边缘 AI 时间同步（NTP / PTP）与事件时间戳可执行手册

调研日期：约 2026-10-25（Asia/Shanghai）
定位：站内边缘 AI 网关、多路相机、MCU 传感、MQTT 事件与 录波 / SOE / 104 的时钟对齐；保证 Schema 字段 ts 可信、可追溯。
上游衔接：edge-ai-event-schema-acceptance.md、edge-ai-mqtt-hardening-offline-buffer.md、edge-ai-substation-gateway-bom.md、edge-ai-mcu-tinyml-sensing-cookbook.md、edge-ai-multistream-rtsp-scheduling.md、edge-ai-d60-d90-acceptance-checklist.md。
工具以 chrony、linuxptp（ptp4l / phc2sys / timemaster） 公开文档为准；站端 GPS/北斗接收机与调度时钟型号 unknown（以运维现网为准）。不确定处标 unknown。

0. 一句话结论

边缘 AI 必须有站内可追溯时钟：最低 NTP/SNTP（chrony） 对站控/管理网 NTP；有条件上 PTP（IEEE 1588，ptp4l）+ GPS/北斗。事件 Schema 的 ts 建议 UTC（带 Z）或带显式偏移，并可选上报 clock_quality。时钟跳变、断 NTP 要告警；禁止把未同步、大幅跳变后的事件当金标准对标 SOE。中国大陆 无夏令时，禁止本地脚本按 DST 改钟。

1. 为何要对时（硬动机）

红线

2. 方案分层（选型与落地）

2.1 分层总表

2.2 主机：chrony 最低配置要点

• 安装：chrony（Debian/Ubuntu 常见包名）；禁用与 systemd-timesyncd 双跑（二选一，默认 chrony）。
• 指站内 NTP：server <站控NTP> iburst；可选公网仅作 运维备路（生产站内常禁外网）。
• 常用核验：chronyc tracking（参考源、Last offset、RMS offset、Leap status）；chronyc sources -v。
• 硬件时间戳：ethtool -T ethX 确认 HW TX/RX；chrony hwtimestamp 勿与同口 ptp4l 抢 PHC（冲突时分口或走 timemaster）。
• 步进 vs 渐变：大偏差时 chrony 可 step；生产建议配置 告警阈值（见 §4），避免静默大跳。

2.3 PTP：ptp4l / phc2sys / timemaster

站端注意：

1. 域号 / Profile 跟运维现网（电力站常见专用 profile，具体编码 unknown，以站钟文档为准）。
2. AI 网关默认 Ordinary Clock 从钟，不做站级 Grandmaster。
3. 与录波装置同 PTP 域时，才能谈「ms 级对标」；仅 NTP 时验收写清「秒级对齐」。

2.4 容器与板级

3. 事件字段：ts 与 clock_quality

3.1 ts 约定（对齐 Schema）

建议字段（可与现有 Schema 扩展兼容）：

{
  "event_code": "PPE_VIOLATION",
  "ts": "2026-10-25T01:00:00.123Z",
  "ts_publish": "2026-10-25T01:00:00.180Z",
  "clock_quality": {
    "sync_state": "sync",
    "source": "ptp+ntp",
    "offset_ms": 2.5,
    "max_error_ms": 20,
    "leap": "ok",
    "last_sync_age_s": 12
  },
  "quality": "suspect"
}

3.2 clock_quality 建议枚举

阈值建议（可配置，非标准）：|offset_ms| > 100 视觉告警降级；> 1000 与 SOE 对标任务冻结。

4. 故障模式：检测与告警

与 MQTT 衔接：运维类走 edgeai/.../events/ops 或 telemetry 扩展，禁止进保护遥控通道。断时钟 不得阻塞推理（同「断 MQTT 不堵」原则）。

5. 两周落地清单

6. 与 BOM / Schema / MQTT 衔接

7. 验收门禁与 SOE / 录波对表（可勾选）

与录波 / SOE 对表实操（最小）

1. 选同一时间窗：人工触发可观测事件（如 PPE 试验帽、电子围栏试闯），同时记下保护/测控 SOE 或录波通道时刻。
2. 取 AI MQTT 事件 ts（及可选 ts_publish），计算 Δt。
3. 报告写明时钟层级（L1 NTP / L2 PTP）、VLAN、是否同源 GNSS。
4. Δt 超合同阈：先查 AI 盒 clock_quality，再查相机 OSD、协议网关缓冲，最后才怀疑模型误检时刻。

二次系统对时规程、保护装置 IRIG-B/PTP 专规以站端为准；本文不展开继电保护专业条款（细节 unknown 处以调度/厂家文档为准）。

8. 参考命令速查（可执行）

# NTP / chrony
chronyc tracking
chronyc sources -v
chronyc makestep   # 仅维护窗口；生产慎用，须审计

# NIC 时间戳能力
ethtool -T eth0

# PTP（linuxptp，配置随站域）
# ptp4l -i eth0 -f /etc/linuxptp/ptp4l.conf
# phc2sys -s eth0 -c CLOCK_REALTIME -O 0
# 或 timemaster -f /etc/timemaster.conf

timedatectl status   # 确认 NTPSynchronized / Time zone: Asia/Shanghai

具体 conf 键值以发行版与站钟文档为准；上文不绑定单一 vendor profile（unknown 处以运维为准）。

9. 许可与版本钉选（简）

本文仅落盘调研手册，不替代站端二次系统/继电保护时钟规程。实施前与运维、保护专业确认 NTP/PTP 域与跨区边界。