Cable Commands: cable d

cable d31-mode

To enable the DOCSIS 3.1 mode on a MAC domain, use the cable d31-mode command in the interface configuration mode. To disable the DOCSIS 3.1 mode, use the no form of the command.

[ no] cable d31-mode

This command has no keywords or arguments.

Command Default

DOCSIS 3.1 mode is enabled.

Command Modes

Interface configuration—cable interface only (config-if)

MAC domain profile configuration (config-profile-md)

Command History

Release Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Enabling the DOCSIS 3.1 mode has the following effects:

  • MDDs advertise the MAC domain as DOCSIS 3.1 capable.

  • DOCSIS 3.1 protocol support is enabled for the MAC domain, including:

    • v5 Ranging support

    • D3.1 TLV parsing

    • D3.1 MMMs

  • OFDM channels are included in MD-SG calculations assuming that they are a member of an associated fiber node.

  • OFDM channels are allowed to become active primary-capable downstream channels within the MAC domain.

Examples

The following example shows how to enable DOCSIS 3.1 mode:

router#configure terminal 
router(config)#interface c3/0/0 
router(config-if)#cable d31-mode 

cable d40-mode

To enable the DOCSIS 4.0 mode on a MAC domain, use the cable d40-mode command in the interface configuration mode. To disable the DOCSIS 4.0 mode, use the no form of the command.

cable d40-mode

no cable d40-mode

This command has no keywords or arguments.

Command Default

DOCSIS 4.0 mode is enabled.

Command Modes

Interface configuration—cable interface only (config-if)

MAC domain profile configuration (config-profile-md)

Command History

Release Modification

Cisco IOS XE Dublin 17.12.1z

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Enabling the DOCSIS 4.0 mode has the following effects:

  • MDDs advertise the MAC domain as DOCSIS 4.0 capable.

  • DOCSIS 4.0 protocol support is enabled for the MAC domain, including:

    • D4.0 TLV parsing

    • D4.0 MMMs

  • OFDM channels are included in MD-SG calculations assuming that they are a member of an associated fiber node.

  • OFDM channels are allowed to become active primary-capable downstream channels within the MAC domain.

Examples

The following example shows how to enable DOCSIS 4.0 mode:

router#configure terminal 
router(config)#interface c4/0/0 
router(config-if)#cable d40-mode 

cable dci-response

To configure how a cable interface responds to DCI-REQ messages for CMs on that interface, use the cable dci-response command in cable interface configuration mode.

cable dci-response [success | ignore | reject permanent | reject temporary]

Syntax Description

success

(Optional) Configures the interface so that the Cisco CMTS responds to DCI-REQ messages from CMs on the interface by sending a DCI-RSP response with the confirmation code of Success (0).

ignore

(Optional) Configures the interface so that the Cisco CMTS ignores DCI-REQ messages from CMs on the interface. It does not send any DCI-RSP responses.

reject permanent

(Optional) Configures the interface so that the Cisco CMTS responds to DCI-REQ messages from CMs on the interface by sending a DCI-RSP response with the confirmation code of Reject Permanent (4).

reject temporary

(Optional) Configures the interface so that the Cisco CMTS ignores the first four DCI-REQ messages from a CM on the interface, but on the fifth DCI-REQ message, the CMTS responds with a DCI-RSP response with the confirmation code of Reject Temporary (3). The CMTS then continues to ignore the next seven DCI-REQ messages and then restarts this process when it receives the twelfth DCI-REQ message.

Command Default

The Cisco CMTS router responds to DCI-REQ messages from all CMs by sending a DCI-RSP response with the confirmation code of Success (0).

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Description

12.1(4)CX

This command was introduced for DOCSIS 1.1 operation.

12.2(4)BC1

This command was integrated into Cisco IOS Release 12.2(4)BC1.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The Device Class Identification (DCI) messages are part of the Media Access Control Specification section of the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above). A CM can optionally use the DCI-REQ message to inform the CMTS router of certain capabilities, such as whether it is a CPE-controlled cable modem (CCCM).

The CMTS router then responds with one of the following confirmation codes:

  • Success—Allows the CM to continue with the registration process.

  • Reject Permanent—Instructs the CM to cancel its registration process on this downstream channel. The CM must try all other available downstream channels before attempting to register on this downstream channel again.

  • Reject Temporary—Instructs the CM to reset its DCI-REQ counter, to send another DCI-REQ message, and to wait for the DCI-RSP before proceeding with the registration process.


Note


The CMTS router also can respond with an Upstream Transmitter Disable (UP-DIS) message. See the description of the cable dci-upstream-disable command for details.

Examples

The following example shows how to configure the CMTS router so that it ignores all DCI-REQ messages from CMs on the cable interface at slot 6:


Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-response ignore

The following example shows how to configure the CMTS router so that it returns to its default behavior for the cable interface on slot 6, which is to respond to all DCI-REQ messages from CMs by sending a DCI-RSP with a Success confirmation code:


Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-response success

Note


The cable dci-response success command does not appear in a startup or running configuration file, because it is the default configuration for a cable interface.

cable dci-upstream-disable

To configure a cable interface so that it transmits a DOCSIS 1.1 Upstream Transmitter Disable (UP-DIS) message to a particular CM, use the cable dci-upstream-disable command in cable interface configuration mode. To remove that configuration and return to the default configuration, use the no form of this command.

cable dci-upstream-disable mac-address [enable | disable]

no cable dci-upstream-disable mac-address [enable | disable]

Syntax Description

mac-address

Specifies the MAC physical layer address for a particular CM.

enable

(Optional) Enables the UP-DIS message for the particular CM, so that when the CM sends a DCI-REQ message, the CMTS router responds by sending an UP-DIS response.

disable

(Optional) Disables the sending of UP-DIS messages to a particular CM.

Command Default

The Cisco CMTS router does not transmit UP-DIS messages to any CMs.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Description

12.1(4)CX

This command was introduced for DOCSIS 1.1 operation.

12.2(4)BC1

This command was integrated into Cisco IOS Release 12.2(4)BC1.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) allows a CMTS router to transmit an Upstream Transmitter Disable (UP-DIS) message to a CM. If the CM supports the UP-DIS message, it responds by immediately disabling its upstream transmitter circuitry. The CM must be power-cycled before it can begin transmitting on the upstream again.

Examples

The following example shows the cable dci-upstream-disable command being used to enable the UP-DIS message for the CM with the MAC address of 0123.4567.89ab.


Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-upstream-disable 0123.4567.89ab enable
Router(config-if)# exit
Router(config)# exit

cable def-phy-burst

To specify a value for the upstream Maximum Traffic Burst parameter for CMs that do not specify their own value, use the cable def-phy-burst command in controller configuration mode. To reset the maximum burst size to its default, use the no form of this command.

cable def-phy-burst burst-size

no cable def-phy-burst

Syntax Description

burst-size

Specifies the maximum number of bytes that are allowed in a burst. The valid range is 0 to 4096 bytes, with a default of 2000 bytes. A value of 0 specifies that CMs cannot register unless they specify a valid burst size.

Command Default

2000 bytes

Command Modes

Controller configuration—upstream-cable only (config-controller)

Command History

Release Modification

IOS-XE 3.15.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers. This command replaces the cable default-phy-burst command.

Usage Guidelines


Note


The cable def-phy-burst command applies to cable modems that cannot perform fragmentation. The value specified by the cable def-phy-burst command is used to determine the maximum total frame burst size supported for a cable modem request. In contrast, the cable upstream fragment-force command may be used to determine the largest single physical burst a cable modem can transmit, when the cable modem supports fragmentation.

The DOCSIS 1.0 specification allows CMs to register without specifying a maximum upstream burst size, or to register with a value of 0, which means an unlimited burst size. This behavior can interfere with DOCSIS 1.1 networks because excessively large bursts on an upstream will generate unpredictable jitter and delay in voice calls. DOCSIS 1.1 CMs can also cause this problem if they register without enabling fragmentation of packets at the DOCSIS MAC layer.

This command allows you to specify a default burst size for CMs that register without specifying a burst size or that register with a burst size of 0. It also specifies the maximum size of long data grants if a CM specifies a size of 0 (unlimited) in the Upstream Channel Descriptor (UCD) packet. If a CM specifies a long data grant that would exceed the maximum burst size, and the CM is not using DOCSIS concatenation, the DOCSIS scheduler drops the bandwidth request.

To prevent CMs from registering without defining a burst profile, use this command with a burst-size of zero. CMs that do not define a burst profile will not be allowed to register and come online.


Note


Typically, DOCSIS 1.1 CMs set the maximum upstream transmit burst size to the larger value of 1522 bytes and maximum concatenated burst size (which can be a maximum of 4096 bytes).

The default PHY burst parameter interacts with two other parameters that are configured in the DOCSIS configuration file:

  • DOCSIS 1.1 configuration files can also specify a value for the maximum concatenation burst, which has a default of 1522 bytes. If this parameter is greater than the default PHY burst size, the CM can override the default PHY burst when it is using concatenation.
  • DOCSIS 1.0 and 1.1 configuration files can also specify a maximum transmit burst size. In DOCSIS 1.1 configurations, this parameter defaults to 3044 bytes, with a minimum of 1522 bytes. DOCSIS 1.0 configuration files could set this parameter to a value lower than 1522 bytes, depending on what version of the DOCSIS 1.0 specification they support. The CMTS router will enforce the lower limit between the default phy burst and the maximum transmit burst, so you should ensure that all configuration files in your network specify a minimum of 1522 bytes for the maximum transmit burst size.

Examples

The following example shows how to set the default maximum burst size to 1 on a Cisco cBR-8 router:

Router(config)# controller upstream-Cable 3/0/1
Router(config-controller)# cable def-phy-burst 1

cable default-phy-burst

To specify a value for the upstream Maximum Traffic Burst parameter for CMs that do not specify their own value, use the cable default-phy-burst command in cable interface configuration mode. To reset the maximum burst size to its default, use the no form of this command.

cable default-phy-burst burst-size

no cable default-phy-burst

Syntax Description

burst-size

Specifies the maximum number of bytes that are allowed in a burst. The valid range is 0 to 4096 bytes, with a default of 2000 bytes. A value of 0 specifies that CMs cannot register unless they specify a valid burst size.

Command Default

2000 bytes

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

12.2(8)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(15)BC2

The cable upstream fragment-force command is introduced, with considerations to the cable defaut-phy-burst command.

The maximum upstream traffic burst may also be influenced by the new cable upstream fragment-force command for cable modems that are able to perform fragmentation.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was replaced by the cable def-phy-burst command on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines


Note


The cable default-phy-burst command applies to cable modems that cannot perform fragmentation. The value specified by the cable default-phy-burst command is used to determine the maximum total frame burst size supported for a cable modem request. In contrast, the cable upstream fragment-force command may be used to determine the largest single physical burst a cable modem can transmit, when the cable modem supports fragmentation.

The DOCSIS 1.0 specification allows CMs to register without specifying a maximum upstream burst size, or to register with a value of 0, which means an unlimited burst size. This behavior can interfere with DOCSIS 1.1 networks because excessively large bursts on an upstream will generate unpredictable jitter and delay in voice calls. DOCSIS 1.1 CMs can also cause this problem if they register without enabling fragmentation of packets at the DOCSIS MAC layer.

This command allows you to specify a default burst size for CMs that register without specifying a burst size or that register with a burst size of 0. It also specifies the maximum size of long data grants if a CM specifies a size of 0 (unlimited) in the Upstream Channel Descriptor (UCD) packet. If a CM specifies a long data grant that would exceed the maximum burst size, and the CM is not using DOCSIS concatenation, the DOCSIS scheduler drops the bandwidth request.

To prevent CMs from registering without defining a burst profile, use this command with a burst-size of zero. CMs that do not define a burst profile will not be allowed to register and come online.


Note


Typically, DOCSIS 1.1 CMs set the maximum upstream transmit burst size to the larger value of 1522 bytes and maximum concatenated burst size (which can be a maximum of 4096 bytes).

The default PHY burst parameter interacts with two other parameters that are configured in the DOCSIS configuration file:

  • DOCSIS 1.1 configuration files can also specify a value for the maximum concatenation burst, which has a default of 1522 bytes. If this parameter is greater than the default PHY burst size, the CM can override the default PHY burst when it is using concatenation.
  • DOCSIS 1.0 and 1.1 configuration files can also specify a maximum transmit burst size. In DOCSIS 1.1 configurations, this parameter defaults to 3044 bytes, with a minimum of 1522 bytes. DOCSIS 1.0 configuration files could set this parameter to a value lower than 1522 bytes, depending on what version of the DOCSIS 1.0 specification they support. The CMTS router will enforce the lower limit between the default phy burst and the maximum transmit burst, so you should ensure that all configuration files in your network specify a minimum of 1522 bytes for the maximum transmit burst size.

Examples

The following example shows the default maximum burst size to 1522 bytes, which is the minimum size required by the DOCSIS 1.1 specification:


Router(config)# interface cable 5/1
 
Router(config-if)# cable default-phy-burst 1522

The following example shows the default maximum burst size to 0, which means that a CM must specify a valid burst profile before the Cisco CMTS allows it to register and come online:


Router(config)# interface cable 5/1
 
Router(config-if)# cable default-phy-burst 0

The following example shows the default maximum burst size being reset to its default of 2000 bytes:


Router(config)# interface cable 5/1
 
Router(config-if)# no cable default-phy-burst 

cable depi multicast pool

To configure the DEPI multicast pool for downstream virtual splitting, use the cable depi multicast pool command in global configuration mode. To void the DEPI multicast pool configuration, use the no form of this command.

cable depi multicast pool id

no cable depi multicast pool id

Syntax Description

id

Specifies the ID of the DEPI multicast pool.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco IOS XE Everest 16.5.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to configure the DEPI multicast pool.

Examples

The following example shows how to configure the DEPI multicast pool:

Router# configure terminal
Router(config)# cable depi multicast pool 1
Router(config-multicast-pool)# 

cable depi multicast pool redundant include-video-controller

To configure the DEPI multicast pool for downstream virtual splitting, use the cable depi multicast pool id [redundant include-video-controller] command in global configuration mode. To void the DEPI multicast pool configuration, use the no form of this command.

cable depi multicast pool id [ redundant [ include-video-controller ] ]

no cable depi multicast pool id [ redundant [ include-video-controller ] ]

Syntax Description

id

Specifies the ID of the DEPI multicast pool.

redundant

Redundant multicast pool for secondary Linecard Downstream Controller.

redundant include-video-controller

IP assignment for redundant(stand-by) controllers including video controllers if supported by CBR-CCAP-LC-G2-R Linecard.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco IOS XE Bengaluru 17.6.1z

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

  • If you configure cable depi multicast pool 10 redundant, then multicast IPs is assigned only to downstream-cable controllers.

  • If you configure cable depi multicast pool 10 redundant include-video-controller, then multicast IPs are assigned for both downstream-cable and downstream-video controllers CBR-CCAP-LC-G2-R Linecards.

If video controllers are not supported by CBR-CCAP-LC-40G Linecards, then IPs are assigned only to downstream-cable controllers. The total redundant pool is set up by the system and allocates IP addresses for all possible controllers multiplied by the number of interfaces available.

Examples

The following example shows how to configure redundant include-video-controller:

Router# configure terminal
Router(config)# cable depi multicast pool 10
Router(config-multicast-pool)# redundant include-video-controller
Router(config-multicast-pool)# 

Examples

The following example shows the difference between redundant and redundant include-video-controller configurations:

  • If you use the redundant config, then the total controllers = 16 DOCSIS(x interfaces) + 20 OOB.

  • If you use the redundant include-video-controller config, then the total controllers = 16 DOCSIS(x interfaces) + 16 VIDEO(x interfaces) + 20 OOB

Examples

For Example, If Linecard ‘0’ is secondary, then IP is allocated to downstream-cable and downstream-video controllers as shown below:

  • The following allocations are only applicable to CBR-CCAP-LC-40G and CBR-CCAP-LC-G2-R Linecards prior to Cisco IOS XE Bengaluru 17.6.1z:

    • If Linkha is enabled and redundant is configured as 16(x4) + 20 = 84 IPs, then the IPs are assigned to the following controllers:

      Controllers

      Interfaces

      DS0/0/0 to DS0/0/15

      Te0/1/0 and Te0/1/2

      DS0/0/16 to DS0/0/31

      Te0/1/4 and Te0/1/6

    • If Linkha is disabled and redundant is configured as 16(x8) + 20 = 148 IPs, then the IPs are assigned to the following controllers:

      Controllers

      Interfaces

      DS0/0/0 to DS0/0/15

      Te0/1/0, Te0/1/1, Te0/1/2, Te0/1/3

      DS0/0/16 to DS0/0/31

      Te0/1/4, Te0/1/5, Te0/1/6, Te0/1/7

    • If Linkha is enabled and redundant include-video-controller is configured as 16(x4) + 16(x4) + 20 = 148 IPs, then the IPs are assigned to the following controllers:

      Controllers

      Interfaces

      DS0/0/0 to DS0/0/15

      Te0/1/0 and Te0/1/2

      DS0/0/16 to DS0/0/31

      Te0/1/4 and Te0/1/6

      VID0/0/0 to VID0/0/15

      Te0/1/0 and Te0/1/2

      VID0/0/16 to VID0/0/31

      Te0/1/4 and Te0/1/6

    • If Linkha is disabled and redundant include-video-controller is configured as 16(x8) + 16(x8) + 20 = 276 IPs, then the IPs are assigned to the following controllers:

      Controllers

      Interfaces

      DS0/0/0 to DS0/0/15

      Te0/1/0, Te0/1/1, Te0/1/2, Te0/1/3

      DS0/0/16 to DS0/0/31

      Te0/1/4, Te0/1/5, Te0/1/6, Te0/1/7

      VID0/0/0 to VID0/0/15

      Te0/1/0, Te0/1/1, Te0/1/2, Te0/1/3

      VID0/0/16 to VID0/0/31

      Te0/1/4, Te0/1/5, Te0/1/6, Te0/1/7

  • The following allocations are only applicable to CBR-CCAP-LC-G2-R cards for Cisco IOS XE Bengaluru 17.6.1z and later.

    If Linkha is disabled and redundant include-video-controller is configured as 16(x8) + 16(x8) + 20 = 276 IPs, then the IPs are assigned to the following controllers:

    Controllers

    Interfaces

    DS0/0/0 to DS0/0/7

    Te0/1/0, Te0/1/1

    DS0/0/8 to DS0/0/15

    Te0/1/2, Te0/1/3

    DS0/0/16 to DS0/0/23

    Te0/1/4, Te0/1/5

    DS0/0/24 to DS0/0/31

    Te0/1/6, Te0/1/7

    VID0/0/0 to VID0/0/7

    Te0/1/0, Te0/1/1

    VID0/0/8 to VID0/0/15

    Te0/1/2, Te0/1/3

    VID0/0/16 to VID0/0/23

    Te0/1/4, Te0/1/5

    VID0/0/24 to VID0/0/31

    Te0/1/6, Te0/1/7

cable depi multicast statistic monitor

This feature enables you to view statistics for the multicast group assigned by DEPI multicast pool. You can enable this feature using the cable depi multicast statistic monitor command. Use this command for docsis, bcast and ncast video configurations. OOB configuration is not supported. To void the configuration, use the no form of this command.

cable depi multicast statistic monitor

no cable depi multicast statistic monitor

Syntax Description

monitor

Enable monitor multicast DEPI throughput.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco IOS XE Bengaluru 17.6.1z

This command is introduced for the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to view statistics for the multicast group assigned by DEPI multicast pool.

Examples

The following example shows how to configure the cable depi multicast statistic monitor command:

Router# configure terminal
Router(config)# cable depi multicast statistic monitor
Router(config)# 

After configuring the command, you can verify your configuration using the following command:

Examples

Router# show cable depi multicast counter
IP                                             POOL ID pps          bps          IF       Controller
225.225.225.0                                  1       4686         39335848     Te3/1/0  DS3/0/1

cable device

To configure an access list for a cable modem (CM) device or host on the Cisco CMTS router, use the cable device command in privileged EXEC mode. To remove an access group, use the no access-group option of this command.

cable device { {ip-address | mac-address} [no] access-group {access-list | access-name} | [vrf vrf-name] ip-address [no] access-group [access-list | access-name]}

Syntax Description

ip-address

IP address of the CM device or host.

mac-address

MAC address of the CM device or host.

access-group

Enables access-group options. The no form removes access-group specifications.

{access-list | access-name }

Specifies the IP access list (standard or extended), either by access-list number (1 to 199) or by access-list name.

vrf vrf-name

Specifies a virtual routing and forwarding (VRF) instance that is populated with VPN routes.

  • vrf-name —Name of the VRF instance

Command Default

None

Command Modes


Privileged EXEC (#)

Command History

Release

Description

12.1

This command was moved from earlier releases.

12.1(1a)T1

The vrf keyword was added for Multiprotocol Label Switching (MPLS) VPN support.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

For the vrf keyword of this command, only the ip-address option is supported.

An access list can be configured to deny access to any IP address other than the ones previously configured, using the access-list access-list deny any any command. Starting with Cisco IOS Release 12.2(33)SCD, when a CM is added to such an access list on the Cisco uBR7200 series universal broadband routers, the ping fails. If the CM is reset, removed, or powered off, the ping succeeds after the CM comes online. However, the show cable modem access-group command displays that the CM does not belong to the access-group.


Note


The cable device command is not supported on the Cisco uBR10012 universal broadband router.

Note


The vrf keyword is not supported in Cisco IOS Releases 12.0 SC, 12.1 EC, and 12.2 BC.

Examples

The following example shows how to assign an access list to the MAC address of a cable device:


Router# configure terminal
 
Router(config)# cable device 0010.7b6b.77ed acc 1 
Router(config)# exit
 

cable dfo-retry-count

To configure the Downstream Frequency Override (DFO) retry count, use the cable dfo-retry-count command in global configuration mode. To reset the DFO retry count to its default value, use the no form of this command.

cable dfo-retry-count n

no cable dfo-retry-count n

Syntax Description

n

Downstream frequency override retry count. The valid range is from 1 to 100.

Command Default

The DFO retry count is 20 on the Cisco uBR10012 and Cisco uBR7200 series routers.

The DFO retry count is 5 on the Cisco cBR series routers.

Command Modes


Global configuration (config)

Command History

Release

Modification

12.2(33)SCD7

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The Downstream Frequency Override (DFO) feature enables cable modems to register on a specific primary RF channel. Because of RF failure conditions and some cable modem types, the cable modem takes more time to register on a specific primary RF channel. You can configure the DFO retry count to reduce the cable modem registration time using the cable dfo-retry-count command.

Examples

The following example shows how to configure the DFO retry count as 10:


Router# configure terminal
Router(config)# cable dfo-retry-count 10

cable dhcp ipv4 profile

To enter the IPv4 DHCP profile configuration mode, use the cable dhcp ipv4 profile command in global configuration mode. To remove the configured profile, use the no form of this command.

cable dhcp ipv4 profile name

no cable dhcp ipv4 profile name

Syntax Description

name

Specifies the name of the IPv4 DHCP profile.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

IOS XE Fuji 16.8.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to enter the IPv4 DHCP profile configuration mode:


Router# configure terminal
 
Router(config)# cable dhcp ipv4 profile DEVICE1
 
Router(config-dhcpv4-profile)#

cable dhcp-giaddr

To modify the GIADDR field for the DHCPDISCOVER and DHCPREQUEST packets with a relay IP address before they are forwarded to the DHCP server, use the cable dhcp-giaddr command in cable interface or subinterface configuration mode. To set the GIADDR field to its default, use the no form of this command.

cable dhcp-giaddr {policy [strict | host | mta | ps | stb | profile name ] giaddr | primary}

no cable dhcp-giaddr

Syntax Description

policy

Selects the control policy, so that the primary address is used for cable modems and the secondary addresses are used for hosts and other customer premises equipment (CPE) devices. This setting is typically used when the CMs on the interface are configured for routing, so that the CMs and hosts can use IP addresses on different subnets.

strict

(Optional, only when the policy keyword is specified) Selects the GIADDR IP address as the source IP address in the forwarded DHCPOFFER packet.

By default when using the policy option, the Cisco CMTS changes the source IP address in the DHCPOFFER packet to match that of the primary address on the cable interface. Enable the strict option to prevent this behavior, which could interfere with any access lists applied to the CM when the CM is using a different subnet from the primary address space of the cable interface.

host

Specifies the GIADDR for hosts.

mta

Specifies the GIADDR for media terminal adapters (MTA).

ps

Specifies the GIADDR for portal servers (PS).

stb

Specifies the GIADDR for set-top boxes (STB).

profile name

Specifies DHCP profile as control policy.

giaddr

IP addresses of the secondary interface of the bundle interface.

primary

Selects the primary address always to be used for the GIADDR field for both CMs and CPE devices. This option is typically used for the Cisco uBR-MC16E card and Cisco uBR7100E series routers to support EuroDOCSIS operations.

Command Default

None

Command Modes


Interface configuration (config-if)


Subinterface configuration (config-subif)

Command History

Release

Modification

12.0(4)T

This command was introduced.

12.0(6)SC

This command was integrated into Cisco IOS Release 12.0(6)SC.

12.1(2)EC1

This command was integrated into Cisco IOS Release 12.1(2)EC1.

12.1(3a)EC

This command was modified to support subinterfacess.

12.2(15)BC2

This command was modified to include the strict option.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. This command was modified to support the Cisco uBR7225VXR router.

12.2(33)SCD5

This command was modified to support the host , mta , ps , and stb keywords.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

IOS XE Fuji 16.8.1

Thiscommand was modified to add the profile keyword.

Usage Guidelines

You can use this command to modify the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets to provide a relay IP address before packets are forwarded to the DHCP servers. Use this command to set a policy option such that primary addresses are used for CMs and secondary addresses are used for hosts (such as PCs) behind the CMs.

When using multiple secondary subnets, the Cisco CMTS router uses the first secondary IP address as the GIADDR field when forwarding a DHCPDISCOVER request to the DHCP server. If no DHCP server responds with a DHCPOFFER message after three attempts, the Cisco CMTS router uses the next secondary IP address, up to a maximum of 16 secondary addresses.


Note


If you have configured a Cisco CM for routing mode and are also using the cable-modem dhcp-prox nat command on the CM, you must configure the corresponding cable interface on the Cisco CMTS using the cable dhcp-giaddr policy strict ] command.

Caution


You cannot use the strict option with the internal DHCP server that is onboard the Cisco CMTS router, because the strict option requires the use of DHCP relay operation, which is not performed by DHCP termination points such as the internal DHCP server.



Note


For cBR Series Converged Broadband Routers, internal DHCP server is not supported.

Examples

The following example shows how to set the primary address to be used always for GIADDR:


Router# configure terminal
 
Router(config)# interface cable 3/0
 
Router(config-if)# cable dhcp-giaddr primary 

The following example shows how to set the primary address to be used always for GIADDR in the cable subinterface mode:


Router# configure terminal
 
Router(config)# interface cable 6/0.1
 
Router(config-subif)# cable dhcp-giaddr primary

The following example shows how to configure the router so that the primary address is used for CMs and the secondary addresses are used for hosts. In addition, the GIADDR is used as the source IP address in forwarded DHCPOFFER packets.


Router# configure terminal
 
Router(config)# interface cable 5/1/0
 
Router(config-if)# cable dhcp-giaddr policy strict

The following example shows how to configure the router so that the CPE device (in this case, the MTA) uses a specific secondary interface:


Router# configure terminal
Router(config)# interface bundle 25
Router(config-if)# cable dhcp-giaddr mta 172.10.10.1

The following example shows how to specify DHCP profile as control policy:


Router# configure terminal
Router(config)# interface bundle 2
Router(config-if)# cable dhcp-giaddr policy profile DEVICE1 2.2.1.1

cable dhcp-insert

To configure the Cisco CMTS router to insert descriptors into DHCP packets using option 82, use the cable dhcp-insert command in global configuration mode. To remove this configuration, use the no form of this command.

cable dhcp-insert {downstream-description | hostname | service-class | upstream-description}

Syntax Description

downstream-description

Appends received DHCP packets with downstream port descriptors.

hostname

Appends received DHCP packets with router host names.

service-class

Appends received DHCP packets with router service class.

upstream-description

Appends received DHCP packets with upstream port descriptors.

Command Default

This configuration is disabled by default.

Command Modes


Interface configuration (config-if) and bundle interface configuration.

Command History

Release

Modification

12.3(21)BC

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

12.2(33)SCF2

This command was modified. The service-class keyword was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The cable dhcp-insert command is used to configure the following feature:

DHCP, ToD, and TFTP Services for the CMTS Routers

This feature enhances the DHCP security potential and the Cable Duplicate MAC Address Feature on the Cisco CMTS router.

The cable dhcp-insert command specifies which descriptors to append to DHCP packets. The DHCP servers can then detect cable modem clones and extract geographical information.


Note


Multiple types of descriptor strings can be configured as long as the maximum relay information option size is not exceeded.

The Cisco CMTS router can use the DHCP Relay Agent Information option (DHCP option 82) to send particular information about a cable modem, such as its MAC address and the cable interface to which it is connected. If the DHCP server cannot match the information with that belonging to a cable modem in its database, the Cisco CMTS router identifies that the device is a CPE device. This allows the Cisco CMTS router and DHCP server to retain accurate information about which CPE devices are using which cable modems and whether the devices should be allowed network access.

The DHCP Relay Agent can also be used to identify cloned modems or gather geographical information for E911 and other applications. Using the cable dhcp-insert command, configure the Cisco CMTS router to insert downstream, upstream, hostname, or service class descriptors into DHCP packets. A DHCP server can utilize such information to determine service levels available to the host specific to the provisioned subscriber.


Note


To use the service-class option, the service class name specified in the CM configuration file must be configured on the Cisco CMTS. The ip dhcp relay information option-insert command should be configured on the bundle interface to insert the service-class option into the DHCP DISCOVER messages.

Examples

The following example shows how to insert descriptors into DHCP packets. The DHCP server can then use these descriptors to identify cable modem clones and extract geographical information.


Router(dhcp-config)# cable dhcp-insert service-class

cable dhcp-parse option

To enable parsing of Dynamic Host Configuration Protocol (DHCP) options, use the cable dhcp-parse option command in cable interface configuration mode. To disable parsing, use the no form of this command.

cable dhcp-parse option-optnum

no cable dhcp-parse option-optnum

Syntax Description

-optnum

Specifies the DHCP option. Valid values are 43 and 60.

Command Default

The CMTS does not parse the specified DHCP options.

Command Modes


Cable interface configuration (config-if)

Command History

Release

Modification

12.3(21)BC

This command was introduced.

IOS-XE 3.15.OS

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

To determine specific device and system information, configure cable dhcp-parse option-43 command on the CMTS. The CMTS parses option-43 of the CPE DHCP message to determine the device and system information of the CPE.

To determine the CPE device type, configure cable dhcp-parse option-60 command on the CMTS. The CMTS parses option-60 of the CPE DHCP message to determine the device type of the CPE.

Examples

The following example shows DHCP option 43 enabled on the CMTS:


Router(config-if)# cable dhcp-parse option-43
 
Router(config-if)#

cable diaglog

To enable the DOCSIS 3.1 mode on a MAC domain, use the cable d31-mode command in the interface configuration mode. To disable the DOCSIS 3.1 mode, use the no form of the command.

[ no] cable d31-mode

This command has no keywords or arguments.

Command Default

DOCSIS 3.1 mode is enabled.

Command Modes

Interface configuration (config-if)

Command History

Release Modification

Cisco IOS XE Fuji 16.6.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Enabling the DOCSIS 3.1 mode has the following effects:
  • MDDs advertise the MAC domain as DOCSIS 3.1 capable.

  • DOCSIS 3.1 protocol support is enabled for the MAC domain, including:
    • v5 Ranging support

    • D3.1 TLV parsing

    • D3.1 MMMs

  • OFDM channels are included in MD-SG calculations assuming that they are a member of an associated fiber node.

  • OFDM channels are allowed to become active primary-capable downstream channels within the MAC domain.

Examples

The following example shows how to enable DOCSIS 3.1 mode:

router#configure terminal 
router(config)#interface c3/0/0 
router(config-if)#cable d31-mode 

cable diplexer-band-edge

To enable transmitting diplexer band edges in MAC Domain Descriptor (MDD) messages use the cable diplexer-band-edge comand. To disable transmitting diplexer band edges in MAC Domain Descriptor (MDD) messages use the no cable diplexer-band-edge comand.

cable diplexer-band-edge

no cable diplexer-band-edge

This command has no keywords or arguments.

Command Default

Transmitting diplexer band edges in MAC Domain Descriptor (MDD) messages is enabled by default.

Command Modes

Interface configuration—cable interface only (config-if)

MAC domain profile configuration (config-profile-md)

Command History

Release Modification

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following sample shows and example of the cable diplexer-band-edge command.

Router# conf t
Router(config)# cable profile mac-domain MD1
Router(config-profile-md) #cable diplexer-band-edge 
Router(config-profile-md)#end

The following sample shows and example of the no cable diplexer-band-edge command.

Router# conf t
Router(config)# cable profile mac-domain MD1
Router(config-profile-md) #no cable diplexer-band-edge 
Router(config-profile-md)#end

cable diplexer-mdd-override-band-edge

To override diplexer band edge settings in MAC Domain Descriptor (MDD) messages, use the cable diplexer-band-edge comand. You can manually set the values used in MDD TLV 21.

To disable override diplexer band edge settings in MAC Domain Descriptor (MDD) messages, use the no cable diplexer-band-edge comand.

cable diplexer-mdd-override-band-edge { ds_lower frequency-value | ds_upper frequency-value | us_upper frequency-value }

no cable diplexer-mdd-override-band-edge

Syntax Description

ds_lower frequency-value

Configure DS Lower Band Edge. You can configure 108MHz or 258MHz.

ds_upper frequency-value

Configure DS Upper Band Edge. You can configure 1002MHz or 1218MHz.

us_upper frequency-value

Configure DS Upper Band Edge. You can configure 42MHz, 65MHz, 85MHz, 117MHz, 204MHz.

Command Default

override diplexer band edge settings in MAC Domain Descriptor (MDD) messages is disabled by default.

Command Modes

Interface configuration—cable interface only (config-if)

MAC domain profile configuration (config-profile-md)

Command History

Release Modification

Cisco IOS XE Dublin 17.12.1w

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following sample shows an example of the cable diplexer-mdd-override-band-edge command.

Router#configure terminal
Router#(config)#interface Cable1/0/0
Router(config-if)#cable diplexer-mdd-override-band-edge us_upper 204MHz
Router(config-if)#cable diplexer-mdd-override-band-edge ds_lower 258MHz
Router(config-if)#cable diplexer-mdd-override-band-edge ds_upper 1218MHz
Router(config-if)#end

Use the following command to verify the configuration.

Router#show cable mac-domain Cable1/0/0 mdd Integrated-Cable 1/0/0 0 | be Diplexer      
Diplexer Band Edge
        US Upper Band Edge:  4
        DS Lower Band Edge:  1
        DS Upper Band Edge:  0

cable divert-rate-limit

To set Cable-side DRL rate and limit, use the cable divert-rate-limit command in interface configuration mode. To reset the rate and limit to the default values, use the no form of this command.

cable divert-rate-limit rate rate limit limit

no cable divert-rate-limit

Syntax Description

rate

Specifies the divert rate in packets per second. Minimum rate is 1 packet per second. Maximum rate is 65535 packets per second. The default rate is 2000 packets per second.

limit

Specifies the number of packets to be diverted in an initial burst of packets. Minimum limit is 4 packets. Maximum limit is 4194 packets. The default limit is 2000 packets.

Command Default

The default DRL configuration for every physical cable interface is 2000 packets per second and the default limit is 2000 packets.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command was replaced by the platform punt-sbrl subscriber rate command on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Cable-side DRL is configured on the physical cable interface. It cannot be configured on a cable bundle interface.

Examples

The following example shows how to configure the rate and limit values for a cable interface.:


Router(config-if)# cable divert-rate-limit rate 1 limit 4

cable docsis30-voice downstream req-attr-mask

To configure downstream DOCSIS 3.0 QoS parameters of the required attribute-mask and forbidden attribute-mask number for all DS voice flows, use the cable docsis30-voice downstream req-attr-mask command in global configuration mode. To disable the required attribute-mask and forbidden attribute-mask number, use the no form of this command.

cable docsis30-voice downstream req-attr-mask req-attr-mask forb-attr-mask forb-attr-mask

no cable docsis30-voice

Syntax Description

req-attr-mask

Specifies the required attribute-mask value.

Example: 0

It can also include HEX format.

Example:

cable docsis30-voice downstream req-attr-mask FF for-attr-mask 8000AAbb

forb-attr-mask

Specifies the forbidden attribute-mask value.

Example: 80000000

Command Default

The value of required attribute-mask and forbidden attribute-mask number is 0. Use the no form of this command to return to default. It will set the values for required attribute-mask and forbidden attribute-mask number to 0.

Command Modes


Global configuration (config)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command is used to configure DOCSIS 3.0 voice-related downstream service-flow attribute-mask number.

Examples

The following example shows how to configure the downstream attribute mask for the interface cable:


Router# configure terminal
 
Enter configuration commands, one per line. End with CNTL/Z. 
Router(config)# cable docsis30-voice downstream req-attr-mask ?
 
<0-FFFFFFFF> The attribute bitmap in hex 
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 ? 
forb-attr-mask SF Forbidden Attribute Mask 
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 forb-attr-mask ?
 
<0-FFFFFFFF> The attribute bitmap in hex 
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 forb-attr-mask bbcc
 
Router(config)# do show run | include docsis30 
cable docsis30-voice downstream req-attr-mask AA00 forb-attr-mask BBCC
 
Router(config)# no cable docsis30-voice down
 
Router(config)# no cable docsis30-voice
 
Router(config)# do show run | include docsis30
 

cable docsis-ver

To report the CMTS-supported DOCSIS version to the DHCP server, use the cable docsis-ver command in global configuration mode. To report the default DOCSIS verison to the DHCP server, use the no form of the command.

cable docsis-ver [ major version | minor version]

no cable docsis-ver [ major version | minor version]

Syntax Description

major version

Specifies the major DOCSIS version.

minor version

Specifies the minor DOCSIS version.

Command Default

The default value of the command is cable docsis-ver 3 1

Command Modes


Global configuration (config)

Command History

Release

Modification

IOS-XE 16.7.1

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

cable dot1q-vc-map

To map a cable modem to a particular Virtual Local Area Network (VLAN) on a local outbound Ethernet interface, use the cable dot1q-vc-map command in global configuration mode. To remove this mapping, or to remove a particular customer’s name from the internal tables, use the no form of this command.

cable dot1q-vc-map mac-address ethernet-interface vlan-id {cust-name}

cable dot1q-vc-map mac-address ethernet-interface backup-interface ethernet-interface vlan-id {cust-name}

no cable dot1q-vc-map mac-address ethernet-interface backup-interface ethernet-interface vlan-id {cust-name}

no cable dot1q-vc-map mac-address

no cable dot1q-vc-map customer cust-name

Syntax Description

mac-address

Hardware (MAC) address for the cable modem whose traffic is to be mapped.

ethernet-interface

Outbound interface to which this cable modem should be mapped.

On the Cisco uBR7100 series and Cisco uBR7246VXR routers, you can specify an Ethernet, Fast Ethernet, or Gigabit Ethernet interface, depending on what interfaces are actually installed in the chassis.

On the Cisco cBR series routers, you can specify the Gigabit Ethernet 0 interface or a Ten Gigabit Ethernet interface.

vlan-id

ID for the IEEE 802.1Q Virtual Local Area Network (VLAN) that should be used to tag the frames for this cable modem. The range is 1 to 4095, with no default on the Cisco uBR7100 series and Cisco uBR7246VXR routers. The range is 2 to 4095 on the Cisco cBR series routers.

Note

 
The switches acting as the bridge aggregators might support a lower number of VLAN IDs. If so, the Cisco CMTS router should be configured within the limits of the switches’ maximum number of VLANs.

cust-name

(Optional) Identifies the customer using this VLAN. The cust-name can be any arbitrary alphanumeric string, up to 127 characters long.

customer cust-name

(Optional) Deletes all VCs belong to this customer. The cust-name can be any arbitrary alphanumeric string, up to 127 characters long.

backup-interface ethernet-interface

Specifies the backup WAN interface.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

12.2(15)BC2

This command was introduced for Cisco uBR7246VXR universal broadband routers.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

12.2(33)SCJ

This command was modified. The backup-interface keyword was added.

IOS-XE 3.18.0S

This command was modified. The backup-interface keyword was added.

Usage Guidelines

This command maps a cable modem, on the basis of its hardware (MAC) address, to a particular IEEE 802.1Q VLAN on a particular outbound Ethernet interface. This enables the cable modem’s traffic to be part of a virtual LAN at the Layer-2 level.


Note


To use this command, you must first enable the use of IEEE 802.1Q Layer 2 tunnels, using the cable l2-vpn-service dot1q command. Then use this command to map individual cable modems to specific VLANs.

Examples

The following example shows how to enable the use of Layer 2 tunnels and then map specific CMs to VLANs on a specific interface on a Cisco uBR7246VXR router:


Router# configure terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4
Router(config)# cable dot1q-vc-map 0010.7bed.9c95 GigabitEthernet 1/0 5
Router(config)# exit

The following example shows the same command as above on a Cisco uBR7246VXR router, but this time each VLAN is identified by the customer that is using it:


Router# configure terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4 ENTERPRISE-CO1 
Router(config)# cable dot1q-vc-map 0010.7bed.9c95 GigabitEthernet 1/0 5 ENTERPRISE-CO2 
Router(config)# exit

The following example shows how to remove the Layer 2 mapping for a specific cable modem on a Cisco uBR7246VXR router. This particular cable modem’s traffic is then routed using the normal Layer 3 routing processes.


Router# config terminal
Router(config)# no cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4
Router(config)# exit
 

The following example shows how to enable the use of Layer 2 tunnels and then map specific CMs to VLANs on a specific interface on a Cisco cBR-8 router:


Router# configure terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 0 2
Router(config)# cable dot1q-vc-map 0010.7bed.9c95 TenGigabitEthernet 4/1/0 5
Router(config)# exit

The following example shows how to configure a backup WAN interface on DOT1Q L2VPN on a Cisco cBR-8 router:


Router# configure terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 0025.2eab.8482 Te4/0/1 backup-interface Te4/0/7 207 Topgun 

cable dot1q-vc-map port-channel

To configure the port-channel uplink port for TLS L2VPN, use the cable dot1q-vc-map port-channel command in global configuration mode.

cable dot1q-vc-map mac address port-channel number vlan id custom name

Syntax Description

mac address

MAC address of the cable modem.

number

Port-channel interface number.

vlan id

IEEE 802.1Q VLAN ID.

custom name

Name of the customer.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release Modification

IOS-XE 3.18.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The cable dot1q-vc-map port-channel command configures the port-channel uplink port for TLS L2VPN.

Examples

The following example shows how to configure the port-channel uplink port for TLS L2VPN:

router# configure terminal 
router(config)#cable l2-vpn-service xconnect nsi dot1q 
router(config)#cable dot1q-vc-map c8fb.26a5.551c port-channel 64 1200 topgun 

cable downstream annex

To set the Moving Picture Experts Group (MPEG) framing format for a downstream port on a cable interface line card to either Annex A (Europe) or Annex B (North America), use the cable downstream annex command in cable interface configuration mode.

cable downstream annex {A | B}

Syntax Description

A

Annex A. The downstream uses the EuroDOCSIS J.112 standard.

B

Annex B. The DOCSIS-compliant cable plants that support North American channel plans use ITU J.83 Annex B downstream radio frequency.

Command Default

Annex B for all Cisco cable interface cards other than the Cisco uBR-MC16E. Annex A, if using the Cisco uBR-MC16E cable interface line card and the Cisco uBR7111E and Cisco uBR7114E universal broadband routers.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

12.1(1a)T1

This command was introduced.

12.0(7)T, 12.1(1a)T1, 12.1 mainline, 12.0(8)SC, 12.1(2)EC1

Support for Annex A was introduced for the Cisco uBR-MC16E cable interface line card.

12.1(7)EC

Support for Annex A was added for the Cisco uBR7111E and Cisco uBR7114E universal broadband routers.

12.2(15)CX

Support was added for both Annex A and Annex B on the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable interface line cards.

12.2(15)BC2

Support was added for both Annex A and Annex B on the Cisco uBR-MC5X20U/S cable interface line cards.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

The MPEG framing format must be compatible with the downstream symbol rate you set. Annex B is the North America (DOCSIS) standard and Annex A is the European (EuroDOCSIS) standard. You should review your local standards and specifications for downstream MPEG framing to determine which format you should use.

The Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20U cable interface line cards support both Annex A and Annex B operation. However, on the Cisco uBR-MC28U/X, both downstreams must be configured for the same mode (either both Annex A or both Annex B).

On the Cisco uBR-MC16U and Cisco uBR-MC28U (with integrated upconverter), the IF frequency is fixed at 44 MHz for both Annex A and Annex B modes of operation. On the Cisco uBR-MC16X and Cisco uBR-MC28X (without integrated upconverter), the IF frequency is set to 36.125 MHz in Annex A mode and 44 MHz in Annex B mode.


Note


This command can be used to change the symbol rate, alpha, and other parameters for compliance with EuroDOCSIS (annex A), or DOCSIS (annex B). Annex A is not supported on the Cisco uBR-MC1xC, Cisco uBR-MC16B, Cisco uBR-MC16S, and Cisco uBR-MC28C cable interface line cards. Annex B is not supported on the Cisco uBR-MC16E card and on the Cisco uBR7111E and Cisco uBR7114E universal broadband routers.

Note


The cable interface line card downstream ports and the CMs on the HFC network connected through these ports must be set to the same MPEG framing format.

Caution


In Cisco IOS Release 12.1, only Annex B MPEG framing format is supported.



Tip


Changing the MPEG framing format affects the PHY layer on the downstream and disconnects all online CMs. For this reason, if you are using N+1 HCCP redundancy, you should configure this command on both the Protect and Working interfaces, so that the PHY layer is properly configured before a switchover occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also applies to the cable downstream modulation and cable downstream interleave-depth commands.)


Examples

The following example shows how to set the MPEG framing format to Annex A:


Router# configure terminal
Router(config)# interface cable 1/0
Router(config-if)# cable downstream annex A 

The following example shows how to set the MPEG framing format to Annex B:


Router# configure terminal
Router(config)# interface cable 4/0
Router(config-if)# cable downstream annex B

cable downstream attribute-mask

To configure an attribute for a cable interface or a wideband cable interface, use the cable downstream attribute-mask command in interface configuration mode or MAC domain profile configuration mode. To disable this configuration, use the no form of this command.

cable downstream attribute-mask mask

no cable downstream attribute-mask mask

Syntax Description

mask

Specifies the mask value for the interface.

Command Default

If this command is not used, the default attribute is used for the cable interface and the wideband cable interface. The default attribute is 0x80000000 (31-bit) for the wideband cable interface and zero for the cable interface. For a wideband cable interface, 31-bit mask is always set to 1.

Command Modes


Interface configuration (config-if)


MAC domain profile configuration (config-profile-md)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

IOS XE Fuji 16.7.1

This command was modified to support MAC domain profile configuration on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The attribute-mask comprises 32 attributes and each attribute represents a single bit in the mask. You can configure a provisioned attribute mask for each channel and provisioned bonding group to assign values to the operator-defined binary attributes, or to override the default values of the specification-defined attributes. The operator may configure, in the CM configuration file, a required attribute mask and a forbidden attribute mask for a service flow. Additionally, in a CM-initiated dynamic service request, the CM can include a required attribute mask and a forbidden attribute mask for a service flow.

Examples

The following example shows how to configure an attribute for a wideband cable interface:


Router# configure terminal
Router(config)# interface wideband-cable 1/0/0:0
Router(config-if)# cable downstream attribute-mask 800000ff

cable downstream channel-id

To configure the downstream channel ID, use the cable downstream channel-id command in cable interface configuration mode. To set the downstream channel ID to its default value, use the no form of this command.

cable downstream channel-id id

no cable downstream channel-id

Syntax Description

id

Specifies a downstream channel ID. Valid values for releases prior to Cisco IOS Release 12.2(33)SCB are from 0 to 255 and the valid values for Cisco IOS Release 12.2(33)SCB and later are from 1 to 255 as 0 is reserved for network management.

Command Default

The unit number of the downstream device, starting with a value of 1.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

12.0(5)T

This command was introduced.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

12.2(33)SCB1

The downstream channel ID scheme was changed.

IOS-XE 3.15.0S

This command was replaced by thedocsis-channel-id command on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Use this command to ensure that each downstream channel has a unique ID when there are multiple Cisco CMTS routers at a headend facility.

Cisco IOS assigns the default ID number of each downstream channel in the order in which devices connected to the downstream channels appear to the CMTS router. The downstream channel connected to the first device that appears to the CMTS router is configured with a default ID of 1, the downstream channel connected to the second device that appears is configured with an ID of 2, and so on.

The local downstream channel channel ID is unique across all SPA channels. When you add a channel to the MAC domain using the downstream modular-cable rf-channel command, the channel IDs in the MAC domain are unique. This also facilitates channel ID uniqueness when the channels are added to a fiber node.

The following applies to rf-channel rf-port cable downstream channel-id channel-id command also.

Table 1. Downstream Channel ID Scheme for 12.2(33)SCB1

8/1

8/0

7/1

7/0

6/1

6/0

5/1

5/0

slot 3

slot 1

SPA Bay 0

217-240

193-216

SPA Bay 1

217-240

193-216

SPA Bay 2

217-240

193-216

SPA Bay 3

217-240

193-216

5x20 DS /0

169

145

121

97

73

49

25

1

5x20 DS /1

173

149

125

101

77

53

29

5

5x20 DS /2

177

153

129

105

81

57

33

9

5x20 DS /3

181

157

133

109

85

61

37

13

5x20 DS /4

185

161

137

113

89

65

41

17

Table 2. Downstream Channel ID Scheme for 12.3(23)BCx

8/1

8/0

7/1

7/0

6/1

6/0

5/1

5/0

slot 3

slot 1

SPA Bay 0

24-47

24-47

SPA Bay 1

48-71

48-71

5x20

188-192

180-184

168-172

160-164

148-152

140-144

128-132

120-124


Caution


Changing the downstream channel ID of an active channel automatically disconnects all connected CMs and forces them to go offline and reregister with the CMTS router, as required by the DOCSIS specifications.


Examples

The following example shows how to configure the downstream channel on the cable interface line card in slot 6 of a Cisco CMTS router with a channel ID of 44:


Router(config-if)# cable downstream channel-id 44

The following example shows how to restore the downstream channel ID configuration to the default configuration:


Router(config-if)# cable downstream channel-id

cable downstream-channel-id automatic

To automatically configure the downstream channel IDs, use the cable downstream-channel-id automatic command in global configuration mode. To set the downstream channel ID (DCID) to its default value, use the no form of this command.

cable downstream-channel-id automatic

no cable downstream-channel-id automatic

Syntax Description

automatic

Specifies an automatic assignment of the DCIDs by the Cisco CMTS.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

12.2(33)SCE

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Use this command to automatically assign unique channel IDs for all downstream channels in a fiber node. Automatic DCIDs are not assigned to downstreams that are not in any fiber node.

Examples

This example shows how to automatically configure the downstream channel IDs:


Router(config)# cable downstream-channel-id automatic

cable downstream controller-profile

To configure the downstream controller profile, use the cable downstream controller-profile command in global configuration mode. To void the downstream controller profile configuration, use the no form of this command.

cable downstream controller-profile id[ RPHY| I-CMTS]

no cable downstream controller-profile id

Syntax Description

Syntax Description

id

Specifies the downstream controller profile ID.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

Cisco IOS XE Everest 16.5.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Cisco IOS XE Fuji 16.7.1

This command was modified on the Cisco cBR Series Converged Broadband Routers. Keywords RPHY and I-CMTS were added.

Usage Guidelines

Use this command to configure the downstream controller profile.

When configuring a new i-CMTS controller profile, keyword I-CMTS is needed. If user input RPHY or do not input any keyword, the system will consider it as a RPHY controller profile.

Examples

The following example shows how to enter the downstream controller profile configuration mode:


Router# configure terminal
Router(config)# cable downstream controller-profile 1 I-CMTS
Router(config-controller-profile)#

cable downstream description

To specify a description for a downstream port, use the cable downstream description description command.

cable downstream description description

Syntax Description

description

Specifies a description that is up to 80 characters describing the downstream port.

Command Default

By default, no description is configured.

Command Modes

cable interface (config-if)

MAC domain profile configuration (config-profile-md)

Command History

Release Modification

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Examples

The following sample shows and example of the cable downstream description command.

Router# conf t
Router(config)# cable profile mac-domain MD1
Router(config-profile-md) # cable downstream description DS 
Router(config-profile-md) # no cable downstream description
Router(config-profile-md)#end

cable downstream dsg

Supports Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) configuration under MAC domain interface on a Cisco CMTS router with an OPS MD-profile. The method of configuring A-DSG by OPS MD-profile now is in addition to the existing method of using legacy CLI to configure DSG TG.

cable downstream dsg [channel list DSG Channel List Setting | dcd-enable Enable DSG DCD messages when no enabled rules/tunnels | tg DSG Tunnel group | timer DSG Timer Setting | vendor-param DSG vendor specific parameters]

chan-list

(Optional) Specifies the downstream Channel List Setting. The valid range is from 1 to 65535.

dcd-enable

(Optional) Enables the DSG DCD messages when no enabled rules/tunnels are enabled.

tg

(Optional) Specifies the DSG Tunnel group.

timer

(Optional) Specifies the DSG Timer Setting.

vendor-param

(Optional) Sepecifies the DSG vendor-specific parameters group ID.

The following example shows how the show cable downstream dsg command is used:

router# show cable downstream dsg tg
TG    Chan  TG             Rule Vendor   UCID   Service-group  Profile
id    id   state  I/F      pri  Param    list   Profile        chan state
-----    -----   ----- -------     ----    ------    --------------- --------------       
2000   1    en    C1/0/0   0                       SG1           en       
4500   1    en    C1/0/0   2       2       1 2     SG1           dis       
4500   2    en             0                       --            --   

cable downstream dsg chan-list

To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) channel list entry to a downstream channel and include it in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router, use the cable downstream dsg chan-list command in interface configuration mode. To remove the configuration, use the no form of this command.

cable downstream dsg chan-list list-index

no cable downstream dsg chan-list list-index

Syntax Description

list-index

Alphanumeric list index identifier.

Command Default

Channel lists are not defined by default.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(13a)BC

This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 series routers.

12.2SB

This command was integrated into Cisco IOS Release 12.2SB. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Global configuration for A-DSG must be complete before configuring interface definitions.

Examples

The following example shows configuration of inclusion of DSG channel list entries in DCD messages on a downstream cable interface on a Cisco CMTS router:


interface Cable6/0
 cable downstream dsg chan-list 2

Examples


Router# configure terminal
Router(config)#interface cable 1/0/0
Router(config-if)#cable downstream dsg chan-list 1

cable downstream dsg dcd-enable

To enable Downstream Channel Descriptor (DCD) messages to be sent on a downstream channel on a Cisco CMTS router, use the cable downstream dsg dcd-enable command in interface configuration mode. To disable DCD messages, use the no form of this command.

cable downstream dsg dcd-enable

no cable downstream dsg dcd-enable

Syntax Description

This command has no arguments or keywords.

Command Default

DCD messages are disabled.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(13a)BC

This command was introduced to support A-DSG 1.1 on the Cisc uBR10012 router and Cisco uBR7200 series routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Global configuration for Advanced-mode DOCSIS Set-top Gateway (A-DSG) must be complete before configuring interface definitions. This command is used when there are no enabled rules or tunnels for A-DSG on a Cisco CMTS router.

Examples

The following example shows how to enable DCD messages on a downstream interface on a Cisco CMTS router along with several other A-DSG interface configuration commands:


interface Cable6/0
 cable downstream dsg dcd-enable
 cable downstream dsg chan-list 2
 cable downstream dsg timer 3
 cable downstream dsg vendor-param 2
 cable downstream dsg rule 1 priority 1 clients 1 tunnel 1
 cable downstream dsg rule 1 vendor-param 1
 cable downstream dsg rule 1 classifiers 1 5
 cable downstream dsg rule 2 priority 1 clients 2 tunnel 2

cable downstream dsg disable

To exclude the primary capable interface from DOCSIS Set-Top Gateway DSG forwarding, use the cable downstream dsg disable command in cable interface configuration mode. To remove the configuration, use the no form of this command.

cable downstream dsg disable

no cable downstream dsg disable

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.2(33)SCG

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The cable downstream dsg disable command is associated with the Advanced Mode DOCSIS Set-Top Gateway 1.2 for the Cisco CMTS Routers feature.

When DSG is enabled on the MAC domain interface and DSG forwarding is disabled on the primary capable interface, the Cisco CMTS router does not create multicast service flows on the primary capable interface.

If DSG forwarding is already enabled on the primary capable interface, the Cisco CMTS router removes multicast service flows from the interface.

Examples

The following example shows how to disable A-DSG forwarding on a primary capable modular interface on the Cisco CMTS router:


Router# configure terminal
Router(config)# interface modular-cable 1/0/0:0
Router(config-if)# cable downstream dsg disable
Router(config-if)# end

cable downstream dsg rule


Note


Effective with Cisco IOS Release 12.3(17a)BC2, the cable downstream dsg rule command is removed from Cisco IOS software.

To define and associate an Advanced-mode DOCSIS Set-top Gateway (A-DSG) rule to the downstream channel on a Cisco CMTS router, use the cable downstream dsg rule command in interface configuration mode. To remove the DSG rule configuration, use the no form of this command.

cable downstream dsg rule rule-id [clients clnt-list-id tunnel tun-id | priority priority | vendor-param vsif-grp-id | ucid ucid1 | [ucid1 ucid2 . . . ucidn] | cfr cfr-index [cfr-index . . . ] | disable]

no cable downstream dsg rule rule-id [clients clnt-list-id tunnel tun-id | priority priority | vendor-param vsif-grp-id | ucid ucid1 | [ucid1 ucid2 . . . ucidn] | cfr cfr-index [cfr-index . . . ] | disable]

Syntax Description

rule-id

Defines the DSG rule identifier.

clients clnt-list-id

Sets the DSG clients and associates the clients with the channel list identifier for this DSG rule.

tunnel tun-id

Sets the DSG tunnel to be associated with this rule, and defines the DSG tunnel identifier.

priority priority

Sets the priority of the DSG rule.

vendor-param vsif-grp-id

Associates DSG vendor-specific parameters with the specified DSG rule.

ucid ucid1 | [ucid1 ucid2 ...ucidn ]

Sets the upstream channel identifider for the DSG rule.

cfr cfr-index [cfr-index ...]

Sets the index for the classifier value associated with the DSG rule.

disable

Disables a DSG rule.

Command Default

DSG rules are disabled by default when they are created.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(13a)BC

This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 router and Cisco uBR7200 series routers.

12.3(17a)BC2

This command was removed.

IOS-XE 3.15.OS

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Global configuration for A-DSG must be complete before configuring interface definitions.

Because rules are disabled when they are created, you must enable the configuration using the no cable downstream dsg rule disable command. To disable a DSG rule configuration, use the cable downstream dsg rule disable command.

You can associate DSG clients, vendor specific parameters, classifiers, DSG tunnel address, upstream channel identifier range, and rule priority to a downstream channel. You can apply more than one rule to a downstream channel. All configured rules that are enabled are included in the Downstream Channel Descriptor (DCD) message.

Examples

The following example shows configuration and association of DSG rules on a downstream cable interface on a Cisco CMTS router, followed by an example of enabling the configured DSG rules:


interface Cable6/0
 cable downstream dsg rule 1 clients 1 tunnel 1
 cable downstream dsg rule 1 priority 1 
 cable downstream dsg rule 1 vendor-param 1
 cable downstream dsg rule 1 classifiers 1 5
 cable downstream dsg rule 2 clients 2 tunnel 2
 cable downstream dsg rule 2 priority 1
!
! Enable the DSG rule configuration
!
 no cable downstream dsg rule 1 disable
 no cable downstream dsg rule 2 disable

The following example shows how to disable DSG rules that were previously enabled:


interface cable6/0
 cable downstream dsg rule 1 disable
 cable downstream dsg rule 2 disable

cable downstream dsg tg

To associate an Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) tunnel group to a MAC domain interface on a Cisco CMTS router, use the cable downstream dsg tg command in cable interface configuration mode. To remove this association, use the no form of this command.

cable downstream dsg tg tgid [channel channel_ID | priority DSG-rule-priority [enable | disable] | ucid ID1 [ID2 ID3 ID4] | vendor-param vendor-group-ID]

no cable downstream dsg tg tgid

Syntax Description

dsg tg tgid

Specifies the DSG tunnel group ID. The valid range is from 1 to 65535.

channel channel_ID

(Optional) Specifies the downstream channel ID. The valid range is from 1 to 65535.

priority DSG-rule-priority

(Optional) Specifies the DSG rule priority for the cable interface. The valid range is from 0 to 255.

enable

(Optional) Enables the DSG rule priority on a DSG tunnel group.

disable

(Optional) Disables the DSG rule priority on a DSG tunnel group.

ucid upstream-channel-ID

(Optional) Specifies the upstream channel ID (UCID). You can specify a maximum of four upstream channel IDs.

Cisco cBR-8 router—The valid range is 0 to 8.

vendor-param vendor-group-ID

(Optional) Specifies the vendor specific parameters group ID. The valid range is from 1 to 65535.

Command Default

The DSG traffic is not forwarded to the MAC domain.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.2(33)SCG

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

The cable downstream dsg tg command is used to configure the Advanced Mode DOCSIS Set-Top Gateway 1.2 for the Cisco CMTS Routers feature.

If you do not specify a downstream channel ID using the channel keyword, the Cisco CMTS router automatically assigns a free channel to associate the MAC domain interface with the DSG tunnel group. This channel is created with default parameters.

If you specify the channel keyword in the no form of the command, only the MAC domain to DSG tunnel group association is removed from the configuration. If the no form of the command is used without the channel keyword, both the tunnel group association and the channel are removed.

Examples

The following example shows how to associate an A-DSG tunnel group to a MAC domain interface:


Router(config)# interface cable 5/1/0
Router(config-if)# cable downstream dsg tg 1
Router(config-if)# cable downstream dsg tg 1 channel 22
Router(config-if)# cable downstream dsg tg 1 priority 2 enable
Router(config-if)# cable downstream dsg tg 1 ucid 1 2 3 4
Router(config-if)# cable downstream dsg tg 1 vendor-param 20

Examples

This example shows how to associate an A-DSG tunnel group to a MAC domain interface on a Cisco cBR-8 router:

Router(config)# interface cable 1/0/0
Router(config-if)# cable downstream dsg tg 1
Router(config-if)# cable downstream dsg tg 1 channel 2
Router(config-if)# cable downstream dsg tg 1 priority 0 enable
Router(config-if)# cable downstream dsg tg 1 ucid 1 2 3 4
Router(config-if)# cable downstream dsg tg 1 vendor-param 20

cable downstream dsg tg channel

To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) tunnel group to a downstream interface on a Cisco CMTS router, use the cable downstream dsg tg channel command in interface configuration mode. To remove this configuration, use the no form of this command.

cable downstream dsg tg group-id channel channel-id

no cable downstream dsg tg group-id channel channel-id

Syntax Description

group-id

Specifies the A-DSG tunnel group identifier as a number from 1 to 65535.

channel-id

Specifies the downstream channel identifier as a number from 1 to 65535.

Command Default

The A-DSG tunnel group is not associated to a downstream interface.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(17a)BC2

This command was introduced to support A-DSG 1.2 on the Cisco uBR10012 router and Cisco uBR7200 series routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Thecable dsg tg channel global configuration command establishes the configuration of tunnels in a tunnel group. Tunnel groups are enabled by default.

Then, you can associate the tunnel group to a downstream cable interface using the cable downstream dsg tg channel interface configuration command.

Examples

The following example shows the configuration and activation of a tunnel group with ID of 1 and channel ID of 2 in global configuration, followed by association of the tunnel group to a downstream interface on a Cisco CMTS router:


cable dsg tg 1 channel 2
interface cable 8/1/2
 cable downstream dsg tg 1 channel 2

Examples

This example shows the configuration and activation of a tunnel group with ID of 1 and channel ID of 1in global configuration, followed by association of the tunnel group to a downstream interface on a Cisco cBR-8 router:


cable dsg tg 1 channel 1
interface cable 1/0/0
 cable downstream dsg tg 1 channel 1

cable downstream dsg timer

To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) timer entry to a downstream channel and include it in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router, use the cable downstream dsg timer command in interface configuration mode. To remove this setting, use the no form of this command.

cable downstream dsg timer timer-index

no cable downstream dsg timer timer-index

Syntax Description

timer-index

Identifier for the DSG timer setting in the index.

Command Default

The downstream DSG timer is not configured by default.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(13a)BC

This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 router and Cisco uBR7200 series routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Global configuration for A-DSG must be complete before configuring interface definitions.

Examples

The following example shows the configuration DSG timers for inclusion in DCD messages on a downstream cable interface on a Cisco CMTS router:


interface Cable6/0
 cable downstream dsg timer 3

Examples

This example shows how to associate an A-DSG tunnel group to a MAC domain interface on a Cisco cBR-8 router:

Router(config)# interface cable 1/0/0
Router(config-if)# cable downstream dsg timer 1

cable downstream dsg vendor-param

To associate Advanced-mode DOCSIS Set-Top Gateway (A-DSG) vendor parameters to a downstream, to be included in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router, use the cable downstream dsg vendor-param command in interface configuration mode. To remove this configuration from a Cisco CMTS router, use the no form of this command.

cable downstream dsg vendor-param vsif-grp-id

no cable downstream dsg vendor-param vsif-grp-id

Syntax Description

vsif-grp-id

Associates a vendor parameter with a group identifier.

Command Default

This command is not configured by default.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

12.3(13a)BC

This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 router and Cisco uBR7200 series routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Global configuration for A-DSG must be complete before configuring interface definitions.

Examples

The following example shows configuration of A-DSG vendor parameters on a downstream interfac, along with several other downstream interface commands on a Cisco CMTS router:


interface Cable6/0
 cable downstream dsg dcd-enable
 cable downstream dsg chan-list 2
 cable downstream dsg timer 3
 cable downstream dsg vendor-param 2
 cable downstream dsg rule 1 priority 1 clients 1 tunnel 1
 cable downstream dsg rule 1 vendor-param 1
 cable downstream dsg rule 1 classifiers 1 5
 cable downstream dsg rule 2 priority 1 clients 2 tunnel 2

cable downstream freq-profile

To set the frequency profile for the cable interface line card, use the cable downstream freq-profile command in global configuration mode.

cable downstream freq-profile id

Syntax Description

Syntax Description

id

Downstream frequency profile ID. 0 to 3 are system defined, 4 to 15 are user defined.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

IOS-XE 3.15.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to set the frequency profile for the cable interface line card.

Examples

The following example shows how to enable the downstream frequency profile configuration:


Router# configure terminal
Router(config)# cable downstream freq-profile 4
Router(config-freq-prof)#

cable downstream frequency

To note the downstream center frequency for the cable interface line card to reflect the digital carrier frequency of the downstream radio frequency carrier (the channel) for that downstream port, use the cable downstream frequency command in cable interface configuration mode. On cable interfaces with an integrated upconverter, to unset the downstream frequency and to disable the RF output from the integrated upconverter, use the no form of this command.

cable downstream frequency down-freq-hz

no cable downstream frequency

Syntax Description

down-freq-hz

The known center frequency of the downstream carrier in Hz (the valid range is 55,000,000 to 858,000,000). The usable range depends on whether the downstream is configured for DOCSIS or EuroDOCSIS operations:

  • DOCSIS = 88,000,000 to 855,000,000 MHz
  • Extended frequency range = 70,000,000 to 855,000,000 MHz
  • EuroDOCIS = 112,000,000 to 858,000,000 MHz

The Cisco IOS supports a superset of these standards, and setting a center frequency to a value outside these limits violates the DOCSIS or EuroDOCSIS standards. Cisco does not guarantee the conformance of the downstream and upconverter outputs when using frequencies outside the DOCSIS or EuroDOCSIS standards.

Command Default

Disabled. On the Cisco uBR7100 series routers, the default downstream center frequency for the integrated upconverter is 500 MHz.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

11.3 XA

This command was introduced to support NTSC/DOCSIS Annex B RF operation.

12.0(7)XR2, 12.0(8)SC

Modified to support PAL/SECAM EuroDOCSIS RF operation.

12.1(2)EC1

Supports both Annex A and Annex B.

12.1(5)EC1

Modified to support the integrated upconverter on the Cisco uBR7100 series universal broadband router.

12.2(11)CY, 12.2(11)BC3

Support was added for the Cisco uBR-MC5X20S cable interface line card.

12.2(15)CX

Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable interface line cards.

12.2(15)BC2

Support was added for the extended frequency range and for the Cisco uBR-MC5X20U cable interface line card. In addition, the command was changed to accept only center frequencies in 250 KHz increments (previously, the command allowed 125 KHz increments).

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command is either optional or required, depending on the cable interface line card being used.

  • On the Cisco uBR7100 series routers using the integrated upconverter (the DS0 RF output), and on cable interfaces that support integrated upconverters (such as the Cisco uBR-MC16U, Cisco uBR-MC28U, and Cisco uBR-MC5X20U), this command configures the frequency for the integrated upconverter. The no form of this command unsets the frequency and disables the output from the integrated upconverter.
  • For cable interfaces that use an external upconverter (such as the Cisco uBR-MC16S and the DS0 (IF) output on Cisco uBR7100 series routers), this command is informational-only, because it does not affect the external upconverter. The external upconverter must be programmed separately with the appropriate center frequency.

Note


The no form of this command is supported only on the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cable interface line cards, and on the Cisco uBR7100 series universal broadband router.

Note


We recommend configuring this command on all cable interfaces, even those that are using external upconverters. This is because this command is required to enable the downstream frequency override feature and for N+1 line card redundant operation when using SNMP-capable external upconverters.

The downstream frequency of your RF output must be set to match the expected input frequency of your upconverter. To do this, you enter the fixed center frequency of the downstream channel for the downstream port. (You can also select a default that does not set a specific fixed value.) The valid range for a fixed center frequency is 54,000,000 to 858,000,000 Hz. The center frequency is also used to configure an IF-to-RF upconverter that must be installed in your downstream path.

The digital carrier frequency is specified to be the center of a 6.0 MHz channel. For example, EIA channel 95 spans 90.000 to 96.000 MHz. The center frequency is 93.000 MHz, which is the digital carrier frequency that should be configured as the downstream frequency. The typical range for current CATV headends is 88,000,000 to 860,000,000 Hz.

In Cisco IOS software releases before Cisco IOS Release 12.2(15)BC2, the cable downstream frequency command allowed the center frequency to be specified in 125 KHz increments. In Cisco IOS Release 12.2(15)BC2 and later releases, this was changed to allow only 250 KHz increments, because of the requirements of the Broadband Processing Engine cable interface line cards that use an internal upconverter (Cisco uBR-MC16U, Cisco uBR-MC28U, and Cisco uBR-MC5X20S/U).


Note


DOCSIS allows downstreams to use any center frequency within 88,000,000 to 855,000,000 MHz. However, when most cable modems first come online, they initially start scanning the downstream for the frequencies that are in the NTSC channel plan. If a valid downstream is not found among those frequencies, the cable modems then beginning scanning the remaining frequencies. For the fastest and most efficient registration times, we recommend configuring downstreams for the frequencies that are specified in the NTSC channel plan.

Note


For cBR Series Converged Broadband Routers, the frequency configuration will be available as a part of the RF channel configuration.

Examples

The following example shows how to set the downstream center frequency display value:


Router(config)# interface c6/0
 
Router(config-if)# cable downstream frequency 96000000

cable downstream if-output

To activate a downstream port on a cable interface and to generate either a standard modulated signal or a test signal, use the cable downstream if-output command in cable interface configuration mode. To disable all signal output on the intermediate frequency (IF) carrier and to shut down the interface, use the no form of this command.

cable downstream if-output [continuous-wave | prbs]

no cable downstream if-output

Syntax Description

continuous-wave

Outputs an unmodulated carrier signal on the downstream, shutting down normal data network operations.

prbs

Outputs a Pseudo Random Bit Stream (PRBS) test signal on the downstream, shutting down normal data network operations.

Command Default

The downstream interface is enabled for normal data use.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

11.3 XA

This command was introduced.

12.0(7)XR2, 12.0(7)T, 12.(0)SC,12.1(2)EC1

This command was modified to support Annex A (EuroDOCSIS) downstreams, and the continuous-wave and prbs options were added.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Typically, a downstream is configured to output a modulated signal, using the cable downstream if-output command, allowing data transmissions to be sent over the HFC cable network. However, this command can also be used to test the cable plant or to shut down the interface completely:

  • cable downstream if-output continuous-wave —Generates an unmodulated, continuous sine wave on the downstream interface. You can use a spectrum analyzer to verify the frequency, amplitude, and power of the wave. The test signal continues on the downstream until you resume normal modulated operations using the cable downstream if-output command.
  • cable downstream if-output prbs —Generates a PRBS test signal on the downstream interface. You can use a spectrum analyzer to verify the frequency, amplitude, and power of the wave. The test signal continues on the downstream until you resume normal modulated operations using the cable downstream if-output command.
  • no cable downstream if-output —Terminates all signal output and shuts down the downstream interface. The interface remains shut down until you reactive the downstream using the cable downstream if-output command.

Note


Generating a PRBS or continuous-wave test signal or shutting down the interface automatically stops the modulated carrier data signal and disconnects all CMs on that downstream. These commands should not be used on a live network except as part of troubleshooting major network problems.

Examples

The following example shows how to enable downstream port 0 on a cable interface:


Router# configure terminal
Router# interface c6/0
Router(config-if)# cable downstream if-output

The following example shows a PRBS test signal being generated on a downstream for a period of time. The downstream is then shut down so that the test engineer can verify that no signal is being sent on the downstream. After the tests have been run, the downstream is reactivated for normal modulated data use:


Router# configure terminal
Router# interface c6/0
Router(config-if)# cable downstream if-output prbs
(the signals are verified by a spectrum analyzer...)
Router#(config-if)# no cable downstream if-output
(the downstream is checked to verify no signals are being sent on it...)
Router#(config-if)# cable downstream if-output
Router#(config-if)# exit
 

cable downstream interleave-depth

To set the downstream interleave depth, use the cable downstream interleave-depth command in cable interface configuration mode. To restore the default setting, use the no form of this command.

cable downstream interleave-depth {8 | 16 | 32 | 64 | 128}

no cable downstream interleave-depth

Syntax Description

8 | 16 | 32 | 64 | 128

Indicates the downstream interleave depth in number of rows of codewords.

Command Default

The downstream interleave depth value is 32.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

11.3 XA

This command was introduced.

12.0(7)XR2, 12.(0)SC,12.1(2)EC1

This command was modified to support Annex A operation (which uses a fixed interleave).

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines


Note


This command is not supported on the Cisco uBR-MC16E cable interface line card or on the Cisco uBR7111E and Cisco uBR7114E universal broadband routers, because the interleave on the EuroDOCSIS downstream is fixed.

This command sets the minimum latency of the system. A higher interleave depth provides more protection from bursts of noise on the HFC network by spreading out the bits for each codeword over a greater transmission time.

Interleave transmissions do not transmit each codeword by itself, but instead send bits from multiple codewords at the same time, so that a noise burst affects the minimum number of bits per codeword, which allows the Forward Error Correction (FEC) algorithm a greater chance of detecting and correcting any transmission errors.

A higher interleave depth transmits bits from a greater number of codewords, increasing the efficacy of the FEC algorithm. However, a higher depth also increases downstream latency, which might slow TCP/IP throughput for some configurations, so you need to choose an interleave depth that is appropriate both for your plant’s noise levels and application needs.

If your cable plant is experiencing high noise levels, consider increasing the interleave from the default of 32 to 64. For plants with exceptionally high noise levels, increase the interleave to 128 to provide the maximum protection from noise bursts.

Low interleave depth values typically cause some packet loss on typical HFC networks, because burst noise lasts beyond the error correction block correctable length. However, on cable plants with exceptionally low noise levels, Cisco recommends initially using the default value of 32, and then trying an interleave of either 16 or 8 to see if this increases performance without increasing the number of errors that result from noise.

The table below shows interleave characteristics and their relation to each other.


Note


The table below does not apply to EuroDOCSIS cable plants because the interleave depth for EuroDOCSIS cable interfaces is fixed.
Table 3. DOCSIS Downstream Cable Interleave Descriptions

I (Number of Taps)

J (Increment)

Burst Protection

64-QAM/256 QAM

Latency

64-QAM/256 QAM

8

16

5.9 microseconds/4.1 milliseconds

0.22 ms/0.15 ms

16

8

12 microseconds/8.2 milliseconds

0.48 ms/0.33 ms

32

4

24 microseconds/16 milliseconds

0.98 ms/0.68 ms

64

2

47 microseconds/33 milliseconds

2.0 ms/1.4 ms

128

1

95 microseconds/66 milliseconds

4.0 ms/2.8 ms


Tip


Changing the interleave depth affects the PHY layer on the downstream and disconnects all online CMs. For this reason, if you are using N+1 HCCP redundancy, you should configure this command on both the Protect and Working interfaces, so that the PHY layer is properly configured before a switchover occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also applies to the cable downstream annex and cable downstream modulation commands.)


Examples

The following example shows how to configure the downstream interleave depth to 128 microseconds:


Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable downstream interleave-depth 128 

cable downstream modulation

To set the modulation format for a downstream port on a cable interface line card, use the cable downstream modulation command in cable interface configuration mode.

cable downstream modulation {64qam | 256qam}

Syntax Description

Syntax Description

64qam

Modulation rate is 6 bits per downstream symbol.

256qam

Modulation rate is 8 bits per downstream symbol.

Command Default

The default modulation for Cisco RF Gateway 10 is 64 QAM.

Command Modes


Interface configuration—cable interface only (config-if)

Command History

Release

Modification

11.3 XA

This command was introduced.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Router.

Usage Guidelines

Downstream modulation defines the speed in bits per second at which data travels downstream to the subscriber’s CM. A symbol is the basic unit of modulation. QPSK encodes 2 bits per symbol, 16-QAM encodes 4 bits per symbol, 64-QAM encodes 6 bits per symbol, and 256-QAM encodes 8 bits per symbol.


Note


Setting a downstream modulation format of 256-QAM requires approximately a 6-dB higher signal-to-noise ratio (SNR) than 64-QAM at the subscriber’s cable modem. If your network is marginal or unreliable at 256-QAM, use the 64-QAM format instead.

Tip


Changing the modulation format affects the PHY layer on the downstream and disconnects all online CMs. For this reason, if you are using N+1 HCCP redundancy, you should configure this command on both the Protect and Working interfaces, so that the PHY layer is properly configured before a switchover occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also applies to the cable downstream annex and cable downstream interleave-depth commands.)


Examples

The following example shows how to set the downstream modulation to 256-QAM:


Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable downstream modulation 256qam

cable downstream ofdm-chan-profile

To define the OFDM channel profile on the OFDM channel, use the cable downstream ofdm-chan-profile command in global configuration mode. To remove the profile, use no form of this command.

cable downstream ofdm-chan-profile id

no cable downstream ofdm-chan-profile id

Syntax Description

Syntax Description

id

Downstream OFDM modulation profile ID. Valid range is from 20 to 255.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to define the OFDM channel profile for the OFDM channel.

Examples

The following example shows how to enable the OFDM channel profile configuration:


Router# configure terminal
Router(config)# cable downstream ofdm-chan-profile 21
Router(config-ofdm-chan-prof)#

cable downstream ofdm-flow-to-profile

To override the profile selection logic, use the cable downstream ofdm-flow-to-profile command in global configuration mode.

Cisco cBR-8 Converged Broadband Router

cable downstream ofdm-flow-to-profile [interface Integrated-Cable slot/subslot/port:chan]profile-data profile ID mac-address cable-modem-mac

Syntax Description

profile ID

Data profile identifier.

cable-modem-mac

MAC address of the cable modem.

slot/subslot/port:chan

Specifies the OFDM channel.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release

Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Cisco IOS XE Everest 16.6.1

This command was modified on the Cisco cBR Series Converged Broadband Routers. The interface integrated-Cable keyword was added.

Usage Guidelines

When this command is configured, all the service flows on the cable modem, identified by its MAC address,are mapped to the specified data profile. With the Interface option, profile override can be specified for a particular downstream OFDM channel. Thus with two OFDM downstream channels on a single CM, each channel can have a unique profile override. When the ofdm-flow-to-profile override is configured and no OFDM channel is specified, the profile Id will apply to all OFDM channels in use on the cable modem.

Examples

The following example shows how to override the selection logic:

Router(config)# cable downstream ofdm-flow-to-profile profile-data 2 mac-address fc52.8d5e.9e55

Once this command is configured, all the service flows on the cable modem whose MAC address is fc52.8d5e.9e55, are mapped to the profile ID 2.

The following example shows how to override the selection logic on a specific channel.

Router(config)# cable downstream ofdm-flow-to-profile interface integrated-Cable 1/0/0:158 profile-data 3 mac-address 4800.33ea.7012

Router(config)# cable downstream ofdm-flow-to-profile interface integrated-Cable 1/0/0:159 profile-data 2 mac-address 4800.33ea.7012

cable downstream ofdm-modulation-profile

To define the OFDM modulation profile on the OFDM channel, use the cable downstream ofdm-modulation-profile command in global configuration mode. To remove the profile, use no form of this command.

cable downstream ofdm-modulation-profile id

no cable downstream ofdm-modulation-profile id

Syntax Description

Syntax Description

id

Downstream OFDM modulation profile ID. Valid range is from 8 to 255.

Command Default

None

Command Modes


Global configuration (config)

Command History

Release

Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to define the OFDM modulation profile for the OFDM channel.

Examples

The following example shows how to enable the OFDM modulation profile configuration:


Router# configure terminal
Router(config)# cable downstream ofdm-modulation-profile 21
Router(config-ofdm-mod-prof)#