单片机与物联网 / 系统课时
扫描 I2C 设备
扫描 I2C 设备
I2C 设备接上 ESP32 后,最先要确认的不是驱动库,而是总线是否真的能收到设备应答。本节配置 SDA、SCL 并扫描 7 位地址,用扫描结果验证供电、接线、上拉电阻和设备地址。
学习目标
- 正确连接 I2C 的 SDA、SCL、GND 与上拉电阻
- 使用
Wire扫描 1~126 的 7 位设备地址 - 根据扫描结果定位接线错误、地址不符或总线电气问题
先确认 I2C 总线接线
I2C 使用 SDA 数据线和 SCL 时钟线,多台设备可以并联在同一对线上。两根信号线都是开漏结构,需要通过上拉电阻拉到逻辑电源;很多传感器模块已经自带上拉,因此不能只凭板上是否看到电阻来判断。

经典 ESP32 开发板常用 GPIO21 作为 SDA、GPIO22 作为 SCL,但其他 ESP32 系列或定制板可能不同。若模块允许 5V 供电,也不代表其 SDA、SCL 一定适合直接接到 ESP32;信号线上拉电压应与 ESP32 GPIO 的 3.3V 逻辑兼容。
用 ACK 扫描设备地址
I2C 主机向某个地址发起传输后,如果从机返回 ACK,就说明该地址上存在能够响应的设备。扫描器依次尝试 1~126,跳过保留地址 0 和 127,并打印所有收到 ACK 的地址。
#include <Arduino.h>
#include <Wire.h>
constexpr int SDA_PIN = 21;
constexpr int SCL_PIN = 22;
void scanI2C() {
int found = 0;
Serial.println("Scanning...");
for (uint8_t address = 1; address < 127; ++address) {
Wire.beginTransmission(address);
uint8_t error = Wire.endTransmission();
if (error == 0) {
Serial.print("Found device at 0x");
if (address < 16) {
Serial.print("0");
}
Serial.println(address, HEX);
++found;
} else if (error == 4) {
Serial.print("Unknown error at 0x");
Serial.println(address, HEX);
}
}
Serial.print("Done, ");
Serial.print(found);
Serial.println(" device(s) found.");
}
void setup() {
Serial.begin(115200);
delay(1000);
// 从低速的 100 kHz 开始,便于先验证接线和器件响应。
Wire.begin(SDA_PIN, SCL_PIN);
Wire.setClock(100000);
scanI2C();
}
void loop() {
}预期输出会随实际设备而变化。若总线上有一个正常应答的器件,可看到:
Scanning...
Found device at 0x<VALUE>
Done, 1 device(s) found.其中 <VALUE> 是设备实际的 7 位地址,例如某些 OLED 模块可能显示 3C;不同器件和地址拨码状态会得到不同结果。
读懂扫描结果
扫描到地址只表示该地址能在 I2C 层返回 ACK,并不能证明传感器寄存器、显示内容或业务协议一定正确。它更适合作为驱动开发前的第一道连通性检查:先确认“总线能找到设备”,再继续加载具体设备库。
如果输出为 Done, 0 device(s) found.,应按电气层到配置层的顺序检查,而不是先改驱动代码。先确认模块供电和公共 GND,再检查 SDA/SCL 是否接反、程序里的引脚是否与实际接线一致,最后确认上拉电阻和设备地址选择脚。
扫描通过后的下一步
确认地址后,应把扫描器中的地址记录到具体设备驱动配置里,再进行一次真实读写验证。例如传感器应读取一个已知寄存器,显示屏应完成初始化并显示内容。这样可以把“物理连通”和“协议功能”分成两个阶段验证,出问题时更容易定位。