Files
STM32F4-Base/App/util
wandering1 029437be89 台架执行《实机测试实施指南》步骤 3~7 并闭环
步骤 3/4(IWDG V2/V4/V5 + 堆低水位 S11):
- V2 任务饿死 stall 后 ≤2.5s IWDG 复位;V4 关中断死循环 ~4.9s 稳定复位;
  V5 30min 120×FTP 全 PASS、零 IWDG 复位。堆告警全程未触发(min_ever=4728B)。
- task_watchdog.c:stall 证据写盘会经 nand_ftl_wd_feed 喂狗 → 增 s_stall_evidenced
  每次 stall 仅取一次证据,避免"取证据"本身阻止复位。
- default_task.c:堆低水位告警(HEAP_LOW_WATER_B=3072)。

步骤 5(GD5F 错误通道 S9):gd5f2gq5ue.c/.h + nand_ftl.c 错误码统一为 int32_t 并
全量检查返回值;套件回归 16/16 PASSED。
- test/run_all_suites.py:--forbidden 改为按套件覆盖(GD5F 用 "HardFault;assert")——
  TC-GD5F-704 故意触发 [ERR] 回落轮询,统一默认值会误判 FAIL。

步骤 6(网络稳定性):7.1 正常路径 ✅(V5 证据);7.2 N-2 丢弃可观测性代码已具备、
49s 静默在 V5 未复现(降级低风险观察项);7.3 N-3 待 PC peer。

步骤 7(工程卫生):
- S5:新增 test-cppcheck 钩子(仅 warning,排除模拟器桩)。
- S4:新增 scripts/check_test_traceability.py(默认仅告警)。
- 待核实项 TEST_SUITE_SELECTED 实机核实 = 死代码(无使用点);RTC 套件实际正常执行,
  真缺口 = 缺套件级汇总行 → sd2506_test_task.c 补 === RTC Tests: N/M PASSED === 并
  修正 Phase 级汇总累计问题;test_config.h 补齐 RTC 并注释"当前无引用"。

验证:产品 @build 0/0;pre-commit --all-files 17/17 Passed;
run_all_suites.py --suites RTC → PASS。
文档:实机测试实施指南 / SD2506_Test_Guide / 待处理内容 / 测试与架构改进建议 同步。
2026-10-04 00:35:06 +08:00
..

App/util/ — 通用工具函数

平台无关的纯工具模块(无 FreeRTOS 依赖、无硬件依赖),可在 MCU 与 PC 模拟器中共用。

文件一览

文件 作用
sys_clock.c/h 墙钟时间管理:RTC 基准、tick 回绕防护、每 30 天惰性再基准化
task_watchdog.c/h 独立看门狗(IWDG)判定状态机:任务心跳位图 + defaultTask 单一喂狗者

已删除(2026-10-02):crc.c/h(CRC-16 Modbus / CRC-8)与 ringbuf.c/h(SPSC 环形缓冲) 两模块零调用者且未编入任何构建——CRC 唯一使用点 net_cfg_legacy.c 自带静态 s_crc16_modbus(),环形缓冲由 App/log/console_log.c 内联实现(s_con_ring)。 保留只会造成"有统一实现"的误导,故整体移除(详见 docs/待处理内容.md E-15 销项)。

设计要点

sys_clock

  • 以 SD2506 RTC 为基准,HAL tick 计数补齐亚秒精度
  • 49.7 天 tick 回绕防护:每 30 天惰性再基准化(sys_clock_get 内部触发)
  • RTC 故障时降级到默认时间基准并返回 -1,触发"时钟芯片异常"自检上报
  • 设计详见 docs/子系统设计/系统墙钟时间维护说明.md

task_watchdog

  • 任务心跳位图:各任务只置位(task_wd_beat),校验者取走并清零(单字原子,无锁)
  • 单一喂狗者:defaultTask 每 100 ms 抽样判定,仅当位图等于必需掩码时才喂狗
  • 硬件访问收敛:IWDG 寄存器与 HAL_GetTick() 经 wd_platform_* 弱钩子访问 (声明在 task_watchdog.h 末段),MCU 端为 __weak 默认实现,主机侧单测以同名强符号覆盖 → 可在 PC 上跑纯逻辑回归
  • 设计详见 docs/子系统设计/看门狗设计说明.md;单测见 docs/测试说明/看门狗单元测试说明.md

相关文档

  • docs/子系统设计/系统墙钟时间维护说明.md
  • docs/子系统设计/看门狗设计说明.md
  • docs/测试说明/看门狗单元测试说明.md