DWDM provisioning
This section provides information to provision the DWDM coherent optic, frequency, and coherent parameters.
Note: Different procedures are required if the DWDM
port is managed using the OpenConfig component YANG model.
Provisioning the DWDM coherent optic
This procedure describes how to provision the DWDM coherent optic. To provision the DWDM coherent optic, the user must provision the connector breakout type and enable the transceiver Digital Coherent Optics (DCO) on the cage where the device is present. Use the following command to show connector information.
show port 1/1/c1Output example
The following example shows that the starting point is a new default connector 1/1/c1 that is not provisioned, is administratively shutdown, and has a DWDM coherent optic transceiver installed.
===============================================================================
QSFP-DD Connector
===============================================================================
Description : QSFP-DD Connector
Interface : 1/1/c1
FP Number : 1 MAC Chip Number : 1
Licensed : Yes
Admin State : down
Oper State : down
IfIndex : 1610899520
Last State Change : 03/01/2022 18:10:14
Last Cleared Time : 03/01/2022 18:20:32 DDM Events : Enabled
Breakout : no breakout
RS-FEC Config Mode : None
Transceiver Data
Transceiver Status : operational
Transceiver Type : QSFP-DD DCO : Disabled
Model Number : 3HE16565AARA01 NOK INUIAPJHAA
TX Laser Wavelength: 1547 nm Diag Capable : yes
Number of Lanes : 1
Connector Code : LC Vendor OUI : 20:20:20
Manufacture date : 2021/06/03 Media : Ethernet
Serial Number : 11111111111
Part Number : DP04QSDD-E30-090
Optical Compliance : 400G-ZR-Amp 400G-ZR-Unamp 400G-ZR-Amp Custom (197) Custo*
Link Length support: Unknown
-
Use the following command to configure the connector breakout.
configure port connector breakoutMD-CLI
*[ex:/configure port 1/1/c1 connector] A:admin@node-2# breakout c1-400gclassic CLI
*A:node-2# configure port 1/1/c1 connector breakout c1-400g -
Use the following command to configure the DCO.
configure port transceiver digital-coherent-opticsMD-CLI
*[ex:/configure port 1/1/c1 transceiver] A:admin@node-2# digital-coherent-optics trueclassic CLI
*A:node-2# configure port 1/1/c1 transceiver digital-coherent-optics
Provisioning DWDM frequency
Transceiver Type : QSFP-DD DCO : Enabled
Model Number : 3HE16565AARA01 NOK INUIAPJHAA
TX Laser Wavelength: 1547 nm
Laser Tunability : flex-tunable
Config Freq (MHz) : 0 Min Freq (MHz) : 191300000
Oper Freq (MHz) : not-operational Max Freq (MHz) : 196100000
Fine Tune Range : 6000 MHz Fine Tune Resolu*: 1 MHz
Supported Grids : 100GHz 75GHz 50GHz 25GHz 12.5GHz 6.25GHz
Diag Capable : yes
Number of Lanes : 1
Connector Code : LC Vendor OUI : 20:20:20
Manufacture date : 2021/06/03 Media : Ethernet
Serial Number : 11111111111
Part Number : DP04QSDD-E30-090
Optical Compliance : 400G-ZR-Amp 400G-ZR-Unamp
Link Length support: Unknown
===============================================================================
Transceiver Digital Diagnostic Monitoring (DDM)
===============================================================================
Value High Alarm High Warn Low Warn Low Alarm
-------------------------------------------------------------------------------
Temperature (C) +36.0 +80.0 +75.0 +15.0 -5.0
Supply Voltage (V) 3.30 3.46 3.43 3.17 3.13
===============================================================================
===============================================================================
Transceiver Lane Digital Diagnostic Monitoring (DDM)
===============================================================================
High Alarm High Warn Low Warn Low Alarm
-------------------------------------------------------------------------------
Lane Tx Output Power (dBm) 0.00 -2.00 -16.00 -18.01
Lane Rx Optical Pwr (avg dBm) 2.00 0.00 -23.01 -28.24
-------------------------------------------------------------------------------
Lane ID Temp(C)/Alm Tx Bias(mA)/Alm Tx Pwr(dBm)/Alm Rx Pwr(dBm)/Alm
-------------------------------------------------------------------------------
1 - - -40.00 -40.00
===============================================================================
===============================================================================
Coherent Optical Module
===============================================================================
Cfg Tx Target Power: 1.00 dBm Present Rx Channel : N/A
Cfg Rx LOS Thresh : -23.00 dBm Cfg Rx Channel : 0 (auto)
Disp Control Mode : automatic Sweep Start Disp : -25500 ps/nm
Cfg Dispersion : 0 ps/nm Sweep End Disp : 2000 ps/nm
CPR Window Size : 32 symbols Rx LOS Reaction : squelch
Compatibility : longHaul
Cfg Tx Power Min : -22.90 dBm Cfg Tx Power Max : 4.00 dBm
Cfg Alarms : modflt mod netrx nettx hosttx
Alarm Status :
Defect Points :
Rx Q Margin : 0.0 dB Chromatic Disp : 0 ps/nm
SNR X Polar : 0.0 dB Diff Group Delay : 0 ps
SNR Y Polar : 0.0 dB Pre-FEC BER : 0.000E+00
Module State : lowPower
Tx Turn-Up States :
Rx Turn-Up States :
-
Configure the frequency using the following context.
By default, no frequency is configured. A frequency must be provisioned. The following example displays a frequency configuration of 194400000:configure port 1/1/c1 dwdm frequency 194400000 (classic CLI)
*A:Dut-A# configure port 1/1/c1 dwdm frequency - frequency <MHz> - no frequency <MHz> : [191100000..196150000] *A:Dut-A# configure port 1/1/c1 dwdm frequency 194400000configure port 1/1/c1 dwdm frequency 194400000 (MD-CLI)*[pr:/configure port 1/1/c1 dwdm] A:admin@cses-V27# frequency ? frequency <number> <number> - <191100000..196150000> - megahertz Center frequency for tunable DWDM optical interface *[pr:/configure port 1/1/c1 dwdm] A:admin@cses-V27# frequency 194400000 -
Enable frequency by configuring either of the following:
- In the classic CLI, use the configure port 1/1/c1 no shutdown command to enable the connector.
- In the MD-CLI, use the configure port 1/1/c1 admin-state enable command to enable the connector.
In the following example, the “Config Freq” and “Oper Freq” fields in the show port 1/1/c1 output reflect the frequency setting, the “Coherent Optical Module” values are present, and the “Module State” displays the “txOff” value until the connector ports are administratively set to no shutdown or set to enable. For any DWDM frequency changes, after port 1/1/c1 is administratively set to no shutdown or set to enable again, the coherent module initializes and transitions through various states as visible in the “Module State” field.Transceiver Type : QSFP-DD DCO : Enabled Model Number : 3HE16565AARA01 NOK INUIAPJHAA TX Laser Wavelength: 1542.142 nm Laser Tunability : flex-tunable Config Freq (MHz) : 194400000 Min Freq (MHz) : 191300000 Oper Freq (MHz) : 194400000 Max Freq (MHz) : 196100000 Fine Tune Range : 6000 MHz Fine Tune Resolu*: 1 MHz Supported Grids : 100GHz 75GHz 50GHz 25GHz 12.5GHz 6.25GHz Diag Capable : yes Number of Lanes : 1 Connector Code : LC Vendor OUI : 7c:b2:5c Manufacture date : 2020/01/11 Media : Ethernet Serial Number : 111111111 Part Number : DP04QSDD-E30-090 Optical Compliance : 400G-ZR-Amp 400G-ZR-Unamp 400G-ZR-Amp Custom (197) Custo* Link Length support: Unknown =============================================================================== Transceiver Digital Diagnostic Monitoring (DDM) =============================================================================== Value High Alarm High Warn Low Warn Low Alarm ------------------------------------------------------------------------------- Temperature (C) +63.0 +80.0 +75.0 +15.0 -5.0 Supply Voltage (V) 3.25 3.46 3.43 3.17 3.13 =============================================================================== =============================================================================== Transceiver Lane Digital Diagnostic Monitoring (DDM) =============================================================================== High Alarm High Warn Low Warn Low Alarm ------------------------------------------------------------------------------- Lane Tx Output Power (dBm) 0.00 -2.00 -13.00 -14.00 Lane Rx Optical Pwr (avg dBm) 2.00 0.00 -21.02 -23.01 ------------------------------------------------------------------------------- Lane ID Temp(C)/Alm Tx Bias(mA)/Alm Tx Pwr(dBm)/Alm Rx Pwr(dBm)/Alm ------------------------------------------------------------------------------- 1 - - -40.00 -9.78 =============================================================================== =============================================================================== Coherent Optical Module =============================================================================== Cfg Tx Target Power: 1.00 dBm Cfg Rx LOS Thresh : -23.00 dBm Disp Control Mode : automatic Sweep Start Disp : -25500 ps/nm Cfg Dispersion : 0 ps/nm Sweep End Disp : 2000 ps/nm CPR Window Size : 32 symbols Rx LOS Reaction : squelch Compatibility : longHaul Cfg Tx Power Min : -22.90 dBm Cfg Tx Power Max : 4.00 dBm Cfg Alarms : modflt mod netrx nettx hosttx Alarm Status : Defect Points : Rx Q Margin : 4.1 dB Chromatic Disp : 1 ps/nm SNR/OSNR X Polar : 19.2 dB / 35.7 dB Diff Group Delay : 3 ps SNR/OSNR Y Polar : 19.2 dB / 35.7 dB Pre-FEC BER : 3.340E-04 Module State : txOff Tx Turn-Up States : init laserTurnUp laserReadyOff laserReady modulatorConverge Rx Turn-Up States : init laserReady waitForInput adcSignal opticalLoc demodLock -
To the enable the laser and have the optic reach the “ready”
state, the connector port as per the configured breakout must be enabled.
Configure each connector port to be administratively set to no
shutdown or set to enable as follows:
- In the classic CLI, use the configure port 1/1/c1 no shutdown command to enable each connector port.
- In the MD-CLI, use the configure port 1/1/c1 admin-state enable command to enable each connector port.
Provisioning DWDM coherent parameters
Classic CLI command
*A:Dut-A# configure port 1/1/c1 dwdm coherent
- coherent
compatibility - Configure the optical mode and rate of operation
cpr-window-size - Configure the Carrier Phase Recovery window size
dispersion - Configure the dispersion compensation
mode - Configure the dispersion algorithm mode
[no] report-alarms - Enable/disable logging of alarms
[no] rx-los-reaction - Configure the reaction to an RX LOS
rx-los-thresh - Configure the average input power LOS (Loss of Signal)
threshold
sweep - Configure the dispersion sweep start and end values
target-power - Configure the desired average output power
MD-CLI command
*[pr:/configure port 1/1/c1 dwdm]
A:admin@cses-V27# coherent ?
coherent
apply-groups - Apply a configuration group at this level
apply-groups-exclude - Exclude a configuration group at this level
compatibility - Optical mode and rate of operation
cpr-window-size - Window size for the carrier phase recovery
dispersion - Residual chromatic dispersion compensation
mode - Mode used to compensate for chromatic dispersion
report-alarm + Enter the report-alarm context
rx-los-reaction - Reaction to an RX LOS
rx-los-thresh - Average input power LOS threshold
sweep + Enter the sweep context
target-power - Average output power target for the port
Note: For ZR and ZR+ optics, only the
compatibility, report-alarms,
rx-los-thresh, and target-power commands
are applicable.
-
Configure the coherent compatibility command using the
following context. The example below displays a compatibility
metro configuration.
configure port 1/1/c1 dwdm coherent compatibility metro (classic CLI)
*A:Dut-A# configure port 1/1/c1 dwdm coherent compatibility - compatibility <mode> <mode> : long-haul|metro|access|interop|interop2|interop3| long-haul-non-diff *A:Dut-B# configure port 1/1/c1 dwdm coherent compatibility metroconfigure port 1/1/c1 dwdm coherent compatibility metro (MD-CLI)*[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# compatibility ? compatibility <keyword> <keyword> - (long-haul|metro|access|interop|interop2|interop3|long-haul- non-differential) Default - long-haul Optical mode and rate of operation *[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# compatibility metroThe coherent compatibility applies different optic application codes. The command default is long-haul and to change what has been previously configured, the user must shut down or disable the 1/1/c1 connector before provisioning for coherent compatibility.For any DWDM compatibility changes, after the 1/1/c1 connector is configured as no shutdown in the classic CLI or admin-state enable in the MD-CLI, the coherent module initializes and transitions through various states as visible in the “Module State” field until it is ready again.
-
Configure the report-alarms or
report-alarm command using the following context. The
example below displays a configuration where the alarms are not reported.
configure port 1/1/c1 dwdm coherent no report-alarms modflt mod netrx nettx hosttx (classic CLI)
*A:Dut-A# configure port 1/1/c1 dwdm coherent report-alarms - no report-alarms [modflt] [mod] [netrx] [nettx] [hosttx] - report-alarms [modflt] [mod] [netrx] [nettx] [hosttx] *A:Dut-B# configure port 1/1/c1 dwdm coherent no report-alarms modflt mod netrx nettx hosttxconfigure port 1/1/c1 dwdm coherent report-alarm (MD-CLI)*[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# report-alarm ? report-alarm hosttx - Report the host (electrical side) transmit alarm mod - Report the module alarm modflt - Report the module fault alarm netrx - Report the network (optical side) receive alarm nettx - Report the network (optical side) transmit alarm *[pr:/configure port 1/1/c1 dwdm coherent report-alarm] A:admin@cses-V27# info modflt false mod false netrx false nettx false hosttx falseWhen an alarm is reported, it is logged in the event logs and a trap is sent to the Network Management System (NMS). For details about the alarms and defect points, see the TIMETRA-PORT-MIB.mib. By default, all alarms are reported. -
Configure the rx-los-thresh
command using the following context. The example below displays a configuration
of -18 dBm.
configure port 1/1/c1 dwdm coherent rx-los-thresh -18 (classic CLI)
*A:Dut-A# configure port 1/1/c1 dwdm coherent rx-los-thresh - rx-los-thresh <threshold> <threshold> : [-30.00..-13.00] dBm - Default: -23.00 *A:Dut-B# configure port 1/1/c1 dwdm coherent rx-los-thresh -18configure port 1/1/c1 dwdm coherent rx-los-thresh -18 (MD-CLI)*[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# rx-los-thresh ? rx-los-thresh <decimal-number> <decimal-number> - <-30.0..-13.0> - decibel-milliwatts, 2 fraction digits Default - -23 Average input power LOS threshold *[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# rx-los-thresh -18This command configures the received optical power threshold at which the Loss of Signal (LOS) alarm is declared. To clear the LOS alarm, the received optical power must be higher than the configured rx-los-thresh command. -
Configure the target-power
command using the following context. The example below displays a configuration
of -12 dBm.
configure port 1/1/c1 dwdm coherent target-power -12 (classic CLI)
*A:Dut-A# configure port 1/1/c1 dwdm coherent target-power - target-power <power> <power> : [-20.00..3.00] dBm - Default: 1.00 *A:Dut-A# configure port 1/1/c1 dwdm coherent target-power -12configure port 1/1/c1 dwdm coherent target-power -12 (MD-CLI)*[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# target-power ? target-power <decimal-number> <decimal-number> - <-20.0..3.0> - decibel-milliwatts, 2 fraction digits Default - 1 Average output power target for the port *[pr:/configure port 1/1/c1 dwdm coherent] A:admin@cses-V27# target-power -12The target-power command configures the average output power target for the port.The actual measured Tx power along with the configured power is displayed by using the show port 1/1/c1 detail command.=============================================================================== Transceiver Lane Digital Diagnostic Monitoring (DDM) =============================================================================== High Alarm High Warn Low Warn Low Alarm ------------------------------------------------------------------------------- Lane Tx Output Power (dBm) 0.00 -2.00 -13.00 -14.00 Lane Rx Optical Pwr (avg dBm) 2.00 0.00 -21.02 -23.01 ------------------------------------------------------------------------------- Lane ID Temp(C)/Alm Tx Bias(mA)/Alm Tx Pwr(dBm)/Alm Rx Pwr(dBm)/Alm ------------------------------------------------------------------------------- 1 - - -11.91 -9.86 =============================================================================== * indicates that the corresponding row element may have been truncated. =============================================================================== Coherent Optical Module =============================================================================== Cfg Tx Target Power: -12.00 dBm Cfg Rx LOS Thresh : -23.00 dBm Disp Control Mode : automatic Sweep Start Disp : -25500 ps/nm Cfg Dispersion : 0 ps/nm Sweep End Disp : 2000 ps/nm CPR Window Size : 32 symbols Rx LOS Reaction : squelch Compatibility : longHaul Cfg Tx Power Min : -22.90 dBm Cfg Tx Power Max : 4.00 dBm Cfg Alarms : modflt mod netrx nettx hosttx Alarm Status : Defect Points : Rx Q Margin : 4.1 dB Chromatic Disp : 1 ps/nm SNR/OSNR X Polar : 19.1 dB / 35.7 dB Diff Group Delay : 2 ps SNR/OSNR Y Polar : 19.1 dB / 35.7 dB Pre-FEC BER : 3.430E-04 Module State : ready Tx Turn-Up States : init laserTurnUp laserReadyOff laserReady modulatorConverge outputPowerAdjust Rx Turn-Up States : init laserReady waitForInput adcSignal opticalLock demodLock ------------------------------------------------------------------------------- Coherent Optical Port Statistics (Elapsed Seconds: 588) ------------------------------------------------------------------------------- Statistic Current Average Minimum Maximum ------------------------------------------------------------------------------- Rx BER 3.430E-04 3.415E-04 3.050E-04 3.780E-04 Rx SNR (dB) 19.2 19.1 19.1 19.2 Rx OSNR (dB) 35.7 35.7 35.7 35.7 Rx Chromatic Disp (ps/nm) 1 2 1 3 Rx Diff Group Delay (ps) 2 2 2 3 Rx Freq Offset (MHz) 287 284 182 387 Rx Q (dB) 10.6 10.5 10.5 10.6 Rx Per-Channel Power (dBm) -9.69 -9.63 -9.78 -9.49 Tx Power (dBm) -11.93 -10.69 -11.93 -9.72 -------------------------------------------------------------------------------