用光纤同步两台设备的时间|White Rabbit

把精密时间送到远端

CERN与GSI等发展、NIST实际部署的开放时间同步技术。本页选官方SPEC双节点入门套件,含概览视频、原版BOM、九章接线与PPS测量图解;原采购入口、版本兼容和校准边界明确标注。

alan000

IEEE IFCS(NIST应用论文) 2018

参数信息

基础同步节点
2 个

复现文档

确认两节点范围和采购包

目的:搭起两节点 White Rabbit PPS 同步教学系统。

1. 按 SPEC Starting Kit v3.1 准备两台 PC、两块 SPEC 4.1、两块 FMC-DIO 2.0。

2. 两板用 2 m 光纤直连;基础路线不加 WR 交换机。

3. 逐项核对标准套件的 7 类物料,并另备两根可传数据的 mini-USB 线。

4. 老商品页库存和版本尚未确认,先向原供应链核询价、板卡修订和随包五金;GPS、原子钟和长光纤属于扩展项。

**检查**:两节点硬件与额外 USB 线均已列入采购/清点表。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![01|确认两节点范围和采购包 图解](https://cdn.lunlunapp.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/cover/742eac762bc7413fa65e9a289a7ec724.jpg)![01|确认两节点范围和采购包 图解](https://cdn.lunlunapp.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/cover/a42360cb62ff4f8099ff600cd789fe0d.png)

断电安装板卡并固定

目的:断电安装两块扩展板,确认机箱和 PCIe 规格匹配。

1. 两台 PC 均断电,核查空余 PCIe x4、x8 或 x16 槽及机箱高度。

2. 按接口方向和支柱将 FMC-DIO 与 SPEC 组合,固定到 PCIe 挡板。

3. 检查金手指、排针和焊点,没有弯针、松动或裸露金属接触机箱。

4. 优先按原手册分置两台 PC;手册记录部分内核下单机双板会出问题。

**检查**:板卡平整入槽并由挡板固定,机箱内无松散螺丝或短路风险。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![ssk_inside.jpg](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/b751772a367b45c1aa0c20a977992d8b.jpg)![ssk_configs.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/46b8b91a7aaf43db93d46ae4468e578a.png)

接成对SFP、光纤与UART

目的:按手册连接两节点的 SFP 光链路和各自 UART。

1. PC01装紫色 AXGE-3454-0531,PC02装蓝色 AXGE-1254-0531。

2. 用 LC-LC、2 m 单模光纤连接两块 SPEC;插接前取下端帽并保持端面清洁。

3. 每块 SPEC 各用一根 mini-USB 数据线接回所属 PC,用于物理 UART。

4. 记录 PC 编号、板卡序列号、SFP 料号和 UART 对应关系。

**检查**:光纤两端接到不同节点,UART线没有交叉混接,序列号与记录一致。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![ssk_sfp.jpg](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/652aaa90067a4986a9e2896466e3ac03.jpg)![ssk_usb.jpg](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/0ac222c505ff4cca8fb868e0efae22bd.jpg)

锁定系统和源码依赖

目的:在与原驱动匹配的隔离系统中准备锁定版源码。

1. 原手册验证 Ubuntu 16.04.6/内核 4.15.9 与 Ubuntu 18.04.2/内核 4.18.0-17;记录 18.04.3 的 5.0 内核兼容问题。

2. 使用隔离实验环境,不把旧驱动装进日常主系统。

3. 锁定版本 v3.1 及全部子模块;先确认原仓库迁移后的 GitLab 地址和系统依赖。

4. 按 v3.1 手册安装依赖、执行 make,再按手册执行 sudo make install。

**检查**:系统/内核版本、源码提交和子模块均有记录;迁移地址或依赖不明时先停在编译前。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![calibration.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/6a38728d4e474239895ac7a74bccf4db.png)

识别PCIe并加载驱动

目的:确认 PC 能识别 SPEC 并建立驱动接口。

1. 运行 `lspci`,记录 CERN 设备条目及实际 PCIe 路径。

2. 按原手册加载 `spec`、`htvic`、`wr-nic`、`wr-dio` 驱动。

3. 检查系统出现 `wri` 接口,并查看 `dmesg` 中是否有加载错误。

4. 仅当旧板明确提示 FRU 缺失时,按该板实际型号、序列号和总线路径执行对应修复;不要复制示例序列号。

**检查**:PCIe设备、驱动和 wri 接口均可见;FRU正常时跳过修复。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![05|识别PCIe并加载驱动 图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/b751772a367b45c1aa0c20a977992d8b.jpg)![05|识别PCIe并加载驱动 图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/6a38728d4e474239895ac7a74bccf4db.png)

读串口、备份配置和校准信息

目的:通过 UART 确认固件、SFP识别及校准信息。

1. 以 115200 波特率打开对应 `ttyUSB` 串口;端口号按本机枚举结果选择。

2. 确认出现 `wrc` 提示符,运行 `ver` 查看版本。

3. 运行 `sfp show` 和 `sfp match`,核对模块信息及校准数据库匹配结果。

4. 只有确认 SDBFS 缺失或损坏时才进入手册修复步骤;正常配置不要格式化。

5. 校准数值采用手册的专门校准章节,并匹配实际硬件和固件,不套用其他示例延迟。

**检查**:版本、SFP型号和校准匹配状态已保存;SDBFS状态正常。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![06|读串口、备份配置和校准信息 图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/0ac222c505ff4cca8fb868e0efae22bd.jpg)![06|读串口、备份配置和校准信息 图解](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/6a38728d4e474239895ac7a74bccf4db.png)

配置主从并观察锁定

目的:将紫色节点设为主时钟、蓝色节点设为从时钟,并检查锁定状态。

1. 在紫色节点依次执行 `ptp stop`、`mode master`、`ptp start`。

2. 在蓝色节点依次执行 `ptp stop`、`mode slave`、`ptp start`。

3. 在从端 GUI 查看 Link up、Locked Calibrated、TRACK_PHASE 和 Phase tracking ON。

4. 记录主从角色与状态;主端是自由振荡器,因此这一步验证两节点相对同步,不提供绝对 UTC 溯源。

**检查**:从端链路为 Link up,锁定与相位跟踪状态均显示开启。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![07|配置主从并观察锁定 图解](https://cdn.lunlunapp.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/cover/a42360cb62ff4f8099ff600cd789fe0d.png)![07|配置主从并观察锁定 图解](https://cdn.lunlunapp.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/cover/3f985329394f494090b2454585477424.png)

接双通道PPS测量

目的:用示波器测量两端 PPS 边沿差。

1. 确认 PLL 已锁定;按原命令将两板连接器 #1(channel0)设为 p 模式。

2. 两块板分别用等长 LEMO 线,再经 LEMO-BNC 接示波器两个通道。

3. 确认示波器端接和通道偏斜设置,保存双通道波形。

4. 记录线缆长度;手册提示约 5 ns/m 额外延迟,线长差会影响亚纳秒比较。

5. 套件第三根线留作 DIO 扩展测试。

**检查**:两通道均有 PPS 边沿,接线长度和通道设置已记录。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![ssk_pps-setup.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/753cdff22b62435393e59796f92f0453.png)![ssk_lemo.jpg](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/35d078ccd56740dd8c94e36eb323d39c.jpg)

记录波形、误差和配置

目的:记录同步测量误差,并保存可复查的配置。

1. 测量双 PPS 边沿差,记录均值、峰峰值、时间跨度和测量不确定度。

2. 重连或重启两端后,再检查从端是否重新锁定。

3. 将 stamp-frame 网络例程的 8 ns 分辨率与 PPS 同步结果分开记录。

4. 归档板卡序列号、内核、源码提交、固件版本、SFP数据库信息和接线照片。

**检查**:波形、测量条件和锁定记录齐全后,再报告本机实测结果。

\

[原手册v3.1完整命令与图](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4/doc/wr-starting-kit.md) · [锁定源码](https://gitlab.com/ohwr/project/wr-starting-kit/-/tree/7ef09bfebbadd1ca8bd8567a35c11b7305aabbe4)

![09|记录波形、误差和复现边界 图解](https://cdn.lunlunapp.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/cover/3f985329394f494090b2454585477424.png)![ssk_pps-res.jpg](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/a7f80b66-f9a5-4dea-b726-e60e1e600797/files/image/49ec87ae5e424bf68a47dbd3fe5e2f70.jpg)