把精密时间送到远端
CERN与GSI等发展、NIST实际部署的开放时间同步技术。本页选官方SPEC双节点入门套件,含概览视频、原版BOM、九章接线与PPS测量图解;原采购入口、版本兼容和校准边界明确标注。
alan000
IEEE IFCS(NIST应用论文) 2018
目的:搭起两节点 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)

目的:断电安装两块扩展板,确认机箱和 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)

目的:按手册连接两节点的 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)

目的:在与原驱动匹配的隔离系统中准备锁定版源码。
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)

目的:确认 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)

目的:通过 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)

目的:将紫色节点设为主时钟、蓝色节点设为从时钟,并检查锁定状态。
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)

目的:用示波器测量两端 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)

目的:记录同步测量误差,并保存可复查的配置。
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)
