wandering1
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。
40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# 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/子系统设计/系统墙钟时间维护说明.md`
|
||
- `docs/子系统设计/看门狗设计说明.md`
|
||
- `docs/测试说明/看门狗单元测试说明.md`
|