MCU 固件调试：诊断方法

单片机固件调试：实战诊断技巧

单片机固件诊断从基础系统参数检查开始。没有这些，开发就成了瞎猜。我们将介绍经过验证的技术，从简单LED到高级接口，聚焦STM32及类似平台的实际场景。

第一步：将系统时钟输出到MCO引脚。这样可以在分频后用示波器测量实际的HSE或SYSCLK频率。

HAL_RCC_MCOConfig(RCC_MCO1, RCC_MCO1SOURCE_HSE, RCC_MCODIV_4);
HAL_RCC_MCOConfig(RCC_MCO2, RCC_MCO2SOURCE_SYSCLK, RCC_MCODIV_5);

{.pad.port=PORT_C, .pad.pin=9, .name="MCO_2",   .stm_mode=GPIO_MODE_AF_PP,      .gpio_pull=GPIO__PULL_AIR, .speed=GPIO_SPEED_FREQ_VERY_HIGH,  .alternate= GPIO_AF0_MCO,},
{.pad.port=PORT_A, .pad.pin=8, .name="MCO_1",   .stm_mode=GPIO_MODE_AF_PP,      .gpio_pull=GPIO__PULL_AIR, .speed=GPIO_SPEED_FREQ_VERY_HIGH,  .alternate= GPIO_AF0_MCO,},

将测量值与代码对比，就能发现时钟配置错误。

状态指示灯与基础检查

任何固件都离不开心跳LED。1 Hz闪烁的LED能确认代码在运行、验证定时准确，并显示系统存活。额外加个红色LED表示软件或硬件错误。

• 优势：视觉烟雾测试——无需额外设备。
• 实现：定时器周期500 ms翻转引脚。
• 扩展：多LED对应子系统（时钟、外设）。

LED不闪烁？继续调试无意义——固件没启动或卡死了。

断言函数提供强健检查。它们在零参数时触发：

• makeAssert：Makefile构建时检查。
• preprocAssert：预处理器验证。
• staticAssert：编译时配置验证。
• DynamicAssert：运行时，支持GDB断点。

战略性放置断言，能精确定位项目各阶段故障。

通过接口的高级调试

UART上的CLI是最灵活工具。全双工文本接口（Rx/Tx/GND）支持：

• 按地址读写内存。
• 通过指针调用函数。
• 监控计数器、发送I2C/SPI/UART数据包。
• 解析定时器寄存器。

最小CLI功能：

• 输入回显。
• 非易失性内存命令历史。
• 帮助与TAB补全。
• 认证。
• 彩色输出（错误红色、警告黄色）。
• 表格渲染（GPIO、ADC）。

CLI不会破坏实时定时，不像JTAG/SWD。RAM日志结合UART初始化后刷新，能诊断早期启动，包括时钟。支持级别：LOG_ERROR、LOG_WARNING、LOG_INFO、LOG_DEBUG，并带模块过滤（如ll usb debug）。

信号分析工具

针对实时进程，用GPIO作标记：

• 翻转引脚计数系统初始化步骤。
• GPIO映射：多引脚转二进制码。

示波器（至少2通道，数字式）捕获边沿。逻辑分析仪（Saleae，8–16通道）擅长总线如MII/I2S/SDIO：USB 3.0速度、PC端周期/频率/占空比分析。

DAC（10–12位）输出模拟值到示波器。调试调度器绝佳：电压台阶揭示线程优先级。

步进调试的局限与替代方案

GDB通过SWD/JTAG在断点停顿（HardFault的PC/LR）。但它破坏定时：硬件定时器超前，WDT复位MCU。优化（-O0 -g3）耗费Flash空间，常不可用。

替代：arm-none-eabi-addr2line将HardFault地址映射到源代码行：

set ELF_FILE=C:/ncs/v2.1.0/nrf/applications/nrf5340_audio/build/gateway_app/zephyr/zephyr.elf
set ADDR2LINE="C:\Program Files (x86)\GNU Arm Embedded Toolchain\10 2021.10\bin\arm-none-eabi-addr2line.exe"
%ADDR2LINE% -e %ELF_FILE% 0x000054cd
%ADDR2LINE% -e %ELF_FILE% 0x0000857e

OLED显示屏提供独立指标：Tamagotchi式监控，无需UART。单元测试覆盖无调试器代码，支持安全重构。

关键要点

• 心跳LED与MCO：基础烟雾测试——忽略它们等于闭眼飞行。
• 带日志级别的CLI：无定时干扰的全控。
• GPIO/DAC + 示波器/分析仪：实时信号洞察。
• 断言与addr2line：无需完整调试精确定位HardFault。
• GDB/SWD：定时扭曲下的最后手段。

— Editorial Team