从一道蓝桥杯赛题看嵌入式开发基本功：如何用STM32CubeMX+HAL库搞定EEPROM读写与状态机按键

从蓝桥杯赛题到工业级开发：STM32 HAL库下EEPROM与状态机的工程化实践

在嵌入式开发领域，竞赛题目往往浓缩了实际工程中的典型问题。第九届蓝桥杯嵌入式赛题中的EEPROM读写和复杂按键处理，恰恰反映了工业场景中两个高频需求：非易失性数据存储和人机交互设计。本文将跳出"解题"思维，系统讲解如何将这些赛题技能转化为可复用的工程模块。

1. EEPROM驱动的工业级实现

AT24C02这类I2C接口EEPROM在智能仪表、IoT设备中广泛应用，但直接调用HAL库的原始API往往存在隐患。我们通过CubeMX配置和代码封装来实现可靠存储。

1.1 CubeMX的精准配置要点

在Pinout & Configuration标签页中，需要特别注意：

• I2C模式选择I2C而非SMbus
• 时钟速度设置为100kHz（标准模式）
• 启用I2C中断（可选但推荐）

关键配置参数对照表：

注意：PA6(SCL)、PA7(SDA)必须配置为开漏输出模式，硬件设计时务必外接4.7kΩ上拉电阻

1.2 增强型读写函数封装

原始HAL库的I2C函数缺乏错误恢复机制，我们封装带重试功能的版本：

#define EEPROM_RETRY_TIMES 3 uint8_t eeprom_read_byte(uint16_t addr) { uint8_t data = 0; HAL_StatusTypeDef status; uint8_t retry = 0; do { uint8_t dev_addr = 0xA0 | ((addr >> 8) & 0x02); status = HAL_I2C_Mem_Read(&hi2c1, dev_addr, addr & 0xFF, I2C_MEMADD_SIZE_8BIT, &data, 1, 100); if(status != HAL_OK) { HAL_Delay(5); I2C_Reset(&hi2c1); } } while(status != HAL_OK && ++retry < EEPROM_RETRY_TIMES); return data; } void eeprom_write_byte(uint16_t addr, uint8_t data) { HAL_StatusTypeDef status; uint8_t retry = 0; do { uint8_t dev_addr = 0xA0 | ((addr >> 8) & 0x02); status = HAL_I2C_Mem_Write(&hi2c1, dev_addr, addr & 0xFF, I2C_MEMADD_SIZE_8BIT, &data, 1, 100); if(status != HAL_OK) { HAL_Delay(10); I2C_Reset(&hi2c1); } else { HAL_Delay(5); // 写入周期等待 } } while(status != HAL_OK && ++retry < EEPROM_RETRY_TIMES); }

关键增强特性：

• 自动重试机制：应对I2C总线干扰
• 硬件复位恢复：调用I2C_Reset()函数重置外设
• 写入延迟保护：确保EEPROM完成内部编程

2. 状态机按键处理的工程化设计

赛题中的长短按、嵌套按键需求，在工业HMI设计中极为常见。传统if-else嵌套方式难以维护，我们采用状态机模式实现。

2.1 按键状态机建模

定义按键状态转移图：

[IDLE] -- 按下 --> [PRESSED] -- 释放(<800ms) --> [SHORT_PRESS] | -- 持续按压(≥800ms) --> [LONG_PRESS]

对应的状态枚举和数据结构：

typedef enum { KEY_IDLE, KEY_PRESSED, KEY_SHORT_PRESS, KEY_LONG_PRESS } KeyState; typedef struct { GPIO_TypeDef* port; uint16_t pin; KeyState state; uint32_t press_tick; uint8_t long_press_flag; } KeyHandle;

2.2 通用按键处理框架

实现跨项目的可复用模块：

void key_scan(KeyHandle* key) { switch(key->state) { case KEY_IDLE: if(HAL_GPIO_ReadPin(key->port, key->pin) == GPIO_PIN_RESET) { key->state = KEY_PRESSED; key->press_tick = HAL_GetTick(); } break; case KEY_PRESSED: if(HAL_GPIO_ReadPin(key->port, key->pin) == GPIO_PIN_SET) { key->state = KEY_SHORT_PRESS; } else if(HAL_GetTick() - key->press_tick >= 800) { key->state = KEY_LONG_PRESS; key->long_press_flag = 1; } break; case KEY_SHORT_PRESS: case KEY_LONG_PRESS: key->state = KEY_IDLE; break; } } // 使用示例 KeyHandle btn1 = {KEY_B1_GPIO_Port, KEY_B1_Pin, KEY_IDLE, 0, 0}; void main_loop() { key_scan(&btn1); if(btn1.state == KEY_SHORT_PRESS) { // 短按处理 } else if(btn1.long_press_flag) { btn1.long_press_flag = 0; // 长按处理 } }

优势特性：

• 无阻塞设计：避免HAL_Delay()影响系统实时性
• 时间戳判定：精确计算按压时长
• 状态自动复位：无需手动清除标志位

3. 工程实践中的进阶技巧

3.1 EEPROM页写入优化

AT24C02具有16字节页写入能力，批量写入时效率提升显著：

void eeprom_page_write(uint16_t addr, uint8_t* data, uint8_t len) { uint8_t dev_addr = 0xA0 | ((addr >> 8) & 0x02); uint8_t page_offset = addr % 16; uint8_t can_write = 16 - page_offset; if(len > can_write) { HAL_I2C_Mem_Write(&hi2c1, dev_addr, addr, I2C_MEMADD_SIZE_8BIT, data, can_write, 100); HAL_Delay(5); eeprom_page_write(addr + can_write, data + can_write, len - can_write); } else { HAL_I2C_Mem_Write(&hi2c1, dev_addr, addr, I2C_MEMADD_SIZE_8BIT, data, len, 100); HAL_Delay(5); } }

3.2 复合按键状态机

处理按键组合场景（如B2+B3同时按下）：

typedef struct { KeyHandle* keys; uint8_t count; uint32_t combo_mask; } KeyGroup; void key_group_scan(KeyGroup* group) { uint32_t current_mask = 0; for(int i=0; i<group->count; i++) { key_scan(&group->keys[i]); if(group->keys[i].state != KEY_IDLE) { current_mask |= (1 << i); } } if(current_mask == group->combo_mask) { // 触发组合键功能 } }

4. 调试与性能优化

4.1 I2C总线故障排查

常见问题及解决方案：

4.2 状态机调试技巧

添加调试输出辅助分析：

const char* key_state_str[] = { "IDLE", "PRESSED", "SHORT_PRESS", "LONG_PRESS" }; void key_scan_debug(KeyHandle* key, const char* name) { KeyState prev = key->state; key_scan(key); if(prev != key->state) { printf("[%s] %s -> %s\n", name, key_state_str[prev], key_state_str[key->state]); } }

在STM32CubeIDE中，通过SWD接口实时输出状态变化，配合逻辑分析仪捕获GPIO波形，可快速定位复杂按键逻辑问题。