单片机与物联网 / 系统课时
在启动阶段读取看门狗复位标志
在启动阶段读取看门狗复位标志
设备意外重启后,单凭启动日志无法判断是程序主动复位,还是看门狗超时。本课以 STM32F407 和 STM32CubeF4 HAL 为例,在启动入口保存 RCC 复位标志、及时清除旧状态,再用软件复位与 IWDG 超时实验验证判因结果。
学习目标
- 在外设初始化之前保存
RCC->CSR的复位原因位,并理解标志为什么需要清除。 - 使用串口记录 IWDG、WWDG 与软件复位标志,保留可供调试的原始快照。
- 分别制造软件复位和看门狗超时,核对下一次启动的日志。
看懂复位标志与读取时机
STM32F407 的复位原因记录在 RCC->CSR 中;这些标志可能跨多次系统复位保留,直到软件写入 RMVF 清除,因此多个置位不等于多个故障同时发生。常用位如下:
| HAL 标志 | 寄存器位 | 含义 |
|---|---|---|
RCC_FLAG_IWDGRST |
IWDGRSTF |
独立看门狗超时 |
RCC_FLAG_WWDGRST |
WWDGRSTF |
窗口看门狗触发 |
RCC_FLAG_SFTRST |
SFTRSTF |
软件系统复位 |
RCC_FLAG_PORRST |
PORRSTF |
上电/掉电复位 |
RCC_FLAG_PINRST |
PINRSTF |
复位引脚相关标志 |
RCC_FLAG_BORRST |
BORRSTF |
欠压复位相关标志 |
在 main() 最开始、HAL_Init() 和板级初始化之前取得寄存器快照,再执行 __HAL_RCC_CLEAR_RESET_FLAGS()。不能先清标志再查询,也不要直接把若干标志写成互斥的 if...else;上电时 PORRSTF、BORRSTF 等可能一起置位。不同系列须按对应参考手册核对位定义,可参考 STM32F407 RM0090。

编写可验证的启动程序
实验使用 STM32F407、STM32CubeIDE 的 STM32CubeF4 HAL 工程,保持复位后默认 HSI 16 MHz 时钟。确保工程包含并启用 HAL UART、HAL IWDG 模块及对应驱动;IWDG 使用软件启动模式,不要在别处提前启动。将下方代码作为 Core/Src/main.c 的完整实验实现,连接 PA2(USART2_TX,AF7)到 3.3 V USB 转串口模块的 RX,两端 GND 共地,串口终端设为 115200、8N1。不要把 TTL 引脚直接接到 RS-232 电平接口。
#include "stm32f4xx_hal.h"
#include <stdio.h>
#define TEST_MODE 0U // 0=只记录;1=软件复位;2=IWDG超时
static UART_HandleTypeDef huart2;
static IWDG_HandleTypeDef hiwdg;
static volatile uint32_t boot_csr;
static void UART2_TX_Init(void)
{
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
__HAL_RCC_USART2_CLK_ENABLE();
gpio.Pin = GPIO_PIN_2;
gpio.Mode = GPIO_MODE_AF_PP;
gpio.Pull = GPIO_PULLUP;
gpio.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
gpio.Alternate = GPIO_AF7_USART2;
HAL_GPIO_Init(GPIOA, &gpio);
huart2.Instance = USART2;
huart2.Init.BaudRate = 115200;
huart2.Init.WordLength = UART_WORDLENGTH_8B;
huart2.Init.StopBits = UART_STOPBITS_1;
huart2.Init.Parity = UART_PARITY_NONE;
huart2.Init.Mode = UART_MODE_TX;
huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart2.Init.OverSampling = UART_OVERSAMPLING_16;
if (HAL_UART_Init(&huart2) != HAL_OK) {
while (1) {}
}
}
int main(void)
{
// 先取完整快照;清除后只能从boot_csr判断这一次的来源
boot_csr = RCC->CSR;
__HAL_RCC_CLEAR_RESET_FLAGS();
HAL_Init();
UART2_TX_Init();
char line[80];
int n = snprintf(line, sizeof(line),
"RESET IWDG=%d WWDG=%d SW=%d\r\n",
(boot_csr & RCC_CSR_IWDGRSTF) != 0U,
(boot_csr & RCC_CSR_WWDGRSTF) != 0U,
(boot_csr & RCC_CSR_SFTRSTF) != 0U);
if (n > 0 && n < (int)sizeof(line)) {
HAL_UART_Transmit(&huart2, (uint8_t *)line, (uint16_t)n, 100);
}
if (TEST_MODE == 1U &&
(boot_csr & RCC_CSR_SFTRSTF) == 0U) {
HAL_Delay(200);
NVIC_SystemReset();
}
if (TEST_MODE == 2U &&
(boot_csr & RCC_CSR_IWDGRSTF) == 0U) {
hiwdg.Instance = IWDG;
hiwdg.Init.Prescaler = IWDG_PRESCALER_256;
hiwdg.Init.Reload = 249;
if (HAL_IWDG_Init(&hiwdg) != HAL_OK) {
while (1) {}
}
// 故意不喂狗,超时后由硬件执行复位
while (1) { HAL_Delay(3000); }
}
while (1) { HAL_Delay(1000); }
}预期输出(将 TEST_MODE 改为 1、重新编译烧录,并从未设置软件复位标志的启动状态开始;以下为连续两次启动的关键日志):
RESET IWDG=0 WWDG=0 SW=0
RESET IWDG=0 WWDG=0 SW=1这里的串口输出发生在 UART 初始化之后,但判断使用的是初始化前的 boot_csr 快照。若需检查上电、引脚或欠压原因,可在调试器 Watch 视图查看 boot_csr 中的 RCC_CSR_PORRSTF、RCC_CSR_PINRSTF、RCC_CSR_BORRSTF。
分别制造两种复位并验收
- 将
TEST_MODE设为1并烧录,必要时重新上电以清除调试下载带来的既有软件复位状态。第一次启动记录SW=0,约 200 ms 后调用NVIC_SystemReset();第二次启动记录SW=1,程序不再反复复位。 - 将
TEST_MODE设为2并烧录。首次进入测试分支时调用HAL_IWDG_Init(),按约 32 kHz 的 LSI 估算,250 次计数乘以 256 分频,再除以每秒 32000 次计数,超时约为 2 秒。程序故意不调用HAL_IWDG_Refresh();硬件超时后重启。 - 串口应先看到
IWDG=0,随后看到IWDG=1。重启后的程序因检测到该标志,不会再次进入看门狗测试分支。将TEST_MODE恢复为0并烧录,退出故障注入状态。
看门狗实验的第二次启动预期输出:
RESET IWDG=1 WWDG=0 SW=0避免历史标志导致误判
先读后清是最低限度的判因规则。若删掉清除语句,先运行 IWDG 测试再执行软件复位,IWDGRSTF 与 SFTRSTF 可能同时为 1;此时不能断言最后一次复位由两个原因共同触发。正确做法是每次启动先读取快照,立即清除硬件历史标志,等串口就绪后再输出保存的快照。
若串口没有输出,先核对 PA2 是否连接转串口 RX、GND 是否共地、终端是否为 115200 8N1,以及工程是否仍使用预期的 16 MHz HSI;若启用了 PLL,须同步验证 UART 波特率计算。若 IWDG 一直是 0,则检查是否真的进入 TEST_MODE=2 分支、IWDG 是否被调试冻结以及芯片选项字节是否为软件启动。
实验程序仅适合独立测试。产品固件应在复位早期保留原始快照,并在清除标志前后按设计写入可靠的故障记录;若启用了硬件自动看门狗,还必须在初始化阶段及时喂狗,不能直接套用这份故意超时的代码。