14. PTP 时间同步
Odin1 Lite 支持基于 PTP(Precision Time Protocol,IEEE 1588) 的高精度时间同步,可将设备系统时钟与上位机(Host)时钟同步到毫秒级以内,使 LiDAR、相机、IMU 等传感器数据的硬件时间戳与主机时钟处于同一时间基准,满足多传感器融合、多机协同等对时间一致性要求较高的应用场景。
Odin1 Lite 默认使用系统时钟(SysTick)作为传感器数据时间戳来源。未部署 PTP 环境时无需任何配置。
14.1 PTP 协议原理
14.1.1 协议概述
PTP(IEEE 1588)是一种面向局域网的高精度时钟同步协议,与 NTP(毫秒~十毫秒级)相比,PTP 通过硬件时间戳(Hardware Timestamping)将同步精度提升至亚微秒级,广泛应用于工业自动化、电信、车载与机器人领域。
PTP 采用主从(Master-Slave)架构:
- 主时钟(Grandmaster / GM):网络中的时间源,通常为上位机或专用时钟服务器;
- 从时钟(Slave):与主时钟对齐的设备,Odin1 Lite 在同步网络中作为从时钟;
- 边界时钟(Boundary Clock, BC) / 透明时钟(Transparent Clock, TC):中间网络设备(如 PTP 交换机),逐跳修正链路时延,避免多级转发引入的累积误差。
14.1.2 同步机制(Delay Request/Response 机制)
主从时钟之间通过四类报文完成时钟偏移与链路时延的测量:
主时钟(Master) 从时钟(Slave)
│ │
│ ── Sync(t1 硬件打戳) ──────────────▶ │ t2
│ ── Follow_Up(携带 t1) ─────────────▶ │
│ │
│ ◀───────────── Delay_Req(t3 打戳)── │ t3
│ ◀──────── Delay_Resp(携带 t4)────── │ t4
│ │
偏移:offset = [(t2-t1) - (t4-t3)] / 2
链路时延:delay = [(t2-t1) + (t4-t3)] / 2
- 主时钟周期性广播
Sync报文,并在报文经过网卡时由 PHY/MAC 硬件打上精确时间戳(t1);从时钟记录接收时间戳(t2); Follow_Up报文将 t1 传递给从时钟;- 从时钟发送
Delay_Req(打戳 t3),主时钟回复Delay_Resp(携带接收时间戳 t4); - 从时钟根据上述公式解算时钟偏移(offset)与链路时延(delay),并逐步驯服(discipline)本地时钟。
关键精度保障在于 t1–t4 均由硬件产生,消除了协议栈软件处理带来的不确定时延(抖动可达数十微秒),这也是 PTP 相对软件 NTP 方案的核心优势。
14.1.3 传输协议:L2(IEEE 802.3)
PTP 报文可承载于 UDP/IPv4(L3)或直接承载于以太网帧(L2,EtherType 0x88F7)。Odin1 Lite 采用 L2(IEEE 802.3) 传输:
- L2 报文不经过 IP 协议栈,时延更小、路径确定性更强;
- 需要网络中所有 PTP 端口配置为同一传输协议(本方案交换机端口协议须设置为 IEEE 802.3)。
14.1.4 主从选举(BMCA)
网络中的时钟通过最佳主时钟算法(Best Master Clock Algorithm, BMCA)依据时钟等级(clockClass)、精度(clockAccuracy)、优先级(Priority1/Priority2)等参数自动选举主时钟。在 Odin1 Lite 的典型部署中,上位机被显式配置为 masterOnly,交换机作为边界时钟向上游(Host)同步、向下游(设备)提供时间源。
14.2 系统架构
Odin1 Lite 的 PTP 同步体系由三层组成:
┌──────────────────┐
│ Host(主时钟) │ ptp4l(masterOnly) + phc2sys(系统时钟 → 网卡 PHC)
└────────┬─────────┘
│ IEEE 802.3(L2 PTP 报文)
┌────────┴─────────┐
│ PTP 交换机(BC) │ HiSync PTP 交换机 R01,P0 = 管理,PTP1~PTP4 = 一主三从
└────────┬─────────┘
│
┌────────┴─────────┐
│ Odin1 Lite(从) │ ptp4l + phc2sys(网卡 PHC → 系统时钟)+ odin_ptp_daemon
└──────────────────┘
| 组件 | 角色 | 说明 |
|---|---|---|
Host ptp4l | 主时钟端口 | -H(硬件时间戳)-2(L2 传输)--masterOnly=1 |
Host phc2sys | 时钟驯服 | 将 Host 系统时钟(CLOCK_REALTIME)同步到网卡 PHC |
| PTP 交换机 | 边界时钟(BC) | 上游跟随 Host,下游为最多三台设备提供时间;SYNC 指示灯同步状态可视化 |
设备 ptp4l / phc2sys | 从时钟 | 将网卡 PHC 与主时钟对齐,并把 PHC 同步到设备系统时钟 |
设备 odin_ptp_daemon | 常驻守护进程 | 管理设备端 PTP 会话,配合驱动时间同步模式 |
14.3 网络与交换机配置
Odin1 Lite 通过 HiSync PTP 交换机(R01 型,北京飞灵科技) 组建同步网络:
| 项 | 说明 |
|---|---|
| 端口定义 | P0:连接管理电脑(WebUI 配置,不参与 PTP);PTP1 ~ PTP4:一主三从 PTP 端口 |
| WebUI 地址 | http://192.168.1.82(需与 Odin1 Lite / Host 同网段) |
| 登录账户 | 用户名 admin / 密码 admin |
| 指示灯 | SYNC:绿灯慢闪 = PHC 未同步;绿灯常亮 = 已与上游 PHC 同步 |
配置步骤:
- 管理电脑接入
P0,将其配置为192.168.1.x网段,浏览器访问http://192.168.1.82登录 WebUI; - 左侧列表进入「时间同步 → PTP」,点击「端口配置」;
- 若各 PTP 端口
Protocol列显示的不是 L2,点击「编辑」,将 Protocol 更改为 IEEE 802.3(其余配置保持默认),保存; - 将所有 PTP 端口协议改为 L2 后,点击「保存并应用」,等待交换机重启。
主时钟 Host 与从设备均须接入
PTP1 ~ PTP4,不要接入P0。
14.4 主机端(Host)配置
前提:确认 Host 网卡支持硬件时间戳(ethtool -T <网卡> 输出含 hardware-raw-clock / SOF_TIMESTAMPING_RAW_HARDWARE),并确认接入交换机的网卡名称(下例为 enp1s0f0,请替换为实际网卡)。
# 启动 ptp4l:L2 传输 + 硬件时间戳 + 仅主模式
sudo ptp4l -i enp1s0f0 -m -H -2 --masterOnly=1
# 启动 phc2sys:将系统时钟同步到网卡 PHC(另一终端)
sudo phc2sys -s CLOCK_REALTIME -c enp1s0f0 -m -O 0 -S 0.001
Host 启动后,无论从设备是否接入,交换机都应先与 Host 完成同步——可通过交换机 SYNC 指示灯(绿灯常亮)或 WebUI「同步状态」页面(时间同步状态、PTP 时钟时间、偏移量、祖父时钟信息等)确认。
14.5 硬件支持性检查与软同步方案
14.5.1 如何判断 Host 网卡是否支持 PTP 硬件时间戳
PTP 硬件时间戳依赖网卡的 PHC(PTP Hardware Clock)。在 Host 上依次执行以下检查:
① 查看网卡时间戳能力
ethtool --json -T enp1s0f0 # 或旧版:ethtool -T enp1s0f0
| 输出关键字 | 含义 | 结论 |
|---|---|---|
hardware-raw-clock: true / SOF_TIMESTAMPING_RAW_HARDWARE 且 ptp-hardware-clock 指向 /dev/ptpN | 网卡具备独立 PHC | ✅ 支持硬件同步,按 14.4 正常部署 |
仅有 software-raw-clock: true / SOF_TIMESTAMPING_SOFTWARE | 网卡无 PHC | ❌ 不支持硬件同步,转 14.5.2 软同步 |
常见支持硬件时间戳的网卡:Intel i210/i211/i225/i226、82574、82599/X520、X550 系列;大多数消费级板载网卡(如 Realtek RTL8111/8125、部分 Intel 1225-V 系列)不支持。
② 确认 PHC 设备节点
ls /dev/ptp*
# 支持硬件时间戳的网卡会枚举出 /dev/ptp0 等节点;
# 可用 ethtool --json -T enp1s0f0 输出中的 ptp-hardware-clock 字段确认对应关系
③ 验证 PHC 可读
sudo phc_ctl /dev/ptp0 get
若返回当前 PHC 时间则说明硬件时钟工作正常。
设备端(Odin1 Lite)已内置 PHC 硬件时钟,上述检查仅针对 Host。若 Host 不支持硬同步,整条链路将退化为软同步精度。
14.5.2 软件时间戳方案(无 PHC 网卡)
若 Host 网卡不支持硬件时间戳,仍可使用 linuxptp 的软时间戳(software timestamping)模式完成 PTP 同步:报文打戳点从 PHY/MAC 退化为内核协议栈,消除用户态处理时延,但无法消除内核收发路径抖动,典型同步精度从亚微秒级退化为百微秒级(约 10 μs ~ 1 ms)。
Host 侧只需一处变化(对比 14.4):ptp4l 的 -H(硬件时间戳)改为 -S(软件时间戳):
# Host:软时间戳主时钟(-S = software timestamping)
sudo ptp4l -i enp1s0f0 -m -S -2 --masterOnly=1
# phc2sys 不再适用(Host 无 PHC):
# -S 模式下 ptp4l 的时间戳直接来源于系统时钟 CLOCK_REALTIME,
# Host 系统时钟本身就是对外发布的时间基准,无需额外驯服
# 设备端:保持硬件时间戳从模式不变(odin_ptp_daemon / ptp4l -H),无需任何改动
说明:设备侧 PHC 始终可用,建议保持硬件时间戳从模式;链路整体精度瓶颈在 Host 软戳一侧。若客户对精度要求较高且 Host 不带 PHC,也可建议客户更换一颗支持硬件时间戳的网卡(如 Intel i226,成本低且主流发行版免驱)。
精度预期与选型建议
方案 Host 硬件要求 典型同步精度 适用场景 硬件 PTP(推荐) 网卡带 PHC 亚微秒级 多传感器紧耦合融合、运动重建 软件 PTP(-S) 普通网卡 10 μs ~ 1 ms 时间粗对齐、日志对时
14.5.3 软同步下的替代工具
软同步对 Host 网卡无硬件要求,实现工具也不限于 linuxptp。除本方案默认的 linuxptp(ptp4l) 外,主流可选实现如下:
| 工具 | 协议/Profile | 平台 | 特点 | 适用性 |
|---|---|---|---|---|
| linuxptp(ptp4l + phc2sys) | IEEE 1588-2019 全配置(含 L2/UDP、802.1AS) | Linux | 官方内核配套实现,功能最全,软/硬时间戳均支持 | ✅ 推荐,本文档默认方案 |
| ptpd2(PTPd) | IEEE 1588-2008 | Linux/BSD | 老牌实现,配置简单,社区活跃度已下降 | ⚠️ 可用,无新特性,不建议新项目采用 |
| OpenAvnu gPTP | IEEE 802.1AS(gPTP) | Linux/Windows | Intel 主导,面向 AVB/TSN 音视频场景,Windows 侧可用 | ⚠️ 仅推荐 gPTP/TSN 场景 |
说明:
- 802.1AS(gPTP)注意:若客户环境是车载/AVB/TSN 网络并使用 gPTP profile,需确认 PTP 交换机同样支持 802.1AS,且 Odin1 Lite 侧 daemon 是否兼容对应 profile,请先联系留形技术支持确认;
- ptpd2 与 ptp4l 不能同时运行在同一主机,端口会冲突;
- 无论选择哪种工具,软同步的精度上限由打戳点位置(内核协议栈)决定,而非工具本身,各工具在相同软戳模式下精度基本相当。
14.6 设备端配置
设备端 PTP 会话由固件内置的 odin_ptp_daemon 守护进程自动管理(与 ptp4l / phc2sys 配套),无需用户登录设备做任何手工操作。
用户的全部操作都在 Host 侧通过 ROS 服务完成:
驱动提供时间同步模式服务(详见 5. 数据输出):
# 查询当前同步模式(0=SysTick 系统时钟,1=PTP)
ros2 service call /manifold/device0/get_sync_mode \
odin_ros_driver_rev1/srv/GetSyncMode "{}"
# 切换到 PTP 硬件时间戳模式(需重启设备后生效)
ros2 service call /manifold/device0/set_sync_mode \
odin_ros_driver_rev1/srv/SetSyncMode "{sync_mode: 1}"
PTP 生效后,可实时查询同步质量:
ros2 service call /manifold/device0/get_ptp_sync_status \
odin_ros_driver_rev1/srv/GetPtpSyncStatus "{}"
返回的快照包含同步状态、时钟偏移(offset from master)、链路时延(mean path delay)与频率调整量等,可用于量化评估同步精度。
若
get_ptp_sync_status长时间显示未同步,请按顺序排查:交换机端口协议是否为 L2(14.3)→ Host 主时钟是否运行(14.4)→ 设备时间同步模式是否为 PTP(14.6);仍无法解决请联系留形技术支持。
14.7 同步验证
- 交换机同步状态:
SYNC指示灯绿灯常亮,WebUI「同步状态」显示已同步且偏移量在毫秒级以内; - PTP 同步状态查询:通过
get_ptp_sync_status确认设备侧同步状态与偏移量(见 14.6); - 数据时间戳验证:Host 运行驱动后,检查传感器话题时间戳已切换到同步后的时钟:
ros2 launch odin_ros_driver_rev1 odin1Lite.launch.py
ros2 topic echo /manifold/device0/imu --field header.stamp
14.8 注意事项
- 全网络 PTP 端口必须统一使用 L2(IEEE 802.3) 协议,混用 UDPv4 会导致无法同步;软同步模式下报文同样走 L2,交换机端口配置要求不变;
set_sync_mode修改后必须重启设备才能生效;- 设备端
odin_ptp_daemon与系统默认ptp4l/phc2sys互斥,同时运行会导致同步异常; - Host 网卡最好支持硬件时间戳;不支持时可退化为软时间戳(
ptp4l -S),但同步精度将显著下降(详见 14.5); - PTP 交换机与 Host、设备须处于同一网段,Host 接入交换机
PTP1 ~ PTP4,管理电脑接入P0; - 建议通过
get_ptp_sync_status定期监控偏移量,偏移持续增大时优先排查链路、交换机端口配置与 Host 主时钟状态。