FPGA 与数字 IC 设计 / 系统课时
调试I2C总线异常
调试I2C总线异常
本课解决 I2C 总线“没响应、地址错误、无 ACK、总线被占用”等问题。通过同时观察 SCL、SDA 与 ACK 的时序关系,可以按总线电气状态、设备地址、协议时序和数据阶段逐层缩小故障范围,最终定位到具体异常环节。
学习目标
- 能从 SCL、SDA 波形识别 START、STOP、地址、数据和 ACK。
- 能按“总线状态→地址阶段→应答阶段→数据阶段”的顺序定位异常。
- 能用逻辑分析仪抓取并验证一个具体的 I2C 失败事务。
先确认一帧 I2C 事务长什么样
I2C 调试最重要的是不要只看 SDA 是否跳变,而要把 SDA 与 SCL 放在同一时间轴上。START 表现为 SCL 为高电平时 SDA 从高变低;STOP 则是在 SCL 为高电平时 SDA 从低变高。正常传输中,SDA 通常只在 SCL 为低时改变,在 SCL 为高时保持稳定供接收端采样。

每发送 8 位地址或数据后,第 9 个时钟用于应答。接收方在 ACK 位把 SDA 拉低表示确认,保持高电平则是 NACK。看到“第 9 个时钟时 SDA 为高”不能立刻断定设备不存在,还要先确认这是地址后的 ACK 位还是数据后的 ACK 位,并确认事务确实形成了完整的 9 个时钟周期。
准备可复现的抓取环境
下面使用 Linux 的 /dev/i2c-1 发起一笔固定写事务,便于逻辑分析仪反复抓取同一种波形。运行前必须确认系统已经启用对应 I2C 控制器、存在 /dev/i2c-1,当前用户具有访问权限;同时需要可用的 Python 3 与 pip,并确保 pip 能访问配置的软件包源以安装 smbus2。如果设备节点不存在,应先按具体开发板或系统方式启用 I2C,而不是直接运行示例。
python3 --version
python3 -m pip --version
python3 -m pip install smbus2
python3 -c "from smbus2 import SMBus; print('smbus2 ready')"预期结果
Python 3.<VERSION>
pip <VERSION> from <PATH>
...
smbus2 readyPython、pip 和安装过程中的版本、路径与下载日志会随环境变化;实际值可能不同。只需确认 Python 3、pip 均可用,smbus2 安装没有报错,并且最后输出 smbus2 ready。
用最小事务检查时序
逻辑分析仪只需抓取一笔能够稳定复现的读或写事务。触发点可选为 SCL 为高时 SDA 出现下降沿,也就是 START 条件,然后观察后续地址、ACK、数据和 STOP。下面的完整程序向 7-bit 地址 0x3C 写入寄存器 0x00 和数据 0x55。
from smbus2 import SMBus
BUS_ID = 1
DEVICE_ADDR = 0x3C
REGISTER = 0x00
VALUE = 0x55
def main():
# 设备必须真实连接在 /dev/i2c-1,且使用 7-bit 地址 0x3C。
with SMBus(BUS_ID) as bus:
bus.write_byte_data(DEVICE_ADDR, REGISTER, VALUE)
# 只有事务未被内核报告错误时才会执行到这里。
print(
f"write ok: addr=0x{DEVICE_ADDR:02X}, "
f"reg=0x{REGISTER:02X}, value=0x{VALUE:02X}"
)
if __name__ == "__main__":
main()预期输出
write ok: addr=0x3C, reg=0x00, value=0x55抓波形时,应看到主控发送 START,随后发送地址和写方向位并收到 ACK,再发送寄存器与数据,各自后跟 ACK,最后以 STOP 结束。若从设备未连接、地址错误或拒绝应答,程序通常会在写操作处报 I/O 错误,因此不会得到上述成功输出。
按阶段定位无响应与无 ACK
先看总线空闲状态。标准 I2C 的 SCL、SDA 在空闲时都应由上拉电阻保持高电平。如果 SDA 长时间为低,优先检查从设备卡住、主控未释放总线、短路、上拉或电平转换等电气问题,不要直接把它解释成地址错误。
当 START 已经出现而地址后的第一个 ACK 缺失时,重点检查目标设备是否上电、地址是否正确、设备是否接在当前总线上,以及 R/W 方向是否符合预期。I2C 常用的是 7-bit 地址,线上发送的首字节由地址左移一位后再加入 R/W 位组成;逻辑分析仪可能显示 7-bit 地址,也可能显示完整地址字节,调试时必须先确认工具采用哪一种表示方式。
如果地址 ACK 正常而后续数据出现 NACK,故障范围通常已经从“设备是否存在”缩小到寄存器地址、数据格式、设备当前状态或事务边界。此时应比较成功事务与失败事务的字节序列,而不是继续重复扫描设备地址。
区分协议问题与电气问题
协议层异常通常表现为时钟数量、位序、START、STOP 或 ACK 关系不符合预期;电气问题则更常表现为边沿过慢、电平达不到门限、SDA 被异常拉低或 SCL 长时间无法释放。逻辑分析仪适合判断数字协议关系,示波器更适合确认上升时间、幅度、振铃和毛刺。
实际定位时,可以固定按以下顺序检查:先确认 SDA、SCL 空闲时是否都为高,再确认 START、地址与 R/W 位、地址 ACK、各数据字节后的 ACK/NACK,最后确认 STOP 是否正常结束以及总线是否重新释放。某一步已经明确异常时,应先停在该层验证根因,不要带着未经确认的假设继续解释后续波形。