看门狗判定状态机增加主机侧单元测试(L0.5 层)
为 task_watchdog.c 的判定逻辑(位图取走清零 / 必需掩码 0x37 判定 / miss_streak 连续 8 次停喂 / 100ms 抽样节流 / tick 回绕安全)补一层 主机侧纯逻辑单元测试,弥补此前只能靠真机或模拟器才能发现回归的空白。 架构(沿用项目既有"共享核心 + 平台后端"做法,参照 cfg_file_store): - task_watchdog.h 末段新增"平台后端(内部)"声明 3 个钩子 (wd_platform_feed / _start / _tick_ms),MCU 端以 __weak 提供默认实现, 行为与重构前逐字一致(@build 0 错误 0 警告,Flash +20B)。 - 主机侧单测以同名强符号覆盖三钩子,即可离线注入/观测,无需碰 MCU 代码。 - 测试文件 #include 生产源文件本身,保证测的是真代码而非副本。 - 测试专用复位 task_wd_test_reset() 仅 TASK_WATCHDOG_UNIT_TEST 下编入, MCU 构建零代码零符号。 测试(test/host/watchdog/,MSVC 离线编译,纯标准库驱动): - 39 项断言全过(退出码 0);注入故障可复现退出码 1。 - run_unit_test.py 直接拼 INCLUDE/LIB 调 cl.exe,绕开本机被禁的 reg.exe。 - stub/ 三桩头覆盖 main.h / iwdg.h / dbg_log.h。 门禁:pre-commit 新增 watchdog-unit-test 本地钩子(L0.5 层),仅被测文件 或其测试变动时触发;测试开发标准流程.md 新增 L0.5 层说明。 顺带改善:task_watchdog.c 的节流基线 s_last_tick 由函数内 static 提为文件 static(可测性 + 模块状态归一)。
This commit is contained in:
@@ -69,6 +69,55 @@ uint32_t task_wd_last_mask(void); /* 上次抽样到的位图(0 位 = 缺
|
||||
uint32_t task_wd_miss_count(void); /* 累计未达标轮数 */
|
||||
uint32_t task_wd_is_armed(void); /* 1 = IWDG 已启动 */
|
||||
|
||||
/*
|
||||
* ============================ 平台后端(内部) ============================
|
||||
* 把判定状态机中的硬件访问收敛到三个薄钩子,使"取走清零 / 掩码判定 / 缺失
|
||||
* 累计 / 节流"成为纯逻辑,可在主机侧用桩替换后离线穷举验证
|
||||
* (见 test/host/watchdog/ 与 docs/测试说明/看门狗单元测试说明.md)。
|
||||
*
|
||||
* 与 App/cfg/cfg_file_store.h 的"共享核心 + 平台后端"同款做法:
|
||||
* - 三者由 task_watchdog.c 以 __weak 提供 MCU 默认实现(读写 IWDG 寄存器 /
|
||||
* 调 HAL_GetTick),**行为与不抽钩子时逐字一致**;
|
||||
* - 主机侧单测提供同名**强符号**覆盖 → 不碰 MCU 代码即可观测/注入;
|
||||
* - MCU 构建零行为变化。
|
||||
*
|
||||
* ⚠ 非模块对外接口,业务代码**不要**直接调用(由 task_wd_* 间接使用)。
|
||||
* ========================================================================
|
||||
*/
|
||||
|
||||
/*
|
||||
* 函数功能:重装 IWDG 计数器(喂狗)
|
||||
* 返回值:无
|
||||
* 函数说明:MCU 默认实现 = `IWDG->KR = 0x0000AAAAu;`
|
||||
* 主机侧单测覆盖此符号以记录"何时被喂"。
|
||||
*/
|
||||
void wd_platform_feed(void);
|
||||
|
||||
/*
|
||||
* 函数功能:启动 IWDG(不可逆,启动后只能靠复位停止)
|
||||
* 返回值:无
|
||||
* 函数说明:MCU 默认实现 = `IWDG->KR = 0x0000CCCCu;`
|
||||
*/
|
||||
void wd_platform_start(void);
|
||||
|
||||
/*
|
||||
* 函数功能:读单调毫秒时基(用于 100ms 抽样节流)
|
||||
* 返回值:自启动以来的毫秒计数(32 位回绕安全,用无符号差比较)
|
||||
* 函数说明:MCU 默认实现 = `HAL_GetTick()`
|
||||
* 主机侧单测覆盖此符号以驱动时间推进。
|
||||
*/
|
||||
uint32_t wd_platform_tick_ms(void);
|
||||
|
||||
/*
|
||||
* 函数功能:复位判定状态机(**仅主机侧单元测试使用**)
|
||||
* 返回值:无
|
||||
* 函数说明:仅当定义 TASK_WATCHDOG_UNIT_TEST 时编入(MCU 构建无此符号)。
|
||||
* 用于在用例之间清空位图/计数/节流基线,保证用例互不污染。
|
||||
*/
|
||||
#ifdef TASK_WATCHDOG_UNIT_TEST
|
||||
void task_wd_test_reset(void);
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user