精确时间协议 - PTP

删除交换机上的默认 NTP 配置

cumulus@switch:~$ nv unset service ntp mgmt server 0.cumulusnetworks.pool.ntp.org
cumulus@switch:~$ nv unset service ntp mgmt server 1.cumulusnetworks.pool.ntp.org
cumulus@switch:~$ nv unset service ntp mgmt server 2.cumulusnetworks.pool.ntp.org
cumulus@switch:~$ nv unset service ntp mgmt server 3.cumulusnetworks.pool.ntp.org
cumulus@switch:~$ nv config apply

停止并禁用管理 VRF 中的 NTP 服务

cumulus@switch:~$ sudo systemctl stop ntpsec@mgmt.service
cumulus@switch:~$ sudo systemctl disable ntpsec@mgmt.service

1. 编辑 /etc/ntpsec/ntp.conf 文件以注释掉默认 NTP 配置

   cumulus@switch:~$ sudo nano /etc/ntpsec/ntp.conf
   # server 0.cumulusnetworks.pool.ntp.org iburst
   # server 1.cumulusnetworks.pool.ntp.org iburst
   # server 2.cumulusnetworks.pool.ntp.org iburst
   # server 3.cumulusnetworks.pool.ntp.org iburst
   

   2. 停止并禁用管理 VRF 中的 NTP 服务

   cumulus@switch:~$ sudo systemctl stop ntpsec@mgmt.service
   cumulus@switch:~$ sudo systemctl disable ntpsec@mgmt.service
   

NVUE nv set service ptp 命令需要实例编号（以下示例命令中为 1）以进行管理。

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set interface swp1 ip address 10.0.0.9/32
cumulus@switch:~$ nv set interface swp2 ip address 10.0.0.10/32
cumulus@switch:~$ nv set interface swp1 ptp enable on
cumulus@switch:~$ nv set interface swp2 ptp enable on
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set bridge domain br_default
cumulus@switch:~$ nv set bridge domain br_default type vlan-aware
cumulus@switch:~$ nv set bridge domain br_default vlan 10-30
cumulus@switch:~$ nv set bridge domain br_default vlan 10 ptp enable on
cumulus@switch:~$ nv set interface swp1 bridge domain br_default
cumulus@switch:~$ nv set interface swp1 bridge domain br_default vlan 10
cumulus@switch:~$ nv set interface swp1 bridge domain br_default vlan 20
cumulus@switch:~$ nv set interface swp1 ptp transport 802.3
cumulus@switch:~$ nv set interface swp1 ptp enable on
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set bridge domain br_default
cumulus@switch:~$ nv set bridge domain br_default type vlan-aware
cumulus@switch:~$ nv set bridge domain br_default vlan 10-30
cumulus@switch:~$ nv set bridge domain br_default vlan 10 ptp enable on
cumulus@switch:~$ nv set interface vlan10 type svi
cumulus@switch:~$ nv set interface vlan10 ip address 10.1.10.2/24
cumulus@switch:~$ nv set interface vlan10 base-interface br_default
cumulus@switch:~$ nv set interface vlan10 ptp enable on
cumulus@switch:~$ nv set interface swp1 bridge domain br_default
cumulus@switch:~$ nv set interface swp1 bridge domain br_default vlan 10
cumulus@switch:~$ nv set interface swp1 bridge domain br_default vlan 20
cumulus@switch:~$ nv set interface swp1 ptp enable on
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set bridge domain br_default
cumulus@switch:~$ nv set bridge domain br_default type vlan-aware
cumulus@switch:~$ nv set bridge domain br_default vlan 10-30
cumulus@switch:~$ nv set bridge domain br_default vlan 10 ptp enable on
cumulus@switch:~$ nv set interface swp2 bridge domain br_default
cumulus@switch:~$ nv set interface swp2 bridge domain br_default access 10
cumulus@switch:~$ nv set interface swp2 ptp transport 802.3
cumulus@switch:~$ nv set interface swp2 ptp enable on
cumulus@switch:~$ nv config apply

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set bridge domain br_default
cumulus@switch:~$ nv set bridge domain br_default type vlan-aware
cumulus@switch:~$ nv set bridge domain br_default vlan 10-30
cumulus@switch:~$ nv set bridge domain br_default vlan 10 ptp enable on
cumulus@switch:~$ nv set interface vlan10 type svi
cumulus@switch:~$ nv set interface vlan10 ip address 10.1.10.2/24
cumulus@switch:~$ nv set interface vlan10 base-interface br_default
cumulus@switch:~$ nv set interface swp2 bridge domain br_default
cumulus@switch:~$ nv set interface swp2 bridge domain br_default access 10
cumulus@switch:~$ nv set interface swp2 ptp enable on
cumulus@switch:~$ nv config apply

1. 配置 NVUE 以停止管理 PTP 配置文件

cumulus@switch:~$ nv set system config apply ignore /etc/linuxptp/phc2sys.conf
cumulus@switch:~$ nv set system config apply ignore /etc/ptp4l.conf
cumulus@switch:~$ nv set system config apply ignore /etc/cumulus/switchd.d/ptp.conf
cumulus@switch:~$ nv config apply

2. 编辑 /etc/cumulus/switchd.d/ptp.conf 文件，将 ptp.timestamping 参数设置为 TRUE

   cumulus@switch:~$ sudo nano /etc/cumulus/switchd.d/ptp.conf
   ...
   ptp.timestamping     TRUE
   ...
   

3. 重启 switchd 服务

   cumulus@switch:~$ sudo systemctl restart switchd.service
   

4. 编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，以配置您要用于 PTP 的交换机上的接口。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
#
# Default interface options
#
time_stamping                  hardware
# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.
[swp1]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E
[swp2]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E

[swp1]
l2_mode                 trunk
vlan_intf               vlan10
src_ip                  10.1.10.2
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E
network_transport       RAWUDPv4

[swp2]
l2_mode                 access
vlan_intf               vlan10
src_ip                  10.1.10.2
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E
network_transport       RAWUDPv4

5. 编辑 /etc/linuxptp/phc2sys.conf 文件以添加以下参数

   cumulus@switch:~$ sudo nano /etc/linuxptp/phc2sys.conf
   # phc2sys is enabled
   [global]
   logging_level         6
   path_trace_enabled    0
   use_syslog            1
   verbose               0
   domainNumber          0
   

6. 启用并启动 ptp4l 和 phc2sys 服务

   cumulus@switch:~$ sudo systemctl enable ptp4l.service phc2sys.service
   cumulus@switch:~$ sudo systemctl start ptp4l.service phc2sys.service
   

cumulus@switch:~$ nv set service ptp 1 domain 3
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default Data Set 部分以更改 domainNumber 设置，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               128
priority2               128
domainNumber            3
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

以下示例命令在未设置配置文件时配置单步模式

cumulus@switch:~$ nv set service ptp 1 two-step off
cumulus@switch:~$ nv config apply

要将时钟时间戳模式恢复为默认设置（双步模式），请运行 nv set service ptp 1 two-step on 命令。

要为基于 IEEE1588、ITU 8275-1 或 ITU 8275-2 的自定义配置文件设置时钟时间戳模式，请运行 nv set service ptp <instance-id> profile <profile-id> two-step 命令。例如，要为名为 CUSTOM1 的自定义配置文件设置单步模式，请运行 nv set service ptp 1 profile CUSTOM1 two-step off 命令。

编辑 /etc/ptp4l.conf 文件的 Default Data Set 部分，将 twoStepFlag 设置更改为 0，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               254
priority2               254
domainNumber            3

twoStepFlag             0
dscp_event              43
dscp_general            43
udp6_scope              0x0E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要将时钟时间戳模式恢复为默认设置（双步模式），请将 twoStepFlag 设置更改为 1。

cumulus@switch:~$ nv set service ptp 1 priority1 200
cumulus@switch:~$ nv set service ptp 1 priority2 200
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default Data Set 部分以更改 priority1 和/或 priority2 设置，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               200
priority2               200
domainNumber            3
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

以下示例启用 PTP，将配置文件设置为 default-itu-8275-1，启用 SyncE，在 swp3 上启用 PTP，并启用噪声传递伺服。

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set service ptp 1 current-profile default-itu-8275-1
cumulus@switch:~$ nv set system synce enable on
cumulus@switch:~$ nv set interface swp3 ptp enable on
cumulus@switch:~$ nv set service ptp 1 servo noise-transfer
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 和 /etc/firefly_servo/servo.conf 文件；请参阅以下示例。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly                      0
free_running                   1
slave_event_monitor            /var/run/servo_slave_event_monitor
priority1                      128
priority2                      128
domainNumber                   24

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
network_transport              L2
dataset_comparison             G.8275.x
G.8275.defaultDS.localPriority 128
ptp_dst_mac                    01:80:C2:00:00:0E
#
# Port Data Set
#
logAnnounceInterval            -3
logSyncInterval                -4
logMinDelayReqInterval         -4
announceReceiptTimeout         3
delay_mechanism                E2E
 
offset_from_master_min_threshold   -50
offset_from_master_max_threshold   50
mean_path_delay_threshold          200
tsmonitor_num_ts                   100
tsmonitor_num_log_sets             2
tsmonitor_num_log_entries          4
tsmonitor_log_wait_seconds         1
#
# Run time options
#
logging_level                  6
path_trace_enabled             0
use_syslog                     1
verbose                        0
summary_interval               0
#
# servo parameters
#
pi_proportional_const          0.000000
pi_integral_const              0.000000
pi_proportional_scale          0.700000
pi_proportional_exponent       -0.300000
pi_proportional_norm_max       0.700000
pi_integral_scale              0.300000
pi_integral_exponent           0.400000
pi_integral_norm_max           0.300000
first_step_threshold           0.000020
step_threshold                 0.000000025
servo_offset_threshold         20
servo_num_offset_values        10
write_phase_mode               1
max_frequency                  50000000
sanity_freq_limit              0
#
# Default interface options
#
time_stamping                  hardware

[swp3]
udp_ttl                      1
masterOnly                   0
delay_mechanism              E2E

cumulus@switch:~$ sudo nano /etc/firefly_servo/servo.conf
[global]
free_running                        0
domainNumber                        24

offset_from_master_min_threshold    -50
offset_from_master_max_threshold    50

# Debugging & Logging
doca_logging_level                  50

init_max_time_adjustment            0
max_time_adjustment                 1500
hold_over_timer                     0
# Sampling Window & servo logic
servo_window_timer                  3000
servo_window_min_samples            10
servo_num_offset_values             5

要禁用源端口 ID 检查，请运行 nv set service ptp 1 ignore-source-id on 命令

cumulus@switch:~$ nv set service ptp 1 ignore-source-id on
cumulus@switch:~$ nv config apply

要重新启用源端口 ID 检查，请运行 nv set service ptp 1 ignore-source-id off 命令。

要禁用源端口 ID 检查，请编辑 /etc/ptp4l.conf 文件以添加 ignore_source_id 1 参数，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   0
ignore_source_id               1
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要将多播 MAC 地址设置为非转发

cumulus@switch:~$ nv set service ptp 1 multicast-mac non-forwarding
cumulus@switch:~$ nv config apply

要将多播 MAC 地址设置为转发，请运行 nv unset service ptp 1 multicast-mac non-forwarding 命令。

要将多播 MAC 地址设置为非转发，请编辑 /etc/ptp4l.conf 文件以添加 ptp_dst_mac 参数，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
#
# Run time options
#
logging_level                  6
path_trace_enabled             0
use_syslog                     1
verbose                        0
summary_interval               0
ptp_dst_mac                    01:80:C2:00:00:0E

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set service ptp 1 ip-dscp 22
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default Data Set 部分，以更改触发从时钟读取时间戳的 PTP 消息的 dscp_event 设置，以及携带命令、响应、信息或时间戳的 PTP 消息的 dscp_general 设置。

保存 /etc/ptp4l.conf 文件后，重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               200
priority2               200
domainNumber            3

twoStepFlag             1
dscp_event              22
dscp_general            22
udp6_scope              0x0E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp transport ipv6
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，以更改接口的 network_transport 设置，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E
network_transport       RAWUDPv6

[swp2]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E
network_transport       RAWUDPv6
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp mixed-multicast-unicast on
cumulus@switch:~$ nv config apply

要将 swp1 上的消息模式改回默认的多播设置

cumulus@switch:~$ nv set interface swp1 ptp mixed-multicast-unicast off
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，在接口下添加 hybrid_e2e 1 行，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
hybrid_e2e              1
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要将消息模式改回默认的多播设置，请删除接口下的 hybrid_e2e 行，然后重启 ptp4l 服务。

以下示例将 swp1 上连续 Announce 消息之间的 announce 间隔设置为 -1。

cumulus@switch:~$ nv set interface swp1 ptp timers announce-interval -1
cumulus@switch:~$ nv config apply

以下示例将 swp1 上多播消息的平均 sync-interval 设置为 -5。

cumulus@switch:~$ nv set interface swp1 ptp timers sync-interval -5
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分

• 要将 swp1 上连续 Announce 消息之间的 announce 间隔设置为 -1，请在接口节下添加 logAnnounceInterval -1。
• 要将 swp1 上多播消息的平均 sync-interval 设置为 -5，请在接口节下添加 logSyncInterval -5。

编辑 /etc/ptp4l.conf 文件后，重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
logAnnounceInterval     -1
logSyncInterval         -5
udp_ttl                 20
masterOnly              1
delay_mechanism         E2E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp forced-master on
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，以更改接口的 masterOnly 设置，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                 1
masterOnly              1
delay_mechanism         E2E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp ttl 20
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，以更改接口的 udp_ttl 设置，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                 20
masterOnly              1
delay_mechanism         E2E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp unicast-service-mode client
cumulus@switch:~$ nv config apply

1. 在 /etc/ptp4l.conf 文件的接口部分末尾添加以下行

   [unicast_master_table]
   table_id               3
   logQueryInterval       0
   RAWUDPv4                  100.100.100.1
   
   [swp1]
   table_id                1
   ...
   

2. 重启 ptp4l 服务。

   cumulus@switch:~$ sudo systemctl restart ptp4l.service
   

cumulus@switch:~$ nv set interface swp1 ptp unicast-service-mode server
cumulus@switch:~$ nv config apply

1. 在 /etc/ptp4l.conf 文件的接口部分末尾添加以下行

   [swp1]
   ...
   unicast_listen      1
   ...
   

2. 重启 ptp4l 服务。

   cumulus@switch:~$ sudo systemctl restart ptp4l.service
   

cumulus@switch:~$ nv set interface swp1 ptp unicast-master-table-id 1
cumulus@switch:~$ nv config apply

1. 在 /etc/ptp4l.conf 文件的接口部分末尾添加表 ID

   [swp1]
   ...
   table_id   1
   
   

2. 重启 ptp4l 服务。

   cumulus@switch:~$ sudo systemctl restart ptp4l.service
   

cumulus@switch:~$ nv set interface swp1 ptp unicast-request-duration 20
cumulus@switch:~$ nv config apply

1. 在 /etc/ptp4l.conf 文件的接口部分末尾添加 unicast_request_duration 参数

   [swp1]
   ...
   table_id   1
   unicast_request_duration 20
   

2. 重启 ptp4l 服务。

   cumulus@switch:~$ sudo systemctl restart ptp4l.service
   

• 要设置 ITU 8275.1 配置文件，请运行 nv set service ptp <instance-id> current-profile default-itu-8275-1 命令。
• 要设置 ITU 8275.2 配置文件，请运行 nv set service ptp <instance-id> current-profile default-itu-8275-2 命令。

以下示例将配置文件设置为 ITU 8275.1

cumulus@switch:~$ nv set service ptp 1 current-profile default-itu-8275-1
cumulus@switch:~$ nv config apply

要设置 IEEE 1588 配置文件

cumulus@switch:~$ nv set service ptp 1 current-profile default-1588
cumulus@switch:~$ nv config apply

要设置预定义的 ITU 8275.1 配置文件，请编辑 /etc/ptp4l.conf 文件并设置如下所示的参数，然后重启 ptp4l 服务

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
...
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   24

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
dataset_comparison             G.8275.x
G.8275.defaultDS.localPriority 128
ptp_dst_mac                    01:80:C2:00:00:0E
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要设置预定义的 ITU 8275.2 配置文件，请编辑 /etc/ptp4l.conf 文件并设置如下所示的参数，然后重启 ptp4l 服务

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
...
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   24

twoStepFlag                    1 
dscp_event                     46
dscp_general                   46
network_transport              RAWUDPv4
dataset_comparison             G.8275.x
G.8275.defaultDS.localPriority 128
hybrid_e2e                     1
inhibit_multicast_service      1
unicast_listen                 1
unicast_req_duration           60
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要使用预定义的 IEEE 1588 配置文件，请编辑 /etc/ptp4l.conf 文件并设置如下所示的参数，然后重启 ptp4l 服务

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   0

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
network_transport              RAWUDPv4
dataset_comparison             ieee1588
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

• 创建配置文件名称。
• 设置新配置文件所基于的配置文件类型（itu-g-8275-1 itu-g-8275-2 或 ieee-1588）。
• 更新您要更改的任何配置文件设置（announce-interval、delay-req-interval、priority1、sync-interval、announce-timeout、domain、priority2、transport、delay-mechanism、local-priority）。
• 将自定义配置文件设置为当前配置文件。

以下示例命令基于预定义的 ITU 8275-1 配置文件创建名为 CUSTOM1 的自定义配置文件。这些命令将 domain 设置为 28，将 announce-timeout 设置为 3，然后将 CUSTOM1 设置为当前配置文件

cumulus@switch:~$  nv set service ptp 1 profile CUSTOM1 
cumulus@switch:~$  nv set service ptp 1 profile CUSTOM1 profile-type itu-g-8275-1  
cumulus@switch:~$  nv set service ptp 1 profile CUSTOM1 domain 28
cumulus@switch:~$  nv set service ptp 1 profile CUSTOM1 announce-timeout 3
cumulus@switch:~$  nv set service ptp 1 current-profile CUSTOM1
cumulus@switch:~$  nv config apply

以下示例 /etc/ptp4l.conf 文件基于预定义的 ITU 8275-1 配置文件创建一个自定义配置文件，并将 domain 设置为 28，将 announce-timeout 设置为 3。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   28

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
network_transport              L2
dataset_comparison             G.8275.x
G.8275.defaultDS.localPriority 128
ptp_dst_mac                    01:80:C2:00:00:0E

#
# Port Data Set
#
logAnnounceInterval            5
logSyncInterval                -4
logMinDelayReqInterval         -4
announceReceiptTimeout         3
delay_mechanism                E2E

offset_from_master_min_threshold   -50
offset_from_master_max_threshold   50
mean_path_delay_threshold          200
tsmonitor_num_ts                   100
tsmonitor_num_log_sets             3
tsmonitor_num_log_entries          4
tsmonitor_log_wait_seconds         1

#
# Run time options
#
logging_level                  6
path_trace_enabled             0
use_syslog                     1
verbose                        0
summary_interval               0

#
# servo parameters
#
pi_proportional_const          0.000000
pi_integral_const              0.000000
pi_proportional_scale          0.700000
pi_proportional_exponent       -0.300000
pi_proportional_norm_max       0.700000
pi_integral_scale              0.300000
pi_integral_exponent           0.400000
pi_integral_norm_max           0.300000
step_threshold                 0.000002
first_step_threshold           0.000020
max_frequency                  900000000
sanity_freq_limit              0

#
# Default interface options
#
time_stamping                  hardware


# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E

[swp2]
udp_ttl                 1
masterOnly              0
delay_mechanism         E2E

cumulus@switch:~$ sudo systemctl restart ptp4l.service

以下示例命令设置

• 基于 ITU 8275-2 的名为 CUSTOM1 的自定义配置文件的本地优先级为 10。
• 基于 ITU 8275-2 的名为 CUSTOM1 的自定义配置文件的时钟本地优先级为 100。

cumulus@switch:~$ nv set service ptp 1 profile CUSTOM1 local-priority 10
cumulus@switch:~$ nv set service ptp 1 profile CUSTOM1 clock-local-priority 100
cumulus@switch:~$ nv config apply

将 G.8275.portDS.localPriority（本地优先级）选项和 G.8275.defaultDS.localPriority（时钟本地优先级）选项添加到 /etc/ptp4l.conf 文件的 Global 部分，然后重启 ptp4l 服务。

以下示例设置

• 本地优先级为 10。
• 时钟本地优先级为 100。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   28

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
network_transport              L2
dataset_comparison             G.8275.x
G.8275.defaultDS.localPriority 100
G.8275.portDS.localPriority    10
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set interface swp1 ptp 1 local-priority 120
cumulus@switch:~$ nv config apply

将 G.8275.portDS.localPriority 选项添加到 /etc/ptp4l.conf 文件的 interface 部分，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
[swp1]
udp_ttl                      1
hybrid_e2e                   1
masterOnly                   0
delay_mechanism              E2E
network_transport            RAWUDPv6
G.8275.portDS.localPriority  120
...

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set service ptp 1 acceptable-master 24:8a:07:ff:fe:f4:16:06
cumulus@switch:~$ nv config apply

您还可以为 Grand Master 配置备用优先级 1 值

cumulus@switch:~$ nv set service ptp 1 acceptable-master 24:8a:07:ff:fe:f4:16:06 alt-priority 2

要为 swp1 启用 PTP 可接受主时钟表选项

cumulus@switch:~$ nv set interface swp1 ptp acceptable-master on
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件的 Default interface options 部分，以添加 acceptable_master_clockIdentity 248a07.fffe.f41606。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
#
# Default interface options
#
time_stamping           hardware


[acceptable_master_table]
maxTableSize 16
acceptable_master_clockIdentity 248a07.fffe.f41606
...

您还可以为 Grand Master 配置备用优先级 1 值。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
#
# Default interface options
#
time_stamping           hardware


[acceptable_master_table]
maxTableSize 16
acceptable_master_clockIdentity 248a07.fffe.f41606 2

要为 swp1 启用 PTP 可接受主时钟表选项，请在 [swp1] 下添加 acceptable_master on。

...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                 20
masterOnly              1
delay_mechanism         E2E
acceptable_master       on
...

重启 ptp4l 服务

cumulus@switch:~$ sudo systemctl restart ptp4l.service

以下示例将最小偏移阈值设置为 -1000，最大偏移阈值设置为 1000，路径延迟阈值设置为 300

cumulus@switch:~$ nv set service ptp 1 monitor min-offset-threshold -1000
cumulus@switch:~$ nv set service ptp 1 monitor max-offset-threshold 1000
cumulus@switch:~$ nv set service ptp 1 monitor path-delay-threshold 300
cumulus@switch:~$ nv config apply

您可以在 /etc/ptp4l.conf 文件中手动配置以下监控设置。请务必运行 sudo systemctl restart ptp4l.service 以应用设置。

以下示例将最小偏移阈值设置为 -1000，最大偏移阈值设置为 1000，路径延迟阈值设置为 300

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               128
priority2               128
domainNumber            0

twoStepFlag             1
dscp_event              46
dscp_general            46

offset_from_master_min_threshold   -1000
offset_from_master_max_threshold   1000
mean_path_delay_threshold          300
...

以下示例将允许的最大日志集数设置为 4，将允许的最大日志条目数设置为 6，并将违规日志间隔设置为 10

cumulus@switch:~$ nv set service ptp 1 monitor max-violation-log-sets 4
cumulus@switch:~$ nv set service ptp 1 monitor max-violation-log-entries 6
cumulus@switch:~$ nv set service ptp 1 monitor violation-log-interval 10
cumulus@switch:~$ nv config apply

您可以在 /etc/ptp4l.conf 文件中手动配置以下监控设置。请务必运行 sudo systemctl restart ptp4l.service 以应用设置。

以下示例将允许的最大日志集数设置为 4，将允许的最大日志条目数设置为 6，并将违规日志间隔设置为 10

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
[global]
#
# Default Data Set
#
slaveOnly               0
priority1               128
priority2               128
domainNumber            0

twoStepFlag             1
dscp_event              46
dscp_general            46

offset_from_master_min_threshold   -50
offset_from_master_max_threshold   50
mean_path_delay_threshold          300
tsmonitor_num_ts                   100
tsmonitor_num_log_sets             4
tsmonitor_num_log_entries          6
tsmonitor_log_wait_seconds         10
...

cumulus@switch:~$ nv unset interface swp1 ptp
cumulus@switch:~$ nv unset interface swp2 ptp
cumulus@switch:~$ nv unset interface swp3 ptp
cumulus@switch:~$ nv config apply

编辑 /etc/ptp4l.conf 文件以从 Default interface options 部分删除接口，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
# Default interface options
#
time_stamping           hardware

# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

cumulus@switch:~$ sudo systemctl restart ptp4l.service

cumulus@switch:~$ nv set service ptp 1 enable off
cumulus@switch:~$ nv config apply

cumulus@switch:~$ sudo systemctl stop ptp4l.service phc2sys.service
cumulus@switch:~$ sudo systemctl disable ptp4l.service phc2sys.service

cumulus@switch:~$ nv set service ptp 1 enable on
cumulus@switch:~$ nv set service ptp 1 priority2 254
cumulus@switch:~$ nv set service ptp 1 priority1 254
cumulus@switch:~$ nv set service ptp 1 domain 3
cumulus@switch:~$ nv set interface swp1 ptp enable on
cumulus@switch:~$ nv set interface swp2 ptp enable on
cumulus@switch:~$ nv set interface swp3 ptp enable on
cumulus@switch:~$ nv set interface swp4 ptp enable on
cumulus@switch:~$ nv config apply

cumulus@switch:~$ sudo cat /etc/nvue.d/startup.yaml
- set:
    interface:
      lo:
        ip:
          address:
            10.10.10.1/32: {}
        type: loopback
      swp1:
        ptp:
          enable: on
        type: swp
      swp2:
        ptp:
          enable: on
        type: swp
      swp3:
        ptp:
          enable: on
        type: swp
      swp4:
        ptp:
          enable: on
        type: swp
    service:
      ptp:
        '1':
          domain: 3
          enable: on
          priority1: 254
          priority2: 254

cumulus@switch:~$ sudo cat /etc/ptp4l.conf
...
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      254
priority2                      254
domainNumber                   3

twoStepFlag                    1
dscp_event                     46
dscp_general                   46

offset_from_master_min_threshold   -50
offset_from_master_max_threshold   50
mean_path_delay_threshold          200
tsmonitor_num_ts                   100
tsmonitor_num_log_sets             2
tsmonitor_num_log_entries          4
tsmonitor_log_wait_seconds         1

#
# Run time options
#
logging_level                  6
path_trace_enabled             0
use_syslog                     1
verbose                        0
summary_interval               0

#
# servo parameters
#
pi_proportional_const          0.000000
pi_integral_const              0.000000
pi_proportional_scale          0.700000
pi_proportional_exponent       -0.300000
pi_proportional_norm_max       0.700000
pi_integral_scale              0.300000
pi_integral_exponent           0.400000
pi_integral_norm_max           0.300000
step_threshold                 0.000002
first_step_threshold           0.000020
max_frequency                  900000000
sanity_freq_limit              0

#
# Default interface options
#
time_stamping                  hardware


# Interfaces in which ptp should be enabled
# these interfaces should be routed ports
# if an interface does not have an ip address
# the ptp4l will not work as expected.

[swp1]
udp_ttl                      1
masterOnly                   0
delay_mechanism              E2E
network_transport            RAWUDPv4

[swp2]
udp_ttl                      1
masterOnly                   0
delay_mechanism              E2E
network_transport            RAWUDPv4

[swp3]
udp_ttl                      1
masterOnly                   0
delay_mechanism              E2E
network_transport            RAWUDPv4

[swp4]
udp_ttl                      1
masterOnly                   0
delay_mechanism              E2E
network_transport            RAWUDPv4

cumulus@switch:~$ nv set service ptp 1 force-version 2.0
cumulus@switch:~$ nv config apply

要将次要 PTP 版本设置回默认值，请运行 nv unset service ptp 1 force-version 命令。

编辑 /etc/ptp4l.conf 文件以将 ptp_minor_version 0 添加到 Global 部分，然后重启 ptp4l 服务。

cumulus@switch:~$ sudo nano /etc/ptp4l.conf
...
[global]
#
# Default Data Set
#
slaveOnly                      0
priority1                      128
priority2                      128
domainNumber                   0

twoStepFlag                    1
dscp_event                     46
dscp_general                   46
ptp_minor_version              0

cumulus@switch:~$ sudo systemctl restart ptp4l.service

要将次要 PTP 版本设置回默认值 (1)，请从 /etc/ptp4l.conf 文件的 Global 部分删除 ptp_minor_version 0，然后重启 ptp4l 服务。

对于您要设置流量整形的每个启用 PTP 的端口，运行 nv set interface <interface> ptp shaper enable on 命令。

cumulus@switch:~$ nv set interface swp1 ptp shaper enable on
cumulus@switch:~$ nv set interface swp2 ptp shaper enable on
cumulus@switch:~$ nv config apply

要查看接口的 PTP 整形设置，请运行 nv show interface <interface> ptp shaper 命令

cumulus@switch:~$ nv show interface swp1 ptp shaper
        operational  applied  
------  -----------  -------  
enable               on   

在 /etc/cumulus/switchd.d/ptp_shaper.conf 文件中，为您要应用流量整形的接口设置以下参数，并启用流量整形器。您必须重新加载 switchd 才能使更改生效。

cumulus@switch:~$ sudo nano /etc/cumulus/switchd.d/ptp_shaper.conf
## Per-port configuration for PTP shaper
ptp_shaper.port_group_list = [enable-group]
ptp_shaper.enable-group.port_set = swp1,swp2
ptp_shaper.enable-group.ptp_shaper_enable = true

cumulus@switch:~$ sudo systemctl reload switchd.service