Clock Synchronization Operational Commands
Validating the Configurations Using the ufi-ptp-cli Shell
To validate the configuration, use the ufi-ptp-cli shell as shown in the following example.
This example displays the output of the show ptp clock info command, detailing the PTP clock’s configuration. It includes information such as the clock identity, profile type (G.8275.1), clock type (Time Slave Clock), and various PTP interval settings.
supervisor@rtbrick>rtbrick.net:~ $ ufi-ptp-cli Check UFI PTP Service Status ... Ready. Read configuration successfully Build On Jun 3 2025 02:14:45 ufi-ptp> enable ufi-ptp# show ptp clock info Clock Identity : 5C:07:58:A2:CE:5C:00:01 Profile : G.8275.1 profile Clock Type : Time Slave Clock Servo Alg : Full-On-Path Number Of Ports : 32 Clock Class : 255 Domain Number : 24 Scaled Log Variance : 0xFFFF Priority1 : 128 Priority2 : 255 Slave Only : True Two Step : False Announce Receipt Timeout (min) : 3 Announce Receipt Timeout (def) : 3 Announce Receipt Timeout (max) : 10 Log Announce Interval (min) : -3 Log Announce Interval (def) : -3 Log Announce Interval (max) : -3 Log Sync Interval (min) : -4 Log Sync Interval (def) : -4 Log Sync Interval (max) : -4 Log Min Delay Req Interval (min) : -4 Log Min Delay Req Interval (def) : -4 Log Min Delay Req Interval (max) : -4 Domain # (min) : 24 Domain # (def) : 24 Domain # (max) : 43 Priority 1 : 128 Priority 2 (min) : 0 Priority 2 (def) : 128 Priority 2 (max) : 225 Local Priority : 128
This example displays the output of the show ptp port 67 peer command, detailing PTP packet statistics for peer 0 on Port 67. It provides counts of various received and transmitted PTP messages, such as Sync, Delay Request, Delay Response, and Announce messages.
ufi-ptp# show ptp port 9 peer Port 9: Peer #0 L2 address : D8:3A:DD:AA:4D:9D Clock Identity : D8:3A:00:FF:FE:AA:4D:9D Received Sync : 138913 Received Delay Request : 0 Received Delay Response : 138904 Received Peer Delay Request : 0 Received Peer Delay Response : 0 Received Followup : 138913 Received Peer Delay Followup : 0 Received Announce : 69457 Received Signalling : 0 Received Management : 0 Transmitted Sync : 0 Transmitted Delay Request : 138904 Transmitted Delay Response : 0 Transmitted Peer Delay Request : 0 Transmitted Peer Delay Response : 0 Transmitted Followup : 0 Transmitted Peer Delay Followup : 0 Transmitted Announce : 0 Transmitted Signalling : 0 Transmitted Management : 0
The show ptp port 67 master command output displays that port 67 has one PTP master identified as E1:C1:1A:G5:L2:15.
ufi-ptp# show ptp port 67 master Port 67: Master #0 : E1:C1:1A:G5:L2:15 ufi-ptp#
PTP Show CLIs
show ptp clock-info
This command displays detailed information about the PTP clock running on the device.
Syntax:
This example displays detailed information about the PTP clock. Key details include the clock identifier, profile (g8275.1), clock type (Slave Clock), domain number, and various PTP interval settings.
supervisor@rtbrick>switch: op> show ptp clock-info Clock Identifier 5c:07:58:a2:ce:5c:00:01 Profile g8275.1 Clock Type Slave Clock Max Number of Ports 32 Clock Class 255 Domain Number 24 Scaled Log Variance 0xFFFF Priority1 128 Priority2 255 Slave Only True Announce Receipt Timeout (Min) 3 Announce Receipt Timeout (Def) 3 Announce Receipt Timeout (Max) 10 Log Announce Interval (Min) -3 Log Announce Interval (Def) -3 Log Announce Interval (Max) -3 Log Sync Interval (Min) -4 Log Sync Interval (Def) -4 Log Sync Interval (Max) -4 Log Delay Req Interval (Min) -4 Log Delay Req Interval (Def) -4 Log Delay Req Interval (Max) -4 Domain Min 24 Domain Default 24 Domain Max 43 Priority2 Min 0 Priority2 Default 128 Priority2 Max 225 Local Priority 128
show ptp peer
This command displays detailed information about the PTP peers discovered on the interface ifp-0/1/61.
Syntax:
| Option | Description |
|---|---|
- |
Without any option, the commands displays the PTP peer information for all interfaces. |
<interface> |
Displays the PTP peer information for the specified interface. |
This example displays the output of the show ptp peer command for interface ifp-0/1/8. It details information about a PTP peer, including its address, clock ID, port state (Uncalibrated), and counts of various PTP messages received and transmitted.
supervisor@rtbrick>ufi16.q2c.u13.r5.nbg.rtbrick.net: cfg> show ptp peer ifp-0/1/8 Peer Address d8:3a:dd:aa:4d:9d Clock ID d8:3a:00:ff:fe:aa:4d:9d Mode 0 Port State Uncalibrated Mean Path Delay 386 Log Announce Interval -3 Log Sync Interval -4 Log Delay Req Interval -4 Rx Sync 19209 Rx Delay Req 0 Rx Delay Resp 19199 Rx Follow Up 19209 Rx PDelay Follow Up 0 Rx Announce 9605 Rx Signalling 0 Rx Management 0 Tx Sync 0 Tx Delay Req 19199 Tx Delay Resp 0 Tx Follow Up 0 Tx PDelay Follow Up 0 Tx Announce 0 Tx Signalling 0 Tx Management 0
This example displays the output of the show ptp peer interface ifp-0/1/61 command, providing details about a PTP peer on interface ifp-0/1/61. It includes the peer’s address and clock ID, its "Uncalibrated" port state, and various counts of PTP messages received and transmitted.
supervisor@rtbrick>switch: op> show ptp peer interface ifp-0/1/8 ifp-0/1/8 Peer Address d8:3a:dd:aa:4d:9d Clock ID d8:3a:00:ff:fe:aa:4d:9d Port State Uncalibrated Mean Path Delay 627 Mode 0 Log Announce Interval -3 Log Sync Interval -4 Log Delay Req Interval -4 Rx Sync 17287 Rx Delay Req 0 Rx Delay Resp 17278 Rx Follow Up 17287 Rx PDelay Follow Up 0 Rx Announce 8644 Rx Signalling 0 Rx Management 0 Tx Sync 0 Tx Delay Req 17278 Tx Delay Resp 0 Tx Follow Up 0 Tx PDelay Follow Up 0 Tx Announce 0 Tx Signalling 0 Tx Management 0
show ptp servo
This command displays the status and configuration of the PTP servo mechanism on a device. The servo is a critical component in PTP that adjusts the local clock to synchronize with a master clock.
Syntax:
This example displays the output of the show ptp servo command, providing the PTP servo statistics for Clock 0. It details the servo’s configuration, current state ("Frequency Locked"), lock status ("Locked"), and various correction and packet rate values.
supervisor@rtbrick>switch: op> show ptp servo Servo Stat for Clock 0 Servo Config Freq + Phase Correction Servo State Frequency Locked Servo State Duration 0:14:25 Lock Status Locked APTS Mode N/A Frequency Correction 58.000000 ppb Phase Correction -294750000.000000 nsec Offset From Master -4294622349.000000 nsec Mean Path Delay 384.000000 nsec APTS GPS to PTP Offset N/A Sync Packet Rate 16 Delay Packet Rate 16
show ptp statistics
This command displays the PTP packet statistics for a device.
Syntax:
| Option | Description |
|---|---|
- |
Without any option, the commands displays the PTP packet statistics for all interfaces. |
<interface> |
Displays the PTP packet statistics for the specified interface. |
This example displays the output of the show ptp statistics command, detailing both global and interface-specific (ifp-0/1/61) PTP packet transmission, reception, and discard counts.
supervisor@rtbrick>switch: op> show ptp statistics PTP statistics Tx 20160 Rx 70583 Discarded 20 ifp-0/1/8 Tx 20160 Rx 70583 Discarded 20
The example displays PTP packet statistics for interface ifp-0/1/8, showing 21601 packets transmitted, 75626 received, and 20 discarded.
supervisor@rtbrick>switch: op> show ptp statistics interface ifp-0/1/8 ifp-0/1/8 Tx 21601 Rx 75626 Discarded 20