单片机与物联网 / 系统课时
排查总线故障
排查总线故障
当 ESP32 与 I2C 外设通信失败时,不要直接怀疑代码或更换模块。本节用“地址扫描→引脚核对→电平与上拉检查→降低时钟→重新验证”的顺序建立证据链,定位最常见的总线故障。
学习目标
- 使用 I2C 地址扫描程序确认 ESP32 是否能发现从设备
- 从地址、GPIO、电平、上拉电阻和时钟频率逐项定位通信失败原因
- 根据扫描结果和电气现象判断下一步修复动作
先用扫描结果划分故障范围
排查前先确认一个事实:总线上是否存在任何能够应答的设备。如果扫描程序一个地址都找不到,优先检查接线、电源、GPIO 和上拉;如果能扫描到设备但应用程序仍失败,则重点核对设备地址、寄存器协议和库配置。
以经典 ESP32 开发板常见的 GPIO21 作为 SDA、GPIO22 作为 SCL 为例。不同 ESP32、ESP32-S3、ESP32-C3 开发板的可用引脚不同,代码中的 GPIO 必须与实际接线一致。
#include <Arduino.h>
#include <Wire.h>
constexpr int SDA_PIN = 21;
constexpr int SCL_PIN = 22;
void scanI2CBus() {
int found = 0;
for (uint8_t address = 1; address < 127; ++address) {
Wire.beginTransmission(address);
uint8_t error = Wire.endTransmission();
// 返回 0 表示该 7 位地址上的从设备正常应答。
if (error == 0) {
Serial.printf("发现 I2C 设备:0x%02X\n", address);
++found;
}
}
if (found == 0) {
Serial.println("未发现 I2C 设备");
}
}
void setup() {
Serial.begin(115200);
delay(1000);
// 显式指定 SDA、SCL 和 100 kHz,避免依赖开发板默认引脚。
Wire.begin(SDA_PIN, SCL_PIN, 100000);
scanI2CBus();
}
void loop() {
}预期输出
发现 I2C 设备:0x3C这里假设连接的是地址为 0x3C 的设备;实际地址由模块型号和地址选择引脚决定。如果输出是“未发现 I2C 设备”,说明故障发生在应用层协议之前,应继续检查总线本身。
按固定顺序检查总线

排查时按照从确定性最高、成本最低的项目开始,避免同时修改多个变量。
| 检查项 | 正常条件 | 常见故障表现 |
|---|---|---|
| 地址 | 使用设备实际的 7 位地址 | 扫描能发现设备,但业务代码始终 NACK |
| GPIO | SDA、SCL 与代码配置完全一致 | 扫描不到任何地址 |
| 电平与共地 | ESP32 与模块共地,信号电平兼容 3.3V | 通信随机失败,严重时可能损坏 GPIO |
| 上拉电阻 | SDA、SCL 都被适当上拉到兼容电源 | 波形上升慢、扫描不稳定或完全无响应 |
| 时钟频率 | 从 100 kHz 等保守频率开始 | 短线可用、长线或多个设备时频繁报错 |
地址问题尤其容易混淆。很多数据手册会同时出现“7 位地址”和包含读写位的“8 位地址”,Arduino Wire API 使用的是 7 位地址,不要把已经左移并包含 R/W 位的值直接传入。
检查电平、上拉与时钟
I2C 的 SDA 和 SCL 是开漏信号,总线需要上拉电阻才能可靠回到高电平。许多传感器模块已经自带上拉,但裸芯片、转接板或多个模块组合时不能想当然。断电检查原理图或模块标识,并确认 SDA、SCL 没有被错误接到 5V 上拉。
如果地址、接线和供电都正确,但通信偶发失败,可先把 I2C 时钟从较高频率降到 100000 Hz,必要时进一步测试 50000 Hz。降低频率后明显恢复,通常说明总线电容、线长、上拉阻值或器件时序余量存在问题,而不是设备地址错误。
修复后做闭环验证
修复完成后重新运行扫描程序,并连续复位或重新上电数次。稳定的结果应满足:每次都能发现相同地址,没有时有时无的设备,也不会因为轻触线缆就改变扫描结果。
如果扫描已经稳定成功,而具体传感器或显示模块仍无法工作,就应停止继续修改 SDA、SCL 和上拉,转而检查对应驱动库中的设备地址、初始化参数、寄存器协议与器件型号。这样可以把“总线故障”和“设备协议故障”明确分开,避免在错误层级反复试错。