1. 为什么I2C调试总让人又爱又恨搞嵌入式的人迟早要跟I2C打交道。它引脚少、协议简单、挂载设备多EEPROM、OLED、各类传感器、RTC、IO扩展芯片几乎都走I2C。但真正上手调试的时候很多人会发现明明接线没错代码也是抄的例程设备就是没反应。示波器一挂波形要么拉不起来要么ACK位死活不对要么读出来的数据全是0xFF。我做了十多年嵌入式从8位机到ARM Cortex-A系列从裸机到LinuxI2C外设调试踩过的坑能写一本书。这篇内容就是把我这些年调试I2C设备的思路完整梳理一遍从硬件层到协议层再到系统层把“怎么定位问题”这件事讲透。不管你是刚接触嵌入式的学生还是工作几年但一遇到I2C就头疼的工程师这篇内容都能给你一套可以直接复用的排查框架。核心关键词嵌入式、I2C、外设调试、i2c-tools、设备树。这几个词基本覆盖了I2C调试的完整链路——硬件协议是基础i2c-tools是Linux下的利器设备树是嵌入式Linux必须跨过的门槛。我会按照“先通协议、再查硬件、后调系统”的顺序展开每一层都给出具体的操作方法和判断依据。2. I2C协议层先把时序这件事搞明白2.1 两根线背后的通信逻辑I2C只有两根信号线SCL和SDA。SCL是时钟线SDA是数据线。所有通信都由主机发起从机被动响应。很多人觉得I2C简单就是因为线少。但线少不代表逻辑简单恰恰因为只有两根线所有信息——起始、地址、数据、应答、停止——都靠这两根线的电平变化来编码。起始条件StartSCL为高电平时SDA从高变低。停止条件StopSCL为高电平时SDA从低变高。这两个条件必须由主机产生从机不会主动发起。数据位传输SCL为低电平时SDA上的数据可以变化SCL为高电平时SDA必须保持稳定接收方在这个时刻采样。应答位ACK/NACK每传输完8位数据接收方需要在第9个时钟周期把SDA拉低表示应答。如果接收方没有拉低就是NACK。主机读数据时发完最后一个字节后要发NACK然后发停止条件。这些概念看起来基础但实际调试中80%的问题都出在这些基础环节。比如SDA在SCL高电平期间发生了变化从机就会误判为起始或停止条件导致通信错乱。再比如上拉电阻太大上升沿太缓SCL高电平期间SDA还没稳定采样就会出错。2.2 时钟频率与上拉电阻的匹配关系I2C标准模式100kHz快速模式400kHz高速模式3.4MHz。频率越高对上升沿的要求越严格。上升时间由总线电容和上拉电阻共同决定公式是t_r ≈ 0.847 × R_pullup × C_bus标准模式下上升时间要求小于1000ns快速模式小于300ns。假设总线电容100pF标准模式下上拉电阻最大约11.8kΩ快速模式下最大约3.5kΩ。实际选型时通常用4.7kΩ或2.2kΩ就是留了余量。我见过太多人用10kΩ上拉跑400kHz结果波形上升沿像山坡一样缓从机根本识别不了。也见过有人用1kΩ上拉功耗大不说有些从机的灌电流能力不够SDA拉不低直接通信失败。上拉电阻的选择要同时考虑总线电容、通信速率和从机的电气特性不是随便放一个就行。2.3 地址格式与读写位I2C的7位地址加上1位读写标志组成第一个字节。写操作时最低位为0读操作时为1。比如一个设备的7位地址是0x3C写地址就是0x78读地址就是0x79。很多数据手册直接给出8位地址这时候要注意区分它给的是包含读写位的还是纯7位地址。有些设备支持10位地址但实际项目中很少遇到。绝大多数传感器、EEPROM、OLED都是7位地址。调试时如果地址搞错设备根本不会应答。用i2c-tools的i2cdetect扫描时它显示的是7位地址这一点要记住。3. 硬件层排查从原理图到示波器3.1 上电前的静态检查拿到一块新板子不要急着上电写代码。先做静态检查用万用表测SCL和SDA对地的阻抗确认没有短路。测SCL和SDA之间的阻抗确认没有互相短路。测上拉电阻的阻值确认焊接正确。测从机电源引脚对地阻抗确认没有电源短路。这些检查花不了几分钟但能避免烧芯片。我见过有人上电后发现电流异常大一查是SDA和VCC短路了芯片已经冒烟。静态检查是最低成本的保护措施。3.2 上电后的电平检查上电后先不通信用万用表或示波器测SCL和SDA的静态电平。正常情况下两根线都应该被上拉到高电平。如果某根线一直是低电平说明有设备在拉低它可能是从机损坏也可能是主机GPIO配置成了输出低。如果两根线都是高电平说明总线空闲状态正常。这时候可以尝试通信用示波器观察波形。如果SCL没有波形说明主机根本没有发起通信问题在主机端。如果SCL有波形但SDA没有变化说明主机没有正确发送数据或者SDA线断了。3.3 示波器抓波形的关键观察点用示波器抓I2C波形时重点看这几个地方起始条件是否干净SDA下降沿时SCL是否稳定在高电平地址字节是否正确对照数据手册逐位核对ACK位是否被拉低第9个时钟周期SDA是否被从机拉低数据字节是否符合预期读操作时从机输出的数据是否正确停止条件是否完整SDA上升沿时SCL是否稳定在高电平如果ACK位没有被拉低说明从机没有响应。可能原因地址错误、从机未上电、从机损坏、从机处于复位状态、上拉电阻不合适导致从机识别不到起始条件。我习惯用双通道示波器同时抓SCL和SDA触发方式设为SDA下降沿起始条件。这样每次通信都能完整捕获。如果示波器有I2C解码功能直接打开解码地址、数据、ACK都会标注出来效率高很多。4. Linux下的I2C调试利器i2c-tools实战4.1 i2c-tools的安装与基本用法在嵌入式Linux系统里i2c-tools是调试I2C设备的第一工具。它包含几个核心命令i2cdetect、i2cget、i2cset、i2cdump、i2ctransfer。安装方式取决于你的根文件系统。Buildroot里直接勾选i2c-tools包。Yocto里在IMAGE_INSTALL里加上i2c-tools。Debian/Ubuntu系统直接apt install i2c-tools。安装完成后先确认I2C总线编号ls /dev/i2c-*通常会看到i2c-0、i2c-1等。每个编号对应一条I2C总线。具体哪条总线接了什么设备要看硬件原理图和设备树配置。4.2 i2cdetect扫描总线上的设备i2cdetect -y 1这个命令会扫描总线1上的所有7位地址显示哪些地址有设备响应。输出是一个16x8的表格行是地址高位列是地址低位。表格中显示地址数字的位置表示该地址有设备显示“--”表示无设备显示“UU”表示该地址被驱动占用。注意i2cdetect的-y参数表示跳过交互确认。不加-y会提示你确认因为扫描可能会干扰某些设备。实际调试中如果总线上有EEPROM扫描一般没问题。但如果总线上有正在工作的设备扫描可能会导致数据错乱。生产环境中慎用。如果扫描不到任何设备先检查总线编号是否正确再检查硬件连接。如果扫描到一堆地址都有响应可能是SDA或SCL对地短路或者上拉电阻缺失导致总线浮空。4.3 i2cget和i2cset读写寄存器确认设备地址后用i2cget读寄存器i2cget -y 1 0x3c 0x00这条命令读取总线1上地址0x3c设备的寄存器0x00。输出是一个字节的十六进制值。写寄存器用i2cseti2cset -y 1 0x3c 0x00 0xae这条命令向地址0x3c的寄存器0x00写入0xae。对于16位寄存器地址的设备需要加参数i2cget -y 1 0x50 0x0000 ww表示按字16位读取。具体用法要看设备的数据手册。4.4 i2cdump查看整个寄存器空间i2cdump -y 1 0x50这个命令会把设备的所有寄存器内容打印出来。对于EEPROM这类设备可以快速查看存储内容。对于传感器可以查看各个配置寄存器和数据寄存器的当前值。我调试一颗加速度计时先用i2cdump把WHO_AM_I寄存器找出来确认通信正常再逐个配置控制寄存器最后读数据寄存器。整个过程不用写一行代码全靠i2c-tools完成。4.5 i2ctransfer组合读写i2ctransfer比i2cget/i2cset更灵活支持一次传输中组合多个读写操作i2ctransfer -y 1 w20x3c 0x00 0xae r1这条命令先向0x3c写两个字节0x00 0xae然后读一个字节。对于需要先写寄存器地址再读数据的设备这种组合操作更符合实际协议。很多I2C设备读寄存器的流程是先写寄存器地址再发起读操作。i2cget内部就是这么做的但i2ctransfer可以让你更精确地控制时序和字节数。5. 设备树配置嵌入式Linux的必经之路5.1 设备树里I2C节点的基本结构在嵌入式Linux中I2C控制器和挂载的设备都要在设备树里描述。一个典型的I2C节点长这样i2c1 { status okay; clock-frequency 400000; eeprom50 { compatible atmel,24c02; reg 0x50; }; oled3c { compatible solomon,ssd1306; reg 0x3c; }; };status设为okay表示启用这条总线。clock-frequency指定通信速率。每个子节点代表一个挂载设备reg属性是设备的7位地址。compatible属性用来匹配驱动。如果内核里有对应的驱动设备会被自动识别并创建/dev节点或sysfs接口。如果没有驱动设备节点仍然存在可以用i2c-tools直接操作。5.2 地址冲突与别名处理一条I2C总线上不能有两个相同地址的设备。如果硬件设计时没注意两个设备地址撞了软件层面很难解决。唯一的办法是改硬件——要么换地址可配置的设备要么用I2C多路复用器如TCA9548A把总线分成多条。TCA9548A的用法是在设备树里把它当做一个I2C设备然后在它下面再挂子总线i2c1 { mux70 { compatible nxp,pca9548; reg 0x70; #address-cells 1; #size-cells 0; i2c0 { #address-cells 1; #size-cells 0; reg 0; device3c { compatible solomon,ssd1306; reg 0x3c; }; }; }; };这样每个子总线上的设备地址可以重复因为物理上它们是隔离的。5.3 常见设备树配置错误与排查设备树配错是嵌入式Linux下I2C设备不工作的常见原因。几个典型错误总线编号搞错i2c1对应的是/dev/i2c-1但硬件上设备接的是i2c0地址写错reg属性写的是8位地址而不是7位地址status没设okay默认是disabled总线根本不工作pinctrl没配SCL和SDA引脚没有正确复用为I2C功能clock-frequency超范围有些控制器不支持400kHz设了也没用排查方法先看内核启动日志里I2C控制器的初始化信息确认总线注册成功。再用i2cdetect扫描确认设备能被探测到。如果i2cdetect能扫到但驱动不工作检查compatible属性是否匹配。如果i2cdetect扫不到检查pinctrl和硬件连接。6. 典型设备调试实录6.1 EEPROM读写验证EEPROM是最简单的I2C设备适合用来验证总线是否正常。以AT24C02为例地址0x50容量256字节。写一个字节i2cset -y 1 0x50 0x00 0x55读回来i2cget -y 1 0x50 0x00如果读回0x55说明读写都正常。如果读回0xFF说明写没成功或者读有问题。EEPROM写操作需要时间写完之后要等5ms左右才能读。i2cset默认会等但有些情况下需要手动加延时。页写时注意不要跨页。AT24C02每页8字节如果从地址0x07开始写8个字节会跨到下一页导致数据回卷。这是EEPROM的经典坑。6.2 OLED屏幕的点亮流程SSD1306驱动的OLED是I2C调试的常见目标。地址通常是0x3C或0x3D。点亮流程上电后先延时100ms等待OLED内部复位完成发送初始化命令序列关闭显示、设置时钟、设置复用率、设置偏移、设置起始行、设置电荷泵、设置内存模式、设置扫描方向、设置对比度、开启显示发送显示数据用i2c-tools手动发命令i2cset -y 1 0x3c 0x00 0xae i2cset -y 1 0x3c 0x00 0xd5 i2cset -y 1 0x3c 0x00 0x80 ...每个命令前要加0x00控制字节表示后面跟的是命令。发数据前加0x40控制字节。常见问题OLED不亮先检查电荷泵是否开启。SSD1306需要内部电荷泵产生7.5V驱动电压如果电荷泵没开屏幕完全不亮。再检查对比度设置对比度太低也会看不见。6.3 传感器数据读取以常见的温湿度传感器SHT30为例地址0x44。测量流程发送测量命令0x2C06高重复性测量等待15ms读取6个字节温度高8位、温度低8位、温度CRC、湿度高8位、湿度低8位、湿度CRC用i2ctransferi2ctransfer -y 1 w20x44 0x2c 0x06 sleep 0.02 i2ctransfer -y 1 r60x44读回来的数据需要转换温度 -45 175 × (raw / 65535)湿度 100 × (raw / 65535)。如果读回来全是0xFF说明传感器没有应答。检查地址是否正确SHT30的地址由ADDR引脚决定0x44或0x45检查供电是否正常检查上拉电阻是否合适。7. 常见问题速查与避坑指南7.1 通信失败排查流程现象可能原因排查方法i2cdetect扫不到任何设备总线未启用、pinctrl未配、硬件断线检查设备树status、用示波器看波形i2cdetect扫到但读写失败地址错误、寄存器地址错误对照数据手册核对地址ACK位始终为高从机未响应检查从机供电、地址、上拉电阻读回数据全0xFF从机未驱动SDA、读时序错误检查读操作流程、确认从机输出使能数据偶尔出错时序余量不足、干扰降低速率、减小上拉电阻、加滤波电容总线死锁从机拉低SDA不放发送9个时钟脉冲复位总线7.2 总线死锁的复位方法I2C总线死锁是经典问题从机在传输过程中复位SDA被拉低不放主机无法发起新的起始条件。解决方法主机把SCL配置为GPIO输出手动发送9个时钟脉冲然后发送停止条件。在Linux下可以用i2c-gpio驱动模拟这个操作或者直接写GPIO寄存器。有些SoC的I2C控制器内置了总线恢复功能在设备树里使能即可。7.3 实操心得与注意事项上拉电阻不要省很多模块自带4.7kΩ上拉但多个模块并联后等效电阻变小可能导致灌电流超标。这时候要拆掉部分模块的上拉电阻。示波器是最好朋友不要靠猜直接看波形。起始条件、地址、ACK、数据每个环节都能从波形上读出来。先调通一个设备再挂多个总线上挂多个设备时先单独调通每一个再全部挂上。否则出了问题不知道是哪个设备导致的。设备树改完要重新编译修改.dts后需要重新编译dtb并更新到板子上不是改完就生效。i2c-tools的-y参数要慎用在总线上有正在工作的设备时扫描可能导致数据错乱。调试阶段用生产环境不要用。注意电平匹配3.3V的SoC接5V的I2C设备需要电平转换。直接连可能烧毁SoC的IO口。长走线要加缓冲I2C总线走线超过30cm时总线电容增大上升沿变缓。可以用I2C缓冲器如PCA9600或者降低速率。8. 从裸机到Linux的调试思路差异裸机环境下调试I2C你需要自己实现起始、停止、字节收发、ACK处理。好处是可控性高坏处是什么都要自己写。STM32的HAL库提供了I2C初始化函数和读写API但底层时序还是硬件控制器在管。如果硬件I2C有问题可以用GPIO模拟软件I2C时序完全由代码控制方便调试。Linux环境下I2C控制器驱动由内核提供你只需要在设备树里描述设备然后用i2c-tools或编写用户态程序访问。好处是屏蔽了底层细节坏处是出了问题不好定位——你不知道是控制器驱动的问题、设备树的问题还是硬件的问题。我的建议是新板子 bring-up 阶段先用裸机或U-Boot里的I2C命令验证硬件通路。U-Boot通常有i2c命令可以扫描总线、读写寄存器。确认硬件没问题后再进Linux调驱动。这样能把硬件问题和软件问题分开排查效率高很多。9. 工具链与调试环境搭建建议一套顺手的调试环境能省很多时间。我的标配示波器至少100MHz带宽双通道带I2C解码功能逻辑分析仪8通道以上配合Sigrok/PulseView软件协议解码能力强万用表测通断、测电压、测电阻i2c-toolsLinux下的必备工具集内核日志dmesg | grep i2c看控制器初始化和设备注册信息sysfs接口/sys/bus/i2c/devices/查看已注册的I2C设备逻辑分析仪在调试I2C时比示波器更好用因为它能直接解码出地址、数据、ACK不用自己对着波形数位。Saleae的逻辑分析仪配合它的软件I2C解码非常直观。国产的DSLogic也不错配合PulseView使用。10. 个人经验总结调试I2C设备核心思路是分层排查先确认硬件通路正常再确认协议层通信正常最后确认系统层配置正确。每一层都有对应的工具和方法不要跳步。我最常遇到的坑是上拉电阻和地址错误。上拉电阻太大导致波形上升沿太缓从机识别不到起始条件地址搞错导致从机不应答。这两个问题占了I2C调试问题的七成以上。另外设备树配置是嵌入式Linux下I2C调试的门槛。很多人从裸机转Linux时不习惯用设备树描述硬件总想在代码里硬编码。但Linux的驱动模型就是基于设备树的绕不过去。花时间把设备树搞明白后面调试效率会高很多。最后分享一个小技巧如果手头没有示波器可以用另一个GPIO接在SDA或SCL上配置为边沿触发中断在中断里记录时间戳粗略判断有没有波形和波形频率。虽然精度不高但应急够用。
嵌入式I2C外设调试全攻略：从协议时序到i2c-tools与设备树实战
1. 为什么I2C调试总让人又爱又恨搞嵌入式的人迟早要跟I2C打交道。它引脚少、协议简单、挂载设备多EEPROM、OLED、各类传感器、RTC、IO扩展芯片几乎都走I2C。但真正上手调试的时候很多人会发现明明接线没错代码也是抄的例程设备就是没反应。示波器一挂波形要么拉不起来要么ACK位死活不对要么读出来的数据全是0xFF。我做了十多年嵌入式从8位机到ARM Cortex-A系列从裸机到LinuxI2C外设调试踩过的坑能写一本书。这篇内容就是把我这些年调试I2C设备的思路完整梳理一遍从硬件层到协议层再到系统层把“怎么定位问题”这件事讲透。不管你是刚接触嵌入式的学生还是工作几年但一遇到I2C就头疼的工程师这篇内容都能给你一套可以直接复用的排查框架。核心关键词嵌入式、I2C、外设调试、i2c-tools、设备树。这几个词基本覆盖了I2C调试的完整链路——硬件协议是基础i2c-tools是Linux下的利器设备树是嵌入式Linux必须跨过的门槛。我会按照“先通协议、再查硬件、后调系统”的顺序展开每一层都给出具体的操作方法和判断依据。2. I2C协议层先把时序这件事搞明白2.1 两根线背后的通信逻辑I2C只有两根信号线SCL和SDA。SCL是时钟线SDA是数据线。所有通信都由主机发起从机被动响应。很多人觉得I2C简单就是因为线少。但线少不代表逻辑简单恰恰因为只有两根线所有信息——起始、地址、数据、应答、停止——都靠这两根线的电平变化来编码。起始条件StartSCL为高电平时SDA从高变低。停止条件StopSCL为高电平时SDA从低变高。这两个条件必须由主机产生从机不会主动发起。数据位传输SCL为低电平时SDA上的数据可以变化SCL为高电平时SDA必须保持稳定接收方在这个时刻采样。应答位ACK/NACK每传输完8位数据接收方需要在第9个时钟周期把SDA拉低表示应答。如果接收方没有拉低就是NACK。主机读数据时发完最后一个字节后要发NACK然后发停止条件。这些概念看起来基础但实际调试中80%的问题都出在这些基础环节。比如SDA在SCL高电平期间发生了变化从机就会误判为起始或停止条件导致通信错乱。再比如上拉电阻太大上升沿太缓SCL高电平期间SDA还没稳定采样就会出错。2.2 时钟频率与上拉电阻的匹配关系I2C标准模式100kHz快速模式400kHz高速模式3.4MHz。频率越高对上升沿的要求越严格。上升时间由总线电容和上拉电阻共同决定公式是t_r ≈ 0.847 × R_pullup × C_bus标准模式下上升时间要求小于1000ns快速模式小于300ns。假设总线电容100pF标准模式下上拉电阻最大约11.8kΩ快速模式下最大约3.5kΩ。实际选型时通常用4.7kΩ或2.2kΩ就是留了余量。我见过太多人用10kΩ上拉跑400kHz结果波形上升沿像山坡一样缓从机根本识别不了。也见过有人用1kΩ上拉功耗大不说有些从机的灌电流能力不够SDA拉不低直接通信失败。上拉电阻的选择要同时考虑总线电容、通信速率和从机的电气特性不是随便放一个就行。2.3 地址格式与读写位I2C的7位地址加上1位读写标志组成第一个字节。写操作时最低位为0读操作时为1。比如一个设备的7位地址是0x3C写地址就是0x78读地址就是0x79。很多数据手册直接给出8位地址这时候要注意区分它给的是包含读写位的还是纯7位地址。有些设备支持10位地址但实际项目中很少遇到。绝大多数传感器、EEPROM、OLED都是7位地址。调试时如果地址搞错设备根本不会应答。用i2c-tools的i2cdetect扫描时它显示的是7位地址这一点要记住。3. 硬件层排查从原理图到示波器3.1 上电前的静态检查拿到一块新板子不要急着上电写代码。先做静态检查用万用表测SCL和SDA对地的阻抗确认没有短路。测SCL和SDA之间的阻抗确认没有互相短路。测上拉电阻的阻值确认焊接正确。测从机电源引脚对地阻抗确认没有电源短路。这些检查花不了几分钟但能避免烧芯片。我见过有人上电后发现电流异常大一查是SDA和VCC短路了芯片已经冒烟。静态检查是最低成本的保护措施。3.2 上电后的电平检查上电后先不通信用万用表或示波器测SCL和SDA的静态电平。正常情况下两根线都应该被上拉到高电平。如果某根线一直是低电平说明有设备在拉低它可能是从机损坏也可能是主机GPIO配置成了输出低。如果两根线都是高电平说明总线空闲状态正常。这时候可以尝试通信用示波器观察波形。如果SCL没有波形说明主机根本没有发起通信问题在主机端。如果SCL有波形但SDA没有变化说明主机没有正确发送数据或者SDA线断了。3.3 示波器抓波形的关键观察点用示波器抓I2C波形时重点看这几个地方起始条件是否干净SDA下降沿时SCL是否稳定在高电平地址字节是否正确对照数据手册逐位核对ACK位是否被拉低第9个时钟周期SDA是否被从机拉低数据字节是否符合预期读操作时从机输出的数据是否正确停止条件是否完整SDA上升沿时SCL是否稳定在高电平如果ACK位没有被拉低说明从机没有响应。可能原因地址错误、从机未上电、从机损坏、从机处于复位状态、上拉电阻不合适导致从机识别不到起始条件。我习惯用双通道示波器同时抓SCL和SDA触发方式设为SDA下降沿起始条件。这样每次通信都能完整捕获。如果示波器有I2C解码功能直接打开解码地址、数据、ACK都会标注出来效率高很多。4. Linux下的I2C调试利器i2c-tools实战4.1 i2c-tools的安装与基本用法在嵌入式Linux系统里i2c-tools是调试I2C设备的第一工具。它包含几个核心命令i2cdetect、i2cget、i2cset、i2cdump、i2ctransfer。安装方式取决于你的根文件系统。Buildroot里直接勾选i2c-tools包。Yocto里在IMAGE_INSTALL里加上i2c-tools。Debian/Ubuntu系统直接apt install i2c-tools。安装完成后先确认I2C总线编号ls /dev/i2c-*通常会看到i2c-0、i2c-1等。每个编号对应一条I2C总线。具体哪条总线接了什么设备要看硬件原理图和设备树配置。4.2 i2cdetect扫描总线上的设备i2cdetect -y 1这个命令会扫描总线1上的所有7位地址显示哪些地址有设备响应。输出是一个16x8的表格行是地址高位列是地址低位。表格中显示地址数字的位置表示该地址有设备显示“--”表示无设备显示“UU”表示该地址被驱动占用。注意i2cdetect的-y参数表示跳过交互确认。不加-y会提示你确认因为扫描可能会干扰某些设备。实际调试中如果总线上有EEPROM扫描一般没问题。但如果总线上有正在工作的设备扫描可能会导致数据错乱。生产环境中慎用。如果扫描不到任何设备先检查总线编号是否正确再检查硬件连接。如果扫描到一堆地址都有响应可能是SDA或SCL对地短路或者上拉电阻缺失导致总线浮空。4.3 i2cget和i2cset读写寄存器确认设备地址后用i2cget读寄存器i2cget -y 1 0x3c 0x00这条命令读取总线1上地址0x3c设备的寄存器0x00。输出是一个字节的十六进制值。写寄存器用i2cseti2cset -y 1 0x3c 0x00 0xae这条命令向地址0x3c的寄存器0x00写入0xae。对于16位寄存器地址的设备需要加参数i2cget -y 1 0x50 0x0000 ww表示按字16位读取。具体用法要看设备的数据手册。4.4 i2cdump查看整个寄存器空间i2cdump -y 1 0x50这个命令会把设备的所有寄存器内容打印出来。对于EEPROM这类设备可以快速查看存储内容。对于传感器可以查看各个配置寄存器和数据寄存器的当前值。我调试一颗加速度计时先用i2cdump把WHO_AM_I寄存器找出来确认通信正常再逐个配置控制寄存器最后读数据寄存器。整个过程不用写一行代码全靠i2c-tools完成。4.5 i2ctransfer组合读写i2ctransfer比i2cget/i2cset更灵活支持一次传输中组合多个读写操作i2ctransfer -y 1 w20x3c 0x00 0xae r1这条命令先向0x3c写两个字节0x00 0xae然后读一个字节。对于需要先写寄存器地址再读数据的设备这种组合操作更符合实际协议。很多I2C设备读寄存器的流程是先写寄存器地址再发起读操作。i2cget内部就是这么做的但i2ctransfer可以让你更精确地控制时序和字节数。5. 设备树配置嵌入式Linux的必经之路5.1 设备树里I2C节点的基本结构在嵌入式Linux中I2C控制器和挂载的设备都要在设备树里描述。一个典型的I2C节点长这样i2c1 { status okay; clock-frequency 400000; eeprom50 { compatible atmel,24c02; reg 0x50; }; oled3c { compatible solomon,ssd1306; reg 0x3c; }; };status设为okay表示启用这条总线。clock-frequency指定通信速率。每个子节点代表一个挂载设备reg属性是设备的7位地址。compatible属性用来匹配驱动。如果内核里有对应的驱动设备会被自动识别并创建/dev节点或sysfs接口。如果没有驱动设备节点仍然存在可以用i2c-tools直接操作。5.2 地址冲突与别名处理一条I2C总线上不能有两个相同地址的设备。如果硬件设计时没注意两个设备地址撞了软件层面很难解决。唯一的办法是改硬件——要么换地址可配置的设备要么用I2C多路复用器如TCA9548A把总线分成多条。TCA9548A的用法是在设备树里把它当做一个I2C设备然后在它下面再挂子总线i2c1 { mux70 { compatible nxp,pca9548; reg 0x70; #address-cells 1; #size-cells 0; i2c0 { #address-cells 1; #size-cells 0; reg 0; device3c { compatible solomon,ssd1306; reg 0x3c; }; }; }; };这样每个子总线上的设备地址可以重复因为物理上它们是隔离的。5.3 常见设备树配置错误与排查设备树配错是嵌入式Linux下I2C设备不工作的常见原因。几个典型错误总线编号搞错i2c1对应的是/dev/i2c-1但硬件上设备接的是i2c0地址写错reg属性写的是8位地址而不是7位地址status没设okay默认是disabled总线根本不工作pinctrl没配SCL和SDA引脚没有正确复用为I2C功能clock-frequency超范围有些控制器不支持400kHz设了也没用排查方法先看内核启动日志里I2C控制器的初始化信息确认总线注册成功。再用i2cdetect扫描确认设备能被探测到。如果i2cdetect能扫到但驱动不工作检查compatible属性是否匹配。如果i2cdetect扫不到检查pinctrl和硬件连接。6. 典型设备调试实录6.1 EEPROM读写验证EEPROM是最简单的I2C设备适合用来验证总线是否正常。以AT24C02为例地址0x50容量256字节。写一个字节i2cset -y 1 0x50 0x00 0x55读回来i2cget -y 1 0x50 0x00如果读回0x55说明读写都正常。如果读回0xFF说明写没成功或者读有问题。EEPROM写操作需要时间写完之后要等5ms左右才能读。i2cset默认会等但有些情况下需要手动加延时。页写时注意不要跨页。AT24C02每页8字节如果从地址0x07开始写8个字节会跨到下一页导致数据回卷。这是EEPROM的经典坑。6.2 OLED屏幕的点亮流程SSD1306驱动的OLED是I2C调试的常见目标。地址通常是0x3C或0x3D。点亮流程上电后先延时100ms等待OLED内部复位完成发送初始化命令序列关闭显示、设置时钟、设置复用率、设置偏移、设置起始行、设置电荷泵、设置内存模式、设置扫描方向、设置对比度、开启显示发送显示数据用i2c-tools手动发命令i2cset -y 1 0x3c 0x00 0xae i2cset -y 1 0x3c 0x00 0xd5 i2cset -y 1 0x3c 0x00 0x80 ...每个命令前要加0x00控制字节表示后面跟的是命令。发数据前加0x40控制字节。常见问题OLED不亮先检查电荷泵是否开启。SSD1306需要内部电荷泵产生7.5V驱动电压如果电荷泵没开屏幕完全不亮。再检查对比度设置对比度太低也会看不见。6.3 传感器数据读取以常见的温湿度传感器SHT30为例地址0x44。测量流程发送测量命令0x2C06高重复性测量等待15ms读取6个字节温度高8位、温度低8位、温度CRC、湿度高8位、湿度低8位、湿度CRC用i2ctransferi2ctransfer -y 1 w20x44 0x2c 0x06 sleep 0.02 i2ctransfer -y 1 r60x44读回来的数据需要转换温度 -45 175 × (raw / 65535)湿度 100 × (raw / 65535)。如果读回来全是0xFF说明传感器没有应答。检查地址是否正确SHT30的地址由ADDR引脚决定0x44或0x45检查供电是否正常检查上拉电阻是否合适。7. 常见问题速查与避坑指南7.1 通信失败排查流程现象可能原因排查方法i2cdetect扫不到任何设备总线未启用、pinctrl未配、硬件断线检查设备树status、用示波器看波形i2cdetect扫到但读写失败地址错误、寄存器地址错误对照数据手册核对地址ACK位始终为高从机未响应检查从机供电、地址、上拉电阻读回数据全0xFF从机未驱动SDA、读时序错误检查读操作流程、确认从机输出使能数据偶尔出错时序余量不足、干扰降低速率、减小上拉电阻、加滤波电容总线死锁从机拉低SDA不放发送9个时钟脉冲复位总线7.2 总线死锁的复位方法I2C总线死锁是经典问题从机在传输过程中复位SDA被拉低不放主机无法发起新的起始条件。解决方法主机把SCL配置为GPIO输出手动发送9个时钟脉冲然后发送停止条件。在Linux下可以用i2c-gpio驱动模拟这个操作或者直接写GPIO寄存器。有些SoC的I2C控制器内置了总线恢复功能在设备树里使能即可。7.3 实操心得与注意事项上拉电阻不要省很多模块自带4.7kΩ上拉但多个模块并联后等效电阻变小可能导致灌电流超标。这时候要拆掉部分模块的上拉电阻。示波器是最好朋友不要靠猜直接看波形。起始条件、地址、ACK、数据每个环节都能从波形上读出来。先调通一个设备再挂多个总线上挂多个设备时先单独调通每一个再全部挂上。否则出了问题不知道是哪个设备导致的。设备树改完要重新编译修改.dts后需要重新编译dtb并更新到板子上不是改完就生效。i2c-tools的-y参数要慎用在总线上有正在工作的设备时扫描可能导致数据错乱。调试阶段用生产环境不要用。注意电平匹配3.3V的SoC接5V的I2C设备需要电平转换。直接连可能烧毁SoC的IO口。长走线要加缓冲I2C总线走线超过30cm时总线电容增大上升沿变缓。可以用I2C缓冲器如PCA9600或者降低速率。8. 从裸机到Linux的调试思路差异裸机环境下调试I2C你需要自己实现起始、停止、字节收发、ACK处理。好处是可控性高坏处是什么都要自己写。STM32的HAL库提供了I2C初始化函数和读写API但底层时序还是硬件控制器在管。如果硬件I2C有问题可以用GPIO模拟软件I2C时序完全由代码控制方便调试。Linux环境下I2C控制器驱动由内核提供你只需要在设备树里描述设备然后用i2c-tools或编写用户态程序访问。好处是屏蔽了底层细节坏处是出了问题不好定位——你不知道是控制器驱动的问题、设备树的问题还是硬件的问题。我的建议是新板子 bring-up 阶段先用裸机或U-Boot里的I2C命令验证硬件通路。U-Boot通常有i2c命令可以扫描总线、读写寄存器。确认硬件没问题后再进Linux调驱动。这样能把硬件问题和软件问题分开排查效率高很多。9. 工具链与调试环境搭建建议一套顺手的调试环境能省很多时间。我的标配示波器至少100MHz带宽双通道带I2C解码功能逻辑分析仪8通道以上配合Sigrok/PulseView软件协议解码能力强万用表测通断、测电压、测电阻i2c-toolsLinux下的必备工具集内核日志dmesg | grep i2c看控制器初始化和设备注册信息sysfs接口/sys/bus/i2c/devices/查看已注册的I2C设备逻辑分析仪在调试I2C时比示波器更好用因为它能直接解码出地址、数据、ACK不用自己对着波形数位。Saleae的逻辑分析仪配合它的软件I2C解码非常直观。国产的DSLogic也不错配合PulseView使用。10. 个人经验总结调试I2C设备核心思路是分层排查先确认硬件通路正常再确认协议层通信正常最后确认系统层配置正确。每一层都有对应的工具和方法不要跳步。我最常遇到的坑是上拉电阻和地址错误。上拉电阻太大导致波形上升沿太缓从机识别不到起始条件地址搞错导致从机不应答。这两个问题占了I2C调试问题的七成以上。另外设备树配置是嵌入式Linux下I2C调试的门槛。很多人从裸机转Linux时不习惯用设备树描述硬件总想在代码里硬编码。但Linux的驱动模型就是基于设备树的绕不过去。花时间把设备树搞明白后面调试效率会高很多。最后分享一个小技巧如果手头没有示波器可以用另一个GPIO接在SDA或SCL上配置为边沿触发中断在中断里记录时间戳粗略判断有没有波形和波形频率。虽然精度不高但应急够用。
![10.1[A]](http://pic.xiahunao.cn/yaotu/10.1[A])
