I2C 技术系列 · 持续更新中本系列从 OD 开漏物理层一路打到 Linux i2c子系统,把两根线背后那套电气/协议/仲裁/恢复/驱动全拧成一根线。 想系统追更戳这里查看完整目录【I2C 技术系列 00】总目录本篇定位:代码写完了,但跑起来有问题——地址扫不到、读写错、偶发挂死。本篇讲 I2C 调试工具链(i2c-tools / 示波器 / 逻辑分析仪)和故障定位方法论,从现象到根因的完整排查路径。读完你遇到 I2C 问题不会瞎试,有章法。调试是经验,更是方法I2C 问题千奇百怪:地址不对、上拉不够、电容超标、时序违规、EMI 干扰。瞎试三天不如按方法三小时定位。工具会用 排查有章法 资深 BSP 工程师的水准。目录一、调试工具链总览二、i2c-tools 详解2.1 i2cdetect —— 扫描总线2.2 i2cdump —— dump 寄存器2.3 i2cget / i2cset —— 读写单寄存器2.4 i2ctransfer —— 灵活传输(新工具)2.5 i2cdetect -l —— 列出总线三、示波器抓波形3.1 探头接法3.2 看什么3.3 典型波形3.4 测量技巧四、逻辑分析仪分析4.1 优势4.2 工具4.3 解码步骤4.4 看什么4.5 协议解码示例五、万用表与上拉测量5.1 静态测量5.2 上拉电阻验证5.3 总线电容估算5.4 上电时序检查六、常见故障定位流程6.1 地址扫不到(i2cdetect 无响应)6.2 读写偶发错误6.3 总线挂死(BUSY 一直 1)6.4 数据错位七、dmesg 与内核日志7.1 看 I2C 相关日志7.2 probe 日志7.3 错误日志7.4 动态调试7.5 ftrace 看 I2C 调用八、调试驱动技巧8.1 加 dev_info 打印8.2 regmap 调试8.3 i2c-dev 调试裸寄存器8.4 降速调试九、关键问题 QAQ1:i2cdetect 扫不到,但示波器看到 START 了?Q2:i2cdump 出来全是 0x00 或 0xFF?Q3:示波器看到上升沿很缓,怎么办?Q4:逻辑分析仪解码地址对,但 ACK 总是 NACK?Q5:Linux 下 I2C 报 -121(-EREMOTEIO)是什么?Q6:偶发挂死,抓不到现场,怎么办?十、实战案例案例 1:地址 0x50 扫不到案例 2:7bit vs 8bit 地址混淆案例 3:400k 偶发数据错案例 4:写 EEPROM 后读,偶发挂死案例 5:多器件共总线,某器件偶发 NACK案例 6:Linux 驱动 probe 失败案例 7:EMI 导致偶发误 START案例 8:DMA 读数据首字节错十一、本篇小结与速查核心要点排查决策表速查表延伸阅读参考资料一、调试工具链总览软件层: i2c-tools(i2cdetect/dump/get/set) ── 用户态快速验证 /sys/bus/i2c/ ── sysfs 查设备 dmesg ── 内核日志看 probe/错误 ftrace / debugfs ── 内核 I2C 调试 硬件层: 万用表 ── 测电压/上拉/通断 示波器 ── 看模拟波形(电平/上升沿/毛刺) 逻辑分析仪 ── 看数字时序(协议解码) 工具选择: 先软件(i2c-tools) ── 快速定位通不通 再硬件(示波器/逻辑分析仪) ── 深入为什么不通工具解决什么成本i2c-tools地址扫到没、寄存器读写对不对零(软件)万用表上拉有没有、电压对不对、短路没低示波器波形电平、上升沿、毛刺、时序中逻辑分析仪协议解码、时序参数、多通道中二、i2c-tools 详解2.1 i2cdetect —— 扫描总线i2cdetect-y0# 0 1 2 3 4 5 6 7 8 9 a b c d e f# 00: -- -- -- -- -- -- -- --# 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --# ...# 50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --# 60: -- -- -- -- -- -- -- -- -- 68 69 -- -- -- -- --# 70: -- -- -- -- -- -- -- ---y:不交互确认0:总线号(/dev/i2c-0)扫描两种方式:快速写(默认)/ 读模式(-r)--:保留地址(0x00-0x07, 0x78-0x7f)不扫UU:内核驱动已占用该地址i2cdetect 会发真实 I2C 事务i2cdetect 对每个地址发写请求看是否 ACK。某些器件被意外写会出问题(如 EEPROM 写到错地址)。功能安全场景慎用,或用-r读模式(只读不写)。2.2 i2cdump —— dump 寄存器# dump 0x50 的 256 字节寄存器i2cdump-y00x50# 指定模式i2cdump-y00x50 b# byte 模式(默认)i2cdump-y00x50 w# word 模式(16bit)i2cdump-y00x50 c# byte 模式(连续读)EEPROM dump 出来是数据表传感器 dump 看寄存器默认值,对比 datasheet2.3 i2cget / i2cset —— 读写单寄存器# 读 0x50 的 0x10 寄存器(字节)i2cget-y00x50 0x10# 读 wordi2cget-y00x50 0x10 w# 写 0xAB 到 0x50 的 0x10i2cset-y00x50 0x10 0xAB# 写 wordi2cset-y00x50 0x10 0xABCD w2.4 i2ctransfer —— 灵活传输(新工具)# 写 2 字节(地址 0x10, 数据 0xAB 0xCD)到 0x50i2ctransfer-y0w30x50 0x10 0xAB 0xCD# 从 0x50 读 6 字节(先写 0x10 设地址,Sr 读)i2ctransfer-y0w10x50 0x10 r6w30x50:写 3 字节到 0x50r6:读 6 字节比 i2cget/set 灵活,支持任意 msg 组合2.5 i2cdetect -l —— 列出总线i2cdetect-l# i2c-0 i2c rk3x-i2c I2C adapter# i2c-1 i2c rk3x-i2c I2C adapter三、示波器抓波形3.1 探头接法CH1 接 SDA,CH2 接 SCL地夹接被测板的地探头×10 档(减小寄生电容)触发:SCL 下降沿或 SDA 下降沿(START)3.2 看什么检查项正常异常电平幅度高VDD,低≈0高不够(上拉弱/漏电)上升沿 tr满足模式要求(400k300ns)太缓(Rp 太大/Cb 太大)下降沿 tf300ns太缓(驱动弱/线长)SCL 高电平期间 SDA稳定抖动(干扰)START/STOP 边沿清晰模糊(上升沿缓)ACK 拉低第 9 拍 SDA 低没拉低(地址错/无器件)3.3 典型波形正常 START 地址 ACK:SDA ‾‾‾‾‾‾\‾‾‾‾‾‾‾‾‾‾‾‾‾\___/‾‾‾\___/‾‾‾‾‾ ↓(START) 数据MSB... ACK(低) SCL ‾‾‾‾‾‾‾‾\_/‾\_/‾\_/‾\_/‾\_/‾\_/‾\_/‾‾‾ 高时SDA下降START上拉不足(上升沿缓):SDA ___/‾‾‾‾‾‾‾‾‾‾‾(缓慢上升,过冲不到 VDD) ↑ tr 太大,Rp 太大或 Cb 太大无 ACK:SDA 数据发完,第9拍 SDA 没被拉低(保持高NACK) → 地址错/器件不在/器件忙3.4 测量技巧用示波器协议解码功能(I2C decode),直接显示地址/数据抓偶发故障用单次触发 长存储看毛刺用峰值检测模式测 tr:光标卡上升沿 0.3VDD 到 0.7VDD四、逻辑分析仪分析4.1 优势多通道(SDA/SCL/其他信号)协议自动解码(I2C/SPI/UART)长时间记录,找偶发问题时序参数测量4.2 工具硬件:Saleae Logic / 逻辑分析仪(几十元的 USB 8 通道够用)软件:PulseView / Saleae Logic / sigrok4.3 解码步骤接 SDA/SCL 两通道采样率 ≥ 10× I2C 速度(400k 用 4MHz)选 I2C 协议解码设置 SDA/SCL 通道抓取后看解码的地址/数据/ACK4.4 看什么检查项说明地址对不对(7bit vs 8bit 坑)ACK/NACK每字节后 ACK 还是 NACKSTART/STOP时序对不对,有没有误触发Sr读寄存器有没有正确 Sr时序参数tSU/tHD/tLOW/tHIGH 是否违规拉伸SCL 有没有被从机拉低4.5 协议解码示例START ADDR: 0x76 (W) ACK DATA: 0xD0 ACK Sr ADDR: 0x76 (R) ACK DATA: 0x58 NACK ← 主机读最后一字节 NACK(正常) STOP这是 BMP280 读 ID(0xD0)读出 0x58 的完整事务解码后一目了然,比示波器看波形快五、万用表与上拉测量5.1 静态测量测量方法正常异常VDD红表笔接 VDD,黑接地3.3V/5V不对(电源问题)SDA/SCL 静态电平总线空闲时测VDD(上拉)低(短路/器件拉低)上拉电阻断电测 SDA-VDD 电阻4.7k/10k 左右开路/短路/错值SDA-SCL 通断测两线间不通短路(严重故障)SDA/SCL 对地测对地电阻高阻(MΩ)低(短路/器件坏)5.2 上拉电阻验证断电,万用表电阻档测 SDA 到 VDD应读出 Rp 值(如 4.7k)读 0:短路;读 ∞:上拉开路(没焊/断线)5.3 总线电容估算断电,示波器测上升时间 trCb tr / (0.8473 × Rp)例:tr300ns, Rp4.7k → Cb75pF,正常tr1μs, Rp4.7k → Cb250pF,偏大5.4 上电时序检查上电瞬间示波器看 SDA/SCL从机不应在上电时拉低 SDA/SCL(影响主机初始化)若从机上电慢,主机初始化要 delay六、常见故障定位流程6.1 地址扫不到(i2cdetect 无响应)i2cdetect 无 0x50 ↓ 1. 硬件:器件在不在?焊接对不对? ├ 万用表测 VDD(有电?) ├ 测 SDA/SCL 静态电平(应 VDD) └ 测上拉电阻(有?) ↓ 2. 地址对不对? ├ 查 datasheet 地址(7bit) ├ 引脚配置位(A0/A1/A2)设对没 └ 7bit vs 8bit 坑(0x50 vs 0xA0) ↓ 3. 总线对不对? ├ i2cdetect -l 看总线号对不对 ├ 设备树 controller enabled? └ pinctrl/clock 配了没 ↓ 4. 示波器抓:发 START 时 SDA/SCL 动不动? ├ 动但无 ACK → 器件没响应(地址/焊接) └ 不动 → 控制器没输出(pinctrl/时钟)6.2 读写偶发错误偶发读写失败 ↓ 1. dmesg 看错误类型(NACK? ARB_LOST? TIMEOUT?) ↓ 2. 示波器/逻辑分析仪抓偶发时刻波形 ├ 上升沿缓? → 上拉/电容问题 ├ 毛刺? → EMI/滤波 └ 拉伸超时? → 从机慢/异常 ↓ 3. 软件加重试 错误统计 ↓ 4. 排除:多任务并发?DMA cache?电压稳?6.3 总线挂死(BUSY 一直 1)BUSY 卡死(10 篇) ↓ GPIO 切输入读 SDA/SCL ├ SCL0 → 从机拉伸 / 短路 ├ SDA0 → 从机拉低不放(9 时钟恢复) └ 都高 → 控制器假 BUSY(软件复位) ↓ 对应恢复手段6.4 数据错位读出数据整体偏移/乱 ↓ 1. 逻辑分析仪看时序:START/地址/数据对不对 ↓ 2. 检查 Sr(读寄存器)对不对 ↓ 3. 检查采样点(SCL 高时 SDA 应稳定) ↓ 4. 加上层 CRC/校验,多次读比对 ↓ 5. 上升沿缓导致采样错?改上拉/降速七、dmesg 与内核日志7.1 看 I2C 相关日志dmesg|grep-ii2cdmesg|grep-ibmp280dmesg|grep-iadapter7.2 probe 日志[ 2.345] rk3x-i2c ff150000.i2c: initialized [ 2.346] i2c i2c-0: adapter [rk3x-i2c] registered [ 2.350] bmp280 0-0076: supply vddio not found, using dummy regulator [ 2.360] bmp280 0-0076: registering I2C device看 probe 成功/失败看 client 注册(i2c-0 上 0x76)看驱动匹配7.3 错误日志[ 12.456] rk3x-i2c ff150000.i2c: unexpected NACK [ 12.457] bmp280 0-0076: failed to read chip id: -121 [ 12.458] bmp280: probe of 0-0076 failed with error -121NACK(地址无应答)→ -EREMOTEIO(-121)看错误码定位7.4 动态调试# 开 I2C core 调试echo1/sys/module/i2c_core/parameters/debug# 或echofile i2c-core-base.c p/sys/kernel/debug/dynamic_debug/controlechofile i2c-dev.c p/sys/kernel/debug/dynamic_debug/controldmesg-w# 实时看7.5 ftrace 看 I2C 调用echofunction/sys/kernel/debug/tracing/current_tracerechoi2c_*/sys/kernel/debug/tracing/set_ftrace_filterecho1/sys/kernel/debug/tracing/tracing_on# 跑 I2C 操作cat/sys/kernel/debug/tracing/trace八、调试驱动技巧8.1 加 dev_info 打印staticintmy_probe(structi2c_client*client,...){dev_info(client-dev,probe start, addr0x%02x\n,client-addr);intidi2c_smbus_read_byte_data(client,REG_ID);dev_info(client-dev,chip id0x%02x\n,id);if(id!EXPECTED_ID){dev_err(client-dev,chip id mismatch\n);return-ENODEV;}...}8.2 regmap 调试structregmap_configconfig{.reg_bits8,.val_bits8,.reg_format_endianREGMAP_ENDIAN_NATIVE,.cache_typeREGCACHE_RBTREE,.num_reg_defaults_rawARRAY_SIZE(regs),.reg_defaults_rawregs,};// regmap 自带 debugfs// /sys/kernel/debug/regmap/0-0076/// registers -- dump 所有寄存器// name// rangecat/sys/kernel/debug/regmap/0-0076/registers8.3 i2c-dev 调试裸寄存器# 不写驱动,直接 i2c-dev 操作验证器件i2cset-y00x76 0xF4 0x27# 配 BMP280 ctrli2cget-y00x76 0xD0# 读 ID先 i2c-tools 验证器件 寄存器,再写驱动驱动 probe 失败时,i2c-tools 是绕过驱动的验证手段8.4 降速调试i2c0 { clock-frequency 100000; // 降到 100k 排查 };400k 出问题,降到 100k 看好不好降速好了 → 信号完整性/上拉/电容问题降速还不好 → 协议/器件问题九、关键问题 QAQ1:i2cdetect 扫不到,但示波器看到 START 了?A:START 发了但无 ACK。原因:① 地址错(7bit/8bit 混淆);② 器件焊接虚/没贴;③ 器件上电没完成;④ 器件复位引脚没拉高;⑤ VDD 没给到器件。逐项排查。Q2:i2cdump 出来全是 0x00 或 0xFF?A:全 0x00:可能地址错,读到全 0(总线被拉低)全 0xFF:无 ACK,i2cdump 默认填 FF确认地址对、器件在、能正常 i2cgetQ3:示波器看到上升沿很缓,怎么办?A:tr 大说明 Rp 太大或 Cb 太大。减小 Rp(如 10k → 4.7k)减小总线电容(短线/少器件/分段 TCA9548A)降速(给 tr 更多时间)检查上拉是不是真的接了(虚焊)Q4:逻辑分析仪解码地址对,但 ACK 总是 NACK?A:地址发了但从机不应答。① 器件没上电/复位没释放;② 器件地址引脚配置错(A0/A1/A2);③ 器件不支持该地址模式(10bit 器件用 7bit 扫);④ 器件在休眠模式要先唤醒。Q5:Linux 下 I2C 报 -121(-EREMOTEIO)是什么?A:-EREMOTEIO(-121)是 I2C 子系统表示从机 NACK的典型错误码。地址 NACK(器件不在)或数据 NACK(器件异常)都会报。看 dmesg 具体日志区分。Q6:偶发挂死,抓不到现场,怎么办?A:软件加错误统计 日志(记录每次错误类型/时间)看门狗监控,挂死触发恢复并记录逻辑分析仪长时间抓(循环触发 长存储)排除规律(温度?电源?电磁干扰?)故障注入测试(主动复现)十、实战案例案例 1:地址 0x50 扫不到现象:i2cdetect 扫不到 EEPROM 0x50。排查:万用表测 VDD3.3V(对)测 SDA/SCL 静态3.3V(对,上拉在)示波器抓:START 发了,地址 0x50 发了,第 9 拍 SDA 没拉低(NACK)查 EEPROM 焊接:发现 SDA 焊盘虚焊补焊后正常案例 2:7bit vs 8bit 地址混淆现象:datasheet 写器件地址 0xA0,i2cdetect 扫不到 0xA0。分析:0xA0 是 8bit 写地址(0x501|0)。i2cdetect 用 7bit,应扫 0x50。解决:用 0x50 扫,扫到。Linux 设备树 reg 也用 7bit。案例 3:400k 偶发数据错现象:400k 读 BMP280,偶发温度异常。排查:逻辑分析仪抓:上升沿 tr500ns(400k 要求300ns)算 Cb:tr/(0.8473×Rp)500ns/(0.8473×4.7k)125pF(偏大,线太长)减小 Rp 到 2.2k,tr 降到 230ns,正常或降速到 100k案例 4:写 EEPROM 后读,偶发挂死现象:写 EEPROM 立刻读,偶发 BUSY 卡死。分析(10 篇案例):EEPROM 写周期 5ms 内拉伸 SCL,控制器未配拉伸超时。解决:配拉伸超时 写后 delay 5ms 再读。案例 5:多器件共总线,某器件偶发 NACK现象:EEPROM BMP280 OLED 共总线,偶发 BMP280 NACK。排查:算总线电容:3 器件 长线 150pF(偏大)上拉 10k,tr1.3μs(400k 不达标)减上拉到 4.7k,tr600ns(勉强)或用 TCA9548A 分段,各段独立电容案例 6:Linux 驱动 probe 失败现象:BMP280 驱动 probe 报 -ENODEV。排查:dmesg:chip id0x00, expected 0x58i2cget 读 0xD0 也是 0x00 → 通信层就有问题i2cdetect 扫到 0x76 → 控制器 OK,器件应答地址示波器:地址 ACK,但数据 NACK → 器件收到地址但读寄存器不响应查 datasheet:BMP280 上电后需要 2ms 稳定才能读probe 加 delay 2ms 后再读,正常案例 7:EMI 导致偶发误 START现象:工控现场 I2C 偶发数据错,dmesg 报 ARB_LOST(单主不该有)。分析:EMI 毛刺在 SCL 高时让 SDA 下降,被误识别为 START/仲裁。解决:增大控制器滤波长度PCB 加 EMI 抑制(屏蔽线/限流/地平面)软件加 CRC 校验,错乱重读案例 8:DMA 读数据首字节错现象:DMA 读 BMP280,首字节恒错。分析(09 篇):DMA 启动前没先发读请求命令位,I2C 没真正发读事务,DMA 搬的是无效数据。解决:DMA 启动前先 PIO 发 N 个读请求命令(bit81),再启动 DMA 收。十一、本篇小结与速查核心要点工具链:软件(i2c-tools/sysfs/dmesg/ftrace)→ 硬件(万用表/示波器/逻辑分析仪)i2c-tools:detect 扫地址 / dump 寄存器 / get-set 读写 / transfer 灵活传输示波器看模拟(电平/上升沿/毛刺),逻辑分析仪看数字(协议解码/时序)万用表测静态:VDD/SDA-SCL 电平/上拉电阻/通断故障定位:现象 → dmesg 看错误类型 → 示波器/逻辑分析仪抓波形 → 根因7bit vs 8bit 地址坑:datasheet 0xA0 实际 7bit 是 0x50降速是排查信号完整性的利器(降速好了 SI 问题)i2c-tools 绕过驱动直接操作,验证器件/寄存器regmap debugfs 可 dump 寄存器偶发问题:软件统计 长抓 故障注入排查决策表现象第一步第二步地址扫不到万用表测电平/上拉示波器看 START 有没有读写偶发错dmesg 看错误码逻辑分析仪抓波形总线挂死GPIO 读 SDA/SCL9 时钟恢复(10 篇)数据错位逻辑分析仪看时序检查 Sr / 采样点上升沿缓测 tr / 算 Cb减 Rp / 降速 / 分段NACK确认地址/上电/焊接示波器看 ACK 拍probe 失败dmesg 看错误i2c-tools 绕过驱动验证速查表想干啥命令/方法扫总线i2cdetect -y Ndump 寄存器i2cdump -y N 0x50读寄存器i2cget -y N 0x50 0x10写寄存器i2cset -y N 0x50 0x10 0xAB灵活传输i2ctransfer -y N w10x50 0x10 r6看 clientls /sys/bus/i2c/devices/看日志dmesg | grep i2c看 regmapcat /sys/kernel/debug/regmap/0-0076/registers降速调试设备树 clock-frequency100000测上拉万用表电阻档 SDA-VDD测电容示波器测 tr,算 Cbtr/(0.8473×Rp)协议解码逻辑分析仪 I2C decode延伸阅读【I2C 技术系列 10】I2C 错误处理与总线恢复 —— 故障恢复机制【I2C 技术系列 12】I2C 设备驱动实战 —— 器件驱动调试[[14-I2C排查手册与速查表]] —— 现场速查【I2C 技术系列 01】I2C 电气特性与物理层 —— 电平/上拉原理【I2C 技术系列 02】I2C 上拉电阻与总线电容设计 —— Rp/Cb 计算【I2C 技术系列 06】I2C 速度模式与时序参数 —— 时序参数判据【Linux内核专栏 16】调试与性能 —— Linux 调试方法参考资料Linux Documentation/i2c/dev-interfacei2c-tools man pagesSaleae Logic / sigrok 文档NXP AN282(I2C 故障诊断)【I2C 技术系列 00】总目录 · 上一篇:[[12-I2C设备驱动实战]] ·下一篇:[[14-I2C排查手册与速查表]]✨ 感谢你的阅读 ✨技术之路漫漫分享是为了更好地交流。如果本文的内容对你有启发希望能得到你的支持 点赞|⭐ 收藏| 关注如果你在调试过程中遇到了其他问题欢迎在评论区 留言我们一起探讨。关注我一起交流底层开发的那些事儿
I2C 技术系列 · 持续更新中本系列从 OD 开漏物理层一路打到 Linux i2c子系统,把两根线背后那套电气/协议/仲裁/恢复/驱动全拧成一根线。 想系统追更戳这里查看完整目录【I2C 技术系列 00】总目录本篇定位:代码写完了,但跑起来有问题——地址扫不到、读写错、偶发挂死。本篇讲 I2C 调试工具链(i2c-tools / 示波器 / 逻辑分析仪)和故障定位方法论,从现象到根因的完整排查路径。读完你遇到 I2C 问题不会瞎试,有章法。调试是经验,更是方法I2C 问题千奇百怪:地址不对、上拉不够、电容超标、时序违规、EMI 干扰。瞎试三天不如按方法三小时定位。工具会用 排查有章法 资深 BSP 工程师的水准。目录一、调试工具链总览二、i2c-tools 详解2.1 i2cdetect —— 扫描总线2.2 i2cdump —— dump 寄存器2.3 i2cget / i2cset —— 读写单寄存器2.4 i2ctransfer —— 灵活传输(新工具)2.5 i2cdetect -l —— 列出总线三、示波器抓波形3.1 探头接法3.2 看什么3.3 典型波形3.4 测量技巧四、逻辑分析仪分析4.1 优势4.2 工具4.3 解码步骤4.4 看什么4.5 协议解码示例五、万用表与上拉测量5.1 静态测量5.2 上拉电阻验证5.3 总线电容估算5.4 上电时序检查六、常见故障定位流程6.1 地址扫不到(i2cdetect 无响应)6.2 读写偶发错误6.3 总线挂死(BUSY 一直 1)6.4 数据错位七、dmesg 与内核日志7.1 看 I2C 相关日志7.2 probe 日志7.3 错误日志7.4 动态调试7.5 ftrace 看 I2C 调用八、调试驱动技巧8.1 加 dev_info 打印8.2 regmap 调试8.3 i2c-dev 调试裸寄存器8.4 降速调试九、关键问题 QAQ1:i2cdetect 扫不到,但示波器看到 START 了?Q2:i2cdump 出来全是 0x00 或 0xFF?Q3:示波器看到上升沿很缓,怎么办?Q4:逻辑分析仪解码地址对,但 ACK 总是 NACK?Q5:Linux 下 I2C 报 -121(-EREMOTEIO)是什么?Q6:偶发挂死,抓不到现场,怎么办?十、实战案例案例 1:地址 0x50 扫不到案例 2:7bit vs 8bit 地址混淆案例 3:400k 偶发数据错案例 4:写 EEPROM 后读,偶发挂死案例 5:多器件共总线,某器件偶发 NACK案例 6:Linux 驱动 probe 失败案例 7:EMI 导致偶发误 START案例 8:DMA 读数据首字节错十一、本篇小结与速查核心要点排查决策表速查表延伸阅读参考资料一、调试工具链总览软件层: i2c-tools(i2cdetect/dump/get/set) ── 用户态快速验证 /sys/bus/i2c/ ── sysfs 查设备 dmesg ── 内核日志看 probe/错误 ftrace / debugfs ── 内核 I2C 调试 硬件层: 万用表 ── 测电压/上拉/通断 示波器 ── 看模拟波形(电平/上升沿/毛刺) 逻辑分析仪 ── 看数字时序(协议解码) 工具选择: 先软件(i2c-tools) ── 快速定位通不通 再硬件(示波器/逻辑分析仪) ── 深入为什么不通工具解决什么成本i2c-tools地址扫到没、寄存器读写对不对零(软件)万用表上拉有没有、电压对不对、短路没低示波器波形电平、上升沿、毛刺、时序中逻辑分析仪协议解码、时序参数、多通道中二、i2c-tools 详解2.1 i2cdetect —— 扫描总线i2cdetect-y0# 0 1 2 3 4 5 6 7 8 9 a b c d e f# 00: -- -- -- -- -- -- -- --# 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --# ...# 50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --# 60: -- -- -- -- -- -- -- -- -- 68 69 -- -- -- -- --# 70: -- -- -- -- -- -- -- ---y:不交互确认0:总线号(/dev/i2c-0)扫描两种方式:快速写(默认)/ 读模式(-r)--:保留地址(0x00-0x07, 0x78-0x7f)不扫UU:内核驱动已占用该地址i2cdetect 会发真实 I2C 事务i2cdetect 对每个地址发写请求看是否 ACK。某些器件被意外写会出问题(如 EEPROM 写到错地址)。功能安全场景慎用,或用-r读模式(只读不写)。2.2 i2cdump —— dump 寄存器# dump 0x50 的 256 字节寄存器i2cdump-y00x50# 指定模式i2cdump-y00x50 b# byte 模式(默认)i2cdump-y00x50 w# word 模式(16bit)i2cdump-y00x50 c# byte 模式(连续读)EEPROM dump 出来是数据表传感器 dump 看寄存器默认值,对比 datasheet2.3 i2cget / i2cset —— 读写单寄存器# 读 0x50 的 0x10 寄存器(字节)i2cget-y00x50 0x10# 读 wordi2cget-y00x50 0x10 w# 写 0xAB 到 0x50 的 0x10i2cset-y00x50 0x10 0xAB# 写 wordi2cset-y00x50 0x10 0xABCD w2.4 i2ctransfer —— 灵活传输(新工具)# 写 2 字节(地址 0x10, 数据 0xAB 0xCD)到 0x50i2ctransfer-y0w30x50 0x10 0xAB 0xCD# 从 0x50 读 6 字节(先写 0x10 设地址,Sr 读)i2ctransfer-y0w10x50 0x10 r6w30x50:写 3 字节到 0x50r6:读 6 字节比 i2cget/set 灵活,支持任意 msg 组合2.5 i2cdetect -l —— 列出总线i2cdetect-l# i2c-0 i2c rk3x-i2c I2C adapter# i2c-1 i2c rk3x-i2c I2C adapter三、示波器抓波形3.1 探头接法CH1 接 SDA,CH2 接 SCL地夹接被测板的地探头×10 档(减小寄生电容)触发:SCL 下降沿或 SDA 下降沿(START)3.2 看什么检查项正常异常电平幅度高VDD,低≈0高不够(上拉弱/漏电)上升沿 tr满足模式要求(400k300ns)太缓(Rp 太大/Cb 太大)下降沿 tf300ns太缓(驱动弱/线长)SCL 高电平期间 SDA稳定抖动(干扰)START/STOP 边沿清晰模糊(上升沿缓)ACK 拉低第 9 拍 SDA 低没拉低(地址错/无器件)3.3 典型波形正常 START 地址 ACK:SDA ‾‾‾‾‾‾\‾‾‾‾‾‾‾‾‾‾‾‾‾\___/‾‾‾\___/‾‾‾‾‾ ↓(START) 数据MSB... ACK(低) SCL ‾‾‾‾‾‾‾‾\_/‾\_/‾\_/‾\_/‾\_/‾\_/‾\_/‾‾‾ 高时SDA下降START上拉不足(上升沿缓):SDA ___/‾‾‾‾‾‾‾‾‾‾‾(缓慢上升,过冲不到 VDD) ↑ tr 太大,Rp 太大或 Cb 太大无 ACK:SDA 数据发完,第9拍 SDA 没被拉低(保持高NACK) → 地址错/器件不在/器件忙3.4 测量技巧用示波器协议解码功能(I2C decode),直接显示地址/数据抓偶发故障用单次触发 长存储看毛刺用峰值检测模式测 tr:光标卡上升沿 0.3VDD 到 0.7VDD四、逻辑分析仪分析4.1 优势多通道(SDA/SCL/其他信号)协议自动解码(I2C/SPI/UART)长时间记录,找偶发问题时序参数测量4.2 工具硬件:Saleae Logic / 逻辑分析仪(几十元的 USB 8 通道够用)软件:PulseView / Saleae Logic / sigrok4.3 解码步骤接 SDA/SCL 两通道采样率 ≥ 10× I2C 速度(400k 用 4MHz)选 I2C 协议解码设置 SDA/SCL 通道抓取后看解码的地址/数据/ACK4.4 看什么检查项说明地址对不对(7bit vs 8bit 坑)ACK/NACK每字节后 ACK 还是 NACKSTART/STOP时序对不对,有没有误触发Sr读寄存器有没有正确 Sr时序参数tSU/tHD/tLOW/tHIGH 是否违规拉伸SCL 有没有被从机拉低4.5 协议解码示例START ADDR: 0x76 (W) ACK DATA: 0xD0 ACK Sr ADDR: 0x76 (R) ACK DATA: 0x58 NACK ← 主机读最后一字节 NACK(正常) STOP这是 BMP280 读 ID(0xD0)读出 0x58 的完整事务解码后一目了然,比示波器看波形快五、万用表与上拉测量5.1 静态测量测量方法正常异常VDD红表笔接 VDD,黑接地3.3V/5V不对(电源问题)SDA/SCL 静态电平总线空闲时测VDD(上拉)低(短路/器件拉低)上拉电阻断电测 SDA-VDD 电阻4.7k/10k 左右开路/短路/错值SDA-SCL 通断测两线间不通短路(严重故障)SDA/SCL 对地测对地电阻高阻(MΩ)低(短路/器件坏)5.2 上拉电阻验证断电,万用表电阻档测 SDA 到 VDD应读出 Rp 值(如 4.7k)读 0:短路;读 ∞:上拉开路(没焊/断线)5.3 总线电容估算断电,示波器测上升时间 trCb tr / (0.8473 × Rp)例:tr300ns, Rp4.7k → Cb75pF,正常tr1μs, Rp4.7k → Cb250pF,偏大5.4 上电时序检查上电瞬间示波器看 SDA/SCL从机不应在上电时拉低 SDA/SCL(影响主机初始化)若从机上电慢,主机初始化要 delay六、常见故障定位流程6.1 地址扫不到(i2cdetect 无响应)i2cdetect 无 0x50 ↓ 1. 硬件:器件在不在?焊接对不对? ├ 万用表测 VDD(有电?) ├ 测 SDA/SCL 静态电平(应 VDD) └ 测上拉电阻(有?) ↓ 2. 地址对不对? ├ 查 datasheet 地址(7bit) ├ 引脚配置位(A0/A1/A2)设对没 └ 7bit vs 8bit 坑(0x50 vs 0xA0) ↓ 3. 总线对不对? ├ i2cdetect -l 看总线号对不对 ├ 设备树 controller enabled? └ pinctrl/clock 配了没 ↓ 4. 示波器抓:发 START 时 SDA/SCL 动不动? ├ 动但无 ACK → 器件没响应(地址/焊接) └ 不动 → 控制器没输出(pinctrl/时钟)6.2 读写偶发错误偶发读写失败 ↓ 1. dmesg 看错误类型(NACK? ARB_LOST? TIMEOUT?) ↓ 2. 示波器/逻辑分析仪抓偶发时刻波形 ├ 上升沿缓? → 上拉/电容问题 ├ 毛刺? → EMI/滤波 └ 拉伸超时? → 从机慢/异常 ↓ 3. 软件加重试 错误统计 ↓ 4. 排除:多任务并发?DMA cache?电压稳?6.3 总线挂死(BUSY 一直 1)BUSY 卡死(10 篇) ↓ GPIO 切输入读 SDA/SCL ├ SCL0 → 从机拉伸 / 短路 ├ SDA0 → 从机拉低不放(9 时钟恢复) └ 都高 → 控制器假 BUSY(软件复位) ↓ 对应恢复手段6.4 数据错位读出数据整体偏移/乱 ↓ 1. 逻辑分析仪看时序:START/地址/数据对不对 ↓ 2. 检查 Sr(读寄存器)对不对 ↓ 3. 检查采样点(SCL 高时 SDA 应稳定) ↓ 4. 加上层 CRC/校验,多次读比对 ↓ 5. 上升沿缓导致采样错?改上拉/降速七、dmesg 与内核日志7.1 看 I2C 相关日志dmesg|grep-ii2cdmesg|grep-ibmp280dmesg|grep-iadapter7.2 probe 日志[ 2.345] rk3x-i2c ff150000.i2c: initialized [ 2.346] i2c i2c-0: adapter [rk3x-i2c] registered [ 2.350] bmp280 0-0076: supply vddio not found, using dummy regulator [ 2.360] bmp280 0-0076: registering I2C device看 probe 成功/失败看 client 注册(i2c-0 上 0x76)看驱动匹配7.3 错误日志[ 12.456] rk3x-i2c ff150000.i2c: unexpected NACK [ 12.457] bmp280 0-0076: failed to read chip id: -121 [ 12.458] bmp280: probe of 0-0076 failed with error -121NACK(地址无应答)→ -EREMOTEIO(-121)看错误码定位7.4 动态调试# 开 I2C core 调试echo1/sys/module/i2c_core/parameters/debug# 或echofile i2c-core-base.c p/sys/kernel/debug/dynamic_debug/controlechofile i2c-dev.c p/sys/kernel/debug/dynamic_debug/controldmesg-w# 实时看7.5 ftrace 看 I2C 调用echofunction/sys/kernel/debug/tracing/current_tracerechoi2c_*/sys/kernel/debug/tracing/set_ftrace_filterecho1/sys/kernel/debug/tracing/tracing_on# 跑 I2C 操作cat/sys/kernel/debug/tracing/trace八、调试驱动技巧8.1 加 dev_info 打印staticintmy_probe(structi2c_client*client,...){dev_info(client-dev,probe start, addr0x%02x\n,client-addr);intidi2c_smbus_read_byte_data(client,REG_ID);dev_info(client-dev,chip id0x%02x\n,id);if(id!EXPECTED_ID){dev_err(client-dev,chip id mismatch\n);return-ENODEV;}...}8.2 regmap 调试structregmap_configconfig{.reg_bits8,.val_bits8,.reg_format_endianREGMAP_ENDIAN_NATIVE,.cache_typeREGCACHE_RBTREE,.num_reg_defaults_rawARRAY_SIZE(regs),.reg_defaults_rawregs,};// regmap 自带 debugfs// /sys/kernel/debug/regmap/0-0076/// registers -- dump 所有寄存器// name// rangecat/sys/kernel/debug/regmap/0-0076/registers8.3 i2c-dev 调试裸寄存器# 不写驱动,直接 i2c-dev 操作验证器件i2cset-y00x76 0xF4 0x27# 配 BMP280 ctrli2cget-y00x76 0xD0# 读 ID先 i2c-tools 验证器件 寄存器,再写驱动驱动 probe 失败时,i2c-tools 是绕过驱动的验证手段8.4 降速调试i2c0 { clock-frequency 100000; // 降到 100k 排查 };400k 出问题,降到 100k 看好不好降速好了 → 信号完整性/上拉/电容问题降速还不好 → 协议/器件问题九、关键问题 QAQ1:i2cdetect 扫不到,但示波器看到 START 了?A:START 发了但无 ACK。原因:① 地址错(7bit/8bit 混淆);② 器件焊接虚/没贴;③ 器件上电没完成;④ 器件复位引脚没拉高;⑤ VDD 没给到器件。逐项排查。Q2:i2cdump 出来全是 0x00 或 0xFF?A:全 0x00:可能地址错,读到全 0(总线被拉低)全 0xFF:无 ACK,i2cdump 默认填 FF确认地址对、器件在、能正常 i2cgetQ3:示波器看到上升沿很缓,怎么办?A:tr 大说明 Rp 太大或 Cb 太大。减小 Rp(如 10k → 4.7k)减小总线电容(短线/少器件/分段 TCA9548A)降速(给 tr 更多时间)检查上拉是不是真的接了(虚焊)Q4:逻辑分析仪解码地址对,但 ACK 总是 NACK?A:地址发了但从机不应答。① 器件没上电/复位没释放;② 器件地址引脚配置错(A0/A1/A2);③ 器件不支持该地址模式(10bit 器件用 7bit 扫);④ 器件在休眠模式要先唤醒。Q5:Linux 下 I2C 报 -121(-EREMOTEIO)是什么?A:-EREMOTEIO(-121)是 I2C 子系统表示从机 NACK的典型错误码。地址 NACK(器件不在)或数据 NACK(器件异常)都会报。看 dmesg 具体日志区分。Q6:偶发挂死,抓不到现场,怎么办?A:软件加错误统计 日志(记录每次错误类型/时间)看门狗监控,挂死触发恢复并记录逻辑分析仪长时间抓(循环触发 长存储)排除规律(温度?电源?电磁干扰?)故障注入测试(主动复现)十、实战案例案例 1:地址 0x50 扫不到现象:i2cdetect 扫不到 EEPROM 0x50。排查:万用表测 VDD3.3V(对)测 SDA/SCL 静态3.3V(对,上拉在)示波器抓:START 发了,地址 0x50 发了,第 9 拍 SDA 没拉低(NACK)查 EEPROM 焊接:发现 SDA 焊盘虚焊补焊后正常案例 2:7bit vs 8bit 地址混淆现象:datasheet 写器件地址 0xA0,i2cdetect 扫不到 0xA0。分析:0xA0 是 8bit 写地址(0x501|0)。i2cdetect 用 7bit,应扫 0x50。解决:用 0x50 扫,扫到。Linux 设备树 reg 也用 7bit。案例 3:400k 偶发数据错现象:400k 读 BMP280,偶发温度异常。排查:逻辑分析仪抓:上升沿 tr500ns(400k 要求300ns)算 Cb:tr/(0.8473×Rp)500ns/(0.8473×4.7k)125pF(偏大,线太长)减小 Rp 到 2.2k,tr 降到 230ns,正常或降速到 100k案例 4:写 EEPROM 后读,偶发挂死现象:写 EEPROM 立刻读,偶发 BUSY 卡死。分析(10 篇案例):EEPROM 写周期 5ms 内拉伸 SCL,控制器未配拉伸超时。解决:配拉伸超时 写后 delay 5ms 再读。案例 5:多器件共总线,某器件偶发 NACK现象:EEPROM BMP280 OLED 共总线,偶发 BMP280 NACK。排查:算总线电容:3 器件 长线 150pF(偏大)上拉 10k,tr1.3μs(400k 不达标)减上拉到 4.7k,tr600ns(勉强)或用 TCA9548A 分段,各段独立电容案例 6:Linux 驱动 probe 失败现象:BMP280 驱动 probe 报 -ENODEV。排查:dmesg:chip id0x00, expected 0x58i2cget 读 0xD0 也是 0x00 → 通信层就有问题i2cdetect 扫到 0x76 → 控制器 OK,器件应答地址示波器:地址 ACK,但数据 NACK → 器件收到地址但读寄存器不响应查 datasheet:BMP280 上电后需要 2ms 稳定才能读probe 加 delay 2ms 后再读,正常案例 7:EMI 导致偶发误 START现象:工控现场 I2C 偶发数据错,dmesg 报 ARB_LOST(单主不该有)。分析:EMI 毛刺在 SCL 高时让 SDA 下降,被误识别为 START/仲裁。解决:增大控制器滤波长度PCB 加 EMI 抑制(屏蔽线/限流/地平面)软件加 CRC 校验,错乱重读案例 8:DMA 读数据首字节错现象:DMA 读 BMP280,首字节恒错。分析(09 篇):DMA 启动前没先发读请求命令位,I2C 没真正发读事务,DMA 搬的是无效数据。解决:DMA 启动前先 PIO 发 N 个读请求命令(bit81),再启动 DMA 收。十一、本篇小结与速查核心要点工具链:软件(i2c-tools/sysfs/dmesg/ftrace)→ 硬件(万用表/示波器/逻辑分析仪)i2c-tools:detect 扫地址 / dump 寄存器 / get-set 读写 / transfer 灵活传输示波器看模拟(电平/上升沿/毛刺),逻辑分析仪看数字(协议解码/时序)万用表测静态:VDD/SDA-SCL 电平/上拉电阻/通断故障定位:现象 → dmesg 看错误类型 → 示波器/逻辑分析仪抓波形 → 根因7bit vs 8bit 地址坑:datasheet 0xA0 实际 7bit 是 0x50降速是排查信号完整性的利器(降速好了 SI 问题)i2c-tools 绕过驱动直接操作,验证器件/寄存器regmap debugfs 可 dump 寄存器偶发问题:软件统计 长抓 故障注入排查决策表现象第一步第二步地址扫不到万用表测电平/上拉示波器看 START 有没有读写偶发错dmesg 看错误码逻辑分析仪抓波形总线挂死GPIO 读 SDA/SCL9 时钟恢复(10 篇)数据错位逻辑分析仪看时序检查 Sr / 采样点上升沿缓测 tr / 算 Cb减 Rp / 降速 / 分段NACK确认地址/上电/焊接示波器看 ACK 拍probe 失败dmesg 看错误i2c-tools 绕过驱动验证速查表想干啥命令/方法扫总线i2cdetect -y Ndump 寄存器i2cdump -y N 0x50读寄存器i2cget -y N 0x50 0x10写寄存器i2cset -y N 0x50 0x10 0xAB灵活传输i2ctransfer -y N w10x50 0x10 r6看 clientls /sys/bus/i2c/devices/看日志dmesg | grep i2c看 regmapcat /sys/kernel/debug/regmap/0-0076/registers降速调试设备树 clock-frequency100000测上拉万用表电阻档 SDA-VDD测电容示波器测 tr,算 Cbtr/(0.8473×Rp)协议解码逻辑分析仪 I2C decode延伸阅读【I2C 技术系列 10】I2C 错误处理与总线恢复 —— 故障恢复机制【I2C 技术系列 12】I2C 设备驱动实战 —— 器件驱动调试[[14-I2C排查手册与速查表]] —— 现场速查【I2C 技术系列 01】I2C 电气特性与物理层 —— 电平/上拉原理【I2C 技术系列 02】I2C 上拉电阻与总线电容设计 —— Rp/Cb 计算【I2C 技术系列 06】I2C 速度模式与时序参数 —— 时序参数判据【Linux内核专栏 16】调试与性能 —— Linux 调试方法参考资料Linux Documentation/i2c/dev-interfacei2c-tools man pagesSaleae Logic / sigrok 文档NXP AN282(I2C 故障诊断)【I2C 技术系列 00】总目录 · 上一篇:[[12-I2C设备驱动实战]] ·下一篇:[[14-I2C排查手册与速查表]]✨ 感谢你的阅读 ✨技术之路漫漫分享是为了更好地交流。如果本文的内容对你有启发希望能得到你的支持 点赞|⭐ 收藏| 关注如果你在调试过程中遇到了其他问题欢迎在评论区 留言我们一起探讨。关注我一起交流底层开发的那些事儿
