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

定位常见故障

定位常见故障

本节给出一条可重复的 ESP32 排障路径:先确认“供电、串口、复位原因和资源状态”这些基础证据,再分别处理烧录失败、反复重启、内存不足、网络掉线和外设无响应,避免靠反复换线、重刷或改代码碰运气。

学习目标

  • 用固定顺序收集串口、复位原因、堆内存、Wi-Fi 和总线设备证据。
  • 根据故障现象区分供电、启动模式、软件崩溃、资源耗尽和外设连接问题。
  • 修复后用同一组指标复测,确认问题真正消失而不是暂时恢复。

先固定证据链

排障顺序建议保持稳定:先看是否能上电和枚举串口,再看是否能进入下载模式;程序能运行后读取复位原因和堆内存;网络问题再看连接状态与信号;外设问题最后确认供电、电平、地址和总线响应。顺序固定后,症状会快速收敛到某一层。

ESP32 常见故障排查流程

用诊断程序先拿到基础数据

下面的 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 扫描结果应连续多次保持一致。

如果一次修改同时动了供电、代码和网络配置,即使故障消失也无法确定根因。工程排障更有效的做法是一次只改变一个变量,并记录“现象、证据、假设、修改、复测结果”,这样同类问题再次出现时可以直接复用证据链。

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

目录与阅读设置

阅读设置

17

记录一个想法

定位常见故障

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

登录哪都通