1. 项目缘起与整体设计思路STM32F103 配 AT24C02 这个组合在嵌入式圈子里算是“Hello World”级别的经典搭配。但经典归经典我见过太多人在这上面翻车——不是读出来全是 0xFF就是写进去读出来错位再不然就是程序卡在 while 循环里等 ACK 等到天荒地老。这次我拿手头一块最小系统板把整个 I2C 读写 EEPROM 的链路从头到尾捋一遍把那些藏在时序图和手册角落里的坑一个个挖出来。先说清楚这个项目要干什么用 STM32F103 的硬件 I2C 外设对 AT24C02 这颗 2Kbit256 字节的 EEPROM 进行字节读写和页写操作。AT24C02 的 I2C 地址是 7 位格式高 4 位固定为 1010低 3 位由 A2/A1/A0 引脚决定所以一块总线上最多挂 8 片凑出 16Kbit 的存储空间。这个容量放在今天看确实小得可怜但用来存配置参数、校准系数、设备序列号这类“写一次读很多次”的数据绰绰有余。为什么选硬件 I2C 而不是软件模拟这个问题我纠结过很久。软件模拟的好处是引脚随便选、时序自己控、调试直观坏处是占用 CPU 时间、高速下容易丢步。硬件 I2C 的优点是省 CPU、速率稳、有中断和 DMA 支持缺点是 STM32F103 的 I2C 外设出了名的“事儿多”——errata 手册里列了一堆已知问题状态机卡死、BUSY 位不清、ACK 丢失这些坑我都踩过。但话说回来把硬件 I2C 调通之后整个系统的实时性会好很多尤其是在多任务环境下不用为了等 I2C 时序去阻塞主循环。整体方案上我选择STM32CubeMX 生成初始化代码 HAL 库操作的路线。有人喜欢直接怼寄存器觉得 HAL 库效率低、封装太厚。我的看法是对于 I2C 这种时序敏感但速率要求不高的外设HAL 库的封装完全够用而且 CubeMX 能自动处理好时钟树、引脚复用、上拉配置这些琐碎事情省下来的时间可以花在业务逻辑上。当然如果你要做高速连续读写或者对时序有极端要求那确实得考虑 LL 库甚至直接操作寄存器。硬件连接上STM32F103 的 I2C1 默认引脚是 PB6SCL和 PB7SDAI2C2 是 PB10SCL和 PB11SDA。我这次用 I2C1因为最小系统板上 PB6/PB7 通常已经引出来了接线方便。AT24C02 这边A2/A1/A0 全部接地所以器件地址是 0xA0写和 0xA1读。WP 引脚接地允许正常读写如果接高电平芯片进入写保护状态只能读不能写——这个引脚新手很容易忽略焊上去发现写不进去查半天代码最后发现是 WP 被拉高了。上拉电阻的问题值得单独说。I2C 总线是开漏输出SCL 和 SDA 都必须接上拉电阻才能输出高电平。STM32F103 的 I2C 引脚配置成复用开漏模式后内部弱上拉大约 40kΩ 左右这个阻值在标准模式100kHz下勉强能用但波形上升沿会比较缓遇到长走线或者多器件挂载时容易出问题。我的建议是外接 4.7kΩ 上拉电阻到 3.3V这是经过无数项目验证的“黄金阻值”。阻值太小功耗大太大上升沿慢4.7k 在 100kHz 和 400kHz 下都能给出漂亮的方波。注意AT24C02 的供电范围是 1.8V 到 5.5VSTM32F103 是 3.3V 系统两者可以直接对接不需要电平转换。但如果你用的是 5V 单片机那就必须加电平转换电路否则 5V 的 SDA 灌到 3.3V 的引脚上时间长了会把 IO 口打坏。2. AT24C02 芯片特性与 I2C 协议核心细节2.1 AT24C02 的存储结构与寻址方式AT24C02 的内部存储阵列是 32 页 × 8 字节 256 字节。注意这个“页”的概念它是页写操作的基本单位。当你执行页写时可以一次连续写入最多 8 个字节但有一个硬性约束不能跨页。也就是说如果你从地址 0x06 开始写 4 个字节写到 0x09 没问题但如果从 0x07 开始写 4 个字节写到 0x0A 就跨页了第 4 个字节会回卷到本页开头覆盖掉 0x00 的数据。这个“回卷”特性是 AT24C02 的硬件行为不是 bug但如果不清楚这一点调试时会非常困惑——明明写了 4 个字节读出来只有 3 个对第 4 个不知道跑哪去了。字节地址是 8 位的从 0x00 到 0xFF对应 256 个存储单元。每次写操作后内部地址计数器自动加一所以连续读的时候不用反复发地址直接读就行。但连续写不行因为每次写操作都需要一个完整的“起始条件 器件地址 字地址 数据 停止条件”周期EEPROM 内部需要时间来擦写存储单元。2.2 I2C 时序的关键参数与实测波形I2C 协议本身不复杂两根线、几种状态组合而已。但真正调起来时序参数才是决定成败的地方。标准模式 100kHz 下几个关键时间参数必须满足参数含义最小值最大值单位tHD;STA起始条件保持时间4.0-μstLOWSCL 低电平时间4.7-μstHIGHSCL 高电平时间4.0-μstSU;STA重复起始建立时间4.7-μstHD;DAT数据保持时间03.45μstSU;DAT数据建立时间250-nstSU;STO停止条件建立时间4.0-μs这些数字看着枯燥但每一个都对应着实际波形上的一个区间。我拿示波器抓过 STM32F103 硬件 I2C 在 100kHz 下的波形SCL 低电平大约 5.2μs高电平大约 4.8μs周期 10μs 左右完全满足标准模式要求。但如果你把速率调到 400kHz周期变成 2.5μs这时候上拉电阻和总线电容的影响就非常明显了。我试过用 10kΩ 上拉跑 400kHz上升沿明显变缓波形顶部圆角严重AT24C02 偶尔会丢 ACK。换成 4.7kΩ 后波形立刻方正了。起始条件和停止条件的判定逻辑也值得说清楚。起始条件是 SCL 为高时SDA 从高变低停止条件是 SCL 为高时SDA 从低变高。这两个条件之间SDA 只能在 SCL 为低时变化否则会被误判为起始或停止。硬件 I2C 外设会自动处理这些但如果你用软件模拟就必须严格保证这个顺序。2.3 器件地址与读写位AT24C02 的 7 位器件地址格式是1010 A2 A1 A0。A2/A1/A0 对应芯片上的三个引脚接地为 0接 VCC 为 1。我这次全部接地所以 7 位地址是 1010000即 0x50。但 I2C 传输时是 8 位格式最低位是读写位0 表示写1 表示读。所以写操作0x50 1 | 0 0xA0读操作0x50 1 | 1 0xA1HAL 库的HAL_I2C_Mem_Write和HAL_I2C_Mem_Read函数内部会自动处理这个移位和读写位拼接你只需要传入 7 位地址 0x50 就行。但如果你用HAL_I2C_Master_Transmit这种底层函数就得自己拼好 0xA0 或 0xA1。我见过有人把 0xA0 传给HAL_I2C_Mem_Write的 DevAddress 参数结果函数内部又左移一位变成 0x140截断后变成 0x40完全错了。这个坑很隐蔽因为编译不报错运行时就是没响应。提示HAL 库的 I2C 函数中DevAddress 参数统一使用 7 位地址格式不要自己左移。如果你不确定用HAL_I2C_IsDeviceReady函数先探测一下传 0x50返回 HAL_OK 就说明地址对了。3. 硬件设计与 CubeMX 配置实操3.1 最小系统板接线与上拉电阻选型我用的最小系统板是常见的“蓝板”STM32F103C8T6核心板引出 PB6/PB7。AT24C02 模块是市面上常见的 8 脚 SOP8 转 DIP 的小板板载了 4.7kΩ 上拉电阻和 WP 下拉电阻直接飞线就行。如果你是自己画板记住这几个要点SCL 和 SDA 各接一个 4.7kΩ 上拉电阻到 3.3V不要共用。AT24C02 的 VCC 和 GND 之间加一个 100nF 去耦电容靠近芯片引脚放置。WP 引脚根据需求接 GND允许写或 VCC写保护不要悬空。A2/A1/A0 根据地址需求接 GND 或 VCC不要悬空。我实测过如果上拉电阻用 10kΩ在 100kHz 下勉强能用但示波器上看上升沿大约 1.2μs接近标准模式的上限。换成 4.7kΩ 后上升沿降到 600ns 左右裕量充足。如果总线上挂多个器件总线电容增大上拉电阻还要适当减小但最小不要低于 2.2kΩ否则低电平灌电流会超过 3mA长期运行可能损伤 IO 口。3.2 CubeMX 时钟树与 I2C 参数配置CubeMX 里配置 I2C1 的步骤不复杂但有几个参数容易配错。首先在 Pinout 视图里把 PB6 和 PB7 分别设为 I2C1_SCL 和 I2C1_SDA模式选 I2C。然后在 Configuration 标签页里打开 I2C1 的参数设置I2C Speed Mode选 Standard Mode 或 Fast Mode。AT24C02 支持 400kHz但为了稳定我先用 100kHz。Clock Speed100000 Hz。Duty CycleFast Mode 下才有意义Standard Mode 下忽略。Analog Filter建议开启能滤掉一些毛刺。Digital Filter设为 0 或 1根据实际噪声情况调整。时钟树这边I2C1 挂在 APB1 总线上APB1 的时钟频率决定了 I2C 的时钟源。STM32F103 的 APB1 最高 36MHzCubeMX 会自动计算分频系数。我一般把系统时钟设成 72MHzAPB1 设成 36MHz这样 I2C 的时钟源就是 36MHz分频后得到 100kHz 或 400kHz 都很方便。生成代码后MX_I2C1_Init函数里会有一堆结构体赋值其中I2C_InitStructure.I2C_ClockSpeed 100000就是速率设置。如果你发现实际速率不对先检查 APB1 的时钟频率是不是和你预期的一致。我遇到过有人把系统时钟设成 72MHz 但 APB1 分频设成 1结果 APB1 跑 72MHzI2C 分频算出来完全不对通信直接失败。3.3 GPIO 模式选择复用开漏还是复用推挽这个问题在热词里也出现了——“i2c的推挽模式和开漏模式”。正确答案是必须用复用开漏模式。I2C 总线是开漏结构多个器件可以同时拉低总线但没有任何器件能主动拉高高电平完全靠上拉电阻。如果你把 STM32 的 I2C 引脚配成推挽输出当它输出高电平时会强行把总线拉到 VCC如果此时另一个器件正在拉低总线就会形成电源到地的低阻通路大电流灌入 IO 口时间长了必烧。CubeMX 在配置 I2C 引脚时会自动设为GPIO_MODE_AF_OD也就是复用开漏。你不需要手动改但要知道为什么。有些新手用软件模拟 I2C 时把 SDA 配成推挽输出读数据时又切成输入来回切换很麻烦。正确做法是 SDA 始终配成开漏输出读的时候直接读引脚电平就行因为开漏模式下输出高电平时引脚实际处于高阻态外部上拉电阻会把电平拉高此时读引脚得到的就是总线的真实状态。注意STM32F103 的 I2C 引脚在复用开漏模式下内部弱上拉是默认关闭的必须依赖外部上拉电阻。如果你没接外部上拉总线永远拉不高通信必然失败。4. 代码实现字节读写与页写全流程4.1 字节写操作与写周期等待字节写是最基本的操作。流程是起始条件 → 发送器件地址写→ 等待 ACK → 发送字地址 → 等待 ACK → 发送数据 → 等待 ACK → 停止条件。HAL 库把这整个流程封装成了HAL_I2C_Mem_Write一个函数调用HAL_StatusTypeDef status; uint8_t data 0x5A; status HAL_I2C_Mem_Write(hi2c1, 0x50 1, 0x00, I2C_MEMADD_SIZE_8BIT, data, 1, 100); if (status ! HAL_OK) { // 错误处理 }注意第二个参数我写的是0x50 1也就是 0xA0。这里有个细节HAL 库的HAL_I2C_Mem_Write函数内部会对 DevAddress 参数做一次左移操作吗答案是不会。这个函数的 DevAddress 参数期望的是已经包含读写位的 8 位地址。所以你必须传 0xA0 而不是 0x50。但HAL_I2C_IsDeviceReady函数的 DevAddress 参数期望的是 7 位地址传 0x50。这两个函数的参数格式不一致是 HAL 库的一个历史遗留问题非常容易搞混。写操作完成后AT24C02 需要一段时间来把数据真正写入存储单元这个时间叫写周期时间tWR典型值 5ms最大值 5ms。在这 5ms 内芯片不会响应任何 I2C 命令如果你紧接着发下一个写命令它会丢 ACK。所以每次写操作后必须延时 5ms 以上或者用 ACK 轮询的方式等待芯片就绪。我一般用HAL_Delay(5)简单粗暴地等但在实时性要求高的场合可以用 ACK 轮询void AT24C02_WaitReady(void) { uint32_t timeout 0; while (HAL_I2C_IsDeviceReady(hi2c1, 0x50 1, 1, 10) ! HAL_OK) { timeout; if (timeout 100) break; // 超时退出 } }HAL_I2C_IsDeviceReady会发送起始条件 器件地址如果芯片就绪会返回 ACK否则返回 NACK。这个函数内部有重试机制第三个参数是重试次数第四个参数是每次重试的超时时间。用这种方式等待比固定延时更高效因为芯片可能 2ms 就写完了没必要死等 5ms。4.2 页写操作与跨页边界处理页写可以一次写入最多 8 个字节效率比字节写高很多。但跨页问题必须处理。我的做法是先计算当前地址到本页末尾还有多少字节然后取剩余字节数和待写字节数的较小值作为本次写入长度循环直到所有数据写完。#define AT24C02_PAGE_SIZE 8 #define AT24C02_ADDR 0x50 HAL_StatusTypeDef AT24C02_PageWrite(uint8_t memAddr, uint8_t *pData, uint16_t size) { HAL_StatusTypeDef status; uint16_t written 0; while (written size) { uint8_t pageRemain AT24C02_PAGE_SIZE - (memAddr % AT24C02_PAGE_SIZE); uint8_t chunk (size - written) pageRemain ? (size - written) : pageRemain; status HAL_I2C_Mem_Write(hi2c1, AT24C02_ADDR 1, memAddr, I2C_MEMADD_SIZE_8BIT, pData written, chunk, 100); if (status ! HAL_OK) return status; AT24C02_WaitReady(); memAddr chunk; written chunk; } return HAL_OK; }这段代码的核心逻辑是pageRemain 8 - (memAddr % 8)。比如 memAddr 是 0x06pageRemain 8 - 6 2本次最多写 2 个字节到页末尾剩下的下次再写。这样就能保证每次写入都不跨页。实测下来页写 8 个字节的总耗时大约是 5ms写周期 传输时间比 8 次字节写的 40ms 快了很多。如果你要写入大量数据比如 256 字节全写用页写只需要 32 次写周期总共约 160ms用字节写要 256 次约 1.28 秒。差距非常明显。4.3 字节读与连续读操作读操作比写操作简单因为不需要等待写周期。字节读的流程是起始条件 → 发送器件地址写→ 等待 ACK → 发送字地址 → 等待 ACK → 重复起始条件 → 发送器件地址读→ 等待 ACK → 读取数据 → 发送 NACK → 停止条件。HAL 库的HAL_I2C_Mem_Read函数封装了这个流程uint8_t readData; status HAL_I2C_Mem_Read(hi2c1, AT24C02_ADDR 1, 0x00, I2C_MEMADD_SIZE_8BIT, readData, 1, 100);连续读就更简单了指定读取长度AT24C02 内部地址计数器会自动递增一次读出多个字节uint8_t buffer[16]; status HAL_I2C_Mem_Read(hi2c1, AT24C02_ADDR 1, 0x00, I2C_MEMADD_SIZE_8BIT, buffer, 16, 100);注意连续读的地址回卷问题如果你从 0xFE 开始读 4 个字节会读到 0xFE、0xFF、0x00、0x01。这是正常行为不是错误。AT24C02 的地址计数器是 8 位的溢出后自动回卷到 0x00。提示连续读的时候HAL 库会在最后一个字节前发送 NACK然后发停止条件。如果你用逻辑分析仪抓波形会看到最后一个字节的 ACK 位是高的NACK这是正常的。5. 常见问题排查与避坑经验实录5.1 读出来全是 0xFF 或 0x00这是最常遇到的问题。0xFF 通常意味着总线没有被拉低或者器件没有响应。排查步骤用万用表量 SCL 和 SDA 的静态电平应该是 3.3V。如果是 0V检查上拉电阻是否接好或者总线是否被某个器件拉死。用HAL_I2C_IsDeviceReady探测器件地址返回 HAL_OK 说明器件在线。检查 WP 引脚是否被拉高如果 WP 为高写操作会被忽略但读操作正常。如果你写进去读出来还是 0xFF很可能是 WP 的问题。检查器件地址是否正确。A2/A1/A0 的接法决定了地址如果你不确定用 0x50 到 0x57 逐个探测。0x00 通常意味着器件响应了但数据没写进去或者读地址错了。检查字地址是否超出 0x00-0xFF 范围虽然 AT24C02 只有 256 字节但如果你传了 0x100HAL 库会截断成 0x00读出来就是地址 0x00 的数据。5.2 HAL_I2C_Mem_Write 返回 HAL_BUSY这个错误通常是因为 I2C 总线被卡住了。STM32F103 的 I2C 外设有几个已知的 errata其中一个是在某些异常情况下BUSY 位会一直置位软件复位也清不掉。解决办法是手动切换 SCL 和 SDA 的 GPIO 模式模拟几个时钟脉冲把总线解锁void I2C_BusRecovery(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; // 切换 SCL 和 SDA 为普通开漏输出 HAL_GPIO_DeInit(GPIOB, GPIO_PIN_6 | GPIO_PIN_7); GPIO_InitStruct.Pin GPIO_PIN_6 | GPIO_PIN_7; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, GPIO_InitStruct); // 发送 9 个时钟脉冲 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); } // 发送停止条件 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); HAL_Delay(1); // 重新初始化 I2C MX_I2C1_Init(); }这段代码的原理是如果从机在发送数据时被复位它可能一直拉着 SDA 不放导致总线死锁。发送 9 个时钟脉冲可以让从机把剩余的数据位发完然后释放 SDA。最后发送停止条件让总线回到空闲状态。5.3 写进去读出来数据错位这个问题通常是页写跨页导致的。比如你从地址 0x07 开始写 4 个字节期望写入 0x07、0x08、0x09、0x0A但实际上第 4 个字节会回卷到 0x00覆盖掉原来的数据。解决办法就是用前面提到的页写函数自动处理跨页边界。还有一种可能是写周期等待不够。AT24C02 的写周期最大 5ms如果你只延时了 1ms 就发下一个命令芯片可能还没准备好导致数据丢失。建议用 ACK 轮询代替固定延时或者把延时加到 10ms 保险。5.4 常见问题速查表现象可能原因排查方法解决方案读出来全是 0xFF总线未拉高、器件未响应量静态电平、探测地址检查上拉电阻、器件地址、WP 引脚读出来全是 0x00字地址错误、数据未写入检查字地址范围确认字地址在 0x00-0xFF返回 HAL_BUSY总线死锁检查 BUSY 位执行总线恢复流程返回 HAL_TIMEOUT从机未响应 ACK用逻辑分析仪抓波形检查器件地址、上拉电阻、电源数据错位页写跨页检查写入地址和长度使用页写边界处理函数写不进去WP 引脚为高量 WP 引脚电平WP 接 GND偶尔丢数据写周期等待不足增加延时或 ACK 轮询用 HAL_I2C_IsDeviceReady 等待5.5 实操心得与经验总结第一个心得先用逻辑分析仪抓波形再改代码。我见过太多人遇到问题就埋头改代码改了半天发现是硬件问题。逻辑分析仪能直接看到 SCL 和 SDA 上的实际波形起始条件、地址、ACK、数据一目了然。没有逻辑分析仪的话至少用示波器看两路波形确认电平和时序正常。第二个心得HAL 库的 I2C 函数超时时间不要设太长。我一般设 100ms超过这个时间还没响应说明硬件有问题继续等也没用。设太长会导致程序卡死设太短又容易误判。100ms 是个比较平衡的值。第三个心得AT24C02 的写次数是有限的。官方数据手册标称 100 万次擦写寿命数据保持 100 年。但这是理想条件下的数据实际使用中如果频繁写入寿命会打折扣。如果你的应用需要频繁保存数据建议加一个缓存机制只在数据真正变化时才写入 EEPROM或者用铁电存储器FRAM替代FRAM 的擦写次数几乎是无限的。第四个心得多字节读取时buffer 要足够大。我见过有人定义uint8_t buf[4]却读 8 个字节结果栈溢出程序跑飞。这种错误编译不报错运行时才出问题非常难查。建议在HAL_I2C_Mem_Read调用前加一个断言检查 buffer 大小是否足够。第五个心得I2C 速率不是越高越好。400kHz 虽然快但对硬件要求高走线长了、上拉大了都容易出问题。100kHz 虽然慢但稳定可靠对于 EEPROM 这种低速外设完全够用。我一般先用 100kHz 调通确认功能正常后再尝试 400kHz如果 400kHz 不稳定就退回 100kHz。6. 性能优化与扩展思路6.1 用 DMA 解放 CPU如果你需要频繁读写大量数据比如一次性写入 256 字节用轮询方式会阻塞 CPU 很长时间。这时候可以用 DMA 来搬运数据。STM32F103 的 I2C1 支持 DMA 请求CubeMX 里可以配置 DMA 通道。配置好之后HAL_I2C_Mem_Write_DMA和HAL_I2C_Mem_Read_DMA函数会在后台完成数据传输CPU 可以去做其他事情。但 DMA 方式有个坑I2C 的 DMA 请求是在每个字节传输完成后触发的不是一次性搬完。所以 DMA 传输时间仍然受 I2C 速率限制100kHz 下传输 256 字节大约需要 25ms不算写周期。DMA 的好处是 CPU 不用在 while 循环里空转可以进入低功耗模式或者处理其他任务。6.2 用结构体封装读写接口在实际项目中我习惯把 EEPROM 操作封装成结构体把器件地址、页大小、写周期等参数集中管理typedef struct { I2C_HandleTypeDef *hi2c; uint8_t devAddr; uint8_t pageSize; uint16_t writeCycle; } EEPROM_Handle; HAL_StatusTypeDef EEPROM_WriteByte(EEPROM_Handle *eeprom, uint8_t addr, uint8_t data); HAL_StatusTypeDef EEPROM_ReadByte(EEPROM_Handle *eeprom, uint8_t addr, uint8_t *data); HAL_StatusTypeDef EEPROM_WritePage(EEPROM_Handle *eeprom, uint8_t addr, uint8_t *data, uint16_t size);这样如果以后换成 AT24C04、AT24C08 或者别的 EEPROM 芯片只需要改结构体参数上层业务代码不用动。AT24C04 的页大小是 16 字节AT24C08 是 16 字节AT24C16 是 16 字节但地址位数不同封装好之后切换很方便。6.3 数据校验与掉电保护EEPROM 存储的数据在掉电时可能丢失尤其是写操作进行到一半时断电数据会处于不确定状态。我的做法是在数据后面加一个 CRC 校验字节读取时先校验 CRC如果校验失败就使用默认值。这样即使掉电导致数据损坏系统也能正常启动。typedef struct { uint32_t magic; // 魔数标识数据有效 uint16_t crc; // CRC16 校验 uint8_t data[32]; // 实际数据 } ConfigBlock;写入时先算好 CRC再一起写入。读取时先检查 magic 是否正确再校验 CRC。如果任何一项失败就加载默认配置并重新写入。这个机制在工业现场非常实用我做过的一个项目在强电磁干扰环境下运行EEPROM 数据偶尔会翻位加了 CRC 校验后系统稳定性大幅提升。6.4 从 AT24C02 扩展到其他 EEPROMAT24C02 只有 256 字节如果不够用可以无缝切换到 AT24C324KB、AT24C648KB甚至 AT24C25632KB。这些芯片的 I2C 协议基本兼容主要区别在于字地址位数AT24C02 是 8 位字地址AT24C32 及以上是 16 位字地址。HAL 库的HAL_I2C_Mem_Write函数有一个MemAddressSize参数传I2C_MEMADD_SIZE_8BIT或I2C_MEMADD_SIZE_16BIT就行。但要注意AT24C32 以上的芯片器件地址的低 3 位中有一部分被用作页地址实际可挂载的器件数量会减少。比如 AT24C64 只支持 4 个不同地址AT24C256 只支持 2 个。如果你需要挂载多个大容量 EEPROM要么用 I2C 多路复用器要么换用 SPI 接口的 EEPROM。提示从 AT24C02 切换到 AT24C32 时除了改字地址位数还要注意页大小从 8 字节变成 32 字节页写边界处理逻辑要相应调整。7. 调试工具与实战建议7.1 逻辑分析仪的选择与使用调试 I2C 最趁手的工具是逻辑分析仪。我手头用的是 8 通道 24MHz 采样率的廉价逻辑分析仪配合开源软件 PulseView 使用抓 I2C 波形完全够用。采样率至少要是被测信号频率的 4 倍以上100kHz 的 I2C 用 1MHz 采样率就能看清细节24MHz 更是绰绰有余。接线很简单通道 0 接 SCL通道 1 接 SDA地线接 GND。PulseView 里添加 I2C 解码器设置好 SCL 和 SDA 通道就能自动解析出起始条件、地址、读写位、ACK/NACK、数据字节。我每次调试 I2C 都先抓波形确认时序正常后再看代码效率比盲改代码高十倍。7.2 用 ST-Link 调试时的注意事项STM32F103 用 ST-Link 调试时如果程序卡在 I2C 的 while 循环里调试器可能无法暂停或者变量值不刷新。这是因为 I2C 外设的时钟在调试模式下可能被关闭。解决办法是在 CubeMX 的 Debug 配置里把DBGMCU_APB1_FZ的DBG_I2C1_SMBUS_TIMEOUT位使能这样调试暂停时 I2C 时钟继续运行不会影响调试。另外如果你在 I2C 通信过程中设置断点从机可能会因为超时复位而丢失状态。建议在 I2C 操作前后设置断点不要在传输过程中暂停。如果必须暂停先确认从机是否支持时钟拉伸Clock StretchingAT24C02 是支持的所以暂停时间不太长的话问题不大。7.3 实战建议先调通再优化我的习惯是分三步走第一步用最简单的字节读写把硬件链路调通确认能正确写入和读出第二步加上页写和连续读提高效率第三步根据项目需求决定是否上 DMA、是否加 CRC 校验、是否做掉电保护。不要一上来就追求完美先把基本功能跑通再逐步优化。还有一点保留一份最小可复现的测试代码。我每次调通一个新外设都会把最小可运行的代码单独存一份以后遇到类似项目直接复制粘贴省去重新配置的时间。这份代码里包含 CubeMX 的配置文件、初始化代码、读写函数和测试用例拿到新板子上改一下引脚就能用。这个项目后续还可以这样扩展把 EEPROM 读写封装成文件系统支持按文件名存取数据或者做一个参数管理模块支持参数的默认值、范围校验、版本迁移再或者结合 RTC把 EEPROM 当作日志存储记录设备运行状态。这些扩展我在其他项目里都做过核心的 I2C 读写逻辑和今天分享的完全一样把基础打牢了上层怎么玩都行。
1. 项目缘起与整体设计思路STM32F103 配 AT24C02 这个组合在嵌入式圈子里算是“Hello World”级别的经典搭配。但经典归经典我见过太多人在这上面翻车——不是读出来全是 0xFF就是写进去读出来错位再不然就是程序卡在 while 循环里等 ACK 等到天荒地老。这次我拿手头一块最小系统板把整个 I2C 读写 EEPROM 的链路从头到尾捋一遍把那些藏在时序图和手册角落里的坑一个个挖出来。先说清楚这个项目要干什么用 STM32F103 的硬件 I2C 外设对 AT24C02 这颗 2Kbit256 字节的 EEPROM 进行字节读写和页写操作。AT24C02 的 I2C 地址是 7 位格式高 4 位固定为 1010低 3 位由 A2/A1/A0 引脚决定所以一块总线上最多挂 8 片凑出 16Kbit 的存储空间。这个容量放在今天看确实小得可怜但用来存配置参数、校准系数、设备序列号这类“写一次读很多次”的数据绰绰有余。为什么选硬件 I2C 而不是软件模拟这个问题我纠结过很久。软件模拟的好处是引脚随便选、时序自己控、调试直观坏处是占用 CPU 时间、高速下容易丢步。硬件 I2C 的优点是省 CPU、速率稳、有中断和 DMA 支持缺点是 STM32F103 的 I2C 外设出了名的“事儿多”——errata 手册里列了一堆已知问题状态机卡死、BUSY 位不清、ACK 丢失这些坑我都踩过。但话说回来把硬件 I2C 调通之后整个系统的实时性会好很多尤其是在多任务环境下不用为了等 I2C 时序去阻塞主循环。整体方案上我选择STM32CubeMX 生成初始化代码 HAL 库操作的路线。有人喜欢直接怼寄存器觉得 HAL 库效率低、封装太厚。我的看法是对于 I2C 这种时序敏感但速率要求不高的外设HAL 库的封装完全够用而且 CubeMX 能自动处理好时钟树、引脚复用、上拉配置这些琐碎事情省下来的时间可以花在业务逻辑上。当然如果你要做高速连续读写或者对时序有极端要求那确实得考虑 LL 库甚至直接操作寄存器。硬件连接上STM32F103 的 I2C1 默认引脚是 PB6SCL和 PB7SDAI2C2 是 PB10SCL和 PB11SDA。我这次用 I2C1因为最小系统板上 PB6/PB7 通常已经引出来了接线方便。AT24C02 这边A2/A1/A0 全部接地所以器件地址是 0xA0写和 0xA1读。WP 引脚接地允许正常读写如果接高电平芯片进入写保护状态只能读不能写——这个引脚新手很容易忽略焊上去发现写不进去查半天代码最后发现是 WP 被拉高了。上拉电阻的问题值得单独说。I2C 总线是开漏输出SCL 和 SDA 都必须接上拉电阻才能输出高电平。STM32F103 的 I2C 引脚配置成复用开漏模式后内部弱上拉大约 40kΩ 左右这个阻值在标准模式100kHz下勉强能用但波形上升沿会比较缓遇到长走线或者多器件挂载时容易出问题。我的建议是外接 4.7kΩ 上拉电阻到 3.3V这是经过无数项目验证的“黄金阻值”。阻值太小功耗大太大上升沿慢4.7k 在 100kHz 和 400kHz 下都能给出漂亮的方波。注意AT24C02 的供电范围是 1.8V 到 5.5VSTM32F103 是 3.3V 系统两者可以直接对接不需要电平转换。但如果你用的是 5V 单片机那就必须加电平转换电路否则 5V 的 SDA 灌到 3.3V 的引脚上时间长了会把 IO 口打坏。2. AT24C02 芯片特性与 I2C 协议核心细节2.1 AT24C02 的存储结构与寻址方式AT24C02 的内部存储阵列是 32 页 × 8 字节 256 字节。注意这个“页”的概念它是页写操作的基本单位。当你执行页写时可以一次连续写入最多 8 个字节但有一个硬性约束不能跨页。也就是说如果你从地址 0x06 开始写 4 个字节写到 0x09 没问题但如果从 0x07 开始写 4 个字节写到 0x0A 就跨页了第 4 个字节会回卷到本页开头覆盖掉 0x00 的数据。这个“回卷”特性是 AT24C02 的硬件行为不是 bug但如果不清楚这一点调试时会非常困惑——明明写了 4 个字节读出来只有 3 个对第 4 个不知道跑哪去了。字节地址是 8 位的从 0x00 到 0xFF对应 256 个存储单元。每次写操作后内部地址计数器自动加一所以连续读的时候不用反复发地址直接读就行。但连续写不行因为每次写操作都需要一个完整的“起始条件 器件地址 字地址 数据 停止条件”周期EEPROM 内部需要时间来擦写存储单元。2.2 I2C 时序的关键参数与实测波形I2C 协议本身不复杂两根线、几种状态组合而已。但真正调起来时序参数才是决定成败的地方。标准模式 100kHz 下几个关键时间参数必须满足参数含义最小值最大值单位tHD;STA起始条件保持时间4.0-μstLOWSCL 低电平时间4.7-μstHIGHSCL 高电平时间4.0-μstSU;STA重复起始建立时间4.7-μstHD;DAT数据保持时间03.45μstSU;DAT数据建立时间250-nstSU;STO停止条件建立时间4.0-μs这些数字看着枯燥但每一个都对应着实际波形上的一个区间。我拿示波器抓过 STM32F103 硬件 I2C 在 100kHz 下的波形SCL 低电平大约 5.2μs高电平大约 4.8μs周期 10μs 左右完全满足标准模式要求。但如果你把速率调到 400kHz周期变成 2.5μs这时候上拉电阻和总线电容的影响就非常明显了。我试过用 10kΩ 上拉跑 400kHz上升沿明显变缓波形顶部圆角严重AT24C02 偶尔会丢 ACK。换成 4.7kΩ 后波形立刻方正了。起始条件和停止条件的判定逻辑也值得说清楚。起始条件是 SCL 为高时SDA 从高变低停止条件是 SCL 为高时SDA 从低变高。这两个条件之间SDA 只能在 SCL 为低时变化否则会被误判为起始或停止。硬件 I2C 外设会自动处理这些但如果你用软件模拟就必须严格保证这个顺序。2.3 器件地址与读写位AT24C02 的 7 位器件地址格式是1010 A2 A1 A0。A2/A1/A0 对应芯片上的三个引脚接地为 0接 VCC 为 1。我这次全部接地所以 7 位地址是 1010000即 0x50。但 I2C 传输时是 8 位格式最低位是读写位0 表示写1 表示读。所以写操作0x50 1 | 0 0xA0读操作0x50 1 | 1 0xA1HAL 库的HAL_I2C_Mem_Write和HAL_I2C_Mem_Read函数内部会自动处理这个移位和读写位拼接你只需要传入 7 位地址 0x50 就行。但如果你用HAL_I2C_Master_Transmit这种底层函数就得自己拼好 0xA0 或 0xA1。我见过有人把 0xA0 传给HAL_I2C_Mem_Write的 DevAddress 参数结果函数内部又左移一位变成 0x140截断后变成 0x40完全错了。这个坑很隐蔽因为编译不报错运行时就是没响应。提示HAL 库的 I2C 函数中DevAddress 参数统一使用 7 位地址格式不要自己左移。如果你不确定用HAL_I2C_IsDeviceReady函数先探测一下传 0x50返回 HAL_OK 就说明地址对了。3. 硬件设计与 CubeMX 配置实操3.1 最小系统板接线与上拉电阻选型我用的最小系统板是常见的“蓝板”STM32F103C8T6核心板引出 PB6/PB7。AT24C02 模块是市面上常见的 8 脚 SOP8 转 DIP 的小板板载了 4.7kΩ 上拉电阻和 WP 下拉电阻直接飞线就行。如果你是自己画板记住这几个要点SCL 和 SDA 各接一个 4.7kΩ 上拉电阻到 3.3V不要共用。AT24C02 的 VCC 和 GND 之间加一个 100nF 去耦电容靠近芯片引脚放置。WP 引脚根据需求接 GND允许写或 VCC写保护不要悬空。A2/A1/A0 根据地址需求接 GND 或 VCC不要悬空。我实测过如果上拉电阻用 10kΩ在 100kHz 下勉强能用但示波器上看上升沿大约 1.2μs接近标准模式的上限。换成 4.7kΩ 后上升沿降到 600ns 左右裕量充足。如果总线上挂多个器件总线电容增大上拉电阻还要适当减小但最小不要低于 2.2kΩ否则低电平灌电流会超过 3mA长期运行可能损伤 IO 口。3.2 CubeMX 时钟树与 I2C 参数配置CubeMX 里配置 I2C1 的步骤不复杂但有几个参数容易配错。首先在 Pinout 视图里把 PB6 和 PB7 分别设为 I2C1_SCL 和 I2C1_SDA模式选 I2C。然后在 Configuration 标签页里打开 I2C1 的参数设置I2C Speed Mode选 Standard Mode 或 Fast Mode。AT24C02 支持 400kHz但为了稳定我先用 100kHz。Clock Speed100000 Hz。Duty CycleFast Mode 下才有意义Standard Mode 下忽略。Analog Filter建议开启能滤掉一些毛刺。Digital Filter设为 0 或 1根据实际噪声情况调整。时钟树这边I2C1 挂在 APB1 总线上APB1 的时钟频率决定了 I2C 的时钟源。STM32F103 的 APB1 最高 36MHzCubeMX 会自动计算分频系数。我一般把系统时钟设成 72MHzAPB1 设成 36MHz这样 I2C 的时钟源就是 36MHz分频后得到 100kHz 或 400kHz 都很方便。生成代码后MX_I2C1_Init函数里会有一堆结构体赋值其中I2C_InitStructure.I2C_ClockSpeed 100000就是速率设置。如果你发现实际速率不对先检查 APB1 的时钟频率是不是和你预期的一致。我遇到过有人把系统时钟设成 72MHz 但 APB1 分频设成 1结果 APB1 跑 72MHzI2C 分频算出来完全不对通信直接失败。3.3 GPIO 模式选择复用开漏还是复用推挽这个问题在热词里也出现了——“i2c的推挽模式和开漏模式”。正确答案是必须用复用开漏模式。I2C 总线是开漏结构多个器件可以同时拉低总线但没有任何器件能主动拉高高电平完全靠上拉电阻。如果你把 STM32 的 I2C 引脚配成推挽输出当它输出高电平时会强行把总线拉到 VCC如果此时另一个器件正在拉低总线就会形成电源到地的低阻通路大电流灌入 IO 口时间长了必烧。CubeMX 在配置 I2C 引脚时会自动设为GPIO_MODE_AF_OD也就是复用开漏。你不需要手动改但要知道为什么。有些新手用软件模拟 I2C 时把 SDA 配成推挽输出读数据时又切成输入来回切换很麻烦。正确做法是 SDA 始终配成开漏输出读的时候直接读引脚电平就行因为开漏模式下输出高电平时引脚实际处于高阻态外部上拉电阻会把电平拉高此时读引脚得到的就是总线的真实状态。注意STM32F103 的 I2C 引脚在复用开漏模式下内部弱上拉是默认关闭的必须依赖外部上拉电阻。如果你没接外部上拉总线永远拉不高通信必然失败。4. 代码实现字节读写与页写全流程4.1 字节写操作与写周期等待字节写是最基本的操作。流程是起始条件 → 发送器件地址写→ 等待 ACK → 发送字地址 → 等待 ACK → 发送数据 → 等待 ACK → 停止条件。HAL 库把这整个流程封装成了HAL_I2C_Mem_Write一个函数调用HAL_StatusTypeDef status; uint8_t data 0x5A; status HAL_I2C_Mem_Write(hi2c1, 0x50 1, 0x00, I2C_MEMADD_SIZE_8BIT, data, 1, 100); if (status ! HAL_OK) { // 错误处理 }注意第二个参数我写的是0x50 1也就是 0xA0。这里有个细节HAL 库的HAL_I2C_Mem_Write函数内部会对 DevAddress 参数做一次左移操作吗答案是不会。这个函数的 DevAddress 参数期望的是已经包含读写位的 8 位地址。所以你必须传 0xA0 而不是 0x50。但HAL_I2C_IsDeviceReady函数的 DevAddress 参数期望的是 7 位地址传 0x50。这两个函数的参数格式不一致是 HAL 库的一个历史遗留问题非常容易搞混。写操作完成后AT24C02 需要一段时间来把数据真正写入存储单元这个时间叫写周期时间tWR典型值 5ms最大值 5ms。在这 5ms 内芯片不会响应任何 I2C 命令如果你紧接着发下一个写命令它会丢 ACK。所以每次写操作后必须延时 5ms 以上或者用 ACK 轮询的方式等待芯片就绪。我一般用HAL_Delay(5)简单粗暴地等但在实时性要求高的场合可以用 ACK 轮询void AT24C02_WaitReady(void) { uint32_t timeout 0; while (HAL_I2C_IsDeviceReady(hi2c1, 0x50 1, 1, 10) ! HAL_OK) { timeout; if (timeout 100) break; // 超时退出 } }HAL_I2C_IsDeviceReady会发送起始条件 器件地址如果芯片就绪会返回 ACK否则返回 NACK。这个函数内部有重试机制第三个参数是重试次数第四个参数是每次重试的超时时间。用这种方式等待比固定延时更高效因为芯片可能 2ms 就写完了没必要死等 5ms。4.2 页写操作与跨页边界处理页写可以一次写入最多 8 个字节效率比字节写高很多。但跨页问题必须处理。我的做法是先计算当前地址到本页末尾还有多少字节然后取剩余字节数和待写字节数的较小值作为本次写入长度循环直到所有数据写完。#define AT24C02_PAGE_SIZE 8 #define AT24C02_ADDR 0x50 HAL_StatusTypeDef AT24C02_PageWrite(uint8_t memAddr, uint8_t *pData, uint16_t size) { HAL_StatusTypeDef status; uint16_t written 0; while (written size) { uint8_t pageRemain AT24C02_PAGE_SIZE - (memAddr % AT24C02_PAGE_SIZE); uint8_t chunk (size - written) pageRemain ? (size - written) : pageRemain; status HAL_I2C_Mem_Write(hi2c1, AT24C02_ADDR 1, memAddr, I2C_MEMADD_SIZE_8BIT, pData written, chunk, 100); if (status ! HAL_OK) return status; AT24C02_WaitReady(); memAddr chunk; written chunk; } return HAL_OK; }这段代码的核心逻辑是pageRemain 8 - (memAddr % 8)。比如 memAddr 是 0x06pageRemain 8 - 6 2本次最多写 2 个字节到页末尾剩下的下次再写。这样就能保证每次写入都不跨页。实测下来页写 8 个字节的总耗时大约是 5ms写周期 传输时间比 8 次字节写的 40ms 快了很多。如果你要写入大量数据比如 256 字节全写用页写只需要 32 次写周期总共约 160ms用字节写要 256 次约 1.28 秒。差距非常明显。4.3 字节读与连续读操作读操作比写操作简单因为不需要等待写周期。字节读的流程是起始条件 → 发送器件地址写→ 等待 ACK → 发送字地址 → 等待 ACK → 重复起始条件 → 发送器件地址读→ 等待 ACK → 读取数据 → 发送 NACK → 停止条件。HAL 库的HAL_I2C_Mem_Read函数封装了这个流程uint8_t readData; status HAL_I2C_Mem_Read(hi2c1, AT24C02_ADDR 1, 0x00, I2C_MEMADD_SIZE_8BIT, readData, 1, 100);连续读就更简单了指定读取长度AT24C02 内部地址计数器会自动递增一次读出多个字节uint8_t buffer[16]; status HAL_I2C_Mem_Read(hi2c1, AT24C02_ADDR 1, 0x00, I2C_MEMADD_SIZE_8BIT, buffer, 16, 100);注意连续读的地址回卷问题如果你从 0xFE 开始读 4 个字节会读到 0xFE、0xFF、0x00、0x01。这是正常行为不是错误。AT24C02 的地址计数器是 8 位的溢出后自动回卷到 0x00。提示连续读的时候HAL 库会在最后一个字节前发送 NACK然后发停止条件。如果你用逻辑分析仪抓波形会看到最后一个字节的 ACK 位是高的NACK这是正常的。5. 常见问题排查与避坑经验实录5.1 读出来全是 0xFF 或 0x00这是最常遇到的问题。0xFF 通常意味着总线没有被拉低或者器件没有响应。排查步骤用万用表量 SCL 和 SDA 的静态电平应该是 3.3V。如果是 0V检查上拉电阻是否接好或者总线是否被某个器件拉死。用HAL_I2C_IsDeviceReady探测器件地址返回 HAL_OK 说明器件在线。检查 WP 引脚是否被拉高如果 WP 为高写操作会被忽略但读操作正常。如果你写进去读出来还是 0xFF很可能是 WP 的问题。检查器件地址是否正确。A2/A1/A0 的接法决定了地址如果你不确定用 0x50 到 0x57 逐个探测。0x00 通常意味着器件响应了但数据没写进去或者读地址错了。检查字地址是否超出 0x00-0xFF 范围虽然 AT24C02 只有 256 字节但如果你传了 0x100HAL 库会截断成 0x00读出来就是地址 0x00 的数据。5.2 HAL_I2C_Mem_Write 返回 HAL_BUSY这个错误通常是因为 I2C 总线被卡住了。STM32F103 的 I2C 外设有几个已知的 errata其中一个是在某些异常情况下BUSY 位会一直置位软件复位也清不掉。解决办法是手动切换 SCL 和 SDA 的 GPIO 模式模拟几个时钟脉冲把总线解锁void I2C_BusRecovery(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; // 切换 SCL 和 SDA 为普通开漏输出 HAL_GPIO_DeInit(GPIOB, GPIO_PIN_6 | GPIO_PIN_7); GPIO_InitStruct.Pin GPIO_PIN_6 | GPIO_PIN_7; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, GPIO_InitStruct); // 发送 9 个时钟脉冲 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); } // 发送停止条件 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); HAL_Delay(1); // 重新初始化 I2C MX_I2C1_Init(); }这段代码的原理是如果从机在发送数据时被复位它可能一直拉着 SDA 不放导致总线死锁。发送 9 个时钟脉冲可以让从机把剩余的数据位发完然后释放 SDA。最后发送停止条件让总线回到空闲状态。5.3 写进去读出来数据错位这个问题通常是页写跨页导致的。比如你从地址 0x07 开始写 4 个字节期望写入 0x07、0x08、0x09、0x0A但实际上第 4 个字节会回卷到 0x00覆盖掉原来的数据。解决办法就是用前面提到的页写函数自动处理跨页边界。还有一种可能是写周期等待不够。AT24C02 的写周期最大 5ms如果你只延时了 1ms 就发下一个命令芯片可能还没准备好导致数据丢失。建议用 ACK 轮询代替固定延时或者把延时加到 10ms 保险。5.4 常见问题速查表现象可能原因排查方法解决方案读出来全是 0xFF总线未拉高、器件未响应量静态电平、探测地址检查上拉电阻、器件地址、WP 引脚读出来全是 0x00字地址错误、数据未写入检查字地址范围确认字地址在 0x00-0xFF返回 HAL_BUSY总线死锁检查 BUSY 位执行总线恢复流程返回 HAL_TIMEOUT从机未响应 ACK用逻辑分析仪抓波形检查器件地址、上拉电阻、电源数据错位页写跨页检查写入地址和长度使用页写边界处理函数写不进去WP 引脚为高量 WP 引脚电平WP 接 GND偶尔丢数据写周期等待不足增加延时或 ACK 轮询用 HAL_I2C_IsDeviceReady 等待5.5 实操心得与经验总结第一个心得先用逻辑分析仪抓波形再改代码。我见过太多人遇到问题就埋头改代码改了半天发现是硬件问题。逻辑分析仪能直接看到 SCL 和 SDA 上的实际波形起始条件、地址、ACK、数据一目了然。没有逻辑分析仪的话至少用示波器看两路波形确认电平和时序正常。第二个心得HAL 库的 I2C 函数超时时间不要设太长。我一般设 100ms超过这个时间还没响应说明硬件有问题继续等也没用。设太长会导致程序卡死设太短又容易误判。100ms 是个比较平衡的值。第三个心得AT24C02 的写次数是有限的。官方数据手册标称 100 万次擦写寿命数据保持 100 年。但这是理想条件下的数据实际使用中如果频繁写入寿命会打折扣。如果你的应用需要频繁保存数据建议加一个缓存机制只在数据真正变化时才写入 EEPROM或者用铁电存储器FRAM替代FRAM 的擦写次数几乎是无限的。第四个心得多字节读取时buffer 要足够大。我见过有人定义uint8_t buf[4]却读 8 个字节结果栈溢出程序跑飞。这种错误编译不报错运行时才出问题非常难查。建议在HAL_I2C_Mem_Read调用前加一个断言检查 buffer 大小是否足够。第五个心得I2C 速率不是越高越好。400kHz 虽然快但对硬件要求高走线长了、上拉大了都容易出问题。100kHz 虽然慢但稳定可靠对于 EEPROM 这种低速外设完全够用。我一般先用 100kHz 调通确认功能正常后再尝试 400kHz如果 400kHz 不稳定就退回 100kHz。6. 性能优化与扩展思路6.1 用 DMA 解放 CPU如果你需要频繁读写大量数据比如一次性写入 256 字节用轮询方式会阻塞 CPU 很长时间。这时候可以用 DMA 来搬运数据。STM32F103 的 I2C1 支持 DMA 请求CubeMX 里可以配置 DMA 通道。配置好之后HAL_I2C_Mem_Write_DMA和HAL_I2C_Mem_Read_DMA函数会在后台完成数据传输CPU 可以去做其他事情。但 DMA 方式有个坑I2C 的 DMA 请求是在每个字节传输完成后触发的不是一次性搬完。所以 DMA 传输时间仍然受 I2C 速率限制100kHz 下传输 256 字节大约需要 25ms不算写周期。DMA 的好处是 CPU 不用在 while 循环里空转可以进入低功耗模式或者处理其他任务。6.2 用结构体封装读写接口在实际项目中我习惯把 EEPROM 操作封装成结构体把器件地址、页大小、写周期等参数集中管理typedef struct { I2C_HandleTypeDef *hi2c; uint8_t devAddr; uint8_t pageSize; uint16_t writeCycle; } EEPROM_Handle; HAL_StatusTypeDef EEPROM_WriteByte(EEPROM_Handle *eeprom, uint8_t addr, uint8_t data); HAL_StatusTypeDef EEPROM_ReadByte(EEPROM_Handle *eeprom, uint8_t addr, uint8_t *data); HAL_StatusTypeDef EEPROM_WritePage(EEPROM_Handle *eeprom, uint8_t addr, uint8_t *data, uint16_t size);这样如果以后换成 AT24C04、AT24C08 或者别的 EEPROM 芯片只需要改结构体参数上层业务代码不用动。AT24C04 的页大小是 16 字节AT24C08 是 16 字节AT24C16 是 16 字节但地址位数不同封装好之后切换很方便。6.3 数据校验与掉电保护EEPROM 存储的数据在掉电时可能丢失尤其是写操作进行到一半时断电数据会处于不确定状态。我的做法是在数据后面加一个 CRC 校验字节读取时先校验 CRC如果校验失败就使用默认值。这样即使掉电导致数据损坏系统也能正常启动。typedef struct { uint32_t magic; // 魔数标识数据有效 uint16_t crc; // CRC16 校验 uint8_t data[32]; // 实际数据 } ConfigBlock;写入时先算好 CRC再一起写入。读取时先检查 magic 是否正确再校验 CRC。如果任何一项失败就加载默认配置并重新写入。这个机制在工业现场非常实用我做过的一个项目在强电磁干扰环境下运行EEPROM 数据偶尔会翻位加了 CRC 校验后系统稳定性大幅提升。6.4 从 AT24C02 扩展到其他 EEPROMAT24C02 只有 256 字节如果不够用可以无缝切换到 AT24C324KB、AT24C648KB甚至 AT24C25632KB。这些芯片的 I2C 协议基本兼容主要区别在于字地址位数AT24C02 是 8 位字地址AT24C32 及以上是 16 位字地址。HAL 库的HAL_I2C_Mem_Write函数有一个MemAddressSize参数传I2C_MEMADD_SIZE_8BIT或I2C_MEMADD_SIZE_16BIT就行。但要注意AT24C32 以上的芯片器件地址的低 3 位中有一部分被用作页地址实际可挂载的器件数量会减少。比如 AT24C64 只支持 4 个不同地址AT24C256 只支持 2 个。如果你需要挂载多个大容量 EEPROM要么用 I2C 多路复用器要么换用 SPI 接口的 EEPROM。提示从 AT24C02 切换到 AT24C32 时除了改字地址位数还要注意页大小从 8 字节变成 32 字节页写边界处理逻辑要相应调整。7. 调试工具与实战建议7.1 逻辑分析仪的选择与使用调试 I2C 最趁手的工具是逻辑分析仪。我手头用的是 8 通道 24MHz 采样率的廉价逻辑分析仪配合开源软件 PulseView 使用抓 I2C 波形完全够用。采样率至少要是被测信号频率的 4 倍以上100kHz 的 I2C 用 1MHz 采样率就能看清细节24MHz 更是绰绰有余。接线很简单通道 0 接 SCL通道 1 接 SDA地线接 GND。PulseView 里添加 I2C 解码器设置好 SCL 和 SDA 通道就能自动解析出起始条件、地址、读写位、ACK/NACK、数据字节。我每次调试 I2C 都先抓波形确认时序正常后再看代码效率比盲改代码高十倍。7.2 用 ST-Link 调试时的注意事项STM32F103 用 ST-Link 调试时如果程序卡在 I2C 的 while 循环里调试器可能无法暂停或者变量值不刷新。这是因为 I2C 外设的时钟在调试模式下可能被关闭。解决办法是在 CubeMX 的 Debug 配置里把DBGMCU_APB1_FZ的DBG_I2C1_SMBUS_TIMEOUT位使能这样调试暂停时 I2C 时钟继续运行不会影响调试。另外如果你在 I2C 通信过程中设置断点从机可能会因为超时复位而丢失状态。建议在 I2C 操作前后设置断点不要在传输过程中暂停。如果必须暂停先确认从机是否支持时钟拉伸Clock StretchingAT24C02 是支持的所以暂停时间不太长的话问题不大。7.3 实战建议先调通再优化我的习惯是分三步走第一步用最简单的字节读写把硬件链路调通确认能正确写入和读出第二步加上页写和连续读提高效率第三步根据项目需求决定是否上 DMA、是否加 CRC 校验、是否做掉电保护。不要一上来就追求完美先把基本功能跑通再逐步优化。还有一点保留一份最小可复现的测试代码。我每次调通一个新外设都会把最小可运行的代码单独存一份以后遇到类似项目直接复制粘贴省去重新配置的时间。这份代码里包含 CubeMX 的配置文件、初始化代码、读写函数和测试用例拿到新板子上改一下引脚就能用。这个项目后续还可以这样扩展把 EEPROM 读写封装成文件系统支持按文件名存取数据或者做一个参数管理模块支持参数的默认值、范围校验、版本迁移再或者结合 RTC把 EEPROM 当作日志存储记录设备运行状态。这些扩展我在其他项目里都做过核心的 I2C 读写逻辑和今天分享的完全一样把基础打牢了上层怎么玩都行。
实战与调优指南)
