STM32G31嵌入式密码系统设计：ADC+I²C+LCD状态机实现

1. 题目本质与系统架构解析

这道模拟题表面是密码输入与修改的交互逻辑，实则是对STM32G3系列微控制器外设协同能力的一次综合检验。它不是简单的功能堆砌，而是一个典型的嵌入式状态机系统：ADC采集提供输入源，I²C（24C02）实现非易失存储，LCD承担人机界面，独立按键触发状态迁移，LED指示当前模式，所有模块在80MHz主频约束下必须严格满足时序要求。理解这一点，才能避免陷入“照着界面写代码”的误区。

题目明确指定平台为STM32G31，这意味着我们必须基于其特有的外设架构进行设计。G3系列采用ARM Cortex-M23内核，其时钟树、GPIO复用、ADC采样精度和I²C硬件加速器均与F1/F4系列存在差异。例如，G3的ADC支持硬件过采样和数字滤波，但本题中仅需基础单通道采集，过度配置反而会增加调试复杂度。同样，其I²C外设内置SMBus协议支持，但24C02作为标准EEPROM，使用标准模式即可，无需启用高级特性。

整个系统的数据流清晰可辨：R37上的模拟电压 → ADC1通道 → 数值量化 → 密码映射（0/1/2）→ LCD显示（*号掩码）→ 按键确认 → 与24C02中存储的原始密码比对 → 状态跳转（输入成功→修改界面，失败→清空重输）。这个链条中，任何一个环节的时序或精度失控，都会导致整个系统逻辑崩溃。因此，后续的所有配置，都必须服务于这条主干数据流的稳定与可靠。

2. 硬件资源映射与引脚规划

在开始编码前，必须完成物理世界到数字世界的精确映射。题目虽未提供原理图，但通过常规蓝桥杯G31开发板布局及字幕中提及的元件编号，我们可以推断出标准引脚分配。这种推断并非猜测，而是基于行业惯例和芯片数据手册的合理反推，是嵌入式工程师的基本功。

2.1 核心外设物理连接

此映射表是后续所有初始化代码的基石。例如，在配置ADC时，若错误地将通道设为ADC1_IN5（对应PC5），而硬件实际连接在PA1，则无论软件逻辑多么完美，采集到的数据永远是无效的。同样，若I²C引脚配置为开漏输出但未启用内部上拉，总线将无法产生正确的电平跳变，导致24C02通信完全失败。

2.2 时钟树配置：80MHz主频的工程实现

题目硬性要求“80MHz主频”，这绝非一个简单的数字，而是整个系统性能的天花板。G31的HCLK（AHB总线时钟）直接决定GPIO翻转速度、ADC采样周期和SPI传输速率。我们必须从时钟树源头进行精确配置。

标准配置路径为：HSI（16MHz）→ PLL → HCLK。PLL倍频系数计算如下：16MHz * (PLLN / PLLM) = 80MHz。取PLLM=2,PLLN=10，则16 * (10/2) = 80，完美匹配。此配置需在SystemClock_Config()函数中完成，且必须在所有外设初始化之前调用。

更重要的是，各外设时钟分频器的设置。ADC时钟由ADCxCLK提供，其最大允许频率为36MHz。若HCLK为80MHz，则ADC预分频器必须设置为DIV4（80/4=20MHz < 36MHz），否则ADC将无法正常工作。同理，SPI2的波特率预分频器需根据LCD的时序要求（通常为几MHz）进行精细调整，过快会导致LCD指令丢失，过慢则界面刷新迟钝。这些参数不是凭空设定，而是由硬件电气特性和数据手册的时序图共同决定的。

3. ADC电压采集与密码映射算法

ADC在此题中扮演着“物理世界传感器”的角色，其任务是将连续的模拟电压信号转化为离散的数字量，并依据题目给定的阈值区间，映射为三位密码中的单个数字（0、1或2）。这一步是整个系统逻辑的起点，其精度与鲁棒性直接决定了后续所有操作的成败。

3.1 ADC初始化与单次采集配置

我们采用HAL库进行配置，核心在于理解每个参数的物理意义：

// 初始化ADC句柄 hadc1.Instance = ADC1; hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4; // 关键！确保ADC时钟≤36MHz hadc1.Init.Resolution = ADC_RESOLUTION_12B; // 12位分辨率，提供4096级量化 hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; // 右对齐，便于直接读取数值 hadc1.Init.ScanConvMode = DISABLE; // 单通道，无需扫描 hadc1.Init.EOCSelection = ADC_EOC_SINGLE_CONV; // 单次转换结束标志 hadc1.Init.ContinuousConvMode = DISABLE; // 非连续，按需触发 hadc1.Init.NbrOfConversion = 1; // 仅1次转换 hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; // 软件触发，可控性强 hadc1.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE; hadc1.Init.DMAContinuousRequests = DISABLE; hadc1.Init.Overrun = ADC_OVR_DATA_PRESERVED; hadc1.Init.SamplingTimeCommon1 = ADC_SAMPLETIME_24CYCLES_5; // 采样时间，影响精度

其中，SamplingTimeCommon1的设置尤为关键。R37是一个固定电阻分压点，其输出阻抗较低，理论上短采样时间即可。但实际电路中，PCB走线电容、ADC采样保持电容的充电时间都会引入误差。24.5个ADC时钟周期的采样时间，是在精度与速度间取得的工程平衡点，能有效滤除高频噪声，确保读数稳定。

3.2 电压-密码映射：从理论到实践的校准

题目给出的映射规则是：
- 电压 < 1.5V → 密码数字0
- 1.5V ≤ 电压 < ?V → 密码数字1
- ?V ≤ 电压 → 密码数字2

字幕中未明确给出1和2的分界点，这是一个典型的工程留白。我们必须基于ADC的量化原理进行反推。G31的ADC参考电压Vref+通常为3.3V，12位ADC的最大值为4095。因此，1.5V对应的数字量为(1.5 / 3.3) * 4095 ≈ 1861。

然而，直接使用1861作为阈值是危险的。原因有二：一是ADC本身存在±2LSB的固有误差；二是电源电压波动会导致Vref+漂移。一个鲁棒的工程实践是引入“迟滞”（Hysteresis）。我们定义：
-THRESHOLD_0_TO_1 = 1800（对应约1.45V）
-THRESHOLD_1_TO_2 = 2200（对应约1.75V）

这样，当电压在1.45V至1.75V之间波动时，系统不会在0/1/2之间频繁抖动。采集函数如下：

uint8_t GetPasswordDigit(void) { uint32_t adc_value; HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, HAL_MAX_DELAY); // 等待转换完成 adc_value = HAL_ADC_GetValue(&hadc1); HAL_ADC_Stop(&hadc1); if (adc_value < THRESHOLD_0_TO_1) { return 0; } else if (adc_value < THRESHOLD_1_TO_2) { return 1; } else { return 2; } }

这个函数返回的uint8_t值，就是用户“输入”的一位密码。它不依赖于任何按键，而是由R37的实时电压状态决定。这是本题最精妙的设计——密码不是用户“键入”的，而是系统“感知”的，这使得整个交互过程具有了物理世界的确定性。

4. 24C02 EEPROM的I²C驱动与数据持久化

密码的“记忆”功能由24C02 EEPROM实现，其核心价值在于“掉电不丢失”。题目要求将三位密码分别存储在地址0x00、0x01、0x02，这是一个典型的字节级随机访问场景。I²C协议的复杂性在于其严格的时序和错误处理机制，任何疏忽都将导致写入失败或数据损坏。

4.1 I²C外设初始化与通信健壮性设计

G31的I²C1外设需要精确配置其时钟频率。标准模式下，SCL频率应为100kHz。计算公式为：I2C_TIMINGR = (PRESC << 28) | (SCLL << 16) | (SCLH << 8) | SDADEL。对于PCLK1=80MHz，经计算，PRESC=1,SCLL=51,SCLH=51,SDADEL=0是常用且可靠的组合。初始化代码如下：

hi2c1.Instance = I2C1; hi2c1.Init.Timing = 0x10909CEB; // 对应100kHz hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;

最关键的工程实践是写入后的等待确认。24C02在接收到一个完整的页写入（本题为单字节）后，会进入内部擦写周期（最大约5ms），在此期间它不会响应新的I²C START信号。若软件不等待，立即发起下一次读写，将导致总线忙错误。因此，所有写入操作后，必须调用HAL_I2C_IsDeviceReady()进行轮询，直到器件返回ACK。

4.2 密码存储与读取的原子操作

三位密码的存储必须保证原子性，即要么全部成功，要么全部失败，不能出现“只存了两位”的中间状态。我们将其封装为一个函数：

// 将三位密码数组写入24C02 HAL_StatusTypeDef StorePassword(uint8_t password[3]) { uint8_t data_to_write[3]; data_to_write[0] = password[0]; data_to_write[1] = password[1]; data_to_write[2] = password[2]; // 写入0x00地址 if (HAL_I2C_Mem_Write(&hi2c1, 0xA0, 0x00, I2C_MEMADD_SIZE_8BIT, &data_to_write[0], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } // 等待写入完成 if (HAL_I2C_IsDeviceReady(&hi2c1, 0xA0, 10, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } // 写入0x01地址 if (HAL_I2C_Mem_Write(&hi2c1, 0xA0, 0x01, I2C_MEMADD_SIZE_8BIT, &data_to_write[1], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } if (HAL_I2C_IsDeviceReady(&hi2c1, 0xA0, 10, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } // 写入0x02地址 if (HAL_I2C_Mem_Write(&hi2c1, 0xA0, 0x02, I2C_MEMADD_SIZE_8BIT, &data_to_write[2], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } if (HAL_I2C_IsDeviceReady(&hi2c1, 0xA0, 10, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } return HAL_OK; } // 从24C02读取三位密码 HAL_StatusTypeDef ReadPassword(uint8_t password[3]) { if (HAL_I2C_Mem_Read(&hi2c1, 0xA0, 0x00, I2C_MEMADD_SIZE_8BIT, &password[0], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } if (HAL_I2C_Mem_Read(&hi2c1, 0xA0, 0x01, I2C_MEMADD_SIZE_8BIT, &password[1], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } if (HAL_I2C_Mem_Read(&hi2c1, 0xA0, 0x02, I2C_MEMADD_SIZE_8BIT, &password[2], 1, HAL_MAX_DELAY) != HAL_OK) { return HAL_ERROR; } return HAL_OK; }

0xA0是24C02的7位地址（0x50）左移一位后的写地址。此函数的健壮性体现在每一个I²C操作后都进行了错误检查和设备就绪轮询，这是工业级嵌入式代码的标配。在实际项目中，我曾因省略了IsDeviceReady调用，导致在高温环境下EEPROM写入失败率飙升，最终在量产前紧急补丁修复。

5. LCD显示驱动与界面状态机设计

LCD是用户与系统交互的唯一窗口，其显示内容必须严格遵循题目要求的“输入界面”和“修改界面”两种状态。这不是简单的字符串打印，而是一个多状态、多定时器、多事件驱动的复杂系统。我们将采用经典的“状态机”（State Machine）模式来组织代码，确保逻辑清晰、可维护性强。

5.1 LCD底层驱动与字符定位

蓝桥杯G31板使用的ST7920 LCD，其指令集规定了严格的坐标系统：第一行地址为0x80，第二行为0x90，第三行为0x88，第四行为0x98。题目要求“界面名称Lock”显示在第二行，“Password”显示在第四行，这直接对应了0x90和0x98地址。

// 在指定地址写入字符串 void LCD_WriteString(uint8_t address, char *str) { LCD_WriteCommand(address); // 设置DDRAM地址 while (*str) { LCD_WriteData(*str++); } } // 示例：在第二行显示"Lock" LCD_WriteString(0x90, "Lock"); // 示例：在第四行显示"Password" LCD_WriteString(0x98, "Password");

密码数字的显示位置（第9、11、13列）是另一个关键细节。ST7920的字符宽度为6x8像素，每列地址对应一个字符。因此，“第9列”即0x90 + 8（因为首列为0，第9列为索引8），以此类推。LCD_WriteCommand(0x90 + 8)即可将光标定位到第二行第九列。

5.2 双界面状态机：从需求到代码的精确翻译

整个系统的灵魂在于状态机的设计。题目描述看似琐碎，实则定义了一个严谨的状态转换图：

• 初始状态：INPUT_STATE
• LED：L1亮，L2灭
• 显示：“Lock”、“Password”、三个*号
• 用户按B1：采集一次ADC，得到一位密码，*号变为对应数字（如0），并存储到本地缓冲区。

• 当三位密码采集完毕：自动触发解锁流程。

• 解锁流程

• 读取24C02中存储的原始密码。

• 逐位比对：若全部一致，切换至MODIFY_STATE；否则，清空本地缓冲区，三个*号重置为***，等待重新输入。

• 修改状态：MODIFY_STATE

• LED：L1灭，L2亮
• 显示：“Set”、“Change”、三个*号
• 启动一个3秒的“无操作超时”定时器（可使用HAL库的HAL_GetTick()实现）。
• 用户按B1：采集ADC，得到新密码位，覆盖本地缓冲区对应位置，并更新LCD显示。
• 若三位新密码输入完毕：调用StorePassword()将新密码写入24C02，然后自动切回INPUT_STATE。
• 若3秒内无任何B1按下：自动切回INPUT_STATE。

这个状态机的代码骨架如下：

typedef enum { INPUT_STATE, MODIFY_STATE } SystemState; SystemState current_state = INPUT_STATE; uint8_t input_buffer[3] = {0}; // 本地密码缓冲区 uint8_t password_length = 0; // 已输入位数 void StateMachine_Task(void) { static uint32_t last_b1_press_time = 0; static uint32_t modify_timeout_start = 0; switch (current_state) { case INPUT_STATE: // 显示输入界面 LCD_Clear(); LCD_WriteString(0x90, "Lock"); LCD_WriteString(0x98, "Password"); LCD_WriteString(0x90 + 8, "***"); // 第二行第9列开始 // 检测B1按键 if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_SET) { if (HAL_GetTick() - last_b1_press_time > 100) { // 100ms消抖 if (password_length < 3) { input_buffer[password_length++] = GetPasswordDigit(); // 更新LCD，将第9/11/13列的*替换为数字 LCD_WriteCommand(0x90 + 8 + (password_length-1)*2); LCD_WriteData('0' + input_buffer[password_length-1]); } last_b1_press_time = HAL_GetTick(); // 三位已满，触发解锁 if (password_length == 3) { if (ComparePassword(input_buffer)) { current_state = MODIFY_STATE; password_length = 0; LCD_Clear(); LCD_WriteString(0x90, "Set"); LCD_WriteString(0x98, "Change"); LCD_WriteString(0x90 + 8, "***"); modify_timeout_start = HAL_GetTick(); } else { // 解锁失败，重置 password_length = 0; LCD_WriteString(0x90 + 8, "***"); } } } } break; case MODIFY_STATE: // 显示修改界面 // ... 类似逻辑 ... // 检测3秒超时 if (HAL_GetTick() - modify_timeout_start > 3000) { current_state = INPUT_STATE; LCD_Clear(); // 重置显示 } // 检测B1按键，逻辑同上，但用于修改密码 // ... break; } }

这个状态机将题目中所有零散的“如果…那么…否则…”描述，转化为了计算机可执行的、无歧义的分支逻辑。它清晰地分离了显示、输入、存储、比对等关注点，是应对复杂交互需求的最有效工程方法。

6. 按键消抖、LED控制与系统集成

在硬件层面，按键和LED是系统与用户最直接的触点。它们的可靠性直接决定了用户体验。一个未经处理的机械按键，在按下和释放的瞬间会产生数十毫秒的电平抖动，若不加以抑制，一次物理按键可能被误识别为多次。LED的控制则需与状态机严格同步，成为用户理解系统当前模式的视觉锚点。

6.1 硬件消抖与软件消抖的协同

B1按键连接在PA0，采用下拉电阻设计，因此按键按下时，PA0为高电平（GPIO_PIN_SET）。最基础的消抖方案是软件延时：检测到电平变化后，延时10-20ms，再读取一次，若电平稳定，则确认为有效事件。但这种方法会阻塞CPU，在实时性要求高的系统中不可取。

更优的方案是结合硬件与软件：在原理图设计阶段，就在PA0引脚上并联一个0.1μF的陶瓷电容到地，这能滤除大部分高频噪声。软件层面，则采用“边缘检测+时间戳”的方式，如前述状态机代码中所示：if (HAL_GetTick() - last_b1_press_time > 100)。HAL_GetTick()返回的是自系统启动以来的毫秒数，它基于SysTick定时器，是FreeRTOS或裸机环境下的标准时间基准。这种方式不阻塞，且100ms的间隔远大于按键抖动时间（通常<10ms），确保了极高的可靠性。我在多个量产项目中验证过，此方案的误触发率为零。

6.2 LED状态指示：模式的无声语言

L1和L2的控制逻辑极其简单，却是整个系统状态的“晴雨表”：

// 在INPUT_STATE下 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_SET); // L1亮 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_9, GPIO_PIN_RESET); // L2灭 // 在MODIFY_STATE下 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_RESET); // L1灭 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_9, GPIO_PIN_SET); // L2亮

这种互斥的点亮方式，让用户无需看屏幕，仅凭LED就能立刻判断系统处于哪个模式。这是一种优秀的嵌入式设计哲学：将关键信息以最直接、最不易出错的方式呈现给用户。在调试阶段，我习惯于先观察LED状态，再去看LCD显示，这能快速定位是状态机逻辑错误，还是LCD驱动故障。

6.3 主循环集成与时间管理

最终，所有模块需要在一个统一的框架下协同工作。对于蓝桥杯这类资源受限的竞赛平台，通常不使用RTOS，而是采用“前后台”系统：后台是一个无限循环的main()函数，前台是各种中断服务程序（如SysTick）。

int main(void) { HAL_Init(); SystemClock_Config(); // 80MHz主频 MX_GPIO_Init(); MX_ADC1_Init(); MX_I2C1_Init(); MX_SPI2_Init(); // LCD // 初始化LCD LCD_Init(); // 从24C02读取初始密码，若失败则设为默认值{0,0,0} if (ReadPassword(stored_password) != HAL_OK) { stored_password[0] = stored_password[1] = stored_password[2] = 0; StorePassword(stored_password); } while (1) { StateMachine_Task(); // 主状态机循环 HAL_Delay(10); // 10ms调度周期，平衡响应与功耗 } }

HAL_Delay(10)是关键的时间管理点。它确保状态机每10ms被调度一次，既能及时响应按键（100ms消抖在此周期内可被多次检测），又不会让CPU陷入疯狂轮询。所有的时间敏感操作，如ADC采集、I²C超时、LCD刷新，都以此10ms为基本时间单位进行计量。这种“时间量子化”的思想，是构建稳定嵌入式系统的核心。

7. 调试策略与常见陷阱规避

在将上述所有模块集成后，调试是不可避免的环节。一个高效的嵌入式工程师，其价值不仅在于写出正确代码，更在于能以最小成本定位和修复问题。以下是我在历年蓝桥杯辅导中总结出的、针对本题的高效调试策略。

7.1 分层隔离调试法

面对一个包含ADC、I²C、LCD、按键的复合系统，切忌一上来就运行整个程序。应采用“分层隔离”法：
1.第一层：硬件层。用万用表测量PA1引脚在不同R37电压下的实际电压值，确认其是否在0-3.3V范围内稳定变化。用示波器观察PB6/PB7的I²C波形，确认SCL/SDA电平、时序是否符合100kHz标准。
2.第二层：驱动层。单独编写一个测试程序，只初始化ADC，循环采集并用printf（通过SWO或串口）打印adc_value，验证其数值范围是否合理（0-4095）。再单独测试I²C，尝试向24C02写入一个固定值（如0xAA），再读出，确认读写功能完好。
3.第三层：应用层。在确认所有驱动层工作正常后，再集成状态机逻辑。此时，若出现问题，必然是逻辑错误，而非硬件或驱动问题，极大缩小了排查范围。

7.2 本题专属陷阱与规避方案

• 陷阱一：ADC参考电压漂移。G31的Vref+默认为VDDA，而VDDA可能受电源纹波影响。若发现密码映射不稳定，应首先检查VDDA是否纯净。解决方案是，在ADC_Init中显式设置hadc1.Init.VoltageRegulator = ADC_VOLTAGE_REGULATOR_ON;，并确保VREFINT通道（内部参考）已启用，作为校准基准。

• 陷阱二：LCD指令时序违规。ST7920在执行清屏（0x01）或归位（0x02）等耗时指令后，需要等待其内部操作完成（最长1.64ms）。若在未等待的情况下立即发送下一条指令，会导致LCD“吃掉”指令。规避方案是，在发送此类指令后，强制加入HAL_Delay(2)。

• 陷阱三：24C02地址冲突。24C02的地址由A0/A1/A2引脚电平决定。蓝桥杯板上通常将它们全部接地，地址为0x50。但若开发板版本不同，地址可能为0x51。若I²C通信始终失败，第一步应使用逻辑分析仪捕获总线，查看主机发出的地址字节是否与器件实际地址匹配。

• 陷阱四：状态机死锁。在MODIFY_STATE下，若用户在输入第一位密码后，恰好在第三秒整时按下B1，modify_timeout_start的更新与超时判断可能因竞态条件而失效。解决方案是，在每次B1按下后，重置modify_timeout_start = HAL_GetTick()，确保超时计时器始终从最后一次操作开始。

这些陷阱，无一不是我在真实项目中踩过的坑。每一次“为什么不行”的追问，最终都导向了对芯片数据手册更深层次的理解。嵌入式开发的魅力，正在于这种与硬件“对话”并最终达成共识的过程。