- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
05-PTP commands | 270.17 KB |
display ptp foreign-masters-record
ptp alarm-threshold { time-lock | time-unlock }
ptp alarm-threshold clock-source-class
ptp alarm-threshold time-offset
ptp alarm-threshold time-offset-sum pk-pk
PTP commands
display ptp clock
Use display ptp clock to display PTP clock information.
Syntax
display ptp clock
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The PTP clock information is display only after you have specified a PTP profile, a PTP mode, and a PTP domain.
Examples
# Display PTP clock information.
<Sysname> display ptp clock
PTP profile : IEEE 1588 Version 2
PTP mode : BC
Slave only : No
Sync uncertain : Disabled
Clock state : Disabled
Clock ID : AD0000-FFFE-000000
Clock type : Local
Clock domain : 1
Number of PTP ports : 0
Priority1 : 128
Priority2 : 128
Clock quality :
Class : 248
Accuracy : 254
Offset (log variance) : 65535
Offset from master : 0 (ns)
Mean path delay : 0 (ns)
Steps removed : 0
Local clock time : Mon Jul 6 12:30:08 2020
Clock source info:
Clock Pri1 Pri2 Accuracy Class TimeSrc Direction In-Status Offset(log variance)
------------------------------------------------------------------
Local 128 128 254 248 160 N/A N/A 65535
ToD0 128 128 32 6 32 N/A Inactive 65535
ToD1 128 128 32 6 32 N/A Inactive 65535
Field |
Description |
PTP global state |
Whether PTP is enabled globally: · Enabled. · Disabled. |
PTP profile |
PTP standard: · IEEE 1588 version 2. · IEEE 802.1AS. · SMPTE ST 2059-2. · AES67-2015. · ITU-T G.8275.1. · ITU-T G.8275.2. |
PTP mode |
Clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC. · T-BC. · T-TC. · T-TSC. · T-BC-P. · T-TSC-P. |
Slave only |
Whether the OC operates in Slave only mode: · Yes. · No. |
Sync uncertain |
Whether the device is enabled to notify the downstream nodes of its time synchronization state: · Disabled. · Enabled. |
Clock state |
PTP clock state: · Disabled—The PTP clock state feature is disabled. · Free-Run—The PTP clock has never been synchronized to a time source and is not in the process of synchronizing to a time source. · Acquiring—The PTP clock is in the process of synchronizing to a time source. · Locked—The PTP clock has been synchronized to a time source. · Holdover—The PTP clock is in holdover state. |
Clock ID |
Clock ID for the device, which uniquely identifies a PTP device. |
Clock type |
Clock type of the device: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock. |
ToD delay time |
Delay correction value in nanoseconds for the ToD clock. This field is not displayed when the device is a local clock. |
Clock domain |
PTP domain where the device resides. |
Priority1 |
Priority 1 value for the device. |
Priority2 |
Priority 2 value for the device. |
Class |
Time class of the device. |
Accuracy |
Time accuracy of the device. |
Offset (log variance) |
Offset of the grandmaster clock. |
Offset from master |
Offset from the master clock node (parent clock node), in nanoseconds. N/A indicates that information for this field is not obtained. |
Mean path delay |
Mean path delay, in nanoseconds. N/A indicates that information for this field is not obtained. |
Steps removed |
Hops from the grandmaster to the local clock node. N/A indicates that information for this field is not obtained. |
Clock source info |
Information about the clock source. |
Clock |
Clock source type: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock. |
Pri1 |
Priority 1 value of the clock source. |
Pri2 |
Priority 2 value of the clock source. |
LP |
Local priority of the clock source. (This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.) |
TimeSrc |
Time source of the clock source. |
Direction |
For a local clock source, this field displays N/A. For a ToD clock source, the values include: · IN—The device receives clock signals. · Out—The device transmits clock signals. · N/A—The device does not receive or transmit clock signals. |
In-Status |
For a local clock source, this field displays N/A. For a ToD clock source, this field indicates whether the clock source is active: · Active. · Inactive. |
display ptp corrections
Use display ptp corrections to display PTP corrections that have occurred on a subordinate port.
Syntax
display ptp corrections
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The PTP corrections are displayed only when the following conditions are met:
· You have specified a PTP profile, PTP mode, and PTP domain for the device.
· The device has a subordinate port and has performed time or frequency synchronization through the port.
If the subordinate port is changed, the recorded information will be cleared.
Examples
# Display PTP corrections that have occurred on a subordinate port.
<Sysname> display ptp corrections
Correction time Corrections(s,ns) Rate ratio Slave port
Mar 11 03:14:54 2019 0,74 0.999999973 WGE1/0/1
Mar 11 03:14:55 2019 -1,17 0.999999980 WGE1/0/1
Table 2 Command output
Field |
Description |
Correction time |
Time when the correction occurred. |
Corrections(s,ns) |
Time corrections in seconds or nanoseconds. N/A indicates that no correction occurred this time. |
Rate ratio |
Ratio of the subordinate port rate to the master port rate. N/A indicates that no correction occurred this time. |
Slave port |
Name of the subordinate port. |
display ptp foreign-masters-record
Use display ptp foreign-masters-record to display information about foreign master nodes.
Syntax
display ptp foreign-masters-record [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about foreign master nodes for all interfaces.
Usage guidelines
Foreign master node information is displayed only when the following conditions are met:
· The PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, AES67-2015, ITU-T G.8275.1, or ITU-T G.8275.2.
· You have specified a PTP mode and PTP domain for the device.
· The device has a port in slave, passive, or uncalibrated state.
Examples
# Display information about foreign master nodes for all interfaces.
<Sysname> display ptp foreign-masters-record
P1=Priority1, P2=Priority2, LP=LocalPriority, C=Class, A=Accuracy,
OSLV=Offset-scaled-log-variance, SR=Steps-removed
GM=Grandmaster
-------------------- --- --- --- --- --- ------ --- --- -----------------------
Clock ID P1 P2 LP C A OSLV SR GM Interface
-------------------- --- --- --- --- --- ------ --- --- -----------------------
62214E-FFFE-B20100 128 128 N/A 248 254 65535 0 Yes WGE1/0/1
Table 3 Command output
Field |
Description |
Interface |
PTP interface name. |
Clock ID |
Clock ID of the foreign master node. |
LP |
Local priority of the interface. It will be used as the local priority of the peer node in BMC selection. (This field is available only for the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile.) The value is N/A if the device does not support this configuration. |
C |
Time class. |
A |
Time accuracy. |
OSLV |
Offset of the grandmaster clock. |
SR |
Hops from the grandmaster to the local clock node. |
GM |
Whether the node represents the grandmaster clock: · Yes. · No. |
display ptp interface
Use display ptp interface to display PTP running information for one or all PTP interfaces.
Syntax
display ptp interface [ interface-type interface-number ]
display ptp interface brief
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP running information for all PTP interfaces.
brief: Displays brief PTP running information for all interfaces. If you do not specify this keyword, this command displays detailed PTP running information for the specified PTP interface or all PTP interfaces.
Usage guidelines
The detailed PTP running information can be displayed only if you enable PTP on the interface. The brief PTP running information can be displayed only when PTP is operating on the interface.
Examples
# Display brief PTP running information for all PTP interfaces.
<Sysname> display ptp interface brief
State Delay mechanism Clock step Asymmetry correction Name
Slave E2E Two 0 WGE1/0/1
Passive E2E Two 0 WGE1/0/2
# Display detailed PTP running information for Twenty-FiveGigE 1/0/1.
<Sysname> display ptp interface twenty-fivegige 1/0/1
Clock ID : 000FE2-FFFE-FF0000
Port number : 15
PTP version : 2
PTP enable : Enabled
Transport of PTP : User Datagram Protocol (IPv4)
Unicast destination address : 10.10.10.2
DSCP priority : 56
Port state : Slave
Force state : No
Clock step : Two
Asymmetry correction : 0
Delay mechanism : End to End
Announce interval (log mean) : 1
Announce receipt time out : 3
Sync interval (log mean) : 2
Delay request interval (log mean) : 2
Peer delay request interval (log mean) : 0
Mean path delay : 1357 (ns)
Table 4 Command output
Field |
Description |
State |
States of the PTP interface: · Slave—Receives synchronization messages. · Uncalibrated—Temporary state before the interface enters Slave state. · Passive—Neither receives nor sends synchronization messages. A PTP interface is in passive state after it receives an announce messages. · Master—Sends synchronization messages. · Premaster—Temporary state before the interface enters Master state. · Listening—Neither receives nor sends synchronization messages. A PTP interface is in listening state after being initialized. · Faulty—PTP is running incorrectly. A PTP interface in faulty state does not process PTP messages. · Disabled—PTP is not running on the interface. A PTP interface in disabled state does not process PTP messages. · Initializing—The interface is initializing. A PTP interface in initializing state does not process PTP messages. · N/A—No PTP interface state is obtained. |
Delay mechanism |
Delay measurement mechanism: · End to End—Request-response mechanism. · Peer to Peer—Peer delay mechanism. |
Clock step |
Mode for carrying timestamps: · One—Single-step mode. · Two—Two-step mode. |
Asymmetry correction |
Asymmetric delay correction value (in nanoseconds). |
Name |
Name of the PTP interface. |
Clock ID |
Clock ID of the device where the interface resides. |
PTP version |
PTP version number. The version number is always 2. |
PTP enable |
Whether PTP is enabled on the port: · Enabled. · Disabled. |
Transport of PTP |
PTP message transport protocol: · User Datagram Protocol (IPv4). · IEEE 802.3/Ethernet. |
Unicast destination address |
Destination IP address for unicast PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp unicast-destination command is not executed. |
Unicast negotiate port role |
This field is available only when the PTP profile is ITU-T G.8275.2. Role of the port for unicast negotiation. · Request-port. · Grant-port. This field displays Disabled when unicast negotiation is disabled on the port. |
DSCP priority |
DSCP value for PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp dscp command is not executed. |
VLAN |
VLAN ID for PTP messages. This field is not displayed if the ptp vlan command is not executed. |
Dot1p priority |
802.1p precedence for PTP messages. This field is not displayed if the ptp vlan command is not executed. |
Force state |
Whether the force state is configured: · Yes. · No. |
Announce interval (log mean) |
Announce message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent. |
Announce receipt time out |
Number of announcement intervals before the receiving node stops receiving announce messages. If a member node does not receive any announce message from the master node within the specified value, it considers the master node invalid. |
Sync interval (log mean) |
Sync message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent. |
Delay request interval (log mean) |
Minimum delay request message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent. |
Delay response interval (log mean) |
Delay response message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Peer delay request interval (log mean) |
Peer delay request message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent. |
Local priority |
Priority of the peer node. This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. |
NotSlave |
Whether or not the NotSlave feature is enabled. This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. |
Mean path delay |
Mean path delay, in nanoseconds. |
display ptp parent
Use display ptp parent to display information about the parent node (master node).
Syntax
display ptp parent
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The command does not display information about the parent node (master node) in any of the following circumstances:
· PTP profile, PTP mode, or PTP domain is not configured for the device.
· The clock node type of the device is TC or T-TC.
· The ptp active force-state command has been executed.
Examples
# Display information about the parent node.
<Sysname> display ptp parent
Parent clock:
Parent clock ID : 000FE2-FFFE-FF0005
Parent port number : 15
Observed parent offset (log variance) : N/A
Observed parent clock phase change rate : N/A
Grandmaster clock:
Grandmaster clock ID: 000FE2-FFFE-FF0000
Grandmaster clock quality:
Class : 248
Accuracy : 254
Offset (log variance) : 65535
Priority1 : 128
Priority2 : 128
Table 5 Command output
Field |
Description |
Parent port number |
Outgoing interface number of the parent clock. |
Observed parent offset (log variance) |
Offset from the parent clock node. N/A indicates that information for this field is not obtained. |
Class |
Time class of the grandmaster clock. |
Accuracy |
Time accuracy of the grandmaster clock. |
Offset (log variance) |
Offset of the grandmaster clock. |
Priority1 |
Priority 1 value of the grandmaster clock. |
Priority2 |
Priority 2 value of the grandmaster clock. |
display ptp path-trace
Use display ptp path-trace to display brief information about the PTP synchronization path from the GM to the device.
Syntax
display ptp path-trace
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command does not have an output if one of the following conditions exists:
· The PTP profile, PTP clock node type, or PTP domain is not configured.
· The clock node type is E2ETC, E2ETC-OC, P2PTC, P2PTC-OC, or T-TC.
· The ptp active force-state command has been configured.
Examples
# Display brief information about the PTP synchronization path from the GM to the device.
<Sysname> display ptp path-trace
Sequence number Clock ID
1 000FE2-FFFE-FF0000
2 000FE3-FFFE-F90000
3 000FE4-FFFE-F50000
4 000FE5-FFFE-F20000
5 000FE6-FFFE-F70000
Table 6 Command output
Field |
Description |
Sequence number |
Sequence number of the clock node. |
Clock ID |
ID of the clock node |
Related commands
ptp active force-state
ptp domain
ptp mode
ptp profile
display ptp statistics
Use display ptp statistics to display PTP statistics.
Syntax
display ptp statistics [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP statistics on all interfaces.
Usage guidelines
The command displays PTP statistics only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
Examples
# Display PTP statistics on Twenty-FiveGigE 1/0/1.
<Sysname> display ptp statistics interface twenty-fivegige 1/0/1
Received packets
--------------------------------------------------------------------------
Announce :0 Sync :0 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :0
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Sent packets
--------------------------------------------------------------------------
Announce :476 Sync :2543 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :2542
PdelayReq:238 PdelayResp:0 PdelayRespFollowUp :0
Discarded packets
--------------------------------------------------------------------------
Announce :0 Sync :0 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :0
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
# Display PTP statistics on all interfaces.
<Sysname> display ptp statistics
Interface : Twenty-FiveGigE1/0/1
Received packets
--------------------------------------------------------------------------
Announce :2353 Sync :4700 Signaling :0
DelayReq :0 DelayResp :4450 FollowUp :4700
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Sent packets
--------------------------------------------------------------------------
Announce :8 Sync :14 Signaling :0
DelayReq :4450 DelayResp :0 FollowUp :14
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Discarded packets
--------------------------------------------------------------------------
Announce :0 Sync :4 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :4
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Table 7 Command output
Field |
Description |
Received packets |
Statistics about received PTP messages. |
Sent packets |
Statistics about sent PTP messages. |
Discarded packets |
Statistics about discarded PTP messages. |
display ptp time-property
Use display ptp time-property to display PTP clock time information.
Syntax
display ptp time-property
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command does not display PTP clock time information in any of the following circumstances:
· PTP profile, PTP mode, or PTP domain is not configured for the device.
· The clock node type of the device is TC.
· The ptp active force-state command has been executed.
Examples
# Display PTP clock time information.
<Sysname> display ptp time-property
PTP clock time property:
Current UTC offset valid : True
Current UTC offset : 33
Leap59 : Yes
Leap61 : No
Time traceable : True
Frequency traceable : True
PTP timescale : True
Time source : 0xA0 (Internal oscillator)
Sync uncertain : False
Table 8 Command output
Field |
Description |
Current UTC offset valid |
Whether the UTC offset is valid: · True—Yes. · False—No. |
Current UTC offset |
Cumulative offset (in seconds) between the Coordinated Universal Time (UTC) of the grandmaster clock and the International Atomic Time (TAI). |
Leap59 |
Whether cumulative offset is minus 1: · Yes. · No. |
Leap61 |
Whether cumulative offset is plus 1: · Yes. · No. |
Time traceable |
Whether the PTP time is traceable: · True—Yes. · False—No. |
Frequency traceable |
Whether the PTP frequency is traceable: · True—Yes. · False—No. |
PTP timescale |
The possible timescales available for use by the grandmaster clock: · True—PTP timescale. · False—Non-PTP timescale. |
Time source |
Attributes of the grandmaster clock: · Atomic clock. · GPS. · Handset. · Internal oscillator. · NTP. · Other. · PTP. · Terrestrial radio. · Unknown. |
Sync uncertain |
Whether the upstream clock is not reliable: · True—The upstream clock is not reliable. · False—The upstream clock is reliable. |
ptp { tod0 | tod1 }
Use ptp { tod0 | tod1 } to configure ToD input or output.
Use undo ptp { tod0 | tod1 } to restore the default delay correction value.
Syntax
ptp { tod0 | tod1 } { input [ delay input-delay-time ] | output [ delay output-delay-time ] }
undo ptp { tod0 | tod1 } { input | output }
Default
The device transmits ToD clock signals from ToD 0 and receives ToD clock signals at ToD 1. The transmit and receive delay correction value is 0 nanoseconds.
Views
System view
Predefined user roles
network-admin
Parameters
tod0: Specifies the ToD 0 clock.
tod1: Specifies the ToD 1 clock.
input: Specifies the input direction for the device to receive ToD clock signals.
input-delay-time: Specifies the delay correction value in nanoseconds for receiving ToD clock signals. The value is in the range of 0 to 2000000. The default value is 0.
output: Specifies the output direction for the device to send ToD clock signals.
output-delay-time: Specifies the delay correction value in nanoseconds for sending ToD clock signals. The value is in the range of 0 to 1600. The default value is 0.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
If you connect the device correctly to a ToD clock source and configure this command, the device uses the ToD clock source as its GM.
Examples
# Set the delay correction value to 1000 and 100 nanoseconds for receiving ToD 0 clock signals and sending ToD 1 clock signals, respectively.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp tod0 input delay 1000
[Sysname] ptp tod1 output delay 100
Related commands
ptp domain
ptp mode
ptp profile
ptp active force-state
Use ptp active force-state to activate the port role configuration.
Use undo ptp active force-state to restore the default.
Syntax
ptp active force-state
undo ptp active force-state
Default
The port role configuration is not activated.
Views
System view
Predefined user roles
network-admin
Usage guidelines
After you change the role of a PTP port, you must execute this command to activate the port role configuration.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
A T-TSC or T-TSC-P clock node does not support this command.
Examples
# Activate the port role configuration.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp active force-state
Related commands
ptp domain
ptp force-state
ptp mode
ptp profile
ptp alarm-threshold { time-lock | time-unlock }
Use ptp alarm-threshold { time-lock threshold-value | time-unlock unlock-value } * to set the PTP time locking and unlocking thresholds.
Use undo ptp alarm-threshold { time-lock | time-unlock } * to restore the default.
Syntax
ptp alarm-threshold { time-lock lock-value | time-unlock unlock-value } *
undo ptp alarm-threshold { time-lock | time-unlock } *
Default
The default settings for this command vary by device model.
Views
System view
Predefined user roles
network-admin
Parameters
time-lock lock-value: Specifies the PTP time locking threshold in ns. The value range for this argument varies by device model.
time-unlock unlock-value: Specifies the PTP time unlocking threshold in ns. The value range for this argument varies by device model.
Usage guidelines
This command is available only after you specify a PTP profile and PTP clock node type.
When the time offset of the PTP reference clock crosses the PTP time unlocking threshold, the PTP time is put into unlocked state. The system outputs a time-unlocked log entry for notification. When the time offset of the PTP reference clock drops to or below the PTP time locking threshold, the PTP time is put into locked state. The system outputs a time-locked log entry for notification.
The PTP time unlocking threshold must be greater than or equal to the locking threshold.
You can execute the command multiple times. If different values are configured for a threshold, the most recent configuration takes effect.
Examples
# Set the PTP time locking threshold to 100 ns.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp alarm-threshold time-lock 100
Related commands
ptp domain
ptp mode
ptp profile
ptp alarm-threshold clock-source-class
Use ptp alarm-threshold clock-source-class to set the class threshold for the clock source.
Use undo ptp alarm-threshold clock-source-class to restore the default.
Syntax
ptp alarm-threshold clock-source-class class-value
undo ptp alarm-threshold clock-source-class
Default
The class threshold for the clock source is 6.
Views
System view
Predefined user roles
network-admin
Parameters
class-value: Specifies a class threshold, in the range of 0 to 255.
Usage guidelines
Each PTP clock source has a class value. For a ToD clock source, you can set its class value by using the ptp clock-source command. The higher the value, the lower the class. When the class value of the clock source crosses the class threshold, the system outputs a log for notification.
This command is available only after you specify a PTP profile and PTP clock node type.
Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.
Examples
# Set the class threshold to 20 for the clock source.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp clock mode t-bc
[Sysname] ptp alarm-threshold clock-source-class 20
Related commands
ptp clock mode
ptp clock-source
ptp domain
ptp profile
ptp alarm-threshold time-offset
Use ptp alarm-threshold time-offset to set the time-offset threshold between the external reference clock and the PTP clock.
Use undo ptp alarm-threshold time-offset to restore the default.
Syntax
ptp alarm-threshold time-offset time-offset-value
undo ptp alarm-threshold time-offset
Default
The time-offset threshold between the external reference clock and the PTP clock is 500 ns.
Views
System view
Predefined user roles
network-admin
Parameters
time-offset-value: Specifies the time-offset threshold between the external reference clock and the PTP clock, in the range of 200 to 1000, in ns.
Usage guidelines
If the device uses an external ToD reference clock, it calculates the time offset between the external reference clock and the PTP clock at a pre-defined interval (not configurable). When the offset exceeds the threshold, the device outputs a log for notification.
This command is available only after you specify a PTP profile and a PTP clock node type.
Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.
Examples
# Set the threshold to 800 for the time offset between the external reference clock and the PTP clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp clock mode t-bc
[Sysname] ptp alarm-threshold time-offset 800
Related commands
ptp domain
ptp mode
ptp profile
ptp alarm-threshold time-offset-sum pk-pk
Use ptp alarm-threshold time-offset-sum pk-pk to set the time-offset-sum peak-to-peak threshold.
Use undo ptp alarm-threshold time-offset-sum pk-pk to restore the default.
Syntax
ptp alarm-threshold time-offset-sum pk-pk threshold-value
undo ptp alarm-threshold time-offset-sum pk-pk
Default
The time-offset-sum peak-to-peak threshold is 500 ns.
Views
System view
Predefined user roles
network-admin
Parameters
threshold-value: Sets the time-offset-sum peak-to-peak threshold in the range of 0 to 2000, in ns.
Usage guidelines
This command is available only after you specify a PTP profile and PTP clock node type.
The PTP module calculates the time-offset-sum peak-to-peak value at specific intervals and compares the value with the threshold configured by this command. If the value is larger than the threshold, the system outputs a log for notification.
Examples
# Set the time-offset-sum peak-to-peak threshold to 1500 ns.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp alarm-threshold time-offset-sum pk-pk 1500
Related commands
ptp domain
ptp mode
ptp profile
ptp announce-interval
Use ptp announce-interval to set the interval for sending announce messages.
Use undo ptp announce-interval to restore the default.
Syntax
ptp announce-interval interval
undo ptp announce-interval
Default
For the IEEE 1588 version 2 or AES67-2015 PTP profile, the interval argument value is 1 and the announce message sending interval is 2 (21) seconds.
For the IEEE 802.1AS PTP profile, the interval argument value is 0 and the announce message sending interval is 1 (20) second.
For the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile, the interval argument value is –3 and the announce message sending interval is 1/8 (2-3) seconds.
For the SMPTE ST 2059-2 PTP profile, the interval argument value is –2 and the announce message sending interval is 1/4 (2-2) second.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending announce messages. When the PTP profile is IEEE 1588 version 2 or AES67-2015, the value range for the interval argument is 0 to 4. When the PTP profile is IEEE 802.1AS, the value range for the interval argument is 0 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –3 to 1. When the PTP profile is ITU-T G.8275.1, the value range for the interval argument is –3 to 6. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –3 to 0.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The configuration of the interval at which the master node sends announce messages depends on the PTP profile in the PTP domain.
· PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.
· ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends announce messages to the client. If the negotiation succeeds, the grant-port sends announce messages at the configured interval to the client. If the negotiation fails, the grant-port does not send announce messages to the client.
Examples
# Set the announce message sending interval to 4 (22) seconds on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp announce-interval 2
Related commands
ptp domain
ptp mode
ptp profile
ptp announce-timeout
Use ptp announce-timeout to set a timeout multiplier for receiving announce messages.
Use undo ptp announce-timeout to restore the default.
Syntax
ptp announce-timeout multiple-value
undo ptp announce-timeout
Default
The timeout multiplier for receiving announce messages is 3.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
multiple-value: Sets the timeout multiplier for receiving announce messages, in the range of 2 to 10.
Usage guidelines
A master node sends announce messages to the member nodes at the specified interval. If a member node does not receive any announce message from the master node after the timeout expires, it determines that the master node is invalid. The timeout = timeout multiplier × interval at which the master node sends announce messages.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
To ensure a stable PTP network, set the timeout multiplier for receiving announce messages to a value in the range of 5 to 7.
The ITU-T G.8275.2 PTP profile does not support this command.
Examples
# Set the timeout multiplier for receiving announce messages to 5 on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp announce-timeout 5
Related commands
ptp announce-interval
ptp domain
ptp mode
ptp profile
ptp asymmetry-correction
Use ptp asymmetry-correction to set the asymmetric delay correction time.
Use undo ptp asymmetry-correction to restore the default.
Syntax
ptp asymmetry-correction { minus | plus } value
undo ptp asymmetry-correction
Default
The asymmetric delay correction time is 0 nanoseconds, which means that delay correction is not performed.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
minus: Subtracts the specified asymmetric delay correction value.
plus: Adds the specified asymmetric delay correction value.
value: Specifies the asymmetric delay correction value in the range of 0 to 2000000 nanoseconds.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
Examples
# Set the asymmetric delay correction time to 100 nanoseconds on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp asymmetry-correction plus 100
Related commands
ptp domain
ptp mode
ptp profile
ptp clock-source
Use ptp clock-source to configure the parameters for a clock source.
Use undo ptp clock-source to restore the clock source parameters to their default values.
Syntax
Local clock source:
ptp clock-source local { accuracy acc-value | class class-value | time-source ts-value }
undo ptp clock-source local { accuracy | class | time-source }
ToD clock source:
ptp clock-source { tod0 | tod1 } { accuracy acc-value | class class-value | grandmaster-clockid clock-id | offsetscaled-logvariance value | time-source ts-value }
undo ptp clock-source { tod0 | tod1 } { accuracy | class | grandmaster-clockid | offsetscaled-logvariance | time-source }
Default
· IEEE 1588 version 2
¡ Local clock source—The accuracy value and the time class value depend on the device model. The offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value not configurable.
¡ ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) is 65535, and the time source value is 32.
· IEEE 802.1AS
¡ Local clock source—The accuracy value, the time class value, and the offset (log variance) value depend on the device model. The time source value is 160.
¡ ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) is 16640, and the time source value is 32.
· ITU-T G.8275.1 PTP profile
¡ T-TSC clock node type
- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.
- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.
¡ T-BC or T-TC clock node type: Default PTP technical standard
- Local clock source—The accuracy value and the time class value depend on the device model. The offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value is not configurable.
¡ ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.
· ITU-T G.8275.2
¡ T-TSC-P clock node type
- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.
- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.
¡ T-BC-P clock node type
- Local clock source—The accuracy value and the time class value vary by device model, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.
- ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.
Views
System view
Predefined user roles
network-admin
Parameters
tod0: Specifies the ToD 0 clock.
tod1: Specifies the ToD 1 clock.
accuracy acc-value: Specifies the accuracy of the ToD clock, in the range of 0 to 255. A smaller value indicates a higher accuracy. Table 9 shows the description for clock accuracy values.
Table 9 Clock accuracy value description
Clock accuracy value (in hexadecimal format) |
Description |
00 through 1F |
Reserved. |
20 |
Less than 25 nanoseconds (1 nanosecond = 10-9 second). |
21 |
Less than 100 nanoseconds. |
22 |
Less than 250 nanoseconds. |
23 |
Less than 1 microsecond (10-6 second). |
24 |
Less than 2.5 microseconds. |
25 |
Less than 10 microseconds. |
26 |
Less than 25 microseconds. |
27 |
Less than 100 microseconds. |
28 |
Less than 250 microseconds. |
29 |
Less than 1 millisecond (10-3 second). |
2A |
Less than 2.5 milliseconds. |
2B |
Less than 10 milliseconds. |
2C |
Less than 25 milliseconds. |
2D |
Less than 100 milliseconds. |
2E |
Less than 250 milliseconds. |
2F |
Less than 1 second. |
30 |
Less than 10 seconds. |
31 |
More than 10 seconds. |
32 through 7F |
Reserved. |
80 through FD |
For use by alternate PTP profiles. |
FE |
Unknown. |
FF |
Reserved. |
class class-value: Specifies the class of the ToD clock, in the range of 0 to 255. A smaller value indicates a higher time class. Table 10 shows the description for clock classes (those not listed are reserved by the protocol and are not recommended to use).
Table 10 Clock class description
Clock class (in decimal format) |
Description |
6 |
The clock node synchronizes its time to the master reference time source. PTP assigns a time table to the clock node. A clock node with time class 6 cannot become a member clock of any other clocks in the domain. |
7 |
The former time class is 6. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. PTP assigns a time table to the clock node. A clock node with time class 7 cannot become a member clock of any other clocks in the domain. |
13 |
The clock node synchronizes its time to a time source. ARB assigns a time table to the clock node. A clock node with time class 13 cannot become a member clock of any other clocks in the domain. |
14 |
The former time class is 13. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. ARB assigns a time table to the clock node. A clock node with time class 14 cannot become a member clock of any other clocks in the domain. |
52 |
The clock node with time class 7 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 52 cannot become a member clock of any other clocks in the domain. |
58 |
The clock node with time class 14 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 58 cannot become a member clock of any other clocks in the domain. |
150 |
The clock node synchronizes its frequency to a reference source with frequency accuracy of ±1 ppm (one in a million). The reference source has synchronized itself to the master reference time source. The timescale is PTP. |
158 |
The clock node synchronizes its frequency to a reference source with frequency accuracy of ±10 ppm (ten in a million). The reference source has synchronized itself to the master reference time source. The timescale is PTP. |
187 |
The clock node with time class 7 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 187 can become a member clock of another clock in the domain. |
193 |
The clock node with time class 14 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 193 can become a member clock of another clock in the domain. |
220 |
The clock node synchronizes its frequency to a reference source with frequency accuracy of ±1 ppm (one in a million). The reference source has synchronized itself to the master reference time source. The timescale is ARB. |
228 |
The clock node synchronizes its frequency to a reference source with frequency accuracy of ±10 ppm (ten in a million). The reference source has synchronized itself to the master reference time source. The timescale is ARB. |
248 |
Default time class value. |
255 |
Clock node operating in slave-only mode. |
grandmaster-clockid clock-id: Specifies the GM clock ID. The clock-id argument is in the XXXXXX-XXXX-XXXXXX format. X represents a hexadecimal number. A full 0 number is not supported. This option is not available for a local clock source. For a ToD clock source, you must specify this option.
offsetscaled-logvariance value: Specifies the offset (log variance). The value is in the range of 0 to 65535. This option is not available for a local clock source.
time-source ts-value: Specifies the clock attribute value in the range of 0 to 255. Table 11 shows the description for the clock attribute values (those not listed are reserved for the protocol).
Table 11 GM attribute value description
GM attribute values (in hexadecimal format) |
Description |
10 |
Atomic clock. |
20 |
GPS. |
30 |
Terrestrial radio. |
40 |
PTP. |
50 |
NTP. |
60 |
Handset. |
90 |
Other. |
A0 |
Internal oscillator. |
F0 |
Master clock. Time in the master is derived from the periodicity of a synchronization signal where the time value is undefined and is not related to real time. The timescale is ARB. |
F1 |
Master clock. Time in the master is derived from the periodicity of a synchronization signal and is initially referenced to a local time source. Subsequent time accuracy in relation to real time will depend on the frequency accuracy of the synchronization signal. |
F2 to FE |
For use by alternate PTP profiles. |
FF |
Reserved. |
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
You can execute this command multiple times to configure different parameters. If you configure a parameter multiple times, the most recent configuration takes effect.
Examples
# Set the time accuracy of the ToD 0 clock to 44 in system view.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp clock-source tod0 accuracy 44
Related commands
ptp domain
ptp mode
ptp profile
ptp clock-step
Use ptp clock-step to configure the mode for carrying timestamps.
Use undo ptp clock-step to restore the default.
Syntax
ptp clock-step { one-step | two-step }
undo ptp clock-step
Default
Two-step mode is used for carrying timestamps.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
one-step: Specifies the single-step mode.
two-step: Specifies the two-step mode.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS PTP profile supports only the two-step mode.
Examples
# Configure the two-step timestamp-carrying mode on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp clock-step two-step
Related commands
ptp domain
ptp mode
ptp profile
ptp delay-mechanism
Use ptp delay-mechanism to specify a delay measurement mechanism for a BC or an OC.
Use undo ptp delay-mechanism to restore the default.
Syntax
ptp delay-mechanism { e2e | p2p }
undo ptp delay-mechanism
Default
When the PTP profile is IEEE 1588 version 2, AES67-2015, or SMPTE ST 2059-2, the request-response delay measurement mechanism applies.
When the PTP profile is IEEE 802.1AS, the peer delay measurement mechanism applies.
When the PTP profile is ITU-T G.8275.1, the request-response delay measurement mechanism applies.
When the PTP profile is ITU-T G.8275.2, the request-response delay measurement mechanism applies.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
e2e: Specifies the request-response mechanism.
p2p: Specifies the peer delay mechanism.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
When the PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015, the following restrictions apply:
· You can configure this command only on a BC or OC clock node.
· You cannot configure this command on an E2ETC, E2ETC+OC, P2PTC, or P2PTC+OC clock node. The E2ETC and E2ETC+OC clock nodes support both request-response and peer delay measurement mechanisms. A P2PTC clock node supports only the peer delay measurement mechanism.
The IEEE 802.1AS PTP profile supports only the peer delay measurement mechanism and does not support this command.
The ITU-T G.8275.1 PTP profile supports only the request-response delay measurement mechanism and does not support this command.
The ITU-T G.8275.2 PTP profile supports only the request-response delay measurement mechanism and does not support this command.
Examples
# Specify the OC clock node type. Specify the request-response delay measurement mechanism (e2e) on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp delay-mechanism e2e
Related commands
ptp domain
ptp mode
ptp profile
ptp delay-resp-interval
Use ptp delay-resp-interval to set the interval at which the server sends Delay_resp messages to the client.
Use undo ptp delay-resp-interval to restore the default.
Syntax
ptp delay-resp-interval interval
undo ptp delay-resp-interval
Default
The value of the interval argument is –4 and the minimum interval for sending Delay_resp messages is 1/16 (2-4) seconds.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Delay_resp messages. The value range for this argument is –5 to 0.
Usage guidelines
Only the ITU-T G.8275.2 PTP profile supports this command.
This command, configured on a request-port, specifies the interval at which the grant-port sends Delay_resp messages to the request-port.
After receiving a Delay_req message from a request port, the grant-port responses by sending a Delay_resp message and starts a timer defined by this command. The grant-port will not send another Delay_resp message until it receives a Delay_req message after the timer expires.
Examples
# Set the Delay_resp message sending interval to 2-3 seconds.
<Sysname> system-view
[Sysname] ptp profile g8275.2
[Sysname] ptp mode t-bc-p
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2
[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-negotiate request-port
[Sysname-Twenty-FiveGigE1/0/1] ptp delay-resp-interval -3
Related commands
ptp mode
ptp profile
ptp unicast-destination
ptp unicast-negotiate
ptp destination-mac
Use ptp destination-mac to configure the destination MAC address for non-peer delay messages.
Use undo ptp destination-mac to restore the default.
Syntax
ptp destination-mac mac-address
undo ptp destination-mac
Default
The destination MAC address of non-peer delay messages is 011B-1900-0000.
The destination MAC address of peer delay messages is 0180-C200-000E.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the destination MAC address for non-peer delay messages as 0180-C200-000E or 011B-1900-0000.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device. The IEEE 802.1AS, SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles do not support this command.
This command takes effect only when PTP messages are transported over IEEE 802.3/Ethernet packets.
IEEE 802.3/Ethernet-encapsulated PTP messages can be sent through multicast (default) or unicast. In multicast mode, the destination MAC address is 0180-C200-000E or 011B-1900-0000 for non-Pdelay messages and 0180-C200-000E for Pdelay messages. Non-Pdelay messages include delay_Req, delay_Resp, delay_Resp_Follow_Up, Announce, Sync, and FollowUp messages. Pdelay messages include Pdelay_Req, Pdelay_Resp, and Pdelay_Resp_Follow_Up messages.
If a clock node uses the unicast mode, you must configure any unicast MAC address on the uplink node of this clock node as the destination MAC address for PTP messages.
Examples
# Set the destination MAC address for non-peer delay messages to 0180-C200-000E on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp destination-mac 0180-c200-000e
Related commands
ptp domain
ptp mode
ptp profile
ptp domain
Use ptp domain to specify a PTP domain.
Use undo ptp domain to restore the default.
Syntax
ptp domain domain-number
undo ptp domain
Default
No PTP domain exists.
Views
System view
Predefined user roles
network-admin
Parameters
domain-number: Specifies a PTP domain by its number. The value range for the domain-number argument is 0 to 255 for the IEEE 1588 version 2, IEEE 802.1AS, and AES67-2015 PTP profiles, 0 to 127 for the SMPTE ST 2059-2 PTP profile, 24 to 43 for the ITU-T G.8275.1 PTP profile, and 44 to 63 for the ITU-T G.8275.2 PTP profile.
Usage guidelines
You can configure this command only after you have specified a PTP profile and PTP mode for the device.
If you delete a PTP domain, all PTP configurations related to the domain are deleted, except the PTP profile and PTP mode settings.
Examples
# Assign the device to PTP domain 2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 2
Related commands
ptp mode
ptp profile
ptp dscp
Use ptp dscp to set a DSCP value for PTP messages transmitted over IPv4 UDP.
Use undo ptp dscp to restore the default.
Syntax
ptp dscp dscp
undo ptp dscp
Default
The DSCP value is 56 for PTP messages transmitted over IPv4 UDP.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
dscp: Sets a DSCP value in the range of 0 to 63 for PTP messages.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles do not support this command.
This command takes effect only for PTP messages transmitted over IPv4 UDP.
Examples
# Set the DSCP value to 63 for PTP messages transmitted over IPv4 UDP on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp
[Sysname-Twenty-FiveGigE1/0/1] ptp dscp 63
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
ptp enable
Use ptp enable to enable PTP.
Use undo ptp enable to disable PTP.
Syntax
ptp enable
undo ptp enable
Default
PTP is disabled.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
You can enable PTP on only one port if the clock node type of the device is OC or T-TSC.
As a best practice, enable PTP on an interface after you complete PTP configuration on the interface.
To enable PTP on a Layer 3 Ethernet interface that has been assigned to a VPN instance, you must specify this VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command if PTP messages are to be transmitted in multicast mode over IPv4 UDP.
Examples
# Specify the OC clock node type and enable PTP on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp enable
# Specify the E2ETC clock node type and enable PTP on Twenty-FiveGigE 1/0/1 and Twenty-FiveGigE 1/0/2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode e2etc
[Sysname] ptp domain 1
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp enable
[Sysname-Twenty-FiveGigE1/0/1] interface twenty-fivegige 1/0/2
[Sysname-Twenty-FiveGigE1/0/2] ptp enable
Related commands
ptp domain
ptp mode
ptp profile
ptp source
ptp force-state
Use ptp force-state to configure a role for a PTP port.
Use undo ptp force-state to restore the default.
Syntax
ptp force-state { master | passive | slave }
undo ptp force-state
Default
The PTP port role is automatically calculated based on the BMC algorithm.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
master: Specifies the PTP port as a master port.
passive: Specifies the PTP port as a passive port.
slave: Specifies the PTP port as a subordinate port.
Usage guidelines
By default, the PTP port roles are automatically negotiated based on the BMC algorithm. If you use this command to change the role of one PTP port, all the other PTP ports in the PTP domain stop working. For these PTP ports to function, you must specify roles for each of them by using this command. As a best practice, enable automatic negotiation of PTP port roles based on the BMC algorithm.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
You can configure only one subordinate port for a device.
The T-TSC, T-TSC-P, and T-BC-P clock nodes do not support this command.
After you change the role of a PTP port, you must execute the ptp active force-state command to activate the port role configuration.
Examples
# Specify the OC clock node type and specify Twenty-FiveGigE 1/0/1 as a subordinate port.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp force-state slave
Related commands
ptp active force-state
ptp domain
ptp mode
ptp profile
ptp slave-only
ptp local-priority
Use ptp local-priority to configure a local priority for an interface.
Use undo ptp local-priority to restore the default.
Syntax
ptp local-priority local-priority
undo ptp local-priority
Default
The local priority of an interface is 128.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
local-priority: Specifies a priority in the range of 1 to 255. The lower the value, the higher the priority.
Usage guidelines
This command is available only after you specify a PTP profile, PTP clock node type, and PTP domain. Only the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles support this command.
An announce message does not carry the local priority of the clock node. Under the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile, each PTP-enabled interface on a clock node has a local priority. This priority will be used as the local priority of the peer node in BMC selection and is one of the factors that determine whether the peer node can be elected as the GM.
Examples
# Set the local priority for Twenty-FiveGigE1/0/1 to 10.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp local-priority 10
Related commands
ptp mode
ptp profile
ptp max-steps-removed
Use ptp max-steps-removed to specify the maximum number of removed steps (clock nodes) from the GM to the device.
Use undo ptp max-steps-removed to restore the default.
Syntax
ptp max-steps-removed step-removed-value
undo ptp max-steps-removed
Default
The maximum number of removed steps is 255 from the GM to the device.
Views
System view
Predefined user roles
network-admin
Parameters
step-removed-value: Specifies the maximum number of removed steps from the GM to the device, in the range of 1 to 255.
Usage guidelines
If the number of removed steps from the GM to the device exceeds the maximum number, the device cannot synchronize time through PTP.
This command is available only after you specify a PTP profile, PTP clock node type, and PTP domain.
Examples
# Set the maximum number of removed steps from the GM to the device to 20.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp max-steps-removed 20
Related commands
ptp mode
ptp profile
ptp min-delayreq-interval
Use ptp min-delayreq-interval to set the minimum interval for sending delay request messages.
Use undo ptp min-delayreq-interval to restore the default.
Syntax
ptp min-delayreq-interval interval
undo ptp min-delayreq-interval
Default
When the PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015, the value of the interval argument is 0 and the minimum interval for sending delay request messages is 1 (20) second.
When the PTP profile is ITU-T G.8275.1 or ITU-T G.8275.2, the value of the interval argument is –4 and the minimum interval for sending delay request messages is 1/16 (2-4) seconds.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending delay request messages. When the PTP profile is IEEE 1588 version 2 or ITU-T G.8275.1, the value range for the interval argument is –4 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to 4. When the PTP profile is AES67-2015, the value range for the interval argument is –3 to 5. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –5 to 0.
Usage guidelines
When a member clock receives a Sync message, it responds by sending a Delay_Req message and starts a timer defined by this command. The member clock will not send another Delay_Req message until it receives a Sync message after the timer expires.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS PTP profile does not support this command.
In PTP multicast transport mode, this command takes effect only when configured on the master clock. The master clock sends the value to a member clock through PTP messages to control the interval for the member clock to send Delay_Req messages. To view the interval, execute the display ptp interface command on the member clock.
In PTP unicast transport mode, this command takes effect when configured on member clocks. It does not take effect when configured on the master clock.
As a best practice, set the interval argument to a value in the range of ptp syn-interval interval to ptp syn-interval interval plus 5 when the PTP profile is SMPTE ST 2059-2 or AES67-2015.
Examples
# Set the minimum interval to 4 (22) seconds for sending delay request messages on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp min-delayreq-interval 2
Related commands
ptp domain
ptp mode
ptp profile
ptp syn-interval
ptp mode
Use ptp mode to specify a clock node type for the device.
Use undo ptp mode to restore the default.
Syntax
IEEE 1588v2 PTP profile:
ptp mode { bc | e2etc | e2etc-oc | oc | p2ptc | p2ptc-oc }
undo ptp mode
IEEE 802.1AS PTP profile:
ptp mode { bc | oc | p2ptc | p2ptc-oc }
undo ptp mode
AES67-2015 and SMPTE ST 2059-2 PTP profiles:
ptp mode { bc | e2etc | oc | p2ptc }
undo ptp mode
ITU-T G.8275.1 PTP profile:
ptp mode { t-bc | t-tc | t-tsc }
undo ptp mode
ITU-T G.8275.2 PTP profile:
ptp mode { t-bc-p | t-tsc-p }
undo ptp mode
Default
No clock node type is specified.
Views
System view
Predefined user roles
network-admin
Parameters
bc: Specifies the boundary clock (BC) type.
e2etc: Specifies the end-to-end transparent clock (E2ETC) type.
e2etc-oc: Specifies the E2ETC+OC type.
oc: Specifies the ordinary clock (OC) type.
p2ptc: Specifies the peer-to-peer transparent clock (P2PTC) type.
p2ptc-oc: Specifies the P2PTC+OC type.
t-bc: Specifies the telecom boundary clock (T-BC) type.
t-tc: Specifies the telecom transparent clock (T-TC) type.
t-tsc: Specifies the telecom time slave clock (T-TSC) type.
t-bc-p: Specifies the partial-support telecom boundary clock (T-BC-P) type.
t-tsc-p: Specifies the partial-support telecom time slave clock (T-TSC-P) type.
Usage guidelines
CAUTION: If you change the clock node type for the device, all settings except for the PTP profile will be removed. |
You can configure this command only after you have specified a PTP profile for the device. Follow these restrictions and guidelines for specifying a clock node type:
· (Devices that do not support PTP instances.) You can specify only one clock node type for the device.
· (Devices that support PTP instances.) You can specify only one clock node type for the device on a PTP instance.
· The T-TC, T-BC, and T-TSC clock node types are available only for the ITU-T G.8275.1 PTP profile. When the PTP profile is ITU-T G.8275.1, you can specify only the T-TC, T-BC, or T-TSC clock node type.
· The T-BC-P and T-TSC-P clock node types are available only for the ITU-T G.8275.2 PTP profile. When the PTP profile is ITU-T G.8275.2, you can specify only the T-BC-P or T-TSC-P clock node type.
· When the PTP profile is SMPTE ST 2059-2 or AES67-2015, you can specify only the BC, OC, E2ETC, or P2PTC clock node type.
Changing or removing the clock node type will restore the default settings of the PTP profile.
Examples
# Specify the OC clock node type for the device.
<Sysname> system-view
[Sysname] ptp profile 1588v2
Related commands
ptp profile
ptp notslave disable
Use ptp notslave disable to disable the NotSlave feature.
Use undo ptp notslave disable to restore the default.
Syntax
ptp notslave disable
undo ptp notslave disable
Default
The NotSlave feature is enabled on a PTP interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
The NotSlave feature enables a PTP port to select the clock node where it resides as the master node.
This feature is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. You can use this feature to control master/member role of the clock node. For automatic master/member clock node selection in a PTP domain under the ITU-T G.8275.1 PTP profile, you must disable NotSlave on all PTP ports.
This command is available only after you specify a PTP profile, PTP clock node type, and PTP domain.
Under the ITU-T G.8275.1 PTP profile, only the T-BC and T-TC clock nodes support this command.
Under the ITU-T G.8275.2 PTP profile, only a T-BC-P clock node supports this command.
By default, the ports on the T-BC-P and T-BC clock nodes are in master-only mode. To use a port on a T-BC-P or T-BC clock node as a subordinate port, first execute the ptp notslave disable command on the port.
Examples
# Disable the NotSlave feature on Twenty-FiveGigE1/0/1.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp notslave disable
Related commands
ptp mode
ptp profile
ptp path-trace disable
Use ptp path-trace disable to disable PTP path tracing.
Use undo ptp path-trace disable to enable PTP path tracing.
Syntax
ptp path-trace disable
undo ptp path-trace disable
Default
PTP path tracing is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
PTP path tracing traces the clock nodes that the clock signals traverse from the GM to the device. The system can obtain complete path tracing information only when all clock nodes on the path are enabled with PTP path tracing. If a device on the path does not support PTP path tracing, disable this feature to prevent PTP intercommunication issues.
This command is available only after you have specified a PTP profile, PTP clock node type, and PTP domain.
Examples
# Disable PTP path tracing.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp domain 1
[Sysname] ptp path-trace disable
Related commands
display ptp path-trace
ptp mode
ptp profile
ptp pdelay-req-interval
Use ptp pdelay-req-interval to set the interval for sending peer delay request messages.
Use undo ptp pdelay-req-interval to restore the default.
Syntax
ptp pdelay-req-interval interval
undo ptp pdelay-req-interval
Default
The interval for sending peer delay request messages is 1 (20) second.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending peer delay request messages. When the PTP profile is IEEE 1588 version 2 or AES67-2015, the value range for the interval argument is 0 to 5. When the PTP profile is IEEE 802.1AS, the value range for the interval argument is –4 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to 4.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
This command is available only after you specify a PTP profile and a PTP mode.
When the PTP profile is SMPTE ST 2059-2, set the interval argument to a value in the range of ptp syn-interval interval to ptp syn-interval interval plus 5 as a best practice.
The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.
Examples
# Set the interval to 4 (22) seconds for sending peer delay request messages on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp pdelay-req-interval 2
Related commands
ptp domain
ptp mode
ptp profile
ptp syn-interval
ptp port-mode
Use ptp port-mode to specify the OC port type for a TC+OC (including E2ETC+OC and P2PTC+OC) clock.
Use undo ptp port-mode to restore the default.
Syntax
ptp port-mode oc
undo ptp port-mode
Default
The type of all ports on an E2ETC+OC or a P2PTC+OC clock is TC.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
oc: Specifies the OC port type for a TC+OC clock.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
This command is applicable only for E2ETC+OC and P2PTC+OC clocks.
The SMPTE ST 2059-2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles do not support this command.
Examples
# Specify the P2PTC+OC clock node type for the device. Specify the OC port type for Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode p2ptc-oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp port-mode oc
Related commands
ptp domain
ptp mode
ptp profile
ptp priority
Use ptp priority clock-source to configure the priority for the specified clock for GM election through BMC.
Use undo ptp priority clock-source to restore the specified priority to its default value.
Syntax
ptp priority clock-source { local | tod0 | tod1 } { local-priority local-priority | priority1 priority1 | priority2 priority2 }
undo ptp priority clock-source { local | tod0 | tod1 } { local-priority local-priority | priority1 | priority2 }
Default
When the PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015, the priority 1 and priority 2 values are both 128.
When the PTP profile is IEEE 802.1AS, the priority 1 value is 246 and the priority 2 value is 248.
When the PTP profile is ITU-T G.8275.1, the priority 1 value is 128. The priority 2 value is 128 for both T-BC and T-TC clock nodes and 225 for a T-TSC clock node. The local priority value is 128.
When the PTP profile is ITU-T G.8275.2, the priority 1 value is 128. The priority 2 value is 128 for a T-BC-P clock node and 255 for a T-TSC-P clock node. The local priority value is 128.
Views
System view
Predefined user roles
network-admin
Parameters
local: Specifies the local clock.
tod0: Specifies the ToD 0 clock.
tod1: Specifies the ToD 1 clock.
local-priority local-priority: Specifies the local priority for the clock. The value is in the range of 0 to 255. A numerically smaller value has higher priority. This option is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.
priority1 priority1: Specifies priority 1 for the clock, in the range of 0 to 255. The value is 128 for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. A numerically smaller value has higher priority.
priority2 priority2: Specifies priority 2 for the clock. The value is in the range of 0 to 255 for the IEEE 1588 version 2 and IEEE 802.1AS PTP profiles. For the ITU-T G.8275.1 PTP profile, the value is in the range of 0 to 255 for T-BC and T-TC clock nodes and 255 for a T-TSC clock node. For the ITU-T G.8275.2 PTP profile, the value is in the range of 0 to 255 for a T-BC-P clock node and 255 for a T-TSC-P clock node. A numerically smaller value has higher priority.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The local priority of a clock will not be carried in PTP announce messages.
Examples
# Set priority 1 to 10 for the local clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp priority clock-source local priority1 10
Related commands
ptp domain
ptp mode
ptp profile
ptp profile
Use ptp profile to specify a PTP profile for the device.
Use undo ptp profile to restore the default.
Syntax
ptp profile { 1588v2 | 8021as | aes67-2015 | st2059-2 | g8275.1 | g8275.2 }
undo ptp profile
Default
PTP operates only after you specify a PTP profile.
Views
System view
Predefined user roles
network-admin
Parameters
1588v2: Specifies the IEEE 1588 version 2 PTP profile.
8021as: Specifies the IEEE 802.1AS PTP profile.
st2059-2: Specifies the SMPTE ST 2059-2 PTP profile.
aes67-2015: Specifies the AES67-2015 PTP profile.
g8275.1: Specifies the ITU-T G.8275.1 PTP profile.
g8275.2: Specifies the ITU-T G.8275.2 PTP profile.
Usage guidelines
Specify a PTP profile for the device before any other PTP configurations.
Changing or removing a PTP profile clears all settings under the PTP profile.
Examples
# Specify the IEEE 1588 version 2 PTP profile.
<Sysname> system-view
[Sysname] ptp profile 1588v2
ptp slave-only
Use ptp slave-only to configure the OC to operate only as a member clock.
Use undo ptp slave-only to restore the default.
Syntax
ptp slave-only
undo ptp slave-only
Default
An OC can operate either as a master clock or a member clock.
Views
System view
Predefined user roles
network-admin
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
This command is applicable only to OCs.
You can execute the ptp force-state command to specify a subordinate port as a master port or passive port even if the OC operates as a member clock.
Examples
# Specify the OC clock node type for the device. Configure the OC to operate only as a member clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp slave-only
Related commands
ptp domain
ptp force-state
ptp mode
ptp profile
ptp source
Use ptp source to configure the source IP address for multicast PTP messages transmitted over IPv4 UDP.
Use undo ptp source to remove the specified source IP address for multicast PTP messages transmitted over IPv4 UDP.
Syntax
ptp source ip-address [ vpn-instance vpn-instance-name ]
undo ptp source ip-address [ vpn-instance vpn-instance-name ]
Default
No source IP address is configured for multicast PTP messages transmitted over IPv4 UDP.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the source IP address for multicast PTP messages transmitted over IPv4 UDP.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance used for communication between the local device and the peer device. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the peer device belongs to the public network, do not specify this option.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS, ITU-T G.8275.1, and ITU-T G.8275.2 profiles do not support this command.
This command takes effect only when PTP messages are transmitted over IPv4 UDP in multicast mode.
If a PTP-enabled Layer 3 Ethernet interface has been assigned to a VPN instance, you must specify the VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command.
Examples
# Configure the source IP address as 3.5.1.5 for multicast PTP messages transmitted over IPv4 UDP.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp source 3.5.1.5
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
ptp syn-interval
Use ptp syn-interval to set the interval for sending Sync messages.
Use undo ptp syn-interval to restore the default.
Syntax
ptp syn-interval interval
undo ptp syn-interval
Default
When the PTP profile is IEEE 1588 version 2, the interval argument value is 0 and the interval for sending Sync messages is 1 (20) second.
When the PTP profile is IEEE 802.1AS, SMPTE ST 2059-2, or AES67-2015, the interval argument value is –3 and the interval for sending Sync messages is 1/8 (2-3) seconds.
When the PTP profile is ITU-T G.8275.1 or ITU G.8275.2, the interval argument value is –4 and the interval for sending Sync messages is 1/16 (2-4) seconds.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Sync messages. When the PTP profile is IEEE 802.1AS or ITU-T G.8275.1, the value range for the interval argument is –4 to 6. When the PTP profile is IEEE 1588 version 2, the value range for the interval argument is –1 to 1. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to –1. When the PTP profile is AES67-2015, the value range for the interval argument is –4 to 1. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –5 to 0.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The configuration of the interval at which the master node sends Sync messages depends on the PTP profile in the PTP domain.
· PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.
· ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends Sync messages to the client. If the negotiation succeeds, the grant-port sends Sync messages at the configured interval to the client. If the negotiation fails, the grant-port does not send Sync messages to the client.
Examples
# Set the Sync message sending interval to 2 (21) seconds on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp syn-interval 1
Related commands
ptp domain
ptp mode
ptp profile
ptp sync-uncertain enable
Use ptp sync-uncertain enable to enable the device to notify the downstream nodes of its time synchronization state.
Use undo ptp sync-uncertain enable to disable the device from notifying the downstream nodes of its time synchronization state.
Syntax
ptp sync-uncertain enable
undo ptp sync-uncertain enable
Default
The device does not notify the downstream nodes of its time synchronization state.
Views
System view
Predefined user roles
network-admin
Usage guidelines
By default, the device transfers only the locked and unlocked status of the upstream node to the downstream nodes, and does not transfer its locked or unlocked status to the downstream nodes.
After this command is configured, the device notifies the downstream nodes of its locked and unlocked status through the synchronizationUncertain flag in the announce messages. The downstream nodes do not synchronize to the device when they receive information that the device time is unlocked and synchronize to the device when they receive information that the device time is locked.
This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.
Examples
# Enable the device to notify the downstream nodes of its time synchronization state.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp sync-uncertain enable
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
Use ptp transport-protocol to specify the IPv4 UDP transport protocol for PTP messages.
Use undo ptp transport-protocol to restore the default.
Syntax
ptp transport-protocol udp
undo ptp transport-protocol
Default
The IEEE 1588 version 2, IEEE 802.1AS, and ITU-T G.8275.1 PTP profiles transport PTP messages over IEEE 802.3/Ethernet.
The SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles transport PTP messages over IPv4 UDP.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
udp: Specifies the IPv4 UDP transport protocol for PTP messages.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles support IEEE 802.3/Ethernet transport of PTP messages and do not support this task.
The SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles support IPv4 UDP transport of PTP messages and do not support this task.
Examples
# Specify the IPv4 UDP transport protocol for PTP messages on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp
Related commands
ptp domain
ptp mode
ptp profile
ptp unicast-destination
Use ptp unicast-destination to configure the destination IP address for unicast PTP messages transmitted over IPv4 UDP.
Use undo ptp unicast-destination to restore the default.
Syntax
ptp unicast-destination ip-address
undo ptp unicast-destination ip-address
Default
No destination IP address is configured for unicast PTP messages transmitted over IPv4 UDP.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the destination IP address for unicast PTP messages transmitted over IPv4 UDP.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles do not support this command.
You must configure this command when the PTP profile is ITU-T G.8275.2.
This command takes effect only when PTP messages are transmitted over IPv4 UDP.
Examples
# Set the destination IP address to 10.10.10.2 for unicast PTP messages transmitted over IPv4 UDP.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp
[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
ptp unicast-negotiate
Use ptp unicast-negotiate to enable unicast negotiation.
Use undo ptp unicast-negotiate to disable unicast negotiation.
Syntax
ptp unicast-negotiate { grant-port | request-port }
undo ptp unicast-negotiate
Default
Unicast negotiation is disabled.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
grant-port: Specifies the port as a grant-port.
request-port: Specifies the port as a request-port.
Usage guidelines
Only the ITU-T G.8275.2 PTP profile supports this command.
The ITU-T G.8275.2 PTP profile allows you to establish a PTP synchronization tree by specifying the request-ports and master-ports.
A request-port initiates a connection request to a specific grant-port. They negotiate PTP parameters and exchange PTP messages to synchronize the client time to the server. Plan the network in advance and specify the ports on the member (client) clock nodes as request-ports and the ports on the master (server) clock nodes as grant-ports.
If you do not configure this command, the synchronization tree is established through dynamic election.
For unicast negotiation to take effect, you must execute also the ptp unicast-destination command. The ports on a T-TSC-P clock node cannot be specified as grant-ports.
Examples
# Enable unicast negotiation on Twenty-FiveGigE 1/0/1 and specify the port as a request-port.
<Sysname> system-view
[Sysname] ptp profile g8275.2
[Sysname] ptp mode t-bc-p
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2
[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-negotiate request-port
[Sysname-Twenty-FiveGigE1/0/1] ptp enable
Related commands
ptp mode
ptp profile
ptp unicast-destination
ptp utc
Use ptp utc to set the correction date for Coordinated Universal Time (UTC).
Use undo ptp utc to remove the correction date configured for UTC.
Syntax
ptp utc { leap59-date | leap61-date } date
undo ptp utc { leap59-date | leap61-date }
Default
No correction date is configured for UTC.
Views
System view
Predefined user roles
network-admin
Parameters
leap59-date: Adjusts UTC at the last minute (23:59) of the specified date so that UTC is one second slower than TAI.
leap61-date: Adjusts UTC at the last minute (23:59) of the specified date so that UTC is one second faster than TAI.
date: Sets the date to adjust UTC, in the format of YYYY/MM/DD. The value range for YYYY and MM is 2000 to 2035 and 1 to 12, respectively. The value range for DD depends on the specified month. For the configuration to take effect, do not specify a date earlier than the current date.
Usage guidelines
An offset exists between UTC and TAI. The device displays UTC time. However, PTP uses TAI for time synchronization. For the device to synchronize correct time to other clock nodes in the PTP domain when its local clock is selected as the GM, configure this command to correct the offset between UTC and TAI.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
This command takes effect only when it is configured on the master clock node and the local clock of the master clock node is the GM.
Specify either the leap59-date or leap61-date keyword in this command. If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Assume the current date is August 8, 2019. Specify the BC clock node type as BC. Adjust UTC at the last minute of December 31, 2019 so that UTC is one second slower than the TAI.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp domain 0
[Sysname] ptp utc leap59-date 2019/12/31
Related commands
ptp domain
ptp mode
ptp profile
ptp utc offset
Use ptp utc offset to set the cumulative offset between UTC and International Atomic Time (TAI).
Use undo ptp utc offset to restore the default.
Syntax
ptp utc offset utc-offset
undo ptp utc offset
Default
The cumulative offset between UTC and TAI is 0 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
utc-offset: Sets the cumulative offset between UTC and TAI, in seconds. The value is in the range of 0 to 999.
Usage guidelines
An offset exists between UTC and TAI. The device displays UTC time. However, PTP uses TAI for time synchronization. For the device to synchronize correct time to other clock nodes in the PTP domain when its local clock is selected as the GM, configure this command to correct the offset between UTC and TAI.
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
Examples
# Set the cumulative offset to 37 seconds between UTC and TAI.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] ptp utc offset 37
Related commands
ptp domain
ptp mode
ptp profile
ptp vlan
Use ptp vlan to specify a VLAN tag for PTP messages.
Use undo ptp vlan to restore the default.
Syntax
ptp vlan vlan-id [ dot1p dot1p-value ]
undo ptp vlan [ dot1p ]
Default
PTP messages do not have a VLAN tag.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
vlan vlan-id: Specifies a VLAN by its ID. The value range is 1 to 4094.
dot1p dot1p-value: Specifies an 802.1p precedence for PTP messages, in the range of 0 to 7. The default 802.1p precedence is 7 (the highest).
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
Examples
# Specify VLAN 2 and set the 802.1p precedence to 6 for PTP messages on Twenty-FiveGigE1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] ptp vlan 2 dot1p 6
Related commands
ptp domain
ptp mode
ptp profile
reset ptp statistics
Use reset ptp statistics to clear PTP statistics.
Syntax
reset ptp statistics [ interface interface-type interface-number ]
Views
User view
Predefined user roles
network-admin
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command clears PTP statistics on all interfaces.
Examples
# Clear PTP statistics on Twenty-FiveGigE 1/0/1.
<Sysname> reset ptp statistics interface twenty-fivegige 1/0/1
Related commands
display ptp statistics