506eccc68f
本次会话先后销项与关闭: - E-61 SD2506 清 INTAF:原实现只读取 CTR1,而按手册 ARST=0 时读操作 不清标志,属空操作;改为读-改-写 CTR1,并按手册订正 CTR1 位宏 (INTAF/INTDF/BLF 位置,ARST 归 CTR3) - E-16 cfg_file:新增 CFG_FILE_MAX_NAME_LEN(段名/键名 ≤15),注册时 拒绝超长键名;s_gen_document 两处 snprintf 改检查式;补 TC-CFG-024 用例(主机单测 149→151 PASSED) - E-23 TC704:PHASE7_MULTI_COUNT 8→5(并发上限 = 8 − 3 个常驻监听), accept 失败分支加网络代次检查(网络重建即重建监听) - E-26(UDP)按“保留 API + 文档定案”关闭;E-30 评估为不必要后关闭; N-4(ACCEPT 决定不实施)关闭 审计文档剩余 5 项 P2 + 2 项监督,经用户裁定“都不重要”后整体删除: - 删除 docs/问题记录/错误码传播审计.md(634 行) - 九类缺陷模式表迁入 docs/编号规范.md §4.2.1(PAT-01~09) - E-xx 转为纯历史编号族:编号规范 §4.1 属主改“无(原属主已删除)”, §4.3 保持冻结;全仓 26 处引用按“保留编号、去悬空文档名”处理 - 顺带修正 N-4 收口遗留:排期详述 C1 才是 E-25/E-27/E-28 的承载处 (审计 §4 曾误写为登记簿);README 两处 C1 旧名改回“net 层跨上下文收口” 一并提交此前遗留的体系层评审报告 2026-10-14 复核 WIP(六维评分复核、 未闭环 Top 5→3、三区水位实测刷新)。 校验:Keil 构建 0 错误 0 警告(Code=212344);check_doc_links --sections-strict 与 --all(142 文档)通过;内存双台账刷新后均 PASS。
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(旧档/cfg/netcfg.bin迁移,该文件亦已于 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内部触发) - 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