Field	Description
PTP profile	PTP standard: · IEEE 1588 version 2. · ITU-T G.8275.1. · ITU-T G.8275.2.
PTP mode	PTP clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC. · T-BC. · T-TC. · T-TSC. · T-BC-P. · T-TSC-P.
Slave only	Whether the OC operates in Slave only mode: · Yes. · No.
Sync uncertain	Whether the device is enabled to notify the downstream nodes of its time synchronization state: · Disabled. · Enabled.
Clock state	PTP clock state: · Disabled—The PTP clock state feature is disabled. · Free-Run—The PTP clock has never been synchronized to a time source and is not in the process of synchronizing to a time source. · Acquiring—The PTP clock is in the process of synchronizing to a time source. · Locked—The PTP clock has been synchronized to a time source. · Holdover—The PTP clock is in holdover state.
Lock status	Whether the PTP time is in lock state. · 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. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock.
ToD direction	ToD input or output: · IN—The device receives clock signals from an external ToD clock. · N/A—The device neither receives nor transmits ToD clock signals. This field is not displayed for a local clock.
ToD delay time	Delay correction value in nanoseconds for the ToD clock. This field is not displayed when the device is a local clock.
Clock domain	PTP domain where the device resides.
Priority1	Priority 1 value for the PTP clock.
Priority2	Priority 2 value for the PTP clock.
Local priority	Local priority of the PTP clock. (This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.)
Class	Time class of the device. For the ToD clock source, when the value for In-Status is Inactive, this field displays the configured time class of the ToD clock source (default value is 187). When the value for In-Status column is Active, this field displays the actual effective time class of the ToD clock source.
Accuracy	Time accuracy of the device.
Offset (log variance)	Offset of the grandmaster clock.
Offset from master	Offset from the master clock node (parent clock node), in nanoseconds. N/A indicates that information for this field is not obtained.
Mean path delay	Mean path delay, in nanoseconds. N/A indicates that information for this field is not obtained.
Steps removed	Hops from the grandmaster to the local clock node. N/A indicates that information for this field is not obtained.
Clock source info	Information about the clock source.
Clock	Clock source type: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock.
Pri1	Priority 1 value of the clock source.
Pri2	Priority 2 value of the clock source.
LP	Local priority of the clock source. (This field is available only for the ITU-T G.8275.1 PTP profile.)
TimeSrc	Time source of the clock source.
Direction	For a local clock source, this field displays N/A. For a ToD clock source, the values include: · In—The device receives ToD clock signals. · Out—The device transmits ToD clock signals. · N/A—The device does not receive or transmit ToD clock signals.
In-Status	Whether the clock source is active: · Active. · Inactive.

display ptp corrections

Use display ptp corrections to display PTP corrections that have occurred on a subordinate port.

Syntax

display ptp corrections

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The PTP corrections are displayed only when the following conditions are met:

· You have specified a PTP profile and PTP clock node type for the device.

· The device has a subordinate port and has performed time or frequency synchronization through the port.

If the subordinate port is changed, the recorded information will be cleared.

Examples

# Display PTP corrections that have occurred on a subordinate port.

<Sysname> display ptp corrections

Slave port Correction time Corrections(s,ns) Rate ratio

XGE3/1/1 Mar 11 03:14:54 2012 0,74 0.999999973

XGE3/1/1 Mar 11 03:14:55 2012 -1,17 0.999999980

Table 2 Command output

Field	Description
Slave port	Name of the subordinate port.
Correction time	Time when the correction occurred.
Corrections(s,ns)	Time corrections in seconds or nanoseconds. N/A indicates that no correction occurred this time.
Rate ratio	Ratio of the subordinate port rate to the master port rate. N/A indicates that no correction occurred this time.

display ptp foreign-masters-record

Use display ptp foreign-masters-record to display information about foreign master nodes.

Syntax

display ptp foreign-masters-record [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about foreign master nodes for all interfaces.

Usage guidelines

Foreign master node information is displayed only when the following conditions are met:

· The PTP profile is IEEE 1588 version 2 or ITU-T G.8275.1.

· You have specified a PTP clock node type for the device.

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

Examples

# Display information about foreign master nodes for all interfaces.

<Sysname> display ptp foreign-masters-record

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

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

GM=Grandmaster

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

Interface Clock ID P1 P2 LP C A OSLV SR GM

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

XGE3/1/1 000FE2-FFFE-FF0000 0 128 128 248 254 65535 0 Yes

XGE3/1/2 000FE2-FFFE-FF0001 0 128 128 248 254 65535 1 No

Table 3 Command output

Field	Description
Interface	Name of a PTP interface.
Clock ID	Clock ID of the foreign master node.
LP	Local priority of the interface. It will be used as the local priority of the peer node in BMC selection. This field is available only for the ITU-T G.8275.1 PTP profile.
C	Time class.
A	Time accuracy.
OSLV	Offset of the grandmaster clock.
SR	Hops from the grandmaster to the local clock node.
GM	Whether the node represents the grandmaster clock: · Yes. · No.

display ptp interface

Use display ptp interface to display PTP running information for one or all PTP interfaces.

Syntax

display ptp interface [ interface-type interface-number | brief ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP running information for all PTP interfaces.

brief: Displays brief PTP running information for all PTP 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

This command displays detailed PTP information only for PTP-enabled interfaces. The brief PTP running information can be displayed only when PTP is operating on the interface.

Examples

# Display brief PTP running information for all PTP interfaces.

<Sysname> display ptp interface brief

Name State Delay mechanism Clock step Asymmetry correction

XGE3/1/1 Slave E2E Two 0

XGE3/1/2 Passive E2E Two 0

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

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

Clock ID : 000FE2-FFFE-FF0000

Port number : 15

PTP version : 2

PTP enable : Enabled

Transport of PTP : User Datagram Protocol (IPv4)

Unicast destination address : 10.10.10.2

DSCP priority : 56

Port state : Slave

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

Delay response interval (log mean) : 0

Peer delay request interval (log mean) : 0

Local priority : 128

NotSlave : FALSE

Mean path delay : 1357 (ns)

Table 4 Command output

Field	Description
Name	Name of the PTP interface.
State	States of the PTP interface: · Slave—Receives synchronization messages. · Uncalibrated—Temporary state before the interface enters Slave state. · Passive—Neither receives nor sends synchronization messages. A PTP interface is in passive state after it receives an announce messages. · Master—Sends synchronization messages. · Premaster—Temporary state before the interface enters Master state. · Listening—Neither receives nor sends synchronization messages. A PTP interface is in listening state after being initialized. · Faulty—PTP is running incorrectly. A PTP interface in faulty state does not process PTP messages. · Disabled—PTP is not running on the interface. A PTP interface in disabled state does not process PTP messages. · Initializing—The interface is initializing. A PTP interface in initializing state does not process PTP messages. · N/A—No PTP interface state is obtained.
Delay mechanism	Delay measurement mechanism: · End to End—Request-response mechanism. · Peer to Peer—Peer delay mechanism.
Clock step	Mode for carrying timestamps: · 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 enable	Whether PTP is enabled or disabled: · Enabled. · Disabled.
Transport of PTP	PTP messages are transported by: · User Datagram Protocol (IPv4). · IEEE 802.3/Ethernet.
Unicast destination address	Destination IP address for unicast PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp unicast-destination command is not executed.
Unicast negotiate port role	This field is available only when the PTP profile is IEEE 1588 version 2 or ITU-T G.8275.2. Role of the port for unicast negotiation. This field displays Invalid when unicast negotiation is disabled on the port. · Request-port · Grant-port
DSCP priority	DSCP value for PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp dscp command is not executed.
VLAN	VLAN ID for PTP messages. This field is not displayed if the ptp vlan command is not executed.
Dot1p priority	802.1p precedence for PTP messages. This field is not displayed if the ptp vlan command is not executed.
Force state	Whether the force state is configured: · Yes. · No.
Announce interval (log mean)	Announce message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).
Announce receipt time out	Number of announcement intervals before the receiving node stops receiving announce messages. If a member node does not receive any announce message from the master node within the specified value, it considers the master node invalid.
Sync interval (log mean)	Sync message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).
Delay request interval (log mean)	Minimum delay request message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).
Delay response interval (log mean)	Delay response message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).
Peer delay request interval (log mean)	Peer delay request message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).
Local priority	Priority of the peer node. This field is available only for the ITU-T G.8275.1 profile.
NotSlave	Whether or not the NotSlave feature is enabled. This field is available only for the ITU-T G.8275.1 profile.
Mean path delay	Mean path delay, in nanoseconds.

display ptp parent

Use display ptp parent to display parent node (master node) information for the PTP device.

Syntax

display ptp parent

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The command does not display any information when any of the following conditions are met:

· No PTP profile is specified.

· No PTP clock node type is specified, or the PTP clock node type is TC or T-TC.

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

Examples

# Display parent node information for the PTP device.

<Sysname> display ptp parent

Parent clock:

Parent clock ID : 000FE2-FFFE-FF0005

Parent port number : 15

Observed parent offset (log variance) : N/A

Observed parent clock phase change rate : N/A

Grandmaster clock:

Grandmaster clock ID: 000FE2-FFFE-FF0000

Grandmaster clock quality:

Class : 248

Accuracy : 254

Offset (log variance) : 65535

Priority1 : 128

Priority2 : 128

Table 5 Command output

Field	Description
Parent port number	Outgoing interface number of the parent clock.
Observed parent offset (log variance)	Offset from the parent clock node. N/A indicates that information for this field is not obtained.
Class	Time class of the grandmaster clock.
Accuracy	Time accuracy of the grandmaster clock.
Offset (log variance)	Offset of the grandmaster clock.
Priority1	Priority 1 value of the grandmaster clock.
Priority2	Priority 2 value of the grandmaster clock.

display ptp path-trace

Use display ptp path-trace to display brief information about the PTP synchronization path from the GM to the device.

Syntax

display ptp path-trace

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The command displays information correctly only after you have specified a PTP profile and a PTP clock node type.

This command does not take effect if one of the following conditions exists:

· No PTP profile, PTP clock node type, or PTP domain is configured.

· The clock node type is E2ETC, E2ETC-OC, P2PTC, P2PTC-OC, or T-TC.

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

Examples

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

<Sysname> display ptp path-trace

Sequence number Clock ID

1 000FE2-FFFE-FF0000

2 000FE3-FFFE-F90000

3 000FE4-FFFE-F50000

4 000FE5-FFFE-F20000

5 000FE6-FFFE-F70000

Table 6 Command output

Field	Description
Sequence number	Sequence number of the clock node.
Clock ID	ID of the clock node

Related commands

ptp active force-state

ptp domain

ptp mode

ptp profile

display ptp statistics

Use display ptp statistics to display PTP statistics.

Syntax

display ptp statistics [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP statistics for all interfaces.

Usage guidelines

The command does not display any PTP statistics if you have not specified a PTP profile or a PTP clock node type.

Examples

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

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

Table 7 Command output

Field	Description
Received packets	Statistics about received PTP messages.
Sent packets	Statistics about sent PTP messages.
Discarded packets	Statistics about discarded PTP messages.

display ptp time-property

Use display ptp time-property to display PTP clock properties.

Syntax

display ptp time-property

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

This command does not display any information in any of the following circumstances:

· You have not specified a PTP standard or a clock node type.

· You have specified the clock node type as e2etc or p2ptc.

· You have executed the ptp active force-state command.

Examples

# Display PTP clock properties.

<Sysname> display ptp time-property

PTP clock time property:

Current UTC offset valid : True

Current UTC offset : 33

Leap59 : Yes

Leap61 : No

Time traceable : True

Frequency traceable : True

PTP timescale : True

Time source : 0xA0 (Internal oscillator)

Sync uncertain : False

Table 8 Command output

Field	Description
Current UTC offset valid	Whether the 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.
Sync uncertain	Whether the upstream clock is not reliable: · True—The upstream clock is not reliable. · False—The upstream clock is reliable.

ptp { tod0 | tod1 }

Use ptp { tod0 | tod1 } to configure ToD input or output.

Use undo ptp { tod0 | tod1 } to restore the default.

Syntax

ptp tod0 input [ delay input-delay-time ]

undo ptp tod0 input

ptp tod1 output [ delay output-delay-time ]

undo ptp tod1 output

Default

Whether to receive or transmit ToD 0 clock signals is not configured, and the correction delay is not configured.

The device transmits ToD 1 clock signals, and the correction delay is 0 nanoseconds.

Views

System view

Predefined user roles

network-admin

Parameters

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

input: Configures the device to receive ToD clock signals.

delay input-delay-time: Specifies the receiving delay correction value in nanoseconds. The value is in the range of 0 to 2000000. The default value is 0.

output: Configures the device to transmit ToD clock signals as a master.

delay output-delay-time: Specifies the transmitting delay correction value in nanoseconds. The value is in the range of 0 to 1600. The default value is 0.

Usage guidelines

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

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

For the undo form of the command to take effect, first modify ToD input or output settings by executing this command.

Examples

# Configure the device to receive ToD clock signals from ToD 0 and set the receiving delay correction value to 1000 nanoseconds.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp tod0 input delay 1000

Related commands

ptp mode

ptp profile

ptp active force-state

Use ptp active force-state to activate the port role configuration.

Use undo ptp active force-state to restore the default.

Syntax

ptp active force-state

undo ptp active force-state

Default

The port role configuration is not activated.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

The T-TSC, T-TSC-P, and T-BC-P clock nodes do not support this command.

After you change the role of a PTP port, you must execute this command to activate the port role configuration.

Examples

# Activate the port role configuration.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp active force-state

Related commands

ptp force-state

ptp mode

ptp profile

ptp alarm-threshold clock-source-class

Use ptp alarm-threshold clock-source-class to set the class threshold for the clock source.

Use undo ptp alarm-threshold clock-source-class to restore the default.

Syntax

ptp alarm-threshold clock-source-class class-value

undo ptp alarm-threshold clock-source-class

Default

The class threshold for the clock source is 6.

Views

System view

Predefined user roles

network-admin

Parameters

class-value: Specifies a class threshold, in the range of 0 to 255.

Usage guidelines

Each PTP clock source has a class value. For a ToD clock source, you can set its class value by using the ptp clock-source command. The higher the value, the lower the class. When the class value of the clock source crosses the class threshold, the system outputs a log for notification.

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

Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.

Examples

# Set the class threshold to 20 for the clock source.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp clock mode t-bc

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

Related commands

ptp clock mode

ptp clock-source

ptp profile

ptp alarm-threshold { time-lock | time-unlock }

Use ptp alarm-threshold { time-lock threshold-value | time-unlock unlock-value } * to set the PTP time locking and unlocking thresholds.

Use undo ptp alarm-threshold { time-lock | time-unlock } * to restore the default.

Syntax

ptp alarm-threshold { time-lock lock-value | time-unlock unlock-value } *

undo ptp alarm-threshold { time-lock | time-unlock } *

Default

PTP time locking threshold and unlocking threshold are both 500 ns.

Views

System view

Predefined user roles

network-admin

Parameters

time-lock lock-value: Specifies the PTP time locking threshold in ns. The value is in the range of 20 to 3000.

time-unlock unlock-value: Specifies the PTP time unlocking threshold in ns. The value is in the range of 20 to 3000.

Usage guidelines

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

When the time offset of the PTP reference clock crosses the PTP time unlocking threshold, the PTP time is put into unlocked state. The system outputs a time-unlocked log entry for notification. When the time offset of the PTP reference clock drops to or below the PTP time locking threshold, the PTP time is put into locked state. The system outputs a time-locked log entry for notification.

The PTP time unlocking threshold must be greater than or equal to the locking threshold.

You can execute the command multiple times. If different values are configured for a threshold, the most recent configuration takes effect.

Examples

# Set the PTP time locking threshold to 100 ns.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp alarm-threshold time-lock 100

Related commands

ptp 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

If the device uses an external ToD reference clock, it calculates the time offset between the external reference clock and the PTP clock at a pre-defined interval (not configurable). When the offset exceeds the threshold, the device outputs a log for notification.

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

Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp clock mode t-bc

[Sysname] ptp alarm-threshold time-offset 800

Related commands

ptp mode

ptp profile

ptp alarm-threshold time-offset-sum pk-pk

Use ptp alarm-threshold time-offset-sum pk-pk to set the time-offset-sum peak-to-peak threshold.

Use undo ptp alarm-threshold time-offset-sum pk-pk to restore the default.

Syntax

ptp alarm-threshold time-offset-sum pk-pk threshold-value

undo ptp alarm-threshold time-offset-sum pk-pk

Default

The time-offset-sum peak-to-peak threshold is 500 ns.

Views

System view

Predefined user roles

network-admin

Parameters

threshold-value: Sets the time-offset-sum peak-to-peak threshold in the range of 0 to 2000, in ns.

Usage guidelines

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

The PTP module calculates the time-offset-sum peak-to-peak value at specific intervals and compares the value with the threshold configured by this command. If the value is larger than the threshold, the system outputs a log for notification.

Examples

# Set the time-offset-sum peak-to-peak threshold to 1500 ns.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp alarm-threshold time-offset-sum pk-pk 1500

Related commands

ptp 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

When the PTP profile is IEEE 1588 version 2, the interval argument value is 1 and the announce message sending interval is 2 (21) seconds.

When the PTP profile is ITU-T G.8275.1 and ITU-T G.8275.2, the interval argument value is –3 and the announce message sending interval is 1/8 (2-3) seconds.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending announce messages. The value range for the interval argument is –4 to 6 for the IEEE 1588 version 2 PTP profile, –3 to 6 for the ITU-T G.8275.1 PTP profile, and –3 to 0 for the ITU-T G.8275.2 PTP profile.

Usage guidelines

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

The configuration of the interval at which the master node sends announce messages depends on whether unicast negotiation is enabled (Devices that support unicast negotiation).

· When unicast negotiation is disabled, the master node uses the interval configured by using the ptp announce-interval command on its interface to send announce messages.

· When 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/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

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

FlexE physical interface view

Predefined user roles

network-admin

Parameters

multiple-value: Sets the timeout multiplier for the announce message receiving interval, in the range of 2 to 10.

Usage guidelines

A master node sends announce messages to the member nodes at the specified interval. If a member node does not receive any announce message from the master node after the timeout expires, it determines that the master node is invalid. The timeout = timeout multiplier × interval at which the master node sends announce messages.

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

To ensure a stable PTP network, set the timeout multiplier for receiving announce messages to a value in the range of 5 to 7.

The ITU-T G.8275.2 PTP profile does not support this command.

Examples

# Set the timeout multiplier for the announce message sending interval to 5 on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp announce-interval

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

FlexE physical interface view

Predefined user roles

network-admin

Parameters

minus: Subtracts the specified asymmetric delay correction value.

plus: Adds the specified asymmetric delay correction value.

value: Specifies the asymmetric delay correction value in the range of 0 to 2000000 nanoseconds.

Usage guidelines

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

Examples

# Set the asymmetric delay correction time to 100 nanoseconds on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

ptp clock-source

Use ptp clock-source to configure clock source parameters.

Use undo ptp clock-source to restore the default.

Syntax

Local clock source:

ptp clock-source local { accuracy acc-value | class class-value | time-source ts-value }

undo ptp clock-source local { accuracy | class | time-source }

ToD clock source:

ptp clock-source { tod0 | tod1 } { accuracy acc-value | class class-value | grandmaster-clockid clock-id | offsetscaled-logvariance value | time-source ts-value }

undo ptp clock-source { tod0 | tod1 } { accuracy | class | grandmaster-clockid | offsetscaled-logvariance | time-source }

Default

The clock ID of a GM clock is 000000-0000-000000.

· ITU-T G.8275.1 PTP profile

¡ T-TSC clock node type

- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.

- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.

¡ T-BC or T-TC clock node type

- Default PTP technical standard

Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value is not configurable.

ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.

- PTP OAM technical standard

Local clock source—The accuracy value is 254, the time class value is 165, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.

ToD clock source—The accuracy value is 254, the time class value is 165, the offset (log variance) value is 65535, and the time source value is 160.

- PTP Unicom technical standard

Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.

ToD clock source—The accuracy value is 33, the time class value is 6, the offset (log variance) value is 20061, and the time source value is 32.

· IEEE 1588 version 2

¡ The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is fixed and not configurable.

¡ ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) is 65535, and the time source value is 32.

· ITU-T G.8275.2

¡ T-TSC-P clock node type

- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.

- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.

¡ T-BC-P clock node type

- Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is fixed and not configurable.

- ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.

‌

NOTE:

Only the ITU-T G.8275.1 PTP profile supports PTP technical standards.

‌

Views

System view

Predefined user roles

network-admin

Parameters

local: Specifies the local clock.

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock. The device does not support this keyword.

accuracy acc-value: Specifies the accuracy of the ToD clock, in the range of 0 to 255. A smaller value indicates a higher accuracy. Table 9 shows the description for clock accuracy values.

Table 9 Clock accuracy value description

Clock accuracy value (in hexadecimal format)	Description
00 through 1F	Reserved.
20	Less than 25 nanoseconds (1 nanosecond = 10-9 second).
21	Less than 100 nanoseconds.
22	Less than 250 nanoseconds.
23	Less than 1 microsecond (10-6 second).
24	Less than 2.5 microseconds.
25	Less than 10 microseconds.
26	Less than 25 microseconds.
27	Less than 100 microseconds.
28	Less than 250 microseconds.
29	Less than 1 millisecond (10-3 second).
2A	Less than 2.5 milliseconds.
2B	Less than 10 milliseconds.
2C	Less than 25 milliseconds.
2D	Less than 100 milliseconds.
2E	Less than 250 milliseconds.
2F	Less than 1 second.
30	Less than 10 seconds.
31	More than 10 seconds.
32 through 7F	Reserved.
80 through FD	For use by alternate PTP profiles.
FE	Unknown.
FF	Reserved.

class class-value: Specifies the time class of the clock, in the range of 0 to 255. A smaller value indicates a higher time class. Table 10 shows the description for clock classes. The values not listed in the table are reserved by the protocol. As a best practice, do not use those values. The clock's time class is an attribute of the device. For a local clock source, keep its default time class and do not modify it as a best practice.

Table 10 Clock class description

Clock class (in decimal format)	Description
6	The clock node synchronizes its time to the master reference time source. PTP assigns a time table to the clock node. A clock node with time class 6 cannot become a member clock of any other clocks in the domain.
7	The former time class is 6. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. PTP assigns a time table to the clock node. A clock node with time class 7 cannot become a member clock of any other clocks in the domain.
13	The clock node synchronizes its time to a time source. ARB assigns a time table to the clock node. A clock node with time class 13 cannot become a member clock of any other clocks in the domain.
14	The former time class is 13. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. ARB assigns a time table to the clock node. A clock node with time class 14 cannot become a member clock of any other clocks in the domain.
52	The clock node with time class 7 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 52 cannot become a member clock of any other clocks in the domain.
58	The clock node with time class 14 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 58 cannot become a member clock of any other clocks in the domain.
187	The clock node with time class 7 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 187 can become a member clock of another clock in the domain.
193	The clock node with time class 14 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 193 can become a member clock of another clock in the domain.
248	Default time class value.
255	Clock node operating in slave-only mode.

grandmaster-clockid clock-id: Specifies the GM clock ID. The clock-id argument is in the XXXXXX-XXXX-XXXXXX format. X represents a hexadecimal number. A full 0 number is not supported. This option is not available for a local clock source. For a ToD clock source, you must specify this option.

offsetscaled-logvariance value: Specifies the offset (log variance). The value is in the range of 0 to 65535. This option is not available for a local clock source.

time-source ts-value: Specifies the clock attribute value in the range of 0 to 255. Table 11 shows the description for the clock attribute values (those not listed are reserved for the protocol).

Table 11 GM attribute value description

GM attribute values (in hexadecimal format)	Description
10	Atomic clock.
20	GPS.
30	Terrestrial radio.
40	PTP.
50	NTP.
60	Handset.
90	Other.
A0	Internal oscillator.
F0 to FE	For use by alternate PTP profiles.
FF	Reserved.

Usage guidelines

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

You can execute this command multiple times to configure different parameters. If you configure a parameter multiple times, the most recent configuration takes effect.

Examples

# Set the time accuracy for the ToD 0 clock to 44.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp clock-source tod0 accuracy 44

Related commands

ptp mode

ptp profile

ptp technical-standard

PTP clock-state enable

Use ptp clock-state enable to enable the PTP clock state feature.

Use undo ptp clock-state enable to disable the PTP clock state feature.

Syntax

ptp clock-state enable

undo ptp clock-state enable

Default

The PTP clock state feature is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The PTP clock state feature defines and clarifies the following PTP clock states:

· Free-Run—The PTP clock has never been synchronized to a time source and is not in the process of synchronizing to a time source.

· Acquiring—The PTP clock is in the process of synchronizing to a time source.

· Locked—The PTP clock has been synchronized to a time source within the acceptable accuracy.

· Holdover—The PTP clock is no longer synchronized to a time source and is using information obtained when it was previously synchronized.

This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.

This command is mutually exclusive with the ptp technical-standard command.

Examples

# Enable the PTP clock state feature.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp clock-state enable

Related commands

ptp mode

ptp profile

ptp technical-standard

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

FlexE physical interface view

Predefined user roles

network-admin

Parameters

one-step: Specifies the single-step mode.

two-step: Specifies the two-step mode.

Usage guidelines

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

Examples

# Specify the two-step timestamp carrying mode on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

ptp delay-mechanism

Use ptp delay-mechanism to specify a PTP delay measurement mechanism.

Use undo ptp delay-mechanism to restore the default.

Syntax

ptp delay-mechanism { e2e | p2p }

undo ptp delay-mechanism

Default

The request-response delay measurement mechanism applies.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

e2e: Specifies the request-response mechanism.

p2p: Specifies the peer delay mechanism.

Usage guidelines

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

When the PTP profile is IEEE 1588 version 2, the following restrictions apply:

· You can configure this command only on a BC or OC clock node.

· You cannot configure this command on an E2ETC, E2ETC+OC, P2PTC, or P2PTC+OC clock node. The E2ETC and E2ETC+OC clock nodes support both request-response and peer delay measurement mechanisms. A P2PTC clock node supports only the peer delay measurement mechanism.

The ITU-T G.8275.1 PTP profile supports only the request-response delay measurement mechanism and does not support this command.

The ITU-T G.8275.2 PTP profile supports only the request-response delay measurement mechanism and does not support this command.

In IEEE 1588 version 2, the E2ETC, P2PTC, and P2PTC-OC clock nodes do not support unicast negotiation.

The ptp delay-mechanism p2p and ptp unicast-negotiate commands are mutually exclusive.

Examples

# Specify the OC clock type. On Ten-GigabitEthernet 3/1/1, specify the request-response delay measurement mechanism (e2e).

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

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 default settings vary by PTP profile:

· When the PTP profile is IEEE 1588 version 2, the value of the interval argument is 0 and the interval at which the server sends Delay_resp messages to the client is 1 (20) seconds.

· When the PTP profile is ITU-T G.8275.2, the value of the interval argument is –4 and the interval at which the server sends Delay_resp messages to the client is 1/16 (2-4) seconds.

Views

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Delay_resp messages. The value range for this argument is –5 to 0.

Usage guidelines

Only the IEEE 1588 version 2 and ITU-T G.8275.2 PTP profiles support this command.

This command, configured on a request-port, specifies the interval at which the grant-port sends Delay_resp messages to the request-port.

After receiving a Delay_req message from a request port, the grant-port responses by sending a Delay_resp message and starts a timer defined by this command. The grant-port will not send another Delay_resp message until it receives a Delay_req message after the timer expires.

Examples

# Set the Delay_resp message sending interval to 2-3 seconds.

<Sysname> system-view

[Sysname] ptp profile g8275.2

[Sysname] ptp mode t-bc-p

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

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

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

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

Related commands

ptp mode

ptp profile

ptp unicast-destination

ptp unicast-negotiate

ptp destination-mac

Use ptp destination-mac to configure the destination MAC address for PTP 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.

The destination MAC address for peer delay messages is 0180-C200-000E.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies the destination MAC address for PTP unicast messages as any unicast MAC address or specifies the destination MAC address for non-peer delay multicast messages as 0180-C200-000E or 011B-1900-0000.

Usage guidelines

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

This command is not available for the ITU-T G.8275.2 PTP profile.

This command takes effect only if PTP messages are transported over IEEE 802.3/Ethernet packets.

IEEE 802.3/Ethernet-encapsulated PTP messages can be sent through multicast (default) or unicast. In multicast mode, the destination MAC address is 0180-C200-000E or 011B-1900-0000 for non-Pdelay messages and 0180-C200-000E for Pdelay messages. Non-Pdelay messages include delay_Req, delay_Resp, delay_Resp_Follow_Up, Announce, Sync, and FollowUp messages. Pdelay messages include Pdelay_Req, Pdelay_Resp, and Pdelay_Resp_Follow_Up messages.

If a clock node uses the unicast mode, you must configure any unicast MAC address on the uplink node of this clock node as the destination MAC address for PTP messages.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

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

When the PTP profile is IEEE 1588 version 2, the device is in PTP domain 0.

When the PTP profile is ITU-T G.8275.1, the device is in PTP domain 24.

When the PTP profile is ITU-T G.8275.2, the device is in PTP domain 44.

Views

System view

Predefined user roles

network-admin

Parameters

domain-number: Specifies a PTP domain by its number in the range of 0 to 255. For the ITU-T G.8275.1 PTP profile, the value range for the argument is 24 to 43. For the ITU-T G.8275.2 PTP profile, the value range for the argument is 44 to 63.

Usage guidelines

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

Examples

# Configure the PTP domain number to use for the device as 2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 2

Related commands

ptp mode

ptp profile

ptp dscp

Use ptp dscp to set a DSCP value for PTP messages transmitted over IPv4 UDP.

Use undo ptp dscp to restore the default.

Syntax

ptp dscp dscp

undo ptp dscp

Default

The DSCP value is 56 for PTP messages transmitted over IPv4 UDP.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

dscp: Sets a DSCP value in the range of 0 to 63 for PTP messages.

Usage guidelines

This command is available only after you specify a PTP profile and a PTP clock node type. The ITU-T G.8275.1 profile does not support this command.

This command takes effect only if PTP messages are transmitted over IPv4 UDP.

Examples

# Set the DSCP value to 63 for PTP messages transmitted over IPv4 UDP on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

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

Related commands

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

FlexE physical interface view

Predefined user roles

network-admin

Usage guidelines

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

For an OC, T-TSC, or T-TSC-P clock node, you can enable PTP only on one port.

As a best practice, enable PTP on an interface after you configure PTP parameters.

To enable PTP on a Layer 3 Ethernet interface that has been assigned to a VPN instance, you must specify this VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command if PTP messages are to be transmitted in multicast mode over IPv4 UDP.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode e2etc

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

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

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

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

Related commands

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 by the BMC algorithm.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

master: Specifies the PTP port as a master port.

passive: Specifies the PTP port as a passive port.

slave: Specifies the PTP port as a subordinate port.

Usage guidelines

By default, the PTP port roles are automatically negotiated based on the BMC algorithm. If you use this command to change the role of one PTP port, all the other PTP ports in the PTP domain stop working. For these PTP ports to function, you must specify roles for each of them by using this command. As a best practice, enable automatic negotiation of PTP port roles based on the BMC algorithm.

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

The T-TSC, T-TSC-P, and T-BC-P clock nodes do not support this command.

You can configure only one subordinate port for a device.

After you change the role of a PTP port, you must execute the ptp active force-state command to activate the port role configuration.

In IEEE 1588 version 2, this command is mutually exclusive with the ptp unicast-negotiate command.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp active force-state

ptp mode

ptp profile

ptp slave-only

ptp unicast-negotiate

ptp local-priority

Use ptp local-priority to configure a local priority for an interface.

Use undo ptp local-priority to restore the default.

Syntax

ptp local-priority local-priority

undo ptp local-priority

Default

The local priority of an interface is 128.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

local-priority: Specifies a priority in the range of 1 to 255. The lower the value, the higher the priority.

Usage guidelines

This command is available only after you specify a PTP profile and a PTP clock node type. Only the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles support this command.

An announce message does not carry the local priority of the clock node. Under the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile, each PTP-enabled interface on a clock node has a local priority. This priority will be used as the local priority of the peer node in BMC selection and is one of the factors that determine whether the peer node can be elected as the GM.

Examples

# Set the local priority for Ten-GigabitEthernet3/1/1 to 10.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

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

[Sysname-Ten-GigabitEthernet3/1/1] ptp local-priority 10

Related commands

ptp mode

ptp profile

ptp ignore sync-uncertain

Use ptp ignore sync-uncertain to enable the device to ignore the synchronizationUncertain flag.

Use undo ptp ignore sync-uncertain to disable ignoring the synchronizationUncertain flag.

Syntax

ptp ignore sync-uncertain

undo ptp ignore sync-uncertain

Default

The device does not ignore the synchronizationUncertain flag.

Views

System view

Predefined user roles

network-admin

Usage guidelines

By default, the device reads the value of the synchronizationUncertain flag in the announce message it receives.

· A synchronizationUncertain bit value of 1 indicates that synchronization information from the upstream node is unlocked.

· A synchronizationUncertain bit value of 0 indicates that synchronization information from the upstream node is locked.

If synchronization information from the upstream node is unlocked, the device will not use that information for time synchronization. Only if synchronization information from the upstream node is locked, the device uses that information for time synchronization.

Typically, you are not required to configure this command. If the upstream clock is very reliable, you can configure this command to enable the device to ignore the synchronizationUncertain flag. After this command is configured, the device will synchronize the time directly with synchronization information from the upstream clock without reading the synchronizationUncertain bit value.

This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.

Related commands

# Enable the device to ignore the synchronizationUncertain flag.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp ignore sync-uncertain

ptp max-steps-removed

Use ptp max-steps-removed to specify the maximum number of removed steps (clock nodes) from the GM to the device.

Use undo ptp max-steps-removed to restore the default.

Syntax

ptp max-steps-removed step-removed-value

undo ptp max-steps-removed

Default

The maximum number of removed steps is 255 from the GM to the device.

Views

System view

Predefined user roles

network-admin

Parameters

step-removed-value: Specifies the maximum number of removed steps from the GM to the device, in the range of 1 to 255.

Usage guidelines

If the number of removed steps from the GM to the device exceeds the maximum number, the device cannot synchronize time through PTP.

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

Examples

# Set the maximum number of removed steps from the GM to the device to 20.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp max-steps-removed 20

Related commands

ptp mode

ptp profile

ptp min-delayreq-interval

Use ptp min-delayreq-interval to set the minimum interval for sending delay request messages.

Use undo ptp min-delayreq-interval to restore the default.

Syntax

ptp min-delayreq-interval interval

undo ptp min-delayreq-interval

Default

When the PTP profile is IEEE 1588 version 2, the value of the interval argument is 0 and the minimum interval for sending delay request messages is 1 (20) second.

When the PTP profile is ITU-T G.8275.1 or ITU-T G.8275.2, the value of the interval argument is –4 and the minimum interval for sending delay request messages is 1/16 (2-4) seconds.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending delay request messages. The value range for the interval argument is –4 to 6. For the ITU-T G8275.2 PTP profile, the value range for the interval argument is –5 to 0.

Usage guidelines

When a member clock receives a Sync message, it responds by sending a Delay_Req message and starts a timer defined by this command. The member clock will not send another Delay_Req message until it receives a Sync message after the timer expires.

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

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 value on a member clock, 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.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

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

ITU-T G.8275.1 PTP profile:

ptp mode { t-bc | t-tc | t-tsc }

undo ptp mode

ITU-T G.8275.2 PTP profile:

ptp mode { t-bc-p | t-tsc-p }

undo ptp mode

Default

No clock node type is specified for the device.

Views

System view

Predefined user roles

network-admin

Parameters

bc: Specifies the boundary clock (BC) type.

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

e2etc-oc: Specifies the E2ETC+OC type.

oc: Specifies the ordinary clock (OC) type.

p2ptc: Specifies the peer-to-peer transparent clock (P2PTC) type.

p2ptc-oc: Specifies the P2PTC+OC type.

t-bc: Specifies the telecom boundary clock (T-BC) type.

t-tc: Specifies the telecom transparent clock (T-TC) type.

t-tsc: Specifies the telecom time slave clock (T-TSC) type.

t-bc-p: Specifies the partial-support telecom boundary clock (T-BC-P) type.

t-tsc-p: Specifies the partial-support telecom time slave clock (T-TSC-P) type.

Usage guidelines

CAUTION:

If you change the clock node type for the device, all settings except for the PTP profile will be removed.

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

· When the PTP profile is IEEE 1588 version 2, you cannot specify the T-TC, T-BC, or T-TSC clock node type.

· When the PTP profile is ITU-T G.8275.1, you can specify only the T-TC, T-BC, or T-TSC clock node type.

· When the PTP profile is ITU-T G.8275.2, you can specify only the T-BC-P or T-TSC-P clock node type.

You can specify only one clock node type for a device.

Changing or removing the clock node type will restore the default settings of the PTP profile.

Examples

# Specify the OC clock node type for the device.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

Related commands

ptp profile

ptp notslave disable

Use ptp notslave disable to disable the NotSlave feature.

Use undo ptp notslave disable to restore the default.

Syntax

ptp notslave disable

undo ptp notslave disable

Default

The NotSlave feature is enabled on a PTP interface.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Usage guidelines

The NotSlave feature, available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles, enables a PTP port to select the clock node where it resides as the master node. You can use this feature to control master/member role of the clock node. For automatic master/member clock node selection in a PTP domain under the ITU-T G.8275.1 PTP profile, you must disable NotSlave on all PTP ports.

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

Under the ITU-T G.8275.1 PTP profile, only the T-BC and T-TC clock node types support this command.

Under the ITU-T G.8275.2 PTP profile, only the T-BC-P clock node type supports this command.

By default, the ports on the T-BC-P and T-BC clock nodes are in master-only mode. To use a port on a T-BC-P or T-BC clock node as a subordinate port, first execute the ptp notslave disable command on the port.

Examples

# Disable the NotSlave feature on Ten-GigabitEthernet3/1/1.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

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

[Sysname-Ten-GigabitEthernet3/1/1] ptp notslave disable

Related commands

ptp mode

ptp profile

ptp path-trace disable

Use ptp path-trace disable to disable PTP path tracing.

Use undo ptp path-trace disable to enable PTP path tracing.

Syntax

ptp path-trace disable

undo ptp path-trace disable

Default

PTP path tracing is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

PTP path tracing traces the clock nodes that the clock signals traverse from the GM to the device. The system can obtain complete path tracing information only when all clock nodes on the path are enabled with PTP path tracing. If a device on the path does not support PTP path tracing, disable this feature to prevent PTP intercommunication issues.

This command is available only after you have specified a PTP profile and PTP clock node type.

Examples

# Disable PTP path tracing.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp path-trace disable

Related commands

display ptp path-trace

ptp mode

ptp profile

ptp pdelay-req-interval

Use ptp pdelay-req-interval to set the interval for sending peer delay request messages.

Use undo ptp pdelay-req-interval to restore the default.

Syntax

ptp pdelay-req-interval interval

undo ptp pdelay-req-interval

Default

The interval argument value is 0 and the interval for sending peer delay request messages is 1 (20) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending peer delay request messages. The value range for the interval argument is –4 to 6. If the PTP profile is IEEE 1588 version 2, the value range for the interval argument is 0 to 5.

Usage guidelines

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

The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

ptp port-mode

Use ptp port-mode to configure the interface type as OC for a TC+OC (including E2ETC+OC and P2PTC+OC) clock node.

Use undo ptp port-mode to restore the default.

Syntax

ptp port-mode oc

undo ptp port-mode

Default

All interfaces on an E2ETC+OC or a P2PTC+OC clock node is TC type.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

oc: Specifies the OC interface type.

Usage guidelines

This command is available only after you specify a PTP profile and a PTP clock node type. Only E2ETC+OC and P2PTC+OC clock nodes support this command.

The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.

Examples

# Specify the P2PTC+OC clock node type for the device. Configure the interface type for Ten-GigabitEthernet 3/1/1 as OC.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode p2ptc-oc

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

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

Related commands

ptp mode

ptp profile

ptp priority clock-source

Use ptp priority clock-source to configure the priority for a clock source.

Use undo ptp priority clock-source to restore the default.

Syntax

ptp priority clock-source { local | tod0 | tod1 } { local-priority local-priority | priority1 priority1 | priority2 priority2 }

undo ptp priority clock-source { local | tod0 | tod1 } { local-priority | priority1 | priority2 }

Default

When the PTP profile is IEEE 1588 version 2, the priority 1 and priority 2 values are both 128.

When the PTP profile is ITU-T G.8275.1, the priority 1 value is 128. The priority 2 value is 128 for both T-BC and T-TC clock nodes and 225 for a T-TSC clock node. The local priority value is 128.

When the PTP profile is ITU-T G.8275.2, the priority 1 value is 128. The priority 2 value is 128 for a T-BC-P clock node and 255 for a T-TSC-P clock node. The local priority value is 128.

Views

System view

Predefined user roles

network-admin

Parameters

local: Specifies the local clock.

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

local-priority local-priority: Specifies the local priority for the clock. The value is in the range of 0 to 255. A numerically smaller value has higher priority. This option is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.

priority1 priority1: Specifies priority 1 for the clock. The value is in the range of 0 to 255 for the IEEE 1588 version 2 PTP profile, and is 128 for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. A numerically smaller value indicates higher priority.

priority2 priority2: Specifies priority 2 for the clock. The value is in the range of 0 to 255 for the IEEE 1588 version 2 PTP profile. For the ITU-T G.8275.1 PTP profile, the value is in the range of 0 to 255 for T-BC and T-TC clock nodes and 255 for a T-TSC clock node. For the ITU-T G.8275.2 PTP profile, the value is in the range of 0 to 255 for a T-BC-P clock node and 255 for a T-TSC clock node. A numerically smaller value indicates higher priority.

Usage guidelines

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

The local priority of a clock will not be carried in PTP announce messages.

Examples

# Set priority 1 to 10 for the local clock.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp priority clock-source local priority1 10

Related commands

ptp mode

ptp profile

Use ptp profile to specify a PTP profile.

Use undo ptp profile to restore the default.

Syntax

ptp profile { 1588v2 | g8275.1 | g8275.2 }

undo ptp profile

Default

No PTP profile is specified for a device.

Views

System view

Predefined user roles

network-admin

Parameters

1588v2: Specifies the IEEE 1588 version 2 PTP profile.

g8275.1: Specifies the ITU-T G.8275.1 PTP profile.

g8275.2: Specifies the ITU-T G.8275.2 PTP profile.

Usage guidelines

You must first specify a PTP profile before configuring PTP commands.

Changing or removing a PTP profile clears all settings under the PTP profile.

Examples

# Specify the IEEE 1588 version 2 PTP profile.

<Sysname> system-view

[Sysname] ptp profile 1588v2

ptp slave-only

Use ptp slave-only to configure the OC to operate only as a member clock.

Use undo ptp slave-only to restore the default.

Syntax

ptp slave-only

undo ptp slave-only

Default

An OC can operate either as a master clock or a member clock.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command is applicable only to OCs and is available only after you specify a PTP profile and a PTP clock node type.

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.

In IEEE 1588 version 2, this command is mutually exclusive with the ptp unicast-negotiate command.

Examples

# Specify the clock node type as OC 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 slave-only

Related commands

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 transported over IPv4 UDP.

Use undo ptp source to remove the specified source IP address for multicast PTP messages transported 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 transported over IPv4 UDP.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for multicast PTP messages transported 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

This command is available only after you specify a PTP profile and a PTP clock type. The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.

This command takes effect only when PTP messages are transmitted over IPv4 UDP in multicast mode.

If a PTP-enabled Layer 3 Ethernet interface has been assigned to a VPN instance, you must specify the VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command.

Examples

# Specify 3.5.1.5 as the source address for multicast PTP messages transported over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp source 3.5.1.5

Related commands

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 ITU-T G.8275.1 or ITU G.8275.2, the interval argument value is –4 and the interval for sending Sync messages is 1/16 (2-4) seconds.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

FlexE physical interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Sync messages. The value range for the interval argument is -4 to 6 for the ITU-T G.8275.1 PTP profile, –4 to 6 for the IEEE 1588 version 2 PTP profile, and –5 to 0 for the ITU-T G.8275.2 PTP profile.

Usage guidelines

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

The master node sends Sync messages to the member nodes at intervals. The interval depends on whether unicast negotiation is enabled. (Devices that support unicast negotiation.)

· When unicast negotiation is disabled, the master node uses the interval configured by using the ptp syn-interval command on the device interface to send Sync messages.

· When 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/1/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

ptp sync-uncertain enable

Use ptp sync-uncertain enable to enable the device to notify the downstream nodes of its time synchronization state.

Use undo ptp sync-uncertain enable to disable the device from notifying the downstream nodes of its time synchronization state.

Syntax

ptp sync-uncertain enable

undo ptp sync-uncertain enable

Default

The device does not notify the downstream nodes of its time synchronization state.

Views

System view

Predefined user roles

network-admin

Usage guidelines

By default, the device transfers only the locked and unlocked status of the upstream node to the downstream nodes, and does not transfer its locked or unlocked status to the downstream nodes.

After this command is configured, the device notifies the downstream nodes of its locked and unlocked status through the synchronizationUncertain flag in the announce messages. The downstream nodes do not synchronize to the device when they receive information that the device time is unlocked and synchronize to the device when they receive information that the device time is locked.

This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.

Examples

# Enable the device to notify the downstream nodes of its time synchronization state.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp sync-uncertain enable

Related commands

ptp mode

ptp profile

ptp technical-standard

Use ptp technical-standard to specify a PTP technical standard.

Use undo ptp technical-standard to restore the default.

Syntax

ptp technical-standard { oam | cmcc | unicom }

undo ptp technical-standard

Default

The default PTP technical standard applies.

Views

System view

Predefined user roles

network-admin

Parameters

oam: Specifies the OAM standard.

cmcc: Specifies the CMCC standard.

unicom: Specifies the Unicom standard.

Usage guidelines

Operating mechanism

Only the ITU-T G.8275.1 PTP profile supports the OAM standard and Unicom standard. The default values for clock source-related parameters such as accuracy, time class, time source, and offset (log variance) differ between OAM and Unicom standards.

Only the IEEE 1588 version 2 PTP profile supports the CMCC standard. Configuring this standard affects the actual effective clock class of the ToD clock source.

If you configure the IEEE 1588 version 2 PTP profile and specify the CMCC standard, the device supports conversion between ToD status information and the IEEE 1588 version 2 clock class, as required by the CMCC standard:

· If you configure the clock class for the ToD clock source by using the ptp clock-source command, the actual effective clock class of the ToD clock source is the set value.

· If you do not configure the clock class for the ToD clock source (using the default value of 187), the clock card will automatically convert between the status information carried in the ToD clock signal and the IEEE 1588 version 2 clock class as shown in the following table:

Table 12 ToD status information and IEEE 1588 version 2 clock class

ToD status information	IEEE 1588 version 2 clock class
0x00 = Normal	6
0x01 = Time sync device (atomic clock) holdover	7
0x02 = Unavailable	255
0x03 = Time sync device (high-stability oscillator) holdover	52
0x04 = Transmission carrier equipment holdover	187
0x05 = Local rubidium clock holdover	8

ToD status information not included in Table 12 will be converted to IEEE 1588 version 2 clock class 255. IEEE 1588 version 2 clock classes not included in Table 12 will be converted to ToD status 0x02.

Restrictions and guidelines

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

This command is mutually exclusive with the ptp clock-state enable command.

Examples

# Specify the Unicom PTP technical standard.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp technical-standard unicom

Parameters of Clock Attribute will be restored to the default values. Continue? [Y/N]:y

Related commands

ptp clock-source

ptp clock-state enable

ptp mode

ptp profile

ptp transport-protocol

Use ptp transport-protocol to specify the IPv4 UDP transport protocol for PTP messages.

Use undo ptp transport-protocol to restore the default.

Syntax

ptp transport-protocol udp

undo ptp transport-protocol

Default

The IEEE 1588 version 2 and ITU-T G.8275.1 PTP profiles transport PTP messages over IEEE 802.3/Ethernet.

The ITU-T G.8275.2 PTP profile transports PTP messages over IPv4 UDP.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

udp: Specifies the IPv4 UDP transport protocol.

Usage guidelines

This command is available only after you specify a PTP profile and a PTP clock type. The ITU-T G.8275.1, and ITU G.8275.2 PTP profiles do not support this command.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

ptp unicast-destination

Use ptp unicast-destination to configure the destination IP address for unicast PTP messages transported 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 transported over IPv4 UDP.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the destination IP address for unicast PTP messages transported over IPv4 UDP.

Usage guidelines

This command is available only after you specify a PTP profile and a PTP clock node type. The ITU-T G.8275.1 PTP profile does not support this command.

When the PTP profile is ITU-T G.8275.2, you must configure this command.

This command takes effect only for unicast PTP messages transported over IPv4 UDP.

Examples

# Configure 10.10.10.2 as the destination address for unicast PTP messages transported over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

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

Related commands

ptp mode

ptp profile

ptp transport-protocol

ptp unicast-negotiate

Use ptp unicast-negotiate to enable unicast negotiation.

Use undo ptp unicast-negotiate to disable unicast negotiation.

Syntax

ptp unicast-negotiate { grant-port | request-port }

undo ptp unicast-negotiate

Default

Unicast negotiation is disabled.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

grant-port: Specifies the port as a grant-port.

request-port: Specifies the port as a request-port.

Usage guidelines

Application scenarios

The IEEE 1588 version 2 and ITU-T G.8275.2 PTP profiles allow you to establish a PTP synchronization tree by specifying the request-ports and master-ports. If you do not configure this command, the PTP synchronization tree is established dynamically.

Operating mechanism

After this command is configured, a request-port initiates a connection request to a specific grant-port. They negotiate PTP parameters and exchange PTP messages to synchronize the client time to the server. Plan the network in advance and specify the ports on the member (client) clock nodes as request-ports and the ports on the master (server) clock nodes as grant-ports to ensure successful unicast negotiation and PTP synchronization.

Restrictions and guidelines

Only the IEEE 1588 version 2 and ITU-T G.8275.2 PTP profiles support this command.

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

In ITU-T G.8275.2, you cannot configure a grant-port on a T-TSC-P.

In IEEE 1588 version 2, the following restrictions apply:

· For unicast negotiation to take effect, you must configure also the ptp transport-protocol udp command.

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

The ptp slave-only, ptp force-state, and ptp delay-mechanism p2p commands are mutually exclusive with each other.

Examples

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

<Sysname> system-view

[Sysname] ptp profile g8275.2

[Sysname] ptp mode t-bc-p

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

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

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

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

Related commands

ptp delay-mechanism

ptp force-state

ptp mode

ptp profile

ptp slave-only

ptp unicast-destination

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

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

Predefined user roles

network-admin

Parameters

utc-offset: Sets the cumulative offset of UTC relative to TAI, in seconds. The value is in the range of 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.

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 oc

[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

Predefined user roles

network-admin

Parameters

vlan vlan-id: Specifies a VLAN by its ID. The value is in the range of 1 to 4094.

dot1p dot1p-value: Specifies an 802.1p precedence for PTP messages. The value is in the range of 0 to 7. The default value is 7 (the highest). The device uses the default precedence value of 7 for PTP messages no matter which value is specified.

Usage guidelines

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

Examples

# Specify VLAN 2 and set the 802.1p precedence to 6 for PTP messages.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

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

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

Related commands

ptp mode

ptp profile

reset ptp statistics

Use reset ptp statistics to clear PTP statistics.

Syntax

reset ptp statistics [ interface interface-type interface-number ]

Views

User view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command clears PTP statistics on all interfaces.

Examples

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

<Sysname> reset ptp statistics interface ten-gigabitethernet 3/1/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 get 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 on the device for the SNMP module to send the notifications as required. For information about SNMP notifications, see SNMP configuration in Network Management and Monitoring Configuration Guide.

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)

15-Network Management and Monitoring Command Reference

PTP commands

ptp alarm-threshold time-offset-sum pk-pk

ptp destination-mac

ptp priority clock-source

ptp source

Operating mechanism

Restrictions and guidelines

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

Company Information

News & Events

Contact Us