📚 课程目录第4章 I2C总线调试工具

4. I2C总线调试工具：i2c-tools、逻辑分析仪、示波器使用技巧

调试I2C总线，光靠看代码是不够的。你得有趁手的工具，还得知道怎么用。

我个人习惯把调试工具分成三个层次：软件层、协议层、电气层。i2c-tools解决软件交互问题，逻辑分析仪看协议时序，示波器抓电气信号。三个层次配合，基本能搞定90%的I2C故障。

  核心思路：先软件确认通信是否建立，再协议分析数据是否正确，最后电气排查信号质量。别一上来就上示波器，那是最后一步。

4.1 i2c-tools：软件层的瑞士军刀

i2c-tools是Linux下最常用的I2C调试工具集。我在项目中几乎每天都会用到它。说白了，它就是一组命令行工具，让你直接跟I2C设备对话。

4.1.1 常用命令速查

命令	功能	典型用法
`i2cdetect`	扫描总线上的设备地址	`i2cdetect -y 1`
`i2cget`	读取寄存器值	`i2cget -y 1 0x50 0x00`
`i2cset`	写入寄存器值	`i2cset -y 1 0x50 0x00 0xFF`
`i2cdump`	批量读取寄存器	`i2cdump -y 1 0x50`
`i2ctransfer`	自定义传输序列	`i2ctransfer -y 1 w2@0x50 0x00 0x01 r2`

小技巧：-y参数跳过确认提示，适合脚本化操作。但第一次用的时候建议不加，先看清楚总线号对不对。

4.1.2 实战：探测未知设备

拿到一块新板子，第一件事就是看看I2C总线上挂了哪些设备。

# 扫描总线1上的所有设备
i2cdetect -y 1

# 输出示例
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- -- --

看到50这个地址了吗？说明0x50位置有个设备在应答。我遇到过好几次，扫描出来一堆UU，那是驱动已经占用了设备，你得先把驱动卸载掉才能用i2c-tools操作。

4.1.3 读写寄存器验证

确认设备存在后，下一步就是读写寄存器。以EEPROM为例：

# 读取0x50设备，0x00地址处的值
i2cget -y 1 0x50 0x00

# 写入0xFF到0x00地址
i2cset -y 1 0x50 0x00 0xFF

# 批量读取前16个字节
i2cdump -y 1 0x50

注意：写操作要小心。有些设备的寄存器是只读的，写进去可能触发意外行为。我曾经在调试电源管理芯片时，不小心写错了寄存器，导致板子直接掉电。从那以后，我每次写之前都会先读一下当前值。

4.2 逻辑分析仪：协议层的火眼金睛

i2c-tools能告诉你通信结果对不对，但要是通信过程出了问题，就得靠逻辑分析仪了。

逻辑分析仪抓的是数字信号，只看高低电平，不关心电压具体是多少。它最适合分析协议时序问题。

4.2.1 什么时候该用逻辑分析仪

设备无应答：SCL和SDA波形正常，但设备就是不回ACK
数据错位：读回来的数据跟预期不一致
总线冲突：多个主设备同时操作，导致数据混乱
时序违规：SCL频率不对，或者建立时间、保持时间不满足

4.2.2 抓取和解码技巧

我个人习惯这样设置：

采样率：至少4倍于SCL频率。100kHz总线用400kHz采样，400kHz总线用2MHz采样
触发条件：设置SDA下降沿触发，这样能抓到起始条件
解码设置：选择I2C协议，填入正确的设备地址（7位或10位）
深度：抓取足够长的波形，至少包含一次完整的写+读序列

  关键点：逻辑分析仪只能告诉你协议层对不对。如果波形看起来完美但设备还是不工作，那问题可能出在电气层，该上示波器了。

4.2.3 常见波形解读

看波形其实有套路。我总结了一个快速排查流程：

1. 看起始条件：SDA在SCL高电平时下降 → 正确
2. 看地址字节：7位地址+读写位，共8位
3. 看ACK位：第9个SCL周期，SDA被拉低 → 设备应答
4. 看数据字节：MSB先发，每个字节后跟ACK
5. 看停止条件：SDA在SCL高电平时上升 → 正确

如果某一步不对，问题就出在那里。比如地址字节发完没看到ACK，要么地址错了，要么设备没上电。

4.3 示波器：电气层的终极诊断

示波器是最后一道防线。当逻辑分析仪显示协议没问题，但设备还是工作异常时，就该它出场了。

示波器能看到信号的真实面貌：电压幅值、上升时间、下降时间、过冲、振铃、噪声。这些东西逻辑分析仪是看不到的。

4.3.1 示波器设置要点

参数	推荐设置	说明
带宽	≥50MHz	I2C信号上升沿约10-30ns，需要足够带宽
采样率	≥100MSa/s	保证能捕捉到信号细节
时基	2-5μs/div	100kHz总线用5μs，400kHz用2μs
触发	SDA下降沿	捕捉起始条件
探头	10x档位	减少负载效应，提高带宽

4.3.2 电气问题排查清单

我在项目中遇到过的典型电气问题：

电压幅值不足：VIL和VIH不满足规格。3.3V系统，SDA低电平超过0.8V就算不合格
上升沿太缓：上拉电阻太大，或者总线电容太大。标准模式上升时间应小于1μs
过冲/振铃：上拉电阻太小，或者走线过长。超过VCC+0.3V就可能损坏设备
噪声干扰：SCL或SDA上有毛刺，导致误触发

避坑指南：我曾经调试一个传感器模块，逻辑分析仪看波形完美，但数据就是不对。最后用示波器一看，SDA线上的低电平只有1.8V，而主控的VIH要求2.0V。原因是上拉电阻接到了1.8V电源，而不是3.3V。这种问题逻辑分析仪根本看不出来。

4.3.3 测量上升时间和下降时间

上升时间和下降时间是衡量信号质量的重要指标。测量方法：

1. 将光标放在波形上升沿的10%和90%处
2. 读取时间差，这就是上升时间
3. 同样方法测量下降沿的90%到10%，得到下降时间

标准模式要求：
- 上升时间 ≤ 1000ns
- 下降时间 ≤ 300ns

快速模式要求：
- 上升时间 ≤ 300ns
- 下降时间 ≤ 300ns

如果上升时间超标，先检查上拉电阻。4.7kΩ是常用值，总线电容大时换2.2kΩ，电容小时用10kΩ。

4.4 三工具协同工作流程

说了这么多，实际调试时怎么配合使用？我画了个流程图：

这个流程我用了很多年，很管用。你想想看，如果i2c-tools都扫不到设备，直接上示波器找电气问题，是不是更高效？反过来，如果i2c-tools读写正常，但应用层数据不对，那大概率是协议解析的问题，逻辑分析仪一抓就现形。

个人习惯：我调试时会在桌面上同时开着三个窗口：终端跑i2c-tools、逻辑分析仪软件、示波器远程控制。哪个工具发现问题，就切换到哪个深入分析。这样切换起来很快，不打断思路。

4.5 实战案例：一个典型的调试过程

最后分享一个真实案例。有次调试一个温湿度传感器，读回来的温度总是跳变。

i2c-tools探测：设备地址能扫到，读写寄存器也正常。但连续读10次，有2-3次数据异常
逻辑分析仪抓取：协议时序完全正确，ACK应答正常，数据字节也没问题。但异常发生时，SCL上多了一个额外的脉冲
示波器查看：发现SCL线上有毛刺，幅值达到2.5V，刚好在逻辑阈值附近。毛刺来自旁边的DC-DC转换器
修复：在SCL线上加了一个100pF的电容到地，滤除高频噪声。问题解决

你看，三个工具各司其职，缺一不可。没有i2c-tools，你都不知道设备在不在；没有逻辑分析仪，你看不到那个多余的脉冲；没有示波器，你找不到噪声源。

嗯，工具就介绍到这里。记住一个原则：从简单到复杂，从软件到硬件，一步步缩小问题范围。别一上来就拆板子焊线，先敲几个命令试试看。