Configure Controller Parameters for NCS1K14-CCMD-16-C and NCS1K14-CCMD-16-L Cards | Configuring Controllers | Configuration Guide for Cisco NCS 1014, IOS XR Releases 26.x.x

This section lists and explains the software-supported controller parameters, operational attributes, and CLI commands for NCS1K14-CCMD-16-C and NCS1K14-CCMD-16-L line cards.

Table 1. Feature History
Feature Name	Release Information	Feature Description
Supported Functionalities of CCMD-16-C and CCMD-16-L Line Cards	Cisco IOS XR Release 7.11.1	Supported Functionalities of CCMD-16-C and CCMD-16-L Line Cards: The software supports Variable Optical Attenuator (VoA), power monitoring and reporting of parameters to the controllers at the OCH and OMS level. It helps in configuring the amplifier parameters for optimizing signal transmissions. The software also supports in-band and out-of-band tone detection and monitoring and reporting of alarms.

This chapter describes the controller configuration using EDFA, VoA, optical safety, and photodiode parameters which are supported on NCS1K14-CCMD-16-C and NCS1K14-CCMD-16-L line cards.

Table 2. Basic Controller Configuration Parameters
Parameter	CLI	Description
EDFA-ADD Control Mode	`controller Oms R/S/I/P` `egress-ampli-mode power-control`	Here the default mode is gain-control. Use this command to change the mode to power-control mode. You can delete this configuration to revert to gain-control mode.
EDFA-ADD Power	`controller Oms R/S/I/P` `egress-ampli-power <val in 0.1 dBm>`	This is the target output power configuration for the EDFA located on COM-Tx. If the output power is not configured, then a default value is used by the system. You can find the applied target output power by using the show controller oms output.
EDFA-ADD Gain Range	`controller Oms R/S/I/P` `egress-ampli-gain-range <normal \| extended>`	If you change the gain range from Normal to Extended or the opposite way, without updating the proper gain value for the new gain range, then the following may happen: The EDFA switches to the preconfigured or default value of the gain causing a mismatch between the operational and configured gain. The gain configuration is lost during the reload of software or line card, as the configured gain mismatches with the latest gain-range. This may result in traffic interruption during these reload operations. Hence, we recommend that you explicitly configure the gain range mode as normal or extended, and the corresponding gain values for each mode to get the expected results. The following are a few example scenarios that may not work as expected: Scenario 1: Current running config: `controller Oms R/S/I/P egress-ampli-gain-range extended egress-ampli-gain <gain value in extended mode>` New applied config: `controller Oms R/S/I/P no egress-ampli-gain-range extended commit` Scenario 2: Current running config: `controller Oms R/S/I/P egress-ampli-gain-range extended egress-ampli-gain <gain value in extended mode>` New applied config: `controller Oms R/S/I/P egress-ampli-gain-range Normal commit` Scenario 3: Current running config: `controller Oms R/S/I/P egress-ampli-gain <gain value in normal mode>` New applied config: `controller Oms R/S/I/P egress-ampli-gain-range extended commit` The following is another example scenario that involves commit-replace command where you replace the existing gain configuration that does not have explicitly configured gain-range, with new gain-range and gain value. Scenario 4: Current running config: `controller Oms R/S/I/P egress-ampli-gain <gain value in normal mode>` New applied config: `………….. controller Oms R/S/I/P egress-ampli-gain-range extended egress-ampli-gain <gain value in extended mode> commit replace`
EDFA-ADD Gain	`controller Oms R/S/I/P` `egress-ampli-gain <val in 0.1 dB>`	This is used for configuring gain for the EDFA located on the COM-Tx port. If the gain is not configured, then a default value is used by the system. The show controller oms output can be used for finding the applied gain.
EDFA-DROP Control Mode	`controller Oms R/S/I/P` `ingress-ampli-mode power-control`	The default mode is gain-control. Use this command to change the mode to power-control mode. You can delete this configuration to revert to gain-control mode.
EDFA-DROP Power	`controller Oms R/S/I/P` `ingress-ampli-power <vale in 0.1 dBm>`	This is the target output power configuration for the EDFA located on COM-Rx. If the output power is not configured, then a default value is used by the system. You can find the applied target output power by using the show controller oms output.
EDFA-DROP Gain	`controller Oms R/S/I/P` `ingress-ampli-gain <val in 0.1 dB>`	This is used for configuring gain for the EDFA located on the COM-Rx port. If the gain is not configured, then a default value is used by the system. The show controller oms output can be used for finding the applied gain.
VoA Attenuation	`controller Oms R/S/I/P` `tx-voa-attenuation <val in 0.1 dB>` `rx-voa-attenuation <val in 01. dB>`	This is used to configure VoA attenuation for COM-Tx and COM-Rx ports. The system picks a default value if the gain is not configured. The show controller oms output can be used for finding the applied attenuation.
Shutdown (COM Port)	`controller Oms R/S/I/P` `shutdown`	COM-Tx and Rx ports are put in Out of Service (OOS) when this command is executed. This turns off the EDFA devices on both COM-Tx and COM-Rx ports and the respective alarms are masked. Here the default value is 'unshut'.
Shutdown (Ch Ports)	`controller Och R/S/I/P` `shutdown`	The channel port will be marked as out-of-service.

Configure Operational Parameters

The different operational parameters supported are given below.

Table 3. Operational Parameters
Parameter	CLI	Description
Photo Diodes (COM Port)	OMS Controller `Tx Power and Rx Power`	Rx Power = Inband power + OOB Tx Power = Inband power + OOB It reports the power transmitted and received on the OMS port. The OOB power received on COM-Rx is looped back to COM-Tx with some loss due to the insertion-loss on the loop back path.
Photo Diodes (CH Ports)	OCH Controller `Tx Power and Rx Power`	It reports the power transmitted and received on the channel ports.
Amplifier Parameters	OMS Controller `Ingress Ampli Mode` `Ingress Ampli Gain` `Ingress Ampli Tilt` `Ingress Ampli OSRI` `Egress Ampli Mode` `Egress Ampli Gain` `Egress Ampli Tilt` `Egress Ampli Gain Range` `Egress Ampli OSRI` `Egress Ampli BR Power` `Egress Ampli BR Ratio`	Egress and ingress amplifier parameters.
VoA Parameters	OMS Controller `Tx VoA Attenuation and Rx VoA Attenuation`	VoA attenuation parameters.

Configure Optical Safety Parameters

Use the following parameters for configuring optical safety.

Table 4. Optical Safety Parameters
Parameter	CLI	Description
OSRI	`controller Oms R/S/I/P` `egress-ampli-osri` `ingress-ampli-osri`	Use this configuration to enable or Disable Optical Safety Remote Interlock (OSRI) on the amplifiers located on COM-Tx and COM-Rx ports. The default value is 'Off'. The show controller oms output can be used for finding the OSRI configuration and status.