单片机与物联网 / 系统课时

排查总线故障

排查总线故障

当 ESP32 与 I2C 外设通信失败时,不要直接怀疑代码或更换模块。本节用“地址扫描→引脚核对→电平与上拉检查→降低时钟→重新验证”的顺序建立证据链,定位最常见的总线故障。

学习目标

  • 使用 I2C 地址扫描程序确认 ESP32 是否能发现从设备
  • 从地址、GPIO、电平、上拉电阻和时钟频率逐项定位通信失败原因
  • 根据扫描结果和电气现象判断下一步修复动作

先用扫描结果划分故障范围

排查前先确认一个事实:总线上是否存在任何能够应答的设备。如果扫描程序一个地址都找不到,优先检查接线、电源、GPIO 和上拉;如果能扫描到设备但应用程序仍失败,则重点核对设备地址、寄存器协议和库配置。

以经典 ESP32 开发板常见的 GPIO21 作为 SDA、GPIO22 作为 SCL 为例。不同 ESP32、ESP32-S3、ESP32-C3 开发板的可用引脚不同,代码中的 GPIO 必须与实际接线一致。

cpp
#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() {
}

预期输出

text
发现 I2C 设备:0x3C

这里假设连接的是地址为 0x3C 的设备;实际地址由模块型号和地址选择引脚决定。如果输出是“未发现 I2C 设备”,说明故障发生在应用层协议之前,应继续检查总线本身。

按固定顺序检查总线

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 和上拉,转而检查对应驱动库中的设备地址、初始化参数、寄存器协议与器件型号。这样可以把“总线故障”和“设备协议故障”明确分开,避免在错误层级反复试错。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查总线故障

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通