- Table of Contents
-
- 16-Network Management and Monitoring Command Reference
- 00-Preface
- 01-Ping and tracert commands
- 02-System debugging commands
- 03-NQA commands
- 04-NTP commands
- 05-SNMP commands
- 06-RMON commands
- 07-Event MIB commands
- 08-Sampler commands
- 09-Mirroring commands
- 10-NetStream commands
- 11-IPv6 NetStream commands
- 12-sFlow commands
- 13-CWMP commands
- 14-PTP commands
Title | Size | Download |
---|---|---|
14-PTP commands | 216.67 KB |
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
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 profile |
PTP standard: · IEEE 1588 version 2. · IEEE 802.1AS. · AES67-2015. |
PTP mode |
Clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC. |
Slave only |
Whether the OC operates in Slave only mode: · Yes. · No. |
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. |
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 |
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
Slave port Correction time Corrections(s,ns) Rate ratio
HGE1/0/1 Mar 11 03:14:54 2019 0,74 0.999999973
HGE1/0/1 Mar 11 03:14:55 2019 -1,17 0.999999980
Table 2 Command output
Field |
Description |
Slave port |
Name of the subordinate port. |
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. |
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 or AES67-2015.
· You have specified a PTP mode and PTP domain for the device.
· The device has a subordinate port or a port in 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
----------------------- -------------------- --- --- --- --- --- ------ --- ---
Interface Clock ID P1 P2 LP C A OSLV SR GM
----------------------- -------------------- --- --- --- --- --- ------ --- ---
HGE1/0/1 62214E-FFFE-B20100 128 128 N/A 248 254 65535 0 Yes
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. 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
Name State Delay mechanism Clock step Asymmetry correction
HGE1/0/1 Slave E2E Two 0
HGE1/0/2 Passive E2E Two 0
# Display detailed PTP running information for HundredGigE 1/0/1.
<Sysname> display ptp interface hundredgige 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 : 0 (ns)
Table 4 Command output
Field |
Description |
Name |
Name of the PTP interface. |
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. |
Asymmetry correction |
Asymmetric delay correction value (in nanoseconds). |
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. |
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. |
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:
· No PTP profile, PTP mode, or PTP domain is configured for the device.
· The clock node type of the device is 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
The command displays information correctly only after you have specified a PTP profile and a PTP clock node type.
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 |
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 HundredGigE 1/0/1.
<Sysname> display ptp statistics interface hundredgige 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 : HundredGigE1/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 on ToD 1. The 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 range for this argument is 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 range for this argument is 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.
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 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.
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.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
The master node sends announce messages to the member nodes at intervals configured on the member nodes.
Examples
# Set the announce message sending interval to 4 (22) seconds on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp announce-interval 2
Related commands
ptp domain
ptp mode
ptp profile
ptp announce-timeout
Use ptp announce-timeout to set the timeout multiplier for the announce message receiving interval.
Use undo ptp announce-timeout to restore the default.
Syntax
ptp announce-timeout multiple-value
undo ptp announce-timeout
Default
The timeout multiplier for the announce message receiving interval 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 the announce message receiving interval, in the range of 2 to 10.
Usage guidelines
A master node periodically sends announce messages to the member nodes. If a member node does not receive any announce message from the master node within multiple-value times the announce message sending interval configured on the master node, it determines that the master node is invalid.
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.
Examples
# Set the timeout multiplier for the announce message sending interval to 5 on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp announce-interval 2
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 HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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.
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 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
For the IEEE 1588 version 2 or AES67-2015 PTP profile, the request-response delay measurement applies.
For the IEEE 802.1AS PTP profile, the peer 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.
· The IEEE 802.1AS PTP profile supports only the peer delay measurement mechanism and does not support this command.
· This command is applicable only to BCs and OCs.
An E2ETC clock node supports both the request-response and peer delay measurement mechanisms, and a P2PTC supports only the peer delay measurement mechanism. This command is not applicable to these two clock node types.
Examples
# Specify the OC clock node type. Specify the request-response delay measurement mechanism (e2e) on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp delay-mechanism e2e
Related commands
ptp domain
ptp mode
ptp profile
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 and AES67-2015 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 HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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.
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 PTP profile does 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 HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp transport-protocol udp
[Sysname-HundredGigE1/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.
As a best practice, enable PTP on an interface after you complete PTP configuration on the interface.
To enable PTP on a Layer 2 Ethernet interface, make sure the VLAN interface for the VLAN to which the Layer 2 interface belongs is not associated with any VPN instance (the ip binding command not configured on the VLAN 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 HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp enable
# Specify the E2ETC clock node type and enable PTP on HundredGigE 1/0/1 and HundredGigE 1/0/2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode e2etc
[Sysname] ptp domain 1
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp enable
[Sysname-HundredGigE1/0/1] interface hundredgige 1/0/2
[Sysname-HundredGigE1/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.
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 HundredGigE 1/0/1 as a subordinate port.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp force-state slave
Related commands
ptp active force-state
ptp domain
ptp mode
ptp profile
ptp slave-only
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 or AES67-2015, the value of the interval argument is 0 and the minimum interval for sending 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 delay request messages. When the PTP profile is IEEE 1588 version 2, the value range for the interval argument is –4 to 6. When the PTP profile is AES67-2015, the value range for the interval argument is –3 to 5.
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.
When the PTP profile is AES67-2015, 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.
Examples
# Set the minimum interval to 4 (22) seconds for sending delay request messages on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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
ptp mode { bc | e2etc | e2etc-oc | oc | p2ptc | p2ptc-oc }
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.
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:
· You can specify only one clock node type for the device.
· When the PTP profile is 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 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 AES67-2015, the value range for the interval argument is 0 to 5. When the PTP profile is IEEE 1588 version 2 or IEEE 802.1AS, the value range for the interval argument is –4 to 6.
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 interval to 4 (22) seconds for sending peer delay request messages on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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.
Examples
# Specify the P2PTC+OC clock node type for the device. Specify the OC port type for HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode p2ptc-oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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 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.
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.
priority1 priority1: Specifies priority 1 for the clock, in the range of 0 to 255. 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. 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 }
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.
aes67-2015: Specifies the AES67-2015 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 PTP profile does 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 or AES67-2015, the interval argument value is –3 and the interval for sending Sync messages is 1/8 (2-3) 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 1588 version 2 or IEEE 802.1AS, the value range for the interval argument is –4 to 6. When the PTP profile is AES67-2015, the value range for the argument is –4 to 1.
Usage guidelines
You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.
A master node sends Sync messages to the member nodes at the interval set on its interfaces.
Examples
# Set the Sync message sending interval to 2 (21) seconds on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp syn-interval 1
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
Use ptp transport-protocol to specify the IPv4 PTP 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 and IEEE 802.1AS PTP profiles transport PTP messages over IEEE 802.3/Ethernet.
The AES67-2015 PTP profile transports 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 PTP 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 PTP profile supports only IEEE 802.3/Ethernet transport of PTP messages and does not support this task.
The AES67-2015 PTP profile supports only UDP transport of PTP messages and does not support this task.
Examples
# Specify the IPv4 PTP transport protocol for PTP messages on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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 ITU-T G.8275.1 PTP profile does not support this command.
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 hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ptp transport-protocol udp
[Sysname-HundredGigE1/0/1] ptp unicast-destination 10.10.10.2
Related commands
ptp domain
ptp mode
ptp profile
ptp transport-protocol
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 for the vlan-id argument 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 HundredGigE1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 0
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/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 HundredGigE 1/0/1.
<Sysname> reset ptp statistics interface hundredgige 1/0/1
Related commands
display ptp statistics