Files
STM32F4-Base/App/sync
wandering1 d770e36c7c refactor(NET): 源码注释去阶段化 + 网络两份文档重构 + 不稳根因图更新
- 源码注释:删去自愈收敛阶段
1/1.5/3等 scaffolding 称谓,改为语义引用
  (E-02 收口 / F-NET-2/3/4 / docs/网络/网络自愈架构设计.md §5.2 E13);
  涉及 net_socket/.h、net_events、net_listener、net_pending、net_types、
  net_config、ch395f、time_sync、iec104_serv、ui_net_sink、lftpd、
  simulator/sim/net_socket_sim、board/host 测试与探针
- 文档重构:网络自愈架构设计.md 与 Net层阻塞模型架构设计.md 改为现状口径
  (删历史节与阶段叙事),NET/README.md、docs/README.md 同步
- 工具与配图:gen_net_instability_svg.py 与
  docs/images/网络不稳根因总览.svg 随源码口径一并更新
- 门禁:@build 0 错误 0 警告
2026-10-14 22:05:53 +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 — 就绪屏障