授时硬件在环:拔掉天线,为守时评分
电信和电力运营商通过移除授时系统的GNSS并观察时钟的表现来测试它。Kshana不替他们做这件事,也不接触他们的设备。它读取运营商自己的仪器所产生的钟差记录,在运营商声明的两个时间点处将其拆分,并对照公开的ITU-T模板衡量每一步。场景类型为holdover-test;示例场景为scenarios/holdover-test-example.toml和scenarios/holdover-test-ptp4l.toml。
这是硬件安全第1阶段:被动、仅接收,Kshana不发射任何射频(HARDWARE-SAFETY.md)。仅供参考的软件,不是经型式认可的设备。没有人对该程序作过评级、认可或审校,它也不说明任何系统是否满足某项建议书。
程序#
操作人员执行四个步骤。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)。