Only the default MDC supports PTP. Non-default MDCs do not support PTP or PTP commands. For more information about MDCs, see Virtual Technologies Configuration Guide.

Field	Description
PTP instance ID	ID of the PTP instance.
Sync State	Whether the time of the PTP instance can be used to synchronize the local system time. · Active—Yes. · Inactive—No.
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 ] [ all | instance ptp-instance-id ]

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.

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

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, or AES67-2015.

· You have specified a PTP mode and PTP domain for the device.

· The device has a port in slave, passive, or subordinate state.

If you do not specify a PTP instance or all PTP instances, this command displays foreign master node information on PTP instance 0.

Examples

# Display information about foreign master nodes for all interfaces.

<Sysname> display ptp foreign-masters-record

P1=Priority1, P2=Priority2, C=Class, A=Accuracy,

OSLV=Offset-scaled-log-variance, SR=Steps-removed

GM=Grandmaster

----------------------- -------------------- ---- ---- ---- ---- ------ ---- ---

Interface Clock ID P1 P2 C A OSLV SR GM

----------------------- -------------------- ---- ---- ---- ---- ------ ---- ---

XGE3/0/1 62214E-FFFE-B20100 128 128 248 254 65535 0 Yes

# Display information about foreign master nodes of all interfaces on PTP instance 0.

<Sysname> display ptp foreign-masters-record

P1=Priority1, P2=Priority2, C=Class, A=Accuracy,

OSLV=Offset-scaled-log-variance, SR=Steps-removed

GM=Grandmaster

----------------------- -------------------- ---- ---- ---- ---- ------ ---- ---

Interface Clock ID P1 P2 C A OSLV SR GM

----------------------- -------------------- ---- ---- ---- ---- ------ ---- ---

XGE3/0/1 62214E-FFFE-B20100 128 128 248 254 65535 0 Yes

# Display information about foreign master nodes of all interfaces on all PTP instances.

<Sysname> display ptp foreign-masters-record all

P1=Priority1, P2=Priority2, C=Class, A=Accuracy,

OSLV=Offset-scaled-log-variance, SR=Steps-removed

GM=Grandmaster

Interface : Ten-GigabitEthernet3/0/1

------------- -------------------- ---- ---- ---- ---- ------ ---- ---

Instance ID Clock ID P1 P2 C A OSLV SR GM

------------- -------------------- ---- ---- ---- ---- ------ ---- ---

0 62214E-FFFE-B20100 128 128 248 254 65535 0 Yes

Interface : Ten-GigabitEthernet3/0/2

------------- -------------------- ---- ---- ---- ---- ------ ---- ---

Instance ID Clock ID P1 P2 C A OSLV SR GM

------------- -------------------- ---- ---- ---- ---- ------ ---- ---

1 66E331-FFFE-960300 100 128 248 254 65535 0 Yes

Table 3 Command output

Field	Description
Instance ID	ID of the PTP instance.
Interface	PTP interface name.
Clock ID	Clock ID of the foreign master node.
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 instance

Use display ptp instance to display information about PTP instances.

Syntax

display ptp instance [ ptp-instance-id | all ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

all: Specifies all PTP instances.

Usage guidelines

The PTP instance information is displayed only after you have specified a PTP profile, PTP mode, and a PTP domain for the device.

If you do not specify a PTP instance or all PTP instances, this command displays information about PTP instance 0.

Examples

# Display information about PTP instance 0.

<Sysname> display ptp instance

PTP instance ID : 0

PTP instance name : default-instance

PTP domain : 100

PTP profile : IEEE 1588 Version 2

PTP mode : BC

Sync state : Inactive

# Display information about all PTP instances.

<Sysname> display ptp instance all

PTP instance ID : 0

PTP instance name : default-instance

PTP domain : 100

PTP profile : IEEE 1588 Version 2

PTP mode : BC

Sync state : Inactive

PTP instance ID : 1

PTP instance name : -

PTP domain : 200

PTP profile : IEEE 802.1AS

PTP mode : BC

Sync state : Active

Table 4 Command output

Field	Description
PTP instance ID	ID of the PTP instance.
PTP instance name	Name of the PTP instance.
PTP domain	PTP domain to which the PTP instance associates.
PTP profile	PTP standard: · IEEE 1588 version 2. · IEEE 802.1AS. · SMPTE ST 2059-2. · AES67-2015.
PTP mode	Clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC.
Sync state	Whether the instance participates in time synchronization. · Active—Yes. · Inactive—No.

Related commands

ptp instance

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 ] [ all | instance ptp-instance-id ]

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.

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

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.

If you do not specify a PTP instance or all PTP instances, this command displays information on PTP instance 0.

Examples

# Display brief PTP running information for all PTP interfaces.

<Sysname> display ptp interface brief

Name State Delay mechanism Clock step Asymmetry correction

XGE3/0/1 Slave E2E Two 0

XGE3/0/2 Passive E2E Two 0

# Display detailed PTP running information for Ten-GigabitEthernet 3/0/1.

<Sysname> display ptp interface ten-gigabitethernet 3/0/1

Clock ID : 000FE2-FFFE-FF0000

Port number : 15

PTP version : 2

PTP state : Enabled

Transport protocol of PTP : User Datagram Protocol (IPv4)

Unicast destination address : 10.10.10.2

DSCP priority : 56

Port state : Slave

Unicast negotiate port role : Request-port

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)

# Display brief PTP running information for all PTP interfaces on all PTP instances.

<Sysname> display ptp interface brief

Name InstID State Delay mechanism Clock step Asymmetry correction

XGE3/0/1 0 Slave E2E Two 0

XGE3/0/2 1 Slave P2P Two 0

# Display detailed PTP running information for all PTP interfaces on PTP instance 0.

<Sysname> display ptp interface

Interface : Ten-GigabitEthernet3/0/1

Clock ID : 66AAC8-FFFE-480200

Port number : 258

PTP version : 2

PTP state : Enabled

Transport protocol of PTP : IEEE 802.3/Ethernet

Port state : Slave

Unicast negotiate port role : Request-port

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) : 0

Delay request interval (log mean) : 0

Peer delay request interval (log mean) : 0

Mean path delay : 1357 (ns)

# Display detailed PTP running information for all PTP interfaces on all PTP instances.

<Sysname> display ptp interface all

Interface : Ten-GigabitEthernet3/0/1

PTP instance ID : 0

Clock ID : 66AAC8-FFFE-480200

Port number : 258

PTP version : 2

PTP state : Enabled

Transport protocol of PTP : IEEE 802.3/Ethernet

Port state : Slave

Unicast negotiate port role : Request-port

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) : 0

Delay request interval (log mean) : 0

Peer delay request interval (log mean) : 0

Mean path delay : 1357 (ns)

Interface : Ten-GigabitEthernet3/0/2

PTP instance ID : 1

Clock ID : 66AAC8-FFFE-480200

Port number : 259

PTP version : 2

PTP state : Enabled

Transport protocol of PTP : IEEE 802.3/Ethernet

Port state : Slave

Unicast negotiate port role : Request-port

Force state : No

Clock step : Two

Asymmetry correction : 0

Delay mechanism : Peer to Peer

Announce interval (log mean) : 0

Announce receipt time out : 3

Sync interval (log mean) : -3

Delay request interval (log mean) : 0

Peer delay request interval (log mean) : 0

Mean path delay : 1426 (ns)

Table 5 Command output

Field	Description
PTP instance ID	ID of the PTP instance.
InstID	ID of the PTP instance.
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: · One—Single-step mode. · Two—Two-step mode.
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 state	Whether PTP is enabled on the port: · Enabled. · Disabled.
Transport protocol of PTP	PTP message transport protocol: · User Datagram Protocol (IPv4). · IEEE 802.3/Ethernet.
Port state	PTP port state. It has the same value as the State field.
Unicast negotiate port role	This field is available only when the PTP profile is IEEE 1588 version 2. Role of the port for unicast negotiation. · Request-port · Grant-port This field displays Invalid when unicast negotiation is disabled on the port.
Unicast destination address	Destination IP address for unicast PTP messages that are 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 that are 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.
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 [ all | instance ptp-instance-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

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.

· The ptp active force-state command has been executed.

If you do not specify a PTP instance or all PTP instances, this command displays information on PTP instance 0.

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 : 32

Offset (log variance) : 65535

Priority1 : 128

Priority2 : 128

# Display information about the parent node on PTP instance 0.

<Sysname> display ptp parent

Parent clock:

Parent clock ID : 62214E-FFFE-B20100

Parent port number : 258

Observed parent offset (log variance) : N/A

Observed parent clock phase change rate : N/A

Grandmaster clock:

Grandmaster clock ID: 62214E-FFFE-B20100

Grandmaster clock quality:

Class : 248

Accuracy : 32

Offset (log variance) : 65535

Priority1 : 128

Priority2 : 128

# Display information about the parent node on all PTP instances.

<Sysname> display ptp parent all

PTP instance ID : 0

Parent clock:

Parent clock ID : 62214E-FFFE-B20100

Parent port number : 258

Observed parent offset (log variance) : N/A

Observed parent clock phase change rate : N/A

Grandmaster clock:

Grandmaster clock ID: 62214E-FFFE-B20100

Grandmaster clock quality:

Class : 248

Accuracy : 32

Offset (log variance) : 65535

Priority1 : 128

Priority2 : 128

PTP instance ID : 1

Parent clock:

Parent clock ID : 66E331-FFFE-960300

Parent port number : 259

Observed parent offset (log variance) : N/A

Observed parent clock phase change rate : N/A

Grandmaster clock:

Grandmaster clock ID: 66E331-FFFE-960300

Grandmaster clock quality:

Class : 248

Accuracy : 32

Offset (log variance) : 16640

Priority1 : 100

Priority2 : 248

Table 6 Command output

Field	Description
PTP instance ID	ID of the PTP instance.
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 [ all | instance ptp-instance-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

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 on PTP instance 0.

<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

# Display brief information about the PTP synchronization path from the GM to the device on all PTP instances.

<Sysname> display ptp path-trace all

PTP instance ID : 0

Sequence number Clock ID

1 000FE2-FFFE-FF0000

2 000FE3-FFFE-F90000

3 000FE4-FFFE-F50000

4 000FE5-FFFE-F20000

5 000FE6-FFFE-F70000

PTP instance ID : 1

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 7 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 port-history

Use display ptp port-history to display historical role change information for PTP ports.

Syntax

display ptp port-history [ interface interface-type interface-number ] [ all | instance ptp-instance-id ]

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 historical role change information for all interfaces.

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

Usage guidelines

If you do not specify a PTP instance or all PTP instances, this command displays historical role change information for all PTP ports on PTP instance 0.

Examples

# Display historical role change information for all PTP ports on PTP instance 0.

<Sysname> display ptp port-history

Interface: Ten-GigabitEthernet3/0/1

Role change: Disabled -> Listening

Time : Apr 15 08:56:50 2020

IfBMCInfo : 0 255 255 255 255 65535 65535 65535 65535 65535 6

Role change: Listening -> Master

Time : Apr 15 08:56:56 2020

IfBMCInfo : 0 255 255 255 255 65535 65535 65535 65535 65535 6

Table 8 Command output

Field	Description
Interface	PTP port name.
PTP instance ID	ID of the PTP instance.
Role change	Role change of the PTP port.
Time	Time at which the PTP port role was calculated.
IfBMCInfo	BMC information for the PTP port: · IEEE 1588 version 2, SMPTE ST 2059-2, AES67-2015—Includes the values of protocol type, priority 1, clock class, clock accuracy, priority 2, sending port number, receiving port number, source port number, hops, offset (log variance), and port number in sequence and separated by spaces. · IEEE 802.1AS—Includes the values of protocol type, priority 1, clock class, clock accuracy, priority 2, source port number, hops, offset (log variance), and port number in sequence and separated by spaces.

display ptp statistics

Use display ptp statistics to display PTP statistics.

Syntax

display ptp statistics [ interface interface-type interface-number ] [ all | instance ptp-instance-id ]

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.

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

Usage guidelines

The command displays PTP statistics only after you have specified a PTP profile, PTP mode, and PTP domain for the device.

If you do not specify a PTP instance or all PTP instances, this command displays information on PTP instance 0.

Examples

# Display PTP statistics on Ten-GigabitEthernet 3/0/1.

<Sysname> display ptp statistics interface ten-gigabitethernet 3/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 : Ten-GigabitEthernet3/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

# Display PTP statistics on all interfaces on all PTP instances.

<Sysname> display ptp statistics all

Interface : Ten-GigabitEthernet3/0/1

PTP instance ID : 0

Received packets

--------------------------------------------------------------------------

Announce :2359 Sync :4712 Signaling :0

DelayReq :0 DelayResp :4462 FollowUp :4712

PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0

Sent packets

--------------------------------------------------------------------------

Announce :8 Sync :14 Signaling :0

DelayReq :4462 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

Interface : Ten-GigabitEthernet3/0/2

PTP instance ID : 1

Received packets

--------------------------------------------------------------------------

Announce :3642 Sync :30325 Signaling :0

DelayReq :0 DelayResp :0 FollowUp :30325

PdelayReq:3640 PdelayResp:3661 PdelayRespFollowUp :3661

Sent packets

--------------------------------------------------------------------------

Announce :284 Sync :2339 Signaling :0

DelayReq :0 DelayResp :0 FollowUp :2339

PdelayReq:3942 PdelayResp:3640 PdelayRespFollowUp :3640

Discarded packets

--------------------------------------------------------------------------

Announce :0 Sync :0 Signaling :0

DelayReq :0 DelayResp :0 FollowUp :0

PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0

Table 9 Command output

Field	Description
PTP instance ID	ID of the PTP instance.
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 [ all | instance ptp-instance-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

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.

If you do not specify a PTP instance or all PTP instances, this command displays information on PTP instance 0.

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)

# Display PTP clock time information on PTP instance 0.

<Sysname> display ptp time-property

PTP clock time property:

Current UTC offset valid : False

Current UTC offset : 0

Leap59 : No

Leap61 : No

Time traceable : True

Frequency traceable : True

PTP timescale : True

Time source : 0xA0 (Internal oscillator)

# Display PTP clock time information on all PTP instances.

<Sysname> display ptp time-property all

PTP instance ID : 0

PTP clock time property:

Current UTC offset valid : False

Current UTC offset : 0

Leap59 : No

Leap61 : No

Time traceable : True

Frequency traceable : True

PTP timescale : True

Time source : 0xA0 (Internal oscillator)

PTP instance ID : 1

PTP clock time property:

Current UTC offset valid : False

Current UTC offset : 0

Leap59 : No

Leap61 : No

Time traceable : True

Frequency traceable : True

PTP timescale : True

Time source : 0xA0 (Internal oscillator)

Table 10 Command output

Field	Description
PTP instance ID	ID of the PTP instance.
Current UTC offset valid	Whether the Coordinated Universal Time (UTC) offset is valid: · True—Yes. · False—No.
Current UTC offset	Cumulative offset (in seconds) between the 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.

‌

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

PTP instance 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.

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

# In PTP instance view, activate the port role configuration.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] 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 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 PTP time locking threshold is 200 ns, and the PTP time unlocking threshold is 300 ns.

Views

System view

Predefined user roles

network-admin

Parameters

lock-value: Specifies the PTP time locking threshold in ns. The value range for this argument is 50 to 5000.

unlock-value: Specifies the PTP time unlocking threshold in ns. The value range for this argument is 50 to 5000.

Usage guidelines

This command is available only after you specify a PTP profile, PTP clock node type, and PTP domain.

You can configure the locking threshold and unlocking threshold separately. The PTP time unlocking threshold must be greater than or equal to the locking threshold. If you execute this command multiple times, the most recent configuration takes effect.

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 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 for notification.

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, PTP clock node type, and PTP domain.

Only the IEEE 1588 version 2 PTP profile supports 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 domain 2

[Sysname] ptp alarm-threshold clock-source-class 20

Related commands

ptp clock-source

ptp domain

ptp mode

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

Application scenarios

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 to notify the network administrator.

Restrictions and guidelines

This command is available only after you specify a PTP profile, a PTP clock node type, and a PTP domain.

Only the IEEE 1588 version 2 PTP profile supports this command.

Examples

# Set the time offset threshold between the external reference clock and the PTP clock to 800 ns.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp clock mode t-bc

[Sysname] ptp domain 2

[Sysname] ptp alarm-threshold time-offset 800

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 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

Interface PTP instance 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.

Usage guidelines

You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.

The interval at which the master node sends announce messages depends on whether unicast negotiation is enabled.

· If unicast negotiation is not enabled, the master node uses the value configured by using the ptp announce-interval command on its interface as the interval.

· If unicast negotiation is enabled, 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp announce-interval 2

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the announce message sending interval to 4 (22) seconds.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

PTP instance 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.

· IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015—If a member node does not receive any announce message from the master node within multiple-value times the announce message sending interval, it determines that the master node is invalid.

· IEEE 802.1AS—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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp announce-timeout 5

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the timeout multiplier for the announce message sending interval to 5.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

Interface PTP instance 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp asymmetry-correction plus 100

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the asymmetric delay correction time to 100 nanoseconds.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp asymmetry-correction plus 100

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

Interface PTP instance 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp clock-step two-step

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify the two-step timestamp-carrying mode.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

The default setting varies by PTP profile:

· IEEE 1588 version 2, AES67-2015, or SMPTE ST 2059-2 PTP profile—The request-response delay measurement applies.

· IEEE 802.1AS PTP profile—The peer delay measurement mechanism applies.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Interface PTP instance 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. Follow these restrictions and guidelines when you configure this command:

· IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015 PTP profile:

¡ You can configure this command only for a BC or OC clock node.

¡ The E2ETC, E2ETC+OC, P2PTC, and P2PTC+OC clock nodes do not support this command. The E2ETC and E2ETC+OC clock nodes support both the request-response and peer delay measurement mechanisms. The P2PTC clock node supports only the peer delay measurement mechanism.

¡ The ptp delay-mechanism p2p command and the ptp unicast-negotiate command are mutually exclusive.

· IEEE 802.1AS PTP profile: Supports only the peer 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp delay-mechanism e2e

# On PTP instance 1, specify the OC clock node type. Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify the request-response delay measurement mechanism (e2e).

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp delay-mechanism e2e

Related commands

ptp domain

ptp mode

ptp profile

ptp unicast-negotiate

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 0 and the minimum interval for sending Delay_resp messages is 1 (20) seconds.

Views

Layer 3 Ethernet interface view

Interface PTP instance 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 IEEE 1588 version 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 1588v2

[Sysname] ptp mode bc

[Sysname] ptp domain 2

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-destination 10.10.10.2

[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-negotiate request-port

[Sysname-Ten-GigabitEthernet3/0/1] ptp delay-resp-interval -3

Related commands

ptp domain

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 for non-peer delay messages is 011B-1900-0000.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Interface PTP instance 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, and AES67-2015 PTP profiles do not support this command.

This command is available only after you specify IEEE 1588 version 2 or SMPTE ST 2059-2 as the PTP profile and specify a PTP mode.

Peer delay messages include Pdelay_Req, Pdelay_Resp, and Pdelay_Resp_Follow_Up messages. The destination MAC address for peer delay messages is 0180-C200-000E, which cannot be modified.

This command takes effect only if PTP messages are encapsulated in IEEE 802.3/Ethernet packets.

Examples

# Set the destination MAC address for non-peer delay messages to 0180-C200-000E on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp destination-mac 0180-c200-000e

# On PTP instance 1, specify the OC clock node type. Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the destination MAC address for non-peer delay messages to 0180-C200-000E.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

PTP instance view

Predefined user roles

network-admin

Parameters

domain-number: Specifies a PTP domain by its number. When the PTP profile is IEEE 1588 version 2, IEEE 802.1AS, or AES67-2015, the value range for the domain-number argument is 0 to 255. When the PTP profile is SMPTE ST 2059-2, the value range for the domain-number argument is 0 to 127.

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

# In PTP instance view, assign the device to PTP domain 2.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] 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

Interface PTP instance 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp

[Sysname-Ten-GigabitEthernet3/0/1] ptp dscp 63

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the DSCP value to 63 for PTP messages transmitted over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp transport-protocol udp

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

Interface PTP instance 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.

For PTP to run on an interface, enable PTP globally and on the interface. 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.

For a PTP-enabled interface to run PTP correctly, do not add that interface to an aggregation group.

You cannot enable PTP on an aggregate member interface.

Examples

# Specify the OC clock node type and enable PTP on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp enable

# Specify the E2ETC clock node type and enable PTP on Ten-GigabitEthernet 3/0/1 and Ten-GigabitEthernet 3/0/2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode e2etc

[Sysname] ptp domain 1

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp enable

[Sysname-Ten-GigabitEthernet3/0/1] interface ten-gigabitethernet 3/0/2

[Sysname-Ten-GigabitEthernet3/0/2] ptp enable

# On PTP instance 1, specify the OC clock node type. Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Enable PTP.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname] ptp domain 2

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp enable

Related commands

ptp domain

ptp global enable

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

Interface PTP instance 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

You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device.

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 a role 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 only one subordinate port for a device.

After changing the role of a PTP port, you must execute the ptp active force-state command for the new PTP port role to take effect.

Under the IEEE 1588 version 2 PTP profile, the ptp force-state command and the ptp unicast-negotiate command are mutually exclusive.

Examples

# Specify the OC clock node type and specify Ten-GigabitEthernet 3/0/1 as a subordinate port.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp force-state slave

# On PTP instance 1, specify the OC clock node type. Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify Ten-GigabitEthernet 3/0/1 as a subordinate port.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname] ptp domain 0

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp force-state slave

Related commands

ptp active force-state

ptp domain

ptp mode

ptp profile

ptp slave-only

ptp unicast-negotiate

ptp global enable

Use ptp global enable to enable PTP globally.

Use undo ptp global enable to disable PTP globally.

Syntax

ptp global enable

undo ptp global enable

Default

PTP is enabled globally.

Views

System view

Predefined user roles

network-admin

Usage guidelines

For PTP to run on an interface, enable PTP globally and on the interface.

Examples

# Enable PTP globally.

<Sysname> system-view

[Sysname] ptp global enable

Related commands

ptp enable

ptp instance (interface view)

Use ptp instance to assign an interface to a PTP instance and enter interface PTP instance view.

Use undo ptp instance to remove an interface from a PTP instance.

Syntax

ptp instance ptp-instance-id

undo ptp instance ptp-instance-id

Default

An interface is assigned to PTP instance 0.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ptp-instance-id: Specifies a PTP instance ID. The value is in the range of 1 to 3. The PTP instance must have been configured in system view.

Usage guidelines

If the device belongs to multiple PTP domains, you need to configure and associate a PTP instance to each PTP domain. In PTP instance view, you can configure PTP settings such as PTP profile and clock node type. The settings take effect only on the PTP domain associated with the PTP instance. PTP instances are isolated from each other, allowing different PTP timing systems running on a network without affecting each other.

PTP settings configurable in Ethernet interface view can also be configured in interface PTP instance view. PTP settings configured in Ethernet interface view take effect only on PTP instance 0. PTP settings configured in interface PTP instance view take effect only on the instance to which the interface is assigned.

Examples

# Assign Layer 2 interface Ten-GigabitEthernet3/0/1 to PTP instance 1 and enter interface PTP instance view.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-1]

Related commands

ptp instance (system view)

Use ptp instance to create a PTP instance and enter PTP instance view. If the PTP instance exists, the device enters PTP instance view directly.

Use undo ptp instance to delete a PTP instance.

Syntax

ptp instance ptp-instance-id [ name ptp-instance-name ]

undo ptp instance ptp-instance-id

Default

PTP instance numbered 0 and named default-instance exists.

Views

System view

Predefined user roles

network-admin

Parameters

ptp-instance-id: Specifies a PTP instance ID. The value is in the range of 1 to 3.

name ptp-instance-name: Specifies a PTP instance name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the PTP instance is not configured with a name.

Usage guidelines

When the device belongs to multiple PTP domains, you need to configure and associate a PTP instance to each PTP domain. In PTP instance view, you can configure PTP settings such as PTP profile and clock node type. The settings take effect only on the PTP domain associated with the PTP instance. PTP instances are isolated from each other, allowing different PTP timing systems running on a network without affecting each other.

A PTP instance is uniquely identified by its ID on a device. For easy identification and management, you can also set a name for a PTP instance.

Do not set a same name for different PTP instances.

If you use this command to create PTP instances with the same ID but different names, the most recent configuration takes effect.

PTP instance 0 is the default PTP instance. You cannot create or delete PTP instance 0. PTP settings configured in system view take effect only on PTP instance 0. To configure settings for a PTP instance other than PTP instance 0, enter PTP instance view.

Examples

# Create PTP instance 1 and enter its view.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1]

# Create PTP instance numbered 1 and named ptp 1 and enter its view.

<Sysname> system-view

[Sysname] ptp instance 1 name ptp1

[Sysname-ptp-instance-1]

Related commands

ptp instance (interface view)

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 minimum interval for sending delay request messages is 1 (20) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Interface PTP instance 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 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.

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 SMPTE ST 2059-2 or 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp min-delayreq-interval 2

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the minimum interval to 4 (22) seconds for sending delay request messages.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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 or SMPTE ST 2059-2 PTP profile:

ptp mode { bc | e2etc | oc | p2ptc }

undo ptp mode

Default

No clock node type is specified.

Views

System view

PTP instance view

Predefined user roles

network-admin

Parameters

bc: Specifies the boundary clock (BC) type.

e2etc: Specifies the end-to-end transparent clock (E2ETC) type.

NOTE:

SF interface modules does not support the e2etc keyword.

‌

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.

This command is available only after you specify a PTP profile.

When the PTP profile is IEEE 802.1AS, you cannot specify the E2ETC or E2ETC+OC clock node type.

When the PTP profile is SMPTE ST 2059-2 or AES67-2015, you cannot specify the E2ETC+OC or P2PTC+OC clock node type.

Examples

# Specify the OC clock node type for the device.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

# In PTP instance view, specify the OC clock node type.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

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

PTP instance 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

# Disable PTP path tracing in PTP instance view.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] 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

Interface PTP instance 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.

Examples

# Set the interval to 4 (22) seconds for sending peer delay request messages on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp pdelay-req-interval 2

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the interval to 4 (22) seconds for sending peer delay request messages.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

Interface PTP instance 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 and AES67-2015 PTP profiles do not support this command.

Examples

# Specify the P2PTC+OC clock node type for the device. Specify the OC port type for Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode p2ptc-oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp port-mode oc

# On PTP instance 1, specify the P2PTC+OC clock node type. Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify the OC port type for Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode p2ptc-oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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 { priority1 priority1 | priority2 priority2 }

undo ptp priority clock-source local { 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.

Views

System view

PTP instance view

Predefined user roles

network-admin

Parameters

local: Specifies the local clock.

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, in the range of 0 to 255. 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.

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

# In PTP instance view, set priority 1 to 10 for the local clock.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] ptp priority clock-source local priority1 10

Related commands

ptp domain

ptp mode

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 }

undo ptp profile

Default

PTP operates only after you specify a PTP profile.

Views

System view

PTP instance 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.

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

# In PTP instance view, specify the IEEE 1588 version 2 PTP profile.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] 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

PTP instance 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.

Under the IEEE 1588 version 2 PTP profile, the ptp slave-only command and the ptp unicast-negotiate command are mutually exclusive.

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

# In PTP instance view, specify the OC clock node type and configure the OC to operate only as a member clock.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] ptp slave-only

Related commands

ptp domain

ptp force-state

ptp mode

ptp profile

ptp unicast-negotiate

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

PTP instance 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 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

# In PTP instance view, configure the source IP address as 3.5.1.5 for multicast PTP messages transmitted over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] 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.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Interface PTP instance 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 IEEE 1588 version 2, 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 –1. 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.

As a best practice, set the interval to –2 or –4 when the PTP profile is IEEE 1588 version 2. If you set the interval to 6, clock synchronization accuracy might be reduced.

The interval at which the master node sends Sync messages to member nodes depends on whether unicast negotiation is enabled (only the IEEE 1588 version 2 PTP profile supports unicast negotiation).

· If unicast negotiation is not enabled, the master node uses the value configured by using the ptp syn-interval command on its interface as the interval.

· If unicast negotiation is enabled, 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 Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp syn-interval 1

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the Sync message sending interval to 2 (21) seconds.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] quit

[Sysname-ptp-instance-1] ptp domain 1

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp syn-interval 1

Related commands

ptp domain

ptp mode

ptp profile

ptp time-offset

Use ptp time-offset to configure the PTP offset threshold and the number of times PTP time synchronization is suppressed.

Use undo ptp time-offset to restore the default.

Syntax

ptp time-offset { suppression-count suppression-count | suppression-threshold threshold-value } *

undo ptp time-offset { suppression-count | suppression-threshold } *

Default

The PTP offset threshold is 3000 nanoseconds and PTP time synchronization will be suppressed twice.

Views

System view

PTP instance view

Predefined user roles

network-admin

Parameters

suppression-count suppression-count: Specifies the number of times PTP time synchronization is suppressed. The value is in the range of 2 to 80. By default, PTP time synchronization is surpressed twice.

suppression-threshold threshold-value: Specifies the PTP time offset threshold, in nanoseconds. The value range for the threshold-value argument is 50 to 1000000. By default, the PTP time offset threshold is 3000 nanosecond.

Usage guidelines

After master-member relationships are established between the clock nodes, the master and member clock nodes exchange PTP messages and record the message transmit and receive time. Based on the timestamps, each member clock calculates the path delay and then gets the time offset between them and the master clock and adjusts their time accordingly for time synchronization with the master clock.

If the calculated offset exceeds the threshold, the device will suppress PTP time synchronization. Only when the number of suppressions reaches the specified value, the device performs PTP time synchronization. This prevents the device from synchronizing to an incorrect PTP time when the PTP time provided by the master device is instable.

You can configure this command only when the PTP profile, PTP clock node type, and PTP domain are all specified.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the PTP offset threshold to 5000 nanoseconds in system view.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp domain 1

[Sysname] ptp time-offset suppression-threshold 5000

# Set the PTP offset threshold to 5000 nanoseconds in PTP instance view.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode bc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] ptp time-offset suppression-threshold 5000

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

PTP messages are transported through IEEE 802.3 and Ethernet.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Interface PTP instance 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.

This command is not available for the IEEE 802.1AS, SMPTE ST 2059-2, or AES67-2015 PTP profile.

Examples

# Specify the IPv4 PTP transport protocol for PTP messages on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify the IPv4 PTP transport protocol for PTP messages.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

Layer 3 interface PTP instance 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 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 ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp

[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-destination 10.10.10.2

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Set the destination IP address to 10.10.10.2 for unicast PTP messages transmitted over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-1] ptp transport-protocol udp

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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

Interface PTP instance 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

Application scenarios

On a network where the IEEE 1588 version 2 PTP profile runs, you can establish master-subordinate relations between PTP ports by specifying the request-ports and grant-ports with this command. If you do not configure this command, the master-subordinate relations are established through dynamic election.

Operating mechanism

After this command is configured, a request-port initiates a PTP link 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.

Restrictions and guidelines

Only the IEEE 1588 version 2 PTP profile supports this command.

For unicast negotiation to take effect, you must configure also the ptp unicast-destination command.

Follow these restrictions and guidelines to configure unicast negotiation under the IEEE 1588 version 2 PTP profile:

· The ptp transport-protocol udp command must be configured for unicast negotiation to take effect.

· The E2ETC, P2PTC, and P2PTC-OC clock nodes do not support unicast negotiation

· This command is mutually exclusive with the ptp slave-only, ptp force-state, and ptp delay-mechanism p2p commands.

Examples

# Enable unicast negotiation on Ten-GigabitEthernet 3/0/1 and specify the port as a request-port.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp domain 2

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp unicast-destination 10.10.10.2

[Sysname-GigabitEthernet1/0/1] ptp unicast-negotiate request-port

[Sysname-GigabitEthernet1/0/1] ptp enable

Related commands

ptp domain

ptp mode

ptp profile

ptp unicast-destination

ptp slave-only

ptp force-state

ptp delay-mechanism

ptp utc

Use ptp utc to add or subtract one second from the UTC scale on the specified date.

Use undo ptp utc to restore the default.

Syntax

ptp utc { leap59-date | leap61-date } date

undo ptp utc { leap59-date | leap61-date }

Default

No second is added to or subtracted from the UTC scale.

Views

System view

PTP instance view

Predefined user roles

network-admin

Parameters

leap59-date: Subtracts one second from the UTC time scale at the last minute (23:59) on the specified date.

leap61-date: Adds one second to the UTC time scale at the last minute (23:59) on the specified date.

date: Sets the date to adjust the 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

UTC is based on International Atomic Time (TAI), a high-precision atomic coordinate time scale, and adjusted by leap seconds for synchronization with astronomical time.

UTC is constantly compared with UT1 (astronomical time, reflecting the earth's rotation). The International Bureau of Weights and Measures (BIPM) will notify to add or subtract one second from the UTC time scale at the last minute on a specific date (typically June 30 or December 31) to ensure that the difference between UTC and UT1 is within one second.

You can use this command to add or subtract one second from the UTC time on the specific date as published by BIPM.

You can configure this command only after you have specified a PTP profile and PTP mode 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.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Assume that the current date is August 8, 2016. Specify the BC clock node type for the device. According to information published by BIPM, add one second to the UTC time at 23:59:60 on December 31, 2016.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp utc offset 36

[Sysname] ptp utc leap61-date 2016/12/31

Related commands

ptp mode

ptp profile

ptp utc offset

Use ptp utc offset to set the cumulative offset of UTC relative to TAI.

Use undo ptp utc offset to restore the default.

Syntax

ptp utc offset utc-offset

undo ptp utc offset

Default

The cumulative offset of UTC relative to TAI is 0 seconds.

Views

System view

PTP instance view

Predefined user roles

network-admin

Parameters

utc-offset: Sets the cumulative offset of UTC relative to TAI, in seconds. The value range for the utc-offset argument is 0 to 999.

Usage guidelines

A time difference exists between UTC and TAI. Internet devices typically use the UTC time. To provide more accurate time, PTP also uses TAI. If the device acts as a subordinate clock node, it uses the UTC time and TAI time of the clock reference. If the device acts as the clock reference, it will calculate the TAI time based on the UTC time, and synchronize the UTC and TAI time to the subordinate clocks. TAI provided by the device = Current UTC + cumulative offset + leap second.

BIPM periodically publishes the cumulative offset of UTC relative to TAI. Use the value published by BIPM to configure this command.

You can configure this command only after you have specified a PTP profile and PTP mode 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.

Examples

# According to information published by BIPM, the cumulative offset of UTC relative to TAI is 37 seconds. Set the cumulative offset of UTC relative to TAI to 37 seconds.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp utc offset 37

Related commands

ptp mode

ptp profile

ptp utc

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

Layer 2 Ethernet interface PTP instance 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 Ten-GigabitEthernet3/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp vlan 2 dot1p 6

# Assign Ten-GigabitEthernet 3/0/1 to PTP instance 1 and enter interface PTP instance view. Specify VLAN 2 and set the 802.1p precedence to 6 for PTP messages.

<Sysname> system-view

[Sysname] ptp instance 1

[Sysname-ptp-instance-1] ptp profile 1588v2

[Sysname-ptp-instance-1] ptp mode oc

[Sysname-ptp-instance-1] ptp domain 1

[Sysname-ptp-instance-1] quit

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] ptp instance 1

[Sysname-Ten-GigabitEthernet3/0/1-ptp-instance-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 ] [ all | instance ptp-instance-id ]

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.

all: Specifies all PTP instances.

instance ptp-instance-id: Specifies a PTP instance by its ID. The value range for the ptp-instance-id argument is 1 to 3.

Usage guidelines

If you do not specify a PTP instance or all PTP instances, this command clears PTP statistics on PTP instance 0.

Examples

# Clear PTP statistics on Ten-GigabitEthernet 3/0/1.

<Sysname> reset ptp statistics interface ten-gigabitethernet 3/0/1

# Clear PTP statistics on Ten-GigabitEthernet3/0/1 on the default PTP instance.

<Sysname> reset ptp statistics interface ten-gigabitethernet 3/0/1

# Clear PTP statistics on Ten-GigabitEthernet3/0/1 on PTP instance 1.

<Sysname> reset ptp statistics interface ten-gigabitethernet 3/0/1 instance 1

Related commands

display ptp statistics

snmp-agent trap enable ptp

Use snmp-agent trap enable ptp to enable SNMP notification for the PTP module.

Use undo snmp-agent trap enable ptp to disable SNMP notification for the PTP module.

Syntax

snmp-agent trap enable ptp

undo snmp-agent trap enable ptp

Default

SNMP notification is enabled for the PTP module.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Application scenarios

To be informed of important events of the PTP module, enable SNMP notification for the PTP module.

Prerequisites

The notifications generated for the PTP module will be sent to the SNMP module of the device. Configure SNMP notification parameters for the notifications to be output as needed.

Examples

# Disable SNMP notification for the PTP module.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable ptp

Related commands

display snmp-agent trap-list (SNMP commands in Network Management and Monitoring Command Reference)

Field	Description
PTP global state	Whether PTP is enabled globally: · Enabled. · Disabled.
PTP instance ID	ID of the PTP instance.
PTP profile	PTP standard: · IEEE 1588 version 2. · IEEE 802.1AS. · SMPTE ST 2059-2. · 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.
Lock status	Whether the PTP time is locked: · Locked. · Unlocked.
Clock ID	Clock ID for the device, which uniquely identifies a PTP device.
Clock type	Clock type of the device: Local—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.

12-Network Management and Monitoring Command Reference

PTP commands

Application scenarios

Restrictions and guidelines

ptp delay-resp-interval

ptp source

Application scenarios

Operating mechanism

Restrictions and guidelines

reset ptp statistics

Application scenarios

Prerequisites

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us