13-Network Management and Monitoring Command Reference

HomeSupportSwitchesS6550X-HI SeriesReference GuidesCommand ReferencesH3C S6550X-HI Command References-R1116Pxx-6W10013-Network Management and Monitoring Command Reference
05-PTP commands
Title Size Download
05-PTP commands 270.17 KB

PTP commands

display ptp clock

Use display ptp clock to display PTP clock information.

Syntax

display ptp clock

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The PTP clock information is display only after you have specified a PTP profile, a PTP mode, and a PTP domain.

Examples

# Display PTP clock information.

<Sysname> display ptp clock

PTP profile         : IEEE 1588 Version 2

PTP mode            : BC

Slave only          : No

Sync uncertain      : Disabled

Clock state         : Disabled

Clock ID            : AD0000-FFFE-000000

Clock type          : Local

Clock domain        : 1

Number of PTP ports : 0

Priority1     : 128

Priority2     : 128

Clock quality :

 Class                 : 248

 Accuracy              : 254

 Offset (log variance) : 65535

Offset from master  : 0 (ns)

Mean path delay     : 0 (ns)

Steps removed       : 0

Local clock time    : Mon Jul 6 12:30:08 2020

Clock source info:

 Clock   Pri1 Pri2 Accuracy Class TimeSrc Direction In-Status Offset(log variance)

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

 Local   128  128  254      248   160     N/A       N/A       65535

 ToD0    128  128  32       6     32      N/A       Inactive  65535

 ToD1    128  128  32       6     32      N/A       Inactive  65535      

Table 1 Command output

Field

Description

PTP global state

Whether PTP is enabled globally:

·     Enabled.

·     Disabled.

PTP profile

PTP standard:

·     IEEE 1588 version 2.

·     IEEE 802.1AS.

·     SMPTE ST 2059-2.

·     AES67-2015.

·     ITU-T G.8275.1.

·     ITU-T G.8275.2.

PTP mode

Clock node type:

·     BC.

·     E2ETC.

·     E2ETC-OC.

·     OC.

·     P2PTC.

·     P2PTC-OC.

·     T-BC.

·     T-TC.

·     T-TSC.

·     T-BC-P.

·     T-TSC-P.

Slave only

Whether the OC operates in Slave only mode:

·     Yes.

·     No.

Sync uncertain

Whether the device is enabled to notify the downstream nodes of its time synchronization state:

·     Disabled.

·     Enabled.

Clock state

PTP clock state:

·     Disabled—The PTP clock state feature is disabled.

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

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

·     Locked—The PTP clock has been synchronized to a time source.

·     Holdover—The PTP clock is in holdover state.

Clock ID

Clock ID for the device, which uniquely identifies a PTP device.

Clock type

Clock type of the device:

·     Local—Local clock.

·     ToD0—ToD 0 clock.

·     ToD1—ToD 1 clock.

ToD delay time

Delay correction value in nanoseconds for the ToD clock. This field is not displayed when the device is a local clock.

Clock domain

PTP domain where the device resides.

Priority1

Priority 1 value for the device.

Priority2

Priority 2 value for the device.

Class

Time class of the device.

Accuracy

Time accuracy of the device.

Offset (log variance)

Offset of the grandmaster clock.

Offset from master

Offset from the master clock node (parent clock node), in nanoseconds.

N/A indicates that information for this field is not obtained.

Mean path delay

Mean path delay, in nanoseconds.

N/A indicates that information for this field is not obtained.

Steps removed

Hops from the grandmaster to the local clock node.

N/A indicates that information for this field is not obtained.

Clock source info

Information about the clock source.

Clock

Clock source type:

·     Local—Local clock.

·     ToD0—ToD 0 clock.

·     ToD1—ToD 1 clock.

Pri1

Priority 1 value of the clock source.

Pri2

Priority 2 value of the clock source.

LP

Local priority of the clock source. (This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.)

TimeSrc

Time source of the clock source.

Direction

For a local clock source, this field displays N/A.

For a ToD clock source, the values include:

·     IN—The device receives clock signals.

·     Out—The device transmits clock signals.

·     N/A—The device does not receive or transmit clock signals.

In-Status

For a local clock source, this field displays N/A.

For a ToD clock source, this field indicates whether the clock source is active:

·     Active.

·     Inactive.

display ptp corrections

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

Syntax

display ptp corrections

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

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

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

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

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

Examples

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

<Sysname> display ptp corrections

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

Mar 11 03:14:54 2019     0,74                  0.999999973  WGE1/0/1 

Mar 11 03:14:55 2019    -1,17                  0.999999980  WGE1/0/1     

Table 2 Command output

Field

Description

Correction time

Time when the correction occurred.

Corrections(s,ns)

Time corrections in seconds or nanoseconds.

N/A indicates that no correction occurred this time.

Rate ratio

Ratio of the subordinate port rate to the master port rate.

N/A indicates that no correction occurred this time.

Slave port

Name of the subordinate port.

display ptp foreign-masters-record

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

Usage guidelines

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

·     The PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, AES67-2015, ITU-T G.8275.1, or ITU-T G.8275.2.

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

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

Examples

# Display information about foreign master nodes for all interfaces.

<Sysname> display ptp foreign-masters-record

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

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

GM=Grandmaster

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

Clock ID             P1  P2  LP  C   A   OSLV   SR  GM  Interface

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

62214E-FFFE-B20100   128 128 N/A 248 254 65535  0   Yes WGE1/0/1                

Table 3 Command output

Field

Description

Interface

PTP interface name.

Clock ID

Clock ID of the foreign master node.

LP

Local priority of the interface. It will be used as the local priority of the peer node in BMC selection. (This field is available only for the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile.)

The value is N/A if the device does not support this configuration.

C

Time class.

A

Time accuracy.

OSLV

Offset of the grandmaster clock.

SR

Hops from the grandmaster to the local clock node.

GM

Whether the node represents the grandmaster clock:

·     Yes.

·     No.

display ptp interface

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

Syntax

display ptp interface [ interface-type interface-number ]

display ptp interface brief

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

brief: Displays brief PTP running information for all interfaces. If you do not specify this keyword, this command displays detailed PTP running information for the specified PTP interface or all PTP interfaces.

Usage guidelines

The detailed PTP running information can be displayed only if you enable PTP on the interface. The brief PTP running information can be displayed only when PTP is operating on the interface.

Examples

# Display brief PTP running information for all PTP interfaces.

<Sysname> display ptp interface brief

State        Delay mechanism  Clock step  Asymmetry correction  Name

Slave        E2E              Two         0                     WGE1/0/1 

Passive      E2E              Two         0                     WGE1/0/2 

# Display detailed PTP running information for Twenty-FiveGigE 1/0/1.

<Sysname> display ptp interface twenty-fivegige 1/0/1

Clock ID                    : 000FE2-FFFE-FF0000

Port number                 : 15

PTP version                 : 2

PTP enable                  : Enabled

Transport of PTP            : User Datagram Protocol (IPv4)

Unicast destination address : 10.10.10.2

DSCP priority               : 56

Port state                  : Slave

Force state                 : No

Clock step                  : Two

Asymmetry correction        : 0

Delay mechanism             : End to End

Announce interval (log mean)           : 1

Announce receipt time out              : 3

Sync interval (log mean)               : 2

Delay request interval (log mean)      : 2

Peer delay request interval (log mean) : 0

Mean path delay                        : 1357 (ns)

Table 4 Command output

Field

Description

State

States of the PTP interface:

·     Slave—Receives synchronization messages.

·     Uncalibrated—Temporary state before the interface enters Slave state.

·     Passive—Neither receives nor sends synchronization messages. A PTP interface is in passive state after it receives an announce messages.

·     Master—Sends synchronization messages.

·     Premaster—Temporary state before the interface enters Master state.

·     Listening—Neither receives nor sends synchronization messages. A PTP interface is in listening state after being initialized.

·     Faulty—PTP is running incorrectly. A PTP interface in faulty state does not process PTP messages.

·     Disabled—PTP is not running on the interface. A PTP interface in disabled state does not process PTP messages.

·     Initializing—The interface is initializing. A PTP interface in initializing state does not process PTP messages.

·     N/A—No PTP interface state is obtained.

Delay mechanism

Delay measurement mechanism:

·     End to End—Request-response mechanism.

·     Peer to Peer—Peer delay mechanism.

Clock step

Mode for carrying timestamps:

·     One—Single-step mode.

·     Two—Two-step mode.

Asymmetry correction

Asymmetric delay correction value (in nanoseconds).

Name

Name of the PTP interface.

Clock ID

Clock ID of the device where the interface resides.

PTP version

PTP version number. The version number is always 2.

PTP enable

Whether PTP is enabled on the port:

·     Enabled.

·     Disabled.

Transport of PTP

PTP message transport protocol:

·     User Datagram Protocol (IPv4).

·     IEEE 802.3/Ethernet.

Unicast destination address

Destination IP address for unicast PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp unicast-destination command is not executed.

Unicast negotiate port role

This field is available only when the PTP profile is ITU-T G.8275.2.

Role of the port for unicast negotiation.

·     Request-port.

·     Grant-port.

This field displays Disabled when unicast negotiation is disabled on the port.

DSCP priority

DSCP value for PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp dscp command is not executed.

VLAN

VLAN ID for PTP messages. This field is not displayed if the ptp vlan command is not executed.

Dot1p priority

802.1p precedence for PTP messages. This field is not displayed if the ptp vlan command is not executed.

Force state

Whether the force state is configured:

·     Yes.

·     No.

Announce interval (log mean)

Announce message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent.

Announce receipt time out

Number of announcement intervals before the receiving node stops receiving announce messages. If a member node does not receive any announce message from the master node within the specified value, it considers the master node invalid.

Sync interval (log mean)

Sync message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent.

Delay request interval (log mean)

Minimum delay request message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent.

Delay response interval (log mean)

Delay response message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent).

Peer delay request interval (log mean)

Peer delay request message sending interval (in seconds) = 2interval. This field displays the value for the interval exponent.

Local priority

Priority of the peer node.

This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.

NotSlave

Whether or not the NotSlave feature is enabled.

This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.

Mean path delay

Mean path delay, in nanoseconds.

display ptp parent

Use display ptp parent to display information about the parent node (master node).

Syntax

display ptp parent

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The command does not display information about the parent node (master node) in any of the following circumstances:

·     PTP profile, PTP mode, or PTP domain is not configured for the device.

·     The clock node type of the device is TC or T-TC.

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

Examples

# Display information about the parent node.

<Sysname> display ptp parent

Parent clock:

 Parent clock ID                         : 000FE2-FFFE-FF0005

 Parent port number                      : 15

 Observed parent offset (log variance)   : N/A

 Observed parent clock phase change rate : N/A

Grandmaster clock:

 Grandmaster clock ID: 000FE2-FFFE-FF0000

 Grandmaster clock quality:

  Class                 : 248

  Accuracy              : 254

  Offset (log variance) : 65535

  Priority1             : 128

  Priority2             : 128

Table 5 Command output

Field

Description

Parent port number

Outgoing interface number of the parent clock.

Observed parent offset (log variance)

Offset from the parent clock node.

N/A indicates that information for this field is not obtained.

Class

Time class of the grandmaster clock.

Accuracy

Time accuracy of the grandmaster clock.

Offset (log variance)

Offset of the grandmaster clock.

Priority1

Priority 1 value of the grandmaster clock.

Priority2

Priority 2 value of the grandmaster clock.

display ptp path-trace

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

Syntax

display ptp path-trace

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

This command does not have an output if one of the following conditions exists:

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

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

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

Examples

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

<Sysname> display ptp path-trace

Sequence number       Clock ID

1                     000FE2-FFFE-FF0000

2                     000FE3-FFFE-F90000

3                     000FE4-FFFE-F50000

4                     000FE5-FFFE-F20000

5                     000FE6-FFFE-F70000

Table 6 Command output

Field

Description

Sequence number

Sequence number of the clock node.

Clock ID

ID of the clock node

 

Related commands

ptp active force-state

ptp domain

ptp mode

ptp profile

display ptp statistics

Use display ptp statistics to display PTP statistics.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

Usage guidelines

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

Examples

# Display PTP statistics on Twenty-FiveGigE 1/0/1.

<Sysname> display ptp statistics interface twenty-fivegige 1/0/1

                     Received packets

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

Announce :0          Sync      :0          Signaling          :0

DelayReq :0          DelayResp :0          FollowUp           :0

PdelayReq:0          PdelayResp:0          PdelayRespFollowUp :0

 

                     Sent packets

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

Announce :476        Sync      :2543       Signaling          :0

DelayReq :0          DelayResp :0          FollowUp           :2542

PdelayReq:238        PdelayResp:0          PdelayRespFollowUp :0

 

                     Discarded packets

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

Announce :0          Sync      :0          Signaling          :0

DelayReq :0          DelayResp :0          FollowUp           :0

PdelayReq:0          PdelayResp:0          PdelayRespFollowUp :0

# Display PTP statistics on all interfaces.

<Sysname> display ptp statistics

Interface : Twenty-FiveGigE1/0/1

                     Received packets

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

Announce :2353       Sync      :4700       Signaling          :0

DelayReq :0          DelayResp :4450       FollowUp           :4700

PdelayReq:0          PdelayResp:0          PdelayRespFollowUp :0

 

                     Sent packets

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

Announce :8          Sync      :14         Signaling          :0

DelayReq :4450       DelayResp :0          FollowUp           :14

PdelayReq:0          PdelayResp:0          PdelayRespFollowUp :0

 

                     Discarded packets

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

Announce :0          Sync      :4          Signaling          :0

DelayReq :0          DelayResp :0          FollowUp           :4

PdelayReq:0          PdelayResp:0          PdelayRespFollowUp :0

Table 7 Command output

Field

Description

Received packets

Statistics about received PTP messages.

Sent packets

Statistics about sent PTP messages.

Discarded packets

Statistics about discarded PTP messages.

display ptp time-property

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

Syntax

display ptp time-property

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

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

·     PTP profile, PTP mode, or PTP domain is not configured for the device.

·     The clock node type of the device is TC.

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

Examples

# Display PTP clock time information.

<Sysname> display ptp time-property

PTP clock time property:

 Current UTC offset valid : True

 Current UTC offset       : 33

 Leap59 : Yes

 Leap61 : No

 Time traceable      : True

 Frequency traceable : True

 PTP timescale       : True

 Time source         : 0xA0 (Internal oscillator)

 Sync uncertain      : False

Table 8 Command output

Field

Description

Current UTC offset valid

Whether the UTC offset is valid:

·     True—Yes.

·     False—No.

Current UTC offset

Cumulative offset (in seconds) between the Coordinated Universal Time (UTC) of the grandmaster clock and the International Atomic Time (TAI).

Leap59

Whether cumulative offset is minus 1:

·     Yes.

·     No.

Leap61

Whether cumulative offset is plus 1:

·     Yes.

·     No.

Time traceable

Whether the PTP time is traceable:

·     True—Yes.

·     False—No.

Frequency traceable

Whether the PTP frequency is traceable:

·     True—Yes.

·     False—No.

PTP timescale

The possible timescales available for use by the grandmaster clock:

·     True—PTP timescale.

·     False—Non-PTP timescale.

Time source

Attributes of the grandmaster clock:

·     Atomic clock.

·     GPS.

·     Handset.

·     Internal oscillator.

·     NTP.

·     Other.

·     PTP.

·     Terrestrial radio.

·     Unknown.

Sync uncertain

Whether the upstream clock is not reliable:

·     True—The upstream clock is not reliable.

·     False—The upstream clock is reliable.

ptp { tod0 | tod1 }

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

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

Syntax

ptp { tod0 | tod1 } { input [ delay input-delay-time ] | output [ delay output-delay-time ] }

undo ptp { tod0 | tod1 } { input | output }

Default

The device transmits ToD clock signals from ToD 0 and receives ToD clock signals at ToD 1. The transmit and receive delay correction value is 0 nanoseconds.

Views

System view

Predefined user roles

network-admin

Parameters

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

input: Specifies the input direction for the device to receive ToD clock signals.

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

output: Specifies the output direction for the device to send ToD clock signals.

output-delay-time: Specifies the delay correction value in nanoseconds for sending ToD clock signals. The value is in the range of 0 to 1600. The default value is 0.

Usage guidelines

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

If you connect the device correctly to a ToD clock source and configure this command, the device uses the ToD clock source as its GM.

Examples

# Set the delay correction value to 1000 and 100 nanoseconds for receiving ToD 0 clock signals and sending ToD 1 clock signals, respectively.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp tod0 input delay 1000

[Sysname] ptp tod1 output delay 100

Related commands

ptp domain

ptp mode

ptp profile

ptp active force-state

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

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

Syntax

ptp active force-state

undo ptp active force-state

Default

The port role configuration is not activated.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

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

A T-TSC or T-TSC-P clock node does not support this command.

Examples

# Activate the port role configuration.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp active force-state

Related commands

ptp domain

ptp force-state

ptp mode

ptp profile

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

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

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

Syntax

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

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

Default

The default settings for this command vary by device model.

Views

System view

Predefined user roles

network-admin

Parameters

time-lock lock-value: Specifies the PTP time locking threshold in ns. The value range for this argument varies by device model.

time-unlock unlock-value: Specifies the PTP time unlocking threshold in ns. The value range for this argument varies by device model.

Usage guidelines

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

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

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

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

Examples

# Set the PTP time locking threshold to 100 ns.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp alarm-threshold time-lock 100

Related commands

ptp domain

ptp mode

ptp profile

ptp alarm-threshold clock-source-class

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

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

Syntax

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

undo ptp alarm-threshold clock-source-class

Default

The class threshold for the clock source is 6.

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp clock mode t-bc

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

Related commands

ptp clock mode

ptp clock-source

ptp domain

ptp profile

ptp alarm-threshold time-offset

Use ptp alarm-threshold time-offset to set the time-offset threshold between the external reference clock and the PTP clock.

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

Syntax

ptp alarm-threshold time-offset time-offset-value

undo ptp alarm-threshold time-offset

Default

The time-offset threshold between the external reference clock and the PTP clock is 500 ns.

Views

System view

Predefined user roles

network-admin

Parameters

time-offset-value: Specifies the time-offset threshold between the external reference clock and the PTP clock, in the range of 200 to 1000, in ns.

Usage guidelines

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

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp clock mode t-bc

[Sysname] ptp alarm-threshold time-offset 800

Related commands

ptp domain

ptp mode

ptp profile

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

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

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

Syntax

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

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

Default

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

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

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

Related commands

ptp domain

ptp mode

ptp profile

ptp announce-interval

Use ptp announce-interval to set the interval for sending announce messages.

Use undo ptp announce-interval to restore the default.

Syntax

ptp announce-interval interval

undo ptp announce-interval

Default

For the IEEE 1588 version 2 or AES67-2015 PTP profile, the interval argument value is 1 and the announce message sending interval is 2 (21) seconds.

For the IEEE 802.1AS PTP profile, the interval argument value is 0 and the announce message sending interval is 1 (20) second.

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

For the SMPTE ST 2059-2 PTP profile, the interval argument value is –2 and the announce message sending interval is 1/4 (2-2) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending announce messages. When the PTP profile is IEEE 1588 version 2 or AES67-2015, the value range for the interval argument is 0 to 4. When the PTP profile is IEEE 802.1AS, the value range for the interval argument is 0 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –3 to 1. When the PTP profile is ITU-T G.8275.1, the value range for the interval argument is –3 to 6. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –3 to 0.

Usage guidelines

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

The configuration of the interval at which the master node sends announce messages depends on the PTP profile in the PTP domain.

·     PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.

·     ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends announce messages to the client. If the negotiation succeeds, the grant-port sends announce messages at the configured interval to the client. If the negotiation fails, the grant-port does not send announce messages to the client.

Examples

# Set the announce message sending interval to 4 (22) seconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp announce-interval 2

Related commands

ptp domain

ptp mode

ptp profile

ptp announce-timeout

Use ptp announce-timeout to set a timeout multiplier for receiving announce messages.

Use undo ptp announce-timeout to restore the default.

Syntax

ptp announce-timeout multiple-value

undo ptp announce-timeout

Default

The timeout multiplier for receiving announce messages is 3.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

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

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

Examples

# Set the timeout multiplier for receiving announce messages to 5 on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp announce-timeout 5

Related commands

ptp announce-interval

ptp domain

ptp mode

ptp profile

ptp asymmetry-correction

Use ptp asymmetry-correction to set the asymmetric delay correction time.

Use undo ptp asymmetry-correction to restore the default.

Syntax

ptp asymmetry-correction { minus | plus } value

undo ptp asymmetry-correction

Default

The asymmetric delay correction time is 0 nanoseconds, which means that delay correction is not performed.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

minus: Subtracts the specified asymmetric delay correction value.

plus: Adds the specified asymmetric delay correction value.

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

Usage guidelines

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

Examples

# Set the asymmetric delay correction time to 100 nanoseconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp asymmetry-correction plus 100

Related commands

ptp domain

ptp mode

ptp profile

ptp clock-source

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

Use undo ptp clock-source to restore the clock source parameters to their default values.

Syntax

Local clock source:

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

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

ToD clock source:

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

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

Default

·     IEEE 1588 version 2

¡     Local clock source—The accuracy value and the time class value depend on the device model. The offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value not configurable.

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

·     IEEE 802.1AS

¡     Local clock source—The accuracy value, the time class value, and the offset (log variance) value depend on the device model. The time source value is 160.

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

·     ITU-T G.8275.1 PTP profile

¡     T-TSC clock node type

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

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

¡     T-BC or T-TC clock node type: Default PTP technical standard

-     Local clock source—The accuracy value and the time class value depend on the device model. The offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value is not configurable.

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

 

·     ITU-T G.8275.2

¡     T-TSC-P clock node type

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

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

¡     T-BC-P clock node type

-     Local clock source—The accuracy value and the time class value vary by device model, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.

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

 

Views

System view

Predefined user roles

network-admin

Parameters

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

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

Table 9 Clock accuracy value description

Clock accuracy value (in hexadecimal format)

Description

00 through 1F

Reserved.

20

Less than 25 nanoseconds (1 nanosecond = 10-9 second).

21

Less than 100 nanoseconds.

22

Less than 250 nanoseconds.

23

Less than 1 microsecond (10-6 second).

24

Less than 2.5 microseconds.

25

Less than 10 microseconds.

26

Less than 25 microseconds.

27

Less than 100 microseconds.

28

Less than 250 microseconds.

29

Less than 1 millisecond (10-3 second).

2A

Less than 2.5 milliseconds.

2B

Less than 10 milliseconds.

2C

Less than 25 milliseconds.

2D

Less than 100 milliseconds.

2E

Less than 250 milliseconds.

2F

Less than 1 second.

30

Less than 10 seconds.

31

More than 10 seconds.

32 through 7F

Reserved.

80 through FD

For use by alternate PTP profiles.

FE

Unknown.

FF

Reserved.

class class-value: Specifies the class of the ToD clock, in the range of 0 to 255. A smaller value indicates a higher time class. Table 10 shows the description for clock classes (those not listed are reserved by the protocol and are not recommended to use).

Table 10 Clock class description

Clock class (in decimal format)

Description

6

The clock node synchronizes its time to the master reference time source. PTP assigns a time table to the clock node. A clock node with time class 6 cannot become a member clock of any other clocks in the domain.

7

The former time class is 6. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. PTP assigns a time table to the clock node. A clock node with time class 7 cannot become a member clock of any other clocks in the domain.

13

The clock node synchronizes its time to a time source. ARB assigns a time table to the clock node. A clock node with time class 13 cannot become a member clock of any other clocks in the domain.

14

The former time class is 13. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. ARB assigns a time table to the clock node. A clock node with time class 14 cannot become a member clock of any other clocks in the domain.

52

The clock node with time class 7 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 52 cannot become a member clock of any other clocks in the domain.

58

The clock node with time class 14 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 58 cannot become a member clock of any other clocks in the domain.

150

The clock node synchronizes its frequency to a reference source with frequency accuracy of ±1 ppm (one in a million). The reference source has synchronized itself to the master reference time source. The timescale is PTP.

158

The clock node synchronizes its frequency to a reference source with frequency accuracy of ±10 ppm (ten in a million). The reference source has synchronized itself to the master reference time source. The timescale is PTP.

187

The clock node with time class 7 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 187 can become a member clock of another clock in the domain.

193

The clock node with time class 14 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 193 can become a member clock of another clock in the domain.

220

The clock node synchronizes its frequency to a reference source with frequency accuracy of ±1 ppm (one in a million). The reference source has synchronized itself to the master reference time source. The timescale is ARB.

228

The clock node synchronizes its frequency to a reference source with frequency accuracy of ±10 ppm (ten in a million). The reference source has synchronized itself to the master reference time source. The timescale is ARB.

248

Default time class value.

255

Clock node operating in slave-only mode.

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

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

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

Table 11 GM attribute value description

GM attribute values (in hexadecimal format)

Description

10

Atomic clock.

20

GPS.

30

Terrestrial radio.

40

PTP.

50

NTP.

60

Handset.

90

Other.

A0

Internal oscillator.

F0

Master clock. Time in the master is derived from the periodicity of a synchronization signal where the time value is undefined and is not related to real time. The timescale is ARB.

F1

Master clock. Time in the master is derived from the periodicity of a synchronization signal and is initially referenced to a local time source. Subsequent time accuracy in relation to real time will depend on the frequency accuracy of the synchronization signal.

F2 to FE

For use by alternate PTP profiles.

FF

Reserved.

Usage guidelines

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

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

Examples

# Set the time accuracy of the ToD 0 clock to 44 in system view.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp clock-source tod0 accuracy 44

Related commands

ptp domain

ptp mode

ptp profile

ptp clock-step

Use ptp clock-step to configure the mode for carrying timestamps.

Use undo ptp clock-step to restore the default.

Syntax

ptp clock-step { one-step | two-step }

undo ptp clock-step

Default

Two-step mode is used for carrying timestamps.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

one-step: Specifies the single-step mode.

two-step: Specifies the two-step mode.

Usage guidelines

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

The IEEE 802.1AS PTP profile supports only the two-step mode.

Examples

# Configure the two-step timestamp-carrying mode on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp clock-step two-step

Related commands

ptp domain

ptp mode

ptp profile

ptp delay-mechanism

Use ptp delay-mechanism to specify a delay measurement mechanism for a BC or an OC.

Use undo ptp delay-mechanism to restore the default.

Syntax

ptp delay-mechanism { e2e | p2p }

undo ptp delay-mechanism

Default

When the PTP profile is IEEE 1588 version 2, AES67-2015, or SMPTE ST 2059-2, the request-response delay measurement mechanism applies.

When the PTP profile is IEEE 802.1AS, the peer delay measurement mechanism applies.

When the PTP profile is ITU-T G.8275.1, the request-response delay measurement mechanism applies.

When the PTP profile is ITU-T G.8275.2, the request-response delay measurement mechanism applies.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

e2e: Specifies the request-response mechanism.

p2p: Specifies the peer delay mechanism.

Usage guidelines

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

When the PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015, the following restrictions apply:

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

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

The IEEE 802.1AS PTP profile supports only the peer delay measurement mechanism and does not support this command.

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

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

Examples

# Specify the OC clock node type. Specify the request-response delay measurement mechanism (e2e) on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp delay-mechanism e2e

Related commands

ptp domain

ptp mode

ptp profile

ptp delay-resp-interval

Use ptp delay-resp-interval to set the interval at which the server sends Delay_resp messages to the client.

Use undo ptp delay-resp-interval to restore the default.

Syntax

ptp delay-resp-interval interval

undo ptp delay-resp-interval

Default

The value of the interval argument is –4 and the minimum interval for sending Delay_resp messages is 1/16 (2-4) seconds.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

Only the ITU-T G.8275.2 PTP profile supports this command.

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile g8275.2

[Sysname] ptp mode t-bc-p

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2

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

[Sysname-Twenty-FiveGigE1/0/1] ptp delay-resp-interval -3

Related commands

ptp mode

ptp profile

ptp unicast-destination

ptp unicast-negotiate

ptp destination-mac

Use ptp destination-mac to configure the destination MAC address for non-peer delay messages.

Use undo ptp destination-mac to restore the default.

Syntax

ptp destination-mac mac-address

undo ptp destination-mac

Default

The destination MAC address of non-peer delay messages is 011B-1900-0000.

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

You can configure this command only after you have specified a PTP profile, PTP mode, and PTP domain for the device. The IEEE 802.1AS, SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles do not support this command.

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

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp destination-mac 0180-c200-000e

Related commands

ptp domain

ptp mode

ptp profile

ptp domain

Use ptp domain to specify a PTP domain.

Use undo ptp domain to restore the default.

Syntax

ptp domain domain-number

undo ptp domain

Default

No PTP domain exists.

Views

System view

Predefined user roles

network-admin

Parameters

domain-number: Specifies a PTP domain by its number. The value range for the domain-number argument is 0 to 255 for the IEEE 1588 version 2, IEEE 802.1AS, and AES67-2015 PTP profiles, 0 to 127 for the SMPTE ST 2059-2 PTP profile, 24 to 43 for the ITU-T G.8275.1 PTP profile, and 44 to 63 for the ITU-T G.8275.2 PTP profile.

Usage guidelines

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

If you delete a PTP domain, all PTP configurations related to the domain are deleted, except the PTP profile and PTP mode settings.

Examples

# Assign the device to PTP domain 2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 2

Related commands

ptp mode

ptp profile

ptp dscp

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

Use undo ptp dscp to restore the default.

Syntax

ptp dscp dscp

undo ptp dscp

Default

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles do not support this command.

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

Examples

# Set the DSCP value to 63 for PTP messages transmitted over IPv4 UDP on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp

[Sysname-Twenty-FiveGigE1/0/1] ptp dscp 63

Related commands

ptp domain

ptp mode

ptp profile

ptp transport-protocol

ptp enable

Use ptp enable to enable PTP.

Use undo ptp enable to disable PTP.

Syntax

ptp enable

undo ptp enable

Default

PTP is disabled.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

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

You can enable PTP on only one port if the clock node type of the device is OC or T-TSC.

As a best practice, enable PTP on an interface after you complete PTP configuration on the interface.

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

Examples

# Specify the OC clock node type and enable PTP on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp enable

# Specify the E2ETC clock node type and enable PTP on Twenty-FiveGigE 1/0/1 and Twenty-FiveGigE 1/0/2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode e2etc

[Sysname] ptp domain 1

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp enable

[Sysname-Twenty-FiveGigE1/0/1] interface twenty-fivegige 1/0/2

[Sysname-Twenty-FiveGigE1/0/2] ptp enable

Related commands

ptp domain

ptp mode

ptp profile

ptp source

ptp force-state

Use ptp force-state to configure a role for a PTP port.

Use undo ptp force-state to restore the default.

Syntax

ptp force-state { master | passive | slave }

undo ptp force-state

Default

The PTP port role is automatically calculated based on the BMC algorithm.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

master: Specifies the PTP port as a master port.

passive: Specifies the PTP port as a passive port.

slave: Specifies the PTP port as a subordinate port.

Usage guidelines

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

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

You can configure only one subordinate port for a device.

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

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

Examples

# Specify the OC clock node type and specify Twenty-FiveGigE 1/0/1 as a subordinate port.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp force-state slave

Related commands

ptp active force-state

ptp domain

ptp mode

ptp profile

ptp slave-only

ptp local-priority

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

Use undo ptp local-priority to restore the default.

Syntax

ptp local-priority local-priority

undo ptp local-priority

Default

The local priority of an interface is 128.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

Examples

# Set the local priority for Twenty-FiveGigE1/0/1 to 10.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp local-priority 10

Related commands

ptp mode

ptp profile

ptp max-steps-removed

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

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

Syntax

ptp max-steps-removed step-removed-value

undo ptp max-steps-removed

Default

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

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] ptp max-steps-removed 20

Related commands

ptp mode

ptp profile

ptp min-delayreq-interval

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

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

Syntax

ptp min-delayreq-interval interval

undo ptp min-delayreq-interval

Default

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

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending delay request messages. When the PTP profile is IEEE 1588 version 2 or ITU-T G.8275.1, the value range for the interval argument is –4 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to 4. When the PTP profile is AES67-2015, the value range for the interval argument is –3 to 5. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –5 to 0.

Usage guidelines

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

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

The IEEE 802.1AS PTP profile does not support this command.

In PTP multicast transport mode, this command takes effect only when configured on the master clock. The master clock sends the value to a member clock through PTP messages to control the interval for the member clock to send Delay_Req messages. To view the interval, execute the display ptp interface command on the member clock.

In PTP unicast transport mode, this command takes effect when configured on member clocks. It does not take effect when configured on the master clock.

As a best practice, set the interval argument to a value in the range of ptp syn-interval interval to ptp syn-interval interval plus 5 when the PTP profile is SMPTE ST 2059-2 or AES67-2015.

Examples

# Set the minimum interval to 4 (22) seconds for sending delay request messages on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp min-delayreq-interval 2

Related commands

ptp domain

ptp mode

ptp profile

ptp syn-interval

ptp mode

Use ptp mode to specify a clock node type for the device.

Use undo ptp mode to restore the default.

Syntax

IEEE 1588v2 PTP profile:

ptp mode { bc | e2etc | e2etc-oc | oc | p2ptc | p2ptc-oc }

undo ptp mode

IEEE 802.1AS PTP profile:

ptp mode { bc | oc | p2ptc | p2ptc-oc }

undo ptp mode

AES67-2015 and SMPTE ST 2059-2 PTP profiles:

ptp mode { bc | e2etc | oc | p2ptc }

undo ptp mode

ITU-T G.8275.1 PTP profile:

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

undo ptp mode

ITU-T G.8275.2 PTP profile:

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

undo ptp mode

Default

No clock node type is specified.

Views

System view

Predefined user roles

network-admin

Parameters

bc: Specifies the boundary clock (BC) type.

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

e2etc-oc: Specifies the E2ETC+OC type.

oc: Specifies the ordinary clock (OC) type.

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

p2ptc-oc: Specifies the P2PTC+OC type.

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

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

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

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

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

Usage guidelines

CAUTION

CAUTION:

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

You can configure this command only after you have specified a PTP profile for the device. Follow these restrictions and guidelines for specifying a clock node type:

·     (Devices that do not support PTP instances.) You can specify only one clock node type for the device.

·     (Devices that support PTP instances.) You can specify only one clock node type for the device on a PTP instance.

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

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

·     When the PTP profile is SMPTE ST 2059-2 or AES67-2015, you can specify only the BC, OC, E2ETC, or P2PTC clock node type.

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

Examples

# Specify the OC clock node type for the device.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[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

Predefined user roles

network-admin

Usage guidelines

The NotSlave feature enables a PTP port to select the clock node where it resides as the master node.

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

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

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

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

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

Examples

# Disable the NotSlave feature on Twenty-FiveGigE1/0/1.

<Sysname> system-view

[Sysname] ptp profile g8275.1

[Sysname] ptp mode t-bc

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp notslave disable

Related commands

ptp mode

ptp profile

ptp path-trace disable

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

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

Syntax

ptp path-trace disable

undo ptp path-trace disable

Default

PTP path tracing is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

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

Examples

# Disable PTP path tracing.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp domain 1

[Sysname] ptp path-trace disable

Related commands

display ptp path-trace

ptp mode

ptp profile

ptp pdelay-req-interval

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

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

Syntax

ptp pdelay-req-interval interval

undo ptp pdelay-req-interval

Default

The interval for sending peer delay request messages is 1 (20) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending peer delay request messages. When the PTP profile is IEEE 1588 version 2 or AES67-2015, the value range for the interval argument is 0 to 5. When the PTP profile is IEEE 802.1AS, the value range for the interval argument is –4 to 6. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to 4.

Usage guidelines

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

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

When the PTP profile is SMPTE ST 2059-2, set the interval argument to a value in the range of ptp syn-interval interval to ptp syn-interval interval plus 5 as a best practice.

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp pdelay-req-interval 2

Related commands

ptp domain

ptp mode

ptp profile

ptp syn-interval

ptp port-mode

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

Use undo ptp port-mode to restore the default.

Syntax

ptp port-mode oc

undo ptp port-mode

Default

The type of all ports on an E2ETC+OC or a P2PTC+OC clock is TC.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

oc: Specifies the OC port type for a TC+OC clock.

Usage guidelines

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

This command is applicable only for E2ETC+OC and P2PTC+OC clocks.

The SMPTE ST 2059-2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles do not support this command.

Examples

# Specify the P2PTC+OC clock node type for the device. Specify the OC port type for Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode p2ptc-oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp port-mode oc

Related commands

ptp domain

ptp mode

ptp profile

ptp priority

Use ptp priority clock-source to configure the priority for the specified clock for GM election through BMC.

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

Syntax

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

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

Default

When the PTP profile is IEEE 1588 version 2, SMPTE ST 2059-2, or AES67-2015, the priority 1 and priority 2 values are both 128.

When the PTP profile is IEEE 802.1AS, the priority 1 value is 246 and the priority 2 value is 248.

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

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

Views

System view

Predefined user roles

network-admin

Parameters

local: Specifies the local clock.

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

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

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

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

Usage guidelines

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

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

Examples

# Set priority 1 to 10 for the local clock.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp priority clock-source local priority1 10

Related commands

ptp domain

ptp mode

ptp profile

ptp profile

Use ptp profile to specify a PTP profile for the device.

Use undo ptp profile to restore the default.

Syntax

ptp profile { 1588v2 | 8021as | aes67-2015 | st2059-2 | g8275.1 | g8275.2 }

undo ptp profile

Default

PTP operates only after you specify a PTP profile.

Views

System view

Predefined user roles

network-admin

Parameters

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

8021as: Specifies the IEEE 802.1AS PTP profile.

st2059-2: Specifies the SMPTE ST 2059-2 PTP profile.

aes67-2015: Specifies the AES67-2015 PTP profile.

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

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

Usage guidelines

Specify a PTP profile for the device before any other PTP configurations.

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

Examples

# Specify the IEEE 1588 version 2 PTP profile.

<Sysname> system-view

[Sysname] ptp profile 1588v2

ptp slave-only

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

Use undo ptp slave-only to restore the default.

Syntax

ptp slave-only

undo ptp slave-only

Default

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

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

This command is applicable only to OCs.

You can execute the ptp force-state command to specify a subordinate port as a master port or passive port even if the OC operates as a member clock.

Examples

# Specify the OC clock node type for the device. Configure the OC to operate only as a member clock.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp slave-only

Related commands

ptp domain

ptp force-state

ptp mode

ptp profile

ptp source

Use ptp source to configure the source IP address for multicast PTP messages transmitted over IPv4 UDP.

Use undo ptp source to remove the specified source IP address for multicast PTP messages transmitted over IPv4 UDP.

Syntax

ptp source ip-address [ vpn-instance vpn-instance-name ]

undo ptp source ip-address [ vpn-instance vpn-instance-name ]

Default

No source IP address is configured for multicast PTP messages transmitted over IPv4 UDP.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for multicast PTP messages transmitted over IPv4 UDP.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance used for communication between the local device and the peer device. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the peer device belongs to the public network, do not specify this option.

Usage guidelines

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

The IEEE 802.1AS, ITU-T G.8275.1, and ITU-T G.8275.2 profiles do not support this command.

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

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

Examples

# Configure the source IP address as 3.5.1.5 for multicast PTP messages transmitted over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp source 3.5.1.5

Related commands

ptp domain

ptp mode

ptp profile

ptp transport-protocol

ptp syn-interval

Use ptp syn-interval to set the interval for sending Sync messages.

Use undo ptp syn-interval to restore the default.

Syntax

ptp syn-interval interval

undo ptp syn-interval

Default

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

When the PTP profile is IEEE 802.1AS, SMPTE ST 2059-2, or AES67-2015, the interval argument value is –3 and the interval for sending Sync messages is 1/8 (2-3) seconds.

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Sync messages. When the PTP profile is IEEE 802.1AS or ITU-T G.8275.1, the value range for the interval argument is –4 to 6. When the PTP profile is IEEE 1588 version 2, the value range for the interval argument is –1 to 1. When the PTP profile is SMPTE ST 2059-2, the value range for the interval argument is –5 to –1. When the PTP profile is AES67-2015, the value range for the interval argument is –4 to 1. When the PTP profile is ITU-T G.8275.2, the value range for the interval argument is –5 to 0.

Usage guidelines

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

The configuration of the interval at which the master node sends Sync messages depends on the PTP profile in the PTP domain.

·     PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.

·     ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends Sync messages to the client. If the negotiation succeeds, the grant-port sends Sync messages at the configured interval to the client. If the negotiation fails, the grant-port does not send Sync messages to the client.

Examples

# Set the Sync message sending interval to 2 (21) seconds on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp syn-interval 1

Related commands

ptp domain

ptp mode

ptp profile

ptp sync-uncertain enable

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

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

Syntax

ptp sync-uncertain enable

undo ptp sync-uncertain enable

Default

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

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp sync-uncertain enable

Related commands

ptp domain

ptp mode

ptp profile

ptp transport-protocol

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

Use undo ptp transport-protocol to restore the default.

Syntax

ptp transport-protocol udp

undo ptp transport-protocol

Default

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

The SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles transport PTP messages over IPv4 UDP.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

udp: Specifies the IPv4 UDP transport protocol for PTP messages.

Usage guidelines

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

The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles support IEEE 802.3/Ethernet transport of PTP messages and do not support this task.

The SMPTE ST 2059-2, AES67-2015, and ITU-T G.8275.2 PTP profiles support IPv4 UDP transport of PTP messages and do not support this task.

Examples

# Specify the IPv4 UDP transport protocol for PTP messages on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp

Related commands

ptp domain

ptp mode

ptp profile

ptp unicast-destination

Use ptp unicast-destination to configure the destination IP address for unicast PTP messages transmitted over IPv4 UDP.

Use undo ptp unicast-destination to restore the default.

Syntax

ptp unicast-destination ip-address

undo ptp unicast-destination ip-address

Default

No destination IP address is configured for unicast PTP messages transmitted over IPv4 UDP.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

The IEEE 802.1AS and ITU-T G.8275.1 PTP profiles do not support this command.

You must configure this command when the PTP profile is ITU-T G.8275.2.

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

Examples

# Set the destination IP address to 10.10.10.2 for unicast PTP messages transmitted over IPv4 UDP.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp transport-protocol udp

[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2

Related commands

ptp domain

ptp mode

ptp profile

ptp transport-protocol

ptp unicast-negotiate

Use ptp unicast-negotiate to enable unicast negotiation.

Use undo ptp unicast-negotiate to disable unicast negotiation.

Syntax

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

undo ptp unicast-negotiate

Default

Unicast negotiation is disabled.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

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

Usage guidelines

Only the ITU-T G.8275.2 PTP profile supports this command.

The ITU-T G.8275.2 PTP profile allows you to establish a PTP synchronization tree by specifying the request-ports and master-ports.

A request-port initiates a connection request to a specific grant-port. They negotiate PTP parameters and exchange PTP messages to synchronize the client time to the server. Plan the network in advance and specify the ports on the member (client) clock nodes as request-ports and the ports on the master (server) clock nodes as grant-ports.

If you do not configure this command, the synchronization tree is established through dynamic election.

For unicast negotiation to take effect, you must execute also the ptp unicast-destination command. The ports on a T-TSC-P clock node cannot be specified as grant-ports.

Examples

# Enable unicast negotiation on Twenty-FiveGigE 1/0/1 and specify the port as a request-port.

<Sysname> system-view

[Sysname] ptp profile g8275.2

[Sysname] ptp mode t-bc-p

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp unicast-destination 10.10.10.2

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

[Sysname-Twenty-FiveGigE1/0/1] ptp enable

Related commands

ptp mode

ptp profile

ptp unicast-destination

ptp utc

Use ptp utc to set the correction date for Coordinated Universal Time (UTC).

Use undo ptp utc to remove the correction date configured for UTC.

Syntax

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

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

Default

No correction date is configured for UTC.

Views

System view

Predefined user roles

network-admin

Parameters

leap59-date: Adjusts UTC at the last minute (23:59) of the specified date so that UTC is one second slower than TAI.

leap61-date: Adjusts UTC at the last minute (23:59) of the specified date so that UTC is one second faster than TAI.

date: Sets the date to adjust UTC, in the format of YYYY/MM/DD. The value range for YYYY and MM is 2000 to 2035 and 1 to 12, respectively. The value range for DD depends on the specified month. For the configuration to take effect, do not specify a date earlier than the current date.

Usage guidelines

An offset exists between UTC and TAI. The device displays UTC time. However, PTP uses TAI for time synchronization. For the device to synchronize correct time to other clock nodes in the PTP domain when its local clock is selected as the GM, configure this command to correct the offset between UTC and TAI.

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

This command takes effect only when it is configured on the master clock node and the local clock of the master clock node is the GM.

Specify either the leap59-date or leap61-date keyword in this command. If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Assume the current date is August 8, 2019. Specify the BC clock node type as BC. Adjust UTC at the last minute of December 31, 2019 so that UTC is one second slower than the TAI.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

[Sysname] ptp domain 0

[Sysname] ptp utc leap59-date 2019/12/31

Related commands

ptp domain

ptp mode

ptp profile

ptp utc offset

Use ptp utc offset to set the cumulative offset between UTC and International Atomic Time (TAI).

Use undo ptp utc offset to restore the default.

Syntax

ptp utc offset utc-offset

undo ptp utc offset

Default

The cumulative offset between UTC and TAI is 0 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

An offset exists between UTC and TAI. The device displays UTC time. However, PTP uses TAI for time synchronization. For the device to synchronize correct time to other clock nodes in the PTP domain when its local clock is selected as the GM, configure this command to correct the offset between UTC and TAI.

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

Examples

# Set the cumulative offset to 37 seconds between UTC and TAI.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] ptp utc offset 37

Related commands

ptp domain

ptp mode

ptp profile

ptp vlan

Use ptp vlan to specify a VLAN tag for PTP messages.

Use undo ptp vlan to restore the default.

Syntax

ptp vlan vlan-id [ dot1p dot1p-value ]

undo ptp vlan [ dot1p ]

Default

PTP messages do not have a VLAN tag.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

dot1p dot1p-value: Specifies an 802.1p precedence for PTP messages, in the range of 0 to 7. The default 802.1p precedence is 7 (the highest).

Usage guidelines

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

Examples

# Specify VLAN 2 and set the 802.1p precedence to 6 for PTP messages on Twenty-FiveGigE1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp domain 0

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] ptp vlan 2 dot1p 6

Related commands

ptp domain

ptp mode

ptp profile

reset ptp statistics

Use reset ptp statistics to clear PTP statistics.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

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

Examples

# Clear PTP statistics on Twenty-FiveGigE 1/0/1.

<Sysname> reset ptp statistics interface twenty-fivegige 1/0/1

Related commands

display ptp statistics

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网