a90de6b75e
coding-standard 钩子在 App/util/ioboard_di.c 报 4 处 CODE-RULE-09(5.3 函数注释
缺「函数功能」):di_is_null、ioboard_di_ch_reset、ioboard_di_snap_reset、
ioboard_di_snap_copy。该文件自 fd767d1d 引入起就缺这几段,与本次合并无关。
只补注释、零行为改动(+38/-2,全部为注释行):函数签名、函数体、空行结构未动。
事实来源全部取现有代码与 ioboard_di.h 的同名声明,没有新增说法。
顺带给 ioboard_di_snap_copy 写清它与 snap_read 的差别:本函数不做双侧 seq 校验,
可能拷到写者写一半的状态,只供诊断场景用;要一致值必须走 snap_read。
此前头文件只有一句「不保证一致性」,实现里没有任何说明。
实测:check_coding_standard.py 单文件 0 违规、全仓 0 违规;
test/host/ioboard 131/131 PASSED;Keil 0 Error(s) 0 Warning(s),
Program Size Code=365924 与改前逐项相同(Code 不变,符合纯注释改动)。
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(旧档迁移,该文件亦已于 2026-10-10 删除)自带静态s_crc16_modbus(), 从不调用本模块;环形缓冲由App/log/console_log.c内联实现(s_con_ring)。 保留只会造成"有统一实现"的误导,故整体移除。
设计要点
sys_clock
- 以 SD2506 RTC 为基准,HAL tick 计数补齐亚秒精度
- 49.7 天 tick 回绕防护:每 30 天惰性再基准化(
sys_clock_get内部触发) - 64 位单调毫秒:
sys_clock_mono_ms()把 32 位HAL_GetTick()扩成跨0xFFFFFFFF不回退的 64 位单调时钟,临界区保护、任意任务上下文可调(禁 ISR),无网络层依赖;自 2026-11-18 起取代 net 栈上的旧net_mono_now_ms - 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/子系统设计/系统墙钟时间维护说明.mddocs/子系统设计/看门狗设计说明.mddocs/测试说明/单元测试/看门狗单元测试说明.md