窗口看门狗（Window Watchdog，WWDG）是STM32H743专为监控程序执行时序设计的硬件看门狗，核心作用是防止程序“跑飞”或陷入短周期死循环（比如主循环卡死但还能定时喂狗的场景）。与独立看门狗（IWDG）相比，WWDG对程序执行的“时效性”要求更高，是提升系统可靠性的重要补充。
独立看门狗喂狗不能过晚，窗口看门狗喂狗不能过早，也不能过晚。
| 特性 | 独立看门狗（IWDG） | 窗口看门狗（WWDG） |
|---|---|---|
| 时钟源 | 独立低速时钟（LSI） | 外设时钟（PCLK1） |
| 喂狗时间限制 | 溢出前任意时间 | 仅在 “窗口区间” 内有效 |
| 检测的异常类型 | 程序卡死、无响应 | 程序执行过快 / 过慢、跑飞但仍喂狗 |
| 复位触发条件 | 计数器溢出 | 喂狗过早 / 过晚、计数器溢出 |
独立看门狗是 “基础保镖”，核心防范程序完全停止运行的极端情况，依赖独立时钟，可靠性高；
窗口看门狗是 “精准保镖”，核心防范程序执行节奏异常（跑飞但仍能喂狗）的隐蔽问题，弥补了 IWDG 的检测盲区；
实际开发中，两者常配合使用：IWDG 保障程序 “活着”，WWDG 保障程序 “正常地活着”，大幅提升系统的稳定性和安全性。
一、STM32H743 WWDG 核心硬件特性
特性 | 说明 |
时钟源 | 依赖主系统时钟（PCLK1分频，PCLK1=HCLK/2，H743 PCLK1最大48MHz），分频后为1MHz（固定） |
核心机制 | 计数器从设定值递减，仅在“窗口时间内”喂狗有效： |
计数器范围 | 7位计数器（0x000x7F），但仅0x400x7F有效（0x3F及以下触发复位） |
窗口值配置 | 可设置0x40~0x7F之间的任意值，决定喂狗的“有效窗口” |
预分频器 | 可选1/2/4/8分频，调整计数器递减速度（即窗口时间长度） |
中断支持 | 计数器减到0x40时触发早期唤醒中断（EWI），可在中断中喂狗，避免复位 |
复位类型 | 触发内核复位（仅复位CPU及相关外设，非全局复位） |
关闭方式 | 可通过寄存器关闭（与IWDG“启动后不可关闭”不同） |
低功耗特性 | 主时钟停止时（如STOP模式），WWDG停止工作（需依赖IWDG监控低功耗场景） |
WWDG 与 IWDG 核心区别
维度 | 窗口看门狗（WWDG） | 独立看门狗（IWDG） |
时钟源 | 主系统时钟（PCLK1） | 独立LSI（32kHz） |
监控目标 | 程序执行时序（防止提前/过晚喂狗） | 程序整体运行（防止死机） |
喂狗规则 | 仅窗口内喂狗有效 | 任意时间喂狗（超时前） |
复位范围 | 内核复位 | 系统全局复位 |
关闭方式 | 可软件关闭 | 仅复位可关闭 |
低功耗支持 | 主时钟停则停 | 独立运行（支持低功耗） |
适用场景 | 监控程序执行流程（如主循环时序） | 监控系统整体可用性（如死机复位） |
核心概念
7位计数器（T[6:0]）：WWDG的核心计数器，范围0127（0x000x7F），从初始化值开始递减，速率由预分频器决定；
窗口值（W[6:0]）：喂狗的“有效阈值”，仅当计数器 ≤ 窗口值 且 ≥ 0x40 时，喂狗才有效；
早期唤醒中断（EWI）：计数器减到0x40时触发，用于重启前保存重要数据。
超时复位条件：
过晚喂狗：计数器减到0x3F及以下，未喂狗 → 复位；
过早喂狗：计数器 > 窗口值时喂狗 → 复位；
正常喂狗：窗口内喂狗 → 计数器重置为初始值，避免复位。
二、WWDG 核心计算公式
1. 计数器递减周期（T_cnt）
WWDG的时钟源经分频后固定为1MHz（PCLK1/4096），预分频器仅调整递减速度：
T_cnt（μs）= 预分频系数 × 1预分频系数对应值：
预分频配置值 | 预分频系数 | T_cnt |
WWDG_PRESCALER_1 | 1 | 1μs |
WWDG_PRESCALER_2 | 2 | 2μs |
WWDG_PRESCALER_4 | 4 | 4μs |
WWDG_PRESCALER_8 | 8 | 8μs |
2. 窗口时间计算
- 总超时时间（T_total）：计数器从初始值（如0x7F）减到0x3F的时间（过晚喂狗复位时间）：
T_total（μs）= (初始值 - 0x3F) × T_cnt- 有效窗口时间（T_window）：计数器从窗口值减到0x3F的时间（仅此时段可喂狗）：
T_window（μs）= (窗口值 - 0x3F) × T_cnt- 禁止喂狗时间（T_forbid）：计数器从初始值减到窗口值的时间（此时段喂狗→复位）：
T_forbid（μs）= (初始值 - 窗口值) × T_cnt示例计算
需求：设置WWDG初始值0x7F（127），窗口值0x5F（95），预分频系数8：
- T_cnt = 8×1 = 8μs；
- T_total = (127 - 63) ×8 = 512μs（总超时时间，过晚喂狗复位）；
- T_window = (95 - 63) ×8 = 256μs（有效喂狗窗口）；
- T_forbid = (127 - 95) ×8 = 256μs（前256μs喂狗→复位）；
→ 结论：仅在计数器递减256μs后（0x5F~0x40）喂狗才有效，早于或晚于都会复位。
三、STM32H743 WWDG 配置步骤（HAL库）
- 配置WWDG参数（预分频器、初始值、窗口值）；
- （可选）开启早期唤醒中断（EWI），配置NVIC；
- 启动WWDG；
关键HAL库API
函数 | 功能 |
HAL_WWDG_Init() | 初始化WWDG（配置预分频、初始值、窗口值） |
HAL_WWDG_Start() | 启动WWDG（Init已包含启动，可省略） |
HAL_WWDG_Refresh() | 喂狗（重置计数器为初始值，核心函数） |
HAL_WWDG_IRQHandler() | WWDG中断服务函数（处理EWI中断） |
HAL_WWDG_EarlyWakeupCallback() | EWI中断回调函数（计数器到0x40时触发） |
四、实战代码示例
示例1：基础WWDG使用（窗口内喂狗）
#include "stm32h7xx_hal.h" /* WWDG句柄 */ WWDG_HandleTypeDef hwwdg; /* 错误处理函数 */ void Error_Handler(void) { while(1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // LED快速闪烁表示复位/错误 HAL_Delay(100); } } /** * @brief 初始化WWDG：预分频8，初始值0x7F，窗口值0x5F * 计算：T_cnt=8μs，T_forbid=256μs，T_window=256μs，T_total=512μs */ void MX_WWDG_Init(void) { hwwdg.Instance = WWDG; hwwdg.Init.Prescaler = WWDG_PRESCALER_8; // 预分频8 hwwdg.Init.Window = 0x5F; // 窗口值95 hwwdg.Init.Counter = 0x7F; // 初始计数器值127 hwwdg.Init.EWIMode = WWDG_EWI_DISABLE; // 先关闭早期唤醒中断 if (HAL_WWDG_Init(&hwwdg) != HAL_OK) { Error_Handler(); } } /** * @brief WWDG喂狗函数 */ void WWDG_Feed_Dog(void) { // 喂狗：重置计数器为初始值0x7F if(HAL_WWDG_Refresh(&hwwdg) != HAL_OK) { Error_Handler(); } } int main(void) { /* 1. 初始化HAL库、系统时钟、GPIO（LED）、WWDG */ HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); // PA5为推挽输出（LED） MX_WWDG_Init(); // 启动WWDG /* 2. 主循环：在有效窗口内喂狗 */ while (1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // LED慢闪表示正常 HAL_Delay(300); // 延时300μs（大于T_forbid=256μs，进入有效窗口） WWDG_Feed_Dog(); // 窗口内喂狗，正常重置计数器 // 测试1：延时改为200μs（<256μs，过早喂狗→复位） // HAL_Delay(200); // 测试2：延时改为600μs（>512μs，过晚喂狗→复位） // HAL_Delay(600); } }示例2：开启早期唤醒中断（EWI）—— 最后机会喂狗
适合需要“紧急处理+喂狗”的场景，计数器到0x40时触发中断，在中断中喂狗：
/* 步骤1：修改初始化函数，开启EWI中断 */ void MX_WWDG_Init_EWI(void) { hwwdg.Instance = WWDG; hwwdg.Init.Prescaler = WWDG_PRESCALER_8; hwwdg.Init.Window = 0x5F; hwwdg.Init.Counter = 0x7F; hwwdg.Init.EWIMode = WWDG_EWI_ENABLE; // 开启早期唤醒中断 if (HAL_WWDG_Init(&hwwdg) != HAL_OK) { Error_Handler(); } // 配置NVIC（WWDG中断优先级） HAL_NVIC_SetPriority(WWDG_IRQn, 0, 0); HAL_NVIC_EnableIRQ(WWDG_IRQn); } /* 步骤2：实现WWDG中断服务函数（stm32h7xx_it.c） */ void WWDG_IRQHandler(void) { HAL_WWDG_IRQHandler(&hwwdg); } /* 步骤3：实现EWI中断回调函数（最后一次喂狗机会） */ void HAL_WWDG_EarlyWakeupCallback(WWDG_HandleTypeDef *hwwdg) { if(hwwdg->Instance == WWDG) { // 触发EWI中断（计数器到0x40），紧急喂狗 WWDG_Feed_Dog(); HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // LED闪一下，表示触发中断 } } // 主函数中调用 int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_WWDG_Init_EWI(); // 开启EWI的WWDG while (1) { // 故意不主动喂狗，依赖EWI中断喂狗 HAL_Delay(1); } }示例3：判断复位原因（是否由WWDG触发）
调试时需区分复位类型，通过RCC寄存器判断：
/** * @brief 判断复位原因 * @retval 0:上电复位 1:IWDG复位 2:WWDG复位 3:其他复位 */ uint8_t Get_Reset_Reason(void) { uint8_t reason = 0; // 检查复位标志位 if(__HAL_RCC_GET_FLAG(RCC_FLAG_PORRST) != RESET) { reason = 0; // 上电复位 } else if(__HAL_RCC_GET_FLAG(RCC_FLAG_IWDGRST) != RESET) { reason = 1; // IWDG复位 } else if(__HAL_RCC_GET_FLAG(RCC_FLAG_WWDGRST) != RESET) { reason = 2; // WWDG复位 } else { reason = 3; // 手动复位/软件复位等 } // 清除复位标志位 __HAL_RCC_CLEAR_RESET_FLAGS(); return reason; } // 主函数中添加复位提示 int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); // 判断复位原因 uint8_t reset_reason = Get_Reset_Reason(); if(reset_reason == 2) { // WWDG复位：LED常亮2秒 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET); HAL_Delay(2000); } MX_WWDG_Init(); while (1) { HAL_Delay(300); WWDG_Feed_Dog(); HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); } }五、常见问题与避坑指南
1. WWDG不触发复位
- 原因1：喂狗时机刚好在窗口内：计数器始终在有效窗口内被重置，未触发复位（正常现象）；
- 原因2：预分频/窗口值计算错误：有效窗口时间远大于测试延时（如窗口256μs，测试延时100μs，未进入窗口）；
- 原因3：WWDG未真正启动：HAL_WWDG_Init()内部会自动启动，但手动修改寄存器可能导致启动失败；
- 原因4：主时钟配置错误：PCLK1未使能或频率为0，WWDG时钟停止，计数器不递减。
2. 过早喂狗却不复位
- 误区：误以为“计数器>窗口值时喂狗一定复位”，但WWDG有“喂狗保护”：仅当喂狗时计数器>窗口值，且WWDG已启动，才会触发复位；
- 排查技巧：用示波器测CPU复位引脚，或通过复位原因函数确认是否为WWDG复位（避免误判）。
3. EWI中断不触发
- 原因1：未配置NVIC：未使能WWDG_IRQn或优先级配置错误；
- 原因2：EWI模式未开启：hwwdg.Init.EWIMode未设为WWDG_EWI_ENABLE；
- 原因3：计数器未到0x40：喂狗过于频繁，计数器从未递减到0x40。
4. 低功耗模式下WWDG失效
- 原理：WWDG依赖PCLK1，进入STOP模式后主时钟停止，WWDG也停止工作；
- 解决：低功耗场景需搭配IWDG（独立时钟），WWDG仅监控正常运行模式。
5. 喂狗函数调用失败
- 原因：喂狗时计数器已<0x40（过晚喂狗），WWDG已触发复位，喂狗操作无效；
- 解决：提前喂狗，或在EWI中断中紧急喂狗。
6. 混淆WWDG与IWDG的复位范围
- 新手误区：认为WWDG复位会重启整个芯片，实际仅复位内核（部分外设可能仍运行）；
- 验证方法：复位后检查外设状态（如UART配置是否保留），确认复位范围。
六、调试步骤
1. 入门步骤
- 第一步：实现基础WWDG配置，计算并验证有效窗口时间，手动测试“过早/过晚喂狗”触发复位；
- 第二步：开启EWI中断，观察“最后一次喂狗机会”的触发时机；
- 第三步：添加复位原因判断，区分WWDG/IWDG/上电复位；
- 第四步：对比IWDG使用，理解两者的互补场景。
2. 调试技巧
- LED状态区分：
- 正常运行：LED慢闪（如300ms一次）；
- WWDG复位：LED快闪2秒后恢复慢闪；
- EWI中断触发：LED单次短闪（提示紧急喂狗）；
- 串口打印调试：在EWI中断中打印“WWDG EWI Interrupt!”，确认中断触发；
- 寄存器查看：调试时查看WWDG->CR（计数器）、WWDG->CFR（窗口值），确认参数配置正确。
3. 实际应用注意事项
- 窗口值选择：
- 有效窗口时间需覆盖程序“正常执行到喂狗”的时间（如主循环执行时间200300μs，窗口设为256512μs）；
- 禁止喂狗时间需大于程序“异常短周期执行”的时间（防止死循环误喂狗）；
- 喂狗位置：
- 放在主循环末尾，确保所有业务逻辑执行完才喂狗；
- 避免在中断中喂狗（防止中断正常但主循环卡死）；
- 双看门狗搭配：
- WWDG：监控程序执行时序（防止提前喂狗）；
- IWDG：监控程序整体运行（防止死机）；
→ 两者结合，覆盖更多异常场景。
4. 进阶练习
- 模拟程序短周期死循环：主循环执行时间<禁止喂狗时间，测试WWDG是否复位；
- 结合定时器：用TIM定时喂狗，故意调整定时时间，验证窗口机制；
- 动态调整窗口值：根据程序运行状态（如高负载/低负载），动态修改WWDG窗口值。
