Configuration Guide for Cisco NCS 1001, IOS XR Release 25.x.x

Enable automated OTS-OCH thresholds on an amplifier

Updated: July 27, 2026

Want to summarize with AI?

Use this task to complete the required CLI configuration for automated OTS-OCH thresholds on an amplifier and confirm that the intended NCS 1001 behavior is available after the changes are committed.

You can enable or disable automated OTS-OCH thresholds on each EDFA card installed on the node. This setting applies to the EDFA OTS controllers and all related OTS-OCH controller ports.

Before you begin

This feature works only if the user has configured span loss calculation. See Span loss calculation.

When the automatic threshold function is enabled on the amplifier, the threshold value to set is determined using this formula:

rx-low-threshold= (Remote AmplChannel - RXSpanloss )-User Threshold Offset.

Where

Remote AmplChannel is the amplifier channel power set on the remote node for ots controller tx port of remote EDFA.

RXSpanloss is the RX Span Loss calculated on the local node.

User Threshold Offset is the ampli-auto-rxlow-threshold threshold-offset set on the local node for EDFA in slot 1.

Modifying any of the parameters in the formula does not automatically recalculate the rx-low threshold value. To update the rx-low threshold value, you must execute this CLI command:

hw-module slot<n>ampli-auto-rxlow-threshold threshold-offset <value>

Example: hw-module slot 1ampli-auto-rxlow-threshold threshold-offset 400

These parameters are used to configure the command:

<n> (1, 2, 3) : This parameter designates the specific slot where the EDFA card is installed within the device.
<value> (0-800) : This parameter specifies the adjustment to the amplifier RX-LOW threshold, given in tenths of dBm.

Procedure

	1.	Configure the required settings. Example: `hw-module location 0/RP0/CPU0 slot slot number ampli auto-threshold`
	2.	Use the show running hw-module command to verify that automatic thresholds are enabled. Example: `show running hw-module location 0/RP0/CPU0 slot 1 ampli`

The configuration is committed and the optical module uses the requested settings.

This sample enables autothreshold on an EDFA inserted in slot 1.


RP/0/RP0/CPU0:MYS-237#configure terminal 
RP/0/RP0/CPU0:MYS-237(config)#hw-module location 0/RP0/CPU0 slot 1 ampli auto-threshold 
RP/0/RP0/CPU0:MYS-237(config)#commit
RP/0/RP0/CPU0:MYS-237(config)#end

This sample checks whether the auto-threshold is configured.

#show running hw-module location 0/RP0/CPU0 slot 1 ampli
      ….
       ampli span-loss
       ampli node-type TERM
       ampli remote-node local-ipv4 10.58.xxx.xxx remote-ipv4 10.58.xxx.xxx remote-slot-id 3
       ampli auto-threshold

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.