wandering1
2d16fdddc0
道F task-23。动因 = 2026-10-25 台架大窗判读：9 条 stall 行里 16:24/16:28 两起为 复合判据误升级——旧逻辑喂狗前置 = 全必需位同窗跑过，任一窗缺任一位即断喂， 复合连续 8 窗申报 stall；UI 一窗缺、IEC104 下一窗缺、再下窗 FTP 缺这类互不相干 的亚秒抖动被串成 800ms 假停摆（mg=877/918，两事件中无任何任务达单任务容忍线）。 16:39 那起才是真 UI 单任务串（~1.2s，bit4 到 8 连击——受害者面修复 = F3 票）。 【改造】stall/停喂唯一判据 = 任一必需位自己的连续缺席窗数（s_miss_bits[] 分账， +9B BSS）：同一任务 8 窗（800ms）没跑过 → 申报 + 停喂 → IWDG 自然溢出 （IWDGRSTF 权威归因不变）；所有位连击 <8 的缺席窗照常喂狗；位出现即该位清零， 掩码外位不入账（wd_required_mask 随构建变化自动跟随、不留旧账）。`MISS start` 保留为复合边沿诊断行（不再代表停喂，判读口径以设计说明 §6.1/§11.1 为准）。 代价：真停摆从挂死到复位总时长最坏 +约 0.7s（≈2.5s 最坏 / ≈3.3s 标称），V2 台架判据「声明 stall 后 ≤2.5s 复位」不受影响（申报时点未变，停喂起点即申报）。 【测试】test/host/watchdog 断言按新判据改写 5 处（004/005/006/008/013：缺席窗 照常喂），新增 TC-WATCHDOG-017（20 窗 UI/NET 交替缺席：零 stall + 20 窗持续喂—— 旧复合判据必在第 8 窗误报，回归钉）与 TC-WATCHDOG-018（同位 8/9/10 连击必报停 + 停喂；恢复窗喂、账本重启，第二段亚容忍串重新从零计）。47/47 全绿。 【文档】看门狗设计说明 §0/§2.2（停喂链加「v1.5 起字面成立」注）/§3.2/§5.3/ §6.1/§11.1/§11.6 大窗补记 + 变更记录；看门狗单元测试说明（用例表 + 47 断言 + 变更记录，顺带修正 TC-WATCHDOG-003 行 10-12 后未跟的 `0x37`→`0x1F7`）。 【越界申报】① docs/测试说明/看门狗单元测试说明.md——票面写域外，但该文档 §4 自要求「行为变更须同步改单测与本文」，执行性同步；② 根目录 .cubemx_survival_baseline.json——cubemx-survival 钩子对 task_watchdog.c（watchdog- module 审计项 = 全文哈希基线）明示「有意改动请 --write 重建基线」，重建后 31 通过 / 0 失败。均非他人并行改动面。 【门禁】@build 0 错误 0 警告（Code=224768 RO=24640 RW=1328 ZI=135096）。 --all-files 43 绿；红仅 mem-numbers/mem-budget = 台账漂移（vs 2026-10-25 行： Code +80B / ER_IROM1 249328→249408 / ZI +8B（s_miss_bits）/ IRAM1 约 +8B，待回填）。 id-check 增量拦截通过（首跑拦下变更记录里 TC-003/TC-004 裸形，已改全 ID）、 test-coverage 通过、cubemx-survival 通过。 gate: only mem-budget/mem-numbers pending lead ledger backfill 【台架】等你排窗两轮（各 ≥30min）：单独 relisten_stress :7003 / 探针轮。判据按 v1.1 口径 = stall 行零为硬判据；预期本修复后 16:24/16:28 型复合误升级归零， MISS start 仍会出现（诊断量）；16:39 型 UI 真单串在 F3 落地前仍可能照报—— 那属于「判据抓对了人」，请连同 mask 一起记给我。
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