用途:面向 ESP32 / ESP-IDF 固件的崩溃与随机复位排障,先区分软件崩溃与硬件原因,再选择调试手段。
主要能力:提供调试手段矩阵——idf.py monitor 观察启动日志与 panic 现场;coredump(flash 的 data/coredump 分区或 UART)事后分析;JTAG/OpenOCD + GDB 断点单步;运行时 GDB stub;VS Code 官方插件图形化。崩溃处理流程为:复现崩溃后 idf.py monitor 抓现场,已配置 coredump 则提取存档,用 idf.py coredump-info 看崩溃任务、寄存器与栈,再用 idf.py coredump-debug 做符号化调试,定位代码后修复并回归验证。随机重启按 crash-triage 决策树分类看门狗、panic、掉电三类复位原因,再定方向。JTAG 侧需核对探测器与目标板,启动命令为 openocd -f board/<目标板>.cfg,可在 GDB 中调试,也支持经 JTAG 烧录。
限制与边界:经典 ESP32 无内置 USB-Serial/JTAG,需外部适配器如 ESP-Prog,且不支持 SWD;接线、TCK 频率与 board cfg 名须查官方板文档或实测,本技能不编造。供电/硬件问题不下结论,只给出嫌疑证据并交接真机在环验证;工程配置、并发、外设、OTA 分别交接 esp32-idf、esp32-freertos、esp32-peripherals、esp32-ota。回溯地址须与固件版本一致,未配置 coredump 的产品难以追随机崩溃。无真机或无现场时结论标注 Build Verification Only / Pending HIL。诊断数据可能含敏感信息,外发前需脱敏并获用户确认。官方来源包括 JTAG 调试、Core Dump 文档、idf.py 工具与 VS Code ESP-IDF 插件。