机器翻译,未经母语人士审校。以英文版为准。

授时在GitHub上编辑来源:docs/TIMING-HIL.md

授时硬件在环:拔掉天线,为守时评分

电信和电力运营商通过移除授时系统的GNSS并观察时钟的表现来测试它。Kshana不替他们做这件事,也不接触他们的设备。它读取运营商自己的仪器所产生的钟差记录,在运营商声明的两个时间点处将其拆分,并对照公开的ITU-T模板衡量每一步。场景类型为holdover-test;示例场景为scenarios/holdover-test-example.toml和scenarios/holdover-test-ptp4l.toml。

这是硬件安全第1阶段:被动、仅接收,Kshana不发射任何射频(HARDWARE-SAFETY.md)。仅供参考的软件,不是经型式认可的设备。没有人对该程序作过评级、认可或审校,它也不说明任何系统是否满足某项建议书。

由钟差记录评分的一次守时测试,取自引擎v0.40.0在scenarios/holdover-test-example.toml上的一次真实运行(601个样本,每5 s一个)。操作人员在600 s撤去GNSS,在2400 s恢复;钟差漂移到守时结束时的299 ns,在675 s之后超出100 ns的预算,并在恢复后70 s回到100 ns的范围之内。结论:基线模板PASS,守时模板FAIL,守时包络FAIL,恢复RECOVERED。是对照模板测得,不是认可。这些时间是操作人员的陈述,Kshana未予验证。仅供参考:研究与工程工具的分析输出,不是经型式认可的导航设备,也不是生命安全服务。由钟差记录评分的一次守时测试,取自引擎v0.40.0在scenarios/holdover-test-example.toml上的一次真实运行(601个样本,每5 s一个)。操作人员在600 s撤去GNSS,在2400 s恢复;钟差漂移到守时结束时的299 ns,在675 s之后超出100 ns的预算,并在恢复后70 s回到100 ns的范围之内。结论:基线模板PASS,守时模板FAIL,守时包络FAIL,恢复RECOVERED。是对照模板测得,不是认可。这些时间是操作人员的陈述,Kshana未予验证。仅供参考:研究与工程工具的分析输出,不是经型式认可的导航设备,也不是生命安全服务。

程序#

操作人员执行四个步骤。Kshana不执行其中任何一步。

步长 操作人员做什么 记录显示什么
1. 基线 让系统在测试所需的时长内保持锁定到GNSS(并记下此前已锁定了多少天)。 被驾驭时的钟差。
2. 移除GNSS 从被测系统上移除GNSS,例如在接收机处拔下天线电缆,或实验室自己的模拟器的输出,并记下时间。请先查阅接收机厂商的手册:有些接收机为天线供电,有些需要在空置的端口上接终端负载。 钟差开始漂移的时刻。
3. 守时 让系统在规划的时间内依靠自己的振荡器运行。 系统的守时。
4. 恢复 恢复GNSS,并记下时间。 钟差回落(或没有回落)。

操作人员必须做的两件事,因为Kshana做不到:

  • 声明这两个时间。 gnss_removed_s和gnss_restored_s是操作人员的声明。Kshana不会从记录中检测移除,也不核实这两个时间。错误的时间会移动各步骤的边界,从而改变结果。
  • 记录和时间使用同一个时钟。对于时钟日志,时间轴从第一次读数开始,因此这两个时间是自日志第一行起算的秒数。

要记录什么#

以下任何一种,通过现有的clock_log读取器读取(CLOCK-LOG-FORMATS.md):

仪器 格式 记录如何生成
linuxptp ptp4l(从时钟或边界时钟的伺服) ptp4l 使用-m运行,并保留ptp4l[time]: master offset N sK freq ...各行
linuxptp phc2sys phc2sys phc2sys[time]: CLOCK_REALTIME phc offset N sK ...各行
linuxptp ts2phc ts2phc ts2phc[time]: /dev/ptpN offset N sK ...各行
chrony tracking.log chrony-tracking chrony.conf中的log tracking
chrony statistics.log chrony-statistics chrony.conf中的log statistics
TAPR TICC计数器 ticc 相对于参考的时间戳模式
TimeLab ASCII导出 timelab 以所述单位表示的相位
RINEX钟差文件 rinex-clk 一个时钟
其他任何形式 samples或csv_path time_s,time_error_ns数据对,均匀采样

记录测量的是什么很重要。伺服日志(linuxptp、chrony)记录的是守护进程测得并正在校正的偏移:它是伺服控制下剩余的钟差,而不是时钟相对于UTC的独立测量。在确实移除了参考的测试的守时步骤中,伺服日志显示的仍是守护进程所认为的值,它可能不同于真实误差。相对于独立参考的TICC或其他计数器是更可靠的记录;报告结果时请说明你使用的是哪一种。

场景#

kind = "holdover-test"
masks = ["prtc-a", "eprtc-a-holdover"]      # see docs/TELECOM-TIMING.md for the ids

[test]
gnss_removed_s = 600.0                      # the operator's statement
gnss_restored_s = 2400.0                    # omit if GNSS was not restored within the record
locked_duration_days = 5.0                  # how long it was locked before step 2 (sets the ePRTC-A period)
recovery_band_ns = 100.0                    # |TE| inside this counts as recovered
recovery_dwell_s = 60.0                     # ... and must stay inside this long

[series.clock_log]                          # or [series] samples = [[t, ns], ...] or csv_path = "..."
format = "ptp4l"
path = "holdover-2026-11-02.log"            # or text = "..." inline
kshana holdover-test.toml

可选的键:budgets(名称、max_abs_te_ns、来源;缺省时采用电信授时默认值),以及[series.clock_log]内的clock = "...",用于从包含多个时钟的日志中选出一个来源。

报告包含什么#

  • steps:对基线、守时和恢复,给出起止时间、采样数,以及钟差的均值、均方根、最大值和结束值。
  • masks:你指名的每个模板,在其条件所指明的步骤上测量。为锁定时钟编写的模板在基线上测量;为守时或自主时钟编写的模板在守时步骤上测量。每项检查都有其限值、测得值、裕量及其转录来源的表。需要比该步骤所提供的记录更长记录的模板为INCOMPLETE,绝不外推;引擎无法针对该记录的采样间隔进行评估的模板为NOT-EVALUATED,并给出原因。
  • holdover:系统所保持的分数频率偏移(通过守时钟差的最小二乘直线的斜率,单位为ns/s,即十亿分之一)、围绕该直线的残差、最大绝对钟差及其出现的时间,以及移除时刻的阶跃。
  • holdover_envelope:ITU-T G.8272.1表3的ePRTC-A守时包络,依据locked_duration_days,并给出首次超出它的时间。
  • budgets:移除之后,每项钟差预算首次被超出的时间。
  • recovery:|TE|是否进入该范围并在驻留时间内保持其中、这一情况在GNSS恢复之后多久开始、恢复之后的峰值,以及恢复期间相邻采样之间的最大阶跃。
  • curves:基线步骤和守时步骤的MTIE和TDEV。
  • verdicts:每个步骤一个词的概括。

每个数值都带有其单位及其来源,见报告的units块。

用词与限度#

  • 结果是对照模板衡量的。模板转录自可免费下载的ITU-T建议书(与telecom-timing类型相同的表,列于TELECOM-TIMING.md),建议书中标注“有待进一步研究”的每一项都不予收录,而不是自行填补。Kshana不声称某个时钟或系统满足或获得某项建议书的认可,报告也不这样声称。
  • MODELLED。步骤逻辑、直线拟合和恢复规则,是在由答案在运行前已知的公式构建的记录上核对的;没有任何实验室守时对照外部参考基准(oracle)评过分,也没有任何合作方或实验室同意过任何事项。在任何分时钟等级的数据可以升级之前,需要一个授时实验室。
  • 不涵盖的内容,每份报告中均有说明:GNSS是否确实在所述时间被移除和恢复;操作人员未记录的任何步骤;对于采样慢于每秒一次的记录,通过0.1 Hz滤波器定义的模板;仪器自身的测量不确定度;以及时间误差记录之外的任何建议书程序(温度曲线、分组网络负载)。
  • 恢复范围是该测试自己的选择。默认值100 ns是PRTC-A的最大绝对钟差(ITU-T G.8272);它是一条方便的界线,不是任何建议书对恢复提出的要求。
  • 没有发射路径。Kshana读取文件。它不生成信号,在实验室中移除GNSS要用实验室自己的设备并在其自身的授权下进行。

界面#

holdover-test是一种场景类型,因此凡能运行场景类型之处都可运行:kshana <scenario.toml>、Rust API(kshana::api::run_toml)、Python绑定(kshana.run)、WebAssembly和npm构建(内联samples或clock_log.text;那里不提供文件键)、MCP服务器(run_scenario,仅限内联内容)以及Kshana Studio的场景运行器。两个场景文件已内置(kshana example holdover-test-example)。