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

mdc-admin

mdc-operator

Usage guidelines

This command does not display any information if you have not specified a PTP profile (PTP standard) or a PTP mode.

Examples

# Display PTP clock information.

<Sysname> display ptp clock

PTP profile : IEEE 1588 Version 2

PTP mode : BC

Slave only : No

Clock ID : 000FE2-FFFE-FF0000

Clock type : ToD1

ToD direction : In

ToD delay time : 0 (ns)

Clock domain : 0

Number of PTP ports : 2

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

Local clock time : Sun Jan 15 20:57:29 2011

Table 1 Command output

Field | Description
PTP profile | Standards that PTP complies with: · IEEE 1588 version 2. · IEEE 802.1AS.
PTP mode | Clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC.
Slave only | Whether the OC operates in Slave only mode: · Yes. · No.
Clock ID | Clock ID for the device, which uniquely identifies a PTP device.
Clock type | Clock type of the device: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock.
ToD direction | Direction for the ToD clock. The value for this field is In. This field is not displayed when the device is 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 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.

‌

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

mdc-admin

mdc-operator

Usage guidelines

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

· You have specified a PTP profile and PTP mode 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

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

GE1/0/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.

‌

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

mdc-admin

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

· You have specified the PTP profile as IEEE 1588 version 2.

· You have specified a PTP mode for the device.

· The device has a subordinate port or a port in uncalibrated state.

Examples

# Display information about foreign master nodes for all interfaces.

<Sysname> display ptp foreign-masters-record

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

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

GM=Grandmaster

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

Interface Clock ID P1 P2 C A OSLV SR GM

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

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

GE1/0/2 000FE2-FFFE-FF0001 0 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.
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.

‌

PTP commands -- display ptp interface

Use display ptp interface to display PTP running information for an interface.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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 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 interface or all 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 interfaces.

<Sysname> display ptp interface brief

Name State Delay mechanism Clock step Asymmetry correction

GE1/0/1 Slave E2E Two 0

GE1/0/2 Passive E2E Two 0

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

<Sysname> display ptp interface gigabitethernet 1/0/1

Clock ID : 000FE2-FFFE-FF0000

Port number : 15

PTP version : 2

PTP enable : Enabled

Transport of PTP : User Datagram Protocol (IPv4)

Unicast destination address : 10.10.10.2

DSCP priority : 56

Port state : Slave

Force state : No

Clock step : Two

Asymmetry correction : 0

Delay mechanism : End to End

Announce interval (log mean) : 1

Announce receipt time out : 3

Sync interval (log mean) : 2

Delay request interval (log mean) : 2

Peer delay request interval (log mean) : 0

Mean path delay : 0 (ns)

Table 4 Command output

Field | Description
Name | Name of the PTP interface.
State | States of the PTP interface: · Slave—Receives synchronization messages. · Uncalibrated—Temporary state before the interface enters Slave state. · Passive—Neither receives nor sends synchronization messages. A PTP interface is in passive state after it receives an announce messages. · Master—Sends synchronization messages. · Premaster—Temporary state before the interface enters Master state. · Listening—Neither receives nor sends synchronization messages. A PTP interface is in listening state after being initialized. · Faulty—PTP is running incorrectly. A PTP interface in faulty state does not process PTP messages. · Disabled—PTP is not running on the interface. A PTP interface in disabled state does not process PTP messages. · Initializing—The interface is initializing. A PTP interface in initializing state does not process PTP messages. · N/A—No PTP interface state is obtained.
Delay mechanism | Delay measurement mechanism: · End to End—Request-response mechanism. · Peer to Peer—Peer delay mechanism.
Clock step | Mode for carrying timestamps: · 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 that are transmitted over UDP (IPv4). This field is not displayed if the ptp unicast-destination command is not executed.
DSCP priority | DSCP value for PTP messages that are transmitted over UDP (IPv4). 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) = 2internal (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) = 2internal (this field displays the value for the interval exponent).
Delay request interval (log mean) | Minimum delay request message sending interval (in seconds) = 2internal (this field displays the value for the interval exponent).
Peer delay request interval (log mean) | Peer delay request message sending interval (in seconds) = 2internal (this field displays the value for the interval exponent).
Mean path delay | Mean path delay, in nanoseconds.

‌

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

mdc-admin

mdc-operator

Usage guidelines

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

· You have not specified a PTP profile or a PTP mode for the device.

· You have specified the clock node type as TC.

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

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.

‌

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

mdc-admin

mdc-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 mode.

Examples

# Display PTP statistics on GigabitEthernet 1/0/1.

<Sysname> display ptp statistics interface gigabitethernet 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

Table 6 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.

‌

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

mdc-admin

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

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

‌

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

mdc-admin

Usage guidelines

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

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

If the PTP profile is IEEE 1588 version 2, the announce message sending interval is 1 (21) second.

If the PTP profile is IEEE 802.1AS, the announce message sending interval is 1 (20) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Sets the announce message sending interval in seconds. The intervals use log base 2 values. If the PTP profile is IEEE 1588 version 2, the value range for the interval argument is 0 to 4. If the PTP profile is IEEE 802.1AS, the value range for the interval argument is 0 to 6.

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp announce-interval 2

Related commands

ptp mode

ptp profile

PTP commands -- ptp announce-timeout

Use ptp announce-timeout to set the timeout multiplier for the announce message receiving interval.

Use undo ptp announce-timeout to restore the default.

Syntax

ptp announce-timeout multiple-value

undo ptp announce-timeout

Default

The timeout multiplier for the announce message receiving interval is 3.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

A master node periodically sends announce messages to the member nodes.

· When the PTP profile is IEEE 1588 version 2:

If a member node does not receive any announce message from the master node within multiple-value times the announce message sending interval, it determines that the master node is invalid.

· When the PTP profile is IEEE 802.1AS:

If a member node does not receive any announce message from the master node within multiple-value times the announce message sending interval configured on the master node, it determines that the master node is invalid.

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

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp announce-timeout 5

Related commands

ptp announce-interval

ptp mode

ptp profile

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

mdc-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 mode.

Examples

# Set the asymmetric delay correction time to 100 nanoseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

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

Related commands

ptp mode

ptp profile

PTP commands -- ptp clock-source

Use ptp clock-source to configure ToD clock parameters.

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

Syntax

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

undo ptp clock-source { tod0 | tod1 } { accuracy | class | time-source }

Default

For a ToD clock, the accuracy is 32, the clock class is 6, and the attribute value is 32.

Views

System view

Predefined user roles

network-admin

mdc-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 8 shows the description for clock accuracy values.

Table 8 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 9 shows the description for clock classes (those not listed are reserved by the protocol and are not recommended to use).

Table 9 Clock class des cription

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.

‌

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

Table 10 GM attribute value des cription

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

Examples

# Configure the time accuracy for the ToD 0 clock as 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 commands -- 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

mdc-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 mode.

If you specify the PTP profile as IEEE 802.1AS, only the two-step mode is supported.

If you specify the clock node type as E2ETC, P2PTC, E2ETC+OC, or P2PTC+OC, only the two-step mode is supported.

Examples

# Configure the mode for carrying timestamps on GigabitEthernet 1/0/1 as two-step.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp clock-step two-step

Related commands

ptp mode

ptp profile

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

If the PTP profile is IEEE 1588 version 2, the delay measurement mechanism is request-response mechanism.

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

e2e: Specifies the request-response mechanism used by E2ETC.

p2p: Specifies the peer delay mechanism used by P2PTC.

Usage guidelines

This command is applicable only to BCs and OCs.

This command is available only if you specify the PTP profile as IEEE 1588 version 2.

Examples

# Configure the clock node type as OC. Specify the delay measurement mechanism on GigabitEthernet 1/0/1 as e2e.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp delay-mechanism e2e

Related commands

ptp mode

ptp profile

PTP commands -- ptp destination-mac

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

Use undo ptp destination-mac to restore the default.

Syntax

ptp destination-mac mac-address

undo ptp destination-mac

Default

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

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

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

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

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

Examples

# Configure the destination MAC address for non-peer delay messages as 0180-C200-000E on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

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

Related commands

ptp mode

ptp profile

PTP commands -- ptp domain

Use ptp domain to configure the PTP domain number to use for the device.

Use undo ptp domain to restore the default.

Syntax

ptp domain domain-number

undo ptp domain

Default

The PTP domain number is 0.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

domain-number: Specifies a PTP domain by its domain number, in the range of 0 to 255.

Usage guidelines

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

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 commands -- ptp dscp

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

Use undo ptp dscp to restore the default.

Syntax

ptp dscp dscp

undo ptp dscp

Default

The DSCP value is 56 for PTP messages that are transmitted over UDP (IPv4).

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-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 mode.

If the PTP profile is IEEE 802.1AS, you cannot execute this command.

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

Examples

# Set the DSCP value to 63 for PTP messages transmitted over UDP (IPv4) on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp transport-protocol udp

[Sysname-GigabitEthernet1/0/1] ptp dscp 63

Related commands

ptp mode

ptp profile

ptp transport-protocol

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

mdc-admin

Usage guidelines

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

An OC can have only one PTP port.

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

Examples

# Configure the clock node type as OC, and enable PTP on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp enable

# Configure the clock node type as E2ETC, and enable PTP on GigabitEthernet 1/0/1 and GigabitEthernet 1/0/2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode e2etc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp enable

[Sysname-GigabitEthernet1/0/1] interface gigabitethernet 1/0/2

[Sysname-GigabitEthernet1/0/2] ptp enable

Related commands

ptp mode

ptp profile

PTP commands -- 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 BMC.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

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

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

You can configure only one subordinate port for a device.

Examples

# Configure the clock node type as OC. Specify the PTP port GigabitEthernet 1/0/1 as a subordinate port.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp force-state slave

Related commands

ptp active force-state

ptp mode

ptp profile

ptp slave-only

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

If the PTP profile is IEEE 1588 version 2, the minimum interval for sending delay request messages is 1 (20) second.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Sets the minimum interval for sending delay request messages (in seconds). The intervals use log base 2 values. The value range for the interval argument is –4 to 6.

Usage guidelines

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

If the PTP profile is IEEE 802.1AS, you cannot execute this command.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

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

Related commands

ptp mode

ptp profile

PTP commands -- ptp mode

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

Use undo ptp mode to restore the default.

Syntax

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

undo ptp mode

Default

No clock node type is specified.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

bc: Specifies the clock node type as boundary clock (BC).

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

e2etc-oc: Specifies the clock node type as E2ETC+OC.

oc: Specifies the clock node type as ordinary clock (OC).

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

p2ptc-oc: Specifies the clock node type as P2PTC+OC.

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.

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

Examples

# Specify the clock node type as OC for the device.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

Related commands

ptp profile

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

mdc-admin

Parameters

interval: Sets the interval (in seconds) for sending peer delay request messages. The intervals use log base 2 values. 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 mode.

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

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

Related commands

ptp mode

ptp profile

PTP commands -- ptp port-mode

Use ptp port-mode to configure the port type as OC 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

mdc-admin

Parameters

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

Usage guidelines

This command is applicable only to E2ETC+OC and P2PTC+OC clocks and is available only after you specify a PTP profile and a PTP mode.

Examples

# Specify the clock node type as P2PTC+OC for the device. Configure the port type for GigabitEthernet 1/0/1 as OC.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode p2ptc-oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp port-mode oc

Related commands

ptp mode

ptp profile

PTP commands -- 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 } { priority1 priority1 | priority2 priority2 }

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

Default

If the PTP profile is IEEE 1588 version 2, the value for both priority 1 and priority 2 is 128.

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

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

local: Specifies the local clock.

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

priority1 priority1: Specifies priority 1 for the clock, in the range of 0 to 255. A numerically smaller value has higher priority.

priority2 priority2: Specifies priority 2 for the clock, in the range of 0 to 255. A numerically smaller value has higher priority.

Usage guidelines

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

Examples

# Configure priority 1 as 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

PTP commands -- ptp profile

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

Use undo ptp profile to restore the default.

Syntax

ptp profile { 1588v2 | 8021as }

undo ptp profile

Default

PTP operates only after you configure a PTP profile.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

8021as: Specifies the PTP profile as IEEE 802.1AS.

Usage guidelines

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

If you change or remove a PTP profile, PTP functions do not operate and all the configurations for that PTP profile will be removed.

Examples

# Configure the PTP profile as IEEE 1588 version 2.

<Sysname> system-view

[Sysname] ptp profile 1588v2

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

mdc-admin

Usage guidelines

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

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 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 commands -- ptp source

Use ptp source to configure the source IP address for multicast PTP message transmission over UDP (IPv4).

Use undo ptp source to remove the specified source IP address for multicast PTP message transmission over UDP (IPv4).

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 message transmission over UDP (IPv4).

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies the source IP address for multicast PTP message transmission over UDP (IPv4).

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

If the PTP profile is IEEE 802.1AS, you cannot execute this command.

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

Examples

# Configure the source IP address as 3.5.1.5 for multicast PTP messages.

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

If the PTP profile is IEEE 1588 version 2, the interval is 1 (20) second for sending Sync messages.

If the PTP profile is IEEE 802.1AS, the interval is 1/8 (2-3) second for sending Sync messages.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Sets the Sync message sending interval in seconds. The intervals use log base 2 values. If the PTP profile is IEEE 802.1AS, 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 -1 to 1.

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp syn-interval 1

Related commands

ptp mode

ptp profile

PTP commands -- ptp tod

Use ptp tod to configure ToD input or output.

Use undo ptp tod 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 receives signals from an external ToD clock.

The delay correction value for a ToD clock is 0 nanoseconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

tod0: Specifies the ToD 0 clock.

tod1: Specifies the ToD 1 clock.

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

input-delay-time: Specifies the delay correction value in nanoseconds for receiving ToD clock signals. The value range for this argument varies by device model.

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

output-delay-time: Specifies the delay correction value in nanoseconds for sending ToD clock signals. The value range for this argument varies by device model.

Usage guidelines

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

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 tod0 input delay 1000

[Sysname] ptp tod1 output delay 100

Related commands

ptp mode

ptp profile

PTP commands -- ptp transport-protocol

Use ptp transport-protocol to configure UDP transport protocol over IPv4 for PTP messages.

Use undo ptp transport-protocol to restore the default.

Syntax

ptp transport-protocol udp

undo ptp transport-protocol

Default

PTP messages are transported through IEEE 802.3 and Ethernet.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

udp: Specifies the UDP over IPv4 transmit protocol for PTP messages.

Usage guidelines

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

If the PTP profile is IEEE 802.1AS, you cannot execute this command.

Examples

# Configure UDP transport protocol over IPv4 for PTP messages on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp transport-protocol udp

Related commands

ptp mode

ptp profile

PTP commands -- ptp unicast-destination

Use ptp unicast-destination to configure the destination IP address for unicast PTP message transmission over UDP (IPv4).

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 message transmission over UDP (IPv4).

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

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

If the PTP profile is IEEE 802.1AS, you cannot execute this command.

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

Examples

# Configure the destination IP address as 10.10.10.2 for unicast PTP messages.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ptp transport-protocol udp

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

Related commands

ptp mode

ptp profile

ptp transport-protocol

PTP commands -- ptp utc

Use ptp utc to set the correction date for the UTC.

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

Syntax

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

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

Default

No correction date is configured for the UTC.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

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

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

Usage guidelines

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

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, 2010. Specify the clock node type as BC for the device. Adjust the UTC at the last minute of December 31, 2010 so that the UTC is one second slower than the TAI.

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode bc

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

Related commands

ptp mode

ptp profile

PTP commands -- ptp utc offset

Use ptp utc offset to set the cumulative offset between the UTC and 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 the UTC and TAI is 0 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

utc-offset: Sets the cumulative offset between the UTC and TAI, in seconds. The value range varies by device model.

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] ptp profile 1588v2

[Sysname] ptp mode oc

[Sysname] ptp utc offset 33

Related commands

ptp mode

ptp profile

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

mdc-admin

Parameters

vlan vlan-id: Specifies a VLAN by its ID. The value range for the vlan-id argument varies by device model.

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

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

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 gigabitethernet 1/0/1

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

Related commands

ptp mode

ptp profile

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

mdc-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 GigabitEthernet 1/0/1.

<Sysname> reset ptp statistics interface gigabitethernet 1/0/1

Related commands

display ptp statistics