做嵌入式这几年I2C这个接口几乎躲不开。STM32F103是入门教程里的常青树AT24C02又是网上出场率最高的EEPROM芯片这两个组合在一起正好能把I2C协议、驱动编写、调试方法和硬件电路串成一整条链路。这篇博文不是抄手册而是把实际调通这套读写流程的过程拆开讲包括踩过的坑、抓过的波形、改过的代码。如果你已经会点灯、会跑时钟但一碰到I2C就发怵或者被网上互相矛盾的硬件I2C和软件I2C说法绕晕那这篇内容应该能帮上忙。我会从项目选型一直讲到波形验证把关键环节的“为什么”一并交代清楚。1. 项目概述与整体设计思路1.1 这套组合到底在解决什么问题先聊需求。单片机运行时的变量都存在RAM里掉电就清零。可实际项目里总有些数据必须掉电保存设备地址、校准系数、用户偏好、开机次数甚至固件升级的版本号。EEPROM这种存储器的价值就在这儿按字节擦写、掉电不丢、寿命长。AT24C02的容量是2Kbit也就是256字节对存参数来说非常够用。有人会问STM32F103内部不是有Flash吗为什么还要外挂EEPROM因为内部Flash虽然容量大、速度快但它属于页擦除型存储器写之前必须先把整页擦掉而且擦写寿命一般在1万次左右。EEPROM按字节操作寿命动辄100万次适合频繁修改的小数据。两种存储用途不同实际项目中往往是Flash放代码EEPROM放参数各管各的。项目STM32F103内部FlashAT24C02 EEPROM容量64KB~512KB256字节擦写粒度整页擦除单字节擦写寿命约1万次约100万次速度较快慢I2C总线决定典型用途存代码存运行参数至于传输接口AT24C02使用I2C总线两线制地址固定。配合F103的任意两个GPIO就能工作不占用串口和SPI。所以我一般把它作为新手掌握I2C协议的第一个练习对象。1.2 为什么是I2C而不是SPI或串口I2C最大的特点是只需要两根线时钟线SCL和数据线SDA。一条总线上可以挂多个设备每个设备有一个地址。主机访问时先发地址从机应答后才会继续传输。AT24C02的地址由A0/A1/A2引脚组合决定所以理论上一条I2C总线上可以挂8颗同样的芯片而不冲突。相比之下SPI至少需要四根线读要单独的MISO线每个从机还要一根片选CS。UART只能点对点扩展性差。I2C适合低速、小数据量的数据交换EEPROM这种设备天生就是低速小数据用I2C非常合适。当然I2C也有局限比如总线电容大了信号会变形线太长不稳定但AT24C02的应用场景里这些都不是问题。1.3 硬件I2C还是软件模拟I2C这是F103系列经久不衰的争论。网上老有人说STM32硬件I2C有bug用了各种问题也有人说自己用得好好的。我的看法是如果目标是学习协议首选软件模拟如果目标是项目量产只要把硬件I2C的状态机调明白也可以用但排查成本确实高一些。软件模拟I2C本质上就是用普通GPIO按协议时序一个电平一个电平地翻转。好处是每一步都看得见中间卡在哪、哪里没应答单步调试就能定位移植到别的单片机只需要改引脚定义。同样的代码放在51、GD32、ESP32上都能跑思路完全一致。我这次就用软件模拟I2C讲全流程等你会分析时序了再去切硬件外设容易得多。2. AT24C02核心细节与I2C协议基础2.1 AT24C02的内部结构和地址玩法AT24C02内部有256个字节的存储单元地址范围0x00到0xFF每个字节都可以独立读写。芯片把存储空间分成32页每页8字节。这个“页”的概念会在后面的页写操作中直接坑人先记住它。I2C设备地址由芯片的固定前缀“1010”和A0、A1、A2三个引脚组合而来。A0/A1/A2都接地时写地址是0xA0读地址是0xA1。注意这是8位地址最后一位表示方向0是写1是读。如果设备挂载较多可以通过改变A0/A1/A2的电平生成不同地址。控制字节 bit7~bit0含义1 0 1 0 A2 A1 A0 0写入方向常用0xA01 0 1 0 A2 A1 A0 1读取方向常用0xA1页写有个典型陷阱页式写入时内部地址指针一旦写到页尾比如地址0x07会立刻回绕到该页的起始地址0x00不会自动跳到下一页。也就是说从0x05开始连续写4个字节实际是写到0x05、0x06、0x07然后回绕覆盖0x05和0x06。写数据长度超过页边界就会出现错乱。每次写操作结束后芯片需要最多5ms的内部编程时间这期间芯片不会响应任何总线请求。所以写完必须延时等待否则下一次读写过来时芯片可能还忙着数据对不上。我习惯写完统一延时10ms留足余量。2.2 I2C协议时序逐拍拆解I2C总线上所有操作都围绕SCL和SDA两根线的电平组合展开。空闲时两条线都要被上拉电阻拉高。起始信号SCL保持高电平的情况下SDA产生一个高到低的跳变表示主机开始占用总线。停止信号SCL为高电平时SDA从低回到高表示释放总线。数据传输的规矩是SDA的电平只能在SCL为低电平时改变SCL高电平时SDA必须保持稳定接收方就在SCL高电平时把数据读进去。举两个例子发送bit1先拉低SCL把SDA拉高然后拉高SCL保持一下再拉低发送bit0则相反SDA保持低。ACK应答机制像打电话里的“收到”。发送方每送完8位数据在第9个时钟周期释放SDA接收方如果正常接收就把SDA拉低这就是应答。如果接收方没有拉低说明要么地址错了、要么芯片没准备好。读操作时主机读完最后一个字节后要回NACK告诉从机不用再准备了然后发停止信号。这个细节很容易漏。把传输过程想象成两人配合装箱子SCL是口令SDA是动作。口令说“放下”你才能换动作口令说“读”对方就把当前动作照下来。起始和停止就是开场和散场的哨声理解这个画面协议就记住了一半。3. 硬件连接、上拉电阻计算与工程准备3.1 引脚分配与电路接法先讲接线。模拟I2C用PB6和PB7这俩引脚在很多F103最小系统板上都引出来了。连接AT24C02时SCL接PB6SDA接PB7VCC接3.3VGND共地。如果你的模块是成品板上自带I2C上拉电阻直接接线即可如果是裸芯片必须在SCL和SDA上各接一个上拉电阻到3.3V否则信号电平悬空波形乱七八糟。上拉电阻阻值有讲究。I2C标准模式最高100kHz要求信号上升沿不要超过1us。总线电容大约100到200pFRC时间常数等于阻值乘以总线电容4.7k乘以200pF约等于1us所以4.7k是常用值。开发板上引脚距离很近用4.7k完全没问题如果使用长线或者遇到电容偏大的情况可以降到2.2k到3.3k但不建议低于1k否则总线拉低时电流偏大主控芯片的IO驱动可能顶不住。再说一个经常被问的问题5V转3.3V电路。STM32F103供电是3.3VI2C上拉也要接3.3V千万不要图省事把上拉电阻接到5V。AT24C02本身供电范围很宽1.8V到5.5V都能工作但数据线电平必须和主机匹配。自制板需要从5V转3.3V时最简单方案就是用AMS1117-3.3这类LDO输入接5V输出3.3V输入输出各加一个10uF和0.1uF电容去耦。如果是成品开发板直接量一下3.3V引脚就行不用自己搭。3.2 Keil MDK工程搭建与ST-Link调试全流程代码环境说几句。我用Keil MDK加ST-Link调试流程大概是打开Keil新建工程芯片型号选STM32F103C8添加启动文件startup_stm32f10x_md.s建好main.c。如果不想依赖标准外设库直接用寄存器也行后面代码就是寄存器方式连库都不需要加。调试器设置Options for Target里选择ST-LinkDebug页选中ST-Link Debugger打开Settings确认能识别到SW-DP然后切到Flash Download页面勾选Reset and Run。ST-Link接线只需要四根线SWDIO接PA13、SWCLK接PA14、3.3V和GND接目标板供电。注意带ST-Link的排线如果接反方向可能导致识别不到芯片先量好电压再上电。还有一点如果用串口ISP下载过程序部分板子上的BOOT0跳帽位置会影响ST-Link连接排查时优先确认BOOT0为低电平。4. 软件I2C驱动从时序层到应用层4.1 第一步GPIO初始化与时序基础函数软件I2C的核心就是把协议时序翻译成GPIO的翻转动作。我用PB6做SCLPB7做SDA。GPIO配置成开漏输出开漏的好处是拉低能力强释放后靠上拉电阻回到高电平这和I2C多设备共线的机制完全匹配。读取SDA时要切到输入模式否则无法检测从机发出的应答信号。#include stm32f10x.h #define I2C_SCL_1 GPIOB-BSRR GPIO_Pin_6 #define I2C_SCL_0 GPIOB-BRR GPIO_Pin_6 #define I2C_SDA_1 GPIOB-BSRR GPIO_Pin_7 #define I2C_SDA_0 GPIOB-BRR GPIO_Pin_7 #define I2C_SDA_READ ((GPIOB-IDR GPIO_Pin_7) ! 0) static void SDA_Mode_Input(void) { GPIOB-CRL (GPIOB-CRL ~(0x0F (7*4))) | (0x08 (7*4)); GPIOB-BSRR GPIO_Pin_7; } static void SDA_Mode_Output(void) { GPIOB-CRL (GPIOB-CRL ~(0x0F (7*4))) | (0x07 (7*4)); } void I2C_GPIO_Init(void) { RCC-APB2ENR | RCC_APB2ENR_IOPBEN; GPIOB-CRL ~(0x0F (6*4)); GPIOB-CRL | (0x07 (6*4)); /* PB6 开漏输出 */ SDA_Mode_Output(); I2C_SDA_1; I2C_SCL_1; }这段代码没有依赖任何库直接操作寄存器。CRL寄存器控制PB0到PB7的模式每4位管一个引脚。0x07表示开漏输出50MHz0x08配合BSRR置位表示上拉输入。SDA在读和写之间切换模式是为了能检测到从机拉低的应答信号读完之后切回开漏输出继续发送数据。接下来是基础时序函数。延时不是越大越好也不是越小越好以SCL高电平时间满足芯片手册为准。AT24C02标准模式要求SCL高电平至少4.7us空循环几十次大概几微秒最终SCL频率约几十kHz实测很稳定。static void I2C_Delay(void) { volatile uint32_t t 20; while (t--); } static void I2C_Start(void) { I2C_SDA_1; I2C_SCL_1; I2C_Delay(); I2C_SDA_0; I2C_Delay(); I2C_SCL_0; I2C_Delay(); } static void I2C_Stop(void) { I2C_SDA_0; I2C_SCL_1; I2C_Delay(); I2C_SDA_1; I2C_Delay(); } static void I2C_WriteByte(uint8_t dat) { uint8_t i; SDA_Mode_Output(); for (i 0; i 8; i) { I2C_SCL_0; if (dat 0x80) I2C_SDA_1; else I2C_SDA_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); dat 1; } I2C_SCL_0; } static uint8_t I2C_WaitAck(void) { uint8_t timeout 50; SDA_Mode_Input(); I2C_SCL_1; I2C_Delay(); while (I2C_SDA_READ) { if (--timeout 0) { I2C_SCL_0; return 1; } } I2C_SCL_0; return 0; }I2C_Start先释放总线再拉低SDA产生起始沿。结束时先拉低SDA再把SCL拉高最后释放SDA形成停止沿。发送数据时逐位传输每一位都是SCL低电平改数据、SCL高电平保持数据。WaitAck把SDA切到输入并释放如果从机正常应答第9个时钟内SDA会被拉低如果一直读到高电平多半是地址错了或者芯片根本没在线上。我加了一个软件超时防止总线故障时程序卡死。读字节和主机应答函数如下。读数据时主机不输出SDA切输入每个SCL高电平期间读一位。连续读时倒数第二个字节读完要回ACK最后一个字节读完回NACK然后接停止信号。NACK的含义是告诉从机后面不用再准备了读到这里结束。static uint8_t I2C_ReadByte(void) { uint8_t i, dat 0; SDA_Mode_Input(); for (i 0; i 8; i) { I2C_SCL_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); dat 1; if (I2C_SDA_READ) dat | 0x01; } I2C_SCL_0; return dat; } static void I2C_SendAck(uint8_t ack) { SDA_Mode_Output(); if (ack) I2C_SDA_0; else I2C_SDA_1; I2C_SCL_1; I2C_Delay(); I2C_SCL_0; I2C_Delay(); SDA_Mode_Input(); }4.2 第二步AT24C02单字节读写有了时序层写EEPROM就是往总线上丢一帧数据。AT24C02单字节写帧格式是起始、写地址0xA0、字地址、数据、停止。每发完一个字节等一次应答最后等待内部写周期结束。void AT24C02_WriteByte(uint8_t addr, uint8_t data) { I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_WriteByte(data); I2C_WaitAck(); I2C_Stop(); delay_ms(10); } uint8_t AT24C02_ReadByte(uint8_t addr) { uint8_t val; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_Start(); I2C_WriteByte(0xA1); I2C_WaitAck(); val I2C_ReadByte(); I2C_SendAck(0); I2C_Stop(); return val; }读操作看一眼会发现它不是直接读而是先发一遍“写地址”把字地址送进去然后发重复起始信号把方向位改成读主机再读数据。这个重复起始信号很关键如果中间先发停止再重新起始芯片内部地址指针就会变化读出来的就不是目标地址了。这就是随机读的核心流程。我写代码时习惯在每帧结束加10ms延时。延时函数可以是SysTick实现也可以用简单循环精度要求不高EEPROM写周期上限5ms延时10ms是安全值。4.3 第三步页写和连续读的边界处理前面讲过页写跨页会回绕。AT24C02允许一次连续写最多8字节但前提是这批数据不能跨越8字节的页边界。从地址0x05开始写8字节实际写到第4个字节就撞上0x07页尾然后地址回绕到0x00继续覆盖之前的数据。void AT24C02_WritePage(uint8_t addr, uint8_t *buf, uint8_t len) { uint8_t i; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); for (i 0; i len; i) { I2C_WriteByte(buf[i]); I2C_WaitAck(); } I2C_Stop(); delay_ms(10); }这个函数本身不判断跨页调用时要注意。如果确实要写一批跨页数据我会先算当前页剩余空间例如起始地址0x03一页8字节页尾0x07剩余空间就是0x08减去(0x03对0x08取余)结果等于5字节。超过5字节就必须拆成两段分别调用页写函数。实际项目里更好的做法是写一个通用分页函数按8字节一组切第一段先补到页尾后面再逐页写。连续读的逻辑则简单很多读操作开始后芯片地址指针自动加1主机持续给ACK就能一直往下读。void AT24C02_ReadBytes(uint8_t addr, uint8_t *buf, uint8_t len) { uint8_t i; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_Start(); I2C_WriteByte(0xA1); I2C_WaitAck(); for (i 0; i len; i) { buf[i] I2C_ReadByte(); if (i len - 1) I2C_SendAck(0); else I2C_SendAck(1); } I2C_Stop(); }注意最后一位回NACK否则从机不知道传输结束总线释放不干净后面的通信可能被拖住。4.4 用一个测试用例把读写串起来驱动写完写个小用例验证。思路很简单初始化GPIO写一页8字节数据到0x00地址延时后读回来在调试器里对比数组内容。int main(void) { uint8_t wbuf[8] {0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88}; uint8_t rbuf[8] {0}; I2C_GPIO_Init(); AT24C02_WritePage(0x00, wbuf, 8); delay_ms(10); AT24C02_ReadBytes(0x00, rbuf, 8); while (1); }在调试模式下给AT24C02_ReadBytes下断点观察rbuf数组8个数据能和wbuf完全对上说明整套流程通了。如果读出来全是0xFF优先检查接线和上拉电阻如果中间某两个数据对不上十有八九是页写跨页或写周期等待不足。还可以故意把读地址改成0x10读出来的数据完全是随机值进一步验证地址选择会直接影响数据位置。5. 实操过程与波形验证5.1 实际接线和调试记录这次用的是STM32F103C8T6最小系统板外接一个AT24C02模块。接线就四根PB6接SCLPB7接SDAVCC接3.3VGND接GND。要提醒一句开发板的3.3V和5V不要同时接模块如果模块自带稳压最好单独供电避免模块和开发板的电源相互干扰。编译下载后在调试器里看rbuf数组8个字节和wbuf完全一致。随后我把读地址改成0x10再试发现数据变成了一串随机值说明地址选择直接影响数据位置读链路整体是通的。这个验证看起来简单实际上已经把起始、停止、地址、应答、数据位全部测了一遍。5.2 用逻辑分析仪抓I2C波形软件跑通后强烈建议用逻辑分析仪抓一次波形。把探头夹到SCL和SDA采样率设1MHz以上就能看到起始、停止、ACK这些特征。我第一次抓波形时发现如果没接上拉电阻SDA的上升沿像被“拖着”到了高电平还要抖一阵这是RC时间常数太大。换成4.7k电阻后波形干净了很多。波形判读有几个关键特征SCL高电平期间SDA产生下降沿说明是起始信号SCL高电平期间SDA产生上升沿说明是停止信号SCL高电平期间SDA电平稳定每隔8位出现一个ACK低电平说明数据帧正常。如果第9个时钟SDA仍为高就是无应答直接查地址和接线。没有逻辑分析仪时用示波器也能看DC耦合时间轴20us一格。但逻辑分析仪最大优势是能直接解析I2C报文显示主机发的是0xA0还是0xA1哪个设备应答了非常直观。调试I2C总线效率能提升一个档次。6. 常见问题与排查技巧实录6.1 总线卡死SDA一直被拉低最常遇到的故障是SDA一直为低总线上什么设备都交互不了。原因一般是某个从设备的总线状态机乱了比如写周期还没等完就发下一个起始或者中途拔线导致时钟状态中断。AT24C02本身很皮实但遇到这种情况还是需要用软件解锁给SCL打9个时钟脉冲SDA保持高然后发一个起始再加停止让从机从非法状态复位。void I2C_BusReset(void) { uint8_t i; SDA_Mode_Output(); I2C_SDA_1; for (i 0; i 9; i) { I2C_SCL_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); } I2C_Start(); I2C_Stop(); }这个复位函数本质上是强制所有从机重新初始化内部状态机。如果复位后依然卡住就要回头查硬件上有无短路、VCC对不对而不是继续折腾软件。6.2 读出来全是0xFF或者0x00读数据全0xFF基本是芯片根本没参与通信。先确认接线和供电然后用逻辑分析仪看发出0xA0地址时有没有ACK。没有ACK时检查A0/A1/A2引脚有没有和别的线短路模块有没有焊好。如果读出来全0x00则更像是写入失败数据根本没进芯片或者写地址和读地址没对上。建议先单字节写一个固定值0x5A到地址0x00再读回来一步一步缩小范围。现象可能原因排查办法SDA一直低设备状态机卡死、总线短路软件复位、断电重启读全0xFF地址无应答、上拉缺失测ACK、检查供电读全0x00写入失败、地址不对单字节写固定值再读数据错乱回绕页写跨页限制8字节内并避开页尾写后立即读失败tWR未等待写后延时10ms6.3 页写数据错乱页写超过页边界会回绕覆盖。比如从地址0x05开始写8个字节0x01到0x08前4个字节写到0x05到0x07第5个字节地址回绕到0x00于是0x00到0x07读出来是0x05、0x06、0x07、0x08、0x01、0x02、0x03、0x04完全错位。没有分页逻辑时这个现象看起来就像随机丢数据非常迷惑人。所以工程里写页函数前一定要先算剩余空间跨页就拆成多组。这个逻辑不复杂但能省掉后期大量排查时间。我后来封装了一个通用分页写入函数输入起始地址、缓冲区、长度内部自动按页切分业务代码里再也不用关心页边界。6.4 调试心得与速查表做了几个项目之后我对I2C调试的总结就一句话先用逻辑分析仪确认总线上有没有正确的波形再怀疑代码逻辑。软件问题能通过波形和ACK快速定位硬件问题则集中在供电和上拉。很多朋友一上来就调代码其实示波器上波形是乱的代码写得再对也没用。模拟I2C的延时也不是越大越好。延时太大整体读写速度偏慢延时太小SCL高电平保持时间不够芯片不认。我把延时放在3us附近实测稳定。如果你把主频改了或者换了其他I2C器件按照芯片手册的时序参数重新估算延时即可。最后再提一个经验把AT24C02的设备地址0xA0/0xA1和页边界8字节这两条规则贴在调试台上。后面再做OLED屏、RTC、各类传感器I2C的核心套路完全一样这些基础打得越牢换芯片时越省事。
做嵌入式这几年I2C这个接口几乎躲不开。STM32F103是入门教程里的常青树AT24C02又是网上出场率最高的EEPROM芯片这两个组合在一起正好能把I2C协议、驱动编写、调试方法和硬件电路串成一整条链路。这篇博文不是抄手册而是把实际调通这套读写流程的过程拆开讲包括踩过的坑、抓过的波形、改过的代码。如果你已经会点灯、会跑时钟但一碰到I2C就发怵或者被网上互相矛盾的硬件I2C和软件I2C说法绕晕那这篇内容应该能帮上忙。我会从项目选型一直讲到波形验证把关键环节的“为什么”一并交代清楚。1. 项目概述与整体设计思路1.1 这套组合到底在解决什么问题先聊需求。单片机运行时的变量都存在RAM里掉电就清零。可实际项目里总有些数据必须掉电保存设备地址、校准系数、用户偏好、开机次数甚至固件升级的版本号。EEPROM这种存储器的价值就在这儿按字节擦写、掉电不丢、寿命长。AT24C02的容量是2Kbit也就是256字节对存参数来说非常够用。有人会问STM32F103内部不是有Flash吗为什么还要外挂EEPROM因为内部Flash虽然容量大、速度快但它属于页擦除型存储器写之前必须先把整页擦掉而且擦写寿命一般在1万次左右。EEPROM按字节操作寿命动辄100万次适合频繁修改的小数据。两种存储用途不同实际项目中往往是Flash放代码EEPROM放参数各管各的。项目STM32F103内部FlashAT24C02 EEPROM容量64KB~512KB256字节擦写粒度整页擦除单字节擦写寿命约1万次约100万次速度较快慢I2C总线决定典型用途存代码存运行参数至于传输接口AT24C02使用I2C总线两线制地址固定。配合F103的任意两个GPIO就能工作不占用串口和SPI。所以我一般把它作为新手掌握I2C协议的第一个练习对象。1.2 为什么是I2C而不是SPI或串口I2C最大的特点是只需要两根线时钟线SCL和数据线SDA。一条总线上可以挂多个设备每个设备有一个地址。主机访问时先发地址从机应答后才会继续传输。AT24C02的地址由A0/A1/A2引脚组合决定所以理论上一条I2C总线上可以挂8颗同样的芯片而不冲突。相比之下SPI至少需要四根线读要单独的MISO线每个从机还要一根片选CS。UART只能点对点扩展性差。I2C适合低速、小数据量的数据交换EEPROM这种设备天生就是低速小数据用I2C非常合适。当然I2C也有局限比如总线电容大了信号会变形线太长不稳定但AT24C02的应用场景里这些都不是问题。1.3 硬件I2C还是软件模拟I2C这是F103系列经久不衰的争论。网上老有人说STM32硬件I2C有bug用了各种问题也有人说自己用得好好的。我的看法是如果目标是学习协议首选软件模拟如果目标是项目量产只要把硬件I2C的状态机调明白也可以用但排查成本确实高一些。软件模拟I2C本质上就是用普通GPIO按协议时序一个电平一个电平地翻转。好处是每一步都看得见中间卡在哪、哪里没应答单步调试就能定位移植到别的单片机只需要改引脚定义。同样的代码放在51、GD32、ESP32上都能跑思路完全一致。我这次就用软件模拟I2C讲全流程等你会分析时序了再去切硬件外设容易得多。2. AT24C02核心细节与I2C协议基础2.1 AT24C02的内部结构和地址玩法AT24C02内部有256个字节的存储单元地址范围0x00到0xFF每个字节都可以独立读写。芯片把存储空间分成32页每页8字节。这个“页”的概念会在后面的页写操作中直接坑人先记住它。I2C设备地址由芯片的固定前缀“1010”和A0、A1、A2三个引脚组合而来。A0/A1/A2都接地时写地址是0xA0读地址是0xA1。注意这是8位地址最后一位表示方向0是写1是读。如果设备挂载较多可以通过改变A0/A1/A2的电平生成不同地址。控制字节 bit7~bit0含义1 0 1 0 A2 A1 A0 0写入方向常用0xA01 0 1 0 A2 A1 A0 1读取方向常用0xA1页写有个典型陷阱页式写入时内部地址指针一旦写到页尾比如地址0x07会立刻回绕到该页的起始地址0x00不会自动跳到下一页。也就是说从0x05开始连续写4个字节实际是写到0x05、0x06、0x07然后回绕覆盖0x05和0x06。写数据长度超过页边界就会出现错乱。每次写操作结束后芯片需要最多5ms的内部编程时间这期间芯片不会响应任何总线请求。所以写完必须延时等待否则下一次读写过来时芯片可能还忙着数据对不上。我习惯写完统一延时10ms留足余量。2.2 I2C协议时序逐拍拆解I2C总线上所有操作都围绕SCL和SDA两根线的电平组合展开。空闲时两条线都要被上拉电阻拉高。起始信号SCL保持高电平的情况下SDA产生一个高到低的跳变表示主机开始占用总线。停止信号SCL为高电平时SDA从低回到高表示释放总线。数据传输的规矩是SDA的电平只能在SCL为低电平时改变SCL高电平时SDA必须保持稳定接收方就在SCL高电平时把数据读进去。举两个例子发送bit1先拉低SCL把SDA拉高然后拉高SCL保持一下再拉低发送bit0则相反SDA保持低。ACK应答机制像打电话里的“收到”。发送方每送完8位数据在第9个时钟周期释放SDA接收方如果正常接收就把SDA拉低这就是应答。如果接收方没有拉低说明要么地址错了、要么芯片没准备好。读操作时主机读完最后一个字节后要回NACK告诉从机不用再准备了然后发停止信号。这个细节很容易漏。把传输过程想象成两人配合装箱子SCL是口令SDA是动作。口令说“放下”你才能换动作口令说“读”对方就把当前动作照下来。起始和停止就是开场和散场的哨声理解这个画面协议就记住了一半。3. 硬件连接、上拉电阻计算与工程准备3.1 引脚分配与电路接法先讲接线。模拟I2C用PB6和PB7这俩引脚在很多F103最小系统板上都引出来了。连接AT24C02时SCL接PB6SDA接PB7VCC接3.3VGND共地。如果你的模块是成品板上自带I2C上拉电阻直接接线即可如果是裸芯片必须在SCL和SDA上各接一个上拉电阻到3.3V否则信号电平悬空波形乱七八糟。上拉电阻阻值有讲究。I2C标准模式最高100kHz要求信号上升沿不要超过1us。总线电容大约100到200pFRC时间常数等于阻值乘以总线电容4.7k乘以200pF约等于1us所以4.7k是常用值。开发板上引脚距离很近用4.7k完全没问题如果使用长线或者遇到电容偏大的情况可以降到2.2k到3.3k但不建议低于1k否则总线拉低时电流偏大主控芯片的IO驱动可能顶不住。再说一个经常被问的问题5V转3.3V电路。STM32F103供电是3.3VI2C上拉也要接3.3V千万不要图省事把上拉电阻接到5V。AT24C02本身供电范围很宽1.8V到5.5V都能工作但数据线电平必须和主机匹配。自制板需要从5V转3.3V时最简单方案就是用AMS1117-3.3这类LDO输入接5V输出3.3V输入输出各加一个10uF和0.1uF电容去耦。如果是成品开发板直接量一下3.3V引脚就行不用自己搭。3.2 Keil MDK工程搭建与ST-Link调试全流程代码环境说几句。我用Keil MDK加ST-Link调试流程大概是打开Keil新建工程芯片型号选STM32F103C8添加启动文件startup_stm32f10x_md.s建好main.c。如果不想依赖标准外设库直接用寄存器也行后面代码就是寄存器方式连库都不需要加。调试器设置Options for Target里选择ST-LinkDebug页选中ST-Link Debugger打开Settings确认能识别到SW-DP然后切到Flash Download页面勾选Reset and Run。ST-Link接线只需要四根线SWDIO接PA13、SWCLK接PA14、3.3V和GND接目标板供电。注意带ST-Link的排线如果接反方向可能导致识别不到芯片先量好电压再上电。还有一点如果用串口ISP下载过程序部分板子上的BOOT0跳帽位置会影响ST-Link连接排查时优先确认BOOT0为低电平。4. 软件I2C驱动从时序层到应用层4.1 第一步GPIO初始化与时序基础函数软件I2C的核心就是把协议时序翻译成GPIO的翻转动作。我用PB6做SCLPB7做SDA。GPIO配置成开漏输出开漏的好处是拉低能力强释放后靠上拉电阻回到高电平这和I2C多设备共线的机制完全匹配。读取SDA时要切到输入模式否则无法检测从机发出的应答信号。#include stm32f10x.h #define I2C_SCL_1 GPIOB-BSRR GPIO_Pin_6 #define I2C_SCL_0 GPIOB-BRR GPIO_Pin_6 #define I2C_SDA_1 GPIOB-BSRR GPIO_Pin_7 #define I2C_SDA_0 GPIOB-BRR GPIO_Pin_7 #define I2C_SDA_READ ((GPIOB-IDR GPIO_Pin_7) ! 0) static void SDA_Mode_Input(void) { GPIOB-CRL (GPIOB-CRL ~(0x0F (7*4))) | (0x08 (7*4)); GPIOB-BSRR GPIO_Pin_7; } static void SDA_Mode_Output(void) { GPIOB-CRL (GPIOB-CRL ~(0x0F (7*4))) | (0x07 (7*4)); } void I2C_GPIO_Init(void) { RCC-APB2ENR | RCC_APB2ENR_IOPBEN; GPIOB-CRL ~(0x0F (6*4)); GPIOB-CRL | (0x07 (6*4)); /* PB6 开漏输出 */ SDA_Mode_Output(); I2C_SDA_1; I2C_SCL_1; }这段代码没有依赖任何库直接操作寄存器。CRL寄存器控制PB0到PB7的模式每4位管一个引脚。0x07表示开漏输出50MHz0x08配合BSRR置位表示上拉输入。SDA在读和写之间切换模式是为了能检测到从机拉低的应答信号读完之后切回开漏输出继续发送数据。接下来是基础时序函数。延时不是越大越好也不是越小越好以SCL高电平时间满足芯片手册为准。AT24C02标准模式要求SCL高电平至少4.7us空循环几十次大概几微秒最终SCL频率约几十kHz实测很稳定。static void I2C_Delay(void) { volatile uint32_t t 20; while (t--); } static void I2C_Start(void) { I2C_SDA_1; I2C_SCL_1; I2C_Delay(); I2C_SDA_0; I2C_Delay(); I2C_SCL_0; I2C_Delay(); } static void I2C_Stop(void) { I2C_SDA_0; I2C_SCL_1; I2C_Delay(); I2C_SDA_1; I2C_Delay(); } static void I2C_WriteByte(uint8_t dat) { uint8_t i; SDA_Mode_Output(); for (i 0; i 8; i) { I2C_SCL_0; if (dat 0x80) I2C_SDA_1; else I2C_SDA_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); dat 1; } I2C_SCL_0; } static uint8_t I2C_WaitAck(void) { uint8_t timeout 50; SDA_Mode_Input(); I2C_SCL_1; I2C_Delay(); while (I2C_SDA_READ) { if (--timeout 0) { I2C_SCL_0; return 1; } } I2C_SCL_0; return 0; }I2C_Start先释放总线再拉低SDA产生起始沿。结束时先拉低SDA再把SCL拉高最后释放SDA形成停止沿。发送数据时逐位传输每一位都是SCL低电平改数据、SCL高电平保持数据。WaitAck把SDA切到输入并释放如果从机正常应答第9个时钟内SDA会被拉低如果一直读到高电平多半是地址错了或者芯片根本没在线上。我加了一个软件超时防止总线故障时程序卡死。读字节和主机应答函数如下。读数据时主机不输出SDA切输入每个SCL高电平期间读一位。连续读时倒数第二个字节读完要回ACK最后一个字节读完回NACK然后接停止信号。NACK的含义是告诉从机后面不用再准备了读到这里结束。static uint8_t I2C_ReadByte(void) { uint8_t i, dat 0; SDA_Mode_Input(); for (i 0; i 8; i) { I2C_SCL_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); dat 1; if (I2C_SDA_READ) dat | 0x01; } I2C_SCL_0; return dat; } static void I2C_SendAck(uint8_t ack) { SDA_Mode_Output(); if (ack) I2C_SDA_0; else I2C_SDA_1; I2C_SCL_1; I2C_Delay(); I2C_SCL_0; I2C_Delay(); SDA_Mode_Input(); }4.2 第二步AT24C02单字节读写有了时序层写EEPROM就是往总线上丢一帧数据。AT24C02单字节写帧格式是起始、写地址0xA0、字地址、数据、停止。每发完一个字节等一次应答最后等待内部写周期结束。void AT24C02_WriteByte(uint8_t addr, uint8_t data) { I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_WriteByte(data); I2C_WaitAck(); I2C_Stop(); delay_ms(10); } uint8_t AT24C02_ReadByte(uint8_t addr) { uint8_t val; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_Start(); I2C_WriteByte(0xA1); I2C_WaitAck(); val I2C_ReadByte(); I2C_SendAck(0); I2C_Stop(); return val; }读操作看一眼会发现它不是直接读而是先发一遍“写地址”把字地址送进去然后发重复起始信号把方向位改成读主机再读数据。这个重复起始信号很关键如果中间先发停止再重新起始芯片内部地址指针就会变化读出来的就不是目标地址了。这就是随机读的核心流程。我写代码时习惯在每帧结束加10ms延时。延时函数可以是SysTick实现也可以用简单循环精度要求不高EEPROM写周期上限5ms延时10ms是安全值。4.3 第三步页写和连续读的边界处理前面讲过页写跨页会回绕。AT24C02允许一次连续写最多8字节但前提是这批数据不能跨越8字节的页边界。从地址0x05开始写8字节实际写到第4个字节就撞上0x07页尾然后地址回绕到0x00继续覆盖之前的数据。void AT24C02_WritePage(uint8_t addr, uint8_t *buf, uint8_t len) { uint8_t i; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); for (i 0; i len; i) { I2C_WriteByte(buf[i]); I2C_WaitAck(); } I2C_Stop(); delay_ms(10); }这个函数本身不判断跨页调用时要注意。如果确实要写一批跨页数据我会先算当前页剩余空间例如起始地址0x03一页8字节页尾0x07剩余空间就是0x08减去(0x03对0x08取余)结果等于5字节。超过5字节就必须拆成两段分别调用页写函数。实际项目里更好的做法是写一个通用分页函数按8字节一组切第一段先补到页尾后面再逐页写。连续读的逻辑则简单很多读操作开始后芯片地址指针自动加1主机持续给ACK就能一直往下读。void AT24C02_ReadBytes(uint8_t addr, uint8_t *buf, uint8_t len) { uint8_t i; I2C_Start(); I2C_WriteByte(0xA0); I2C_WaitAck(); I2C_WriteByte(addr); I2C_WaitAck(); I2C_Start(); I2C_WriteByte(0xA1); I2C_WaitAck(); for (i 0; i len; i) { buf[i] I2C_ReadByte(); if (i len - 1) I2C_SendAck(0); else I2C_SendAck(1); } I2C_Stop(); }注意最后一位回NACK否则从机不知道传输结束总线释放不干净后面的通信可能被拖住。4.4 用一个测试用例把读写串起来驱动写完写个小用例验证。思路很简单初始化GPIO写一页8字节数据到0x00地址延时后读回来在调试器里对比数组内容。int main(void) { uint8_t wbuf[8] {0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77, 0x88}; uint8_t rbuf[8] {0}; I2C_GPIO_Init(); AT24C02_WritePage(0x00, wbuf, 8); delay_ms(10); AT24C02_ReadBytes(0x00, rbuf, 8); while (1); }在调试模式下给AT24C02_ReadBytes下断点观察rbuf数组8个数据能和wbuf完全对上说明整套流程通了。如果读出来全是0xFF优先检查接线和上拉电阻如果中间某两个数据对不上十有八九是页写跨页或写周期等待不足。还可以故意把读地址改成0x10读出来的数据完全是随机值进一步验证地址选择会直接影响数据位置。5. 实操过程与波形验证5.1 实际接线和调试记录这次用的是STM32F103C8T6最小系统板外接一个AT24C02模块。接线就四根PB6接SCLPB7接SDAVCC接3.3VGND接GND。要提醒一句开发板的3.3V和5V不要同时接模块如果模块自带稳压最好单独供电避免模块和开发板的电源相互干扰。编译下载后在调试器里看rbuf数组8个字节和wbuf完全一致。随后我把读地址改成0x10再试发现数据变成了一串随机值说明地址选择直接影响数据位置读链路整体是通的。这个验证看起来简单实际上已经把起始、停止、地址、应答、数据位全部测了一遍。5.2 用逻辑分析仪抓I2C波形软件跑通后强烈建议用逻辑分析仪抓一次波形。把探头夹到SCL和SDA采样率设1MHz以上就能看到起始、停止、ACK这些特征。我第一次抓波形时发现如果没接上拉电阻SDA的上升沿像被“拖着”到了高电平还要抖一阵这是RC时间常数太大。换成4.7k电阻后波形干净了很多。波形判读有几个关键特征SCL高电平期间SDA产生下降沿说明是起始信号SCL高电平期间SDA产生上升沿说明是停止信号SCL高电平期间SDA电平稳定每隔8位出现一个ACK低电平说明数据帧正常。如果第9个时钟SDA仍为高就是无应答直接查地址和接线。没有逻辑分析仪时用示波器也能看DC耦合时间轴20us一格。但逻辑分析仪最大优势是能直接解析I2C报文显示主机发的是0xA0还是0xA1哪个设备应答了非常直观。调试I2C总线效率能提升一个档次。6. 常见问题与排查技巧实录6.1 总线卡死SDA一直被拉低最常遇到的故障是SDA一直为低总线上什么设备都交互不了。原因一般是某个从设备的总线状态机乱了比如写周期还没等完就发下一个起始或者中途拔线导致时钟状态中断。AT24C02本身很皮实但遇到这种情况还是需要用软件解锁给SCL打9个时钟脉冲SDA保持高然后发一个起始再加停止让从机从非法状态复位。void I2C_BusReset(void) { uint8_t i; SDA_Mode_Output(); I2C_SDA_1; for (i 0; i 9; i) { I2C_SCL_0; I2C_Delay(); I2C_SCL_1; I2C_Delay(); } I2C_Start(); I2C_Stop(); }这个复位函数本质上是强制所有从机重新初始化内部状态机。如果复位后依然卡住就要回头查硬件上有无短路、VCC对不对而不是继续折腾软件。6.2 读出来全是0xFF或者0x00读数据全0xFF基本是芯片根本没参与通信。先确认接线和供电然后用逻辑分析仪看发出0xA0地址时有没有ACK。没有ACK时检查A0/A1/A2引脚有没有和别的线短路模块有没有焊好。如果读出来全0x00则更像是写入失败数据根本没进芯片或者写地址和读地址没对上。建议先单字节写一个固定值0x5A到地址0x00再读回来一步一步缩小范围。现象可能原因排查办法SDA一直低设备状态机卡死、总线短路软件复位、断电重启读全0xFF地址无应答、上拉缺失测ACK、检查供电读全0x00写入失败、地址不对单字节写固定值再读数据错乱回绕页写跨页限制8字节内并避开页尾写后立即读失败tWR未等待写后延时10ms6.3 页写数据错乱页写超过页边界会回绕覆盖。比如从地址0x05开始写8个字节0x01到0x08前4个字节写到0x05到0x07第5个字节地址回绕到0x00于是0x00到0x07读出来是0x05、0x06、0x07、0x08、0x01、0x02、0x03、0x04完全错位。没有分页逻辑时这个现象看起来就像随机丢数据非常迷惑人。所以工程里写页函数前一定要先算剩余空间跨页就拆成多组。这个逻辑不复杂但能省掉后期大量排查时间。我后来封装了一个通用分页写入函数输入起始地址、缓冲区、长度内部自动按页切分业务代码里再也不用关心页边界。6.4 调试心得与速查表做了几个项目之后我对I2C调试的总结就一句话先用逻辑分析仪确认总线上有没有正确的波形再怀疑代码逻辑。软件问题能通过波形和ACK快速定位硬件问题则集中在供电和上拉。很多朋友一上来就调代码其实示波器上波形是乱的代码写得再对也没用。模拟I2C的延时也不是越大越好。延时太大整体读写速度偏慢延时太小SCL高电平保持时间不够芯片不认。我把延时放在3us附近实测稳定。如果你把主频改了或者换了其他I2C器件按照芯片手册的时序参数重新估算延时即可。最后再提一个经验把AT24C02的设备地址0xA0/0xA1和页边界8字节这两条规则贴在调试台上。后面再做OLED屏、RTC、各类传感器I2C的核心套路完全一样这些基础打得越牢换芯片时越省事。
