Files
STM32F4-Base/App/sync
wandering1 a12367981d fix(N34): E14 丢中断复核——芯片不丢事件;listen 排事件挪至 LISTEN 前+全局读收口+全库归因更正
48 轮直读 SINT 矩阵(8 周期×6 变体)复核历史"丢中断"说法:芯片侧事件
丢失 = 0。归类:drain 读清消费 3/48(drain-int 探针现场抓获)、门控
竞态 2/48、主机同步 1/48、幽灵态 0/48 未复现。

根除性修复:net_listen_locked / net_listener_try 的排事件读清从
listen 后挪至 LISTEN 命令之前——新连接 CONNECT 落进该窗即被本方读清
吞掉,即"数据被吞"的生产侧自伤机制(台架 3/48 为同形态放大版)。

全局读收口:全局中断寄存器唯一读者 = net_poll(I7);生产/测试/台架
游离全局读全部删除,ch395f.h 声明处加护栏注释。

归因更正:17 文件约 40 处"丢中断"措辞改为"事件未收到/读清消费竞态"
(机制全部保留,仅归因更正);设计文档 §5.2 新增 E14 锚点;Trap
Records TRAP-NET-17/-20/B3 归因更正段;配图生成器与 SVG 重生成。

台架:事件未收到复核探针保留(drain-int / SINT 补读×3 / 超时归类),
下次跑矩阵自动归类;实验注册(main.c/uvprojx)已完全还原。

验证:@build 0 错误 0 警告;ci_local L0 32/0 + gitlint + L0.5
953/953;doc-links --all --sections-strict 通过;@test PASS(无
[ERR],net init 619ms);回归 :7003 300ms×10 = 10/10、:21 n30×50 =
0/50 失败。
2026-10-14 02:48:50 +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 — 就绪屏障