单片机与物联网 / 系统课时
定位常见故障
定位常见故障
本节给出一条可重复的 ESP32 排障路径:先确认“供电、串口、复位原因和资源状态”这些基础证据,再分别处理烧录失败、反复重启、内存不足、网络掉线和外设无响应,避免靠反复换线、重刷或改代码碰运气。
学习目标
- 用固定顺序收集串口、复位原因、堆内存、Wi-Fi 和总线设备证据。
- 根据故障现象区分供电、启动模式、软件崩溃、资源耗尽和外设连接问题。
- 修复后用同一组指标复测,确认问题真正消失而不是暂时恢复。
先固定证据链
排障顺序建议保持稳定:先看是否能上电和枚举串口,再看是否能进入下载模式;程序能运行后读取复位原因和堆内存;网络问题再看连接状态与信号;外设问题最后确认供电、电平、地址和总线响应。顺序固定后,症状会快速收敛到某一层。

用诊断程序先拿到基础数据
下面的 Arduino ESP32 程序不依赖业务逻辑,启动后输出复位原因、当前与最低空闲堆、Wi-Fi 状态,并扫描默认 I2C 总线。它适合先烧录到可运行的设备上,建立一个“硬件和运行时是否基本正常”的基线。
cpp
#include <Arduino.h>
#include <WiFi.h>
#include <Wire.h>
#include "esp_system.h"
void scanI2C() {
int found = 0;
for (uint8_t address = 1; address < 127; ++address) {
Wire.beginTransmission(address);
if (Wire.endTransmission() == 0) {
Serial.printf("i2c_device=0x%02X\n", address);
++found;
}
}
Serial.printf("i2c_devices=%d\n", found);
}
void setup() {
Serial.begin(115200);
delay(500);
Wire.begin();
Serial.printf("reset_reason=%d\n", static_cast<int>(esp_reset_reason()));
Serial.printf("free_heap=%u\n", ESP.getFreeHeap());
Serial.printf("min_free_heap=%u\n", ESP.getMinFreeHeap());
Serial.printf("wifi_status=%d\n", static_cast<int>(WiFi.status()));
scanI2C();
}
void loop() {
delay(5000);
Serial.printf(
"free_heap=%u min_free_heap=%u wifi_status=%d\n",
ESP.getFreeHeap(),
ESP.getMinFreeHeap(),
static_cast<int>(WiFi.status()));
}预期输出
text
reset_reason=<VALUE>
free_heap=<VALUE>
min_free_heap=<VALUE>
wifi_status=<VALUE>
i2c_device=<VALUE>
i2c_devices=<VALUE>
free_heap=<VALUE> min_free_heap=<VALUE> wifi_status=<VALUE>实际数值会随芯片、固件和连接状态变化。重点不是追求固定数字,而是观察趋势:min_free_heap 是否不断下降、复位原因是否重复、I2C 设备是否稳定出现。
按症状缩小根因
| 现象 | 第一批证据 | 常见根因与动作 |
|---|---|---|
| 烧录失败 | 串口是否出现、串口监视器是否关闭、BOOT/EN 状态 | 换确认可传数据的 USB 线;关闭占用串口的软件;必要时按住 BOOT 再触发下载;降低上传速率只作为兼容性措施 |
| 反复重启 | 复位原因、串口 Panic、供电电压 | Brownout 先查电源和峰值电流;Watchdog 查阻塞循环;Panic 查异常堆栈对应代码 |
| 内存不足 | free_heap、min_free_heap 的长期趋势 |
查未释放对象、反复创建大 String、过大的 JSON/图像缓冲区;让缓冲区复用并限制峰值 |
| 网络掉线 | WiFi.status()、RSSI、掉线是否与大电流外设同步 |
检查信号与 AP 稳定性;避免忙循环阻塞网络任务;加入有限退避重连,不要每毫秒调用 WiFi.begin() |
| 外设无响应 | 供电、电平、共地、I2C 扫描结果、引脚占用 | 先确认地址和接线,再查上拉、电平兼容、总线频率,以及引脚是否被启动配置或其他外设占用 |
修复后必须复测
修复动作要和原始证据一一对应。例如更换电源后,应确认 Brownout 不再出现;修改内存管理后,应运行足够长时间观察 min_free_heap 是否稳定;网络重连修改后,应主动断开 AP 再恢复,确认设备能回到已连接状态;外设修复后,I2C 扫描结果应连续多次保持一致。
如果一次修改同时动了供电、代码和网络配置,即使故障消失也无法确定根因。工程排障更有效的做法是一次只改变一个变量,并记录“现象、证据、假设、修改、复测结果”,这样同类问题再次出现时可以直接复用证据链。
按自己的节奏,确认真正理解。