wandering1
a12367981d
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 失败。
82 lines
3.3 KiB
Python
82 lines
3.3 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""
|
||
本地时间同步服务（PC -> MCU 板子）
|
||
|
||
功能：
|
||
周期性把本机（PC）的本地时间，通过 TCP 推送到 STM32 板子。
|
||
板子端在 timeSyncTask 中以 TCP Server 方式监听端口，收到后调用
|
||
sys_clock_set_unix() 更新系统墙钟并写回 SD2506 RTC，使板子时间 == 你电脑的时间。
|
||
|
||
协议（板子端实现见 App/sync/time_sync.c 的 time_sync_handle_conn）：
|
||
字节 0..3 : 魔术字 "TIME" (0x54 0x49 0x4D 0x45)
|
||
字节 4..7 : 本地 Unix 时间戳，uint32，大端（主机字节序转换后由板子分解）
|
||
|
||
用法：
|
||
python time_sync_server.py # 默认推送到 192.168.1.100:8888
|
||
python time_sync_server.py 192.168.1.100 # 指定板子 IP
|
||
python time_sync_server.py 192.168.1.100 9000 3 # 指定端口与间隔(秒)
|
||
|
||
按 Ctrl+C 停止。
|
||
"""
|
||
|
||
import socket
|
||
import struct
|
||
import sys
|
||
import time
|
||
import calendar
|
||
|
||
DEFAULT_MCU_IP = "192.168.1.100"
|
||
DEFAULT_PORT = 8888
|
||
DEFAULT_INTERVAL = 5.0
|
||
|
||
|
||
def main():
|
||
mcu_ip = sys.argv[1] if len(sys.argv) > 1 else DEFAULT_MCU_IP
|
||
port = int(sys.argv[2]) if len(sys.argv) > 2 else DEFAULT_PORT
|
||
interval = float(sys.argv[3]) if len(sys.argv) > 3 else DEFAULT_INTERVAL
|
||
|
||
print("[time_sync] 本地时间推送服务已启动（TCP 客户端）")
|
||
print(f" 目标板子 : {mcu_ip}:{port}")
|
||
print(f" 推送间隔 : {interval}s")
|
||
print(f" 协议帧 : 'TIME' + uint32(BE) 本地 Unix 时间戳")
|
||
print("[time_sync] 按 Ctrl+C 停止")
|
||
print("-" * 48)
|
||
|
||
while True:
|
||
try:
|
||
# 本地 wall-clock 当作 UTC 算出的 epoch（与电脑显示一致）。
|
||
# 注意：板子 RTC 存本地时间且 unix_to_sd2506 无时区处理，
|
||
# 故必须发"本地墙钟当 UTC"的伪 epoch（calendar.timegm），
|
||
# 不能用 time.mktime（返回真正 UTC epoch，会导致板子慢 8 小时）。
|
||
local_epoch = int(calendar.timegm(time.localtime()))
|
||
pkt = b"TIME" + struct.pack(">I", local_epoch)
|
||
|
||
with socket.create_connection((mcu_ip, port), timeout=5) as sock:
|
||
sock.sendall(pkt)
|
||
# 关键：发送后保持连接打开，给板子留出读完 8 字节的窗口。
|
||
# 若立即 close，CH395F 收到 FIN 会丢弃接收缓冲里尚未被板子读出的
|
||
# 8 字节时间包，导致板子 net_recv 看到 CLOSED 而无数据、时间同步失败。
|
||
# 自愈收敛阶段1-5 起板子会话收尾**不再 close**（单连接监听跨会话常驻，
|
||
# EOF 时 net_close 会连监听一起毁掉）——这里 recv 等 2s 宽限后由
|
||
# 本端关闭；板子 net 层 auto_relisten 随即恢复监听，下一轮照常连接。
|
||
sock.settimeout(2.0)
|
||
try:
|
||
sock.recv(64)
|
||
except (socket.timeout, OSError):
|
||
pass
|
||
|
||
now_str = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
|
||
print(f"[{time.strftime('%H:%M:%S')}] -> {now_str} (epoch={local_epoch})")
|
||
except OSError as e:
|
||
print(f"[{time.strftime('%H:%M:%S')}] 连接/发送失败: {e}")
|
||
|
||
time.sleep(interval)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
try:
|
||
main()
|
||
except KeyboardInterrupt:
|
||
print("\n[time_sync] 已停止")
|