Contents

Network synchronization commands· 1

display network-clock self-test-result 1

display network-clock source· 1

display network-clock status· 3

display network-clock version· 4

network-clock lpuport 5

network-clock source forcessm·· 5

network-clock source frequency· 6

network-clock source priority· 7

network-clock source sa-bit 8

network-clock source ssm·· 8

network-clock ssmcontrol 9

network-clock ssm-degrade-threshold· 10

network-clock work-mode· 11

reset network-clock· 12

Synchronous Ethernet commands· 13

display esmc· 13

esmc bundle· 14

esmc enable· 15

synchronous mode· 16

Network synchronization commands

display network-clock self-test-result

Use display network-clock self-test-result to display the self-test result of the network clock monitoring module.

Syntax

display network-clock self-test-result

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the self-test result of the network clock monitoring module.

<Sysname> display network-clock self-test-result

Clock module state: Normal

  FPGA            : Normal

  E1              : Normal

  Clock Chip      : Normal

Table 1 Command output

Field	Description
Clock module mode	Status of the network clock monitoring module: ·     Normal—The network clock monitoring module is operating correctly. ·     Fault—The network clock monitoring module is not operating correctly. The module changes to this state if the Field Programmable Gate Array (FPGA), E1 chip, or clock chip is faulty.
FPGA	Status of the FPGA: ·     Normal—The FPGA is operating correctly. Fault—The FPGA is faulty.
E1	Status of the E1 chip: ·     Normal—The E1 chip is operating correctly. ·     Fault—The E1 chip is faulty.
Clock Chip	Status of the clock chip: ·     Normal—The clock chip is operating correctly. ·     Fault—The clock chip is faulty.

‌

display network-clock source

Use display network-clock source to display information about the clock sources.

Syntax

display network-clock source

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display information about the clock sources.

<Sysname> display network-clock source

Traced reference: XGE3/0/1

Reference   State   Priority  SSM level Force SSM Sa-Bit  LPU port  Frequency

BITS0       Lost    255       Unknown   ON        4       N/A       2 Mbps

BITS1       Lost    255       Unknown   ON        4       N/A       2 Mbps

PTP         N/A     255       Unknown   ON        N/A     N/A       N/A

XGE3/0/1    Normal  10        Unknown   OFF       N/A     Yes       N/A

Table 2 Command output

Field	Description
Traced reference	Traced clock source. If a clock source is traced, the network clock monitoring module distributes its timing signal to all interface cards. If no clock source has been traced, this field displays N/A.
Reference	Clock source: ·     BITS clock source. The available values include BITS0 and BITS1. ·     PTP clock source. The value is PTP. ·     Line clock source. The value is the line clock input port. This information is displayed only when a line clock input port is configured.
State	State of the clock source: ·     Normal—The clock source is operating correctly. ·     Lost—The clock source is not available or is in an error condition. ·     N/A—PTP is used for time synchronization.
Priority	Priority of the clock source.
SSM level	SSM quality level in descending order: ·     PRC—G.811 primary reference clock. ·     SSU-A—G.812 primary-level SSU. ·     SSU-B—G.812 second-level SSU. ·     SEC—SDH equipment clock. ·     DNU—Do not use for synchronization. ·     Unknown—Unknown quality level.
Force SSM	Whether to use the manually assigned SSM quality level: ·     ON—Uses the manually assigned SSM quality level. ·     OFF—Extracts the SSM quality level from the received timing signal.
Sa bit	Sa bit used by BITS to transmit the SSM: ·     sa4—Bit Sa4. ·     sa5—Bit Sa5. ·     sa6—Bit Sa6. ·     sa7—Bit Sa7. ·     sa8—Bit Sa8. This field displays N/A for line clock sources, because line clocks do not support the Sa bit configuration.
LPU port	Whether the line clock input port takes effect: ·     Yes—The line clock input port takes effect. ·     No—The line clock input port does not take effect. This field displays N/A for BITS 0, BITS 1, and PTP clock sources.
Frequency	Frequency of the BITS clock: ·     2 Mbps. ·     2 MHz.

 

display network-clock status

Use display network-clock status to display the operating state of the network clock monitoring module.

Syntax

display network-clock status

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the operating state of the network clock monitoring module.

<Sysname> display network-clock status

Mode              : Auto

Reference         : N/A

Traced reference  : N/A

Lock mode         : Unknown

SSM output level  : SSUB

SSM control enable: On

Table 3 Command output

Field	Description
Mode	Clock reference selection mode: ·     Auto—Automatic reference selection. ·     Manual—Manual reference selection.
Reference	Manually specified clock reference. This field displays N/A if no clock reference has been specified.
Traced reference	Clock reference that has been selected and traced. This field displays N/A if no clock reference has been selected.
Lock mode	Phase lock state of the clock monitoring module: ·     Freerun—Freerun mode. ·     Locked—Locked (traced) mode. ·     Holdover—Holdover state. ·     Pre-locked—Pre-locked mode. ·     Lost—The clock signal has been lost. ·     Unknown—No timing signal is available. The network clock monitoring module is in an exceptional condition.
SSM output level	Signal quality level of the clock source in the SSM, by descending order of quality: ·     PRC—G.811 primary reference clock. ·     SSU-A—G.812 primary-level SSU. ·     SSU-B—G.812 second-level SSU. ·     SEC—SDH equipment clock. ·     DNU—Do not use for synchronization. ·     Unknown—Unknown quality level.
SSM control enable	Contribution of SSM to automatic reference selection: ·     On—SSM is used in the selection process. ·     Off—SSM is not used in the selection process.

 

display network-clock version

Use display network-clock version to display the version of the network clock monitoring module.

Syntax

display network-clock version

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display version information for the network clock monitoring module.

<Sysname> display network-clock version

Clock card

  Type        : SR07CK3E

  PCB         : Ver.A

  FPGA version: 100

  Release date: 2022-06-02

Table 4 Command output

Field	Description
Type	Model of the clock daughter card.
PCB	PCB version of the clock daughter card.
FPGA version	FPGA version.
Release date	Version compilation time of the clock daughter card.

 

network-clock lpuport

Use network-clock lpuport to specify a line clock input port.

Use undo network-clock lpuport to remove a line clock input port.

Syntax

network-clock lpuport interface-type interface-number

undo network-clock lpuport interface-type interface-number

Default

No ports are specified as line clock input ports.

Views

System view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

Only main physical interfaces can act as clock input ports.

When you specify a main interface as a clock input port, you must set its clock mode to slave. The network clock monitoring module extracts clock signal from an interface only when the interface is operating in slave mode.

Examples

# Specify Pos 3/0/1 as a line clock input port.

<Sysname> system-view

[Sysname] network-clock lpuport pos 3/0/1

Related commands

display network-clock source

network-clock source forcessm

Use network-clock source forcessm to configure the method for setting the quality level of a clock source.

Use undo network-clock source forcessm to restore the default.

Syntax

network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } forcessm { off | on }

undo network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } forcessm

Default

The network clock monitoring module sets the quality level of a clock source to the user-assigned value. It does not extract the quality level from the SSM sent by the clock source.

Views

System view

Predefined user roles

network-admin

Parameters

bits0: Specifies the BITS 0 clock.

bits1: Specifies the BITS 1 clock.

lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.

ptp: Specifies the Precision Timing Protocol (PTP).

off: Sets the quality level of a clock source to the value extracted from the SSM sent by the clock source.

on: Sets the quality level of a clock source to the user-assigned value.

Examples

# Set the quality level of BITS 0 to the value extracted from the SSM sent by the clock source.

<Sysname> system-view

[Sysname] network-clock source bits0 forcessm off

Related commands

display network-clock source

network-clock source frequency

Use network-clock source frequency to set the frequency of a BITS clock.

Use undo network-clock source frequency to restore the default.

Syntax

network-clock source { bits0 | bits1 } frequency { bps-2m | hz-2m }

undo network-clock source { bits0 | bits1 } frequency

Default

The frequency of a BITS clock is 2 Mbps (bps-2m).

Views

System view

Predefined user roles

network-admin

Parameters

bits0: Specifies the BITS 0 clock.

bits1: Specifies the BITS 1 clock.

bps-2m: Sets the frequency to 2 Mbps.

hz-2m: Sets the frequency to 2 MHz.

Examples

# Set the frequency to 2 MHz for BITS 0.

<Sysname> system-view

[Sysname] network-clock source bits0 frequency hz-2m

Related commands

display network-clock source

network-clock source priority

Use network-clock source priority to set the priority of a clock source.

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

Syntax

network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } priority priority

undo network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } priority

Default

All clock sources have a priority of 255.

Views

System view

Predefined user roles

network-admin

Parameters

bits0: Specifies the BITS 0 clock.

bits1: Specifies the BITS 1 clock.

lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.

ptp: Specifies PTP.

priority priority: Sets a priority value in the range of 1 to 255. The lower the value, the higher quality the timing signal.

Examples

# Assign a priority of 3 to BITS 0.

<Sysname> system-view

[Sysname] network-clock source bits0 priority 3

Related commands

display network-clock source

network-clock source sa-bit

Use network-clock source sa-bit to set the Sa bit used to transmit the SSM for a BITS clock.

Use undo network-clock source sa-bit to restore the default.

Syntax

network-clock source { bits0 | bits1 } sa-bit { sa4 | sa5 | sa6 | sa7 | sa8 }

undo network-clock source { bits0 | bits1 } sa-bit

Default

BITS clocks use Sa4 to transmit the SSM.

Views

System view

Predefined user roles

network-admin

Parameters

bits0: Specifies the BITS 0 clock.

bits1: Specifies the BITS 1 clock.

sa-bit: Specifies an Sa bit.

·     sa4—Specifies bit Sa4.

·     sa5—Specifies bit Sa5.

·     sa6—Specifies bit Sa6.

·     sa7—Specifies bit Sa7.

·     sa8—Specifies bit Sa8.

Usage guidelines

Examples

# Specify Sa5 as the SSM bit for BITS 0.

<Sysname> system-view

[Sysname] network-clock source bits0 sa-bit sa5

network-clock source ssm

Use network-clock source ssm to assign an SSM quality level to a clock source.

Use undo network-clock source ssm to restore the default.

Syntax

network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } ssm { dnu | prc | sec | ssua | ssub | unknown }

undo network-clock source { bits0 | bits1 | lpuport interface-type interface-number | ptp } ssm

Default

The SSM quality level is unknown for all clock sources.

Views

System view

Predefined user roles

network-admin

Parameters

bits0: Specifies the BITS 0 clock.

bits1: Specifies the BITS 1 clock.

lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.

ptp: Specifies the PTP.

dnu: Sets the SSM quality level to DNU SSM quality level. DNU clock sources cannot participate in automatic clock reference selection.

prc: Sets the SSM quality level to G.811 primary reference clock.

sec: Sets the SSM quality level to SDH equipment clock.

ssua: Sets the SSM quality level to G.812 primary-level SSU.

ssub: Sets the SSM quality level to G.812 second-level SSU.

unknown: Sets the SSM quality level to unknown.

Usage guidelines

For the manually assigned SSM quality level to take effect, you must configure the network-clock source forcessm on command.

It takes time for an SSM quality level change to take effect. To verify the effectiveness of the change, use the display network-clock source command or check the log.

Examples

# Set the SSM quality level of BITS 0 to DNU.

<Sysname> system-view

[Sysname] network-clock source bits0 ssm dnu

network-clock ssmcontrol

Use network-clock ssmcontrol to control the use of SSM quality level in the automatic reference selection process.

Use undo network-clock ssmcontrol to restore the default.

Syntax

network-clock ssmcontrol { off | on }

undo network-clock ssmcontrol

Default

The SSM quality level is ignored in the automatic reference selection process.

Views

System view

Predefined user roles

network-admin

Parameters

off: Ignores the SSM quality level in clock reference selection.

on: Includes the SSM quality level as a factor for clock reference selection.

Usage guidelines

This command takes effect for automatic clock reference selection.

Examples

# Include the SSM quality level into the automatic clock reference selection process.

<Sysname> system-view

[Sysname] network-clock ssmcontrol on

Related commands

display network-clock source

network-clock ssm

network-clock ssm-degrade-threshold

Use network-clock ssm-degrade-threshold to set an SSM level degradation threshold for the clock reference.

Use undo network-clock ssm-degrade-threshold to restore the default.

Syntax

network-clock ssm-degrade-threshold { dnu | prc | sec | ssua | ssub }

undo network-clock ssm-degrade-threshold

Default

The SSM level degradation threshold is dnu.

Views

System view

Predefined user roles

network-admin

Parameters

dnu: Sets the SSM quality level to DNU SSM quality level. DNU clock sources cannot participate in automatic clock reference selection.

prc: Sets the SSM quality level to G.811 primary reference clock.

sec: Sets the SSM quality level to SDH equipment clock.

ssua: Sets the SSM quality level to G.812 primary-level SSU.

ssub: Sets the SSM quality level to G.812 second-level SSU.

Usage guidelines

After you configure the SSM level degradation threshold, the system outputs an SSM degradation alarm when the SSM level of the reference clock is degraded to a level lower than the threshold.

Examples

# Set the SSM level degradation threshold to prc.

<Sysname> system-view

[Sysname] network-clock ssm-degrade-threshold prc

network-clock work-mode

Use network-clock work-mode to set the clock reference selection mode.

Use undo network-clock work-mode to restore the default.

Syntax

network-clock work-mode { auto | manual source { bits0 | bits1 | lpuport interface-type interface-number | ptp } }

undo network-clock work-mode

Default

Automatic reference selection mode applies.

Views

System view

Predefined user roles

network-admin

Parameters

auto: Enables automatic reference selection.

manual source: Enables manual reference selection.

bits0: Specifies BITS 0 as the reference.

bits1: Specifies BITS 1 as the reference.

ptp: Specifies the PTP synchronized clock as the reference.

lpuport interface-type interface-number: Specifies a line clock input port as the reference. The interface-type interface-number arguments specify an interface by its type and number.

Usage guidelines

To use the timing signal from an interface as the synchronization reference, you must also specify the interface as a line clock input port by using the network-clock lpuport command.

It takes time for a clock reference selection mode change to take effect. To verify the effectiveness of the change, use the display network-clock status command or check the log.

Examples

# Specify BITS 0 as the clock reference.

<Sysname> system-view

[Sysname] network-clock work-mode manual source bits0

# Enable automatic reference selection.

<Sysname> system-view

[Sysname] network-clock work-mode auto

Related commands

display network-clock source

display network-clock status

network-clock lpuport

reset network-clock

Use reset network-clock to reset the clock state of the device.

Syntax

reset network-clock

Views

Any view

Predefined user roles

network-admin

Usage guidelines

If the clocks of two devices are locked to each other because of a misoperation, the clocks will form a loop. As a result, the clock quality will be reduced, and the phase-lock state of the clocks of the two devices will be switched from Locked to Holdover.

By default, when the clocks of two devices are locked to each other because of a misoperation, the phase-lock state of the clocks of the two devices will remain in Holdover state even if the wrong configuration is removed. To recover the clocks, you can use this command to reset the clock state of the device that acts as the clock source, so that the device can provide clock signals to the other end correctly. For example, the clocks of Device A and Device B are locked to each other and Device B acts as the clock source to provide Device A with clock signals. You can recover the clocks as follows:

1.     Cancel the misconfiguration on Device B.

2.     Use this command to reset the clock state of Device B.

3.     After the clock state of Device B is reset, Device A will reselect B as the clock reference.

Examples

# Reset the clock state of the device.

<Sysname> reset network-clock

Related commands

display network-clock status

Synchronous Ethernet commands

display esmc

Use display esmc to display ESMC information.

Syntax

display esmc [ 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, the command displays ESMC information for all interfaces.

Usage guidelines

ESMC information is not available for interfaces in asynchronous mode.

Examples

# Display ESMC information for all interfaces.

<Sysname> display esmc

Interface   : Ten-GigabitEthernet3/0/1

Mode        : Synchronous

ESMC status : Enable

ESMC bundle : 3

Port status : Up

Duplex mode : Full

QL received : QL-SEC

QL sent     : QL-PRC

ESMC information packets received : 2195

ESMC information packets sent     : 6034

ESMC event packets received       : 1

ESMC event packets sent           : 16

ESMC information rate             : 1 packets/sec

ESMC expiration                   : 5 seconds

Table 5 Command output

Field	Description
Interface	Interface that receives ESMC messages.
Mode	Ethernet interface mode: ·     Synchronous—Synchronous mode. Non-Synchronous—Asynchronous mode.
ESMC status	Whether ESMC is enabled: ·     Enable—ESMC is enabled. ·     Disable—ESMC is disabled.
ESMC bundle	ESMC bundle to which the interface is assigned. This field displays N/A if the interface is not assigned to any ESMC bundle.
Duplex mode	Duplex mode of the interface: ·     Full—The interface is operating in full-duplex mode. ·     Half—The interface is operating in half-duplex mode.‌
QL received QL sent	Quality level in the ESMC packet most recently received or sent on the interface: ·     PRC—G.811 primary reference clock. ·     SSU-A—G.812 primary-level SSU. ·     SSU-B—G.812 second-level SSU. ·     SEC—SDH equipment clock. ·     DNU—Do not use for synchronization. ·     UNK—Unknown quality level.
ESMC information packets received ESMC information packets sent	Number of received or sent ESMC information packets.
ESMC event packets received ESMC event packets sent	Number of received or sent ESMC event packets.
ESMC information rate	Transmission rate of ESMC information packets. The value is fixed at 1 pps.
ESMC expiration	ESMC expiration timer. The timer is fixed at 5 seconds.

 

Related commands

esmc enable

synchronous mode

esmc bundle

Use esmc bundle to assign an interface to an ESMC bundle.

Use undo esmc bundle to remove an interface from the ESMC bundle.

Syntax

esmc bundle bundle-number

undo esmc bundle

Default

An interface is not assigned to an ESMC bundle.

Views

Ethernet interface view

FlexE physical interface view

FlexE logical interface view

Predefined user roles

network-admin

Parameters

bundle-number: Specifies an ESMC bundle by its number. The value range for the bundle-number argument is 1 to 64.

Usage guidelines

If a device has multiple interfaces directly connected to the peer device and the interfaces are enabled with SyncE and ESMC, assign these interfaces to an ESMC bundle. This configuration will prevent SyncE clock loops.

When the device selects one interface in an ESMC bundle for clock synchronization, the priority of ESMC messages sent from all interfaces in the bundle is set to DNU. This prevents the peer device from synchronizing with the clock of the device by using the clock information from these interfaces and ensures that no clock loops will be produced.

For this command to take effect, you must first configure the synchronous mode command.

Examples

# Assign Ten-GigabitEthernet3/0/1 to ESMC bundle 3.

<Sysname> system-view

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

[Sysname-Ten-GigabitEthernet3/0/1] synchronous mode

[Sysname-Ten-GigabitEthernet3/0/1] esmc bundle 3

Related commands

esmc enable

synchronous mode

esmc enable

Use esmc enable to enable the Ethernet synchronization messaging channel (ESMC) on an Ethernet interface.

Use undo esmc enable to disable the Ethernet synchronization messaging channel (ESMC) on an Ethernet interface.

Syntax

esmc enable

undo esmc enable

Default

ESMC is disabled on Ethernet interfaces.

Views

Ethernet interface view

FlexE physical interface view

FlexE logical interface view

Predefined user roles

network-admin

Usage guidelines

Before you can enable ESMC, you must configure the interface to operate in synchronous mode.

Examples

# Enable ESMC on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

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

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

Related commands

display esmc

synchronous mode

synchronous mode

Use synchronous mode to enable the synchronous mode on an Ethernet interface.

Use undo synchronous mode to restore the default.

Syntax

synchronous mode

undo synchronous mode

Default

Ethernet interfaces are regular Ethernet interfaces in non-synchronous mode. They do not extract timing signals, send, forward, or process ESMC packets.

Views

Ethernet interface view

FlexE physical interface view

FlexE logical interface view

Predefined user roles

network-admin

Usage guidelines

You can configure an interface as a line clock input port only after you enable the synchronous mode on the interface.

Examples

# Enable the synchronous mode on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

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

[Sysname-Ten-GigabitEthernet3/0/1] synchronous mode

Related commands

display esmc

esmc enable