Files
STM32F4-Base/App/sync
wandering1 506eccc68f docs: 错误码传播审计收口并删除该文档(E-xx 转历史编号族)
本次会话先后销项与关闭:
- 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。
2026-10-15 07:39:38 +08:00
..

App/sync/ — 时间同步

墙钟时间与外部时间源的同步(timeSyncTask)。墙钟本身由 ../util/sys_clock.c 维护, 本目录负责从时间源拉取/接收时间并校准。

文件一览

文件 作用
time_sync.c/h 时间同步任务:等待网络就绪 → 与时间源交互 → 校准墙钟

工作流

timeSyncTask 启动
   ↓ osEventFlagsWait(SYS_EVT_NET_READY, ...|osFlagsNoClear)   // 状态位不可消费!
time_sync 主循环 → 与时间源通信 → sys_clock 校准
   ↓
置 SYS_EVT_TIMESYNC_READY

⚠️ 等待就绪位(SYS_EVT_NET_READY)必须 osFlagsNoClear——它是状态位, 用默认消费型等待会把它清掉,导致后续消费者(如 ftpTask)永远等不到。

相关文档

  • docs/子系统设计/系统墙钟时间维护说明.md — 墙钟基准 / tick 回绕防护
  • test/host/time_sync_server.py — PC 端对时推送服务(测试用)
  • docs/架构设计/项目启动顺序管理.md — 就绪屏障