STM32 HAL库实战：手把手教你实现I2C读写EEPROM
在嵌入式开发中，数据的“记忆”能力至关重要。设想一个温控设备——断电再上电后，它是否还记得你设定的温度？这背后靠的就是非易失性存储。而当我们需要频繁保存小量配置或日志时，Flash寿命短、擦除麻烦，这时候，I2C接口的EEPROM就成了最佳选择。
本文不讲空泛理论，而是带你从零开始，用STM32 HAL库，一行行写出稳定可靠的i2c读写eeprom代码，并深入剖析每一个关键环节的设计考量与避坑指南。
为什么是I2C + EEPROM？
Flash虽然能掉电存数据，但它的“寿命”是个硬伤——通常只有约1万次擦写。如果你每分钟保存一次校准数据，不到一周就可能把Flash“写废”。
相比之下，常见的AT24C系列EEPROM标称擦写次数高达100万次，支持字节级读写，接口简单（仅需SCL和SDA两根线），成本低廉。配合STM32内置的I2C控制器和HAL库，开发效率极高。
更重要的是，I2C总线支持多设备挂载。你可以同时接RTC、传感器和EEPROM，共用两根线，极大节省MCU引脚资源。
理解I2C通信的本质：不是“发送”，而是“对话”
很多人初学I2C，总觉得调个HAL_I2C_Master_Transmit函数就完事了。但实际调试中常遇到写入失败、总线锁死、读回数据为0xFF等问题。根源在于，你没有真正理解I2C是一场“主从对话”。
I2C通信的关键握手机制
- 每一帧数据传输后，接收方必须返回一个ACK（应答）信号，表示“我收到了”。
- 如果返回NACK，说明对方没准备好或不存在。
- 写操作尤其要注意：EEPROM在内部执行写入时（典型5ms），会暂时停止响应任何通信，直到写完成。
这就引出一个核心问题：如何知道EEPROM已经写完了？
答案是：应答轮询（ACK Polling）——不断尝试给它发一个最简单的“打招呼”请求，直到它愿意回应ACK为止。
芯片选型与硬件连接要点
以经典型号AT24C02为例，其关键参数如下：
| 参数 | 值 |
|---|---|
| 容量 | 2Kb (256字节) |
| 页大小 | 8字节 |
| 写入时间 | 最大5ms |
| I2C地址 | 7位，由A2/A1/A0引脚决定 |
硬件设计注意事项
- 上拉电阻：SDA和SCL必须接上拉电阻到VCC，阻值通常为4.7kΩ。若总线上设备多、走线长，可适当减小至2.2kΩ以加快上升沿。
- 电源去耦：在VCC引脚就近放置0.1μF陶瓷电容，避免电源噪声干扰通信。
- 写保护引脚（WP）：接地允许读写；接高电平则进入只读模式，防止误操作。
- 地址引脚配置：通过A2/A1/A0接地或接VCC，可设置设备地址低3位，避免总线冲突。
STM32 CubeMX快速配置I2C外设
使用STM32CubeMX可以一键生成初始化代码，避免手动计算时序参数。
- 在Pinout图中启用I2C1（或其他I2C外设）；
- 设置为I2C模式，勾选SCL和SDA引脚；
- 配置通信速度为400kHz（Fast Mode）；
- CubeMX会自动生成合适的
Timing值，如0x2000090E； - 生成代码后，确保
MX_I2C1_Init()被正确调用。
// CubeMX生成的初始化函数片段 hi2c1.Instance = I2C1; hi2c1.Init.Timing = 0x2000090E; // 400kHz Fast Mode hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; if (HAL_I2C_Init(&hi2c1) != HAL_OK) { Error_Handler(); }⚠️ 注意：不要修改
Timing值，除非你清楚每个bit的含义。错误的时序会导致通信失败或不稳定。
封装通用EEPROM读写函数
直接裸调HAL库API容易出错且复用性差。我们应封装成更贴近应用层的接口函数。
定义设备地址宏
#define EEPROM_DEV_ADDR 0x50 // AT24C02默认地址，A2=A1=A0=0注意：HAL库要求传入原始7位地址，底层会自动处理R/W位。
写操作：支持单字节与页写优化
EEPROM支持两种写模式：
-字节写：一次写1字节；
-页写：一次最多写一页（如8字节），减少I2C事务开销。
/** * @brief 向EEPROM指定地址写入数据（支持页内连续写） * @param mem_addr: 存储器内部地址 (0~255 for AT24C02) * @param data: 数据缓冲区 * @param size: 数据长度（建议不超过页大小） * @retval HAL状态 */ HAL_StatusTypeDef EEPROM_Write(uint16_t mem_addr, uint8_t *data, uint16_t size) { uint8_t tx_buffer[17]; // 最大支持16字节页写 + 1字节地址 if (size == 0 || size > 16 || data == NULL) return HAL_ERROR; // 构造发送包：地址 + 数据 tx_buffer[0] = (uint8_t)mem_addr; memcpy(tx_buffer + 1, data, size); // 执行写操作（地址左移一位，R/W=0） return HAL_I2C_Master_Transmit(&hi2c1, EEPROM_DEV_ADDR << 1, tx_buffer, size + 1, 100); // 超时100ms }✅ 技巧：将地址和数据合并发送，利用I2C的“地址自动递增”特性，实现高效页写。
读操作：先定位指针，再读取数据
I2C EEPROM读取必须分两步：
1. 写操作设置地址指针；
2. 重启后发起读操作。
/** * @brief 从EEPROM指定地址读取数据 * @param mem_addr: 起始地址 * @param data: 接收缓冲区 * @param size: 读取字节数 * @retval HAL状态 */ HAL_StatusTypeDef EEPROM_Read(uint16_t mem_addr, uint8_t *data, uint16_t size) { HAL_StatusTypeDef status; // Step 1: 发送地址指针（写操作） status = HAL_I2C_Master_Transmit(&hi2c1, EEPROM_DEV_ADDR << 1, &mem_addr, 1, 100); if (status != HAL_OK) return status; // Step 2: 重新启动并读取数据（R/W=1） return HAL_I2C_Master_Receive(&hi2c1, (EEPROM_DEV_ADDR << 1) | 0x01, data, size, 100); }❗ 错误示例：有人试图用“写+读”在一个函数里完成，却忘了中间需要总线释放与重启，导致失败。
关键！实现应答轮询：等待写完成
这是保证数据完整性的生死线。如果不等EEPROM写完就进行下一次操作，轻则失败，重则导致总线异常。
/** * @brief 等待EEPROM内部写操作完成（最大等待10ms） */ void EEPROM_WaitForWriteComplete(void) { uint32_t tickstart = HAL_GetTick(); while (HAL_I2C_Master_Transmit(&hi2c1, EEPROM_DEV_ADDR << 1, NULL, 0, // 注意：这里发送0字节 10) != HAL_OK) { // 若超时或收到NACK，说明仍在写入中，继续尝试 if ((HAL_GetTick() - tickstart) > 10) // 防止无限循环 { break; // 强制退出，避免卡死 } HAL_Delay(1); // 小延时，降低CPU负载 } }🔍 原理：发送一个空写操作（无数据），仅发送设备地址。如果EEPROM正在忙，会返回NACK；一旦写完成，就会ACK，函数返回成功。
调用时机：每次写操作后，必须立即调用此函数！
// 示例：安全写入流程 EEPROM_Write(0x10, &value, 1); EEPROM_WaitForWriteComplete(); // 必须等待！实战调试：那些年踩过的坑
坑点1：读回来全是0xFF或0x00？
常见原因：
- SDA/SCL接反？
- 上拉电阻未焊接？
- 设备地址错误？AT24C02地址范围是0x50~0x57，取决于A2/A1/A0；
- 写操作后未等写完成就去读？
✅ 解决方案：
- 用逻辑分析仪抓包，确认START、地址、ACK是否正常；
- 先尝试读一个已知地址，看能否通信；
- 使用应答轮询确保写完成。
坑点2：程序卡死在HAL_I2C函数中？
HAL库默认启用超时机制，但如果配置不当，仍可能因总线锁死而卡住。
✅ 解决方案：
- 总是在调用I2C函数时传入合理超时值（如100ms）；
- 添加总线恢复函数，在初始化或错误后调用：
void I2C_Bus_Recovery(void) { // 模拟9个时钟脉冲，强制从机释放SCL GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); // 假设SCL在PB6 // 将SCL设为推挽输出 GPIO_InitStruct.Pin = GPIO_PIN_6; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); for (int i = 0; i < 9; i++) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(1); } // 重新初始化I2C HAL_I2C_DeInit(&hi2c1); MX_I2C1_Init(); }进阶技巧：提升性能与可靠性
1. 减少I2C事务次数
频繁写单字节效率极低。可采用以下策略：
- 缓存修改，批量写入；
- 使用页写模式，一次写满一页；
- 对于频繁更新的数据，考虑加入RAM缓存层。
2. 软件磨损均衡（Wear Leveling）
虽然EEPROM寿命很长，但若总在同一个地址反复写，仍可能提前损坏。对于日志类数据，可设计环形缓冲区，轮流写不同地址。
3. 加入CRC校验
读写关键配置时，建议附加CRC16校验，防止数据 corruption。
typedef struct { uint16_t threshold; uint8_t mode; uint16_t crc; // CRC16 of the above } Config_t;总结：构建可靠的数据存储系统
一套稳健的i2c读写eeprom代码不只是几个函数的堆砌，而是对协议、硬件、时序和异常处理的综合把控。
我们回顾一下关键实践：
- ✅ 使用HAL库简化开发，但要理解其行为；
- ✅ 写操作后必须调用应答轮询等待写完成；
- ✅ 读操作必须先写地址指针，再发起读；
- ✅ 合理设置超时，避免程序卡死；
- ✅ 物理层注意上拉电阻与电源滤波；
- ✅ 调试时善用逻辑分析仪验证通信波形。
当你下次需要保存用户设置、设备序列号或运行日志时，这套方案可以直接复用。它不仅适用于AT24C02，稍作修改即可用于更大容量的24C64、24C256等芯片。
嵌入式系统的“记忆力”，就藏在这几行看似简单的I2C代码之中。掌握它，你的产品才算真正“活”了起来。
如果你在实现过程中遇到了其他挑战，欢迎在评论区分享讨论。
