Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide - For Cisco IOS Releases 12.3(21)BC, 12.3(21a)BC3 and later 12.3(21a)BCx releases
SIP and SPA Commands

Table Of Contents

SIP and SPA Commands

annex modulation

cable bonding-group-id

cable fiber-node

cable rf-channel

cable wideband auto-reset

controller modular-cable

debug c10k-jacket

debug cable fn

debug cable wbcmts

debug hw-module bay

description (cable fiber-node)

downstream cable

downstream modular-cable rf-channel

ip-address (controller)

modular-host subslot

rf-channel

rf-channel cable downstream channel-id

show cable mac-domain downstream-service-group

show controllers jacket

show controllers modular-cable

show hw-module bay

show hw-module bay oir

upstream cable connector


SIP and SPA Commands


This chapter documents new IOS commands (for Cisco IOS Release 12.3(21)BC) and 12.3(21a)BC3) for the Wideband SIP and Wideband SPA. For all other commands that can be used with the Wideband SIP and Wideband SPA, see these documents:

Cisco Broadband Cable Command Reference Guide

Cisco IOS Release 12.3 command reference and master index publications

Commands for the Wideband SIP and Wideband SPA

annex modulation

cable bonding-group-id

cable fiber-node

cable rf-channel

cable wideband auto-reset

controller modular-cable

debug c10k-jacket

debug cable fn

debug cable wbcmts

debug hw-module bay

description (cable fiber-node)

downstream cable

downstream modular-cable rf-channel

ip-address (controller)

modular-host subslot

rf-channel

rf-channel cable downstream channel-id

show cable mac-domain downstream-service-group

show controllers jacket

show controllers modular-cable

show hw-module bay

show hw-module bay oir

upstream cable connector

Modified Existing Commands for the Wideband SIP and Wideband SPA

The following are either existing commands that have been modified for the Wideband SIP and SPA or for wideband cable functionality or they are variants of existing commands that are used for wideband cable. For information on these commands, see the Cisco Broadband Cable Command Reference Guide.

card

clear cable modem reset

hw-module bay reload

hw-module shutdown

show cable modem summary

show cable modem wideband

show interface wideband-cable

annex modulation

To set the annex (MPEG framing format) and modulation for the Wideband SPA, use the annex modulation command in controller configuration mode. The no form of the annex modulation command sets annex to B and modulation to 64 QAM.

annex {A | B} modulation {64qam | 256qam} [rf-start-index rf-end-index]

no annex {A | B} modulation {64qam | 256qam} [rf-start-index rf-end-index]

Syntax Description

{A | B}

Specifies the MPEG framing format:

A-Annex A. The downstream is compatible with the European MPEG framing format specified in ITU-TJ.83 Annex A.

B-Annex B. The downstream is compatible with the North American MPEG framing format specified in ITU-TJ.83 Annex B.

{64qam | 256qam}

Specifies the modulation rate:

64qam-64-QAM modulation.

256qam-256-QAM modulation.

rf-start-index

rf-end-index

(Optional) Specifies the start and end indexes for RF channels. The following values are allowed:

If the annex is A and the modulation is 256 QAM, rf-start-index must be 0, and rf-end-index must be 17.

For all other cases, rf-start-index must be 0, and rf-end-index must be 23.


Command Default

No annex or modulation is set for the Wideband SPA.

Command Modes

Controller configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use this command to set the following on a Wideband SPA:

Annex (MPEG framing format)

Modulation

Start and end indexes for RF channels

Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command.

For annex A and 256 QAM, each Wideband SPA supports 18 RF channels.

For all other cases, each Wideband SPA supports 24 RF channels.

The rf-start-index and rf-end-index arguments are intended for future use and are not currently needed. If rf-start-index and rf-end-index are not specified, the default values are as follows:

If the annex is A and the modulation is 256 QAM, rf-start-index is 0, and rf-end-index is 17.

For all other cases, rf-start-index is 0, and rf-end-index is 23.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to set the MPEG framing format and modulation for the Wideband SPA located at slot 1, subslot 0, bay 0.

Router(config)# controller modular-cable 1/0/0 
Router(config-controller)# annex B modulation 64qam 

Related Commands

Command
Description

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

modular-host subslot

Specifies the modular-host line card.

rf-channel

Configures an RF channel on a Wideband SPA.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.


cable bonding-group-id

To specify a Bonding Group ID and indicate whether the bonding group is a primary or secondary bonded channel, use the cable bonding-group-id command in interface configuration mode. To remove a bonding group configuration and revert to the default bonding group (a primary bonding group), use the no form of the command.

cable bonding-group-id id_num [secondary]

no cable bonding-group-id id_num [secondary]

Syntax Description

id_num

A unique Bonding Group ID. Valid values are 1 to 255. The bonding group ID must be unique for each wideband channel on the CMTS.

secondary

Specifies that the bonding group is a secondary bonding group. If the secondary keyword is not used, the bonding group is a primary bonding group.


Command Default

If the cable bonding-group-id command is not issued, Cisco IOS software assigns a default ID to the bonding group and configures the wideband-channel cable interface as a primary bonding group.

Command Modes

Interface configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The cable bonding-group-id command is not needed for the wideband channels that will be received by the Scientific Atlanta DPC2505 or EPC2505 wideband cable modems.

The cable bonding-group-id command is used only for wideband channels that will be received by the Linksys WCM300-NA, WCM300-EURO, or WCM300-JP wideband cable modems.

Linksys WCM300 Cable Modem

For wideband channels that will be received by the Linksys WCM300-NA, WCM300-EURO, and WCM300-JP cable modems, the cable bonding-group-id command assigns a bonding group ID to a wideband-channel cable interface and configures the bonding group as a primary bonding group if the secondary keyword is not specified, or as a secondary bonding group if the secondary keyword is specified.

A primary bonding group is a primary bonded channel.

A secondary bonding group is a secondary bonded channel.

The primary bonded channel is the wideband channel on which the Linksys WCM300 modem receives all of its unicast traffic and some of its multicast traffic. The cable modem may identify the primary bonded channel and any secondary bonded channels to the CMTS at cable modem registration time. The DOCSIS configuration file may define the primary bonded channel for the CMTS to assign to the cable modem.

In addition to joining one primary bonded channel, the Linksys WCM300 may join up to two secondary bonded channels simultaneously in order to receive additional multicast data streams. The DOCSIS configuration file may define the secondary bonded channels for the modem to pass to the CMTS. Secondary bonded channels are intended to receive multicast traffic such as broadcast video that is not available on the primary bonded channel.

For information on the TLV encodings that can be used in the DOCSIS configuration file to identify primary and secondary bonded channels, see the Cisco Cable Wideband Solution Design and Implementation Guide, Release 1.0.


Note If a wideband channel is specified as a primary or secondary bonded channel in the DOCSIS configuration file, it must be identically defined as a primary or secondary bonded channel in the CMTS active, running configuration file.


If a wideband channel is configured with the cable bonding-group-id command or by default to be a primary bonded channel, the Linksys WCM300 modem will not register using it as one of its secondary bonded channels.

If a wideband channel is configured with the cable bonding-group-id command to be a secondary bonded channel, the Linksys WCM300 modem will not register using it as its primary bonded channel.


Note When a wideband channel is defined on a Wideband SPA, IOS software configures the wideband channel as a primary bonding group (primary bonded channel) and assigns a default ID to the bonding group. If a wideband channel is to be used as a secondary bonded channel, use the cable bonding-group-id command with the secondary keyword to specify that the channel is a secondary bonded channel.


If you specify a non-unique bonding-group ID for the id_num argument, cable bonding-group-id displays an error message and does not modify the ID.

Scientific Atlanta DPC2505 Cable Modem

The cable bonding-group-id command is not needed for the wideband channels that will be received by the Scientific Atlanta DPC2505 or EPC2505 cable modems.

Examples

The following examples show how to use the cable bonding-group-id command for a variety of purposes. The following cable bonding-group-id command specifies that wideband channel 10 on the Wideband SPA in slot/subslot/bay 1/0/1 will be a secondary bonding group (secondary bonded channel) having the bonding group ID 20.

Router# configure terminal 
Router(config)# interface wideband-cable 1/0/1:10 
Router(config-if)# cable bonding-group-id 20 secondary 

The following example shows how to change a bonding group with an ID of 20 from a secondary to a primary bonding group by omitting the secondary keyword:

Router(config-if)# cable bonding-group-id 20 

The no form of the cable bonding-group-id removes the configured bonding group and reverts the configuration to the default bonding group. For a secondary bonding group with the ID of 20, the following no forms of the command are equivalent:

Router(config-if)# no cable bonding-group-id 20 

or

Router(config-if)# no cable bonding-group-id 20 secondary 

When either of the preceding commands are issued, the wideband-channel cable interface is 
configured to use a default bonding group, which has a default bonding group ID assigned 
by IOS software and is a primary bonding group.

Related Commands

Command
Description

interface

Enters interface configuration mode.


cable fiber-node

To enter cable fiber-node configuration mode, use the cable fiber-node command in global configuration mode. To remove a fiber node configuration, use the no form of the command.

cable fiber-node fiber-node-id

no cable fiber-node fiber-node-id

Syntax Description

fiber-node-id

Specifies a unique numerical ID for the fiber node. Valid values are 1 to 256.


Command Default

The command mode is unchanged.

Command Modes

Global configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

In a cable network, a cable modem is physically connected to only one fiber node. Fiber node software configuration mirrors the physical topology of the cable network. When configuring fiber nodes with Cisco IOS CLI commands, a fiber node is a software mechanism to define the following:

The set of downstream RF channels that will flow into the fiber node

At least one primary downstream channel (traditional DOCSIS downstream channel) for the fiber node

The set of upstream channel ports on the cable interface line card that are connected to the fiber node and available as upstream channels

Use the cable fiber-node command to enter cable fiber-node configuration mode so that you can configure a fiber node.

For a wideband channel to work correctly, each fiber node must be configured as follows:

1. Use the cable fiber-node command to create the fiber node and to enter cable fiber-node configuration mode.

2. Use the downstream cable command to associate the fiber node with one or more primary downstream channels (traditional DOCSIS downstream channels).

3. Use the upstream cable connector command to specify the upstream channel ports for a fiber node.

4. Use the downstream modular-cable rf-channel command to make one or more RF channels available for the fiber node.

5. Optionally use the description (cable fiber-node) command to specify a description for the fiber node.

For each fiber node, a traditional DOCSIS downstream channel on the Cisco uBR10-MC5X20 cable interface line card is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way is called the primary downstream channel.

Each wideband channel must be associated with at least one primary downstream channel and can be associated with multiple primary downstream channels. A wideband channel and its associated primary downstream channels must be belong to the same virtual bundle interface.

The maximum number of cable fiber-nodes that can be configured is limited to 256 for each CMTS.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to enter configuration mode for fiber node 5.

Router# configure terminal 
Router(config)# cable fiber-node 5 
Router(config-fiber-node)#

Related Commands

Command
Description

description (cable fiber-node)

Specifies a description for a fiber node.

downstream cable

Assigns a primary downstream channel for a fiber node.

downstream modular-cable rf-channel

Specifies the RF channels that are available for wideband channels on a fiber node.

upstream cable connector

Specifies the upstream channel ports for a fiber node.


cable rf-channel

To associate an RF channel on a Wideband SPA with a wideband channel, use the cable rf-channel command in interface configuration mode. To remove an association of an RF channel to a wideband channel, use the no form of this command.

cable rf-channel rf-port  [bandwidth-percent bw-percent]

no cable rf-channel rf-port  [bandwidth-percent bw-percent]

Syntax Description

rf-port 

Specifies the RF channel's physical port on the Wideband SPA's FPGA. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

bandwidth-percent bw-percent

Specifies the percent of bandwidth from this RF channel that will be used for the wideband channel. Allowed range is 0 to 100. If bandwidth-percent is not used, the default bandwidth value is 100 percent.


Command Default

No default RF-channel association with a wideband channel is configured. If the cable rf-channel command is used without specifying bandwidth-percent, the default bandwidth value is 100 percent.

Command Modes

Interface configuration mode for a wideband-channel interface.

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The cable rf-channel command associates an RF channel (port) on a Wideband SPA with a wideband channel. Optionally, you can specify the percent of bandwidth from this RF channel that will be used for the specified wideband channel.

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. For all other cases, the SPA supports 24 RF channels.


Note The cable rf-channel command is not available on the Cisco IOS command line until annex and modulation have been set with annex modulation command.


Each Wideband SPA supports up to 12 wideband channels. A wideband channel cannot consist of RF channels from two different Wideband SPAs. The number of RF channels that can be aggregated into a wideband channel is determined by the capability of the wideband cable modem.

The Linksys WCM300-NA, WCM300-EURO, and WCM300-JP wideband cable modems can receive a wideband channel consisting of up to eight downstream RF channels at 6 MHz per channel, or up to six downstream RF channels at 8 MHz per channel. The modem requires that the channels be received in a 50 MHz capture window.

The Scientific Atlanta DPC2505 and EPC2505 wideband cable modems support the receiving of one wideband channel. The wideband channel consists of two downstream RF channels at either 6 MHz per channel or 8 MHz per channel.

An RF channel can be associated with multiple wideband channels as long as the wideband channels belong to the same virtual bundle interface (cable bundle) and the RF channel's total allocated bandwidth does not exceed 100 percent. As an example, Table 11-1 shows that a single RF channel can be associated with multiple wideband channels as long as the total allocated bandwidth for the RF channel does not exceed 100 percent.


Note


Table 11-1 RF Channel Bandwidth Allocation

RF Channel
Wideband
Channel
Bandwidth
Allocated

10

0

30 percent

10

1

30 percent

10

2

40 percent

 Total Bandwidth Percent: 100 percent



Note Each RF channel on the CMTS can be mapped (with the rf-channel's udp-port argument) to a specific QAM port on an edge QAM device. Traffic from different Wideband SPA's cannot be mixed on the same QAM port.


For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to associate RF channel 10 and RF channel 11 with wideband channel 0.

Router(config)# interface wideband-cable 1/0/0:0 
Router(config-if)# cable rf-channel 10 bandwidth-percent 50 
Router(config-if)# cable rf-channel 11 

In the preceding example, because no bandwidth-percent is specified in the second cable rf-channel, the default value (100 percent of bandwidth) applies. That is, 100 percent of RF channel 11 bandwidth is used for wideband channel 0.

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable bonding-group-id

Specifies a bonding group ID and indicates whether the bonding group is a primary or secondary wideband channel.

cable primary

Specifies that a wideband channel is a primary wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

downstream cable

Specifies the RF channels that are available for wideband channels on a fiber node.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

modular-host subslot

Specifies the modular-host line card.

rf-channel

Configures an RF channel on a Wideband SPA.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.

upstream cable connector

Specifies the upstream channel ports for a fiber node.


cable wideband auto-reset

To enable wideband auto-reset mode on the CMTS, use the cable wideband auto-reset command in global configuration mode. To disable wideband auto-reset mode, use the no form of the command.

cable wideband auto-reset

no cable wideband auto-reset

Syntax Description

This command has no keywords or arguments.

Command Default

Wideband auto-reset mode is disabled.

Command Modes

Global configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use this command to enable wideband auto-reset mode on the CMTS. If wideband auto-reset mode is enabled, wideband cable modems registered on a cable interface as traditional DOCSIS modems are auto-reset when the cable interface becomes wideband-capable. When a wideband cable modem auto-resets, it deregisters on the CMTS as a traditional DOCSIS cable modem and immediately attempts to re-register as a wideband cable modem.

A cable interface is considered wideband-capable when at least one fully configured and operational wideband channel has been associated with the interface's traditional DOCSIS (narrowband) channel.

For a fully configured wideband CMTS, wideband cable modems may register as traditional DOCSIS modems for a variety of reasons, such as cable interface line card boot order or line card online insertion and removal (OIR). Rather than defer wideband cable modem registration, wideband cable modems are permitted to register as traditional DOCSIS modems.

If a wideband-capable modem registers as a traditional DOCSIS modem, it registers on a primary downstream channel that has been assigned with the downstream cable command to the modem's fiber node if the fiber node is configured. If the modem's fiber node is not configured, the wideband-capable modem can register on any downstream channel that is visible to it (as a traditional cable modem does).

When and if a cable interface becomes wideband capable, wideband cable modems that have registered as traditional DOCSIS modems are reset for CMTS routers with wideband auto-reset mode enabled. These modems are only reset when the interface first becomes wideband-capable and are not reset again if they subsequently fail to register as wideband cable modems.

For information on assigning a primary downstream channel to a fiber node, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to enable wideband auto-reset mode.

Router# configure terminal 
Router(config)# cable wideband auto-reset

Related Commands

Command
Description

cable bundle

Configures a cable interface to belong to a virtual bundle interface.

downstream cable

Assigns a primary downstream channel for a fiber node.


controller modular-cable

To enter controller configuration mode to configure the Wideband SPA controller, use the controller modular-cable command in global configuration mode.

controller modular-cable  slot/subslot/bay

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).


Command Default

The command mode is unchanged.

Command Modes

Global configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

This command indicates where the Wideband SPA that will be configured is located and enters controller configuration mode.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to enter controller configuration mode for the Wideband SPA in slot 1, subslot 0, and bay 0.

Router# configure terminal 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# 
Router# 

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

modular-host subslot

Specifies the modular-host line card.

rf-channel

Configures an RF channel on a Wideband SPA.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.


debug c10k-jacket

To enable debugging information for the Wideband SIP, use the debug c10k-jacket command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug c10k-jacket

no debug c10k-jacket

Syntax Description

This command has no keywords or arguments.

Command Default

No Wideband SIP debug messages are enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The debug c10k-jacket command is intended for use by Cisco Systems technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco Systems technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

Examples

The following example shows how to enable debug messages for the Wideband SIP.

Router# debug c10k-jacket 

Related Commands

Command
Description

debug cable fn

Enables debugging information for cable fiber nodes.

debug cable wbcmts

Enables debugging information for the wideband CMTS.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug cable fn

To enable debugging information for cable fiber nodes, use the debug cable fn command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable fn

no debug cable fn

Syntax Description

This command has no keywords or arguments.

Command Default

No cable fiber node debug messages are enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The debug cable fn command is intended for use by Cisco Systems technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco Systems technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

For general (non-wideband) information on CMTS debugging commands, see the Cisco Broadband Cable Command Reference Guide.

Examples

The following example shows how to enable debug messages for cable fiber nodes:

Router# debug cable fn 

CMTS fiber node debugging is on

Router# 
...

The following sample messages are displayed when RF channels 0 and 1 are removed from fiber node 1:

Router(config)# cable fiber 1  
Router(config-fiber-node)# no downstream modular-cable 3/0/0 rf-channel 0 - 1  
...
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(0)
*Nov 7 17:42:27.903: cfg_cable_fn_cmd: fiber-node 1 status 0x01 cmd 3 sense 0
*Nov 7 17:42:27.903: no downstream FN 1, 3/0/0 port range 0 - 1 
*Nov 7 17:42:27.903: no downstream FN 1, 3/0/0 bg_rfch 0000000000000004 
*Nov 7 17:42:27.903: set FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_freq_unique: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 freq 555000000 channel_id 203 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: bg_rfch 2 freq 711000000 channel_id 26 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_channel_id_unique: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 freq 203 channel_id 203 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: bg_rfch 2 freq 711000000 channel_id 26 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_bundle_same: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 nb_hwidb Cable8/1/0 bundle 1 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: cfg_cable_fn_cmd: fiber-node 1 status 0x01 
*Nov 7 17:42:35.267: FN 1 save context status 0x01(0x01) 
*Nov 7 17:42:35.267: FN 1 status 0x01 saved status 0x01) 
*Nov 7 17:42:35.267: fiber-node 1 update SG status = 0x01 
*Nov 7 17:42:35.267: DS-SG: Updating Association Table from DS-SG. Current: 0x1 New: 0x0 
*Nov 7 17:42:35.267: DS-SG: Updating the Wideband Channel Mask: 0x0 

Related Commands

Command
Description

debug c10k-jacket

Enables debugging information for the Wideband SIP.

debug cable wbcmts

Enables debugging information for the wideband CMTS.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug cable wbcmts

To enable debugging information for the wideband CMTS, use the debug cable wbcmts command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable wbcmts [association | bpi | cli | guardian | statistics | wcd]

no debug cable wbcmts [association | bpi | cli | guardian | statistics | wcd]

Syntax Description

association

Enables debug messages for RF to fiber-node associations.

bpi

Enables debug messages for Baseline Privacy Interface (BPI).

cli

Enables debug messages for wideband-related Cisco IOS CLI activity.

guardian

Enables debug messages for DOCSIS 3.0 Downstream Channel Bonding operations performed by the modular-host line card.

ha

Enables debug messages for wideband high availability (ha).

statistics

Enables debug messages for wideband-related statistics.

wbka

Enables debug messages for wideband keepalive (wbka) operations.

wcd

Enables debug messages with wideband channel information as conveyed in the Bonded Downstream Channel Descriptor (BDCD).


Command Default

No wideband-related debug messages are enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The debug cable wbcmts command is intended for use by Cisco Systems technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco Systems technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

If you specify debug cable wbcmts with no argument, generic wideband debugging messages are enabled.

Before issuing the debug cable wbcmts wcd command to display BDCD information, you must issue the debug cable interface command to enable debugging on the cable interface line card configured for DOCSIS 3.0 protocol operations. For example:

Router# debug cable interface Cable slot/subslot/port
Router# debug cable wbcmts wcd 

In the preceding example, slot/subslot/port specifies a port on a cable interface line card that has been configured for DOCSIS 3.0 protocol operations with the modular-host subslot command. The line card cable interface for which you enable debug messages with debug cable interface is the first cable interface that is up. For example, if the line card configured for DOCSIS 3.0 protocol operations is located in slot 7/0, specify interface 7/0/1 if 7/0/0 is down and 7/0/1 is up.

For information on configuring a cable interface line card for DOCSIS 3.0 protocol operations, see the command modular-host subslot.

Examples

The following example shows how to enable debug messages for RF to fiber-node associations, and shows sample output:

Router# debug cable wbcmts association 

WBCMTS Association debugging is on 
...
Router(config-fiber-node)# downstream modular-cable 3/0/0 rf-channel 0-1
Router(config-fiber-node)# end
...
Router#
*Nov 7 17:16:08.835: Remove Wideband-Cable3/0/0:0 nb_info 8/1 index 0,chanID 203 bundle 1, 
Index 203
*Nov 7 17:16:08.835: Remove Cable8/1/0 wb_info 8/1 wb_index 0, chanID 72, Index 72
*Nov 7 17:16:08.835: %SYS-5-CONFIG_I: Configured from console by console 

Router# 

The following example shows how to enable debug messages for wideband CMTS statistics, and shows sample output.

Router# debug cable wbcmts statistics

WBCMTS statistics debugging is on

Router# 
Router# show interface cable 8/1/0 service-flow 19 counters
Sfid Packets Bytes PacketDrop Bits/Sec Packet/Sec
19   0       0     0          0        0 
Router#
*Nov 7 17:28:09.815: LC SFID=19, SFID=19, Blaze_Index=23 Reading stats for SFID 1 @ index 
23 on 3/0/0 

Related Commands

Command
Description

debug c10k-jacket

Enables debugging information for the Wideband SIP.

debug cable fn

Enables debugging information for cable fiber nodes.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug hw-module bay

To enable debugging information for a Wideband SPA, use the debug hw-module bay command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug hw-module bay slot/subslot/bay {commands | errors | events | interrupts | oir | periodic}

no debug hw-module bay slot/subslot/bay {commands | errors | events | interrupts | oir | periodic}

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

commands

Enables debug messages for control plane configuration and commands on a Wideband SPA.

errors

Enables debug messages for error handling and race conditions on a Wideband SPA.

events

Enables debug messages for control plane event notifications on a Wideband SPA.

interrupts

Enables debug messages for interrupt handling on a Wideband SPA.

oir

Enables debug messages for online insertion and removal (OIR) processing on a Wideband SPA.

periodic

Enables debug messages for periodic processing on a Wideband SPA.


Command Default

No Wideband SPA debug messages are enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The debug hw-module bay command is intended for use by Cisco Systems technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco Systems technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

If you attempt to use a debug hw-module bay command without a Wideband SPA installed, the keyword options are not provided.

Examples

The following example shows how to enable debug messages for error handling and race conditions:

Router# debug hw-module bay 1/0/0 errors 

Related Commands

Command
Description

debug c10k-jacket

Enable debugging information for the Wideband SIP.

debug cable fn

Enables debugging information for cable fiber nodes.

debug cable wbcmts

Enables debugging information for the wideband CMTS.


description (cable fiber-node)

To specify a description for a fiber node, use the description command in cable fiber-node configuration mode. To remove a description for a fiber node, use the no form of the command.

description description

no description

Syntax Description

description

Specifies a description for the cable fiber node. The character-string can be up to 80 characters long.


Command Default

If the description command is not issued, a description does not exist.

Command Modes

Cable fiber-node configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The description command adds a comment to the configuration to provide information about the fiber node.

Examples

The following example shows how to specify a description for fiber node 5:

Router# configure terminal 
Router(config)# cable fiber-node 5 
Router(config-fiber-node)# description Branch office 5 

Related Commands

Command
Description

cable fiber-node

Enters cable fiber-node configuration mode so that you can configure a fiber node.

downstream cable

Assigns a primary downstream channel for a fiber node.

downstream modular-cable rf-channel

Specifies the RF channels that are available for wideband channels on a fiber node.

upstream cable connector

Specifies the upstream channel ports for a fiber node


downstream cable

To assign a primary downstream channel for a fiber node, use the downstream cable command in cable fiber-node configuration mode. To remove a primary downstream channel for a fiber node, use the no form of the command.

downstream cable slot/subslot/port

no downstream cable slot/subslot/port

Syntax Description

slot

The slot used for the cable interface line card. Valid values are 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 or 1.

port

The downstream port that can be used as a primary downstream channel. Valid values are 0 to 4.


Command Default

If the downstream cable command is not issued, no primary downstream channel is assigned to the fiber node.

Command Modes

Cable fiber-node configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router. 


Usage Guidelines

For each fiber node, a traditional DOCSIS downstream channel is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way is called the primary downstream channel.

The downstream cable command assigns a primary downstream channel for a fiber node. Each fiber node must be assigned at least one primary downstream channel and can be assigned multiple primary downstream channels. Cisco IOS software decides which primary downstream channel to use for the fiber node from the set of channels assigned with downstream cable. Assigning more than one primary channel to a fiber node with the downstream cable command can be useful for load-balancing purposes.

If a wideband-capable modem registers as a traditional DOCSIS 2.0 modem, it will register on a downstream channel as follows:

If the modem's fiber node has been assigned a primary downstream channel with the downstream cable command, the modem registers on that downstream channel.

If the modem's fiber node has not been assigned a primary downstream channel with the downstream cable command, the modem can register on any downstream channel that is visible to it.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to assign a primary downstream channel for fiber node 5. The primary downstream channel is the downstream port located on the cable interface line card at slot/subslot/port 6/0/0.

Router# configure terminal 
Router(config)# cable fiber-node 5 
Router(config-fiber-node)# downstream cable 6/0/0 

Related Commands

Command
Description

cable fiber-node

Enters cable fiber-node configuration mode so that you can configure a fiber node.

description (cable fiber-node)

Specifies a description for a fiber node.

downstream modular-cable rf-channel

Specifies the RF channels that are available for wideband channels on a fiber node.

upstream cable connector

Specifies the upstream channel ports for a fiber node.


downstream modular-cable rf-channel

To specify the RF channels that are available for wideband channels on a fiber node, use the downstream modular-cable rf-channel command in cable fiber-node configuration mode. To remove RF channels that are available for wideband channels on a fiber node, use the no form of the command.

downstream modular-cable slot/subslot/bay rf-channel {rf-port | low-high}

no downstream modular-cable slot/subslot/bay rf-channel {rf-port | low-high}

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

rf-port

Specifies the RF channel physical port on the Wideband SPA FPGA. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

low-high

A range of RF channel physical ports on the Wideband SPA FPGA. The low and high values are separated by a hyphen.


Command Default

If the downstream modular-cable rf-channel command is not issued, no RF channels are configured for wideband channels on the fiber node.

Command Modes

Cable fiber-node configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

The downstream modular-cable rf-channel command makes RF channels available for use on a fiber node. Fiber node software configuration mirrors the physical topology of the cable network. The cable rf-channel command configures the RF channels that will be used for a wideband channel on a Wideband SPA.

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command.

For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. In this case, valid values for the rf-port argument are 0 to 17.

For all other cases, the SPA supports 24 RF channels. In these cases, valid values for the rf-port argument are 0 to 23.

A fiber node can be configured to have RF channels from one or both Wideband SPAs. However, a wideband channel cannot be comprised of RF channels from two different SPAs.

Each time the downstream modular-cable rf-channel command is issued for a fiber node, the set of RF channels that are available for use on that fiber node is added to in a cumulative manner. For example, if the following downstream modular-cable rf-channel commands were issued, the set of RF channels available for fiber node 1 is RF channels 0 to 10 on the Wideband SPA in slot/subslot/bay 1/0/0.

Router# configure terminal 
Router(config)# cable fiber-node 1 
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 0-5 
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 6-10 

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to specify that RF channels 0 to 7 on a Wideband SPA will be available for use on fiber-node 5. The Wideband SPA is located in slot/subslot/bay 1/0/0.

Router# configure terminal 
Router(config)# cable fiber-node 5 
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 0-7 

Related Commands

Command
Description

cable fiber-node

Enters cable fiber-node configuration mode so that you can configure a fiber node.

description (cable fiber-node)

Specifies a description for a fiber node.

downstream cable

Assigns a primary downstream channel for a fiber node.

upstream cable connector

Specifies the upstream channel ports for a fiber node.


ip-address (controller)

To set the IP address of the Wideband SPA FPGA, use the ip-address (controller) command in controller configuration mode. To remove the IP address of the Wideband SPA FPGA, use the no form of this command.

ip-address ip-address

no ip-address ip-address

Syntax Description

ip-address

IP address for the Wideband SPA FPGA.


Command Default

No IP address is set for the Wideband SPA FPGA.

Command Modes

Controller configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use this command to set IP address for the Wideband SPA FPGA. This address is used as the source IP address for packets that the Wideband SPA transmits to the EQAM device.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to set the IP address of the Wideband SPA FPGA. The SPA is located at slot 1, subslot 0, bay 0.

Router(config)# controller modular-cable 1/0/0 
Router(config-controller)# ip-address 192.168.200.6 

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

modular-host subslot

Specifies the modular-host line card.

rf-channel

Configures an RF channel on a Wideband SPA.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.


modular-host subslot

To specify the modular-host line card that will be used for DOCSIS 3.0 Downstream Channel Bonding operations, use the modular-host subslot command in controller configuration mode. To remove the modular-host line card used for DOCSIS 3.0 Downstream Channel Bonding operations, use the no form of this command.

modular-host subslot slot/subslot

no modular-host subslot slot/subslot

Syntax Description

slot/subslot

The location of the modular-host line card.


Command Default

No modular-host line card is configured for DOCSIS 3.0 Downstream Channel Bonding operations.

Command Modes

Controller configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

This command specifies the modular-host line card for DOCSIS 3.0 Downstream Channel Bonding operations. This is the cable interface line card (for example, the Cisco uBR10-MC5X20S-D line card) that is used for these operations. The Wideband SPA itself does not support DOCSIS 3.0 Downstream Channel Bonding operations.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to configure the modular-host line card for DOCSIS 3.0 Downstream Channel Bonding operations for the Wideband SPA located in slot/subslot/bay 1/0/0:

Router(config)# controller modular-cable 1/0/0 
Router(config-controller)# modular-host subslot 7/0 

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

rf-channel

Configures an RF channel on a Wideband SPA.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.


rf-channel

To configure an RF channel on a Wideband SPA, use the rf-channel command in controller configuration mode. To remove an RF channel configuration, use the no form of this command.

rf-channel rf-port  [description description] [frequency freq]
[ip-address ip-address mac-address mac-address udp-port portnum]

no rf-channel rf-port  [description description] [frequency freq]
[ip-address ip-address mac-address mac-address udp-port portnum]

Syntax Description

rf-port 

Specifies the RF-channel physical port on the Wideband SPA's FPGA. Allowed range is 0 to 23. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

description description

(Optional) Specifies a description for the RF channel.

frequency freq

(Optional) Sets the center frequency for the RF channel. Allowed range is 50000000 to 867000000 Hz.

ip-address ip-address

(Optional) Specifies the IP address of the Gigabit Ethernet interface on the edge QAM device for this RF channel.

mac-address mac-address

(Optional) Specifies the MAC address of the next-hop interface or of the edge QAM device for this RF channel. See the Usage Guidelines.

udp-port portnum

(Optional) Specifies the UDP port number for the edge QAM that will be used for this RF channel. Allowed range is 0 to 65535.



Note The description, frequency, ip-address, mac-address, and udp-port arguments are optional in the sense that only one of these has to be specified when rf-channel is issued. More than one of these arguments can be specified when rf-channel is issued.

For each RF channel that will be used on the Wideband SPA, the values for the channel's frequency, IP address, MAC address, and UDP port number must be set with rf-channel.


Command Default

No default RF-channel configuration values are set.

Command Modes

Controller configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

This command configures an RF channel on a Wideband SPA. The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. For all other cases, the SPA supports 24 RF channels.


Note The rf-channel command is not available on the Cisco IOS command line until annex and modulation have been set with the annex modulation command.


For each RF channel, use the rf-channel command in controller configuration mode to configure RF-channel characteristics. For each RF channel (rf-port), the following items must be configured with rf-channel:

Frequency

IP address

MAC address

UDP port

Associated wideband channel (see the cable rf-channel command)

Uniqueness of frequency is required for all cable downstream channels on all cable interfaces and all Wideband SPAs on the CMTS.

The value used for mac-address in the mac-address argument is as follows:

If a Gigabit Ethernet router or Layer-3 switch is used between the Wideband SPA and the edge QAM device, the value specified for mac-address is the MAC address for the next-hop interface on the router or Layer-3 switch.

If a Gigabit Ethernet router or Layer-3 switch is not used, the value specified for mac-address is the MAC address for Gigabit Ethernet interface on the edge QAM device.

The UDP port number set for the RF channel allows mapping an input UDP session to a specific QAM output port. Wideband traffic from different Wideband SPAs cannot be mixed on the same QAM output ports.

Specifying the description keyword to provide a description for the RF channel is optional. Multiple invocations of rf-channel (as opposed to a single invocation) can be used to configure an RF channel. See the Examples section.


Note Be certain to verify that the RF-channel values set with rf-channel match the values configured for the QAM outputs on the edge QAM device. Frequency, IP address, MAC address, and UDP port must be match. If any of these values do not match, the Wideband SPA will not successfully communicate with the edge QAM device.


For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to configure RF channel characteristics for RF port 0:

Router# configure terminal 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 frequency 699000000 
Router(config-controller)# rf-channel 0 ip-address 192.168.200.30 mac-address 
0011-920e-a9ff udp-port 49152 

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable primary

Specifies that a wideband channel is a primary wideband channel.

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

modular-host subslot

Specifies the modular-host line card.

rf-channel cable downstream channel-id

Assigns a downstream channel ID to an RF channel.


rf-channel cable downstream channel-id

To assign a downstream channel ID to an RF channel, use the rf-channel cable downstream channel-id command in controller configuration mode. To remove a downstream channel ID for an RF channel, use the no form of the command.

rf-channel rf-port cable downstream channel-id channel-id

no rf-channel rf-port cable downstream channel-id channel-id

Syntax Description

rf-port

Specifies the RF-channel physical port on the Wideband SPA FPGA. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

channel-id

A unique channel ID. Valid values are 0 to 255.


Command Default

If the rf-channel cable downstream channel-id command is not issued, IOS software assigns a unique downstream channel ID to the RF channel.

Command Modes

Controller configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router. 


Usage Guidelines

For the wideband channel to work correctly, each RF channel on the fiber node that the wideband channel uses must have a unique downstream channel ID. By default, Cisco IOS software assigns a unique downstream channel ID to the RF channel. Use the rf-channel cable downstream channel-id command to change the default channel ID.

The downstream channel ID that is assigned to the RF channel must be unique on the fiber node.

The ID cannot be the same ID as is used for another RF channel on the fiber node.

The ID cannot be the same ID as is used for a primary downstream channel on the fiber node.

You can check downstream channel IDs that are being used by examining the CMTS router configuration file.


Note If you assign a downstream channel ID that is not unique on the fiber node, the rf-channel cable downstream channel-id command displays an error message. The command does assign the channel ID, but the status of the fiber node becomes invalid.


The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command.

For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. In this case, valid values for the rf-port argument are 0 to 17.

For all other cases, the SPA supports 24 RF channels. In these cases, valid values for the rf-port argument are 0 to 23.

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to assign a downstream channel ID of 123 to RF channel 3 on the Wideband SPA located in slot/subslot/bay 1/0/1.

Router# configure terminal 
Router(config)# controller modular-cable 1/0/1 
Router(config-controller)# rf-channel 3 cable downstream channel-id 123 

Related Commands

Command
Description

annex modulation

Sets the annex and modulation for the Wideband SPA.

cable primary

Specifies that a wideband channel is a primary wideband channel.

cable rf-channel

Associates an RF channel on a Wideband SPA with a wideband channel.

controller modular-cable

Enters controller configuration mode to configure the Wideband SPA controller.

modular-host subslot

Specifies the modular-host line card.

ip-address (controller)

Sets the IP address of the Wideband SPA FPGA.

rf-channel

Configures an RF channel on a Wideband SPA.


show cable mac-domain downstream-service-group

To display MAC Domain Downstream Service Group information for a primary downstream channel, use the show cable mac-domain downstream-service-group command in privileged EXEC mode.

show cable mac-domain cable slot/subslot/port downstream-service-group

Syntax Description

slot

The slot used for the cable interface line card. Valid values are 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 or 1.

port

The downstream port used as a primary downstream channel. Valid values are 0 to 4.


Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router. 


Usage Guidelines

Use the show cable mac-domain downstream-service-group command to display MAC Domain Downstream Service Group (MD-DS-SG) information for the specified primary downstream channel.

For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable interface line card is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way for a MAC domain is called the primary downstream channel.

Examples

The following example displays show cable mac-domain downstream-service-group output for the primary downstream channel on the cable interface at slot/subslot/port 5/0/0:

Router# show cable mac-domain cable5/0/0 downstream-service-group 

Primary  MD-DS-SG         RF                                                            
IF       Id        SPA    Chan                                                          
C5/0/0   1         1/0/0  0 - 1

In the preceding example, the MD-DS-SG with ID 1 is used for RF channels 0 and 1 on the Wideband SPA located in slot/subslot/bay 1/0/0.

Related Commands

Command
Description

show cable modem

Displays information for registered and unregistered cable modems (including wideband cable modems).

show cable modem wideband

Displays information for registered and unregistered wideband cable modems.


show controllers jacket

To display Wideband SIP register values, use the show controllers jacket command in privileged EXEC mode.

show controllers jacket slot/subslot [all | cpld | processor | vanadium | spi_fpga]

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

all

(Optional) Displays values for all registers.

cpld

(Optional) Displays values for the CPLD registers.

processor

(Optional) Displays values for the processor registers.

vanadium

(Optional) Displays values for the Vanadium registers.

spi_fpga

(Optional) Displays values for the SPI FPGA registers.


Command Default

If you do not specify all or the keyword for a register, show controllers jacket displays values for all registers.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use the show controllers jacket command to display Wideband SIP register values. Values for the following Wideband SIP components can be displayed:

CPLD—A Complex Programmable Logic Device that contains logic to control resets, the I/O bus, and SPA OIR.

Processor—The Wideband SIP on-board processor that is responsible for configuring the chips on the SIP, communication to the PRE module, and communication with the SPA.

Vanadium—A Cisco-designed ASIC that provides a link between the Wideband SIP and the PRE module.

SPI FPGA—A bus converter that supports up to eight channels on a PL3 interface and up to eight channels shared between the two SPI 4.2 (System Packet Interface Level 4 Phase 2) interfaces. The SPI FPGA also interfaces the on-board processor complex to the Wideband SIP bus.

Examples

The following examples display show controllers jacket output for the cpld and processor keywords:

Router# show controllers jacket 1/0 cpld 

CPLD registers
[A4000000] Version:4
[A4000004] Clock frequency:32
[A4000008] Reset status and control:1
[A400000C] Software reset reason:0
[A4000010] Datapath reset: 19
[A4000014] SPA 0 OIR register: FF
[A4000018] SPA 1 OIR register: FF
[A400001C] SPA OIR interrupt status: (would clear on read)
[A4000020] SPA OIR interrupt mask: FF

Router# show controllers jacket 1/0 processor 

Processor Registers

 Port A:
  Pin Assignment      C00000
  Data Direction      FF437C3A
  Open-Drain          1800F
  Data                A88005
  Special Options     0000
 Port B:
  Pin Assignment      0008
  Data Direction      FFFFBEF
  Open-Drain          0000
  Data                BF0FEFC
  Special Options     0008
 Port C:
  Pin Assignment      3580C
  Data Direction      FF7CA7F3
  Open-Drain          0000
  Data                84D004
  Special Options     0000  
 Port D:
  Pin Assignment      30005
  Data Direction      FFCFFFE
  Open-Drain          30000
  Data                30000
  Special Options     30000

Related Commands

Command
Description

show controllers modular-cable

Displays Wideband SPA information.


show controllers modular-cable

To display Wideband SPA information, use the show controllers modular-cable command in privileged EXEC mode.

show controllers modular-cable slot/subslot/bay {brief | fpga_registers |
{
all | sfp [port port_num] | ge_phy [port port_num] }}

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

brief

(Optional) Displays a brief summary of Wideband SPA controller information.

fpga_registers

(Optional) Displays information on the Wideband SPA FPGA (Blaze) registers.

sfp

(Optional) Displays information on the Wideband SPA small form-factor pluggable (SFP) modules.

ge_phy

(Optional) Displays physical layer (PHY) information on the Wideband SPA Gigabit Ethernet ports.

port port_num

When used with sfp or ge_phy, the information displayed is for the specified Wideband SPA Gigabit Ethernet port. If the port  port_num argument is not used, the information displayed is for both Gigabit Ethernet ports.

all

(Optional) Displays both SFP module and PHY information for the Wideband SPA.


Command Default

If you specify no keyword or argument after slot/subslot/bay, all categories of information for both Gigabit Ethernet ports are displayed.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use the show controllers modular-cable command to display internal state information for the Wideband SPA controller.

The fpga_registers keyword displays FPGA register information for the Wideband SPA FPGA.

The sfp keyword displays SFP module information and hardware details on the SFPs in the specified Wideband SPA port.

The ge_phy keyword displays physical layer and register values for the specified Wideband SPA port.

If you specify all instead of sfp or ge_phy, both SFP module and PHY information are displayed.

Examples

The following examples display show controllers modular-cable output for the fpga_registers, sfp, and ge_phy keywords. In some cases, only part of the output is shown.

Router# show controllers modular-cable 1/0/0 fpga_registers 

REG blz_sw_rev_id offset 0x00000000 = 0x00000000
REG blz_hw_rev_id offset 0x00000004 = 0x04030422
REG rst_ctrl_reg_0 offset 0x00000008 = 0x00000000
REG led_ctrl_reg_0 offset 0x00000010 = 0x00000001
REG gp_config_reg_0 offset 0x00000030 = 0x80000000
REG test_reg offset 0x000000B0 = 0xDEADBEAF
REG adr_trap_reg offset 0x000000B4 = 0x00000040
REG spa_timeout_reg offset 0x000000B8 = 0x000003E8
REG spa_error_reg offset 0x000000BC = 0x0000000A
REG bm_int_stat_reg offset 0x00000100 = 0x00000000
REG sfp_all_int_stat_reg offset 0x00000104 = 0x00000000
REG spa_brd_int_stat_reg offset 0x00000108 = 0x00000203
REG spa_brd_int_en_reg offset 0x00000120 = 0x000000CC
REG spa_brd_int_ovrd_reg offset 0x00000130 = 0x00000000
REG sfp_int_stat_reg_0 offset 0x00000200 = 0x00000000
REG sfp_cfg_stat_reg_0 offset 0x00000204 = 0x00010007
REG sfp_int_stat_reg_1 offset 0x00000208 = 0x00000000
REG sfp_cfg_stat_reg_1 offset 0x0000020C = 0x00010007
REG blz_ctrl_stat_reg offset 0x00000300 = 0x0007FF01
REG dcm_status_reg offset 0x00000304 = 0x00000009          
REG blz_sp_int_stat_reg_0 offset 0x00000310 = 0x00000008
...
Router# show controllers modular-cable 1/0/0 sfp port 1 

SFP in port 1
SFP is present
SFP LOS is not detected
SFP TX FAULT is not detected
SFP TX is enabled

ID: SFP 
        Extended ID: 4
        Connector: LC 
        SONET compliance:  not specified
        Gigabit Ethernet compliance: 1000BASE-SX
        Fibre Channel link length:  not specified
        Fibre Channel transmitter technology:  not specified
        Fibre Channel transmission media:  not specified
        Fibre Channel speed:  not specified
        Encoding: 8B10B  
        Bit Rate: 1300 Mbps
        50 micron-multimode fiber supported length: 550 m
        62.5 micron-multimode fiber supported length: 270 m
        Upper bit rate limit: not specified
        Lower bit rate limit: not specified
        Date code (yy/mm/dd): 05/02/23          
        Vendor name: CISCO-AGILENT   
        Vendor OUI: 12499
        Vendor Part Number (PN): QFBR-5766LP            Vendor Rev:     
        Vendor SN (SN): AGS090855CE     
        Options implemented:
                LOS Signal
                TX Fault Signal
                TX Disable Signal
        Enhanced options implemented: none
        Diagnostic monitoring implemented: none
        Idprom contents (hex):
        0x00:   03 04 07 00 00 00 01 00 00 00 00 01 0D 00 00 00 
        0x10:   37 1B 00 00 43 49 53 43 4F 2D 41 47 49 4C 45 4E 
        0x20:   54 20 20 20 00 00 30 D3 51 46 42 52 2D 35 37 36 
        0x30:   36 4C 50 20 20 20 20 20 20 20 20 20 03 52 00 B5 
        0x40:   00 1A 00 00 41 47 53 30 39 30 38 35 35 43 45 20 
        0x50:   20 20 20 20 30 35 30 32 32 33 20 20 00 00 00 C4 
        0x60:   00 00 06 C9 F0 FA 7C 01 B3 C8 41 6B 39 04 FC 85 
        0x70:   BB 20 9E 00 00 00 00 00 00 00 00 00 B4 94 52 CC 
        0x80:   FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
        0x90:   FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
        State: Initalized          
Phased Initialization
        Phase Reached: 4
        Phase Exit Code: 0
        Phase Read Offset: 0

Socket Verification

Router# show controllers modular-cable 1/0/0 ge_phy port 0 

Gigabit PHY information for port 0:
  PHY Status:
  status (reg 1) = 0x16D
    link is up, auto-negotiation is complete
    remote fault not detected, jabber not detected
  Extended status register (reg 15) = 0xC000
    1000BaseX full duplex capable    1000BaseX half duplex capable 
  phy specific status (reg 17) = 0xAC14
    link is up (real-time), speed/duplex resolved
    speed: 1000 Mbps, duplex: full
    page not received, cable length is < 50m
    MDI cross-over status: MDI, downshift status: no
    energy detect status: sleep
    transmit pause: disabled, receive pause: enabled
    polarity: normal, jabber: no
  phy specific extended status (reg 27) = 0xB487
    Fiber/ copper auto selection disabled, fiber link
    Serial interface auto-negotiation bypass enabled
    Serial interface auto-negotiation bypass status:
      Link came up because regular fiber autoneg completed
    Interrupt polarity is active low
  receive error count: 0x0          


  Auto-negotiation configuration and status:
    Auto-negotiation is enabled and is completed
    Speed/duplex is resolved to 1000 Mbps, full duplex
    Advertised capabilities: 1000BaseX/HD 1000BaseX/FD Pause capable (Asymmetric)
    Partner capabilities: 1000BaseX/FD 
...

Related Commands

Command
Description

show controllers jacket

Displays Wideband SIP register values.


show hw-module bay

To display information about the wideband channels or RF channels on a Wideband SPA, use the show hw-module bay command in privileged EXEC mode.

show hw-module bay {slot/subslot/bay | all} show-type
{wideband-channel | rf-channel} [device-index] [verbose]

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

all

Specifies that the displayed information will be for both bay 1 and bay 0 if Wideband SPAs are installed in both bays.

show-type

The type of information to display. Valid values are association, config, counters, and mapping. See the Usage Guidelines for more information on show types.

{wideband-channel | rf-channel}

Specifies the device to display information for:

wideband-channel—Displays information for the wideband channel indicated by device-index.

rf-channel—Displays information for the RF channel indicated by device-index.

device-index

(Optional) The wideband channel number or RF channel number or BPI index number.

When the wideband-channel keyword is specified, valid values for device-index are 0 to 11.

When the rf-channel keyword is specified, valid values for device-index are 0 to 23 depending on how the Wideband SPA is configured with the annex modulation command.

verbose

(Optional) Used with the config keyword. Shows more configuration information on the wideband channel or RF channel.


Command Default

If you do not specify the verbose keyword, less detailed configuration information is displayed.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.

Usage Guidelines

The type of information that show hw-module bay displays is determined by the value of the show-type argument. Table 0-1 describes the information shown for each show-type. In the table, the Allowed with Keyword column indicates whether the show-type can be used with the keyword wideband-channel or rf-channel.

If device-index is omitted from show hw-module bay, the command displays information for all wideband channels, RF channels, or BPI+ indexes depending on the keywords used. For sample output, see the Examples section.

The association show-type displays wideband-to-narrowband (traditional DOCSIS) channel association information only when the cable interface line card and Wideband SPA are physically present in the CMTS.

Table 11-2 Values for show-type   

show-type
Allowed with Keyword
Description

association

wideband-channel

Displays wideband-to-narrowband (traditional DOCSIS) channel association information. The association of a wideband channel to a traditional DOCSIS downstream channel is made when a primary downstream channel for the fiber node is configured with the downstream cable command.

config

wideband-channel or
rf-channel

Displays wideband channel or RF channel configuration information depending on the keyword specified.

counters

wideband-channel or
rf-channel

Displays wideband channel or RF channel statistics depending on the keyword specified.

mapping

wideband-channel or
rf-channel

Displays mapping of wideband channels to RF channels depending on the keyword specified.


Examples

The following examples display show hw-module bay command output for wideband channel 0 on the Wideband SPA located in slot 1, subslot 0, bay 0:

Router# show hw-module bay 1/0/0 counters wideband-channel 0 

SPA      WB channel   Tx packets              Tx octets
1/0/0    0            29069                   4032392

Router# show hw-module bay 1/0/0 mapping wideband-channel 0 

SPA      WB       RF         BW %
         channel  channel
1/0/0    0        0          100
                  1          100
                  2          100
                  3          100
                  4          100
                  5          100
                  6          100

Router# show hw-module bay 1/0/0 association wideband-channel 0

WB                      BG   Bundle  NB          NB chan  Reserved  Avail
channel                 ID   num     channel     ID       CIR       CIR
Wideband-Cable1/0/0:0   24   123     Cable5/0/1  120      0         0 

In the preceding example, the following information is displayed for each wideband channels when the association keyword is specified.

WB channel—Wideband-cable interface (wideband channel).

BG ID—Bonding Group ID for the wideband channel.

Bundle num—The number of the virtual bundle interface in which the wideband channel is a member.

NB channel—The slot/subslot/port of the primary downstream channel (narrowband channel or traditional DOCSIS channel) for the wideband channel.

NB channel ID—Channel ID for the primary downstream channel.

Reserved CIR—The reserved committed information rate (CIR). Because QoS is currently best effort for wideband traffic, reserved CIR is always 0.

Avail CIR—The part of the CIR that is available. Because QoS is currently best effort for wideband traffic, available CIR is always 0.

The following examples display show hw-module bay command output for wideband channels (0 to 11) on the Wideband SPA located at slot 1, subslot 0, bay 0:

Router# show hw-module bay 1/0/0 counters wideband-channel  

SPA      WB channel   Tx packets        Tx octets
1/0/0    0            395               31590 
1/0/0    1            0                 0 
1/0/0    2            0                 0 
1/0/0    3            0                 0 
1/0/0    4            0                 0 
1/0/0    5            0                 0 
1/0/0    6            0                 0 
1/0/0    7            0                 0 
1/0/0    8            0                 0 
1/0/0    9            0                 0 
1/0/0    10           0                 0 
1/0/0    11           0                 0 

Router# show  hw-module bay 1/0/0 config wideband-channel 
WB                      BG    Bundle  WB Host       Primary 
channel                 ID    num     Slot/Subslot  BG 
Wideband-Cable1/0/0:0   24    123     5/0           Yes 
Wideband-Cable1/0/0:1   25    123     5/0           Yes 
Wideband-Cable1/0/0:2   26    123     5/0           Yes 
Wideband-Cable1/0/0:3   27    123     5/0           Yes 
Wideband-Cable1/0/0:4   28    123     5/0           Yes 
Wideband-Cable1/0/0:5   29    123     5/0           Yes 
Wideband-Cable1/0/0:6   30    123     5/0           Yes 
Wideband-Cable1/0/0:7   31    123     5/0           Yes 
Wideband-Cable1/0/0:8   32    0       5/0           Yes 
Wideband-Cable1/0/0:9   33    0       5/0           Yes 
Wideband-Cable1/0/0:10  34    0       5/0           Yes 
Wideband-Cable1/0/0:11  35    0       5/0           Yes 

In the preceding example, the following information is displayed for each wideband channel when the config keyword is specified.

BG ID—Bonding Group ID.

Bundle num—The number of the virtual bundle interface to which the wideband channel is a member.

WB Host Slot/Subslot—The cable interface line card that has been configured for DOCSIS 3.0 Downstream Channel Bonding operations. See the command modular-host subslot.

Primary BG—Yes indicates that the wideband channel is a primary bonding group (primary wideband channel).

The following examples display show hw-module bay command output for RF channel 0 on the Wideband SPA located in slot 1, subslot 0, bay 0:

Router# show hw-module bay 1/0/0 config rf-channel 0

SPA    RF       Freq       Mod     Annex  IP Address       MAC Address     UDP  
       channel                                                             port
1/0/0  0        699000000  64qam   B      192.168.200.30   0011.920e.a9ff  49152   

In the preceding output, these fields provide information on the edge QAM device that is associated with the RF channel:

IP Address—The IP address of the edge QAM device.

MAC address—The MAC address of the next-hop device or edge QAM device.

UDP port—The UDP port number for the edge QAM that will be used for this RF channel.

Router# show hw-module bay 1/0/0 config rf-channel 0 verbose 

SPA                                 : Wideband-Cable 1/0/0
RF channel number                   : 0
Frequency                           : 699000000 Hz
Modulation                          : 64qam
Annex                               : B
IP address of next hop              : 192.168.200.30
MAC address of EQAM                 : 000c.3033.2cbf
UDP port number                     : 49152
EQAM headroom                       : 0

Router# show hw-module bay 1/0/0 counters rf-channel 0 

SPA      RF channel   MPEG packets tx
1/0/0    0            334815

Router# show hw-module bay 1/0/0 mapping rf-channel 0 

SPA      RF       WB         BW %
         channel  channel
1/0/0    0        0          100

The following example displays show hw-module bay command output for RF channels on the Wideband SPA located at slot 1, subslot 0, bay 0. In the example, the output is for only RF channels 0 to 8 because only those RF channels have been associated with a wideband channel. The BW % column is the percent of the RF channel's bandwidth that is assigned to the wideband channel with the cable rf-channel command.

Router# show hw-module bay 1/0/0 mapping rf-channel  

SPA      RF       WB         BW %
         channel  channel
1/0/0    0        0          100
1/0/0    1        0          100
1/0/0    2        0          100
1/0/0    3        0          100
1/0/0    4        0          100
1/0/0    5        0          100
1/0/0    6        0          100
1/0/0    7        2          100
1/0/0    8        1          100

The following example displays show hw-module bay command output for BPI-Blaze FPGA index content on the Wideband SPA located in slot 1, subslot 0, bay 0. In the example, the output is for BPI+ index number 1.

Related Commands

Command
Description

show hw-module bay oir

Displays the operational status of a Wideband SPA.


show hw-module bay oir

To display the operational status of a Wideband SPA, use the show hw-module bay oir command in privileged EXEC mode.

show hw-module bay {slot/subslot/bay | all} oir [internal]

Syntax Description

slot

The slot where the Wideband SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for the Wideband SIP.

subslot

The subslot where the Wideband SIP resides. On the Cisco uBR10012 router, subslot 0 is always specified.

bay

The bay in the Wideband SIP where the Wideband SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

all

Displays OIR status for all Wideband SPAs in the system.

internal

(Optional) Displays detailed diagnostic information. This option is intended for internal diagnostic use with Cisco Systems technical support personnel.


Command Default

If you do not specify the internal keyword, detailed diagnostic information is not displayed.

Command Modes

Privileged EXEC.

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

Use the show hw-module bay oir command to obtain operational status information about a Wideband SPA. To display information for a specific SPA, specify slot/subslot/bay for the SPA. To display information for all SPAs in the router, use the all keyword.

The optional internal keyword displays detailed diagnostic information that is recommended only for use with Cisco Systems technical support personnel.

Table 0-1 describes the possible values for the Operational Status field in the output.

Table 11-3 Operational Status Field Descriptions 

Operational Status
Description

admin down

SPA is administratively disabled by the hw-module bay shutdown global configuration command.

booting

SPA is initializing.

missing

SPA is not present in the SIP bay.

ok

SPA is operational.

out of service (reason)

The SPA is out of service for one of the following reasons:

Note The following reasons are not applicable to every SPA and can be platform-specific.

Analyze failed—Failed to create a SPA data structure, most likely due to a memory allocation problem.

Authentication failed—SPA has failed hardware validation.

Data structure create error—Failed to create a SPA data structure, most likely due to a memory allocation problem.

Event corrupt—A SPA online insertion and removal (OIR) event has been corrupted. This could be caused by a corrupted message between the SIP and the Route Processor (RP) or some other software or hardware problem.

Event sequence error—A SPA OIR event was received out of sequence. This could be caused by a corrupted message between the SIP and the Route Processor (RP) or some other software or hardware problem.

Fail code not set—Failure code could not be read from a SPA OIR event message. This could be caused by a corrupted message between the SIP and the RP or some other software or hardware problem.

Failed too many times—SPA is disabled because it has failed more than the allowable limit on the platform.

FPD upgrade failed—A field-programmable device, such as the Field-Programmable Gate Array (FPGA), failed to automatically upgrade.

H/W signal deasserted—The SPA_OK or PWR_OK hardware signal indicating that the SPA is accessible is no longer asserted.

Heartbeat failed—Occurs when intelligent SPAs encounter heartbeat failures.

Incompatible FPD—An FPGA version mismatch with the Cisco IOS software has been detected for the SPA.

out of service (reason)

Init timeout—Time limit has been reached during initialization of a SPA.

Read SPA type failed—A read from the hardware for the SPA type failed.

SPA h/w error—The SPA software driver has detected a hardware error.

SPA ready timeout—A timeout occurred on the RP while waiting for the SPA to become operational.

SPA type mismatch—Occurs when you have pre-configured a SPA of one type, but have inserted a SPA of a different type.

SPA unrecognized—SPA is not supported by the Cisco IOS software release.

Start failed—Failed to start interfaces on SPA.

Unexpected inserted event—The SPA OIR software has received a SPA insertion event when the OIR software considered the SPA already present.

Wait h/w ok timeout—A timeout occurred while waiting for the SPA_OK and PWR_OK hardware signals to be asserted.

Wait start timeout—A timeout occurred on the SIP while waiting for permission from the RP to bring up the SPA.


Examples

The following example shows the operational status of a Wideband SPA:

Router# show hw-module bay 1/0/0 oir

Module        Model                Operational Status
------------- -------------------- ------------------------
bay 1/0/0     SPA-24XDS-SFP        ok

The following example shows the operational status of a Wideband SPA when the internal keyword is specified:

Router# show hw-module bay 1/0/0 oir  internal 

WARNING: This command is not intended for production use
and should only be used under the supervision of
Cisco Systems technical support personnel.
sm(spa_oir_tsm bay 1/0/0 TSM), running yes, state ready
Admin Status: admin enabled,  Operational Status: ok(1)
Last reset Reason: audit failure
TSM Context:
    configured_spa_type 0x4AE
    soft remove fail code 0x0(none)
    last_fail_code 0x0(none)
    fail_count 0
    timed_fail_count 0, failed_spa_type 0x0
    recovery_action 0
    associated_fail_code 0x0(none)
    sequence numbers: next from tsm 1, last to tsm 1
    flags 0x0
Subslot:
    spa type 0x4AE, active spa type 0x4AE
    subslot flags 0x0, plugin flags 0x0
TSM Parameters:
    wait_psm_ready_timeout 180000 ms, init_timeout 120000 ms
    short_recovery_delay 5000 ms, long_recovery_delay 120000 ms
    ok_up_time 600000 ms, bad_fail_count 10
    fail_time_period 600000 ms, max_fail_count 5
    supports pre-configuration
sm(spa_oir_audit bay 1/0/1), running yes, state sleep
SPA OIR state machine audit statistics
                In-sync poll-count late-resp resp-fail restarts fail-count
bay 1/0/0           yes       2752         0         4        1          0

Related Commands

Command
Description

show hw-module bay

Displays information about the wideband channels or RF channels on a Wideband SPA.


upstream cable connector

To specify the upstream channel ports for a fiber node, use the upstream cable connector command in cable fiber-node configuration mode. To remove the upstream channel ports for a fiber node, use the no form of this command.

upstream cable slot/subslot connector list-of-ports

no upstream cable slot/subslot connector list-of-ports

Syntax Description

slot/subslot

The location of the cable interface line card containing the upstream port.

list-of-ports

A range of physical port numbers on the cable interface line card. The list-of-ports can be one or more port numbers or a range of port numbers separated by a hyphen or combinations of both. See the Examples section for some samples.

The valid range for port numbers on uBR10-MC5X20 line cards is 0 to 19.


Command Default

No upstream channel is configured for the fiber node.

Command Modes

Cable fiber-node configuration

Command History

Release
Modification

12.3(21)BC

This command was introduced for the uBR10012 router.


Usage Guidelines

This command specifies upstream ports on the cable interface line card (for example, the Cisco uBR10-MC5X20S-D line card) that are connected to a fiber node and that are available as upstream channels.


Note If the upstream ports are physically wired using dense connector configuration, the upstream cable connector command is required as part of the configuration of a fiber node.


Upstream channels on the same fiber node must have unique frequencies assigned. The upstream ports must be ports that are associated with the downstream port specified in the downstream cable command. On a Cisco uBR10-MC5X20 line card, each downstream port is associated with one or more upstream ports.

The no version of this command makes the upstream port no longer available as an upstream channel for the fiber node. If wideband modems on the fiber node are using an upstream channel and that channel is made no longer available with the no upstream cable connector command, the modems will go offline and attempt to re-register.

An upstream channel can be associated with not more than one fiber node. Configuring an upstream channel to a second fiber node causes the upstream channel to be removed from the previous fiber node. It also causes an upstream frequency change if the upstream has a spectrum group configured.

Each time the upstream cable connector command is issued for a fiber node, the set of upstream channels that are available for the fiber node is added to in a cumulative manner. For example, if the following upstream cable connector commands were issued, the set of upstream channels available for fiber node 1 is upstream channels 0 to 2.

Router# configure terminal 
Router(config)# cable fiber-node 1 
Router(config-fiber-node)# upstream cable 5/0 connector 0 
Router(config-fiber-node)# upstream cable 5/0 connector 1-2 

For more information on using this command, refer to Chapter 8, "Configuring the Wideband SPA" in the Cisco uBR10012 Universal Broadband Router SIP and SPA Software Configuration Guide.

Examples

The following example shows how to configure upstream channels for fiber node 1. Notice that the list of port numbers (connectors) can be a single port number, a range of port numbers, or some combination of the two.

Router(config)# cable fiber-node 1 
Router(config-fiber-node)# upstream cable 5/0 connector 0 
Router(config-fiber-node)# upstream cable 5/0 connector 1-2 
Router(config-fiber-node)# upstream cable 6/0 connector 0 1-2 3 
Router(config-fiber-node)# 

Related Commands

Command
Description

cable fiber-node

Enters cable fiber-node configuration mode so that you can configure a fiber node.

description (cable fiber-node)

Specifies a description for a fiber node.

downstream cable

Assigns a primary downstream channel for a fiber node.

downstream modular-cable rf-channel

Specifies the RF channels that are available for wideband channels on a fiber node.