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

系统化排查流程

系统化排查流程

本课建立一套可重复的 STM32 故障排查顺序:先确认供电和时钟等基础条件,再检查引脚、配置、通信、代码与时序,并用可观察证据逐层缩小范围,避免无目的地改代码。

学习目标

  • 按固定顺序完成从硬件到软件的逐层排查
  • 为每一步设计可测量、可复现的验证证据
  • 使用最小诊断程序区分硬件、配置与业务代码问题

先记录现象和边界

开始修改工程前,先把“发生了什么”写清楚。至少记录故障是否稳定复现、上电后何时出现、哪些功能正常、最近改动了什么,以及复位后是否恢复。现象越具体,后续判断越少依赖猜测。

不要把“串口坏了”当作结论,应改写为“USART1 无输出,但 LED 仍按 500 ms 周期闪烁”。后者已经证明主循环、系统时钟和部分 GPIO 正常,排查范围会立即缩小。

按从底层到上层的顺序检查

STM32 系统化故障排查流程图

固定顺序的价值在于:上层功能依赖下层条件。供电不稳时继续检查协议代码,或时钟未启动时反复修改波特率,都只会制造新的变量。

层级 关键检查 可接受证据
供电 测量 VDD、VDDA、GND 和纹波 电压位于器件允许范围且上电稳定
时钟 检查时钟源、PLL 和 SystemCoreClock 调试器可见配置正确,延时周期符合预期
引脚 核对封装、复用、上下拉和电气方向 实际引脚电平与代码动作一致
配置 对照 CubeMX、初始化代码和中断优先级 外设句柄状态正常,无初始化错误
通信 检查连线、共地、电平、波特率与帧格式 逻辑分析仪或示波器看到正确波形
代码 用最小路径替代业务逻辑 基础收发或翻转功能独立通过
时序 检查超时、竞争、阻塞和中断执行时间 临界路径满足周期与响应要求

用最小诊断程序建立证据

下面是片段示例,依赖 CubeMX 已生成 GPIO、USART1 初始化代码,并定义 LED_GPIO_Port、LED_Pin 和 huart1。把它放入现有工程,在主循环中每 500 ms 调用一次,可同时验证主循环、GPIO 和串口发送路径。

c
#include "main.h"
#include <stdio.h>

extern UART_HandleTypeDef huart1;

void Diagnostic_RunOnce(void)
{
    char message[64];

    // LED 翻转用于证明主循环仍在持续运行
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);

    int length = snprintf(
        message,
        sizeof(message),
        "[DIAG] tick=%lu, led=%u\r\n",
        HAL_GetTick(),
        HAL_GPIO_ReadPin(LED_GPIO_Port, LED_Pin)
    );

    // 短超时可避免诊断代码长期阻塞主循环
    HAL_UART_Transmit(
        &huart1,
        (uint8_t *)message,
        (uint16_t)length,
        100
    );
}

主循环调用方式如下。

c
while (1)
{
    Diagnostic_RunOnce();
    HAL_Delay(500);
}

预期结果

text
[DIAG] tick=<TIME>, led=1
[DIAG] tick=<TIME>, led=0

<TIME> 为运行时毫秒计数,实际值会变化。若 LED 正常翻转但串口无输出,应集中检查串口引脚复用、连线、电平和波特率;若两者都不工作,应返回检查供电、复位、时钟和初始化流程。

一次只验证一个假设

每次只改变一个变量,并在修改前写出假设。例如:“USART1 无输出是因为 TX 引脚仍处于普通 GPIO 模式。”随后只修改引脚复用并重新测量。若同时更改时钟、波特率和中断代码,即使故障消失,也无法确认真正根因。

排查时优先使用外部证据:万用表确认电压,示波器确认波形,逻辑分析仪确认协议,调试器确认寄存器和执行位置,日志确认状态变化。单看源码只能说明程序“打算做什么”,不能证明硬件“实际做了什么”。

修复后完成回归验证

找到根因后,不要只验证故障现象已经消失。还应恢复原业务代码,重复冷启动、热复位、长时间运行和边界输入,并确认修复没有破坏其他外设。最后记录现象、根因、修复项和验证方法,形成可复用的排查案例。

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

目录与阅读设置

阅读设置

17

记录一个想法

系统化排查流程

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

登录哪都通