CMTS RF Config GD CMD Reference R7.2.4.2 08 28 2017 PDF
CMTS RF Config GD CMD Reference R7.2.4.2 08 28 2017 PDF
CMTS RF Config GD CMD Reference R7.2.4.2 08 28 2017 PDF
DOC-3022-01
Document Revision 07.02.04c
August 2017
© 2017 Casa Systems, Inc.
All rights reserved. Licensed software products are owned by Casa Systems or its suppliers and are protected
by United States copyright laws and international treaty provisions.
The information regarding the product in this manual is subject to change without notice. All statements,
information, and recommendations in this manual are believed to be accurate but are presented without
warranty of any kind, express of implied. Users must take full responsibility for their application of the product.
In no event shall Casa or its suppliers be liable for any indirect, special, consequential, or incidental damages,
including, without limitation, lost profits or loss or damage to data arising out of the use or inability to use this
manual, even if Casa or its suppliers have been advised of the possibility of such damages.
iii
Contents
Preface
Casa Systems
iv RF Cable Configuration Guide and Command Reference
Contents
Casa Systems
RF Cable Configuration Guide and Command Reference v
Contents
reg-rsp-original-upstream-action .............................................................4-103 .
Casa Systems
vi RF Cable Configuration Guide and Command Reference
Contents
Casa Systems
RF Cable Configuration Guide and Command Reference vii
Contents
load-balance ..............................................................................................10-6 .
modulation-profile ......................................................................................11-2 .
a-long ...................................................................................................11-7 .
a-short .................................................................................................11-9 .
initial ..................................................................................................11-10.
long ....................................................................................................11-11 .
request ...............................................................................................11-12 .
short ...................................................................................................11-13 .
station ................................................................................................11-14 .
ugs .....................................................................................................11-15 .
Casa Systems
viii RF Cable Configuration Guide and Command Reference
Contents
Casa Systems
RF Cable Configuration Guide and Command Reference ix
Contents
packetcable ...............................................................................................16-2 .
module .....................................................................................................17-34.
qos-profile ..................................................................................................18-7
.
channel-utilization-interval .........................................................................19-6 .
spectrum ....................................................................................................19-9
.
Casa Systems
x RF Cable Configuration Guide and Command Reference
Contents
Casa Systems
RF Cable Configuration Guide and Command Reference xi
Contents
Casa Systems
xi
Preface
Cable network administrators and operators who are integrating and configuring the
CMTS RF cable interfaces in the cable headend with their existing network
infrastructure should have experience with the following:
• Internet Layer 2 and Layer 3 networking technologies and transports
• Frequency management on upstream and downstream interfaces.
Note: The additional Casa Systems – NSI Configuration Guide and Command
Reference covers the IETF routing protocols that are supported on CMTS
network side interfaces.
Revision history
This guide supports Casa CMTS software releases up through Release 7.2. See the
Casa Systems – CMTS Release Notes for information on new or late features not yet
covered in this guide.
• 1.00.00 — August 2014; initial review draft.
• 1.00.01 — September 2014; added QAM 8x96 interface chapter.
• 1.00.02 — September 2014; initial release.
• 1.00.03 — October 2014; updated released version with latest functionality.
• 1.00.04 — January 2015; updated 6.4.3 released version with latest functionality.
• 1.00.05 — August 2015; updated to Release 6.4.3.4.
Contacting Casa
Corporate facility
Casa Systems, Inc.
100 Old River Road
Andover, MA 01810
Tel.: 978-688-6706
World Wide Web: www.casa-systems.com
Technical Support
In the United States: Tel: 978-699-3045
E-mail: [email protected]
Technical documentation
Casa Systems provides the following documentation set in PDF format, viewable
using Adobe Reader 5.0 or later. These PDF files are available from the Casa FTP site
at ftp://support.casa-systems.com.
• Casa Systems – C1G CMTS Quick Installation
• Casa Systems – C1G CMTS Hardware Installation Guide
• Casa Systems – C10G CMTS Quick Installation
• Casa Systems – C10G CMTS Hardware Installation Guide
• Casa Systems – C40G CMTS Hardware Installation Guide
• Casa Systems – C100G CMTS Quick Installation
• Casa Systems – C100G CMTS Hardware Installation Guide
• Casa Systems – CMTS Operations and Administration Guide
• Casa Systems – SNMP MIBs and Traps Reference
• Casa Systems – CCAP Video Edge User Guide
• Casa Systems – CMTS Network Solutions Guide
• Casa Systems – NSI Configuration Guide and Command Reference
Note: Casa Systems provides updates to the manuals on a regular basis. Log
on to the Casa Systems Web site at www.casa-systems.com for the latest files
in PDF format. Select customer login and enter your username and
password. If you do not have a Casa-assigned username and password, send
e-mail to [email protected].
Acronyms
Casa Systems manuals contain the following industry-standard and product-specific
acronyms:
3DES Triple Data Encryption Standard (IPsec)
ABR Area Border Router (OSPF)
ARP Address Resolution Protocol
AS Autonomous System
ASN Autonomous System Number
ATDMA Asynchronous Time Division Multiple Access
BDR Backup Designated Router (OSPF)
BFD Bidirectional Forwarding Detection (RFC 5880)
BFS Broadcast File System
BGP Border Gateway Protocol
BKPM Baseline Privacy Key Management
BNG Broadband Network Gateway
BPI[+] Baseline Privacy Interface [Plus]
BPSK Binary Phase Shift Keying
BSoD Business Services over DOCSIS
BSR Bootstrap Router (PIM)
FIB Forwarding Information Base
CAS Conditional Access System (SimulCrypt)
CCAP Converged Cable Access Platform
CE Customer Edge
CIDR Classless Inter-Domain Routing
CIR Committed Information Rate
CM Cable Modem
CMTS Cable Modem Termination System
CNR Carrier-to-noise ratio
COPS Common Open Policy Service
CPD Control Point Discovery (PacketCable)
CPE Customer Premises Equipment
CRC Cyclic Redundancy Check
CSM Casa Spectrum Management
CSMA Carrier Sense Multiple Access
DAD Duplicate Address Detection (interfaces)
DBC Dynamic Bonding Change
DBG Downstream Bonding Group
DCC Dynamic Channel Change
DCD Downstream Channel Descriptor (QAM)
DCTS Digital Cable Termination System
DCU DOCSIS Control and Upstream module
DDM DOCSIS Device Manager
DES Data Encryption Standard
DNCS Digital Network Control System
DNS Domain Name System/Server
DHCP Dynamic Host Configuration Protocol
DLF Destination lookup failure (packets)
DPD Downstream Profile Descriptor (OFDM)
DQM DOCSIS QAM Module
DSA Digital Signature Algorithm (SSH)
DSCP Differentiated Services Code Point
DSG DOCSIS Set-Top Gateway specification (QAM)
DSID Downstream Service Identifier (DOCSIS MAC)
DSX Dynamic Service Change (DSA, DSC, and DSD)
Topic Page
Casa Systems
1-2 RF Cable Configuration Guide and Command Reference
CMTS installation in the network topology
Topic Page
The Casa CMTS provides both a network side interface (NSI) and a radio frequency
interface (RFI). On the NSI, the CMTS provides Ethernet 10/100 Mbps (for system
management), GigE, and 10GigE (C10G) interfaces to routing gateways and servers.
On the RFI, the CMTS provides both upstream and downstream interfaces for
transmission and receipt of digitized content and data services over fiber network
trunks and coaxial cable to and from the subscriber distribution areas.
Residing between the NSI and the RFI is the CMTS forwarding engine that resides in
the CMTS Switch and Management Module. As data, voice, and video traffic is
processed over both the NSI and the RFI, the forwarding engine selectively directs the
traffic over the correct interface for transmission and delivery to a destination.
Upstream HTTP requests to the Internet from a customer PC, for example, is
transmitted by the cable modem (CM) over the fiber network to the upstream CMTS
channels before being forwarded to the NSI and routing gateway to the Internet. The
HTTP response (and Web page) from the Internet destination is then returned to the
CMTS and forwarded over a downstream channel to that customer’s CM for
transmission and presentation at the PC.
Casa Systems
RF cable operations overview 1-3
About the Casa CMTS as a headend device
Figure 1-1. Example D1.0 cable network topology with Casa CMTS
downstream
upstream channel Forward channel lineup
channels
Note: The topology illustrated in Figure 1-1 uses the Casa C3200 CMTS as
an example. Other CMTS platforms, such as the Casa C10G and future Casa
platforms, also fit into this topology.
Casa Systems
1-4 RF Cable Configuration Guide and Command Reference
Understanding the CMTS as a DOCSIS MAC domain
Casa Systems
RF cable operations overview 1-5
Cable modem initialization and learning
C3000 CCASA
ASA
ALM 0 1 2
Multiple
Forward channel lineup
upstream
channels
Television and
Diplexer/filter Forward combiner channel lineup
LOW | HIGH
5 to 42 MHz 50 MHz to 1 GHz
MPEG-2 Set-top box
Fiber network and transport stream
amplifier CH 851
DS
US PC
Coaxial cable D3.0 cable modem
- Multiple tranmitters
and receivers
- Channel bonding
Phone
Modem initialization begins when the modem is connected to the cable provider’s
network and powered on. The modem listens for MAC management message (MMM)
broadcasts from the CMTS. Using QAM modulated signals, the MMM carries the
188-byte MPEG-2 transport stream for modem synchronization with the MAC
domain, as well as the upstream channel descriptors (UCDs) and their associated
MAP packets for establishing upstream transmissions, and a MAC domain descriptor
(MDD) for D3.0 modems capable of channel bonding.
Casa Systems
1-6 RF Cable Configuration Guide and Command Reference
Cable modem initial ranging and registration
Once the CM is able to listen for and receive the MPEG-2 transport streams that are
modulated on the downstream carrier signals, the modem begins the initial ranging
process over the upstream channels.
In large networks with many CMs attempting to register with the CMTS at the same
time, initial ranging requests are subject to collisions with requests from other
modems. Each initial ranging request is considered an initial ranging opportunity.
Because of the high probability of collisions, the MAC domain uses a ranging backoff
algorithm to tell the modem how long to wait before retransmitting another initial
ranging request.
The ranging backoff algorithm reschedules and increases initial ranging transmissions
at random intervals to provide a better opportunity for CMs to avoid collisions.
Ranging backoff values are expressed as an exponential value to set the number of
ranging opportunities per retry, such 23, 24, 25, and 26. For example, configuring a
value of 3 specifies 23, or 8 ranging opportunities on the first attempt. Configuring a
value of 4 specifies 24, or 16 ranging opportunities on the second attempt and so on.
The Casa CMTS allows up to sixteen initial ranging retry attempts. When the CM
receives an upstream transmission grant from the CMTS, the MAC domain adjusts the
CM for frequency, power, and delay. Two-way modem communication with the
CMTS is then established.
After the initial ranging request has completed, the CM is then provisioned using
DHCP and TFTP to complete the initialization process, as described in the next
section. When the initialization process has completed, the CM requests registration
with the CMTS. The CM can then receive transmissions on the downstream channels
and transmit to the CMTS over the upstream channels.
Casa Systems
RF cable operations overview 1-7
Cable modem provisioning and configuration
Figure 1-3 shows the the cable modem initialization and configuration process.
In the upstream, you should not see any power difference, regardless of the number of
channels enabled.
Casa Systems
1-8 RF Cable Configuration Guide and Command Reference
Cable modem power considerations
188-byte
MPEG-2 transport
stream (42 Mbps)
ALM 0 1 2 downstream
channel UCD1
Modem initial UCD2
ranging
UCD3
and registration
Forward UCD4
combiner SYNC
Diplexer/filter
LOW | HIGH MAP1
5 to 42 MHz 50 MHz to 1 GHz
MAP2
QAM64 or QAM256 MAP3
Fiber network and modulation
amplifier MAP4
Coaxial cable
DS
US
Cable modem frequency,
power, and delay adjustments.
1. Modem performs an initial ranging request with the CMTS. Transmission interval is
determined and modem is adjusted for frequency, power and delay. Modem sends
a registration request to the CMTS for two-way communication with the MAC domain.
2. Modem DCHP DISCOVER, OFFER, REQ, ACK packets exchanged with DHCP server.
4. Modem receives modem config file from TFTP server and configures itself. Optional
time-of-day packet exchange.
Casa Systems
RF cable operations overview 1-9
Upstream channel descriptors and MAPs
• Frequency
• Width
• Burst profile
1. Each burst profile can be one of five burst types: initial ranging, periodic ranging,
long data, short data, and request. (See Chapter 11, “Modulation profiles.”)
2. Each burst type can have one or more burst descriptors with up to twelve burst
description parameters, such as modulation type, forward error correction (FEC),
scrambler, preamble, long/short data, and others.
Each UCD has one associated MAP that instructs the modem on “when” to transmit
over an upstream timeline.
Figure 1-4 illustrates the association between the UCD and the MAP, where:
• UCD1 specifies the CMTS upstream channel, frequency, width and burst profile.
Casa Systems
1-10 RF Cable Configuration Guide and Command Reference
UCD and MAP operations
• MAP1 specifies when time-zero (t0) begins on the upstream timeline, as well as
the 32-byte field that carries the service identifier (SID) that describes “who” is
transmitting.
• The interval usage code (IUC) that indicates “what” type of transmission, and the
t0 timing offset to indicate “when” to begin the upstream transmission interval
from t0 on the timeline.
The upstream timeline is comprised of intervals and minislots, where a single group of
minislots makes up one interval. These intervals vary in size starting at time-zero (t0)
until the end of the interval where t0 begins again. Time-division multiplexing (TDM)
scheduling is used to set both long and short intervals in the timeline where the
interval size is based on traffic conditions. Each minislot within each interval is 6.25
microseconds. Figure 1-5 illustrates the upstream channel timeline, intervals, and
minislots in the network context. (See Chapter 21, “Upstream interface.”)
Casa Systems
RF cable operations overview 1-11
UCD and MAP operations
Multiple 1FFE
upstream Casa CMTS Single
channels SYNC
CASA SYSTEMS
C3000 CCASA
ASA
SYS 3 4 5
ALM 0 1 2 downstream
channel UCD1
One upstream
channel selected UCD2
from UCD
UCD3
Forward UCD4
UCD1
combiner SYNC
Diplexer/filter
LOW | HIGH MAP1
5 to 42 MHz 50 MHz to 1 GHz
MAP2
QAM64 or QAM256 MAP3
modulation
MAP4
Upstream timeline
Intervals Large and small intervals in timeline
IUC interval
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Minislots
(6.2 ms per minislot) 0
t0 0
MAP1
MAP
Elements 32 14 4 14 14 4 14
header
“Who” “When”
Service ID (SID) t0 offset
“What”
Interval Usage Code (IUC)
Casa Systems
1-12 RF Cable Configuration Guide and Command Reference
Channel bonding and service group operations
Figure 1-6 illustrates a sample network with eight downstream channels. Even though
the modem only supports 4 downstream and 4 upstream channels, the modem learns
how to receive traffic across all eight CMTS downstream channels. The CMTS
dynamically creates a channel bonding group using four of the channels (based on
current traffic load) and creates a downstream service group, or DS-SG associated
with the assigned modem channel set. A service group is simply a group of channels.
C3000 CCASA
ASA
ALM 0 1 2
A
B Forward channel lineup
C
D
Forward combiner
Multicast bus
Casa Systems
RF cable operations overview 1-13
Physical fiber node vs. DOCSIS terminology
Similarly, the set of upstream channels is called the upstream service group, or
US-SG. Collectively, the upstream and downstream service groups make up the cable
modem service group, or CM-SG. All upstream and downstream channels originating
from the same MAC domain are known as a MAC domain cable modem service
group, or MD-CM-SG.
Note that the CM in Figure 1-6 at the “D” distribution area endpoint uses a
two-channel upstream service group. This means that upstream traffic from the CM
will be assigned to one of two channels from the MAC domain-assigned US-SG for
this modem.
A DOCSIS fiber node refers to a CM service group (CM-SG), which is made up of the
upstream and downstream service groups described in the previous section.
While cable providers around the world today use the term fiber node to describe the
physical cable infrastructure to the distribution areas, it is important to understand that
the term DOCSIS fiber node is associated with a CM service group and not the
physical network.
Casa Systems
1-14 RF Cable Configuration Guide and Command Reference
Load balancing CMTS traffic
The Casa CMTS supports two types of load balancing: general load balancing and
restricted load balancing.
The general load balancing group (GLBG) uses the complete set of upstream and
downstream channels in that modem’s CM service group (CM-SG).
Note: A single CM cannot belong to more than one load balancing group at
any given time.
Both general and restricted load balancing groups have the following characteristics:
At CM registration time, the CMTS attempts to assign the modem either to a restricted
load balancing group (if it exists), or to a general load balancing group. If a restricted
load balancing group does not exist in the CMTS configuration file, the CM is then
assigned by default to the general load balancing group using the channels in the
MD-CM-SG for that modem.
• A single CM can belong to only one load balancing group using only the upstream
and downstream channels within that group.
• Load balancing does not take place if the CMTS cannot determine the load
balancing group to which a registered CM belongs.
Casa Systems
RF cable operations overview 1-15
Dynamic channel and bonding changes
Dynamic channel change (DCC) and dynamic bonding change (DBC) messages from
the MAC domain instruct CMs on when to change channels, or when to change an
upstream or downstream bonding group. Both DCC and DBC can occur during traffic
load balancing at the CMTS when the CM has access to multiple upstream or
downstream channels.
DCC moves legacy and current DOCSIS 3.x modems (not operating with a multiple
receive channel set) from one downstream channel to another using the MD-CM-SG
for that modem. On the upstream side, DCC also instructs CMs to move from one
transmit channel to another from the MD-CM-SG.
DBC moves DOCSIS 3.x modems downstream service flows to different channels in
the modem’s receive channel set. DBC also moves D3.0 upstream service flows to
different channels in the current transmit channel set. In the Casa implementation, the
number of upstream channels is reduced whenever an attenuation change causes a
modem to maximize its transmit power where the modem cannot reach the expected
input power level at the CMTS.
A load balancing policy is a set of rules that govern load balancing operations. There
are two types of rules that the CMTS uses when load balancing takes place: basic
rules and execution rules. The CMTS uniquely identifies each load balancing policy
using a policy ID.
A basic rule sets the time of day when the CMTS is to perform load balancing. The
configured time will be during predictable traffic periods when congestion over the
downstream and upstream channels is most likely to occur. Multiple basic rules are
supported in a load balancing policy. A basic rule is a DOCSIS specification
requirement.
An execution rule defines the specific traffic conditions or parameters that enable the
load balancing algorithms of the CMTS regardless of the time of day (as set in a basic
rule). The execution rule can specify when load balancing is to occur and to which
modems, the time interval, or how often certain modems participate in DCC or DBC
load balancing operations, as well as other parameter settings such as static and
Casa Systems
1-16 RF Cable Configuration Guide and Command Reference
Static vs. dynamic load balancing
dynamic load balancing. Unlike basic load balancing rules, execution rules are
vendor-specific and are not mandated by the DOCSIS specification.
The CMTS performs load balancing in one of two ways, or a combination of the two:
Static load balancing takes place when a CM sends its initial ranging request message
to the CMTS. For DOCSIS 1.0, 1.1 and 2.0 modems, the CMTS responds with a
ranging response (RNG-RSP) message that includes either a Downstream Frequency
Override or an Upstream Channel ID Override field that instructs the CM which
channels it should use. For DOCSIS 3.x modems, when a CM sends its registration
request (REG-REQ) messages, the CMTS responds with a registration response
(REG-RSP) message to instruct the CM to select the channels.
Dynamic load balancing moves CMs among upstream and downstream channels
within the same service group when the difference between two channels exceeds a
defined percentage. The CMTS will use dynamic channel change messages (DCC) to
move CMs with single upstream/downstream channels, and dynamic bonding change
(DBC) messages to move CMs with bonded upstream/downstream channels to
different bonding groups.
Note: For DOCSIS and EuroDOCSIS 3.x modems, the dynamic load
balancing software generates a downstream channel set with a minimum load
to fit the modem‘s receive channel profile (RCP). This prevents rejection of the
new channel set so that load balancing is not canceled when the assigned
modem is under load.
The CMTS does not move modems to disconnected (idle) downstream channels
where there are no registered online CMs.
Casa Systems
RF cable operations overview 1-17
Applying exclusion lists
An exclusion list disables one or more modems from load balancing across CMTS
downstream and upstream channels in situations where it is not feasible to load
balance particular modems. For example, there may be cases where an older DOCSIS
1.0 or 2.0 modem from a specific vendor may not be a good candidate for load
balancing, as well as modems that process particular types of traffic where moving
those modems to other channels introduces risks. CMs in the exclusion list are
specified by MAC address.
burst profile — The set of burst descriptors carried by UCD packets in the MPEG-2
transport stream as sent by the CMTS to a target CM. A burst profile supports up to
five upstream burst types to describe an upstream channel.
burst type — One of five possible upstream burst types that describe an upstream
channel as carried in the burst profile portion of a UCD packet. Possible upstream
burst types include initial-ranging, periodic-ranging, request, long data, and short data.
Each burst type is one burst descriptor with up to twelve parameters.
cable modem service group (CM-SG) — The combination of upstream (US-SG) and
downstream channels (DS-SG) at the CMTS to which a CM has access.
channel bonding — The DOCSIS 3.x CM feature that allows the CMTS to link a
group of channels based on the number of channels supported by the target CM. When
the CMTS creates a bonding group for a CM that has four physical downstream
receivers, the modem can receive over the four channels simultaneously over a
downstream channel set.
Casa Systems
1-18 RF Cable Configuration Guide and Command Reference
Terminology covered in this chapter
downstream channel — The CMTS 50-MHz through 1-GHz channel over which the
CMTS sends MPEG-2 transport streams over the cable infrastructure to the one more
distribution areas. The downstream channel operates with the forward combiner to
deliver modulated content on carrier signals to target cable subscribers.
dynamic channel change (DCC) — The MAC management message from the CMTS
that instructs a CM to move from one channel to another within the CM service group
(CM-SG).
dynamic bonding change (DBC) — The MAC management that moves DOCSIS 3.x
modem downstream service flows to different channels in the modem’s receive
channel set (RCS). DBC also moves D3.0 upstream service flows to different
channels in the current transmit channel set (TCS).
dynamic host control protocol (DHCP) — The IETF protocol for dynamically
assigning an IPv4 or IPv6 address to a requesting device, such as a CM. The CMTS
forwards a DHCP request from a CM to a dedicated DHCP server. The CMTS then
forwards the DHCP response message containing the IP address to the requesting CM.
dynamic load balancing — The CMTS traffic balancing method that moves CMs
among upstream and downstream channels within the same service group after their
initial difference between two channels exceeds a defined percentage.
exclusion list — A list of one or more modems that the CMTS purposely excludes
from load balancing across CMTS downstream and upstream channels.
execution rule — A load balancing metric the defines the specific traffic conditions or
parameters that trigger load balancing operations at the CMTS.
fiber node — The physical cable infrastructure that links the cable headend to one or
more geographical distribution areas.
forward combiner — The cable headend device that places modulated digital content,
such as the downstream channel lineup, onto CMTS downstream carrier signals to
cable distribution areas.
Casa Systems
RF cable operations overview 1-19
Terminology covered in this chapter
forward channel lineup — Modulated digital content, such as local and satellite
television, news and sports feeds, and streaming video, that is carried on CMTS
downstream MPEG-2 transport streams to cable distribution areas.
forwarding engine — The set of CMTS processes that reside between the CMTS
network side interface (NSI) and radio frequency interface (RFI) for controlling how
CMTS traffic is forwarded “through” one or more MAC domains or routed “to”
network destinations.
general load balancing group (GLBG) — The complete set of upstream and
downstream channels in a CM service group (CM-SG) that are available for load
balancing operations.
initial ranging — The upstream burst type that is carried by the upstream channel
descriptor in the MPEG-2 transport stream that enables a CM to request an upstream
transmission grant from the CMTS so that the modem can register with the CMTS.
interval usage code (IUC) — The CMTS-assigned code that schedules the initial
ranging interval in the upstream time line to the CMTS. Once a transmission interval
is set, the MAC domain then adjusts CM frequency, power, and delay for two-way
communication. IUCs are carried by MAP packets in the MPEG-2 transport stream.
load balancing — The CMTS process that enables modems to move from one channel
to another so that traffic load is redistributed for improved bandwidth utilization and
reduced consumption of CMTS resources. See dynamic channel change and dynamic
bonding change.
MAC domain — The Open Systems Interconnect (OSI) Layer 2 device through which
radio frequency traffic is forwarded to CMs over downstream channels, and received
over CMTS upstream channels. The minimum MAC domain contains one upstream
and one downstream channel. The Casa CMTS is an integrated Layer 2 MAC domain
and a Layer 3 physical routing device supported by an internal forwarding engine.
Casa CMTS systems can support up to 64 MAC domains. (See Chapter 8, “DOCSIS
MAC interface.”)
MAC domain cable modem service group (MD-CM-SG) — All CM upstream and
downstream channels originating from a single MAC domain.
Casa Systems
1-20 RF Cable Configuration Guide and Command Reference
Terminology covered in this chapter
MAC domain descriptor (MDD) — The DOCSIS 3.x packet carried by the MPEG-2
transport stream that defines the receive channel set for CMs that support multiple
receivers and transmitters, such as a D3.0 CM with four downstream and four
upstream channels.
MAC management message (MMM) — The CMTS message that carries the MPEG-2
transport stream that includes MAC time synchronization packets, UCD and MAP
packets, and the MDD.
MAP — The packet carried by the MPEG-2 transports stream that instructs the
modem when to transmit over an upstream timeline by specifying when time-zero (t0)
begins. The MAP carries a 32-byte field to indicate the service identifier (SID) to
declare “who” is transmitting, the interval usage code (IUC) that indicates “what”
type of transmission, and the t0 timing offset to indicate “when” to begin the upstream
transmission interval from t0 on the timeline.
minislot — A series or group of time components that make up one upstream time
interval. These intervals vary in size starting at time-zero (t0) until the end of the
interval where t0 begins again. Time-division multiplexing (TDM) scheduling sets
both long and short intervals in the timeline where the interval size is based on traffic
conditions. Each minislot within each interval is 6.25 microseconds.
MPEG-2 transport stream — The 188-byte packet carried in the MAC management
message that includes MAC time synchronization packets, UCD and MAP packets,
and the MDD. An MPEG-2 transport stream with a program identifier (PID) of 1FEE
indicates that the stream originates from a MAC domain. The MPEG-2 transport
stream carries modulated digital content signals to cable distribution areas.
network side interface (NSI) — The OSI Layer 3 routing side of the CMTS. The NSI
supports the IP routing protocols such as OSPF, RIP, BGP, and IS-IS to support
routing between neighbor routers. The CMTS uses 10/100 Fast Ethernet for
out-of-band remote management, as well as GigE and 10GigE interfaces for voice,
data, and video traffic routing. The NSI uses the CMTS forwarding engine to route
network protocol traffic to network destinations.
QAM64 — A 64-state modulation method that combines phase angle and amplitude
signals over downstream channels. QAM64 modulation over 6 MHz channels
operates at 30 Mbps.
Casa Systems
RF cable operations overview 1-21
Terminology covered in this chapter
QAM256 — A 256-state modulation method that combines phase angle and amplitude
signals over downstream channels. QAM256 modulation over 6 MHz channels
operates at 42 Mbps.
radio frequency interface (RFI) — The combination of at least one upstream and one
downstream channel to form the DOCSIS MAC domain. The CMTS provides both
upstream and downstream interfaces for transmission and receipt of digitized content
and data services over fiber network trunks and coaxial cable to and from the
subscriber distribution areas.
ranging backoff algorithm — The CMTS process that tells a CM how long to wait
before retransmitting another initial ranging request. The ranging backoff algorithm
reschedules and increases initial ranging transmissions at random intervals to provide
a better opportunity for CMs to avoid collisions with other modems. Ranging backoff
values are expressed as an exponential value to set the number of ranging
opportunities per retry, such 23, 24, 25, and 26.
receive channel set (RCS) — The downstream channels over which a CM receives
traffic from the MAC domain. The MAC domain descriptor (MDD) in the MPEG-2
transport stream informs the modem about the receive-channel configuration and the
receive channel set to be used by that modem.
service flow — A MAC layer transport service that provides unidirectional transport
of packets from the upper layer to the RF layer along with shaping, policing, and
prioritizing of traffic according to QoS traffic.
service group (SG) — The group of downstream channels (DS-SG) over which a CM
receives traffic from the MAC domain, or the group of upstream channels (US-SG)
over which the CM transmits to the CMTS. The combination of both upstream and
downstream service groups is known as the CM service group (CM-SG) or DOCSIS
fiber node.
service identifier (SID) — The 14-byte portion of the 32-byte packet carried in the
MAP that identifies a particular CM attempting to transmit upstream to the CMTS.
Casa Systems
1-22 RF Cable Configuration Guide and Command Reference
Configuration examples
static load balancing — The CMTS traffic balancing method that instructs the CM
which channels it should use after initial ranging. For DOCSIS 3.x modems, when a
CM sends its registration request (REG-REQ) messages, the CMTS responds with a
registration response (REG-RSP) message to instruct the CM to select the channels.
transmit channel set (TCS) — The CMTS 5–42 MHz upstream channels over which a
CM transmits traffic to the CMTS MAC domain. Upstream channel information is
determined by the UCD and MAP packets carried in the MPEG-2 transport stream
from the CMTS.
trivial file transfer protocol (TFTP) — The IETF protocol used by the CMTS for
transferring a CM configuration file from a dedicated TFTP server to a target CM,
allowing the modem to properly configure itself for two-way communication with the
CMTS.
upstream channel — The CMTS 5–42 MHz channel over which a CM transmits
traffic to the CMTS over a transmit channel set (TCS). Upstream channel information
is determined by the UCD and MAP packets carried in the MPEG-2 transport stream
from the CMTS. (See Chapter 21, “Upstream interface.”)
upstream channel descriptor (UCD) — The packet carried in the MPEG-2 transport
stream that describes the upstream channels over the which a CM transmits to the
CMTS. Each UCD describes an upstream channel with frequency, width, and burst
profile (set of burst descriptors). Each UCD has one associated MAP that instructs the
modem on “when” to transmit over an upstream timeline.
upstream service group — The group of CMTS upstream channels over which a CM
transmits traffic to the CMTS over a transmit channel set (TCS); the group of
upstream channels to which a CM has access.
Configuration examples
This section contains two sample configuration files: basic and general. The basic
configuration allows the CMs to register. The general configuration demonstrates how
to configure advanced features, such as Spectrum Management, Channel Bonding,
and Load Balancing.
Casa Systems
RF cable operations overview 1-23
Basic configuration
Basic configuration
The following sample configuration provides basic settings for registering CMs.
hostname CASA-CMTS
interface eth 0
ip address 192.168.2.215 255.255.255.0
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
Casa Systems
1-24 RF Cable Configuration Guide and Command Reference
General configuration
no logical-channel 0 shutdown
interface upstream 1/1
no shutdown
no logical-channel 0 shutdown
interface upstream 1/2
no shutdown
no logical-channel 0 shutdown
interface upstream 1/3
no shutdown
no logical-channel 0 shutdown
interface upstream 1/4
no shutdown
no logical-channel 0 shutdown
interface upstream 1/5
no shutdown
no logical-channel 0 shutdown
interface upstream 1/6
no shutdown
no logical-channel 0 shutdown
interface upstream 1/7
no shutdown
no logical-channel 0 shutdown
channel-utilization-interval 10
interface ip-bundle 1
ip address 192.168.7.1 255.255.255.0
cable helper-address 192.168.3.7
interface docsis-mac 1
no shutdown
ip bundle 1
downstream 1 interface qam 0/0/0
upstream 1 interface upstream 1/0/0
General configuration
hostname CASA-CMTS
interface eth 0
ip address 192.168.2.215 255.255.255.0
spectrum rule 35
action modulation frequency channel-width
channel-width 3200000 1600000
Casa Systems
RF cable operations overview 1-25
General configuration
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
interface ip-bundle 1
ip address 192.168.6.1 255.255.255.0
ip address 122.8.74.1 255.255.254.0 secondary
cable helper-address 192.168.3.7
service group 1
qam 0/0/0
qam 0/0/1
qam 0/0/2
qam 0/0/3
qam 0/1/0
Casa Systems
1-26 RF Cable Configuration Guide and Command Reference
General configuration
qam 0/1/1
qam 0/1/2
qam 0/1/3
upstream 1/0.0
upstream 1/1.0
upstream 1/2.0
upstream 1/3.0
upstream 1/4.0
upstream 1/5.0
upstream 1/6.0
upstream 1/7.0
interface docsis-mac 1
no shutdown
ip bundle 1
downstream 1 interface qam 0/0/0
downstream 2 interface qam 0/0/1
downstream 3 interface qam 0/0/2
downstream 4 interface qam 0/0/3
downstream 5 interface qam 0/1/0
downstream 6 interface qam 0/1/1
downstream 7 interface qam 0/1/2
downstream 8 interface qam 0/1/3
upstream 1 interface upstream 1/0.0
upstream 2 interface upstream 1/1.0
upstream 3 interface upstream 1/2.0
upstream 4 interface upstream 1/3.0
upstream 5 interface upstream 1/4.0
upstream 6 interface upstream 1/5.0
upstream 7 interface upstream 1/6.0
upstream 8 interface upstream 1/7.0
channel-utilization-interval 10
Casa Systems
RF cable operations overview 1-27
General configuration
Casa Systems
2-1
Configuration summary
Table 2-1 lists and briefly describes the objects related to application classes and
policies.
Casa Systems
2-2 RF Cable Configuration Guide and Command Reference
application
application
Purpose
The application command configures application classes and policies. The two
application objects are described in the following sections.
Modes
(config)#
(conf-app-class <index>)#
(conf-app-policy <id>)#
Syntax
[no] application class <1:16>
[no] application policy <1:32>
Properties
Property name Description
Example:
Example:
Casa Systems
Application classes and policies 2-3
class
class
Purpose
The application class command defines application class properties. Each application
class is a service that defines the rules for matching service flows to that application
class for bandwidth calculation prior to cable admission-control. An application
class can be assigned in only one direction, downstream or upstream. This includes
schedule types for the following:
An application class needs to have a defined name and can have up to eight child
classes that can be configured for availability when the parent application class
reaches its maximum bandwidth. A parent include rule statement must precede
adding a child class. A child class preempts another one from the same parent using
the exclusive and non-exclusive bandwidth percentage settings, although the sum of
all child class exclusive settings cannot exceed that of the parent. For emergency and
normal calls, one child class can be set for normal calls with exclusive set to zero and
non-exclusive set to the maximum normal calls allowed, while another child class can
be set for emergency calls with exclusive set to the maximum voice calls allowed and
non-exclusive set to zero.
Casa Systems
2-4 RF Cable Configuration Guide and Command Reference
class
Mode
(conf-app-class <1:16>)#
Syntax
name <name>
[no] child-class <1:8> {name <name> | downstream-bandwidth exclusive
<0:100> [non-exclusive <0:100>] | include <val> |
upstream-bandwidth exclusive <0:100> [non-exclusive <0:100>]}
downstream-bandwidth exclusive <1:100> [non-exclusive <0:100>]
[no] include {BE | multicast application-id <1:65535>... | packetcable
[emergency | normal] | pcmm {app-id <0:65535>... | gate-priority
<0:7>...} | sched-type [be] [nrtps] [rtps] [ugs] [ugs-ad] |
service-class <name>...}
upstream-bandwidth exclusive <0:100> [non-exclusive <0:100>]
Properties
Property name Description
Example:
Casa Systems
Application classes and policies 2-5
class
Properties (continued)
Property name Description
child-class <1:8> {name Child class ID, which requires a name and an
<name> | include rule set for the parent class (see the include
downstream-bandwidth property). There can be up to eight child classes per
exclusive <0:100> application class.The child should have a related
[non-exclusive <0:100>] | include rule and its own bandwidth values, with the
include <val> | limitation that the sum of exclusive bandwidth
upstream-bandwidth percentages of all the children cannot exceed that of
exclusive <0:100> the parent.
[non-exclusive <0:100>]}
Example:
Casa Systems
2-6 RF Cable Configuration Guide and Command Reference
class
Properties (continued)
Property name Description
Example:
CASA(conf-app-class 1)#
downstream-bandwidth exclusive 16
non-exclusive 20
Casa Systems
Application classes and policies 2-7
class
Properties (continued)
Property name Description
include {BE | multicast Binds a rule to the application class or child class.
application-id <1:65535>... Required for a parent class when defining child
| packetcable [emergency | classes. The rules, which are evaluated in the order
normal] | they are defined, are the following:
pcmm {app-id <0:65535>... |
gate-priority <0:7>...} | • BE — Best effort (BE) service flow with a
sched-type [be] [nrtps] non-zero committed information rate (CIR).
[rtps] [ugs] [ugs-ad] | • multicast application-id <0:65535> — Applica-
service-class <name>...} tion policy ID or space-separated IDs of the mul-
ticast service flow, up to eight IDs.
• packetcable [emergency | normal] — Packet-
Cable call class, with the optional emergency or
normal service type. The emergency service pre-
empts the normal service once the parent class
reaches its maximum bandwidth. For emergency
calls, the exclusive threshold should be set to the
maximum voice calls allowed and the non-exclu-
sive threshold set to zero.
• pcmm {app-id <0:65535> | gate-priority <0:7>}
— PacketCable Multimedia (PCMM), with the
application ID or gate priority. The parent class
can list the child application policy IDs separated
by spaces, up to eight. Gate priority can also take
up to eight values. Set a low gate priority value for
priority services such as multicast streaming.
• sched-type {be | nrtps | rtps | ugs | ugs-ad} —
Quality of service (QoS) class schedule type, as
best-effort (be), Non-Real-Time Polling Service
(nrtps), Real-Time Polling Service (rtps), Unso-
licited Grant Service (ugs), or UGS with Activity
Detection (ugs-ad), which can be combined.
• service-class <name> — Cable service class
name or names, space-separated up to 10.
Example:
Casa Systems
2-8 RF Cable Configuration Guide and Command Reference
class
Properties (continued)
Property name Description
Example:
CASA(conf-app-class 1)#
upstream-bandwidth exclusive 16
non-exclusive 20
Examples
The following example shows an application class with exclusive and non-exclusive
downstream bandwidth thresholds adding up to 30%. The subsequently defined child
class combined bandwidths exceeded this amount, resulting in an error.
Casa Systems
Application classes and policies 2-9
class
In the following example, the parent class thresholds add up to 30%, the individual
child class thresholds add up to no more then 30%, and the totaled child exclusive
thresholds add up to no more than the 10% defined for the parent. This is acceptable.
The non-exclusive thresholds do not have this limitation and can be higher. The count
values show that no modem has yet come online.
In the following example, two identical application classes are defined. The CMTS
evaluates the include rules in order and picks the service-class definitions from the
first class. In so doing, it pegs the accept count to 14 (the two downstream flows times
the seven modems coming online) for the first application class only, and not for the
second. The additional show cable modem qos output shows the upstream and
downstream service-classes for one of the modems that were used in the evaluation.
Casa Systems
2-10 RF Cable Configuration Guide and Command Reference
class
application class 2
name Wave3
include service-class STMrule_DWN.2 STMrule_DWN.1
include pcmm app-id 5
include BE
downstream-bandwidth exclusive 29 non-exclusive 29
child-class 1 name Wave3_CC_1
child-class 1 include pcmm app-id 1 5
child-class 1 downstream-bandwidth exclusive 5 non-exclusive 0
child-class 2 name Wave3_CC_2
child-class 2 include pcmm app-id 2 3
child-class 2 downstream-bandwidth exclusive 20
child-class 3 name Wave3_CC_3
child-class 3 include pcmm app-id 3
child-class 3 downstream-bandwidth exclusive 1
child 1 : accept 0, deny 0, dcc 0, force free 0
child 2 : accept 0, deny 0, dcc 0, force free 0
child 3 : accept 0, deny 0, dcc 0, force free 0
total : accept 0, deny 0, dcc 0, force free 0
Casa Systems
Application classes and policies 2-11
class
cable traffic-policy
Shows the configured application classes. See the “Examples” above. The child and
total accept and deny counts at the bottom of the output are for currently active calls
(that can be synced with admission-control).
Shows the PacketCable Multimedia (PCMM) configuration, if any. The gateid value
to obtain the classifier, gate specification and traffic profile output can be derived
from the multicast output. The ps server identifies the Common Open Policy Service
(COPS) server address, port, and version, as set by the cops pdp-ip command. Up to
128 COPS servers can be configured.
Casa Systems
2-12 RF Cable Configuration Guide and Command Reference
policy
policy
Purpose
There are three ways to trigger multi-link trunking (MLT) for dynamic channel
changes (DCCs) using an application policy:
Mode
(conf-app-policy <1:32>)#
Syntax
[no] limit replication [override]
max iptv channel <0:2>
[no] monitor threshold min-rate-ratio <1:100>
Casa Systems
Application classes and policies 2-13
policy
Properties
Property name Description
Example:
max iptv channel <0:2> Sets the optional maximum Internet Protocol
Television (IPTV) channels the CM is allowed to join,
with 0 disabling the feature.
Example:
Example:
Example
The following commands configure identifying multicast sessions that match group
address 230.0.1.0/24 as limited multicast sessions. (See also Chapter 12, “Multicast
cable operations.”)
Casa Systems
2-14 RF Cable Configuration Guide and Command Reference
policy
application policy 1
Shows multicast replication, including for type DSG, DEF, and IPTV.
Casa Systems
3-1
BPI+ is required on all DOCSIS 1.1 (and later) compliant CMs. Earlier CMs use BPI.
Note: Enabling BPI reduces performance and can cause fluctuations in the
upstream throughput rates.
Casa Systems
3-2 RF Cable Configuration Guide and Command Reference
BPI commands description
Configuration summary
Table 3-1 lists and briefly describes the objects related to BPI and BPI+.
cable privacy Sets the privacy mode for, and enforces, BPI.
cable sa-des-tlvlen-2 Sets the security association TLV length as required by
some BPI-authenticated CMs.
privacy hotlist Adds entries to the privacy hotlist to mark a CM’s or
manufacturer’s certificate as distrusted.
shared-secondary-secret Configures an authentication shared secondary encryption
key.
shared-secret Configures an authentication shared primary encryption
key.
Casa Systems
Baseline Privacy Interface 3-3
cable privacy
cable privacy
Purpose
The cable privacy command sets the privacy mode for, and enforces, BPI or BPI+.
The bpi-enforce and the bpi-plus-enforce parameters can be set concurrently in the
CMTS configuration, because each setting operates on different modem types.
Mode
(config)#
Syntax
[no] cable privacy 40-bit-des
[no] cable privacy add-certificate {manufacturer | root} <string>
[no] cable privacy bpi-enforce [mandatory]
[no] cable privacy bpi-plus-enforce [mandatory]
[no] cable privacy test-edrca-certificate
Properties
Property name Description
Example:
Casa Systems
3-4 RF Cable Configuration Guide and Command Reference
cable privacy
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Baseline Privacy Interface 3-5
cable privacy
Properties (continued)
Property name Description
Example:
interface docsis-mac
privacy
Configures Key Encryption Key (KEK) or Traffic Encryption Key (TEK) lifetime on
a MAC domain interface for BPI. Each lifetime is from 1–604800 seconds. (See the
DOCSIS MAC interface privacy property.)
qos-profile
The qos-profile command example includes a property for specifying whether BPI is
used in a quality of service (QoS) profile, either true or false.
Casa Systems
3-6 RF Cable Configuration Guide and Command Reference
cable privacy
• init(r2) — The CMTS received an initial ranging request from the CM. The
CMTS responded and returned RF power information, timing offset, and
frequency adjustments to the CM. The CM and CMTS link is still in the ranging
state, and ranging is not complete. Check the RF attenuations if initial ranging
remains stuck. Use the debug cable ranging command for information.
• init(ov) — CMTS is static load balancing and is using the upstream channel ID
override and/or downstream frequency override to move the modem to new
channel. Check the modem power if stuck in this state.
• init(rc) — CM ranging to the CMTS completed. Check the cable helper address
configuration and IP connectivity to the DHCP server. Use the debug cable dhcp
command for information. Note: It is also possible that the upstream is at capacity
and has no additional bandwidth for the CM to finish registration and come
online. If this is the case, make sure load balancing is enabled.
• init(ua) — Upstream channel adjustment (for DOCSIS 3.0 modems).
• init(d) — The CMTS received the DHCP discover message; the first IP broadcast
packet was received from the CM.
• init(i) — The CM received the DHCPOFFER reply from the DHCP server, but
the CM has not yet replied with a DHCPREQUEST message, nor has it sent an IP
packet with its assigned IP address. It is possible that the CM received the
DHCPOFFER reply from the DHCP server, but the reply might have invalid
options for that particular CM.
• init(e) — Early authentication and encryption started (D3.0 modems). Check the
modem certificate if stuck in this state.
• init(t) — Time-of-day (TOD) exchange on the configuration file download has
started.
• init(o) — The CM began downloading the DOCSIS configuration file from the
provisioning server. If the CM remains in this state, the download failed, possibly
due to incorrect or corrupt data, inability to reach the TFTP server (such as wrong
file permissions), or invalid or missing configuration parameters.
• init(r) — The CMTS received a register-request from the CM, but has not yet
received a reg-ack. If stuck, check the modem config file. Use the debug cable
registration command to debug the registration request received.
• init(bpi) — Starts baseline privacy. If stuck in this state, check the modem
certificate and ensure that the CM is synchronized with the BPI server.
Casa Systems
Baseline Privacy Interface 3-7
cable privacy
• cc(r1) — The CM previously registered and was online, but the CMTS sent a
Dynamic Channel Change (DCC) or Upstream Channel Change (UCC) request
message to the CM. The CM started moving to the new channel, sending an initial
ranging request on the new downstream or upstream channel to the CMTS. At the
MAC layer, the CM is not yet passing traffic to the new channel and is considered
in the off-line state. This state does not trigger the flap-list counters.
• cc(r2) — This state normally follows cc(r1) and indicates that the CM finished its
initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is not yet passing traffic to
the new channel and is considered in the off-line state. This state does not trigger
the flap-list counters.
• offline — The CM is detected as off-line, disconnected, or powered off.
• offline(m) — The CM failed the Message Integrity Check (MIC) and was put
offline, which could indicate that the shared secret in the DOCSIS configuration
file does not match the value configured for the CM baseline privacy.
• online — The CM has registered; the CM is ready to pass data on the network.
• online(d) — The CM is registered. However, network access for CPE devices
using this CM was disabled by the DOCSIS configuration file. The CMTS
continues to communicate with the CM using DOCSIS messages and IP traffic
(such as SNMP) but the CM does not forward traffic to or from the CPE devices.
Note: If BPI was enabled in the DOCSIS configuration file sent to the CM, the
CM is using BPI encryption unless other messages indicate that the BPI
negotiation and key assignments failed.
• online(pk) — BPI is enabled and the key-encrypting key (KEK) is assigned.
• online(pkd) — BPI is enabled and the KEK is assigned, but network access for
CPE devices using this CM was disabled.
• online(pt) — BPI is enabled and the traffic-encrypting key (TEK) is assigned.
• online(ptd) — BPI is enabled and the TEK is assigned, but network access for
CPE devices using this CM was disabled.
• expire(pk) — BPI is enabled and the KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
Casa Systems
3-8 RF Cable Configuration Guide and Command Reference
cable privacy
• bpi(wait) — BPI wait state in which the affected modem is flapping and cannot
fully come back up, thus not forwarding data. If stuck in this state, reboot the
modem.
• reject(pk) — The KEK assignment is rejected and BPI encryption was not
established.
• reject(pkd) — The KEK assignment is rejected and BPI encryption was not
established, but network access for CPE devices using this CM was disabled.
• reject(pt) — TEK assignment is rejected with BPI encryption not established.
• reject(ptd) — The TEK assignment is rejected and BPI encryption was not
established, but network access for CPE devices using this CM was disabled.
# show cable modem
MAC Address IP Address US DS MAC Prim RxPwr
Intf Intf Status Sid (dBmV)
7cb2.1b42.x 10.200.0.154 2/0.0/0 0/0/3* online(pt) 1 -0.5
e448.c7ba.x 10.200.0.155 2/2.3/0* 0/1/6* online(pt) 1 -0.2
Timing Num BPI
Offset CPEs Enb
2429 0 yes
2382 0 yes
online cm 2 ; offline cm 0 ; ranging cm 0
Shows the capabilities, whether BPI is enabled, and the BPI encryption algorithm for
each MAC address.
Casa Systems
Baseline Privacy Interface 3-9
cable privacy
Shows BPI state information for online and offline modems, if BPI is enabled.
Shows one of the lifetime settings on a DOCSIS MAC interface for the Key
Encryption Key (KEK) and Traffic Encryption Key (TEK) required for BPI. The
value belongs to the previous interface, DOCSIS MAC 1 in this example.
interface docsis-mac 2
…
Casa Systems
3-10 RF Cable Configuration Guide and Command Reference
cable sa-des-tlvlen-2
cable sa-des-tlvlen-2
Purpose
The cable sa-des-tlvlen-2 command sets the security association (SA) type-length
value (TLV) length to two bytes as required by some BPI-authenticated CMs. These
modems may not register with the CMTS using a one-byte descriptor. The
sa-des-tlvlen-2 value is the default.
Mode
(config)#
Syntax
[no] cable sa-des-tlvlen-2
Casa Systems
Baseline Privacy Interface 3-11
privacy hotlist
privacy hotlist
Purpose
The privacy hotlist command adds entries to the privacy hotlist to mark a CM’s or
manufacturer’s certificate as distrusted and prevent those CMs from registering.
Mode
(config)#
Syntax
[no] privacy hotlist cm <mac_addr>
[no] privacy hotlist manufacturer <serial_num>
Properties
Property name Description
Example:
Example:
Casa Systems
3-12 RF Cable Configuration Guide and Command Reference
shared-secondary-secret
shared-secondary-secret
Purpose
Mode
(config)#
Syntax
shared-secondary-secret <1|2> <0|7> <key> [extend]
no shared-secondary-secret <1|2> [extend]
Properties
Property name Description
Example:
CASA(config)# shared-secondary-secret 1
0 DOCSIS extend
Casa Systems
Baseline Privacy Interface 3-13
shared-secret
shared-secret
Purpose
The CMTS supports up to 198 shared secrets (primary, secondary, and extended),
including those defined under the interface docsis-mac configuration.
Mode
(config)#
Syntax
shared-secret <0|7> <key> [extend]
no shared-secret <0|7> [extend]
Properties
Property name Description
Casa Systems
3-14 RF Cable Configuration Guide and Command Reference
shared-secret
Properties (continued)
Property name Description
Example:
Casa Systems
4-1
Provisioning servers at the headend are necessary for the CM to properly complete the
initialization process. The CM initiates a request to a DHCP server for an IPv4 or IPv6
address assignment. Once the CM is assigned an IP address, it submits a request to a
target TFTP server for the DOCSIS modem configuration file. The configuration file
provides operational information to the modem using parameters that are set by the
cable service provider, including program identification to the CMTS MAC domain.
The TFTP server responds to the request by forwarding and loading the configuration
file to the modem at the DHCP-assigned address. Optionally, the CM may request
time information from a time-of-day (ToD) server.
Casa Systems
4-2 RF Cable Configuration Guide and Command Reference
Cable commands description
Configuration summary
Table 4-1 lists and briefly describes the objects related to cable commands.
Casa Systems
Cable commands 4-3
Cable commands description
Casa Systems
4-4 RF Cable Configuration Guide and Command Reference
Cable commands description
Casa Systems
Cable commands 4-5
cable admission-control
cable admission-control
Purpose
The cable admission-control command enables (and sets global parameters for)
admission control, a mechanism that manages the service flow admission requests
when resources are not available to support the incoming service flow. It allows
mapping different service flow types into different application classes with defined
attribute rules. If the bandwidth resource for the application class is not available for
the upstream or downstream channel, the new service flow request is rejected.
Mode
(config)#
Syntax
[no] cable admission-control
[no] cable admission-control cm-registration
[no] cable admission-control dynamic-service [exceed {dcc | reject}]
[no] cable admission-control multicast
[no] cable admission-control preempt priority-voice
Casa Systems
4-6 RF Cable Configuration Guide and Command Reference
cable admission-control
Properties
Property name Description
Example:
Example:
Example:
Casa Systems
Cable commands 4-7
cable admission-control
Properties (continued)
Property name Description
Example:
Example
CASA(config)# cable admission-control cm-registration
CASA(config)# cable admission-control dynamic-service exceed dcc
CASA(config)# application class 4
CASA(conf-app-class 4)# downstream-bandwidth exclusive 100
CASA(conf-app-class 4)# upstream-bandwidth exclusive 100
CASA(conf-app-class 4)# include BE
CASA(conf-app-class 4)# include packetcable emergency
Shows admission control results for the particular downstream or upstream interface.
Casa Systems
4-8 RF Cable Configuration Guide and Command Reference
cable arp fast-timeout
The cable arp fast-timeout command prevents ARP entry from timing out and being
removed from the ARP table if no responses are received after six consecutive
attempts. If this feature is enabled, the SMM ARP still does round robin polling, but if
an ARP reply is not received in eight seconds, SMM ARP polls it again up to two
more times, each eight seconds after the previous request. If no ARP reply is received
at the end of the eight-second interval of the last request, the ARP entry of the CPE is
removed. The default is fast-timeout not enabled.
Mode
(config)#
Syntax
[no] cable arp fast-timeout
Casa Systems
Cable commands 4-9
cable arp filter
The cable arp filter command sets the number of ARP response packets to accept
from the CM and CPE in a configured time window.
Mode
(config)#
Syntax
cable arp filter <0:20> <1:60>
no cable arp filter
Properties
Property name Description
Example:
Casa Systems
4-10 RF Cable Configuration Guide and Command Reference
cable call-signal-classifier
cable call-signal-classifier
Purpose
Mode
(config)#
Syntax
cable call-signal-classifier [source-port-range <0:65535> <0:65535>]
[dest-port-range <0:65535> <0:65535>]
Properties
Property name Description
Example:
CASA(config)# cable
call-signal-classifier
CASA(config)# cable
call-signal-classifier dest-port-range
30 50
Casa Systems
Cable commands 4-11
cable call-signal-classifier
Properties (continued)
Property name Description
source-port-range <0:65535> Source port range indicating the starting and ending
<0:65535> port numbers. A zero value for the starting range
indicates no starting value, and a zero value for the
ending range indicates no ending value. The starting
values must be lower than the ending values. The
source-port-range and dest-port-range can be
specified on the same command line.
Example:
CASA(config)# cable
call-signal-classifier
source-port-range 30 60 dest-port-range
70 90
Casa Systems
4-12 RF Cable Configuration Guide and Command Reference
cable dhcp filter
The cable dhcp filter command sets the number of DHCP response packets to accept
from the CM and CPE in a configured time window.
Mode
(config)#
Syntax
cable dhcp filter <0:255> <1:60>
no cable dhcp filter
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-13
cable dhcp-leasequery filter
The cable dhcp-leasequery filter command sets the number of DHCP leasequery
packets to send to the CM and CPE in a configured time window.
Mode
(config)#
Syntax
cable dhcp-leasequery filter <0:20> <1:4>
no cable dhcp-leasequery filter
Properties
Property name Description
Example:
Casa Systems
4-14 RF Cable Configuration Guide and Command Reference
cable dhcpv6-leasequery filter
Mode
(config)#
Syntax
cable dhcpv6-leasequery filter <0:20> <1:4>
no cable dhcpv6-leasequery filter
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-15
cable diaglog
cable diaglog
Purpose
Mode
(config)#
Syntax
[no] cable diaglog
[no] cable diaglog ranging
cable diaglog reg-detail-mask <0x0:0xffff>
cable diaglog reg-time-interval <60:86400>
[no] cable diaglog registration
Properties
Property name Description
Example:
Example:
Casa Systems
4-16 RF Cable Configuration Guide and Command Reference
cable diaglog
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
Cable commands 4-17
cable docsis version 31
The cable docsis version 31 command enables DOCSIS 3.1 for CMs. The setting
shows up when you run a show running-config verbose | include “cable docsis”
command.
Mode
(config)#
Syntax
[no] cable docsis version 31
Casa Systems
4-18 RF Cable Configuration Guide and Command Reference
cable dsx authorization
The cable dsx authorization command checks all Dynamic Service Change (DSX)
messages (DSA, DSC and DSD) for a valid gate ID authorization value. If the DSX
message is invalid, the CMTS rejects the message.
Mode
(config)#
Syntax
[no] cable dsx authorization
Casa Systems
Cable commands 4-19
cable dynamic-service-flow
cable dynamic-service-flow
Purpose
Mode
(config)#
Syntax
cable dynamic-service-flow bonding
cable dynamic-service-flow non-bonding
cable dynamic-service-flow primary
Properties
Property name Description
Example:
CASA(config)# cable
dynamic-service-flow bonding
Example:
CASA(config)# cable
dynamic-service-flow non-bonding
Casa Systems
4-20 RF Cable Configuration Guide and Command Reference
cable dynamic-service-flow
Properties (continued)
Property name Description
Example:
CASA(config)# cable
dynamic-service-flow primary
Casa Systems
Cable commands 4-21
cable ecn 770
The cable ecn 770 command enables CableLabs Engineering Change Notice (ECN)
770 to help keep modems from getting into the upstream partial service state when
there are a large number of modems attempting to register with the CMTS while the
CMTS is assigning and bonding channels to D3.0 modems. This feature is enabled by
default.
Some CMs end up in upstream partial service mode if there are collisions followed by
no additional attempts to range on the assigned upstream channels. Configuring
unicast ranging as the initial technique instead of the default broadcast ranging in
interface docsis-mac configuration, by using the initial-tech unicast-ranging
command, avoids any collisions and helps prevent modems from getting into
upstream partial service mode.
By enabling ECN 770, UCD encodings are included in the transmit channel
configuration (TCC) in the CMTS registration response to the prevent the partial
service problem. However, modems that are already in partial service mode must be
reset.
Mode
(config)#
Syntax
[no] cable ecn 770
Casa Systems
4-22 RF Cable Configuration Guide and Command Reference
cable event
cable event
Purpose
The cable event command enables generating and dispatching DOCSIS cable event
message notifications. This function is enabled by default. The cable event <id>
command controls the dispatching of DOCIS cable event messages by event ID. By
default, all cable event messages except 82010100 and 82010400 are enabled. Use the
show cable event running-config [brief] command to display the list of cable event
IDs.
Mode
(config)#
Syntax
[no] cable event
[no] cable event <0:4294967295>
[no] cable event <0:4294967295> delivery
[no] cable event priority {alert | critical | debug | emergency | error
| informational | notice | warning} <nonvol_flag> [<vol_flag>]
[no] cable event syslog-server <ip_addr> [port <1:65535>]
[no] cable event throttle-adminStatus {inhibited |
maintainBelowThreshold | stopAtThreshold | unconstrained}
[no] cable event throttle-interval <1:2147483647>
[no] cable event throttle-threshold <num>
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-23
cable event
Properties (continued)
Property name Description
Example:
Casa Systems
4-24 RF Cable Configuration Guide and Command Reference
cable event
Properties (continued)
Property name Description
priority {alert | critical Configures the event reporting flags for DOCSIS
| debug | emergency | error event messages, which determines how the CMTS
| informational | notice | reports these events. The reporting flags can be
warning} <nonvol_flag> alert, critical, debug, emergency, error,
[<vol_flag>] informational, notice, or warning. The flag values
(in hex) designate how messages are handled. The
first value is the non-volatile (flash) flag and the
second optional value can be 0x00 or 0x80 for the
local volatile (memory) log flag:
Example:
Casa Systems
Cable commands 4-25
cable event
Properties (continued)
Property name Description
Example:
Casa Systems
4-26 RF Cable Configuration Guide and Command Reference
cable event
Properties (continued)
Property name Description
Example:
Example:
Shows all the cable events in reverse chronological order. Because of the shear
volume of output, use this command sparingly.
Casa Systems
Cable commands 4-27
cable event
Shows the list of cable events in the running configuration, with the added brief
option.
Casa Systems
4-28 RF Cable Configuration Guide and Command Reference
cable event
Casa Systems
Cable commands 4-29
cable flap-list
cable flap-list
Purpose
The cable flap-list command enables detecting abnormal CMs in the network and
providing a list of malfunctioning ones to help identify the problem.
Mode
(config)#
Syntax
cable flap-list add {<mac_addr> | all | downstream <slot>/<port>/
<chan> | ofdm <slot>/<port>/<chan> | ofdma <slot>/<port>.<pchan>
| upstream <slot>/<port>.<pchan>/<lchan>}
cable flap-list aging {<15:86400> | default}
cable flap-list check-interval {<1:1200> | default}
[no] cable flap-list insertion-time {<1:120> | default}
[no] cable flap-list miss threshold {<3:12> [<60:65535>] | default}
[no] cable flap-list power-adjust threshold {<1:20> | default}
[no] cable flap-list trap
Properties
Property name Description
add {<mac_addr> | all | Adds a flap list to a specific MAC address, all
downstream <slot>/<port>/ modems, or a specific downstream, OFDM, OFDMA,
<chan> | ofdm <slot>/ or upstream interface.
<port>/<chan> | ofdma
<slot>/<port>.<pchan> | Example:
upstream <slot>/
<port>.<pchan>/<lchan>} CASA(config)# cable flap-list add
downstream 4/0/2
Casa Systems
4-30 RF Cable Configuration Guide and Command Reference
cable flap-list
Properties (continued)
Property name Description
Example:
check-interval {<1:1200> | Interval for the CMTS to scan the flap list table,
default} default 120 minutes (2 hours). If the CMTS finds any
CM that reached the aging limit, the CMTS removes
it from the flap list table. When the CM is removed,
the user cannot check the CM’s flap-list information.
Example:
Example:
Casa Systems
Cable commands 4-31
cable flap-list
Properties (continued)
Property name Description
miss threshold {<3:12> When the CMs do not reply to the maintenance
[<60:65535>] | default} message sent from the CMTS after the specified
number of times, they are put in the flap list table for
observation. The default is 6 times. The optional
second parameter is the maximum number of
maintenance messages, default 90.
Example:
power-adjust threshold After the CMs come online and the status is stable, if
{<1:20> | default} the power adjustment from the CMTS to the CMs is
greater than the specified unit of dB, the CMs are
moved to the flap list table for observation. The
default is 2 dB.
Example:
Example:
Casa Systems
4-32 RF Cable Configuration Guide and Command Reference
cable flap-list
Clears all cable flap lists. The optional delete modifier deletes all flap list CM records,
and the reset modifier resets all flap list counters.
Shows the cable flap list. A number of sort options are available.
Casa Systems
Cable commands 4-33
cable host authorization
Mode
(config)#
Syntax
[no] cable host authorization <mac_addr> {<ip_addr> | <ip6_addr>} [vrf
<name>]
Properties
Property name Description
<mac_addr> {<ip_addr> | MAC address and the IPv4 or IPv6 address of the
<ip6_addr>} [vrf <name>] CM, with the optional VRF name.
Example:
Casa Systems
4-34 RF Cable Configuration Guide and Command Reference
cable icmp filter
The cable icmp filter command sets the number of Internet Control Message Protocol
(ICMP) response packets to accept from the CM and CPE in a time window.
Mode
(config)#
Syntax
[no] cable icmp filter <0:255> <1:60>
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-35
cable igmp filter
The cable igmp filter command sets the number of Internet Group Management
Protocol (IGMP) response packets to accept in a configured time window.
Mode
(config)#
Syntax
[no] cable igmp filter <1:5000> <1:60>
Properties
Property name Description
Example:
Casa Systems
4-36 RF Cable Configuration Guide and Command Reference
cable igmp permit src-ip
The cable igmp permit src-ip command sets the permit filter for the Internet Group
Management Protocol (IGMP) packet source address. Situations may occur where
certain D2.0 STBs send IGMP join packets using a private NAT source IP address
instead of the external CPE IP address obtained via DHCP. The command bypasses
the source address verification (SAV) check for the given prefix in order to accept the
private NAT source IP address.
Mode
(config)#
Syntax
[no] cable igmp permit src-ip <ip_addr> <ip_mask>
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-37
cable igmp static-group
The cable igmp static-group command creates a static multicast session for IGMP
any-source-multicast.
Modes
(config)#
(conf-igmp-static-group <addr>)#
Syntax
(config)#
[no] cable igmp static-group {<ip_addr> | ipv6 <v6_addr>}
[source <ip_addr>] [dsid <85689:86688>]
(conf-igmp-static-group x)#
[no] description “<text>”
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
{<ip_addr> | ipv6 Valid multicast group IP address for the static group.
<v6_addr>}
Example:
Casa Systems
4-38 RF Cable Configuration Guide and Command Reference
cable igmp static-group
Properties (continued)
Property name Description
Example:
Example:
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
description “First static group”
CASA(conf-igmp-static-group 224.0.0.0)#
no description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
qam 2/0/0
CASA(conf-igmp-static-group 224.0.0.0)#
no qam 2/0/0
Casa Systems
Cable commands 4-39
cable igmp static-group
Casa Systems
4-40 RF Cable Configuration Guide and Command Reference
cable igmp vrf static-group
The cable igmp vrf static-group command creates a Virtual Routing and Forwarding
(VRF) static group instance for IGMP.
Modes
(config)#
(conf-igmp-static-group x)#
Syntax
(config)#
[no] cable igmp vrf <vpn_id> static-group <ip_addr> [source <ip_addr>]
[dsid <85689:86688>]
(conf-igmp-static-group x)#
[no] description “<text>”
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
Casa Systems
Cable commands 4-41
cable igmp vrf static-group
Properties (continued)
Property name Description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
description “First static group”
CASA(conf-igmp-static-group 224.0.0.0)#
no description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
qam 2/0/0
CASA(conf-igmp-static-group 224.0.0.0)#
no qam 2/0/0
Casa Systems
4-42 RF Cable Configuration Guide and Command Reference
cable map-advance-adjust
cable map-advance-adjust
Purpose
The cable map-advance-adjust command adjusts the MAP lead time globally for all
upstream cards, which addresses some DOCSIS 3.x CMs that require longer MAP
lead times. MAP advance for the upstream interface defines the amount of look-ahead
time for MAPs based on the plant characteristics. The system already has a built-in
look-ahead time to account for internal operations like generating the MAP. The
adjustment can range -1000 through 5000 microseconds, the default 0. (See also the
interface upstream map-advance property.) The show run verbose command
shows the current setting (see Example).
Mode
(config)#
Syntax
[no] cable map-advance-adjust <-1000:5000>
Example
CASA(config)# cable map-advance-adjust 500
CASA(config)# show run verbose | include “cable map-advance”
cable map-advance-adjust 500
Casa Systems
Cable commands 4-43
cable mdd
cable mdd
Purpose
The cable mdd command enables the CMTS to inform registered CMs through the
MAC Domain Descriptor (MDD) that it supports extended transmission power over
upstream channels, or fragmented RCC/RCP TLV packet transmissions if the RCP
length exceeds 255.
Mode
(config)#
Syntax
[no] cable mdd cm-status-ack support
[no] cable mdd extended tx-power support <0|1>
[no] cable mdd rcp {fragment | verbose} support
Properties
Property name Description
Example:
Example:
Casa Systems
4-44 RF Cable Configuration Guide and Command Reference
cable mdd
Properties (continued)
Property name Description
Example:
Shows the extended transmission power support. With extended transmission power
support enabled, debug output shows “Extended Upstream Transmit Power
Capability(40):f4.”
Shows the MDD messages for a downstream channel, including the decoding and
initialization parameters.
Casa Systems
Cable commands 4-45
cable mdd
Casa Systems
4-46 RF Cable Configuration Guide and Command Reference
cable mirror
cable mirror
Purpose
The cable mirror command mirrors traffic from specified devices by setting the CM
or CPE MAC address being mirrored and the destination IPv4 address and UDP port
to which the mirrored traffic is sent. The command takes effect immediately.
Mode
(config)#
Syntax
[no] cable mirror <mac_addr> <dest_ip_addr> <1:65535>
Properties
Property name Description
<mac_addr> MAC address of the CPE or CM, with all data packets
captured and encapsulated to one or the other.
<dest_ip_addr> Destination IP address of the mirror stream.
<1:65535> UDP port to assign the stream.
Example:
Casa Systems
Cable commands 4-47
cable modem
cable modem
Purpose
Modes
#
(config)#
Casa Systems
4-48 RF Cable Configuration Guide and Command Reference
cable monitor-period
cable monitor-period
Purpose
The cable monitor-period command sets the cable monitoring period. Casa Spectrum
Management (CSM) monitors the quality of all upstream channels by periodically
polling measured parameters of signal-to-noise ratio (SNR), correctable Forward
Error Corrections (FECs), and uncorrectable FECs.
Mode
(config)#
Syntax
cable monitor-period <5:3600>
Properties
Property name Description
Example:
Shows forward error correction (FEC) statistics for each upstream port.
Casa Systems
Cable commands 4-49
cable partial-service
cable partial-service
Purpose
Mode
(config)#
Syntax
[no] cable partial-service continue-ranging
[no] cable partial-service dbc-recovery <60:3600>
[no] cable partial-service reset-legacy-cm
[no] cable partial-service tx-power-deficit
[no] cable partial-service upstream-impairment [margin <1:10>]
Casa Systems
4-50 RF Cable Configuration Guide and Command Reference
cable partial-service
Properties
Property name Description
Example:
Example:
Example:
Casa Systems
Cable commands 4-51
cable partial-service
Properties (continued)
Property name Description
Example:
Casa Systems
4-52 RF Cable Configuration Guide and Command Reference
cable partial-service
Properties (continued)
Property name Description
Example:
Casa Systems
Cable commands 4-53
cable partial-service
Shows CMs in partial-service mode. Note the reason codes appended to the US/DS
CHAN EXCLUDED column. Output can also be filtered by MAC address,
downstream or upstream, or service-group.
Casa Systems
4-54 RF Cable Configuration Guide and Command Reference
cable privacy
cable privacy
Purpose
Casa Systems
Cable commands 4-55
cable proxy-arp unknown
The cable proxy-arp unknown command is implemented for fixed IP remote host
deployments in which the CMTS does not have an ARP binding to an IP address in
the ARP table. When configured, the CMTS responds to an ARP request for an
unknown IP address in the IP bundle with the proxy ARP gateway MAC address.
The additional subnet option stipulates that the ARP request is for an IP address in an
unknown subnet to allow the CMTS to respond to ARP requests from CPE devices
which are outside the IP bundle address scope. The enhancement addresses situations
where CPE devices cannot register due to the CMTS not responding to ARP requests
from unknown IP address subnets. The default setting is disabled. Note that the IP
bundle ip address <addr> proxy-arp unknown subnet setting, if used, takes
precedence over this global setting.
Mode
(config)#
Syntax
[no] cable proxy-arp unknown [subnet]
Casa Systems
4-56 RF Cable Configuration Guide and Command Reference
cable qos
cable qos
Purpose
The cable qos command sets quality of service (QoS) options for the CM. The class
property defines the service classes based on bandwidth priority for downstream and
upstream traffic. Normally, bandwidth is assigned in strict priority based on one of 10
priority levels assigned in the configuration file for the CM. Weighted fair queuing
(WFQ) takes one or more of the lower eight priority service classes and assigns a
weight to each one, such that the block of available bandwidth for those classes is
“fairly” and proportionally assigned among them. The method is described in more
detail in the “Weighted fair queuing” section.
Mode
(config)#
Syntax
[no] cable qos class {ds | us} <0:7> {flow-wfq {enable | max-rate
<1000:2147483647>} | weight <1:100>}
cable qos ds scheduler mode {guaranteed-plus | normal}
[no] cable qos temp-us-sf <svclass_name>
cable qos us scheduler mode {guaranteed-plus | normal}
Casa Systems
Cable commands 4-57
cable qos
Properties
Property name Description
class {ds | us} <0:7> Sets the QoS class for the downstream or upstream
{flow-wfq {enable | service. The DOCSIS priority is from 0–7, with 7 the
max-rate <1000:2147483647>} default highest priority. The Weighted Fair Queuing
| weight <1:100>} (WFQ) scheduling algorithm prioritizes weighted
multiple traffic queues that share the same link
capacity (Release 6.4) and the US and DS service
flows within a single queue (Release 6.5.). The
weight is the bandwidth allocation, in ticks. (See
“Weighted fair queuing” for details.) The flow-wfq is
service flow WFQ, which can be enabled and its
maximum traffic rate set, in bits per second. For
details on service flow WFQ, see “Service flow
weighted fair queuing.”
Example:
Example:
Example:
Casa Systems
4-58 RF Cable Configuration Guide and Command Reference
cable qos
Properties (continued)
Property name Description
Example:
In best-effort (BE) weighted fair queuing (using the weight property), the WFQ
scheduler allows contention bandwidth to be allocated across different queues at their
levels based on assigned weights. The CMTS essentially treats all the classes with
WFQ weights assigned with the same block of available remaining bandwidth and
proportions them “fairly” among the classes. All the service flows in each class
assume the aggregated weight from the service class and are treated equally.
For example, if QOS classes 2,3,4,5 have a weight configured, the scheduler services
the DOCSIS MAC (9) and guaranteed bandwidth (8) classes, then classes 7, 6, 1, and
0 in a strict priority fashion. It then services WFQ classes 5, 4, 3, and 2 round-robin
until they either exhaust their quota or it finds the queue empty. Each of the WFQ
Casa Systems
Cable commands 4-59
cable qos
classes is assigned a weight from 0 – 100, which determines the bandwidth proportion
for each class. The effective bandwidth assigned to each service class then becomes a
percentage in terms of the ratio of its weight to the total of all the weights assigned
with the WFQ policy.
Service flow level WFQ (using the flow-wfq property) supports finer grained
bandwidth allocation control than BE WFQ in that it can address individual service
flows in a single queue. If enabled for a particular queue level and when there is
bandwidth contention, bandwidth will be allocated to different service flows within
the queue based on the service flow’s assigned maximum sustained rate.
The maximum sustained rate can be determined with the show cable modem qos
command.
Casa Systems
4-60 RF Cable Configuration Guide and Command Reference
cable qos
Scheduler modes
The default normal scheduling mode satisfies the minimum and maximum
guaranteed rate service flows, and does best-effort round-robin scheduling once the
minimum rate is fulfilled. For example, if there are two service flows (SFs) on a
channel (at maximum 38 Mbps), when 50 Mbps is sent on both streams, they each get
38/2 = 19 Mbps:
Shows the cable QoS downstream or upstream weight (bandwidth allocation) using
the Weighted Fair Queuing (WFQ) scheduling algorithm. In the example, the CMTS
uses the strict priority until it reaches priorities 4, 3, and 2, when it uses the WFQ
algorithm based on the weights set, with priority 4 having the largest weight.
7 Strict Priority -
6 Strict Priority -
5 Strict Priority -
4 Weighted Fair Queue 80
3 Weighted Fair Queue 40
Casa Systems
Cable commands 4-61
cable qos
Shows the cable QoS downstream or upstream weight (bandwidth allocation) using
the service flow WFQ scheduling algorithm. In this example, only priority 7 is
enabled to use the algorithm. If a maximum sustained traffic rate is not set for a
service flow in that class, it uses the defined default maximum rate.
7 Enabled 20000000
6 Disabled Not Set
5 Disabled Not Set
4 Disabled Not Set
3 Disabled Not Set
2 Disabled Not Set
1 Disabled Not Set
0 Disabled Not Set
Casa Systems
4-62 RF Cable Configuration Guide and Command Reference
cable rcp-select priority
The cable rcp-select priority command sets the priority for the Receive Channel
Profile (RCP) selection for the CM. (See also the rcp command in Chapter 6,
“Channel bonding.”)
Mode
(config)#
Syntax
[no] cable rcp-select <string> priority <1:100>
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-63
cable sa-des-tlvlen-2
cable sa-des-tlvlen-2
Purpose
The cable sa-des-tlvlen-2 command sets the security association TLV length to two
bytes as required by some BPI-authenticated CMs. These modems may not be able to
register with the CMTS using a one-byte descriptor. The sa-des-tlvlen-2 value is the
default.
Casa Systems
4-64 RF Cable Configuration Guide and Command Reference
cable sec
cable sec
Purpose
The cable sec command sets the following modem security properties:
Mode
(config)#
Syntax
[no] cable sec cert-revocation-list {refresh-interval <1:524160> | url
<url_addr>}
[no] cable sec cert-revocation-method {crl | crlAndOcsp | none | ocsp}
[no] cable sec config-file-learning
[no] cable sec eae-exclusion <1:4294967295> <mac_addr> [<mask>]
cable sec encrypt_alg_priority [aes128CbcMode] [des40CbcMode]
[des56CbcMode]
[no] cable sec modem-cert check
[no] cable sec ocsp {protocol-url <url> | signature-bypass}
[no] cable sec sav-auth-enable
[no] cable sec sav-cfg-list <name> <1:4294967295> {<ip4_addr>/<mask> |
ipv6 <ip6_addr>/<prefix>} [vrf <name>]
cable sec tftp-options {both | hw-addr | net-addr | none}
Casa Systems
Cable commands 4-65
cable sec
Properties
Property name Description
Example:
Example:
Casa Systems
4-66 RF Cable Configuration Guide and Command Reference
cable sec
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
Cable commands 4-67
cable sec
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
4-68 RF Cable Configuration Guide and Command Reference
cable sec
Properties (continued)
Property name Description
Example:
Casa Systems
Cable commands 4-69
cable sec
Casa Systems
4-70 RF Cable Configuration Guide and Command Reference
cable sec
Shows the CM’s OCSP properties. Output can also be filtered by protocol-url or
signature-bypass.
Shows the CM’s Source Address Verification (SAV) configuration rules. Output can
also be filtered by name and rule ID.
Shows the CM’s TFTP proxy configuration. Note that during a CMTS reset, the TFTP
option should be set to none when downloading the config file.
Casa Systems
Cable commands 4-71
cable service attribute withhold-TLVs peak-rate
Mode
(config)#
Syntax
[no] cable service attribute withhold-TLVs peak-rate
Shows any peak traffic rate settings. Output can also be brief or verbose.
Casa Systems
4-72 RF Cable Configuration Guide and Command Reference
cable service-class
cable service-class
Purpose
The cable service-class command sets parameters for DOCSIS cable service classes.
Service classes support the QoS profile number, traffic priority, maximum upstream
bandwidth, guaranteed upstream bandwidth, maximum downstream bandwidth,
maximum transmit burst length, baseline privacy enable/disable, and type of service
(ToS) overwrite byte. The service class requires an ID and a name.
Modes
(config)#
(conf-service-class <id>)# | (conf-default-ugs)#
Syntax
(config)# [no] cable service-class {<1:1024> | default_ugs}
(conf-service-class x)#
[(conf-default-ugs)#]
name <name>
activity-timeout <0:65535>
admission-timeout <0:65535>
app-id <0:4294967295>
attr-aggr-rule-mask <0x0:0xffffffff>
downstream
ds-resequencing {noResequencingDsid | resequencingDsid}
dscp-overwrite <-1:63>
forbidden-attr-mask <0x0:0xffffffff>
grant-interval <0:4294967295>
grant-jitter <0:4294967295>
grant-size <0:65535>
grants-per-interval <0:127>
max-buff-size <0:4294967295>
max-concat-burst <0:65535>
max-latency <0:4294967295>
max-outstanding-bytes-per-sid-cluster <0:4294967295>
max-req-per-sid-cluster <0:255>
max-time-in-sid-cluster <0:65535>
max-tot-bytes-req-per-sid-cluster <0:4294967295>
max-traffic-burst <1522:4294967295>
max-traffic-rate <0:4294967295>
min-buff-size <0:4294967295>
min-packet-size <0:65535>
min-reserved-rate <0:4294967295>
Casa Systems
Cable commands 4-73
cable service-class
multiplier-bytes-req <bytes>
multiplier-contention-req-window <4:12>
peak-traffic-rate <0:4294967295>
poll-interval <0:4294967295>
poll-jitter <0:4294967295>
priority <0:7>
req-trans-policy <0x0:0xffffffff>
required-attr-mask <0x0:0xffffffff>
sched-type {bestEffort | nonRealTimePollingService |
realTimePollingService | undefined | unsolicitedGrantService
| unsolicitedGrantServiceWithAD}
storage-type {nonVolatile | other | permanent | readOnly |
volatile}
tar-buff-size <0:4294967295>
tos-overwrite <0x0:0xff> <0x0:0xff>
upstream
Properties
Property name Description
{<1:1024> | default_ugs} Service class ID, or the default QoS for the
Unsolicited Grant Service (UGS).
Example:
CASA(config)# cable
service-class 1
CASA(conf-service-class 1)#
CASA(config)#
no cable service-class 1
Example:
Casa Systems
4-74 RF Cable Configuration Guide and Command Reference
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
activity-timeout 600
Example:
CASA(conf-service-class 1)#
admission-timeout 600
Example:
CASA(conf-service-class 1)#
app-id 21345
Example:
CASA(conf-service-class 1)#
attr-aggr-rule-mask 0x0
Example:
CASA(conf-service-class 1)#
downstream
Casa Systems
Cable commands 4-75
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
ds-resequencing
noResequencingDsid
Example:
CASA(conf-service-class 1)#
dscp-overwrite -1
Example:
CASA(conf-service-class 1)#
forbidden-attr-mask 0x0
Example:
CASA(conf-service-class 1)#
grant-interval 0
Example:
CASA(conf-service-class 1)#
grant-jitter 0
Casa Systems
4-76 RF Cable Configuration Guide and Command Reference
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
grant-size 0
Example:
CASA(conf-service-class 1)#
grants-per-interval 0
Example:
CASA(conf-service-class 1)#
max-buff-size 0
Example:
CASA(conf-service-class 1)#
max-concat-burst 40000
Casa Systems
Cable commands 4-77
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
max-latency 0
Example:
CASA(conf-service-class 1)#
max-outstanding-bytes-per-sid-
cluster 0
Example:
CASA(conf-service-class 1)#
max-req-per-sid-cluster 0
Example:
CASA(conf-service-class 1)#
max-time-in-sid-cluster 0
Example:
CASA(conf-service-class 1)#
max-tot-bytes-req-per-sid-cluster
0
Casa Systems
4-78 RF Cable Configuration Guide and Command Reference
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
max-traffic-burst 40000
Example:
CASA(conf-service-class 1)#
max-traffic-rate 0
Example:
CASA(conf-service-class 1)#
min-buff-size 0
Example:
CASA(conf-service-class 1)#
min-packet-size 0
Example:
CASA(conf-service-class 1)#
min-reserved-rate 0
Casa Systems
Cable commands 4-79
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
multiplier-bytes-req 4
Example:
CASA(conf-service-class 1)#
multiplier-contention-req-window
8
Example:
CASA(conf-service-class 1)#
peak-traffic-rate 0
Example:
CASA(conf-service-class 1)#
poll-interval 0
Casa Systems
4-80 RF Cable Configuration Guide and Command Reference
cable service-class
Properties (continued)
Property name Description
Example:
CASA(conf-service-class 1)#
poll-jitter 0
Example:
CASA(conf-service-class 1)#
priority 0
Example:
CASA(conf-service-class 1)#
req-trans-policy 0x0
Example:
CASA(conf-service-class 1)#
required-attr-mask 0x0
Casa Systems
Cable commands 4-81
cable service-class
Properties (continued)
Property name Description
CASA(conf-service-class 1)#
storage-type nonVolatile
Example:
CASA(conf-service-class 1)#
tar-buff-size 0
Example:
CASA(conf-service-class 1)#
tos-overwrite 0xff 0x0
Example:
CASA(conf-service-class 1)#
upstream
Casa Systems
4-82 RF Cable Configuration Guide and Command Reference
cable service-class
To apply the service class parameters, specify the service class name in TLV 24/25.4.
Example
Main
{
NetworkAccess 1;
UsServiceFlow
{
UsServiceFlowRef 1;
QosParamSetType 7;
ServiceClassName "test"; >specify name here
SchedulingType 2;
}
DsServiceFlow
{
DsServiceFlowRef 3;
ServiceClassName "test-ds"; >specify name here; suppose you defined a
service class name "test-ds "on cmts
QosParamSetType 7;
}
MaxCPE 8;
GlobalPrivacyEnable 0;
/* CmMic 1be76c7df4777d078f76a3eb45d650d5; */
/* CmtsMic 6cf3523752bbd5bd627bb05460f1ff27; */
/* EndOfDataMkr*/
/* Pad */
}
Shows the cable service class activity. Output can also be filtered by service-class ID
or default Unsolicited Grant Service (UGS) data grant.
Casa Systems
Cable commands 4-83
cable service-class
Casa Systems
4-84 RF Cable Configuration Guide and Command Reference
cable service-flow active-timeout
Mode
(config)#
Syntax
cable service-flow active-timeout <0:600> [force-delete]
no cable service-flow active-timeout
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-85
cable service-type-id ds-frequency
The cable service-type-id ds-frequency command moves D2.0 CMs between two
CMTS platforms. The command configures up to 128 frequency entries. Traffic on
these downstream frequencies that are not matched to a service-group on the local
CMTS are moved to the other CMTS. There can be up to 524,288 service flows, with
up to 120,000 for DCU, 65525 per 8x8 card, and 174,080 per 8x96 card. Use the show
cable service-type-id command to display the ID settings.
Mode
(config)#
Syntax
[no] cable service-type-id <id> ds-frequency <47000000:999000000>
Properties
Property name Description
Casa Systems
4-86 RF Cable Configuration Guide and Command Reference
cable spectrum
cable spectrum
Purpose
The cable spectrum command sets spectrum management properties for the CM.
Forward-hopping from QPSK to 32QAM, 64QAM or 16QAM takes place depending
on the calculated SNR and thresholds, unless back-hopping is applied.
Mode
(config)#
Syntax
cable spectrum back-hop-step
cable spectrum cm-mode-monitor-period <5:3600>
cable spectrum hop-period <5:3600>
cable spectrum monitor-period <5:3600>
cable spectrum syslog
[no] cable spectrum trap
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-87
cable spectrum
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Example:
Casa Systems
4-88 RF Cable Configuration Guide and Command Reference
cable spectrum
Casa Systems
Cable commands 4-89
cable subscriber over-consume trap
The cable subscriber over-consume trap command sets a trap for subscribers who
exceeded the maximum allowed bandwidth.
Mode
(config)#
Syntax
[no] cable subscriber over-consume trap
Casa Systems
4-90 RF Cable Configuration Guide and Command Reference
cable tag
cable tag
Purpose
The cable tag command defines a cable tag and sets its properties. Cable tagging
allows restricted load balancing (RLB) of policy-based traffic based on how modems
are classified. The command sets the attributes that classifies a matching modem type
to a unique Load balancing policy at the CMTS. Each cable tag is identified by a
unique name and can include up to eight attributes for DOCSIS version and device
class, organizationally unique identifier (OUI), priority, service type identifier, and
type length value (TLV).
Modes
(config)#
(conf-cable-tag <name>)#
Syntax
(config)# [no] cable tag <name>
(conf-cable-tag x)#
[no] docsis device class {eMTA | eSTB}
[no] docsis version {docsis10 | docsis11 | docsis20 | docsis30 |
docsis31}
[no] oui <xx:xx:xx>
priority <1:2560>
[no] service-type-id <name>
tlv ext-upstream-freq-range {0 | 1}
no tlv ext-upstream-freq-range
Properties
Property name Description
Example:
Casa Systems
Cable commands 4-91
cable tag
Properties (continued)
Property name Description
docsis device class Sets the DOCSIS device class for the cable tag,
{eMTA | eSTB} either eMTA for embedded Multimedia Terminal
Adapter (MTA), or eSTB for embedded Set-Top Box
(STB).
Example:
docsis version {docsis10 Sets the DOCSIS version to DOCSIS 1.0, 1.1, 2.0,
| docsis11 | docsis20 | 3.0, or 3.1.
docsis30 | docsis31}
Example:
Example:
priority <1:2560> Sets the tag priority, unique across the system,
default 1. When more than one cable tag is present in
the configuration, the tag with the highest priority is
selected first.
Example:
Casa Systems
4-92 RF Cable Configuration Guide and Command Reference
cable tag
Properties (continued)
Property name Description
Example:
CASA(conf-cable-tag TAG1)#
service-type-id plant1
CASA(conf-cable-tag TAG1)#
no service-type-id plant1
Example:
Shows the cable tag settings, optionally for a specific tag name.
Casa Systems
Cable commands 4-93
cable tcc us-bonding-disable
Mode
(config)#
Syntax
[no] cable tcc us-bonding-disable
Casa Systems
4-94 RF Cable Configuration Guide and Command Reference
cable traffic-policy
cable traffic-policy
Purpose
Modes
(config)#
(traffic-policy <name>)#
Syntax
(config)# [no] cable traffic-policy <name>
(traffic-policy x)#
channel-utilization-threshold <0:100>
downstream
duration <10:1440> [sample-interval <5:60>] [avg-rate
<1:4294967295>]
[no] enable
enforce {max-traffic-rate <1:4294967295> [no-persistence] |
percentage <1:100>} [no-persistence] | priority <0:7>}
max-traffic-rate <0:4294967295>
[no] peak-time1 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time2 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time3 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time4 {daily | weekday | weekend} <0:23> duration
<60:1440>
penalty-enforce {all-day | peak-only}
penalty-period <5:10080>
upstream
Casa Systems
Cable commands 4-95
cable traffic-policy
Properties
Property name Description
Example:
Example:
CASA(traffic-policy TRPOL1)#
channel-utilization-threshold 70
Example:
Example:
Casa Systems
4-96 RF Cable Configuration Guide and Command Reference
cable traffic-policy
Properties (continued)
Property name Description
Example:
Example:
Example:
CASA(traffic-policy TRPOL1)#
max-traffic-rate 600
Casa Systems
Cable commands 4-97
cable traffic-policy
Properties (continued)
Property name Description
peak-time1 {daily | Sets the first peak time in a day, and can be set daily,
weekday | weekend} weekdays, or weekends, followed by the hour start
<0:23> duration time and duration in minutes, with the duration not
<60:1440> crossing midnight.
Example:
peak-time2 {daily | Sets the second peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
peak-time3 {daily | Sets the third peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
Casa Systems
4-98 RF Cable Configuration Guide and Command Reference
cable traffic-policy
Properties (continued)
Property name Description
peak-time4 {daily | Sets the fourth peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
Example:
CASA(traffic-policy TRPOL1)#
penalty-enforce all-day
Example:
CASA(traffic-policy TRPOL1)#
penalty-period 1440
Example:
Casa Systems
Cable commands 4-99
cable traffic-policy
Shows the cable subscriber usage, which depends on a traffic policy being defined.
The optional over-consume modifier shows only those subscribers who exceeded
their maximum allowed bandwidth. Output can also be filtered by MAC address and
DOCSIS MAC domain (with an added service-group filter).
This command shows an asterisk (*) in the Prio (priority) or MaxSusRate (maximum
sustain rate) columns for those CMs under traffic priority enforcement penalty based
on the subscriber traffic management (STM) rule. A penalized modem exceeds the
average rate for the configured duration period and where the enforce priority setting
is applied when setting the cable traffic-policy.
Casa Systems
4-100 RF Cable Configuration Guide and Command Reference
cable upstream
cable upstream
Purpose
Mode
(config)#
Syntax
cable upstream hi-power <0:6>
cable upstream snr-interval <0:600>
Properties
Property name Description
Example:
Example:
Casa Systems
Cable commands 4-101
cable upstream
Shows the upstream burst noise, if enabled. The logical channel output also shows the
burst noise event details, including the percentage and absolute values of the
correctable and uncorrectable burst events.
Casa Systems
4-102 RF Cable Configuration Guide and Command Reference
cable upstream
Shows the power setting and SNR for upstream traffic, if enabled. Channels in partial
state are appended with a hash mask (#). The output also shows any Orthogonal
Frequency Division Multiplexing (OFDM) channel information.
Casa Systems
Cable commands 4-103
reg-rsp-original-upstream-action
reg-rsp-original-upstream-action
Purpose
Mode
(config)#
Syntax
[no] reg-rsp-original-upstream-action
Casa Systems
5-1
Casa Systems
5-2 RF Cable Configuration Guide and Command Reference
Cable modem commands description
Configuration summary
Table 5-1 lists and briefly describes the objects related to cable modem commands.
Casa Systems
Cable modem commands 5-3
cable modem
cable modem
Purpose
The cable modem commands set various CM properties. Some require specifying the
MAC address of the CM, others do not. The maximum number of CMs is 65536, with
a maximum UPS of 3000 and downstream 16384 per card.
The Dynamic Bonding Change (DBC) and Dynamic Channel Change (DCC) methods
include a choice of the initial technique for moving a CM to a new channel. The
initial-tech options are as follows:
See the “Other related command examples” for the clear cable modem commands.
Modes
#
(config)#
Casa Systems
5-4 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> dbc
The cable modem <mac_addr> dbc command changes a CM’s upstream and
downstream channels using the Dynamic Bonding Change (DBC) method. DBC
moves a DOCSIS 3.x modem’s downstream service flows to different channels in the
modem’s receive channel set. DBC also moves D3.0 upstream service flows to
different channels in the current transmit channel set. The DBC configuration is for
the downstream or upstream list, or sets Receive Channel Profile (RCP) properties.
Up to 64 downstream service flows are supported per CM.
Modes
#
(config)#
Syntax
cable modem <mac_addr> dbc downstream-list <list> initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging}
cable modem <mac_addr> dbc downstream-list <list> upstream-list <list>
initial-tech {broadcast-ranging | direct | period-ranging |
reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dbc rcp-id <id> rcc-id <1:255> [upstream-list
<list>] initial-tech {broadcast-ranging | direct |
period-ranging | reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dbc upstream-list <list> initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging} [ofdma-initial-tech {broadcast-ranging |
probing | station-ranging | unicast-ranging}]
Properties
Property name Description
Casa Systems
Cable modem commands 5-5
cable modem <mac_addr> dbc
Properties (continued)
Property name Description
Example:
dbc downstream-list <list> Sets the DBC downstream list for the CM followed by
upstream-list <list> the upstream list and initial technique (as described
initial-tech for the cable modem command). The downstream
{broadcast-ranging | direct list defines the downstream channels as a
| period-ranging | comma-separated list, such as 1,2,3. The upstream
reinitialize-mac | list defines the upstream channels in the same way.
unicast-ranging} The channel must be included in the service group
for the requested channel change.
Example:
Casa Systems
5-6 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> dbc
Properties (continued)
Property name Description
dbc rcp-id <id> rcc-id Sets Dynamic Bonding Change (DBC) Receive
<1:255> [upstream-list Channel Profile (RCP) properties for channel
<list>] initial-tech bonding. The properties are as follows:
{broadcast-ranging | direct
| period-ranging | • rcp-id <id> — Defines the RCP ID, in the format
reinitialize-mac | xx:xx:xx:xx:xx. (See the channel bonding rcp
unicast-ranging} command.)
• rcc-id <1:255> — Defines the Receive Channel
Configuration (RCC) based on the MAC domain
ID. (See the channel bonding rcc command.)
• upstream-list <list> — Optionally defines the
upstream channels as a comma-separated list,
such as 1,2,3. The channel must be included in
the service group for the requested channel
change.
• initial-tech — Sets the initial technique to use for
moving CMs, as described for the cable modem
command.
Example:
dbc upstream-list <list> Sets the DBC upstream list for the CM followed by
initial-tech the initial technique (as described for the cable
{broadcast-ranging | direct modem command). The upstream list defines the
| period-ranging | upstream channels as a comma-separated list, such
reinitialize-mac | as 1,2,3. The channel must be included in the service
unicast-ranging} group for the requested channel change. OFDMA
[ofdma-initial-tech initial-tech load-balancing parameters can also be
{broadcast-ranging | added. The default OFDMA initial-tech is
probing | station-ranging | broadcast-ranging.
unicast-ranging}]
Example:
Casa Systems
Cable modem commands 5-7
cable modem <mac_addr> dbc
Shows CMs that have a non-zero DBC failure count and are failing DBC with the
CMTS. The command displays the total number of DBC failures and timeouts per
DSID, and the last DBC error code.
Casa Systems
5-8 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> dcc
The cable modem <mac_addr> dcc command changes a CM’s upstream and
downstream channels using the Dynamic Channel Change (DCC) dynamic service
flow method. The DCC configuration sets the change frequency or initial technique
for the upstream channel.
Modes
#
(config)#
Syntax
cable modem <mac_addr> dcc change-frequency <50000000:999000000>
[upstream <chan_id>] initial-tech {broadcast-ranging | direct |
period-ranging | reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dcc upstream <1:255>} initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging}
Properties
Property name Description
Casa Systems
Cable modem commands 5-9
cable modem <mac_addr> dcc
Properties (continued)
Property name Description
Example:
dcc upstream <1:255>} Sets the Dynamic Channel Change (DCC) upstream
initial-tech channel ID (see the interface upstream command),
{broadcast-ranging | direct along with the required initial-tech setting, as
| period-ranging | described for the cable modem command.
reinitialize-mac |
unicast-ranging} Example:
Casa Systems
5-10 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> l2vpn-map
The cable modem <mac_addr> l2vpn-map command maps a modem MAC address
to a VLAN for Layer 2 VPN (L2VPN).
Mode
(config)#
Syntax
cable modem <mac_addr> 12vpn-map <1:4094> [vpnid <id>]
no cable modem <mac_addr> l2vpn-map
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-11
cable modem <mac_addr> mpls
The cable modem <mac_addr> mpls vpnid command maps a MAC address to a
Multi-Protocol Label Switching (MPLS) Virtual Private LAN Service (VPLS) or
Virtual Private Wire Service (VPWS).
Mode
(config)#
Syntax
cable modem <mac_addr> mpls vpls <id>
cable modem <mac_addr> mpls vpws <id> <1:2147483647>
no cable modem <mac_addr> mpls
Properties
Property name Description
Example:
Casa Systems
5-12 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> mpls
Properties (continued)
Property name Description
Example:
Casa Systems
Cable modem commands 5-13
cable modem <mac_addr> qos-override
The cable modem <mac_addr> qos-override command allows changing the quality
of service (QoS) parameters for upstream and downstream primary service flows by
overriding them with the parameters of the specified cable service class without
having to unregister the specified CM. The QoS override settings normally persist
across CMTS reboots or CM resets and are maintained in the startup configuration
unless the non-persistent option is used. Up to 64,000 override entries are supported.
Mode
(config)#
Syntax
[no] cable modem <mac_addr> qos-override {ds-service-class |
us-service-class} <name> [non-persistent]
Properties
Property name Description
Casa Systems
5-14 RF Cable Configuration Guide and Command Reference
cable modem <mac_addr> qos-override
Properties (continued)
Property name Description
Example:
Shows CMs with QoS override in effect, also filtered by online CMs or those for
which QoS override is not persisted across CMTS reboots or CM resets.
Casa Systems
Cable modem commands 5-15
cable modem <mac_addr> ucc upstream
Modes
#
(config)#
Syntax
cable modem <mac_addr> ucc upstream <1:255>
Properties
Property name Description
Example:
Casa Systems
5-16 RF Cable Configuration Guide and Command Reference
cable modem authorization
Mode
(config)#
Syntax
cable modem authorization <mac_addr> <sav_cfg_list_name>
no cable modem authorization <mac_addr>
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-17
cable modem deny
The cable modem deny command specifies the MAC address of a cable modem that
is prohibited from registering with the CMTS. The deny list can contain up to 2048
modems.
Mode
(config)#
Syntax
[no] cable modem deny <mac_addr>
Properties
Property name Description
Example:
Casa Systems
5-18 RF Cable Configuration Guide and Command Reference
cable modem excessive-request detection
Mode
(config)#
Syntax
cable modem excessive-request detection grant-assigned <100:65535>
packet-recv <1:32767>
no cable modem excessive-request detection
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-19
cable modem offline aging
The cable modem offline aging command clears modems that have previously
registered with the CMTS but have been off line for a specified number of hours. If set
to 0 (the default), the modem maintains an off-line state indefinitely and is not cleared.
If set to a value in the range 1 to 8760 hours (1 year), the CMTS clears all modems
that have been offline for the specified number of hours.
Mode
(config)#
Syntax
cable modem offline aging <0:8760>
Properties
Property name Description
Example:
Casa Systems
5-20 RF Cable Configuration Guide and Command Reference
cable modem remote-query
The cable modem remote-query command sets the remote query polling interval.
Mode
(config)#
Syntax
[no] cable modem remote-query {<0 | 30:1800> [<snmp_comm>] | loopback
[0:255]}
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-21
cable modem rip authentication-bypass
Mode
(config)#
Syntax
[no] cable modem rip authentication-bypass <mac_addr> <mask>
Properties
Property name Description
Example:
Casa Systems
5-22 RF Cable Configuration Guide and Command Reference
cable modem vendor
Mode
(config)#
Syntax
cable modem vendor <oui> <name>
no cable modem vendor <oui>
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-23
Related show command examples
Polls on the fly to show details on all CMs. (See also the “Related show command
examples” in Chapter 3, “Baseline Privacy Interface.”)
Shows CMs belonging to the specified DOCSIS MAC interface. An additional display
is the show cable modem docsis-mac <id> service-group <id> {downstream |
upstream} throughput command.
Casa Systems
5-24 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows CM error information, including cyclic redundancy check (CRC) and header
check sequence (HCS) errors.
Casa Systems
Cable modem commands 5-25
Related show command examples
Shows downstream cable total and used bytes per downstream channel.
Casa Systems
5-26 RF Cable Configuration Guide and Command Reference
cm-ctrl
cm-ctrl
Purpose
Modes
#
(config)#
Syntax
cm-ctrl <mac_addr> {cm-reinit | disable-forwarding {0|1} |
event_ds_mask <1:255> <0:ffff> | event_mask <0:ffff> |
event_us_mask <1:255> <0:ffff> | mute <0:255> <1:65535>}
Properties
Property name Description
Casa Systems
Cable modem commands 5-27
cm-ctrl
Properties (continued)
Property name Description
Casa Systems
5-28 RF Cable Configuration Guide and Command Reference
default cable modem vendor
The default cable modem vendor command sets a system default vendor.
Mode
(config)#
Syntax
default cable modem vendor <oui>
Properties
Property name Description
Example:
Casa Systems
Cable modem commands 5-29
Other related command examples
Casa Systems
6-1
In the example of a network with eight downstream channels, even though the modem
supports only four downstream and four upstream channels, the modem learns how to
receive traffic across all eight CMTS downstream channels. The CMTS dynamically
creates a channel bonding group using four of the channels (based on current traffic
load) and creates a downstream service group (DS-SG) associated with the assigned
modem channel set. A service group is simply a group of channels.
Similarly, the set of upstream channels is called the upstream service group (US-SG).
Collectively, the upstream and downstream service groups make up the CM service
group (CM-SG). All upstream and downstream channels originating from the same
MAC domain are known as a MAC domain CM service group (MD-CM-SG).
In order for the Casa CMTS to operate in channel bonding mode, the DOCSIS MAC
interface must be configured, as well as a service group with at least one downstream
channel and one upstream channel. For CMs that support channel bonding operation,
the Casa CMTS automatically creates channel bonding groups with channels that
belong to the same service group, and the same DOCSIS MAC interface. The Casa
Casa Systems
6-2 RF Cable Configuration Guide and Command Reference
Configuration example
CMTS supports channel bonding in the same line card module. The maximum number
of downstream channels per QAM module is 32, and the maximum number of
upstream channels per DOCSIS Control and Upstream (DCU) module is 32.
Configuration example
In the following example, one service group is formed with 16 downstream and 8
upstream channels from the same downstream/upstream modules, with two MAC
domain interfaces created within the service group. Each domain contains 8
downstream and 4 upstream channels. The channel bonding then occurs inside each of
the domains, or 8 downstream and 4 upstream channels.
Casa Systems
Channel bonding 6-3
Configuration example
Configuration summary
Table 6-1 lists and briefly describes the objects related to channel bonding.
Casa Systems
6-4 RF Cable Configuration Guide and Command Reference
Configuration example
Casa Systems
Channel bonding 6-5
bonding-group
bonding-group
Purpose
In networks where traffic from a particular modem or service area must use a specific
downstream or upstream channel, upstream and downstream bonding groups can be
configured using the bonding-group object to direct traffic streams to specific
channels configured at the CMTS. This means that the CMTS uses the configured
bonding group and only the specific channels defined in the group. The CMTS does
not make the channel selection dynamically from a group of available channels at the
MAC domain. Up to 480 upstream bonding groups can be configured.
Casa highly recommends the dynamic service group configuration over the static
bonding group configuration, which should only be used in very specific cases where
dynamic channel selection is not feasible.
Note: Service groups are required for cable traffic load balancing and for channel
bonding over D3.0 modems. Service groups are not required for CMs to
register and come up only as long as upstream and downstream channels are
configured in the DOCSIS MAC domain.
Modes
(config)#
(bond-ds-mac-x-group-x)#
(bond-us-mac-x-group-x)#
Syntax
(config)#
[no] bonding-group downstream mac-domain <1:96> group-id <1:65535>
[no] bonding-group upstream mac-domain <1:96> group-id <1:65535>
(bond-ds-mac-x-group-x)#
prov-attr-mask <0x0:0xFFFFFFFF>
[no] qam <slot>/<port>/<chan>
reseq wait-time <255 | 0:180>
reseq warn-thrshld <255 | 0:179>
(bond-us-mac-x-group-x)#
prov-attr-mask <0x0:0xFFFFFFFF>
[no] upstream <slot>/<port>.<chan>/<log_chan>
Casa Systems
6-6 RF Cable Configuration Guide and Command Reference
bonding-group
Properties
Property name Description
Example:
upstream mac-domain <1:96> Adds a static upstream CM bonding group, with the
group-id <1:65535> MAC domain and group IDs, with a maximum 480
upstream groups.
Example:
Example:
CASA(bond-ds-mac-30-group-100)#
prov-attr-mask 0x0
Casa Systems
Channel bonding 6-7
bonding-group
Properties (continued)
Property name Description
Example:
CASA(bond-ds-mac-30-group-100)#
qam 0/2/1
CASA(bond-ds-mac-30-group-100)#
no qam 0/2/1
Example:
CASA(bond-ds-mac-30-group-100)#
reseq wait-time 255
Example:
CASA(bond-ds-mac-30-group-100)#
reseq warn-thrshld 255
Casa Systems
6-8 RF Cable Configuration Guide and Command Reference
bonding-group
Properties (continued)
Property name Description
Example:
CASA(bond-us-mac-30-group-100)#
upstream 13/0.0/0
CASA(bond-us-mac-30-group-100)#
no upstream 13/0.0/0
interface docsis-mac
upstream channel bonding
downstream channel bonding
initial-tech
max sid-cluster per-service-flow
sid-cluster
Casa Systems
Channel bonding 6-9
bonding-group
interface qam
interleave 8
modulation 256qam
The CMTS should have the interface qam configurations to get maximum
throughput on channel bonding and non-bonding CMs. The downstream QAM
interface channel interleave should be 8 and the channel modulation type should be set
to 256qam.
Shows the configured bonding groups or their utilization. Output can also be for
downstream or upstream (and optionally filtered by group-id or app-class) or for a
particular MAC domain.
Casa Systems
6-10 RF Cable Configuration Guide and Command Reference
bonding-group
Casa Systems
Channel bonding 6-11
dbg_id_set qam
dbg_id_set qam
Purpose
The dbg_id_set qam command configures a downstream bonding group (DBG) for a
CM. The properties require entering, in succession, a QAM slot number, CM number,
and DBG ID.
Mode
(config)#
Syntax
dbg_id_set qam <slot> cm <0:16384> dbg <17:48>
no dbg_id_set qam <slot> cm <0:16384>
Properties
Property name Description
Example:
CASA(config)# dbg_id_set
qam 0 cm 1 dbg 17
CASA(config)# no dbg_id_set qam 0 cm 1
Casa Systems
6-12 RF Cable Configuration Guide and Command Reference
rcc
rcc
Purpose
The rcc command sets up the Receive Channel Configuration (RCC) for downstream
channel bonding to the CM (up to 512). RCC is used for downstream channel bonding
of 16 channels in earlier Casa releases that do not support channel bonding. Determine
the following before configuring the RCC group:
Modes
(config)#
(conf-mac <id> rcc <id>)#
Syntax
(config)#
[no] rcc mac <1:96> rcp-id <string> <1:4294967295>
Properties
Property name Description
Casa Systems
Channel bonding 6-13
rcc
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
6-14 RF Cable Configuration Guide and Command Reference
rcc
Properties (continued)
Property name Description
Example:
Casa Systems
Channel bonding 6-15
rcp
rcp
Purpose
The rcp command sets up the Receive Channel Profile (RCP) for downstream channel
bonding to the CM, up to 200.
Modes
(config)#
(rcp xx:xx:xx:xx:xx)#
Syntax
[no] rcp <string>
(rcp xx:xx:xx:xx:xx)#
rc <1:32> {primary | secondary} connect <1:16>
no rc <1:32>
[no] rcp <string>
[no] rcp-description [“<text>”]
rm <1:16> channels <0:64> [min-freq <111000000:999000000> max-freq
<111000000:999000000>]
no rm <1:16>
vendor-specific {spacing6 | spacing8}
Properties
Property name Description
Example:
Casa Systems
6-16 RF Cable Configuration Guide and Command Reference
rcp
Properties (continued)
Property name Description
Example:
Example:
CASA(rcp 00:10:00:10:02)#
rcp-description “spacing 6”
CASA(rcp 00:10:00:10:02)#
no rcp-description
Example:
Casa Systems
Channel bonding 6-17
rcp
Properties (continued)
Property name Description
Example:
CASA(rcp 00:10:00:10:02)#
vendor-specific spacing6
show rcp-list
rcp 00:10:00:10:02
rcp-description CLAB-8M-002
vendor-specific spacing8
rm 1 channels 8
rc 1 primary connect 1
rc 2 secondary connect 1
…
Casa Systems
6-18 RF Cable Configuration Guide and Command Reference
service group
service group
Purpose
The service group command configures a service group for channel bonding. A
service group is a collection of upstream and downstream channels that is allocated to
a single fiber node that supports a given service area. A service group can be bound to
an upstream or downstream interface. There can be up to 48 downstream and 16
upstream channels per node in Release 7.
Radio Frequency over Glass (RFoG) is a CMTS operating mode defined in SCTE 174
2010 and supported in DOCSIS 3.1. In this mode, the CMTS limits the number of
simultaneous upstream transmitters that are coupled to the same optical fiber splitter
to a single transmitter. Because CMs on the same splitter would not be allowed to
transmit data concurrently to the CMTS, an enhancement to the upstream scheduler
allocates the upstream spectrum for modem upstream transmissions to ensure that
time slots do not overlap if these modems are on the same optical fiber. RFoG mode is
enabled or disabled on a per service group basis, allowing cable operators to configure
the CMTS based on each deployment topology. Note that the same contention period
is shared by all subscriber modems.
A limitation of RFoG mode is that it does not permit simultaneous transmissions from
multiple modems that are sharing the same optical fiber, regardless of their baseband
channel frequencies. Therefore, it is undesirable to enable RFoG mode in the
conventional coaxial cables network, because the channel spectrum cannot be fully
utilized for concurrent transmissions.
Creating a service group puts you in the Casa service-group configuration mode.
Note: Service groups are required for cable traffic load balancing and for channel
bonding over D3.0 modems. Service groups are NOT required for CMs to
register and come up only as long as upstream and downstream channels are
configured in the DOCSIS MAC domain.
Modes
(config)#
(conf-svc-grp <name>)#
Casa Systems
Channel bonding 6-19
service group
Syntax
(config)# [no] service group <name>
(conf-svc-grp x)#
[no] description “<text>”
[no] downstream channel bonding
[no] ofdm <slot>/<port>/<chan>
[no] ofdma <slot>/<port>.<chan>
[no] qam <slot>/<port>/<chan> [<1:48>]
[no] upstream <slot>/<port>.<pchan> [<1:8>]
[no] upstream channel bonding
[no] upstream rfog-scheduler
Properties
Property name Description
Example:
Example:
Casa Systems
6-20 RF Cable Configuration Guide and Command Reference
service group
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Casa Systems
Channel bonding 6-21
service group
Properties (continued)
Property name Description
Example:
upstream channel bonding Enables upstream channel bonding from the service
group configuration. Channel bonding must be
enabled from both the interface docsis-mac and
service group configurations.
Example:
Example:
Note: If service groups are configured or changed while the modems are online, the
CMTS can lose track of them and it will be necessary to reset them (or reboot
Casa Systems
6-22 RF Cable Configuration Guide and Command Reference
service group
the CMTS). When the CMTS does not know which service group a modem
belongs to, it writes a message such as the following to the ddm_log:
Shows the configured service groups. OFDM and OFDMA channels in service groups
are also indicated.
service group 5
ofdm 1/0/0
ofdma 10/1.0
…
Casa Systems
Channel bonding 6-23
service group
Shows the upstream signal quality for the specified service group.
Shows the MAC domain downstream service groups, which can also be filtered by
MAC domain and service group name.
Shows the MAC domain upstream service groups, which can also be filtered by MAC
domain and service group name.
Casa Systems
7-1
Configuration summary
Table 7-1 lists and briefly describes the objects related to channel blocks.
Casa Systems
7-2 RF Cable Configuration Guide and Command Reference
channel-block downstream group 4
Mode
(config)#
Syntax
channel-block downstream group 4
Shows the automatically created downstream channel blocks defined for DOCSIS
MAC domains, in groups of up to four. In the example, with six QAM channels
defined, the remaining two channels are given a separate block ID.
Casa Systems
Channel blocks 7-3
channel-block downstream mac-domain block-id
Modes
(config)#
(chan-block-mac-x-block-y)#
Syntax
(config)#
[no] channel-block downstream mac-domain <1:96> block-id <1:255>
(chan-block-mac-x-block-y)#
prov-attr-mask <0x0:0xffffffff>
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
<1:96> block-id <1:255> Creates the channel block with a MAC domain ID and
block ID.
Example:
Casa Systems
7-4 RF Cable Configuration Guide and Command Reference
channel-block downstream mac-domain block-id
Properties (continued)
Property name Description
Example:
CASA(chan-block-mac-1-block-1)#
prov-attr-mask 0x0
Example:
CASA(chan-block-mac-1-block-1)#
qam 1/7/4
CASA(chan-block-mac-1-block-1)#
no qam 1/7/4
Shows the channel block configuration. The output can be filtered by downstream,
MAC domain ID, or block ID.
Casa Systems
Channel blocks 7-5
channel-utilization-interval
channel-utilization-interval
Purpose
The channel-utilization-interval command sets the interval over which the channel
utilization information is collected and averaged.
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
Property name Description
Example:
CASA(config)#
channel-utilization-interval 86400
show channel-utilization-interval
Casa Systems
8-1
Configuration summary
Table 8-1 lists and briefly describes the objects related to DOCSIS MAC interface.
Casa Systems
8-2 RF Cable Configuration Guide and Command Reference
interface docsis-mac
interface docsis-mac
Purpose
Note: The maximum number of available DOCSIS MAC interfaces depends on the
Casa CMTS system, but the absolute maximum number across all systems is 96.
Modes
(config)#
(conf-if-mac <num>)#
Syntax
(config)# [no] interface docsis-mac <1:96>
(conf-if-mac x)#
[no] battery backup
[no] cable cm-status {event <1:27> {max-timer <1:1310> max-number
<0:255>} | report event-list <list>}
[no] cm trap [interval [<0:86400>] | l2vpn-cm-offline-only |
l2vpn-cm-online-only | online-offline-only]
[no] cm-status event report
[no] description “<text>”
[no] dhcp-authorization [ipv4-only | ipv6-only]
[no] dhcp-giaddr-primary
[no] dhcp-insert {circuit-id upstream-description |
downstream-description | hostname | MSO-text | service-class
| upstream-description | upstream-description-mac}
[no] dhcpv6-link-address-primary
[no] downstream <1:255> interface ofdm <slot>/<port>/<chan>
[no] downstream <1:255> interface qam <slot>/<port>/<chan>
[secondary] [<1:80>]
[no] downstream channel bonding
[no] early-authentication-encryption {capability | ranging | total}
[no] energy management
Casa Systems
DOCSIS MAC interface 8-3
interface docsis-mac
Properties
Property name Description
Example:
Casa Systems
8-4 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
battery backup Enables DBC to make the modem enter 1x1 mode
when operating on battery backup.
Example:
Casa Systems
DOCSIS MAC interface 8-5
interface docsis-mac
Properties (continued)
Property name Description
cable cm-status {event Sets parameters for showing cable events, and sets
<1:27> {max-timer the codes for the event types to report in a
<1:1310> max-number comma-separated list.The event codes and
<0:255>} | report parameters are as follows:
event-list <list>}
• 1 — Secondary channel MDD timeout.
• 2 — FEC lock failure.
• 3 — Sequence out-of-range.
• 4 — Secondary channel MDD recovery.
• 5 — FEC lock recovery.
• 6 — T4 timeout.
• 7 — T3 retries exceeded.
• 8 — Successful ranging after T3 retries
exceeded.
• 9 — CM operating on battery backup.
• 10 — CM returned to AC power.
• 11 — MAC address removed.
• 16 — DS OFDM profile failure.
• 17 — Primary downstream change.
• 18 — DPD mismatch.
• 20 — NCP profile failure.
• 21 — Loss of FEC lock on PLC.
• 22 — NCP profile recovery.
• 23 — FEC recovery on PLC channel.
• 24 — FEC recovery on OFDM profile.
• 25 — OFDMA profile failure.
• 26 — MAP storage overflow indicator.
• 27 — MAP storage almost full indicator.
(continued next page)
Casa Systems
8-6 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
cm trap [interval Enables CMTS trap generation any time there are
[<0:86400>] | changes to the cable modem (CM) status over a
l2vpn-cm-offline-only | DOCSIS-MAC interface. An optional time interval
l2vpn-cm-online-only | controls the minimum time to elapse between CMTS
online-offline-only] trap notifications, default 600 seconds (10 minutes).
You can set options for trap notifications whenever
Business Service over DOCSIS/L2VPN modems
deregister and go offline, or when the CM goes online
or offline.
Example:
Casa Systems
DOCSIS MAC interface 8-7
interface docsis-mac
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
8-8 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
CASA(conf-if-mac 1)#
dhcp-giaddr-primary
CASA(conf-if-mac 1)#
no dhcp-giaddr-primary
Casa Systems
DOCSIS MAC interface 8-9
interface docsis-mac
Properties (continued)
Property name Description
Example:
Casa Systems
8-10 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
CASA(conf-if-mac 1)#
dhcpv6-link-address-primary
CASA(conf-if-mac 1)#
no dhcpv6-link-address-primary
Example:
Casa Systems
DOCSIS MAC interface 8-11
interface docsis-mac
Properties (continued)
Property name Description
Example:
Casa Systems
8-12 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
CASA(conf-if-mac 1)#
early-authentication-encryption
capability
CASA(conf-if-mac 1)#
no early-authentication-encryption
Casa Systems
DOCSIS MAC interface 8-13
interface docsis-mac
Properties (continued)
Property name Description
Example:
Casa Systems
8-14 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
Example:
CASA(conf-if-mac 1)#
invited-ranging-attempts 100
CASA(conf-if-mac 1)#
no invited-ranging-attempts
Example:
Casa Systems
DOCSIS MAC interface 8-15
interface docsis-mac
Properties (continued)
Property name Description
CASA(conf-if-mac 1)#
ip-provisioning-mode ipv4-only
Example:
mdd interval <0:2000> Interval for the MAC Domain Descriptor (MDD) that
includes the downstream service groups in the MAC
domain and the upstream ambiguity resolution
channel, in milliseconds, with 0 disabling the MDD.
Example:
Casa Systems
8-16 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Casa Systems
DOCSIS MAC interface 8-17
interface docsis-mac
Properties (continued)
Property name Description
Example:
CASA(conf-if-mac 1)#
multicast-dsid-forward wb-cm-only
CASA(conf-if-mac 1)#
no multicast-dsid-forward
CASA(conf-if-mac 1)#
no multicast-dsid-forward dsg
privacy {kek | tek} Key Encryption Key (KEK) or Traffic Encryption Key
life-time <1:604800> (TEK) lifetime on MAC domain interfaces for the
Baseline Privacy Interface (BPI). The lifetime is in
seconds.
Example:
Casa Systems
8-18 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
CASA(conf-if-mac 1)#
router-advertisement enable
CASA(conf-if-mac 1)#
no router-advertisement enable
Casa Systems
DOCSIS MAC interface 8-19
interface docsis-mac
Properties (continued)
Property name Description
Example:
CASA(conf-if-mac 1)#
shared-secondary-secret 1 7 3155ff
CASA(conf-if-mac 1)#
no shared-secondary-secret 1
Casa Systems
8-20 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
DOCSIS MAC interface 8-21
interface docsis-mac
Properties (continued)
Property name Description
Example:
Casa Systems
8-22 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
DOCSIS MAC interface 8-23
interface docsis-mac
Properties (continued)
Property name Description
Example:
Casa Systems
8-24 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
upstream drop classifier Enables the Upstream Drop Classifier (UDC), which
has a set of matching criteria applied by the CMs to
packets to determine if a packet should be dropped
on upstream traffic.
Example:
Example:
shared-secondary-secret
Creates a shared secondary secret. The command syntax is identical to the interface
docsis-mac shared-secondary-secretcommand.
shared-secret
Creates a shared secret. The command syntax is identical to the interface docsis-mac
shared-secondary-secret command.
Casa Systems
DOCSIS MAC interface 8-25
Related show command examples
Shows the DOCSIS MAC interface configuration. Other options include specifying a
particular DOCSIS MAC ID, brief, stat, and topology.
Casa Systems
8-26 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the utilization rates of all the downstream channels in the system. Note that the
column headings change when shared channels or admission control is enabled.
Shows all downstream channel sets. You can also filter by id and mac-domain.
Casa Systems
DOCSIS MAC interface 8-27
Related show command examples
Shows DOCSIS MAC interface status and statistics. Other options include specifying
a particular domain ID.
Casa Systems
8-28 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the CM status log of the CM, based on the event parameters set.
Shows the MAC domain interface to which a particular upstream channel is linked.
Shows CMs that bypassed TFTP download of the DOCSIS configuration file and
have registered with the CMTS.
show router-advertisement
Shows CMs that bypassed TFTP download of the DOCSIS configuration file and
have registered with the CMTS.
Casa Systems
9-1
Types of OOB messages include conditional access (CA), system information (SI),
electronic program guide (EPG), emergency alert system (EAS), and other generic
messages.
Definitions
• DSG channel — DOCSIS downstream QAM channel that contains one or more
DSG tunnels.
• DSG classifier — Description of Layer 3 and 4 filtering that applies to DSG
tunnel traffic. Classifiers can be specified in the DSG agent contained in the
CMTS and sent as a component of the DSG address table in the Downstream
Channel Descriptor (DCD) message.
• DSG client — Terminates the DSG tunnel at the STB across the cable network
and receives content from the DSG server.
• DSG server — Part of the Set-Top Controller attached from the CMTS via the
regional or WAN IP backbone.
Casa Systems
9-2 RF Cable Configuration Guide and Command Reference
Configuration steps examples
1. Define the DSG tunnel group and the mapping between a tunnel to downstream
QAM channels and DSG rule-related data. See the dsg tunnel-group command
for details. For example:
CASA(config)# dsg tunnel-group 1
CASA(conf-dsg-tunnel-grp-1)# channel 1 qam 0/0/0 rule-priority 20
CASA(conf-dsg-tunnel-grp-1)# channel 2 qam 0/0/1 rule-priority 20
CASA(conf-dsg-tunnel-grp-1)# channel 3 qam 0/0/2 rule-priority 11
CASA(conf-dsg-tunnel-grp-1)# channel 4 qam 0/0/3 rule-priority 11
CASA(conf-dsg-tunnel-grp-1)# end
2. Define the client list, which includes the participating clients that terminate the
DSG tunnel and receive content from the DSG server. Each client has a client type
defined as an application ID, well-known STB MAC address, broadcast ID, or
conditional access (CA) ID, along with any vendor parameters. See the dsg
client-list command for details. For example:
CASA(config)# dsg client-list 1 client 1
id-type macAddr id-value 0001.a6ff.0015 vendor-param-id 0
CASA(config)# dsg client-list 1 client 2
id-type broadcast id-value 0 vendor-param-id 0
3. Set up the tunnel with its tunnel group, destination MAC address, service class,
client list, and service class for tunnel QoS parameters, along with any DSG
classifier ID with the source and destination multicast address. See the dsg tunnel
command for details. For example:
CASA(config)# dsg tunnel 1
CASA(conf-dsg-tunnel 1)# group 1
CASA(conf-dsg-tunnel 1)# dst-address 0013.f735.d38a
CASA(conf-dsg-tunnel 1)# client-list 1
CASA(conf-dsg-tunnel 1)# service-class SRVLCL1
CASA(conf-dsg-tunnel 1)# classifier 1 10 192.168.3.6/32 239.1.1.8
Casa Systems
DOCSIS Set-Top Gateway 9-3
Configuration steps examples
4. Set the DSG timer ID, the global timer entry to be associated with the DSG client
state machine. There are four distinct times to set, an initial timeout (t1),
operational timeout (t2), two-way retry timer (t3), and a one-way retry timer (t4),
set in seconds. See the dsg timer-id command for details. For example:
CASA(config)# dsg timer-id 1 t1 2 t2 30 t3 1 t4 35
5. Optionally define the DSG channel list with the center frequency for DSG
channels as a way to expedite bringing up DSG STBs. You can assign this channel
list to any QAM channel, but the center frequency must be in the range set for the
DSG channels. See the dsg channel-list command for details. For example:
CASA(config)# dsg channel-list 1 channel 1 frequency 526000000
6. For each downstream QAM channel to support DSG, enable DCD messages and
set the DSG properties. For details, see the interface qam command in Chapter
17, “QAM interface.” For example, for one of the QAM channels:
CASA(config)# interface qam 0/0
CASA(conf-if-qam 0/0)# channel 0 frequency 279000000
CASA(conf-if-qam 0/0)# channel 0 dsg dcd-enable
CASA(conf-if-qam 0/0)# channel 0 dsg timer-id 1
CASA(conf-if-qam 0/0)# channel 0 dsg vendor-param-id 1
CASA(conf-if-qam 0/0)# channel 0 dsg interval 5
CASA(conf-if-qam 0/0)# end
Casa Systems
9-4 RF Cable Configuration Guide and Command Reference
DSG maximum capacities
Table 9-1 lists the maximum capacities for the DSG elements.
Configuration summary
Table 9-2 lists and briefly describes the objects related to DOCSIS Set-Top Gateway.
Casa Systems
DOCSIS Set-Top Gateway 9-5
dsg channel-list
dsg channel-list
Purpose
The dsg channel-list command creates a DSG channel-list used in the DCD message
to advertise which QAMs contain DSG tunnels and which channel frequencies carries
them, in order to reduce the STB initial scan time and expedite the DSG client
bring-up. The channel-list can then be applied on any QAM channel (regardless of
whether there are DSG tunnels on it). It is not intended to indicate which STB devices
go on which channel. However, the center frequency indicated by the channel-list
definition must be within the frequency range defined for the QAM channels enabled
for DSG. The center frequency must be defined as a multiple of 62500 Hz.
Mode
(config)#
Syntax
dsg channel-list <1:4294967295> channel <1:4294967295> frequency
<0:1000000000>
no dsg channel-list <1:4294967295> channel <1:4294967295>
Properties
Property name Description
Example:
Casa Systems
9-6 RF Cable Configuration Guide and Command Reference
dsg channel-list
interface qam
channel <id> dsg channel-list <id>
Sends a DSG channel list as a DCD message over a QAM channel. (See the
interface qam command.)
Casa Systems
DOCSIS Set-Top Gateway 9-7
dsg channel-list
Casa Systems
9-8 RF Cable Configuration Guide and Command Reference
dsg client-list
dsg client-list
Purpose
The dsg client-list command creates a DSG client list. This client list can then be
assigned to a dsg tunnel.
Mode
(config)#
Syntax
dsg client-list <1:4294967295> client <1:4294967295> id-type {appId
id-value <0:65535> | broadcast id-value <1:65535> | caSysId
id-value <0:65535> | macAddr id-value <mac_addr}
[vendor-param-id <1:4294967295>]
no dsg client-list <1:4294967295> client <1:4294967295>
Properties
Property name Description
Example:
Casa Systems
DOCSIS Set-Top Gateway 9-9
dsg client-list
Properties
Property name Description
Example:
Casa Systems
9-10 RF Cable Configuration Guide and Command Reference
dsg dcd-global-enable
dsg dcd-global-enable
Purpose
Mode
(config)#
Syntax
[no] dsg dcd-global-enable
Casa Systems
DOCSIS Set-Top Gateway 9-11
dsg timer-id
dsg timer-id
Purpose
The dsg timer-id command sets the DSG client state machine timer. The DSG timer
entry is then applied to a downstream channel and encoded in the DCD message.
Mode
(config)#
Syntax
dsg timer-id <1:4294967295> t1 <1:65535> t2 <1:65535> t3 <1:65535>
t4 <1:65535>
no dsg timer-id <1:4294967295>
Properties
Property name Description
Example:
Casa Systems
9-12 RF Cable Configuration Guide and Command Reference
dsg tunnel
dsg tunnel
Purpose
The dsg command creates a DOCSIS Set-top Gateway (DSG) tunnel. The number of
supported DSG replications per chassis is 8192. Each QAM line card can have up to
1638 DSG replications.
Modes
(config)#
(conf-dsg-tunnel <id>)#
Syntax
(config)# [no] dsg tunnel <1:4294967295>
(conf-dsg-tunnel x)#
classifier <1:65535> <0:255> {<src_ip4/mask> | ipv6 <src_ip6/mask>}
<dst_ip> [<0:65535> <0:65535>] [indcd [<0:65535> <0:65535>]]
no classifier <1:65535>
[no] client-list <1:4294967295>
dst-address <mac_addr>
no dst-address
group <1:4294967295>
no group
service-class <name>
no service-class
Properties
Property name Description
Example:
Casa Systems
DOCSIS Set-Top Gateway 9-13
dsg tunnel
Properties
Property name Description
Casa Systems
9-14 RF Cable Configuration Guide and Command Reference
dsg tunnel
Properties
Property name Description
dst-address <mac_addr> Destination MAC address for the DSG tunnel, in the
form xxxx.xxxx.xxxx.
Example:
Example:
Example:
Shows the DSG tunnel configuration, optionally for a specific tunnel ID.
group 1
dst-address 0100.5e40.100b
client-list 1
classifier 1 1 0.0.0.0/0 239.192.16.11 indcd
Casa Systems
DOCSIS Set-Top Gateway 9-15
dsg tunnel
Shows the cable DSG tunnel configuration. Output can also be filtered by ID, and then
by DSG classifier (CFRS), clients, interface, or verbose.
Cfr Id : 1
State : en
Priority : 1
Dest IP : 239.192.016.011
Src IP : 000.000.000.000
Src Prefix Length : 0
Dest Port Start : 0
Dest Port End : 65535
Client List Id : 1
Client Id : 1
Client Id Type : Application ID 0x1
Interface : 11/0/0
Rule ID : 1
Casa Systems
9-16 RF Cable Configuration Guide and Command Reference
dsg tunnel
Casa Systems
DOCSIS Set-Top Gateway 9-17
dsg tunnel-group
dsg tunnel-group
Purpose
The dsg tunnel-group command creates a DSG tunnel group. A DSG tunnel can then
be added to the tunnel group and you can associate a downstream channel with a DSG
tunnel group. The maximum number of DSG channels in a tunnel group is 2560 and
across all tunnel groups is 5120.
Modes
(config)#
(conf-dsg-tunnel-grp <id>)#
Syntax
(config)# [no] dsg tunnel-group <1:4294967295>
(conf-dsg-tunnel-grp x)#
channel <1:4294967295> qam <slot>/<port>/<chan> [rule-priority
<0:255>] [vendor-param-id <1:4294967295>]
no channel <1:4294967295>
Properties
Property name Description
Example:
Casa Systems
9-18 RF Cable Configuration Guide and Command Reference
dsg tunnel-group
Properties
Property name Description
dsg tunnel 1
group 1
dst-address 0100.5e01.6401
service-class "video-DS"
classifier 1 2 0.0.0.0/0 224.11.11.1 indcd 3001 30011
classifier 11 2 0.0.0.0/0 224.22.22.1 indcd 3001 30011
dsg tunnel 2
group 2
dst-address 0100.5e01.6402
service-class "video-DS"
classifier 2 2 0.0.0.0/0 224.11.11.2 indcd 3001 30011
classifier 12 2 0.0.0.0/0 224.22.22.2 indcd 3001 30011
…
Casa Systems
DOCSIS Set-Top Gateway 9-19
dsg unicast-port
dsg unicast-port
Purpose
The dsg unicast-port command configures the DSG unicast port, 8888 by default.
Mode
(config)#
Syntax
dsg unicast-port <1:65535>
Properties
Property name Description
Example:
Shows the DSG running configuration that includes the unicast port value.
Casa Systems
9-20 RF Cable Configuration Guide and Command Reference
dsg vendor-param-id
dsg vendor-param-id
Purpose
The dsg vendor-param-id command configures DSG vendor parameters. The vendor
parameter ID can then be assigned to a dsg client-list.
Mode
(config)#
Syntax
dsg vendor-param-id <1:4294967295> vendor <1:4294967295> oui <oui>
value <val>
no dsg vendor-param-id <1:4294967295> vendor <1:4294967295>
Properties
Property name Description
Example:
Casa Systems
DOCSIS Set-Top Gateway 9-21
dsg vendor-param-id
Casa Systems
10-1
Each of the methods can further be operated in two types: static or dynamic.
• Static — Load balancing is done at ranging request time. When a CM sends its
initial ranging request message, the CMTS responds with a ranging response
message that includes either a Downstream Frequency Override or an Upstream
Channel ID Override field that instructs the CM which channels it should use.
Casa Systems
10-2 RF Cable Configuration Guide and Command Reference
Load balancing commands description
• Dynamic — A form of load balancing in which CMs are moved among upstream
and downstream channels within the same service group after their initial
difference between two interfaces exceeds a user-defined percentage. The CMTS
will use DCC/UCC messages to move CMs with single upstream/downstream
channels, and Dynamic Bonding Change (DBC) messages to move CMs with
bonding upstream/downstream channels, to different bonding groups.
For DOCSIS and EuroDOCSIS 3.x modems, the dynamic load-balancing software
generates a downstream channel set with a minimum load to fit the modem’s RCP.
This prevents rejection of the new channel set so that load balancing is not canceled
when the assigned modem is under load. The Casa CMTS supports both methods and
types to load balance upstream and downstream channels. You can configure a Casa
CMTS using static load balancing only, or using static load balancing and dynamic
load balancing together.
Because load balancing can only be done to upstream and downstream interfaces
sharing the same physical connectivity, the upstream and downstream interfaces have
to belong to the same service group. Both channel bonding and non-channel bonding
modems can participate in load balancing. Channel bonding modems will count as one
CM for each of its channels.
To apply a load balancing policy globally, apply it to the default group. To apply
different load balancing policies to different MAC Domain/Service Groups, first
define the rules and the policies. Then create a restricted load balance group, and
assign it to the MAC Domain/Service group.
Casa Systems
Load balancing 10-3
Sample load balancing configuration
Casa Systems
10-4 RF Cable Configuration Guide and Command Reference
Sample load balancing configuration
Configuration summary
Table 10-1 lists and briefly describes the objects related to load balancing.
Casa Systems
Load balancing 10-5
Sample load balancing configuration
Casa Systems
10-6 RF Cable Configuration Guide and Command Reference
load-balance
load-balance
Purpose
The load-balance command configures load balancing for the CMTS. Configuring
load balancing requires the following steps:
Modes
(config)#
(load-bal-basic-rule x)#
(load-bal-exclusion-list)#
(load-bal-exe-rule x)#
(load-bal-general-mac-x-sg-x)#
(load-bal-policy x)#
(load-bal-restrict-cm x)#
(load-bal-restrict x)#
Casa Systems
Load balancing 10-7
load-balance
Shows the load balancing static configuration, the equivalent of the show static
load-balance command.
Casa Systems
10-8 RF Cable Configuration Guide and Command Reference
load-balance annexb-upper-frequency
load-balance annexb-upper-frequency
Purpose
Modes
(config)#
Syntax
(config)# load-balance annexb-upper-frequency <0:99000000>
Casa Systems
Load balancing 10-9
load-balance basic-rule
load-balance basic-rule
Purpose
The load-balance basic-rule command sets the basic rules for load balancing. The
DOCS-LOADBAL3-MIB defines the load balance basic rules in SNMP. To configure
the basic rules, do the following:
Modes
(config)#
(load-bal-basic-rule <id>)#
Syntax
(config)# [no] load-balance basic rule <1:4294967295>
(load-bal-basic-rule x)#
[no] enable
suspend-load-balance from <start_time> to <end_time>
Properties
Property name Description
Example:
Casa Systems
10-10 RF Cable Configuration Guide and Command Reference
load-balance basic-rule
Properties (continued)
Property name Description
Example:
suspend-load-balance Sets a basic rule for a time period (from and to) to
from <start_time> to suspend load balancing, in H:MM:SS or HH:MM:SS
<end_time> format.
Example:
CASA(load-bal-basic-rule 1)#
suspend-load-balance from 12:30:00 to
15:00:00
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 15:00:00
Casa Systems
Load balancing 10-11
load-balance dcc-retry
load-balance dcc-retry
Purpose
The load-balance dcc-retry command sets the number of Dynamic Channel Change
(DCC) retries to perform during load balancing. These retries address situations when
a single DCC attempt fails to move a modem away from a forbidden port (using the
prov-attr-mask attribute mask in the modem configuration file) and additional retry
attempts at moving the modem are necessary. The configurable range is 0–10 retries.
The default is zero retries, meaning to try the DCC only once.
Mode
(config)#
Syntax
[no] load-balance dcc-retry <0:10>
Casa Systems
10-12 RF Cable Configuration Guide and Command Reference
load-balance enable
load-balance enable
Purpose
The load-balance enable command enables the load balancing function globally.
By default, the upstream channel has precedence in load balancing across MAC
domains, where the lowest loaded (least busy) upstream channel is selected within the
service group. Then, the lowest loaded downstream channel is selected within the
MAC domain of the selected upstream channel. If the downstream precedence is
configured, then the downstream channel is selected first.
The CMTS uses downstream frequency override and the upstream channel ID
override in the ranging response message to move modems to a different MAC
domain if needed. This applies to all DOCSIS 1.0, 1.1, 2.0 and 3.0 modems. The SID
in the ranging response message is 0x3fff.
Mode
(config)#
Syntax
[no] load-balance enable
[no] load-balance enable across-mac [downstream]
Properties
Property name Description
Example:
Casa Systems
Load balancing 10-13
load-balance enable
Properties (continued)
Property name Description
Example:
load-balance enable
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 13:00:00
Casa Systems
10-14 RF Cable Configuration Guide and Command Reference
load-balance exclusion list
The load-balance exclusion list command sets exclusions for load balancing (up to
200).
Modes
(config)#
(load-bal-exclusion-list)#
Syntax
(config)# [no] load balance exclusion list
(load-bal-exclusion-list)#
[no] mac addr <mac_addr> mask <mask> [both | dynamic | static]
Properties
Property name Description
mac addr <mac_addr> mask MAC address and mask for the exclusion list, in
<mask> [both | dynamic | xxxx.xxxx.xxxx hex format, to apply the exclusion list
static] to modems from a particular modem vendor. One of
the optional modifiers excludes the CM from both
dynamic and static load balancing, from just dynamic
load balancing, or from just static load balancing.
Example:
Casa Systems
Load balancing 10-15
load-balance exclusion list
Casa Systems
10-16 RF Cable Configuration Guide and Command Reference
load-balance execution-rule
load-balance execution-rule
Purpose
The load-balance execution-rule command sets execution rules for load balancing,
with up to 16 execution rules allowed. Note that an execution rule is always enabled;
there is no command to disable it. Define execution rules as follows:
Modes
(config)#
(load-bal-exe-rule <id>)#
Syntax
(config)# [no] load-balance execution-rule <1:16>
(load-bal-exe-rule x)#
cable modem rebalance-interval <60:3600>
no cable modem rebalance-interval
cable modem retry-interval first <0:4294967295> second
<0:4294967295>
no cable modem retry-interval
[no] enable
interval <10:3600>
method {modem | utilization} [dynamic]
no method [dynamic]
[no] permit multicast-session modem move
suspicious-channel retry interval <0:86400>
threshold load <0:100> [enforce <0:100>] [dynamic minimum <2:500> |
minimum <2:500>]
no threshold
upstream-interval <10:3600>
no upstream-interval
upstream-method {modem | utilization} [dynamic]
Casa Systems
Load balancing 10-17
load-balance execution-rule
no upstream-method [dynamic]
upstream-threshold load <0:100> [enforce <0:100>] [dynamic minimum
<2:500> | minimum <2:500>]
no upstream-threshold
Properties
Property name Description
Example:
CASA(config)# load-balance
execution-rule 5
CASA(config)#
no load-balance execution-rule 5
Example:
Example:
Casa Systems
10-18 RF Cable Configuration Guide and Command Reference
load-balance execution-rule
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Load balancing 10-19
load-balance execution-rule
Properties (continued)
Property name Description
Example:
Example:
CASA(load-bal-exe-rule 5)#
suspicious-channel retry interval 3600
Casa Systems
10-20 RF Cable Configuration Guide and Command Reference
load-balance execution-rule
Properties (continued)
Property name Description
threshold load <0:100> Load difference between interfaces to start static load
[enforce <0:100>] balancing, the number of modems on the modem
[dynamic minimum <2:500> method or the percentage on the utilization method,
| minimum <2:500>] default 10. The optional additional modifiers are as
follows:
Example:
CASA(load-bal-exe-rule 5)#
upstream-interval 60
CASA(load-bal-exe-rule 5)#
no upstream-interval 60
Casa Systems
Load balancing 10-21
load-balance execution-rule
Properties (continued)
Property name Description
Example:
CASA(load-bal-exe-rule 5)#
upstream-method modem dynamic
CASA(load-bal-exe-rule 5)#
no upstream-method dynamic
CASA(load-bal-exe-rule 5)#
no upstream-method
CASA(load-bal-exe-rule 5)#
upstream-threshold load 100
CASA(load-bal-exe-rule 5)#
no upstream-threshold
load-balance execution-rule 1
method modem
threshold load 100 dynamic minimum 2
Casa Systems
10-22 RF Cable Configuration Guide and Command Reference
load-balance general-group
load-balance general-group
Purpose
Modes
(config)#
(load-bal-general-default)#
(load-bal-general-mac-<id>-sg-<name>)#
Syntax
(config)#
load-balance general-group default-settings
(load-bal-general-default)#
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
policy-id <0:4294967295>
(config)#
[no] load-balance general-group mac-domain <1:96> service-group <name>
(load-bal-general-mac-x-sg-y)#
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
policy-id <0:4294967295>
Casa Systems
Load balancing 10-23
load-balance general-group
Properties
Property name Description
Example:
CASA(config)# load-balance
general-group default-settings
CASA(load-bal-general-default)#
Example:
CASA(load-bal-general-default)# enable
CASA(load-bal-general-default)#
no enable
Casa Systems
10-24 RF Cable Configuration Guide and Command Reference
load-balance general-group
Properties (continued)
Property name Description
Example:
CASA(load-bal-general-default)#
initial-tech broadcast-ranging
Casa Systems
Load balancing 10-25
load-balance general-group
Properties (continued)
Property name Description
policy-id <0:4294967295> Sets the load-balance policy for the load balancing
general group. The default for the load-balance
general-group is no policy-id.
Example:
CASA(load-bal-general-default)#
policy-id 2
Example:
CASA(config)# load-balance
general-group mac-domain 1
service-group FN_A
CASA(config)# no load-balance
general-group mac-domain 1
service-group FN_A
CASA(load-bal-general-mac-1-sg-FN_A)#
Example:
CASA(load-bal-general-mac-1-sg-FN_A)#
enable
CASA(load-bal-general-mac-1-sg-FN_A)#
no enable
Casa Systems
10-26 RF Cable Configuration Guide and Command Reference
load-balance general-group
Properties (continued)
Property name Description
CASA(load-bal-general-mac-1-sg-FN_A)#
initial-tech broadcast-ranging
Example:
CASA(load-bal-general-mac-1-sg-FN_A)#
policy-id 2
Casa Systems
Load balancing 10-27
load-balance general-group
Casa Systems
10-28 RF Cable Configuration Guide and Command Reference
load-balance permit dbc-chg-prim-ds
Mode
(config)#
Syntax
[no] load-balance permit dbc-chg-prim-ds [dcc-retry <0:10>]
Properties
Property name Description
Example:
Casa Systems
Load balancing 10-29
load-balance policy
load-balance policy
Purpose
The load-balance policy command sets policies for load balancing (up to 20). To set a
policy:
Modes
(config)#
(load-bal-policy <id>)#
Syntax
(config)# [no] load-balance policy <1:4294967295>
(load-bal-policy x)#
[no] cable tag <name> {both | dynamic | static}
[no] rule basic <1:4294967295>
rule execution <1:16>
no rule execution
Properties
Property name Description
Example:
Casa Systems
10-30 RF Cable Configuration Guide and Command Reference
load-balance policy
Properties (continued)
Property name Description
cable tag <name> {both | Cable tag for the load balancing policy, as defined by
dynamic | static} the cable tag command. One of the following options
is required:
Example:
Example:
Example:
CASA(load-bal-policy 1)#
rule execution 1
CASA(load-bal-policy 1)#
no rule execution
Casa Systems
Load balancing 10-31
load-balance policy
load-balance policy 1
rule execution 1
rule basic 1
rule basic 2
Casa Systems
10-32 RF Cable Configuration Guide and Command Reference
load-balance restricted-cm
load-balance restricted-cm
Purpose
Modes
(config)#
(load-bal-restrict-cm <id>)#
Syntax
(config)# [no] load-balance restricted-cm <1:4294967295>
(load-bal-restrict-cm x)#
cable tag <name>
mac addr <addr> [mask <mask>]
restricted-load-balance-group <1:4294967295>
no restricted-load-balance-group
service-type-id <name>
no service-type-id
Properties
Property name Description
Example:
CASA(config)# load-balance
restricted-cm 1
CASA(load-bal-restrict-cm 1)# exit
CASA(config)#
no load-balance restricted-cm 1
Casa Systems
Load balancing 10-33
load-balance restricted-cm
Properties (continued)
Property name Description
cable tag <name> Cable tag for the restricted load balancing policy, as
defined by the cable tag command.
Example:
mac addr <addr> [mask MAC address of the modem, in 48-bit xxxx.xxxx.xxxx
<mask>] format, and optional mask (if omitted, defaults to
FFFF.FFFF.FFFF).
Example:
CASA(load-bal-restrict-cm 1)#
restricted-load-balance-group 1
CASA(load-bal-restrict-cm 1)#
no restricted-load-balance-group
Example:
CASA(load-bal-restrict-cm 1)#
service-type-id plant1
CASA(load-bal-restrict-cm 1)#
no service-type-id
Casa Systems
10-34 RF Cable Configuration Guide and Command Reference
load-balance restricted-cm
load-balance restricted-cm 1
mac addr 0022.2d77.fc56
2 1/0/1 0
3 1/0/2 0
2 4/1.1/0 0
3 4/1.2/0 0
Casa Systems
Load balancing 10-35
load-balance restricted-group
load-balance restricted-group
Purpose
Modes
(config)#
(load-bal-restrict <id>)#
Syntax
(config)# [no] load-balance restricted-group <1:4294967295>
(load-bal-restrict x)#
docsis-mac <1:96>
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
[no] ofdm <slot>/<port>/<chan>
[no] ofdma <slot>/<port>.<phy_chan>
policy-id <0:4294967295>
[no] qam <slot>/<port>/<chan> [<1:80>]
[no] service-type-id <name>
[no] upstream <slot>/<port>.<chan>/<log_chan> [<1:8>]
Casa Systems
10-36 RF Cable Configuration Guide and Command Reference
load-balance restricted-group
Properties
Property name Description
Example:
CASA(config)# load-balance
restricted-group 1
CASA(load-bal-restrict 1)# exit
CASA(config)#
no load-balance restricted-group 1
Example:
Example:
Casa Systems
Load balancing 10-37
load-balance restricted-group
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
10-38 RF Cable Configuration Guide and Command Reference
load-balance restricted-group
Properties (continued)
Property name Description
policy-id <0:4294967295> Sets the load-balance policy for the load balancing
restricted group.
Example:
Example:
Example:
CASA(load-bal-restrict 1)#
service-type-id plant1
CASA(load-bal-restrict 1)#
no service-type-id plant1
Casa Systems
Load balancing 10-39
load-balance restricted-group
Properties (continued)
Property name Description
Example:
Casa Systems
11-1
Configuration summary
Table 11-1 lists and briefly describes the objects related to modulation profiles.
Casa Systems
11-2 RF Cable Configuration Guide and Command Reference
modulation-profile
modulation-profile
Purpose
There are five “Predefined modulation profiles.” This means that any new ones added
have an ID of 6 or higher. The predefined profiles are recommended. However, you
can use the predefined profiles to create profiles in auto mode, which is by simply
specifying the operation mode and modulation type when creating the profile. For
example, specifying qpsk creates a profile the same as predefined modulation profile
1; specifying 16qam creates a profile the same as predefined modulation profile 2.
• If all modems are running DOCSIS 2.0 or 3.0, use Asynchronous Time Division
Multiple Access (ATDMA) mode.
• If the upstream interface has 1.1 or 1.0 modems and 2.0 or 3.0 modems, use
Modified Time Division Multiple Access (MTDMA) mode.
• If all modems are 1.0 or 1.1, use Time Division Multiple Access (TDM) mode.
Mode
(config)#
Syntax
(config)#
[no] modulation-profile <6:1024> [<operation_mode>]
[<modulation_type>]
(config-mod-profile-<id>)#
a-long
a-short
initial
Casa Systems
Modulation profiles 11-3
modulation-profile
long
request
short
station
ugs
Properties
Property name Description
Example:
CASA(config)# modulation-profile 10
CASA(config-mod-prof-10)# exit
CASA(config)# no modulation-profile 10
Casa Systems
11-4 RF Cable Configuration Guide and Command Reference
modulation-profile
Properties (continued)
Property name Description
CASA(config)#
modulation-profile 10 tdma
CASA(config-mod-prof-10)#
Casa Systems
Modulation profiles 11-5
modulation-profile
Properties (continued)
Property name Description
Example:
CASA(config)#
modulation-profile 10 tdma qpsk
CASA(config-mod-prof-10)#
modulation-profile 2
-->> Similar to profile 1 except uses 16qam for short and long data
burst types for TDMA upstream channels.
request tdma qpsk off 64 0 16 338 0 16 fixed on
initial tdma qpsk off 640 5 34 338 0 48 fixed on
station tdma qpsk off 384 5 34 338 0 48 fixed on
short tdma 16qam off 168 6 75 338 7 16 shortened on
Casa Systems
11-6 RF Cable Configuration Guide and Command Reference
modulation-profile
modulation-profile 3
-->> ATDMA type profile; uses QPSK for management bursts, 64qam for
data traffic.
request atdma qpsk off 64 0 16 338 0 16 fixed on 1 1536 qpsk0
initial atdma qpsk off 640 5 34 338 0 48 fixed on 1 1536 qpsk0
station atdma qpsk off 384 5 34 338 0 48 fixed on 1 1536 qpsk0
a-short atdma 64qam off 104 12 75 338 6 16 shortened on 1 1536 qpsk1
a-long atdma 64qam off 104 16 220 338 0 16 shortened on 1 1536 qpsk1
modulation-profile 4
-->> MTDMA type profile; uses QPSK for management bursts, 16qam for
TDMA data traffic, 64qam for ATDMA data traffic.
request mtdma qpsk off 64 0 16 338 0 16 fixed on 1 1536 qpsk0
initial mtdma qpsk off 640 5 34 338 0 48 fixed on 1 1536 qpsk0
station mtdma qpsk off 384 5 34 338 0 48 fixed on 1 1536 qpsk0
short mtdma 16qam off 168 6 75 338 7 16 shortened on 1 1536 qpsk1
long mtdma 16qam off 192 8 220 338 0 16 shortened on 1 1536 qpsk1
a-short mtdma 64qam off 104 12 75 338 6 16 shortened on 1 1536 qpsk1
a-long mtdma 64qam off 104 16 220 338 0 16 shortened on 1 1536 qpsk1
modulation-profile 5
-->> SCDMA type profile; uses QPSK for management bursts, 128qam for
SCDMA data traffic.
request scdma qpsk off 64 0 16 338 1 0 fixed on qpsk0 on 2 1 off
initial scdma qpsk off 640 5 34 338 0 0 fixed on qpsk0 off 2 1 off
station scdma qpsk off 512 5 34 338 0 0 fixed on qpsk0 off 2 1 off
a-short scdma 128qam off 64 5 33 338 12 0 shortened on qpsk0 on 128 1
on
a-long scdma 128qam off 64 10 156 338 0 0 shortened on qpsk0 on 128 1
on
Casa Systems
Modulation profiles 11-7
a-long
a-long
Purpose
The a-long command configures a modulation profile for an a-long data grant used
for transmitting large upstream data in DOCSIS 2.0, 3.0, and 3.1.
Mode
(config-mod-profile-<id>)#
Syntax
a-long <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Properties
Property name Description
• atdma
• mtdma
• scdma
Note: SCDMA is not currently supported as a
modulation operation.
<modulation_type> One of the modulation types described in the
<modulation_type> property.
{on | off} Diff encoding, either on or off.
<1:1024> Preamble length. CM burst preambles are a known
data pattern sent to all CMs by the CMTS through the
Upstream Channel Descriptor (UCD).
<0:16> FEC-T bytes.
<16:255> FEC-K bytes, where FEC-T and FEC-K cannot add
up to more than 255 bytes.
Casa Systems
11-8 RF Cable Configuration Guide and Command Reference
a-long
Properties (continued)
Property name Description
Example
CASA(config)# modulation-profile 6
CASA(config-mod-prof-6)# a-long atdma 64qam off 104 4 220 338 0 8 fixed
on 1 1536 qpsk1
Casa Systems
Modulation profiles 11-9
a-short
a-short
Purpose
The a-short command configures an a-short data grant used for transmitting smaller
upstream data in DOCSIS 2.0 and 3.0.
See the a-long command for a description of the properties. The a-short modulation
profile has the following operation modes, as recommended:
• atdma
• mtdma
• scdma
Mode
(config-mod-profile-<id>)#
Syntax
a-short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 7
CASA(config-mod-prof-7)# a-short atdma 64qam off 104 4 75 338 6 8 fixed
on 1 1536 qpsk1
Casa Systems
11-10 RF Cable Configuration Guide and Command Reference
initial
initial
Purpose
The initial command defines an initial data grant used for transmitting upstream data
when, an interval in which new CMs can join the network.
See the a-long command for a description of the properties. The initial modulation
profile has the following operation modes, as recommended:
• atdma
• mtdma
• scdma
• tdma
Mode
(config-mod-profile-<id>)#
Syntax
initial <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 8
CASA(config-mod-prof-8)# initial atdma qpsk off 640 5 34 338 0 48 fixed
on 1 1536 qpsk0
Casa Systems
Modulation profiles 11-11
long
long
Purpose
The long command defines a long data grant used for transmitting large upstream data
in DOCSIS 1.0 and 1.1. The number of minislots in the interval is larger than the
maximum for short interval transmissions.
See the a-long command for a description of the properties. The long modulation
profile has the following operation modes, as recommended:
• mtdma
• tdma
Mode
(config-mod-profile-<id>)#
Syntax
long <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 9
CASA(config-mod-prof-9)# long tdma qpsk off 640 5 34 338 0 48 fixed on
Casa Systems
11-12 RF Cable Configuration Guide and Command Reference
request
request
Purpose
The request command defines a request data grant used for transmitting upstream
data, an interval in which requests can be made for bandwidth for upstream data
transmission.
See the a-long command for a description of the properties. The request modulation
profile has the following operation modes, as recommended:
• atdma
• mtdma
• scdma
• tdma
Mode
(config-mod-profile-<id>)#
Syntax
request <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 10
CASA(config-mod-prof-10)# request atdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
Casa Systems
Modulation profiles 11-13
short
short
Purpose
The command defines a short data grant used for transmitting shorter upstream data in
DOCSIS 1.0 and 1.1. The interval for a short interval is less than or equal to
maximum-burst-size defined in the short profile.
See the a-long command for a description of the properties. The short modulation
profile has the following operation modes, as recommended:
• mtdma
• tdma
Mode
(config-mod-profile-<id>)#
Syntax
short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 11
CASA(config-mod-prof-11)# short mtdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
Casa Systems
11-14 RF Cable Configuration Guide and Command Reference
station
station
Purpose
The station command defines a station data grant used for transmitting upstream data,
an interval in which CMs are expected to perform some aspect of routine network
maintenance, such as ranging or power adjustment.
See the a-long command for a description of the properties. The station modulation
profile has the following operation modes, as recommended:
• atdma
• mtdma
• scdma
• tdma
Mode
(config-mod-profile-<id>)#
Syntax
station <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 12
CASA(config-mod-prof-12)# station atdma qpsk off 384 5 34 338 0 48
fixed on 1 1536 qpsk0
Casa Systems
Modulation profiles 11-15
ugs
ugs
Purpose
The ugs command defines an Unsolicited Grant Service (UGS) data grant used for
transmitting upstream data. The UGS algorithm is designed to support real-time
service flows, such as Voice over IP (VoIP), that generate fixed size data packets
periodically. The grant period is negotiated during the initialization process of the
connection. Unsolicited Grant Service with Activity Detection (UGS-AD) also
incorporates activity detection to address UL resource wastage in the UGS algorithm,
which makes it suitable for use with on/off voice codecs.
See the a-long command for a description of the properties. The UGS modulation
profile has the following operation modes, as recommended:
• atdma
• mtdma
• scdma
Mode
(config-mod-profile-<id>)#
Syntax
ugs <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 13
CASA(config-mod-prof-13)# ugs atdma qpsk off 384 5 34 338 0 48 fixed on
1 1536 qpsk0
Casa Systems
11-16 RF Cable Configuration Guide and Command Reference
Related show commands
Shows the modulation profile configuration, including the default first five profiles.
The additional table modifier renders the output in table form. Note that the show run
output omits the default first five profiles and shows no profiles if no additional ones
are defined.
Casa Systems
Modulation profiles 11-17
Related show commands
0 to 1 0 0
1 to 3 65 0
3 to 10 35 0
10 to 50 0 0
50 to 500 0 0
500 to 2000 0 0
2000 to 10000 0 0
10000 to 50000 0 0
> 50000 0 0
Casa Systems
12-1
This chapter describes the multicast operations on the cable side. The “Multicast
network operations” chapter in the Casa Systems – NSI Configuration Guide and
Command Reference describes the multicast network operations.
You can identify limited multicast sessions by using the application ID, an attribute
that can be configured into a group QoS configuration. It currently has no significance
Casa Systems
12-2 RF Cable Configuration Guide and Command Reference
Limited multicast sessions
to the CMTS. An application policy is a new object that is used to store application
attributes, such as limiting replication for multicast sessions. The procedure for
identifying a limited multicast session is:
1. Configure a multicast group table with matching group-address and QoS ID.
2. Configure the multicast group QoS with a specified application ID.
3. Configure the application policy to limit replication and with the maximum
number of IPTV channels.
Configuration summary
Table 12-1 lists and briefly describes the objects related to multicast cable operations.
Casa Systems
Multicast cable operations 12-3
Limited multicast sessions
Casa Systems
12-4 RF Cable Configuration Guide and Command Reference
mcast-classifier ds_chan
mcast-classifier ds_chan
Purpose
Mode
(config)#
Syntax
mcast-classifier ds_chan <slot>/<port>/<chan> cl_id <1:4092> sf_id
<1:4092> [dst-ip <ip_addr> <mask> | pri <0:24> | protocol
<0:257> | src-ip <ip_addr> <mask> | tos <0:255> <0:255> <0:255>
no mcast-classifier ds_chan <slot>/<port>/<chan> cl_id <1:4092>
Properties
Property name Description
Example:
Casa Systems
Multicast cable operations 12-5
mcast-classifier ds_chan
Properties (continued)
Property name Description
Example:
protocol <0:257> Optional IP protocol number, 256 for all protocols and
257 for TCP/UDP, which can be followed by the tos
value.
Example:
src-ip <ip_addr> <mask> Optional source IP address and mask values, which
can be followed by the dst-ip, protocol, or tos value.
Example:
tos <0:255> <0:255> <0:255> Optional type of service (ToS), with the low, high, and
mask values, indicated at the end of the command.
Multicast group classifiers must be configured to
enable forwarding of both clear and encrypted
multicast IPTV streams.
Example:
Casa Systems
12-6 RF Cable Configuration Guide and Command Reference
mcast-service-flow ds_chan
mcast-service-flow ds_chan
Purpose
A multicast service flow is a specific type of flow where the packets comprising the
flow require particular treatment by the network forwarding devices along the path to
the packet’s destination.
Mode
(config)#
Syntax
mcast-service-flow ds_chan <slot>/<port>/<chan> sf_id <1:4092> dsid
<1:4092> pri <0:7> gu_rate <Bps> gu_buf_sz <bytes> mx_rate <Bps>
mx_buf_sz <bytes> [default]
no mcast-service-flow ds_chan <slot>/<port>/<chan> sf_id <1:4092>
Properties
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1
CASA(config)# no mcast-service-flow
ds_chan 2/0/0 sf_id 1
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1
Casa Systems
Multicast cable operations 12-7
mcast-service-flow ds_chan
Properties (continued)
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
mx_buf_sz 64
Casa Systems
12-8 RF Cable Configuration Guide and Command Reference
mcast-service-flow ds_chan
Properties (continued)
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
mx_buf_sz 64 default
Casa Systems
Multicast cable operations 12-9
multicast authorization
multicast authorization
Purpose
Modes
(config)#
(conf-auth-file <name>)#
Syntax
(config)#
multicast authorization default-action {deny | permit}
[no] multicast authorization enable
[no] multicast authorization match-profile <name>
multicast authorization max-session-num <0:65535>
Properties
Property name Description
Example:
Casa Systems
12-10 RF Cable Configuration Guide and Command Reference
multicast authorization
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Casa Systems
Multicast cable operations 12-11
multicast authorization
Properties (continued)
Property name Description
Example:
Casa Systems
12-12 RF Cable Configuration Guide and Command Reference
multicast authorization
Properties (continued)
Property name Description
CASA(conf-auth-file MYPROF)#
session-rule 1234 accept 192.168.6.6/24
224.168.5.5/24 priority 1
max number of rules has been
configured: 512
CASA(conf-auth-file MYPROF)#
no session-rule 1234
Casa Systems
Multicast cable operations 12-13
Related show command examples
Shows the multicast authorization profile configuration with the session rule.
Shows the multicast client sessions, with the optional group address filter.
Shows the multicast IGMP client database entries, optionally for a specific IPv4
address. There can be up to 192K multicast IGMP clients.
Casa Systems
12-14 RF Cable Configuration Guide and Command Reference
multicast default grp-service-class-name
Mode
(config)#
Syntax
multicast default grp-service-class-name <name>
no multicast default grp-service-class-name
Properties
Property name Description
Example:
Casa Systems
Multicast cable operations 12-15
multicast group
multicast group
Purpose
The multicast group command configures a multicast group and its properties.
Dynamic IPTV sessions are allowed only if there is a matching classifier defined for
the group. In the multicast group configuration, specify the group-address prefix to
match the supported multicast session. This is required to enable forwarding of both
clear and encrypted multicast IPTV streams. If not matched, IGMP join/leave packets
are dropped. The additional encryption-id parameter is necessary for encryption to be
applied to a matching multicast session. If not specified, traffic is forwarded clear.
Modes
(config)#
(conf-grp-config <id>)#
Syntax
(config)#
[no] multicast group config <1:4294967295>
(conf-grp-config x)#
encryption-id <0:65535>
group-address {<ip_addr>/<mask> | ipv6 <v6_addr>/<prefix>}
phs-id <0:65535>
priority <0:255>
qos-id <0:65535>
source-address {<ip_addr>/<mask> | ipv6 <v6_addr>/<prefix>}
tos-high <0:255>
tos-low <0:255>
tos-mask <0:255>
vrf <id>
(config)#
multicast group encryption <1:65535> algorithm {aes128 | cmts | des40 |
des56}
no multicast group encryption <1:65535>
multicast group qos <1:65535> <class_name> {aggregate max-sess
<1:65535> | single} [app-id <1:32>}
no multicast group qos <1:65535>
Casa Systems
12-16 RF Cable Configuration Guide and Command Reference
multicast group
Properties
Property name Description
Example:
Example:
Example:
Casa Systems
Multicast cable operations 12-17
multicast group
Properties (continued)
Property name Description
Example:
qos-id <0:65535> Identifies the qos instance for configuring the QoS for
the replications of the sessions matching this GC, if
QoS treatment is required. The value 0 indicates that
QoS is allocated based on the default SCN for all
replications derived from this group configuration.
Example:
Example:
Example:
Casa Systems
12-18 RF Cable Configuration Guide and Command Reference
multicast group
Properties (continued)
Property name Description
tos-low <0:255> Low value of a range of the type of service (ToS) byte
value to be defined in a packet classifier.
Example:
tos-mask <0:255> Mask value bitwise and with a type of service (ToS)
byte value to be defined in a packet classifier.
Example:
Example:
Example:
Casa Systems
Multicast cable operations 12-19
multicast group
Properties (continued)
Property name Description
Example:
Casa Systems
12-20 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the multicast replication for each session, with the optional QAM module
specified.
Casa Systems
Multicast cable operations 12-21
multicast load-balance initial-tech
The multicast load-balance initial-tech command sets the initial ranging technique
for load balancing. For details on load balancing, see Chapter 10, “Load balancing.”
Mode
(config)#
Syntax
multicast load-balance initial-tech broadcast-ranging
multicast load-balance initial-tech direct
multicast load-balance initial-tech period-ranging
multicast load-balance initial-tech reinitialize-mac
multicast load-balance initial-tech unicast-ranging
Properties
Property name Description
Example:
Example:
Casa Systems
12-22 RF Cable Configuration Guide and Command Reference
multicast load-balance initial-tech
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Multicast cable operations 12-23
multicast max channel-util
The multicast max channel-util command sets the maximum percentage threshold
for multicast streams per channel. Once the channel reaches the configured threshold,
no further multicast sessions are allowed on that channel. If the threshold percentage
is too low, bandwidth may be wasted (unusable for multicast), or the channel will be
used entirely for unicast traffic. If the threshold percentage is too high, the channel
may become congested with multicast traffic. Casa recommends that you monitor the
default configuration setting of 60 and then tune the value for best performance.
Mode
(config)#
Syntax
multicast max channel-util <1:100>
Properties
Property name Description
Example:
Casa Systems
12-24 RF Cable Configuration Guide and Command Reference
multicast single_said
multicast single_said
Purpose
Mode
(config)#
Syntax
[no] multicast single_said
interface docsis-mac
multicast-dsid-forward
Enables multicast Downstream Service Identifier (DSID) forwarding that allows CMs
to filter multicast traffic before forwarding the traffic to CPE devices. (See the
DOCSIS MAC multicast-dsd-forward property for details.)
interface docsis-mac
no mgmd ipv4 shutdown
Casa Systems
Multicast cable operations 12-25
Related show command examples
interface vlan
rate-limit multicast
Performs a rate limit on the multicast upstream for the VLAN, in maximum number of
packets permitted per second (default no limit).
Casa Systems
12-26 RF Cable Configuration Guide and Command Reference
multicast switch over time
The multicast switch over time command sets the time to switch over from multicast
to unicast and determines how long the CCAP forwards multicast streams to CMs
before changing them to multiple unicast streams. See also the
load-balance execution-rule permit multicast-session modem move property.
Mode
(config)#
Syntax
[no] multicast switch over time <100:10000>
Properties
Property name Description
Example:
Casa Systems
13-1
• Source IP address
• Destination IP address
• IP protocol
• Source port number
• Destination port number
• Type of service (ToS)
• Ingress interface (SNMP IfIndex).
NetFlow depends on a sampling rate. The Casa minimum sampling rate is defined as
one packet out of one thousand packets.
Casa Systems
13-2 RF Cable Configuration Guide and Command Reference
NetFlow monitoring commands description
Configuration summary
Table 13-1 lists and briefly describes the objects related to NetFlow monitoring.
Casa Systems
NetFlow monitoring 13-3
flow exporter-map
flow exporter-map
Purpose
The flow exporter-map command configures an exporter map and its parameters.
Only one exporter map by name is supported initially.
Mode
(config)#
(config-ipfix exporter <n>)#
Syntax
(config)# [no] flow exporter-map <name>
(config-ipfix exporter <n>)#
destination <ip>
options {interface-table | sampler-table} timeout <120:3600>
source loopback <0:255>
template {data | options} timeout <120:3600>
transport udp {dst-port | src-port} <1024:65535>
Properties
Property name Description
Example:
Example:
Casa Systems
13-4 RF Cable Configuration Guide and Command Reference
flow exporter-map
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
NetFlow monitoring 13-5
flow exporter-map
UPS 9/ 9: nobuf 0
UPS 12/12: nobuf 0
QAM 1/ 5: nobuf 0
QAM 5/ 5: nobuf 0
QAM 10/10: nobuf 0
TTL 0/ 0: nobuf 0
Casa Systems
13-6 RF Cable Configuration Guide and Command Reference
flow monitor-map
flow monitor-map
Purpose
The flow monitor-map command configures a flow monitor map and its parameters.
Each monitor has a data cache. An export packet is generated when the cache is full or
the cache timeout is reached.
Mode
(config)#
(config-ipfix monitor <n>)#
Syntax
(config)# flow monitor-map <name>
(config-ipfix monitor <n>)#
cache timeout update <120:3600>
exporter <name>
record {dual | ipv4 | ipv6}
Properties
Property name Description
Example:
Casa Systems
NetFlow monitoring 13-7
flow monitor-map
Properties (continued)
Property name Description
Example:
record {dual | ipv4 | IP protocol of the traffic for monitoring: dual stack,
ipv6} IPv4, or IPv6.
Example:
Instantiates NetFlow egress and ingress monitors for the IP bundle interface.
Casa Systems
13-8 RF Cable Configuration Guide and Command Reference
flow sampler-map
flow sampler-map
Purpose
The flow sampler-map command configures a flow sampler map and its parameters.
Only one sampler map by name is supported initially. The minimum sampler rate is
one out of a thousand packets.
Mode
(config)#
(config-ipfix sampler <n>)#
Syntax
(config)# flow sampler-map <name>
(config-ipfix sampler <n>)#
random 1-out-of <1000:10000>
Properties
Property name Description
Example:
Example:
Casa Systems
NetFlow monitoring 13-9
flow sampler-map
Shows the flow exporter map configuration. A source loopback ID of -1 indicates that
it is not defined.
Casa Systems
14-1
OFDM description
Orthogonal Frequency Division Multiplexing (OFDM) is a data transmission method
where a large number of closely spaced or overlapping very-narrow-bandwidth
orthogonal (mutually exclusive) QAM signals are transmitted in a given channel.
OFDM provides the downstream function, while Orthogonal Frequency Division
Multiplexing Multiple Access (OFDMA) provides the upstream function. The feature
is available for the QAM 8x192 module and UPS 16x8 line card on the C100G and
C40G platforms and is based on the following DOCSIS 3.1 standards:
• http://www.cablelabs.com/wp-content/uploads/specdocs/
CM-SP-CCAP-OSSIv3.1-I01-140808.pdf
• http://www.cablelabs.com/wp-content/uploads/specdocs/
CM-SP-PHYv3.1-I01-131029.pdf
Each of the QAM signals, called a subcarrier, carries a small percentage of the total
payload at a very low data rate. In OFDM, the subcarrier frequencies are chosen so
that the subcarriers are orthogonal to each other, meaning that crosstalk between the
subchannels is eliminated and intercarrier guard bands are not required. This greatly
simplifies the design of both the transmitter and the receiver. In conventional FDM, a
separate filter for each subchannel is required.
OFDMA handles the upstream function for DOCSIS 3.1. For details on OFDMA, see
Chapter 15, “Orthogonal Frequency Division Multiple Access.”
Casa Systems
14-2 RF Cable Configuration Guide and Command Reference
Definitions
Configuration summary
Table 14-1 lists and briefly describes the objects related to OFDM.
Definitions
Casa Systems
Orthogonal Frequency Division Multiplexing 14-3
Definitions
cyclic prefix — Enables the receiver to overcome the effects of inter-symbol and
intercarrier interference caused by micro-reflections in the channel. There are five
possible values and the choice depends on the delay spread of the channel. A longer
delay spread requires a longer cyclic prefix.
lower-freq — Defines the lowest active subcarrier frequency, range 108–1196 MHz.
upper-freq — Defines the highest active subcarrier frequency, range 130–1218 MHz.
next codeword pointer (NCP) —A codeword is a forward error correction (FEC) data
block, comprising a combination of information bytes and parity bytes. The NCP
identifies the physical (PHY) parameters communicated from the CMTS to CMs.
NCP points to the beginning of codewords in a symbol, counting only data
subcarriers. Each FEC-encoded NCP is 48 bits wide. NCPs may be modulated using
QPSK (the default), 16-QAM or 64-QAM, and this modulation is signaled by the
physical link channel (PLC). In addition to the NCPs carrying next codeword pointers,
there is also an NCP carrying the cyclic redundancy check (CRC) for all the NCPs of
the symbol. For 8K FFT mode, there will be NCPs in each symbol. For 4K FFT mode,
there will be one set of NCPs per pair of symbols.
NCP modulation — Defines the modulation of all subcarriers in the NCP channel. If
omitted, the modulation is automatically configured by the CCAP. The NCP profile is
assigned profile ID 255. NCPs may be modulated using QPSK (the default), 16-QAM
or 64-QAM and this modulation is signaled by the physical link channel (PLC).
pilot — A dedicated OFDM subcarrier that can be used for channel estimation
(measurement of channel condition), synchronization, and other purposes. Pilot
subcarriers do not carry data. There are three types of pilots: continuous, scattered,
and complementary. Continuous pilots occur at the same frequency location in every
Casa Systems
14-4 RF Cable Configuration Guide and Command Reference
Definitions
OFDM symbol and are used for frequency and phase synchronization. Scattered pilots
occur at different frequency locations in different symbols and are used for channel
estimation. Complementary pilots are at a lower modulation order, allow phase
tracking along the time axis for frequency offset and phase noise correction, and are
used by the CMTS upstream receiver to enhance signal processing. A set of pilot
patterns is defined from which the CMTS or operator can select to match the
frequency response of the network. The pilot-scale-factor indicates the scale factor for
calculating the number of continuous pilots for a downstream channel.
plc-freq — The PHY link channel (PLC) frequency, the center frequency of the lowest
subcarrier of the 6 MHz encompassed spectrum containing the PLC at its center. The
frequency of this subcarrier is required to be located on a 1-MHz grid and outside any
defined exclusion zone. The aim of the PLC is to convey to the CM the physical
properties of the OFDM channel.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-5
OFDM configuration steps
subcarrier spacing — Defines the KHz spacing associated with a particular FFT
mode configured on the OFDM downstream channel. If it is 4K mode, the subcarrier
spacing is 50 KHz (the default). If it is 8K mode, the subcarrier spacing is 25 KHz.
The steps to configuring downstream OFDM are the following (see also the “OFDM
configuration examples” section):
Casa Systems
14-6 RF Cable Configuration Guide and Command Reference
QAM 8x192 support of shared channels
8. Configure any exclusion zones on the QAM port level using a QAM interface
ofdm port-exclusion-band <1:16> configuration.
9. Configure the interface docsis-mac for the OFDM downstream binding.
10. Configure the service group for the OFDM downstream binding.
11. Save the configuration by using the copy run start command.
12. Perform a system reboot to load the configuration to the active and standby SMM
modules.
The QAM 8x192 line card can support 192 shared (broadcast) channels if two OFDM
channels are used per port. With one OFDM channel per port, 128 broadcast channels
are supported. The following is a review:
• QAM 8x192 supports eight ports per slot, 32 channels per port, and up to 192
shared channels. Hence:
• One OFDM channel per port provides up to 64 single-carrier channels and 128
shared channels. The maximum number of narrowcast channels per port is 80
(64 + 128/8).
• Two OFDM channels per port provides up to 32 single-carrier channels and 192
shared channels. The maximum number of narrowcast channels per port is 56
(32 + 192/8).
Note: A module changeover from one OFDM channel to two channels, and vice
versa, requires a module reboot. For example:
CASA(config)# module
CASA(config)# module 1 ofdm-channels 2
Need to reboot module 1 to apply the change.
CASA(config)# end
CASA# reboot module 1
Casa Systems
Orthogonal Frequency Division Multiplexing 14-7
ofdm
ofdm
Purpose
The ofdm command sets two Orthogonal Frequency Division Multiplexing (OFDM)
downstream parameters: a frequency exclusion band and a profile.
Modes
(config)#
(conf-ofdm-exclusion-band <1:16>)
(conf-ofdm-profile <1:64>)
Syntax
(config)# [no] ofdm exclusion-band <1:16>
(conf-ofdm-exclusion-band x)
[no] exclusion-subcarrier-group <1:128> <108000000:1218000000>
<108000000:1218000000>
[no] ofdm exclusion-band <1:16>...
Properties
Property name Description
Example:
Casa Systems
14-8 RF Cable Configuration Guide and Command Reference
ofdm
Properties (continued)
Property name Description
CASA(conf-ofdm-exclusion-band 1)#
exclusion-subcarrier-group 1 108000000
109000000
CASA(conf-ofdm-exclusion-band 1)#
no exclusion-subcarrier-group 1
108000000 109000000
Example:
Casa Systems
Orthogonal Frequency Division Multiplexing 14-9
ofdm
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
14-10 RF Cable Configuration Guide and Command Reference
ofdm
Properties (continued)
Property name Description
Example:
CASA(conf-ofdm-profile 1)#
profile-modulation 256qam
Example:
CASA(conf-ofdm-profile 1)#
subcarrier-group 1 108000000 109000000
modulation 256qam
CASA(conf-ofdm-profile 1)#
no subcarrier-group 1 108000000
109000000 modulation 256qam
Casa Systems
Orthogonal Frequency Division Multiplexing 14-11
ofdm
Properties (continued)
Property name Description
• 16qam
• 64qam
• 128qam
• 256qam
• 512qam
• 1024qam
• 2048qam
• 4096qam
Example:
Casa Systems
14-12 RF Cable Configuration Guide and Command Reference
ofdm
show all ports that are binding to this ofdm exclusion band 1:
ofdm profile 1
profile-modulation 256qam
subcarrier-group 1 110000000 120000000 modulation 256qam
subcarrier-group 2 130000000 140000000 modulation 256qam
skip-modulation 16qam
ofdm profile 2
profile-modulation zero
subcarrier-group 1 108000000 109000000 modulation zero
skip-modulation zero
Shows the cable Downstream Profile Descriptor (DPD) message for the OFDM
channel. The optional plc modifier shows the PHY Link Channel (PLC) output only.
Only channel 0 can currently be specified. Profiles 0–3 are user defined and profile 4
is the Next Codeword Pointer (NCP) profile.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-13
ofdm
Control: 03 Version: 05
Type: dpd(50) RSVD: 00
Reports the return modulation error rate (RxMER) values for subcarriers of an OFDM
channel to help determine how to transmit data to the CM as efficiently as possible by
properly configuring the profile settings for all subcarriers. RxMER is defined as the
ratio of the average power of the ideal QAM constellation to the average error-vector
power. The OFDM Downstream Spectrum (ODS) report is initiated as an ODS
request (ODS-REQ) by way of the cable ods-req [<n>:]<slot>/<port>/<chan>
command in diagostic mode (executed under Casa technical support supervision
only). Thresholds are set by the ofdm profile-modulation rxmer threshold
command. The report is cleared through the clear cable ods-report ofdm
[<n>:]<slot>/<port>/<chan> command in diagnostic mode. Up to a thousand ODS
reports are supported. The RxMER values are reported from lowest to highest active
subcarrier, in hex as 4 x dB (in the range 0x00–0xFE), such as in the example the first
value, 84, translates to decimal 132, which yields 132 x .25 = 33 dB.
Shows how many OFDM channels are configured with each QAM 8x192 module.
Casa Systems
14-14 RF Cable Configuration Guide and Command Reference
interface qam
interface qam
Purpose
The interface qam command sets the OFDM parameters for a QAM slot, port, and
channel, and for any port exclusion band. The full QAM interface configuration
options are described in Chapter 17, “QAM interface.”
Modes
(config)#
(config-if-qam <slot>/<port>)#
Syntax
(config)# [no] interface qam <slot>/<port>
(config-if-qam X/Y)#
[no] ofdm port-exclusion-band <1:16>
[no] ofdm-channel <0:1>
[no] ofdm-channel <0:1> cyclic-prefix <192 | 256 | 512 | 768 |
1024>
[no] ofdm-channel <0:1> description <string>
[no] ofdm-channel <0:1> interleave <1:32>
[no] ofdm-channel <0:1> lower-freq <108000000:1196000000>
[upper-freq <130000000:1218000000>] [plc-freq
<108000000:1212000000>]
[no] ofdm-channel <0:1> ncp-modulation <type>
[no] ofdm-channel <0:1> pilot-scale-factor <48:120>
[no] ofdm-channel <0:1> plc-freq <108000000:1212000000>
[no] ofdm-channel <0:1> profile <0:3> <1:64>
[no] ofdm-channel <0:1> rolloff-period <0 | 64 | 128 | 192 | 256>
[no] ofdm-channel <0:1> sc-spacing <25 | 50>
[no] ofdm-channel <0:1> shutdown
[no] ofdm-channel <0:1> up-down-trap-enable
[no] ofdm-channel <0:1> upper-freq <130000000:1218000000>
[lower-freq <108000000:1196000000>] [plc-freq
<108000000:1212000000>]
Casa Systems
Orthogonal Frequency Division Multiplexing 14-15
interface qam
Properties
Property name Description
Example:
Example:
CASA(config)# ofdm-channel 0
CASA(config-if-qam 4/0)# ofdm-channel 0
CASA(config-if-qam 4/0)#
no ofdm-channel 0
cyclic-prefix <192 | 256 A cyclic prefix (CP) enables the receiver to overcome
| 512 | 768 | 1024> the effects of inter-symbol and intercarrier
interference caused by micro-reflections in the
channel. There are five possible values for the CP
and the choice depends on the delay spread of the
channel: a longer delay spread requires a longer
cyclic prefix. The default is 192. The CP is converted
into samples using the sample rate of
204.8 Msamples/sec and is an integer multiple of
1/64 * 20 microseconds.
Example:
Casa Systems
14-16 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Orthogonal Frequency Division Multiplexing 14-17
interface qam
Properties (continued)
Property name Description
• 16qam
• 64qam
• qpsk (default)
• zero
Example:
Casa Systems
14-18 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
Orthogonal Frequency Division Multiplexing 14-19
interface qam
Properties (continued)
Property name Description
profile <0:3> <1:64> OFDM local profile ID defined for the channel (up to
four profiles), followed by the global profile ID (as
defined by the ofdm profile command). The no form
of the command uses the local profile value only.
Example:
Example:
Example:
Casa Systems
14-20 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
Orthogonal Frequency Division Multiplexing 14-21
interface qam
Properties (continued)
Property name Description
Example:
Casa Systems
14-22 RF Cable Configuration Guide and Command Reference
interface qam
Shows the OFDM port exclusion band ID for the QAM channel.
Shows the CMs with OFDM transactions, based on various other options. See the
Casa Systems – CMTS Troubleshooting and Diagnostics Guide, Chapter 2, for details.
Only channel 0 can currently be specified.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-23
interface docsis-mac
interface docsis-mac
Purpose
The interface docsis-mac command sets the OFDM downstream binding for the
DOCSIS MAC interface. The full DOCSIS MAC interface configuration options are
described in Chapter 8, “DOCSIS MAC interface.”
Modes
(config)#
(config-if-mac <1:96>)#
Syntax
(config)# [no] interface docsis-mac <1:96>
(config-if-mac x)#
downstream <1:255> interface ofdm <slot>/<port>/<chan>
no downstream <1:255>
Properties
Property name Description
Example:
Casa Systems
14-24 RF Cable Configuration Guide and Command Reference
interface docsis-mac
Properties (continued)
Property name Description
interface docsis-mac 1
no shutdown
no early-authentication-encryption
no multicast-dsid-forward
tftp-proxy
downstream 1 interface ofdm 4/0/0
Casa Systems
Orthogonal Frequency Division Multiplexing 14-25
module <slot> ofdm-channels
Mode
(config)#
Syntax
module <slot> <1:2>
Properties
Property name Description
Example:
Casa Systems
14-26 RF Cable Configuration Guide and Command Reference
module <slot> ofdm-channels
Casa Systems
Orthogonal Frequency Division Multiplexing 14-27
service group
service group
Purpose
The service group command sets the service group for the OFDM downstream
binding. Once OFDM is enabled for the DOCSIS MAC interface and service group,
the channel information is included in the MAC Domain Descriptor (MDD) message
to broadcast to the modem. The full service group configuration options are described
in Chapter 6, “Channel bonding.”
Modes
(config)#
(conf-svc-grp <name>)#
Syntax
(config)# [no] service group <name>
(config-svc-grp x)#
[no] ofdm <slot>/<port>/<chan>
Properties
Property name Description
Example:
Example:
Casa Systems
14-28 RF Cable Configuration Guide and Command Reference
OFDM configuration examples
A simple profile has a default modulation only. A composite profile has both a default
modulation and some additional modulation definitions for some frequency regions.
The following configuration sets the lower frequency to 133.375 MHz, PLC center
frequency to 225 MHz, and upper frequency to 323.375 MHz for one QAM channel
(1/0/0). A single profile has a defined modulation of 16qam. No exclusion zone is
defined.
The following configuration sets the lower frequency to 433.375 MHz, PLC
frequency to 525 MHz, and upper frequency to 623.375 MHz. Four defined profiles
are specified at different modulations, and no exclusion zone.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-29
OFDM configuration examples
The following configuration sets the frequency ranges as in configuration #1, with a
simple profile on QAM channel 1/1/0. The difference here is that an exclusion zone is
defined based on a defined port exclusion band for a subcarrier group. Because of the
exclusion frequencies, the PLC frequency needs to be adjusted outside this range.
Casa Systems
14-30 RF Cable Configuration Guide and Command Reference
OFDM configuration examples
Casa Systems
Orthogonal Frequency Division Multiplexing 14-31
OFDM configuration examples
Casa Systems
14-32 RF Cable Configuration Guide and Command Reference
OFDM configuration examples
The following configuration involves multiple profiles (9, 10, 11, and 12) and no
exclusion zone, as set on QAM channel 1/3/0.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-33
OFDM configuration examples
Casa Systems
14-34 RF Cable Configuration Guide and Command Reference
OFDM configuration examples
no ofdm-channel 0 shutdown
The following configuration involves a single profile (9) and the exclusion zone on
the QAM port from Example 3, as set on channel 1/4/0.
The following configuration involves multiple profiles and an exclusion zone on the
QAM port involving two frequency-separated exclusion subcarrier groups, as set on
QAM channel 1/4/0. Setting just the lower and upper frequencies sets the PLC
frequency automatically outside the exclusion zone.
Casa Systems
Orthogonal Frequency Division Multiplexing 14-35
OFDM configuration examples
Casa Systems
15-1
OFDMA description
Orthogonal Frequency Division Multiple Access (OFDMA) is a multi-user version of
Orthogonal Frequency Division Multiplexing (OFDM) where many users can
transmit and receive over a single channel simultaneously. OFDMA uses distributed
subcarriers among users to enable multiple user transmissions over one channel.
DOCSIS Version 3.1-specific modems are necessary to support OFDMA in the cable
network. DOCSIS 3.0 and earlier modems are not supported.
The OFDMA upstream channel capability is available for the UPS 16x8 line card on
the C100G and C40G platforms and is based on the DOCSIS 3.1 specifications from
CableLabs. One OFDMA upstream channel is supported per port.
Backward compatibility and interoperability with legacy QAM and UPS channels
coexist with both OFDM (downstream) and OFDMA (upstream) implementations.
Configuration summary
Table 15-1 lists and briefly describes the objects related to OFDMA.
Casa Systems
15-2 RF Cable Configuration Guide and Command Reference
Definitions
interface docsis-mac Sets the OFDMA upstream binding for the DOCSIS MAC
interface.
interface ofdma Sets the OFDMA upstream interface binding.
service group Sets the service group for the OFDMA binding.
Definitions
channel configuration — Defines the upstream OFDMA channel table. The minimum
occupied bandwidth is 6.4 MHz for 25-KHz and 10 MHz for 50-KHz subcarrier
spacing, and cannot exceed 96 MHz.
cyclic prefix — Enables the receiver to overcome the effects of inter-symbol and
intercarrier interference caused by micro-reflections in the channel. There are five
possible values and the choice depends on the delay spread of the channel. A longer
delay spread requires a longer cyclic prefix.
fine ranging — Ranging used after initial ranging is completed, to fine-tune timing
and power.
initial ranging — Ranging used by the CMTS to identify a new admitting CM and for
coarse power and timing ranging.
interval usage code (IUC) — Burst profile descriptor for OFDMA upstream channels,
a 4-bit code in the Upstream Channel Descriptor (UCD) message. IUC profiles are
defined for data, initial ranging, and fine ranging.
lower-freq — Defines the lowest active subcarrier frequency, range 5–94.6 MHz.
upper-freq — Defines the highest active subcarrier frequency, range 11.4–101 MHz.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-3
Definitions
minislot — A group of dedicated subcarriers with the same modulation order, for
upstream transmission by a given cable modem.
pilot — A dedicated OFDMA subcarrier that can be used for channel estimation
(measurement of channel condition), synchronization, and other purposes. Pilot
subcarriers do not carry data. A set of pilot patterns is defined from which the CMTS
or operator can select to match the frequency response of the network. The
pilot-scale-factor indicates the scale factor for calculating the number of continuous
pilots for a downstream channel.
ranging backoff —The random back-off window to use when retrying ranging
requests, expressed as start and end values in powers of two. A CM transmitting a
RNG-REQ performs truncated binary exponential backoff using the two values to
control the backoff window.
Casa Systems
15-4 RF Cable Configuration Guide and Command Reference
Definitions
the RP that maximizes capacity for a given bandwidth and/or exclusion band scenario.
OFDMA has eight windowing types for upstream traffic.
subcarrier spacing — Defines the KHz spacing associated with a particular FFT
mode configured on the OFDMA upstream channel. If it is 4K mode, the subcarrier
spacing is 50 KHz (the default). If it is 8K mode, the subcarrier spacing is 25 KHz.
subcarrier zero (SC0) — A subcarrier without power or data and below the defined
channel frequency range. The SC0 center frequency is based on the defined 25-KHz
or 50-KHz spacing. For example, a frequency range of 5–35 MHz for 50-KHz spacing
would have a center frequency of 1.35 MHz; a range of 10–35 MHz would have a
center frequency of 6.35 MHz.
symbols per frame — Number of symbol periods per frame. The recommended
OFDMA ranging slot settings are based on the symbol rate and appear in TABLE.
Ranging slots settings in the number of subcarriers can be changed in the OFDMA
IUC iuc profile. Note that the number of fine ranging carriers larger than 64 cannot be
used as it may cause fine ranging failures. This also means that symbols per frame less
than 10 should not be used.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-5
Definitions
6 64 192
7 64 192
8 64 96
9 64 96
10 64 64
11 64 64
12 32 64
13 32 64
14 32 64
15 32 64
16 32 32
time and frequency division multiplexing (TaFDM) — Allows the upstream frequency
spectrum to be shared between the two types of channels, where a TDMA and
OFDMA channel overlap each other. This feature allows users to transition from the
traditional TDMA scheme to the OFDMA scheme. With multi-access to shared
spectrum resources using the TaFDM scheme, spectrum resources are divided into
time and frequency dimensions which are then allocated to one channel or another.
The upstream scheduler determines which area is used for TDMA or OFDMA
transmissions, with guard bands inserted on the boundary between TDMA and
OFDMA channels both in frequency and time dimensions. The overlapping channels
must be configured into the same OFDMA subcarrier service group. An OFDMA
channel can (a) cover the entirety of all TDMA channels, (b) cover a portion of the
TDMA channels on one side, or (c) reside inside the TDMA spectrum area.
Casa Systems
15-6 RF Cable Configuration Guide and Command Reference
OFDMA configuration steps
The steps to configuring upstream OFDMA are the following (see also the “OFDMA
configuration example” section):
1. Enable OFDMA for UPS 16x8 by using the module <num> ofdma enable
command. (See “Related command examples.”)
2. Define the modulation and pilot pattern for one or more consecutively numbered
OFDMA minislots (minislot-cfg <1:64>).
3. Configure the Interval Usage Code profile (iuc-profile <1:64>) to set the data
grant and ranging parameters.
4. Define any frequency exclusion bands (exclusion-band <1:16>), to be set in the
next step at the port level for the upstream OFDMA interface.
5. Configure the upstream interface ofdma channel parameters for OFDMA
bindings (be sure the channel is shut down first).
6. Configure the service group for the OFDMA upstream binding.
Time and Frequency Division Multiplexing (TaFDM) allows the upstream frequency
spectrum to be shared between the two types of channels, where one OFDMA channel
overlaps one or more TDMA channels. This feature allows users to transition from the
traditional TDMA scheme to the OFDMA scheme.
With multi-access to shared spectrum resources using the TaFDM scheme, spectrum
resources are divided up into time and frequency dimensions which are then allocated
to one channel or another. The upstream scheduler determines which area will be used
for TDMA or OFDMA transmissions. A guardband will be inserted on the boundary
between TDMA and OFDMA channels both in frequency and time dimensions. The
overlapping channels must be in the same OFDMA subcarrier service group.
TaFDM restrictions
There are no restrictions on how the frequency overlap can occur. For example, an
OFDMA channel can:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-7
TaFDM between OFDMA and TDMA channels
Example
CASA(config)# interface upstream 11/1.0
CASA(config-if-ups 11/1.0)# frequency 22000000 CASA(config-if-ups 11/
1.0
CASA(config)# interface upstream 11/1.1
CASA(config-if-ups 11/1.1)# frequency 28400000 CASA(config-if-ups 11/
1.1)# channel-width 6400000
CASA(config)# interface upstream 11/1.2
CASA(config-if-ups 11/1.2)# frequency 38000000
CASA(config-if-ups 11/1.2)# channel-width 6400000
CASA(config-if-ups 11/1.2)# interface upstream 11/1.3
CASA(config-if-ups 11/1.3)# frequency 39600000
CASA(config-if-ups 11/1.3)# channel-width 3200000
CASA(config-if-ups 11/1.3)# end
CASA(config)# ofdma exclusion-band 1
CASA(conf-ofdma-exclusion-band 1)# exclusion-sc-group 1 5000000
7000000
CASA(conf-ofdma-exclusion-band 1)# end
CASA(config)# interface ofdma 11/1.0
CASA(conf-ofdma-channel 11/1.0)# lower-freq 5000000 upper-freq
85000000
CASA(conf-ofdma-channel 11/1.0)# prov-attrib-mask 0x0
CASA(conf-ofdma-channel 11/1.0)# sc-spacing 50
CASA(conf-ofdma-channel 11/1.0)# symbols-per-frame 16
CASA(conf-ofdma-channel 11/1.0)# data-backoff automatic
CASA(conf-ofdma-channel 11/1.0)# ranging-backoff 0 4
CASA(conf-ofdma-channel 11/1.0)# voice-bw-reserve 75 emergency 0
CASA(conf-ofdma-channel 11/1.0)# power-level 0
CASA(conf-ofdma-channel 11/1.0)# power-adjust continue 4
CASA(conf-ofdma-channel 11/1.0)# power-adjust threshold 1
Casa Systems
15-8 RF Cable Configuration Guide and Command Reference
TDMA/OFDMA guardband implementation
With OFDMA mode enabled on a UPS 16x8 line card, each port supports up to one
OFDMA channel and four TDMA single-carrier channels. The OFDMA channels are
between 5 and 101 MHz, while the ATDMA channels can have a center frequency
between 5 and 100 MHz. If the non-overlapping area between the OFDMA and
TDMA edge frequencies is less than 2 MHz, the chances of RF interference can
increase.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-9
TDMA/OFDMA guardband implementation
The SNR value determines the size of the guardband. The guardband range is in
increments of 0.25 MHz from 0.25 MHz through 2.0 MHz. For example, with an SNR
measured at 4 dB, a guardband of 0.25 MHz is imposed, whereas an SNR of 20 dB
imposes a larger guardband of 2.0 MHz. The system does this automatically and
requires no user input. The frequency modulation rate also has an effect on the
guardband size. Lower modulation rates (at a smaller bitrate) are less sensitive to
SNR, in which case a smaller guardband can be applied. A high modulation rate at
QAM1024, for example, requires a higher SNR (35.5 dB, translated to 9.5 dB by the
guardband algorithm), requiring a higher guardband size.
The system imposes certain fixed filter sizes for the OFDMA band with the guardband
in effect, in 5-MHz intervals starting at 10 MHz and extending to 95 MHz. The
95 MHz filter is used if no combined OFDMA and TDMA traffic is enabled. The
other 10 filters are used when overlapping occurs inside the OFDMA band. With
combined traffic, the narrowest filter that completely covers the overlapping area is
selected. For example, with a 20–40 MHz OFDMA band and a 6.4 MHz TDMA band
at 22 MHz, with both sets of channels operating, a 15 MHz filter is selected for the
OFDMA band.
With the guardband in effect, the OFDMA band typically has a 70–80% utilization
rate with OFMA and TDMA transmitting simultaneously.
Example
The following shows a guardband assignment based on changing a TDMA upstream
interface frequency.
Casa Systems
15-10 RF Cable Configuration Guide and Command Reference
TDMA/OFDMA guardband implementation
logical-channel 1 minislot 2
logical-channel 1 shutdown
no shutdown
After the frequency adjustment from 20 to 21 MHz, the OFDMA wide filter selected
is 40 MHz (centered at 37.55 MHz) while the narrow filter selected is 35 MHz
(centered at 41.95 MHz). The guardband is set at 0.25 MHz. The ensuing signal
quality during mixed mode transmission then has a 0.1% correctable forward error
correction (FEC) rate.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-11
ofdma
ofdma
Purpose
The ofdma command sets three OFDM Multiple Access (OFDMA) upstream
parameters: exclusion bands, an Interval Usage Code (IUC) profile, and a minislot
configuration. With OFDMA enabled, the maximum number of single-carrier
channels per port is four (channels 0–3).
If multiple data IUCs are specified, the system performs the following steps:
1. It selects up to two IUCs (which must include IUC 13 as the baseline profile) for
an OFDMA channel as the initial ranging channel of modems. (It assigns IUC 13
to the OFDMA channel only if the CM registers with a non-OFDMA channel.)
2. It dynamically switches between the two IUCs based on signal-to-noise ratio
(SNR) and the data error rate.
3. It does not send dynamic bonding change (DBC) to a dynamically changed IUC
set after the modem registers in step 1.
Modes
(config)#
(conf-ofdma-exclusion-band <1:16>)#
(conf-IUC-profile <1:64>)#
(conf-minislot-cfg <1:64>)#
Syntax
(config)# [no] ofdma exclusion-band <1:16>
(conf-ofdma-exclusion-band x)#
exclusion-sc-group <1:32> <5000000:101000000> <5000000:101000000>
no exclusion-sc-group <1:32>
Casa Systems
15-12 RF Cable Configuration Guide and Command Reference
ofdma
(conf-minislot-cfg x)#
subcarrier-group-minislot <1:32> <5000000:100600000>
<5400000:101000000> modulation <type> pilot-pattern <1:8>
no subcarrier-group-minislot <1:32>
Properties
Property name Description
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-13
ofdma
Properties (continued)
Property name Description
Example:
Casa Systems
15-14 RF Cable Configuration Guide and Command Reference
ofdma
Properties (continued)
Property name Description
data-iuc Data grant ID for the IUC profile. Up to five data IUCs
<5|6|9|10|11|12|13> can be defined for an OFDMA channel. The 5, 6, 9,
modulation <type> 10, 11, and 12 IDs are optional data IUCs. The 13 ID
pilot-pattern <1:8> is the required unpredefined type 5 upstream channel
[minislot-cfg <1:64>] data if the other IDs are not specified (see the top of
the command description for details).
• 8qam
• 16qam
• 32qam
• 64qam
• 128qam
• 256qam
• 512qam
• 1024qam
• qpsk (Quadrature Phase Shift Keying)
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-15
ofdma
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
15-16 RF Cable Configuration Guide and Command Reference
ofdma
Properties (continued)
Property name Description
minislot-cfg <1:64> Defines the modulation and pilot pattern for one or
more consecutively numbered minislots, where one
or both of these parameters differ from the default for
the OFDMA profile for this channel. For OFDMA, a
minislot is a group of dedicated subcarriers all with
the same modulation order. The minislots affected
are defined by a frequency range.
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-17
ofdma
Properties (continued)
Property name Description
• 8qam
• 16qam
• 32qam
• 64qam
• 128qam
• 256qam
• 512qam
• 1024qam
• qpsk (Quadrature Phase Shift Keying)
• zero
Example:
Casa Systems
15-18 RF Cable Configuration Guide and Command Reference
ofdma
Properties (continued)
Property name Description
probe interval <10:10080> Sets the OFDMA probe interval, in minutes. The
default at bootup is disabling the probe so that no
CMs probe occurs, at initial ranging or periodically.
Example:
ofdma exclusion-band 1
exclusion-sc-group 1 5000000 7000000
exclusion-sc-group 2 7000000 16000000
ofdma iuc-profile 1
fine-ranging-iuc 32 800000
initial-ranging-iuc 32 800000
data-iuc 13 modulation 1024qam pilot-pattern 2
Casa Systems
Orthogonal Frequency Division Multiple Access 15-19
ofdma
ofdma minislot-cfg 1
subcarrier-group-minislot 1 5000000 9600000 modulation zero
pilot-pattern 1
Shows the OFDMA probe interval, if set by the ofdma probe interval command.
Probing is disabled by default.
Shows the CMs with OFDMA transactions, based on various other options. See the
Casa Systems – CMTS Troubleshooting and Diagnostics Guide, Chapter 2, for details.
Casa Systems
15-20 RF Cable Configuration Guide and Command Reference
interface docsis-mac
interface docsis-mac
Purpose
The interface docsis-mac command sets the OFDMA upstream binding for the
DOCSIS MAC interface. The full DOCSIS MAC interface configuration options are
described in Chapter 8, “DOCSIS MAC interface.”
Modes
(config)#
(config-if-mac <1:96>)#
Syntax
(config)# [no] interface docsis-mac <1:96>
(config-if-mac x)#
upstream <1:255> interface ofdma <slot>/<port>.<chan>
no upstream <1:255>
Properties
Property name Description
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-21
interface docsis-mac
Properties (continued)
Property name Description
interface docsis-mac 1
no shutdown
no early-authentication-encryption
no multicast-dsid-forward
tftp-proxy
upstream 1 interface ofdma 11/1.0
Casa Systems
15-22 RF Cable Configuration Guide and Command Reference
interface ofdma
interface ofdma
Purpose
The interface ofdma command sets the OFDMA upstream channel binding. OFDMA
can be configured on upstream interface ports 0–15. With OFDMA, the maximum
number of single-carrier (TDMA or ATDMA) channels per port are reduced to four.
Note: For redundancy, the standby UPS_16x8 module installed (in slot 5 or 8) must
also be a multi-mode FPGA that includes OFDMA. Use the show system or show
module config command to confirm.
Modes
(config)#
(conf-ofdma-channel <slot>/<port>.<chan>)#
Syntax
(config)# [no] interface ofdma <slot>/<port>.<chan>
(conf-ofdma-channel x/y.z)#
cyclic-prefix <96 | 128 | 160 | 192 | 224 | 256 | 288 | 320 | 384 |
512 | 640>
data-backoff <0:15> {<0:15> | automatic}
no data-backoff
description <string>
no description
exclusion-band <1:16>
interface ofdma <slot>/<port>.<chan>
iuc-profile <1:64>
lower-freq <5000000:94600000> upper-freq <11400000:101000000>
map-advance {dynamic <200:2000> | static <200:4000>}
no map-advance
[no] multiple-iuc [err-threshold <1:999> | interval <1:200> |
max-retry {<2:200> | unlimited}]
power-adjustment {continue <2:15> | threshold <0:2>}
power-level <-12:12>
[no] pre-equalization
prov-attr-mask {<0x0:0xffffffff> | {[bonding] [highavailability]
[lowlatency]}
ranging-backoff <0:15> <0:15>
no ranging-backoff
rolloff-period <0 | 32 | 64 | 96 | 128 | 160 | 192 | 224>
sc-spacing <25 | 50>
Casa Systems
Orthogonal Frequency Division Multiple Access 15-23
interface ofdma
[no] shutdown
symbols-per-frame <6:36>
[no] up-down-trap-enabled
voice-bw-reserve {<0:100> [emergency <0:100>] | max-calls <0:255>}
[emergency <0:255>]
no voice-bw-reserve
Properties
Property name Description
Example:
Casa Systems
15-24 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
cyclic-prefix <96 | 128 | A cyclic prefix (CP) enables the receiver to overcome
160 | 192 | 224 | 256 | the effects of inter-symbol and intercarrier
288 | 320 | 384 | 512 | interference caused by micro-reflections in the
640> channel. There are 11 possible values for the CP and
the choice depends on the delay spread of the
channel: a longer delay spread requires a longer
cyclic prefix. The CP is converted into samples using
the sample rate of 204.8 Msamples/sec and is an
integer multiple of 1/64 * 20 microseconds. The cyclic
prefix must be greater than the rolloff-period. There
is no no form of the command. The values
correspond to the following microsecond periods:
• 96 — 0.937 μs
• 128 — 1.25 μs
• 160 — 1.5625 μs
• 192 — 1.875 μs
• 224 — 2.1875 μs
• 256 — 2.5 μs
• 288 — 2.8125 μs
• 320 — 3.125 μs
• 384 — 3.75 μs
• 512 — 5.0 μs
• 640 — 6.25 μs
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-25
interface ofdma
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
15-26 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
Example:
iuc-profile <1:64> Interval Usage Code (IUC) profile for the OFDMA
upstream channel. An error is returned if an
iuc-profile is not preconfigured with a data-uic
defined.
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-27
interface ofdma
Properties (continued)
Property name Description
Example:
Casa Systems
15-28 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
map-advance {dynamic MAP advance for the OFDMA interface is the amount
<200:2000> | static of look-ahead time for MAPs based on the plant
<200:4000>} characteristics. The system already has a built-in
look-ahead time to account for internal operations
such as generating the MAP. One of two options are
available, as follows:
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-29
interface ofdma
Properties (continued)
Property name Description
Casa Systems
15-30 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-31
interface ofdma
Properties (continued)
Property name Description
ranging-backoff <0:15> Allowed start and end values for applying windowing
<0:15> to maximize the capacity of the upstream channel,
expressed as powers of two.
Example:
Casa Systems
15-32 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
• 0 — 0.0 μs
• 32 — 0.312 μs
• 64 — 0.625 μs
• 96 — 0.937 μs
• 128 — 1.25 μs
• 160 — 1.5625 μs
• 192 — 1.875 μs
• 224 — 2.1875 μs
Example:
Example:
Casa Systems
Orthogonal Frequency Division Multiple Access 15-33
interface ofdma
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
15-34 RF Cable Configuration Guide and Command Reference
interface ofdma
Properties (continued)
Property name Description
Example:
Enables OFDMA on a UPS 16x8 module, which requires rebooting the module (or
enabling OFDMA on the redundancy card, which triggers rebooting). Use the no form
of the command to disable the OFDMA module. Trying to enable on a UPS_16x4
module returns an error message.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-35
interface ofdma
Shows the upstream module or modules configured with OFDMA. In this example,
there is no redundant standby (such as module 8) enabled for OFDMA redundancy.
Casa Systems
15-36 RF Cable Configuration Guide and Command Reference
interface ofdma
Shows OFDMA upstream interface details and current status, with up to one OFDMA
upstream channel per port.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-37
service group
service group
Purpose
The service group command sets the service group for the OFDMA upstream
binding. Once OFDMA is enabled for the DOCSIS MAC interface and service group,
the channel information is included in the MAC Domain Descriptor (MDD) message
to broadcast to the modem. The full service group configuration options are described
in Chapter 6, “Channel bonding.”
Modes
(config)#
(conf-svc-grp <name>)#
Syntax
(config)# [no] service group <name>
(config-svc-grp x)#
[no] ofdma <slot>/<port>.<chan>
Properties
Property name Description
Example:
Casa Systems
15-38 RF Cable Configuration Guide and Command Reference
service group
Properties (continued)
Property name Description
Example:
Shows the QAM channels associated with a service group, including OFDMA.
Casa Systems
Orthogonal Frequency Division Multiple Access 15-39
OFDMA configuration example
Casa Systems
15-40 RF Cable Configuration Guide and Command Reference
OFDMA configuration example
Casa Systems
Orthogonal Frequency Division Multiple Access 15-41
OFDMA configuration example
Casa Systems
15-42 RF Cable Configuration Guide and Command Reference
OFDMA configuration example
6. Configure the service group to create the upstream binding to the OFDMA
interface.
Once OFDMA is enabled for the DOCSIS MAC interface and service group, the
channel information is included in the MAC Domain Descriptor (MDD) message
to broadcast to the modem. The channel number is currently always 0.
CASA(config)# service group OFDMA
CASA(conf-svc-grp OFDMA)# ofdma 10/1.0
ofdma minislot-cfg 1
subcarrier-group-minislot 1 5000000 7000000 modulation qpsk
pilot-pattern 1
subcarrier-group-minislot 2 20000000 25000000 modulation 64qam
pilot-pattern 8
ofdma iuc-profile 1
data-iuc 5 modulation 8qam pilot-pattern 2
data-iuc 6 modulation 64qam pilot-pattern 3
Casa Systems
16-1
Configuration summary
Table 16-1 lists and briefly describes the objects related to PacketCable.
Casa Systems
16-2 RF Cable Configuration Guide and Command Reference
packetcable
packetcable
Purpose
Mode
(config)#
Syntax
[no] packetcable <cr>
packetcable cops ip dscp <0:63>
[no] packetcable dscp check
packetcable elemid <0:99999>
[no] packetcable ftp {newuser <name> | user password <pwd>}
[no] packetcable gate maxcount <1:196607>
packetcable inactive call aging <0:24> [minimum traffic <0:1000>]
[no] packetcable max {emerg | normal} call <0:8000>
[no] packetcable media alive time <hh:mm>
[no] packetcable mgpi
[no] packetcable multimedia [T1 <1:1000>]
[no] packetcable myaddress <ip_addr>
[no] packetcable nls {agid <0:4294967295> key <key> | cpd |
source-interface loopback <0:255>}
packetcable pepid <text>
[no] packetcable rks batchfile {max {msg <1:1000> | size <1024:65535>}
| sendmode {ftp | udp} | time <1:200>}
[no] packetcable rks retry <1:10>
[no] packetcable rks timeout <1:30>
[no] packetcable t0 <1:65535>
[no] packetcable t1 <1:65535>
[no] packetcable vrf <name> [packetcable | pcmm]
Properties
Property name Description
Example:
CASA(config)# packetcable
CASA(config)# no packetcable
Casa Systems
PacketCable 16-3
packetcable
Properties (continued)
Property name Description
cops ip dscp <0:63> Sets the Differentiated Services Code Point (DSCP)
priority for the Common Open Policy Service
(COPS), up to 64.
Example:
Example:
Example:
ftp {newuser <name> | user Configures an FTP user for PacketCable, with a
password <pwd>} username and password, default casa.
Example:
Casa Systems
16-4 RF Cable Configuration Guide and Command Reference
packetcable
Properties (continued)
Property name Description
gate maxcount <1:196607> Maximum gate count that controls the gate scale,
default value max_cm * 3/100. If the count is larger
than 32767 (0x7fff), the system ID occupies only 15
bits instead of 17, in which case the current gates are
freed forcibly (requiring confirmation; see Example).
Example:
inactive call aging <0:24> Inactive call aging controls freeing of PacketCable
[minimum traffic <0:1000>] gates when service flows become inactive.
Previously, PacketCable gates remained active and
calls were not being torn down after a call ended,
consuming system resources and bandwidth. This
command sets the number of hours to pass before
tearing down a call, as well as setting an optional
minimum voice downstream throughput threshold (in
kilobits) to determine if the call session should be torn
down.
Example:
max {emerg | normal} call Configures maximum emergency or normal calls for
<0:8000> the CMTS, default 0 (disabled).
Example:
Casa Systems
PacketCable 16-5
packetcable
Properties (continued)
Property name Description
media alive time <hh:mm> Media Alive Time is an EM message. To set the
media alive time, set the hours and minutes in the
form hh:mm.
Example:
Example:
Example:
Casa Systems
16-6 RF Cable Configuration Guide and Command Reference
packetcable
Properties (continued)
Property name Description
Example:
Casa Systems
PacketCable 16-7
packetcable
Properties (continued)
Property name Description
Example:
rks batchfile {max {msg A batch file can be sent to the Record Keeping
<1:1000> | size Server (RKS) by UDP or FTP. The batchfile property
<1024:65535>} | sendmode sets the following parameters:
{ftp | udp} | time <1:200>}
• max msg <1:1000> — Maximum number of mes-
sages in a batch file, default 20 messages.
• max size <1024:65535> — Maximum size, in
bytes, of the event message batch file, default
65535.
• sendmode {ftp | udp} — Specified FTP or UDP
as the send mode.
• time <1:200> — Time intervals to send the batch
file to the RKS server, default 200 seconds.
Example:
Casa Systems
16-8 RF Cable Configuration Guide and Command Reference
packetcable
Properties (continued)
Property name Description
rks retry <1:10> Set the RKS retry count, the number of times that a
RADIUS request is resent to a RKS server, default 3
retries.
Example:
rks timeout <1:30> Sets the RKS timeout, the time interval that the router
waits for the RKS server to reply before
retransmitting, default 5 seconds.
Example:
Example:
CASA(config)# packetcable t0 30
CASA(config)# no packetcable t0
Example:
Casa Systems
PacketCable 16-9
packetcable
Properties (continued)
Property name Description
Example:
Shows the packet cable global parameters. Note that in Release 6.5 the PacketCable
Multimedia (PCMM) version is set to 5.0 by default.
Casa Systems
16-10 RF Cable Configuration Guide and Command Reference
packetcable
Shows the gate specifications for a particular gate ID, downstream or upstream.
Shows the Common Open Policy Service (COPS) server IP address and listen port.
Casa Systems
PacketCable 16-11
packetcable
Shows the multiple grants per interval (MGPI), if enabled by the packetcable mgpi
command, with the option of specifying a particular cable modem.
Shows the PacketCable Multimedia (PCMM) configuration, if any. The gateid value
to obtain the classifier, gate specification and traffic profile output can be derived
from the multicast output. The ps server identifies the Common Open Policy Service
(COPS) server address, port, and version, as set by the cops pdp-ip command. Up to
128 COPS servers can be configured.
Casa Systems
17-1
• QAM 8x8 — Eight QAM modules with each eight channels. QAM 8x8 modules
have two modes of operation: normal and high frequency. Normal mode requires
all channels on a given QAM module to be contained in the range 47–860 MHz.
High frequency mode requires all channels on a module in the range 295–
999 MHz. Each QAM module is completely independent of other modules in the
same chassis; some modules can be in high-frequency mode, while others are in
normal mode. The center frequencies for channels on the same port are correlated.
When any one is set, the others change accordingly. The center frequency of each
channel is separated by 6–8 MHz, depending on whether the QAM port is
configured as Annex type B, C, or A.
• QAM 8x96 — Eight QAM modules with each 96 channels, supporting both
narrowcast and shared channels. Each of the eight ports consists of up to 48
channels (32 DOCSIS and up to 16 DVB SimulCrypt or secondary channels)
along with the remainder as shared channels. Shared channels are RF channels
that operate over any or all eight physical ports, totaling 96 or, if Digital Video
Broadcasting (DVB) encryption is used, 64 channels across the module. The
broadcast channels support the DVB channels as DOCSIS secondaries, up to 16
per port. The QAM 8x96 module supports a total of 384 QAM channels in
Annex B and Annex A modes — 320 channels are capable of both DOCSIS and
video traffic, plus 64 video channels capable of broadcasting over any of the RF
ports.
Casa Systems
17-2 RF Cable Configuration Guide and Command Reference
QAM shared channel modes
• QAM 8x192 — Eight QAM modules with each 192 channels, with up to
64 multi-port shared (broadcast) and 64 narrowcast channels per port. The module
introduced for DOCSIS 3.1 supports up to 400 DOCSIS channels per module,
128 multi-port shared channels per module and broadcast channels per port,
80 single-carrier channels (DOCSIS, SDV, and VOD) across eight channel
blocks, 24 Annex A/B/C channels per port operating in DVB SimulCrypt
encryption mode configured in the upper channel range, and up to two channels
per port for Orthogonal Frequency Division Multiplexing (OFDM) (SimulCrypt
allows only one OFDM channel) and one channel per port for Orthogonal
Frequency Division Multiple Access (OFDMA) over 10-Gbps downstream and
1-Gbps upstream service flows.
Configuration summary
Table 17-1 lists and briefly describes the objects related to the QAM interface.
As introduced for QAM 8x96, shared channels are in one of the two following modes,
with the system allowing a combination of the modes across an RF port:
Casa Systems
QAM interface 17-3
QAM shared channel modes
With 96 shared channels (QAM 8x96), each of the eight RF ports can get up to
12 extra narrowcast channels; with 128 shared channels (QAM 8x192), each of the
eight RF ports can get up to 16 extra narrowcast channels.
The number of narrowcast channels per port can range 36–48. The following
conditions apply:
Casa Systems
17-4 RF Cable Configuration Guide and Command Reference
Configuring narrowcast channels
In this mode, the content of the channel can be replicated to all eight RF ports, for
video only. The set of downstream ports on each shared channel can be selected to
allow a subset of RF ports for shared channel replication. The RF frequency of the
shared channel must be the same on all the outgoing RF ports.
The syntax and an example are described in the module command description. The
command sets the total number of narrowcast channels on the module RF downstream
port. With the number of narrowcast-channels set to more than 36, the system places a
set of shared channels into extra narrowcast mode to meet the assigned number. The
maximum value for narrowcast channels is 48, the default, where no extra narrowcast
shared channels are available.
Example
CASA(config)# module 0 narrowcast-channels 44
This command creates 44 narrowcast channels, eight channels per port in excess of the
default 36, which creates 96–[8(excess)x8]=32 shared channels across all ports. Use
the no form of the command to remove the current narrowcast-channels configuration
setting and revert to the default setting of 48 narrowcast channels. Use the
show narrowcast-channels command to display the current narrowcast channels.
Example
CASA(config)# show narrowcast-channels
module 4 narrowcast-channels 44
module 10 narrowcast-channels 44
Casa Systems
QAM interface 17-5
Configuring the shared channels for QAM 8x96 ports
As introduced for QAM 8x96, the shared-channel command places a shared channel
into multi-port shared channel mode (video only). Shared channels in the range 0–91
are enabled using an assigned frequency. Each shared channel frequency must be
assigned first using the following command format:
See the shared-channel property of the interface qam command for details. The
optional range of 1–32 is the number of channels to which the frequency applies using
a single command. Use the clear interface qam shared-channel <slot> stat
command to remove shared channel statistics.
Example
CASA(config)# interface qam 0/0
CASA(config-if-qam 0/0)# shared-channel 0 frequency 555000000
CASA(config-if-qam 0/0)# shared-channel 0 transport stream id 125
Note: If some of the shared channels are assigned to the narrowcast channel
mode, there will be less shared channels available for multi-port shared
channel mode.
Once a shared channel is created on one of the QAM 8x96 ports, it can then be shared
across up to seven additional ports on the same module.
Figure 17-1 shows a sample mapping of the eight QAM 8x96 ports where port 0
shares 12 SDV0 channels with port 1, port 2 shares SDV1 channels with port 3, port 4
shares SDV2 channels with port 5, and port 6 shares SDV3 channels with port 7.
Casa Systems
17-6 RF Cable Configuration Guide and Command Reference
Sharing channels over other QAM 8x96 ports
The following CLI session configures the shared channels on port 0 and shares them
with port 1 using the following steps:
where group-id is the qam group ID in the range 1–8, and first_shchan and
last_shchan specify the block of multi-port shared QAM channels.
5. Run the show docsis channel utilization command to display multi-port shared
channel statistics.
Casa Systems
QAM interface 17-7
Sharing channels over other QAM 8x96 ports
Example
CASA(config)# module 0 narrowcast-channels 32
CASA(config)# show narrowcast-channels
module 0 narrowcast-channels 32
Casa Systems
17-8 RF Cable Configuration Guide and Command Reference
QAM 8x96 and QAM 8x192 channel frequency range
Figure 17-2. QAM 8x96 channel time line frequency blocks (Annex B, C; 128 ch.)
Dynamic system-assigned default frequencies
Casa Systems
QAM interface 17-9
QAM 8x96 and QAM 8x192 channel frequency range
Figure 17-3. QAM 8x96 channel time line frequency blocks (Annex A; 96 ch.)
Dynamic system-assigned default frequencies
Example
CASA# show interface qam 0/1 block
Notes:
annex: 0-A, 1-B, 2-C; mod: 0-64qam, 1-128qam, 3-256qam;
mid: 0-not in any mode, 1-in mode 1, 2-in mode 2;
QCC_MODULE_INFO:
mode 1: annex 1 mod 3 symb 0 intlv 12801 dvb 0 ref_cnt 16 bchan_cnt 0
mode 2: annex 0 mod 0 symb 0 intlv 0 dvb 0 ref_cnt 0 bchan_cnt 0
total active bchan count: 0
Casa Systems
17-10 RF Cable Configuration Guide and Command Reference
QAM 8x192 multi-port shared channels
schan_id:
4 5 6 7 8 9 10 11 12 13 14 15
16 17 18 19 20 21 22 23 24 25 26 27
28 29 30 31 32 33 34 35 36 37 38 39
40 41 42 43 44 45 46 47 48 49 50 51
52 53 54 55 56 57 58 59 60 61 62 63
64 65 66 67 68 69 70 71 72 73 74 75
76 77 78 79 80 81 82 83 84 85 86 87
88 89 90 91 0 1 2 3 255 255 255 255
shutdown channels:
channel 8 freq 531000000 blk 255 off 255 mid 0 annex 1 mod 3 sym 0
intlv 12801 dvb 3 status 0
channel 9 freq 537000000 blk 255 off 255 mid 0 annex 1 mod 3 sym 0
intlv 12801 dvb 3 status 0
channel 10 freq 543000000 blk 255 off 255 mid 0 annex 1 mod 3 sym 0
intlv 12801 dvb 3 status 0
channel 11 freq 549000000 blk 255 off 255 mid 0 annex 1 mod 3 sym 0
intlv 12801 dvb 3 status 0
…
Once a shared channel on one of the QAM 8x192 ports is created, this channel can
then be shared across one or more ports (up to seven additional) on the same module.
The following CLI session configures the video-only multi-port shared channels on
port 0 and shares them with port 1:
Casa Systems
QAM interface 17-11
QAM 8x192 multi-port shared channels
Example
CASA(config)# module 4 narrowcast-channels 64
CASA(config)# show narrowcast-channels
module 4 narrowcast-channels 64
Casa Systems
17-12 RF Cable Configuration Guide and Command Reference
QAM 8x192 multi-port shared channels
no shared-channel 15 shutdown
PORT CHAN SH_CH FREQ(MHz) BINDP BINDC BINDM ANNEX MOD SYMB REPL-P P_MASK BLK_OFF
STATUS
0 0 0 47000000 0 64 ff A 256qam 6952 255 00 0 0 up
0 1 1 55000000 0 65 ff A 256qam 6952 255 00 0 1 up
0 2 2 63000000 0 66 ff A 256qam 6952 255 00 0 2 up
0 3 3 71000000 0 67 ff A 256qam 6952 255 00 0 3 up
0 4 4 79000000 0 68 ff A 256qam 6952 255 00 0 4 up
0 5 5 87000000 0 69 ff A 256qam 6952 255 00 0 5 up
0 6 6 95000000 0 70 ff A 256qam 6952 255 00 0 6 up
0 7 7 103000000 0 71 ff A 256qam 6952 255 00 0 7 up
0 8 8 111000000 0 72 ff A 256qam 6952 255 00 0 8 up
0 9 9 119000000 0 73 ff A 256qam 6952 255 00 0 9 up
0 10 10 127000000 0 74 ff A 256qam 6952 255 00 0 10 up
0 11 11 135000000 0 75 ff A 256qam 6952 255 00 0 11 up
0 12 12 143000000 0 76 ff A 256qam 6952 255 00 0 12 up
0 13 13 151000000 0 77 ff A 256qam 6952 255 00 0 13 up
0 14 14 159000000 0 78 ff A 256qam 6952 255 00 0 14 up
0 15 15 167000000 0 79 ff A 256qam 6952 255 00 0 15 up
Casa Systems
QAM interface 17-13
QAM 8x192 MPTS pass-through broadcast video
5. Add multi-port shared channels to the video QAM domain and QAM group. The
qam-group command in the video qam-domain configuration supports the range
of narrowcast and multi-port shared channels.
Example
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group <id> shared-channel
<first> <last>
where id is the QAM group ID in the range 1–8, and first and last are the first and
last QAM channels in the block of multi-port shared channels.
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group 2 shared-channel 0/0 0/15
Release 7.2 supports Multiple Program Transport Stream (MPTS) processing over
QAM 8x192 ports 0–7 where one input MPTS can be output to one QAM multi-port
shared channel. Note that PID replacement (drop and add) is supported with broadcast
video. Perform the follow steps to configure the QAM for video broadcast:
Casa Systems
17-14 RF Cable Configuration Guide and Command Reference
QAM 8x192 MPTS pass-through broadcast video
Create a video pass-through session on one QAM 8x192 module, then repeat the
command for additional QAM 8x192 modules. In the following example, the MPTS
broadcast video stream is configured on shared channel 4/0. The MPTS is destined for
the multicast group address at IP 227.0.0.0 and the video source IP address for the
MPTS is 17.56.102.2.
Example
CASA(config)# video session 1 pass-through ip-address 227.0.0.0
qam-channels shared-channel 4/0 src-ip 17.56.102.2
Casa Systems
QAM interface 17-15
interface qam
interface qam
Purpose
Modes
(config)#
(config-if-qam <slot>/<port>)#
Syntax
(config)# interface qam <slot>/<port>
(config-if-qam X/Y)#
QAM8x8: annex {A [spectral-inversion] | B | C [spectral-inversion]}
QAM8x96/192: annex {A [spectral-inversion] | B | C
[spectral-inversion]}
channel <num> annex {A [spectral-inversion] [symbol rate
<5000:6999>] | B | C [spectral-inversion] [symbol rate
<5000:6999>]}
[no] channel <num> description “<text>”
[no] channel <num> dsg {channel-list <1:4294967295> | dcd-enable |
interval <2:10> | timer-id <1:4294967295> | vendor-param-id
<1:4294967295>}
channel <num> frequency <0 | 47000000:999000000> [<1:80>]
channel <num> interleave <level>
channel <num> modulation {128qam | 256qam | 64qam | off}
channel <num> power-attenuation <0:100> [<1:80>]
channel <num> prov-attr-mask {<0x0:0xFFFFFFFF> | {[bonding]
[highavailability] [lowlatency]}}
[no] channel <num> replicate-port <ports_list> [<1:80>]
[no] channel <num> shutdown [<1:80>]
[no] channel <num> transport stream id <0:65535> <1:80> [inc
<1:100>]
interface qam <slot>/<port>
interleave <level>
modulation {128qam | 256qam | 64qam | off}
ofdm port-exclusion-band <1:16>
ofdm-channel {0 | 1} [<parms>]
power <250:620> [per-channel]
Casa Systems
17-16 RF Cable Configuration Guide and Command Reference
interface qam
Properties
Property name Description
Example:
Casa Systems
QAM interface 17-17
interface qam
Properties (continued)
Property name Description
annex {A [symbol rate QAM 8x8: Sets the QAM channel annex. There are
<5000:6999>] [channel three MPEG framing formats for a QAM channel,
spacing Annex A (Europe), Annex B (North America), and
<6000000:8000000>] | B | Annex C (Japan), described as follows:
C}
• A — Annex A describes an earlier European CM
system, for which a symbol rate and channel
spacing can be specified. The default
symbol rate is 6952 kilo-symbols per second.
For the DOCSIS channel, 6952 is the only setting.
The channel spacing default is 8000000 Hz
(8 MHz).
• B — Annex B corresponds to
DOCSIS/EuroDOCSIS 1.1 and has a channel
spacing of 6 MHz. The symbol rate and channel
spacing are not options for this annex type.
• C — Annex C describes a variant of DOCSIS 1.1
that is designed to operate in Japanese cable
systems and has a channel spacing of 6 MHz.
The symbol rate and channel spacing are not
options for this annex type.
Example:
Casa Systems
17-18 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Casa Systems
QAM interface 17-19
interface qam
Properties (continued)
Property name Description
channel <num> annex {A Annex for the particular channel, in addition to the
[spectral-inversion] annex set at the port level. The QAM 8x96/192 port
[symbol rate can have up to two different sets of symbol rates
<5000:6999>] | B | C assigned to different channels because of the
[spectral-inversion] different RF requirements of CMs and STBs.
[symbol rate
<5000:6999>]} Spectral inversion and the symbol rate can be
applied to Annex A and Annex C. The default Annex
A symbol rate is 6952 and the default Annex C
symbol rate is 5274. With spectral inversion, the
frequency, modulation, and symbol rate are
persisted.
Example:
Example:
Casa Systems
17-20 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
channel <num> dsg DOCSIS Set-Top Gateway (DSG) properties for the
{channel-list QAM channel. One of the following modifiers is
<1:4294967295> | required:
dcd-enable | interval
<2:10> | timer-id • channel-list <1:4294967295> — Enables send-
<1:4294967295> | ing a DSG channel-list with the frequency defined
vendor-param-id by the dsg channel-list command to the DSG
<1:4294967295>} agent in the Downstream Channel Descriptor
(DCD) message to advertise which QAMs contain
DSG tunnels and what their frequencies are, in
order to expedite bringing up the DSG client STB.
The channel-list can be applied on any QAM
channel and is not intended to indicate which STB
devices go on which channel. However, the cen-
ter frequency defined by the dsg channel-list
must be within the frequency range set for the
QAM channels enabled for DSG.
• dcd-enable — Enables the channel for DCD
messaging, required for DSG.
• interval <2:10> — Sets a downstream time inter-
val in ticks (100 milliseconds per tick), default 5.
• timer-id <1:4294967295> — Assigns a DSG
timer ID to the channel, configured using the dsg
timer-id command in configuration mode.
• vendor-param-id <1:4294967295> — Assigns a
DSG vendor parameter ID to the downstream
channel. A vendor-param-id is configured using
the dsg vendor-param-id command in configura-
tion mode.
Example:
Casa Systems
QAM interface 17-21
interface qam
Properties (continued)
Property name Description
channel <num> frequency QAM channel frequency. The default for channel 1 is
<0 | 47000000:999000000> 549000000 Hz (549 MHz). The center frequencies for
[<1:80>] the four channels on the same port are correlated.
When any one is set, the others change accordingly.
The center frequency of each channel is separated
by 6–8 MHz, depending on the annex type specified.
Changing the frequency requires shutting down the
channel first. Narrowcast and shared channels can
be configured with a frequency of 0 for unused or
disabled channels (shutdown) to avoid possible
unexpected frequencies.
Example:
channel <num> interleave QAM channel interleave level, with the possible
<level> values 8, 16, 32, 64, 128x1 (default), 128x2, 128x3,
128x4, 128x5, 128x6, 128x7, or 128x8. (See also the
interleave <level> command.)
Example:
channel <num> modulation Modulation rate for the specific QAM output channel
{128qam | 256qam | 64qam on the selected QAM port. The possible modulation
| off} rates are 64qam, 128qam, 256qam (default), and
off. A modulation type is required.
Example:
Casa Systems
17-22 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Casa Systems
QAM interface 17-23
interface qam
Properties (continued)
Property name Description
Example:
Casa Systems
17-24 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
channel <num> shutdown Shuts down the channel. The optional number of
[<1:80>] channels designation applies to QAM 8x96/192
boards only.
Example:
Example:
Casa Systems
QAM interface 17-25
interface qam
Properties (continued)
Property name Description
Example:
modulation {128qam | Modulation rate for all QAM output channels on the
256qam | 64qam | off} selected QAM port. The possible modulation rates
are 64qam, 128qam, 256qam, and off, the default
256qam.
Example:
Example:
Casa Systems
17-26 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
Example:
Casa Systems
QAM interface 17-27
interface qam
Properties (continued)
Property name Description
power <250:620> Output power level for all QAM channels per QAM
[per-channel] port, in .1dBmV, default 510. The actual channel
output level depends on how many channels are
enabled on the port. The power setting is the sum of
all enabled QAM channels on the same port, except if
the per-channel modifier is used to set the power
value at the channel level. Currently the only
aviailable per-channel power for Remote PHY is 210
in the tenth of a dBmV unit.
• 60: 1 channel/port
• 56: 2 channels/port
• 52: 4 channels/port
• 49: 8 channels/port
Setting the port power level more than 580 is not
recommended unless the actual CMTS output shows
as slightly lower than what is requested in the CLI, or
when the cable plant is highly attenuated and the
only solution is to force the CMTS to overdrive its
output level (instead of removing attenuation).
Example:
Casa Systems
17-28 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
shared-channel <id> Shared channel ID for the QAM interface, with the
{annex {A [symbol rate following properties:
<5000:6999>]
[spectral-inversion] | B • annex {A [spectral-inversion] | B | C [spec-
| C tral-inversion]}, along with the optional symbol
[spectral-inversion]} | rate for Annex A.
description “<text>” | • description “<text>” — Description for the
frequency <0 | shared channel, up to 64 characters.
47000000:999000000>
[<1:48>]| interleave • frequency <47000000:999000000> — Narrow-
<level> | modulation cast and shared channels can also be configured
with a frequency of 0 for unused or disabled
{128qam | 256qam | 64qam
(shutdown) channels to avoid possible unex-
| off} |
pected frequencies.The optional 1–48 value indi-
power-attenuation
cates the number of channels to apply the
<0:100> [<1:96>] | incrementing frequencies to, default 48.
shutdown [<1:48>] |
transport stream id • interleave <level>
<0:65535> [inc <1:96>]} • modulation {128qam | 256qam | 64qam | off}
• [no] power-attenuation <0:100> [<1:96>] —
See the channel version of this property for a full
description.
• [no] shutdown [<1:48>] — This operation must
be specified. The optional 1–48 value indicates
the number of channels to start up or shut down.
• transport stream id <0:65535> — An ID of 0
removes the transport stream. The inc property
sets the increment of the IDs, such as 2 to skip
every second number (such as 1, 3, 5, etc).
With spectral inversion,only one channel is changed
if the port or configured channel is down, otherwise
all active broadcast channels are changed.
Example:
Casa Systems
QAM interface 17-29
interface qam
Properties (continued)
Property name Description
shutdown Shuts down the QAM port. This command can also
be performed for a specific channel (see the channel
<num> shutdown [<1:80>]) command. The default
state for all QAM ports and channels is shutdown.
This prevents interference with existing
cable-channel configurations. If the QAM port is
disabled, enabling the individual channel will have no
effect until the QAM port is enabled. The no form of
the command restarts the interface.
Example:
spectral inversion on Turns on spectral inversion for the QAM interface. All
parts of the command are required. Spectral
inversion inverts the orientation of the signal
bandwidth with respect to the carrier frequency, a
feature that is turned off by default. Turning spectral
inversion off requires the no form of the command.
Example:
Casa Systems
17-30 RF Cable Configuration Guide and Command Reference
interface qam
Properties (continued)
Property name Description
N * 1000
<channel_span>
Example:
Example:
Casa Systems
QAM interface 17-31
Other related command examples
si generator tot
Generates a Service Information (SI) table for the Time Offset Table (TOT). The
Time Offset Table (TOT) carries the UTC time and date information as well as the
local time offset. It is transmitted in TS packets with a PID value of 0x0014 and a
table ID of 0x73. The command can take the following additional parameters:
Shows the QAM interfaces channel frequencies and shutdown status. The basic
version of the command also shows the associated properties and any shared channels,
which the brief version of the command does not.
Casa Systems
17-32 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the QAM channel statistics. If the channel is specified, it must currently be set
to 0.
Shows the QAM channel power settings for a specified port, including any spectrum
tilt effects. B_POWER is the calculated power before the tilt factor (which gradually
decreases towards the higher end of the frequencies) is subtracted; T_POWER
(B_POWER minus TILT) and CH_POWER show the true channel power.
Casa Systems
QAM interface 17-33
Related show command examples
Shows the QAM field-programmable gate array (FPGA) parameters. For output of the
show interface qam <x/y> block command, see the “Example” on page 9.
Port admin : Up
Port power : 510
Port power tilt : 0
Port power adjusted: 510
total chan up: 8
…
Casa Systems
17-34 RF Cable Configuration Guide and Command Reference
module
module
Purpose
Mode
(config)#
Syntax
[no] module <id> channel-id-offset <1:63>
[no] module <id> narrowcast-channels {<32:96> | <32 | 40 | 48 | 56 |
64>}
[no] module <id> ofdm-channels <1:2>
[no] module <id> ofdma enable
Properties
Property name Description
Example:
CASA(config)# module 0
channel-id-offset 48
CASA(config)#
no module 0 channel-id-offset
Casa Systems
QAM interface 17-35
module
Properties (continued)
Property name Description
Example:
CASA(config)# module 0
narrowcast-channels 48
CASA(config)#
no module 0 narrowcast-channels
Example:
Casa Systems
17-36 RF Cable Configuration Guide and Command Reference
Related show command examples
show narrowcast-channels
Shows QAM interface status and statistics. Other options include specifying a
particular slot.
Shows the QAM modes for the module and its ports. There can be up to three QAM
modes for a QAM 8x192 module, two for unicast and one for broadcast (the one with
the positive ref_cnt). The second broadcast mode (bc_mode 2) is used only in per
channel interleave mode where all the module channels have the same annex,
modulation, and symbol rates, and vary only between two interleave values. The
summary option shows the same output in table format.
Casa Systems
QAM interface 17-37
Related show command examples
Module 1:
uc_mode 1: annex A modulation 256qam interleave 12 symbol_rate 6952
ref_cnt 24
uc_mode 2: annex A modulation 64qam interleave 12 symbol_rate 6952
ref_cnt 24
Port 0:
admin status: UP
total channel up: 28
number uchan up: 24
number bchan up: 4
uchan in mode 1: 12
uchan in mode 2: 12
bchan in mode 1: 4
bchan in mode 2: 0
default mode: annex A modulation 256qam interleave 12
symbol_rate 6952
other mode: annex B modulation 256qam interleave 128x1
symbol rate 0
…
Module 1:
uc_mode 1: annex A modulation 256qam interleave 12 symbol_rate 6952
ref_cnt 24
uc_mode 2: annex A modulation 64qam interleave 12 symbol_rate 6952
ref_cnt 24
PORT ADMIN T_UP UC_UP BC_UP UC_M1 UC_M2 BC_M1 BC_M2 DEF_ANN DEF_MOD
DEF_ITL DEF_SYM OTH_ANN OTH_MOD OTH_ITL OTH_SYM
0 UP 28 24 4 12 12 4 0 Annex_A 64qam
12 6952 Annex_B 256qam 128x1 0
1 DOWN 0 0 0 0 0 0 0 Annex_B 256qam
128x1 0 Annex_B 256qam 128x1 0
2 DOWN 0 0 0 0 0 0 0 Annex_B 256qam
128x1 0 Annex_B 256qam 128x1 0
…
Casa Systems
18-1
The DOCSIS QAM Module (DQM) provides QoS support through a two-level
hierarchical scheduler. The top level is priority based, and the second level is a fair
scheduler based on round robin. Each packet destined for a downstream interface is
assigned a service flow through classification by the DOCSIS forwarding engine. The
scheduler in the DQM module supports a minimum guaranteed rate and a maximum
transmitted rate. Packets are serviced in the order of priority specified by the service
flow. A service flow that is within minimum guaranteed rate is served first. Within the
same priority, round robin is used to schedule between different service flows, unless
service flow weighted fair queuing (WFQ) is enabled.
If the service flow has a minimum guaranteed rate and the current rate is within the
one specified, the packet is queued in the guaranteed class that has the highest priority.
The packet is subsequently rate limited through a token bucket to conform to the
maximum transmitted rate specified for the service flow. Packets that exceed the
maximum transmitted rate are rate-shaped by deferring their transmission. Packets are
Casa Systems
18-2 RF Cable Configuration Guide and Command Reference
QoS support in DCU modules
dropped only if the buffer utilization is high and the buffer usage by the service flow is
above the drop threshold.
In the DOCSIS Control and Upstream (DCU) module, the upstream scheduler handles
modem transmission opportunities. In addition to providing minimum guaranteed rate
and rate limiting support, it also provides jitter guarantees for jitter-sensitive services,
such as unsolicited grant service (UGS). The hierarchical upstream scheduler serves
upstream service flows based on priority. Jitter-sensitive service flows are serviced
first, followed by service flows that are within its guaranteed rate. Best effort service
flows are then serviced in the order of priority. Within each priority, the service flows
are serviced by a round robin scheduler.
For best effort services, the minimum guaranteed rate is checked first. If the
transmission rate of the service flow is within its specified guaranteed rate, the request
is placed in the guaranteed queue, which is serviced before other best effort queues. A
token bucket is used to rate-limit the service flow within its configured maximum
transmission rate and maximum burst size. Requests that exceed the maximum
transmission rate are deferred. Requests that conform to the maximum transmission
rate are placed into the queue determined by the priority of the service flow.
Casa Systems
Quality of service 18-3
QoS support in switch fabric and Gigabit Ethernet interfaces
remainder of the fragments and continues to serve the fragments until the request is
fulfilled.
For service flows that are serviced by upstream channel bonding, the service flow is
inserted into multiple queues, one for each of the upstream channels in the bonding
channel set. The service flow is serviced by each of the upstream channels until all the
outstanding bytes requested are served.
The switch fabric connects to the RF modules and Gigabit Ethernet interfaces. Each of
the fabric ports supports eight classed-based queues. The scheduler in the switch
fabric is straight priority. For packets entering the switch fabric from the DCU
module, the priority is determined by the priority value in the upstream service flow.
For packets entering the switch fabric from Gigabit Ethernet interfaces, the priority is
from the 802.1p field if the packet is VLAN-tagged. For untagged packets, the DSCP
value in the IP header is used to determine the priority. The filtering engine can be
used to overwrite the DSCP value using access list. The priority value can also be
modified based on access lists.
To prevent head-of-line blocking, the switch fabric keeps track of the outstanding
buffer count and packet count for each of the ingress ports and each of the classes.
When an egress port on the switch fabric becomes congested, a packet is discarded at
ingress if the outstanding buffer count or packet count from the ingress port exceeds
the discard threshold for the class it belongs to.
Configuration summary
Table 18-1 lists and briefly describes the objects related to QoS.
Casa Systems
18-4 RF Cable Configuration Guide and Command Reference
QoS support in switch fabric and Gigabit Ethernet interfaces
cops pdp-ip Sets the address of the Policy Decision Point (PDP) for the
Common Open Policy Service (COPS).
qos-profile Configures a QoS profile.
Casa Systems
Quality of service 18-5
cops pdp-ip
cops pdp-ip
Purpose
The cops pdp-ip command sets the address of the Policy Decision Point (PDP) for the
Common Open Policy Service (COPS). The COPS protocol is part of the internet
protocol suite as defined by RFC 2748. COPS specifies a simple client/server model
for supporting policy control over Quality of Service (QoS) signaling protocols (such
as the Resource Reservation Protocol). Policies are stored on servers, and acted upon
by PDPs and are enforced on clients, known as Policy Enforcement Points (PEPs).
There are two models of COPS: the Outsourcing Model and the Provisioning Model,
considered from the view of the client or PEP. The COPS IP address must be in the list
of trusted addresses, or the incoming connection is denied.
The show packetcable cms server command shows the COPS server IP address and
listen port.
Mode
(config)#
Syntax
[no] cops pdp-ip <ip_addr>
Properties
Property name Description
Example:
Casa Systems
18-6 RF Cable Configuration Guide and Command Reference
cops pdp-ip
Shows the PacketCable Multimedia (PCMM) configuration with the COPS server
address, port, and version, if a trusted server.
Casa Systems
Quality of service 18-7
qos-profile
qos-profile
Purpose
The qos-profile command creates a QoS profile with upstream and downstream
bandwidth settings.
Mode
(config)#
Syntax
[no] qos-profile <1:10000> <0:7> <0:100000000> <0:100000000>
<0:100000000> {true|false} <0:65535>
Properties
Property name Description
Example:
Casa Systems
18-8 RF Cable Configuration Guide and Command Reference
qos-profile
cable qos
The cable qos command sets QoS options for the CM.
The qos-id property of the multicast group config command configures the QoS for
the replication of the sessions matching the group configuration.
The multicast group qos command configures the QoS for a multicast group.
show qos-profile
Casa Systems
Quality of service 18-9
qos-profile
Casa Systems
19-1
Casa Systems
19-2 RF Cable Configuration Guide and Command Reference
Spectrum management commands description
5. If the configured channel width differs from the starting high channel width in a
spectrum rule, the high channel width governs in the rule. For example, if the
configured channel width is 3.2MHz and chan-width 6400000 800000 is in the
rule, when a channel width adjustment occurs, it changes to 1.6 MHz (anything
less is unsupported for upstream 16x8 modules). When it recovers, it tries from
6.4 MHz (the high end) first, then the lower width.
6. The show interface upstream x/y and show running-config commands show
configurations, but not necessarily the current configuration of an upstream
interface. If CSM is in use, use show interface upstream x/y current and show
spectrum hop-history upstream x/y[.lchan-1].
7. CSM has a built-in default SNR threshold for each modulation type. To view
them, use the show spectrum snr-threshold-default command. CSM can work
without an SNR threshold for a modulation profile specified in a spectrum rule;
that is, using the default SNR threshold. However, a corrective action will not take
place due to low polled SNR.
8. There can be up to three action command items in the spectrum rule, unless CM
mode is in effect, where only one of two (channel-width or modulation) can be
specified. There is no default action. CSM will attempt a corrective (or
improvement) action in the order specified in the command. However, this does
not guarantee the action takes place. It is important to know how the action helps
before performing it. If an action does not help, it attempts the next one. The most
common reason for an action not helping is that the calculated SNR for that action
does not satisfy the SNR threshold for a modulation profile.
9. A spectrum rule can be Fast Fourier Transform (FFT) or CM mode. An FFT mode
rule can be applied on an upstream physical channel, which means that it
functions on logical channel 0. An FFT rule cannot be applied specifically on
logical channel 0; it can be applied specifically on logical channel 1, but it does
not allow for frequency hops, because the frequency is shared between the logical
channels. A CM mode spectrum rule can be applied (and takes effect) on a logical
channel only. If both physical and logical channels of an interface have spectrum
rules applied, the logical channel rule takes priority.
10. If you want to change configuration based on modulation profile or channel width
(whatever you want CSM to manage), remove the spectrum rule from the channel
first, and put the spectrum rule back in the channel list after the configuration
change. This avoids a conflict between the manual change and CSM control.
Casa Systems
Spectrum management 19-3
Frequency hop case study
If CSM cannot find a frequency to hop to, it will not hop, even if the current frequency
is too noisy to support modems. For example, if there is noise at 31 MHz on interface
5/1/0, then it should perform a frequency hop. There can be multiple steps in the
hopping. However, if the spectrum map is as follows:
There is nowhere to hop to avoid the noise. The three bands (0-2) are too narrow to
escape the noise. When CSM tries a hop (frequency, modulation, or channel width), it
checks if the calculated SNR at the destination (new freq, etc.) is good enough to
accommodate the SNR threshold (280, in this case). If so, hopping is performed.
Otherwise, it tries the next action. In this example, there is no other action.
However, if the 8/4 frequency is moved to 45MHz (away from 25+1.6=26.6 MHz) to
give channel 8/1 more room, as in the following:
spectrum rule 2
frequency band 26000000 42000000
action frequency
Then move channel 8/1 back to 30 MHz (resetting the CSM state machine at
channel 8/1), and apply the rule 2 to upstream 8/1, to acquire:
When the CSM poll reaches a threshold, the channel hops to freq 27.6 MHz, as
indicated by the following debug message:
Casa Systems
19-4 RF Cable Configuration Guide and Command Reference
CSM configuration examples
Casa Systems
Spectrum management 19-5
CSM configuration examples
Configuration summary
Table 19-1 lists and briefly describes the objects related to spectrum management.
Casa Systems
19-6 RF Cable Configuration Guide and Command Reference
channel-utilization-interval
channel-utilization-interval
Purpose
The channel-utilization-interval command sets the interval over which the channel
utilization information is collected and averaged.
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
Property name Description
Example:
CASA(config)#
channel-utilization-interval 86400
show channel-utilization-interval
Casa Systems
Spectrum management 19-7
hop period
hop period
Purpose
The hop period command sets a time period between two consecutive frequency
hops. This period allows new channels to stabilize before making a frequency hopping
decision to assign the traffic to cleaner upstream channels. The default hop period is
every 30 seconds. (This command may be replaced by the cable spectrum
hop-period command.)
Mode
(config)#
Syntax
hop period <5:3600>
Properties
Property name Description
Example:
CASA(config)# hop-period 30
Casa Systems
19-8 RF Cable Configuration Guide and Command Reference
hop period
Shows the spectrum hop history. The Code column shows the abbreviations M
(modulation), C (channel-width), or F (frequency). Filtering can also be by upstream
interface. The last column in the example shows that CM mode is in effect. CM 16
(15) means that 16 modems suffered a hop-down, based on a tolerance-count
threshold (15). CM 7 (15-3) shows a subsequent back-hop of seven modems, which is
less than 12, the tolerance-count (15) minus the backhop-count (3). Use the clear
spectrum hop-stats upstream command to reset the statistics counter.
Shows the spectrum hop statistics for a service group. Additional qualifiers can be
channel-width, modulation, and time-info. Channels without spectrum management
rules or where monitoring is not active appear simply as the channel and logical
channel (such as 10/8.1/1: in the example). The associated MIB is the
clabTopoFiberNodeCfgNodeName object type in the DOCSIS CLAB-TOPO-MIB.
Casa Systems
Spectrum management 19-9
spectrum
spectrum
Purpose
Casa Spectrum Management (CSM) allows the Casa CMTS to monitor the quality of
upstream paths and automatically perform corrective actions when upstream plant
impairments are detected. The monitored upstream plant impairments include Signal
to Noise Ratio (SNR), correctable Forward Error Corrections (FECs), and
uncorrectable FECs. The automatic corrections include frequency hopping, upstream
channel-width adjustment, and dynamic upstream modulation profile changes. CSM
also provides a means to report the configurations, actions, and some test facilities.
Modes
(config)#
(conf-rule x)#
(conf-sched x)#
Casa Systems
19-10 RF Cable Configuration Guide and Command Reference
spectrum analysis
spectrum analysis
Purpose
Mode
(config)#
Syntax
[no] spectrum analysis full-spectrum
spectrum analysis measurement-interval <5:30>
Properties
Property name Description
Example:
Example:
Casa Systems
Spectrum management 19-11
Related show command examples
Casa Systems
19-12 RF Cable Configuration Guide and Command Reference
Related show command examples
EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E
EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E EF 8E
EF 8E EF 8E EF 8E F1 E8 F1 E8 F1 E8 F1 E8 F1 E8 F1 E8 F1 E8 F1 E8
…
Casa Systems
Spectrum management 19-13
spectrum monitor-interface
spectrum monitor-interface
Purpose
Mode
(config)#
Syntax
[no] spectrum monitor-interface <slot>/<port>.<phy_chan>
Properties
Property name Description
Example:
CASA(config)# spectrum
monitor-interface 11/0.1
CASA(config)#
no spectrum monitor-interface 11/0.1
Shows status and other statistics for the configured monitor interfaces.
Casa Systems
19-14 RF Cable Configuration Guide and Command Reference
spectrum rule
spectrum rule
Purpose
Casa Spectrum Manager (CSM) uses the Fast Fourier Transform (FFT) technique to
monitor signal quality on the return path. The FFT screening results, signal-to-noise
ratio (SNR) and Forward Error Correction (FEC) errors in particular, are the main
error events monitored to determine whether plant noise exists and corrective actions
are necessary. Corrective actions can be one, two or all three of frequency hopping,
channel width adjustment, and dynamic modulation profile change.
CSM also provides cable modem (CM) mode management in place of FFT mode
management, if specified via the cm-mode property. CM mode uses the upstream
SNR of a group of CMs to determine the overall quality of the upstream channel. The
CSM approach is tolerance control, that is, how many CMs to tolerate on a particular
channel that suffer low signal quality. CSM polls the CMs, counts how many on a
logical channel have a lower-than-threshold SNR, and may perform a channel hop
when this count is exceeded. In CM mode, roll-back provisions are also included
based on the tolerance. FFT mode and CM mode spectrum rules can be applied to
upstream interfaces in any valid combination, except that CM mode rules must be
applied on logical channels. The roll-back SNR conditions (whether using modulation
profile defaults or explicitly defined) are the same for CM mode and FFT mode.
The following rules apply to using FFT and CM mode spectrum rules on physical and
logical upstream interface channels:
Casa Systems
Spectrum management 19-15
spectrum rule
CSM maintains a list of discrete channel frequencies and/or one or more frequency
bands for each upstream interface as frequency hopping targets. This is called a
spectrum map. CSM scans through the spectrum map to select the cleanest channel.
The spectrum map is updated when a hop is performed. CSM uses spectrum rules to
manage the corrective actions. A spectrum rule consists of a set of thresholds and a
sequential list of actions. An action can be frequency hopping, channel width
adjustment, or modulation profile. An FFT or CM mode procedure is triggered when a
monitored indicator to an upstream interface hits a defined or default threshold.
The actions take place in an order defined by the operator in the action commands. If
plant signal quality is maintained within the thresholds due to one or more actions, the
subsequent actions in a rule are not performed, because they are not necessary. If the
upstream channel signal with corrected modulation and/or adjusted channel width
returns to 3 dB above normal, the spectrum manager may roll back the settings to their
original channel width or modulation profile setting. The back-hop threshold can also
be specified in the CLI. To activate CSM on specified upstream interfaces, spectrum
rules need to be defined and assigned on the interfaces.
Modes
(config)#
(conf-rule x)#
Syntax
(config)# [no] spectrum rule <1:64>
(conf-rule x)#
action {channel-width | frequency | modulation | scheduler <1:16>}
back-hop-limit <1:16> <1:144> [channel-width | modulation]
no back-hop-limit
channel-width <high> <low>
no channel-width
[no] cm-hop
cm-mode [backhop-count <3:10> | backhop-delay <1:100> |
modulation-immediate | tolerance-count <4:100>]
no cm-mode
correctable-fec threshold <0:100> [1000]
[no] description “<text>”
Casa Systems
19-16 RF Cable Configuration Guide and Command Reference
spectrum rule
Properties
Property name Description
Example:
Casa Systems
Spectrum management 19-17
spectrum rule
Properties (continued)
Property name Description
• channel-width
• frequency (FFT mode only)
• modulation
A modulation action requires a secondary profile for
the logical channel in the interface upstream
definition. The spectrum scheduler ID can also be
specified separately for rule scheduling.
Example:
Example:
Casa Systems
19-18 RF Cable Configuration Guide and Command Reference
spectrum rule
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
Spectrum management 19-19
spectrum rule
Properties (continued)
Property name Description
Example:
Casa Systems
19-20 RF Cable Configuration Guide and Command Reference
spectrum rule
Properties (continued)
Property name Description
Example:
Example:
frequency band Sets a frequency band for the rule, in Hz, with a value
<5000000:99800000> for the left edge and a value for the right edge of the
<5200000:100000000> spectrum.
Example:
Casa Systems
Spectrum management 19-21
Other related command examples
Properties (continued)
Property name Description
Example:
Example:
interface upstream
spectrum-rule
Casa Systems
19-22 RF Cable Configuration Guide and Command Reference
Related show command example
interface qam
spectral inversion on
The spectral inversion on property of the interface qam command turns on spectral
inversion for the QAM interface
Shows the cable spectrum settings and spectrum rules, including any CM mode
settings. Filtering can be by rule ID or more brief output.
spectrum rule 1
cm-hop
correctable-fec threshold 5
uncorrectable-fec threshold 3
spectrum rule 35
cm-mode
cm-mode modulation-immediate
action modulation
profile 8 snr-threshold 190 220
profile 10 snr-threshold 130 190
profile 20 snr-threshold 244 274
profile 21 snr-threshold 197 227
profile 22 snr-threshold 133 263
Casa Systems
Spectrum management 19-23
Related show command example
Shows the spectrum SNR threshold defaults. CSM has a built-in default SNR
threshold for each modulation type and for each modulation profile. The default SNR
threshold takes effect for a spectrum rule if there is no threshold specified in a
spectrum rule for a particular modulation profile.
Casa Systems
19-24 RF Cable Configuration Guide and Command Reference
spectrum scheduler
spectrum scheduler
Purpose
The spectrum scheduler command applies a start and end time to spectrum rules.
When enabled, the spectrum rule is in effect to applied channels over the scheduled
time period. When disabled, the rule is not in effect over the specified time periods,
but the rule is enabled during the other configured times. By default, and without any
start and end time, the spectrum rule is scheduled at all times for the applicable
channels. There can be up to 16 scheduler IDs.
Modes
(config)#
(conf-sched x)#
Syntax
[no] spectrum scheduler <1:16>
(conf-sched x)#
[no] description “<text>”
time-action <1:8> {always | {{mon | tue | wed | thu | fri | sat |
sun} <hh:mm>} {mon | tue | wed | thu | fri | sat | sun}
<hh:mm>}} {channel width | frequency | modulation}
no time-action <1:8>
Properties
Property name Description
Example:
Casa Systems
Spectrum management 19-25
spectrum scheduler
Properties (continued)
Property name Description
Example:
Casa Systems
19-26 RF Cable Configuration Guide and Command Reference
test cable hop upstream
The test cable hop upstream command tests the upstream cable hop for a particular
interface.
Mode
(diag)#
Syntax
test cable hop upstream <slot>/<port>.<chan>/<lchan>
Properties
Property name Description
Example:
CASA# diag
Password:
CASA(diag)# test cable hop upstream
13/0.0/0
no spectrum rule on the channel or less
than hop period since last hop on
13/0.0/0
Casa Systems
Spectrum management 19-27
test cable hop-cm-mode upstream
The test cable hop-cm-mode upstream command tests the upstream cable hop for a
CM mode spectrum rule for a particular interface by simulating an upstream poll
based on the polled number of low SNR modems and the corresponding spectrum rule
at the channel.
Mode
(diag)#
Syntax
test cable hop-cm-mode upstream <slot>/<port>.<chan>/<lchan> <1:100>
<1:64>
Properties
Property name Description
Example:
CASA# diag
Password:
CASA(diag)# test cable hop-cm-mode
upstream 13/0.0/0 10 3
a simulated threshold hit in cm-mode is
sent to 13/0.0/0
Casa Systems
20-1
Configuration summary
Table 20-1 lists and briefly describes the objects related to subscriber management.
Casa Systems
20-2 RF Cable Configuration Guide and Command Reference
docsis submgt default
The docsis submgt default command sets the subscriber management default settings
from the CMTS if the modem configuration file does not specify otherwise. The
packet filter group ID in each case refers to the docsis submgt ip-filter value.
Mode
(config)#
Syntax
docsis submgt default active {off | on}
docsis submgt default cm-filter-downstream <0:1024>
docsis submgt default cm-filter-upstream <0:1024>
docsis submgt default cpe-filter-downstream <0:1024>
docsis submgt default cpe-filter-upstream <0:1024>
docsis submgt default learnable {off | on}
docsis submgt default max-ip <0:1023>
docsis submgt default max-ipv6-iapd <0:1023>
docsis submgt default max-ipv6-prefix <0:1023>
docsis submgt default mta-filter-downstream <0:1024>
docsis submgt default mta-filter-upstream <0:1024>
docsis submgt default ps-filter-downstream <0:1024>
docsis submgt default ps-filter-upstream <0:1024>
docsis submgt default stb-filter-downstream <0:1024>
docsis submgt default stb-filter-upstream <0:1024>
Properties
Property name Description
Example:
Casa Systems
Subscriber management 20-3
docsis submgt default
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
learnable {off | on} Allows the CM to learn its IP address. The default is
on.
Example:
Casa Systems
20-4 RF Cable Configuration Guide and Command Reference
docsis submgt default
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Casa Systems
Subscriber management 20-5
docsis submgt default
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Example:
Casa Systems
20-6 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the cable subscriber usage. This command depends on a cable traffic-policy
being defined. (See Chapter 4, “Cable commands.”)
Casa Systems
Subscriber management 20-7
docsis submgt filters clear-all
The docsis submgt filters clear-all command removes all subscriber management IP
and TCP/UDP filters in the system. The command requires a confirmation response.
Mode
(config)#
Syntax
docsis submgt filters clear-all
Are you sure? (yes/no)
Clearing all submgt filters...
Casa Systems
20-8 RF Cable Configuration Guide and Command Reference
docsis submgt ip-filter
The docsis submgt ip-filter command sets a filter rule for DOCSIS subscriber
management to control IP packet forwarding to and from each CM, at the CMTS.
Each modem can be afforded a different subscriber management treatment. Filtering
criteria are maintained through SNMP at the CMTS. There can be up to 1500
subscriber management filters.
Mode
(config)#
Syntax
docsis submgt ip-filter <1:1024> <1:65535> {accept | deny}
docsis submgt ip-filter <1:1024> <1:65535> {accept | deny}
[cm-intf-mask <0:ffffff>] [dst-ip <ip_addr> <mask> | dst-ipv6
<ipv6_addr>] [dst-port <0:65535> <0:65535>] [protocol <0:257>]
[src-ip <ip_addr> <mask>] [src-ipv6 <ipv6_addr>] [src-port
<0:65535> <0:65535>] [tos <0:255> <0:255> <0:255> [cm-intf-mask
<0:ffffff> | dst-port <0:65535> <0:65535> | protocol <0:257> |
src-port <0:65535> <0:65535>]]
no docsis submgt ip-filter <1:1024> <1:65535>
Properties
Property name Description
Casa Systems
Subscriber management 20-9
docsis submgt ip-filter
Properties (continued)
Property name Description
Example:
Casa Systems
20-10 RF Cable Configuration Guide and Command Reference
docsis submgt ip-filter
Properties (continued)
Property name Description
Shows the IP filters for DOCSIS subscriber management. An accept appears as the
number 1 in the output.
Casa Systems
21-1
Upstream modules are available as 16x4, 16x8, or 32x4 line cards. The UPS 16x8
module does not support channel widths less than 1.6 MHz. The UPS 32x4 module is
a revised version of the UPS 16x8 line card, operates with the Casa C100G, C40G,
and C10G CMTS platforms, and is not supported for use with the UPS 16x4 line card.
Configuration summary
Table 21-1 lists and briefly describes the objects related to the upstream interface.
Casa Systems
21-2 RF Cable Configuration Guide and Command Reference
interface upstream
interface upstream
Purpose
Modes
(config)#
(config-if-ups X/Y.C)#
Syntax
(config)# interface upstream <slot>/<port>.<pchan>
(config-if-ups X/Y.C)#
channel-width <Hz>
description “<text>”
no description
frequency <5000000:100000000>
ingress-cancellation [<10:1000>]
no ingress-cancellation
interface upstream <slot>/<port>.<pchan>
logical-channel {0|1} [description “<text>”]
no logical-channel {0|1} description
logical-channel {0|1} channel-width <Hz>
logical-channel {0|1} class-id <0x0:0xffffffff>
logical-channel {0|1} data-backoff {<0:15> <0:15> | automatic}
no logical-channel {0|1} data-backoff
logical-channel {0|1} minislot <size>
logical-channel {0|1} power-offset <-10:10>
[no] logical-channel {0|1} pre-equalization [auto-reset] [0:65535]
logical-channel {0|1} profile <1:1024> [secondary-profile
<id_list>]
logical-channel {0|1} prov-attr-mask {<0x0:0xffffffff> | {[bonding]
[highavailability] [lowlatency]}
[no] logical-channel {0|1} ranging-backoff <0:15> <0:15>
Casa Systems
Upstream interface 21-3
interface upstream
Properties
Property name Description
Example:
Casa Systems
21-4 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
channel-width 6400000
Example:
Example:
Example:
CASA(config-if-ups 13/1.0)#
ingress-cancellation 500
CASA(config-if-ups 13/1.0)#
no ingress-cancellation
Casa Systems
Upstream interface 21-5
interface upstream
Properties (continued)
Property name Description
Example:
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1
CASA(config-if-ups 13/1.0)#
no logical-channel 1
CASA(config-if-ups 13/1.0)#
no logical-channel 1 description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1 channel-width 6400000
Casa Systems
21-6 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1 class-id 0xFFFFFFFF
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 data-backoff 2 8
CASA(config-if-ups 13/1.0)#
no logical-channel 0 data-backoff
Casa Systems
Upstream interface 21-7
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 minislot 64
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 power-offset 0
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 pre-equalization
auto-reset 1440
CASA(config-if-ups 13/1.0)#
no logical-channel 0 pre-equalization
Casa Systems
21-8 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
CASA(config-if-ups 13/1.0)#
logical-channel 0 profile 3
secondary-profile 12,20,33
Casa Systems
Upstream interface 21-9
interface upstream
Properties (continued)
Property name Description
CASA(config-if-ups 13/1.0)#
logical-channel 0 prov-attr-mask 0x0
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 ranging-backoff 2 8
CASA(config-if-ups 13/1.0)#
no logical-channel 0 ranging-backoff
Casa Systems
21-10 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
CASA(config-if-ups 13/1.0)#
logical-channel 0 ranging-priority 0x0
CASA(config-if-ups 13/1.0)#
logical-channel 0 shutdown
CASA(config-if-ups 13/1.0)#
no logical-channel 0 shutdown
CASA(config-if-ups 13/1.0)#
logical-channel spectrum-rule 1
CASA(config-if-ups 13/1.0)#
no logical-channel spectrum-rule
Casa Systems
Upstream interface 21-11
interface upstream
Properties (continued)
Property name Description
Example:
Casa Systems
21-12 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
partial-service fec-threshold 3
CASA(config-if-ups 13/1.0)#
partial-service snr-threshold -1
CASA(config-if-ups 13/1.0)#
power-adjustment threshold 1
CASA(config-if-ups 13/1.0)#
no power-adjustment continue
Casa Systems
Upstream interface 21-13
interface upstream
Properties (continued)
Property name Description
power-level <-16:34> Output power level of the interface. The Casa CMTS
controls the output power levels of CMs to meet the
desired upstream input power level. The nominal
input power level for the upstream RF carrier is in
decibels per millivolt (dBmV). The optimal setting is
0 dBmV.
Example:
CASA(config-if-ups 13/1.0)#
power-level 0
Example:
CASA(config-if-ups 13/1.0)#
pre-equalization extended-taps
CASA(config-if-ups 13/1.0)#
no pre-equalization extended-taps
Example:
Example:
Casa Systems
21-14 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
small-signal-compensation
CASA(config-if-ups 13/1.0)#
no small-signal-compensation
Casa Systems
Upstream interface 21-15
interface upstream
Properties (continued)
Property name Description
Example:
Casa Systems
21-16 RF Cable Configuration Guide and Command Reference
interface upstream
Properties (continued)
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
voice-bw-reserve max-calls 100
CASA(config-if-ups 13/1.0)#
no voice-bw-reserve
modulation-profile <id>
This command creates a modulation profile with the necessary Forward Error
Correction (FEC) bytes to help increase throughput when applied to a downstream
logical channel.
Casa Systems
Upstream interface 21-17
interface upstream
frequency 20000000
channel-width 3200000
ingress-cancellation
logical-channel 0 profile 2
logical-channel 0 minislot 2
logical-channel 0 pre-equalization
no logical-channel 0 shutdown
logical-channel 1 profile 2
logical-channel 1 minislot 2
logical-channel 1 pre-equalization
logical-channel 1 shutdown
no shutdown
Casa Systems
21-18 RF Cable Configuration Guide and Command Reference
interface upstream
Shows the Unsolicited Grant Service (UGS) statistics for the upstream interfaces.
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
Shows the upstream interface burst noise rate or carrier-to-noise ratio (CNR).
Casa Systems
Upstream interface 21-19
upstream igmp filter
The upstream igmp filter command sets the number of Internet Group Management
Protocol (IGMP) packets to accept and the number of seconds in a window.
Mode
(config)#
Syntax
upstream igmp filter <0:5000> <1:5>
no upstream igmp filter
Properties
Property name Description
Example:
Casa Systems
21-20 RF Cable Configuration Guide and Command Reference
upstream map size
The upstream map size command sets the minimum upstream MAP size.
Mode
(config)#
Syntax
[no] upstream map size <2:10>
Properties
Property name Description
Example:
Casa Systems
Upstream interface 21-21
Related show command examples
Shows the upstream interface configuration in a brief form. You can also use the
current modifier to get the current configuration.
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
Casa Systems
21-22 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the upstream channel sets. The added | count-only / output modifier returns the
number of count lines only (the slash is a regular expression) to determine the number
of channel sets in use.
Casa Systems
Upstream interface 21-23
Other related command
Shows the average signal-to-noise ratio (SNR) of the upstream channels in dB units.
modulation-profile
Casa Systems
22-1
Casa Systems
22-2 RF Cable Configuration Guide and Command Reference
Video commands description
Configuration summary
Table 22-1 lists and briefly describes the objects related to video.
Casa Systems
Video 22-3
Video commands description
Casa Systems
22-4 RF Cable Configuration Guide and Command Reference
adduser
adduser
Purpose
The adduser command adds a user to the CMTS configuration. The user’s password
is encrypted by default. The default username is root and the default password is casa.
Modes
#
(config)#
Syntax
adduser <login_id> [privilege <0:15>]
New password: <pwd>
Reenter password: <pwd>
Properties
Property name Description
Casa Systems
Video 22-5
adduser
Properties (continued)
Property name Description
Example:
Shows the user configuration. The same result can be achieved with the show run |
include user command. The current or privilege modifier can also be added.
Casa Systems
22-6 RF Cable Configuration Guide and Command Reference
interface video
interface video
Purpose
Modes
(config)#
(conf-if-video <id>)#
Syntax
(config)# [no] interface video <1:16>
(conf-if-video x)#
bandwidth <0:80000000>
description “<text>”
no description
edis control-source loopback <0:255>
no edis control-source
[no] gige <slot>/<port>
input-group-name <name>
no input-group-name
input-port-id <1:8 | 1:65535>
no input-port-id
ip {address <ip_addr> <mask> | igmp [version <1:3>]}
no ip {address | igmp}
[no] trunk <1:65535>
vlan <1:4094>
no vlan
vrf forwarding <name>
no vrf forwarding
[no] xgige <slot>/<port>
Casa Systems
Video 22-7
interface video
Properties
Property name Description
Example:
Example:
Example:
Example:
Casa Systems
22-8 RF Cable Configuration Guide and Command Reference
interface video
Properties (continued)
Property name Description
gige <slot>/<port> GigE interface slot and port for the voice interface.
There can be up to 16 video interfaces per GigE port.
Example:
Example:
input-port-id <1:8 | Input port ID, to provide the flexibility of modifying the
1:65535> input port used in signaling. For EDIS the maximum
value is 8, for Next Generation on Demand (NGOD)
the maximum value is 65535. If omitted, takes the
value of the video interface ID.
Example:
Example:
Casa Systems
Video 22-9
interface video
Properties (continued)
Property name Description
Example:
Example:
vrf forwarding <name> Enables video Virtual Routing and Forwarding (VRF)
based on a predefined VRF on the VLAN. See the
“Video in a virtual routing and forwarding instance”
section for further details.
Example:
xgige <slot>/<port> XGigE interface slot and port for the voice interface.
There can be up to 16 video interfaces per XGigE
port.
Example:
Casa Systems
22-10 RF Cable Configuration Guide and Command Reference
interface video
Example
The following set of commands creates a video interface that operates in routing mode
and configures the GigE and XGigE interfaces. Note the absence of GigE or XGigE
ports configured for the video interface and the presence of IP addresses on the GigE
and XGigE interfaces.
Casa Systems
Video 22-11
interface video
Shows the video voice statistics. OFDMA upstream channels are indicated with a “w”
(for wideband).
Casa Systems
22-12 RF Cable Configuration Guide and Command Reference
video
video
Purpose
The video command sets video properties. Some commands spawn other
configuration modes.
Modes
#
(config)#
(conf-video-edis x)#
(conf-video-erm x)#
(conf-qam-domain x)#
(conf-video-session x)#
Casa Systems
Video 22-13
video cat-interval
video cat-interval
Purpose
The video cat-interval command sets the maximum time in milliseconds between
adjacent conditional access tables (CATs). A CAT manages cypher keys for
decrypting restricted video streams used for maintaining regular key updates.
Mode
(config)#
Syntax
video cat-interval {<50:1000> | default}
Properties
Property name Description
Example:
Casa Systems
22-14 RF Cable Configuration Guide and Command Reference
video channel-id-offset
video channel-id-offset
Purpose
The video channel-id-offset command excludes DOCSIS channels from the video
channel numbering space. The specified offset indicates the number of reserved
DOCSIS channels. Video channel numbering begins following the offset, where the
first video channel begins at 0. To use the maximum number of narrowcast channels
per port (64) for QAM 8x96 or QAM 8x192, use this command so that the number of
narrowcast video channels per port is less than or equal to 64.
The channel ID offset value can be configured based on the following formula of valid
module narrowcast-channels ranges:
From 1 (or Nmax–64 if Nmax is greater than 64) through Nmax–1, where Nmax is
the largest module narrowcast-channels <num> setting among the modules.
This means that for QAM 8x96 at Nmax 48, the offset value range is 1–47; for
QAM 8x192 at Nmax 80, the offset value range is 16–79. For Nmax 70, the valid
offset value range would be 6–69 (70 minus 64 through 70 minus 1).
The channel-id-offset is set to 32, where channels 0–31 are reserved for DOCSIS and
the remaining 16 channels (32–47) are video channels for QAM 8x96, or 48 channels
(32–79) for QAM 8x192. The remaining video channels are then numbered 0–15 for
QAM 8x96, or 0–47 for QAM 8x192.
The channel-id-offset is set to 64, where channels 0–63 are reserved for DOCSIS and
the remaining 16 channels (64–79) are video channels for the QAM 8x192. The
remaining video channels are then numbered 0–15.
Casa Systems
Video 22-15
video channel-id-offset
Mode
(config)#
Syntax
video channel-id-offset <1:79>
Properties
Property name Description
Example:
Related command
Casa Systems
22-16 RF Cable Configuration Guide and Command Reference
video clk-drift-correction
video clk-drift-correction
Purpose
Mode
(config)#
Syntax
[no] video clk-drift-correction
Casa Systems
Video 22-17
video dejitter-interval
video dejitter-interval
Purpose
The video dejitter-interval command sets the dejitter buffer size. Jitter is the
deviation from true periodicity of a presumed periodic signal, often in relation to a
reference clock source.
Mode
(config)#
Syntax
video dejitter-interval {<10:500> | default}
Properties
Property name Description
Example:
Casa Systems
22-18 RF Cable Configuration Guide and Command Reference
video drop ghost-pid
The video drop ghost-pid command enables dropping ghost Packet Identifiers
(PIDs). A ghost PID is not identified as a well-known PID and is not included in PMT
tables. By default, ghost PIDs are dropped (enabled).
Mode
(config)#
Syntax
(config)# [no] video drop ghost-pid
Casa Systems
Video 22-19
video drop reserved-pids
The video drop reserved-pids command enables dropping packets containing packet
IDs (PIDs) in the range of reserved PIDs, default enabled. Packets with reserved PIDs
should not appear in a Program Mapping Table (PMT) or video Program Association
Table (PAT), or they might be forwarded unconditionally without being processed,
causing the session to be stuck in the Initial state. PIDs 1–15 are the well-known
reserved PIDs, but other markets have other reserved PID ranges, such as Digital
Video Broadcasting (DVB) with PID ranges 16–31 reserved for DVB metadata.
According to these requirements, the desired reserved range is set by the
video reserved-pid upper-limit command.
Packets marked with these reserved PIDs are either dropped with
video drop reserved-pids as they should, or passed through with no video drop
reserved-pids.
Mode
(config)#
Syntax
[no] video drop reserved-pids
Casa Systems
22-20 RF Cable Configuration Guide and Command Reference
video edis
video edis
Purpose
The video edis command configures the Edge Device Interface Specification (EDIS)
index in the QAM domain that defines the session resource manager (SRM). Using
the EDIS protocol, the SRM controls video interfaces and QAM channels in the QAM
domain. One SRM could be from a source such as the Cisco Universal Session and
Resource Manager (USRM), or from another vendor. The EDIS index becomes part
of the video qam-domain definition. Using EDIS, the video runs in SRM mode.
Modes
(config)#
(conf-video-edis <index>)#
Syntax
(config)# [no] video edis <1:8>
(conf-video-edis x)#
[no] announce
[no] description “<text>”
[no] ip-address <ip_addr>
[no] output-port-base <0 | 1>
[no] reset-indication [on-failure]
reset-interval <1:60>
[no] srm-type {bbnd-cvex | casa | cisco-usrm}
(config)# [no] video edis bandwidth-control
Properties
Property name Description
Example:
Casa Systems
Video 22-21
video edis
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
22-22 RF Cable Configuration Guide and Command Reference
video edis
Properties (continued)
Property name Description
output-port-base <0 | 1> Sets the output port base, 0 by default, and
overwrites the video qam export configuration slot
base setting. With an output base value of:
Example:
CASA(conf-video-edis 5)#
output-port-base 0
Example:
CASA(conf-video-edis 5)#
reset-indication
CASA(conf-video-edis 5)#
no reset-indication
Example:
Casa Systems
Video 22-23
video edis
Properties (continued)
Property name Description
Example:
Example:
Configures an access control for EDIS traffic, inbound (the default) or outbound.
Casa Systems
22-24 RF Cable Configuration Guide and Command Reference
video edis
ip-address 169.254.1.2
srm-type bbnd-cvex
reset-interval 5
announce
no reset-indication
video edis 2
ip-address 98.19.16.55
srm-type casa
reset-interval 5
announce
no reset-indication
Casa Systems
Video 22-25
video erm
video erm
Purpose
The video erm command configures Edge Resource Manager (ERM) properties.
ERM is part of the Next Generation On Demand (NGOD) specification and provides
reliable and optimized access to Edge QAM (EQAM) device resources. The ERM
interface is designed to manage the resource allocation of various EQAM resources
for DOCSIS and VoD activities. In addition, the EQAM device supports a
Registration Interface to ERM with the purpose of maintaining an accurate inventory
of resources availability in the EQAM devices. (See the Casa Systems – CCAP Video
Edge User Guide for details.)
Modes
(config)#
(conf-video-erm <id>)#
Syntax
(config)#
[no] video erm <1:8>
(conf-video-erm x)#
connect-retry-time <1.0:60.0>
hold-timeout <30:300>
[no] host-address <addr> [port <1:65535>]
keepalive-timeout <1:120>
Properties
Property name Description
Example:
Casa Systems
22-26 RF Cable Configuration Guide and Command Reference
video erm
Properties (continued)
Property name Description
Example:
CASA(conf-video-erm 1)#
connect-retry-time 7.5
Casa Systems
Video 22-27
video erm
Properties (continued)
Property name Description
Example:
Example:
CASA(conf-video-erm 1)#
keepalive-timeout 20
Casa Systems
22-28 RF Cable Configuration Guide and Command Reference
video error-threshold
video error-threshold
Purpose
The video error-threshold command sets the number of errors to occur before
detecting video degradation.
Mode
(config)#
Syntax
video error-threshold {<1:65535> | default}
Properties
Property name Description
Example:
Casa Systems
Video 22-29
video error-threshold
Input Stream:
Uptime : stopped
Data State : Off
Packets Detected : Yes
PSI Detected : Yes
Bitrate Requested : 0 bps
Bitrate Detected Avg : 0 bps
Bitrate Detected Max : 0 bps
Jitter Detected Avg : 0 ms
Jitter Detected Max : 0 ms
Stream Type : SPTS
SSM Address : 192.30.3.30(*)
Destination IP Addr : 224.2.2.3
Destination UDP Port : 7
PIDs to be dropped :
Input Port : unknown
Encryption(Oper) : Clear
…
Casa Systems
22-30 RF Cable Configuration Guide and Command Reference
video error-window
video error-window
Purpose
The video error-window command sets the time period when sampling for degraded
video.
Mode
(config)#
Syntax
[no] video error-window {<1:30> | default}
Properties
Property name Description
Example:
Casa Systems
Video 22-31
video logging
video logging
Purpose
The video logging command selects one or more logging levels for capturing video
event messages to the system log file. By default, the system logs messages are
classified at the Warning, Informational, and Errors event levels. All other levels must
be interactively enabled with the command.
Before starting a video configuration, ensure that NTP, logging (IPv4 or IPv6), and
SNMP trap server IP addresses have been configured on the system. These services
are important for capturing and monitoring video session activity and for keeping
synchronized with NTP and other servers operating in the video network.
Note: It is recommended that you keep the debugging level disabled unless you are
actively troubleshooting a video problem. Keeping it enabled may impact
system performance when debugging processes are running.
Mode
(config)#
Syntax
[no] video logging {announce | d6-keep-alive | debugging | edis-ping |
edis-raw | edis-text | errors | host | informational | ngod-raw
| ngod-text | trace | source-interface | trace | warning}
Casa Systems
22-32 RF Cable Configuration Guide and Command Reference
video logging
Properties
Property name Description
Casa Systems
Video 22-33
video min-stream-switch-time
video min-stream-switch-time
Purpose
The video min-stream-switch-time command sets the minimum time gap between
two QAM-issued stream switches, or sets the default to 3 seconds. A QAM-issued
stream switch is controlled by QAM, but two successive stream switches cannot take
place within the given time interval. The latter stream switch will be pushed to a queue
and scheduled in a dedicated thread, and in the meantime, a flag indicating the stream
error is saved for the session. After the time interval, the latter stream switch is
processed. If the stream error is recovered during the time, no stream switch is
performed, otherwise, it switches to the next source. When the flag exists, all
subsequent stream errors reported by QAM are discarded.
Use the show video global config command to see the configuration setting.
Mode
(config)#
Syntax
[no] video min-stream-switch-time {<1:60> | default}
Properties
Property name Description
Example:
CASA(config)# video
min-stream-switch-time 30
Casa Systems
22-34 RF Cable Configuration Guide and Command Reference
video module
video module
Purpose
The video module command edits the QAM_8x96 video module per the specified
chassis slot. Only QAM_8x96 (NGOD) modules are supported for this command.
Modes
(config)#
(conf-video-module <id>)#
Syntax
[no] video module <0:13>
(conf-video-module x)#
bandwidth-update-threshold <0:2147483647>
cost <0:255>
[no] d6-enable
[no] description “<text>”
[no] edge-name <name>
[no] erm <1:8>
[no] location “<state>.<city>.<loc_id>.<hub_name>”
[no] ngod control-source loopback <0:255> [port <1:65535>]
[no] shutdown
[no] streaming-zone <name>
Properties
Property name Description
Example:
Casa Systems
Video 22-35
video module
Properties (continued)
Property name Description
Example:
CASA(conf-video-module 10)#
bandwidth-update-threshold 0x70000000
Example:
Example:
Example:
Casa Systems
22-36 RF Cable Configuration Guide and Command Reference
video module
Properties (continued)
Property name Description
edge-name <name> Edge name (instance ID) for the module, three digits
identifying the edge devices in a location, maximum
50 characters.
Example:
Example:
Example:
Casa Systems
Video 22-37
video module
Properties (continued)
Property name Description
Example:
Example:
Example:
CASA(conf-video-module 10)#
streaming-zone SZNAME
CASA(conf-video-module 10)#
no streaming-zone
Casa Systems
22-38 RF Cable Configuration Guide and Command Reference
video module
video module 10
d6-enable
no shutdown
no erm
no streaming-zone
location MA.Andover.01810.HUB1
edge-name 001
description "This video module is in Andover"
cost 1
bandwidth-update-threshold 0
Casa Systems
Video 22-39
video multicast-session-loss-timeout
video multicast-session-loss-timeout
Purpose
Mode
(config)#
Syntax
video multicast-session-loss-timeout {<1:172800> | default}
Properties
Property name Description
Example:
CASA(config)# video
multicast-session-loss-timeout 30
Casa Systems
22-40 RF Cable Configuration Guide and Command Reference
video ngod
video ngod
Purpose
The video ngod command sets various Next Generation On Demand (NGOD)
properties involving control sources, R6 resource management attributes, and vendor
string parameters.
Mode
(config)#
Syntax
video ngod control-source bind
no video ngod control-source bind
video ngod r6-connection-timeout {<30:600> | default]
video ngod r6-control-source loopback <0:255>
no video ngod r6-control-source loopback
video ngod r6-listening-port {<1:65535> | default]
video ngod vendor-string <name>
no video ngod vendor-string
Properties
Property name Description
Example:
Example:
Casa Systems
Video 22-41
video ngod
Properties (continued)
Property name Description
Example:
Example:
Casa Systems
22-42 RF Cable Configuration Guide and Command Reference
video ngod
Properties (continued)
Property name Description
Example:
Casa Systems
Video 22-43
video pat-interval
video pat-interval
Purpose
The video pat-interval command defines the maximum time between adjacent
program association tables (PATs).
Mode
(config)#
Syntax
video pat-interval {<50:1000> | default}
Properties
Property name Description
Example:
Casa Systems
22-44 RF Cable Configuration Guide and Command Reference
video pid-remapping-mode
video pid-remapping-mode
Purpose
Mode
(config)#
Syntax
video pid-remapping-mode {auto [start-pid <16:7900>] | pg-num-based}
Casa Systems
Video 22-45
video pid-remapping-mode
Properties
Property name Description
{auto [start-pid <16:7900>] Sets the PID remapping mode to either automatic or
| pg-num-based} program-number-based, default auto. All elementary
PIDs from all input programs are multiplexed into the
same MPTS for a given QAM channel. The PIDs
must be unique for proper demultiplexing when the
MPTS reaches a QAM set-top box. For multiplexed
video QAM, there are two modes of operation:
Casa Systems
22-46 RF Cable Configuration Guide and Command Reference
video pktloss-window
video pktloss-window
Purpose
The video pktloss-window command sets the number of seconds to allow when
checking for loss of video packets.
Mode
(config)#
Syntax
video pktloss-window {<1:60> | default}
no video pktloss-window
Properties
Property name Description
Example:
Casa Systems
Video 22-47
video pme
video pme
Purpose
The video pme command sets the Privacy Mode Encryption (PME) properties. PME
is a proprietary protocol for video on demand (VOD) services that are widely
supported and implemented in North America. PME includes a conditional access
systems (CAS), edge QAMs, or Converged Cable Access Platform (CCAP)
equipment to provide program encryption to authorized subscribers. The C100G
CCAP provides full support for PME services, including software support for data
path, signaling and management. The encryption of the video stream is completed by
the C100G CCAP hardware.
Note that the separately described video pme install-certificate command is available
only in enable mode.
Mode
(config)#
Syntax
video pme contact <name>
no video pme contact
video pme device-id [2] <id> password [2] <pwd>
no video pme device-id
[no] video pme on
video pme proxy server <addr> [port <0:65535>]
no video pme proxy server
video pme proxy server keepalive <10:3600>
no video pme proxy server keepalive
video pme proxy server master [port <0:65535>]
no video pme proxy server master
video pme retry-time <1:1440>
no video pme retry-time
video pme source-interface loopback <0:255>
no video pme source-interface
video pme url <url>
no video pme url
Casa Systems
22-48 RF Cable Configuration Guide and Command Reference
video pme
Properties
Property name Description
contact <name> Contact email address for the PME device, as a text
string up to 64 characters. The configuration is
mapped to HTTP headers.
Example:
Example:
Example:
Casa Systems
Video 22-49
video pme
Properties (continued)
Property name Description
proxy server <addr> [port PME server IP address on the client side of the
<0:65535>] network. The specified IP address must be the
loopback IP. The default port is 50010. Ensure that
the port is unique to this application.
Example:
Example:
proxy server master [port PME proxy server to be the master server in the
<0:65535>] cluster. The default port is 50010; ensure that the
port is unique to this application.
Example:
Example:
Casa Systems
22-50 RF Cable Configuration Guide and Command Reference
video pme
Properties (continued)
Property name Description
Example:
url <url> URL of the ERS. Specify the URL as a text string of
up to 128 characters. The default URL is the
licensing ERS. Use the no form of the command to
revert to the current URL setting.
Example:
Casa Systems
Video 22-51
video pme
Proxy : On
Proxy mode : Server
device-id : pme
Shows filtered packet statistics (unicast, multicast, or both) from the active video
sessions. The rows argument sets the number of rows to show, with the starting and
ending row numbers, or shows the numerical count of the output rows.
Shows the file synchronization between the active and standby SMM.
Casa Systems
22-52 RF Cable Configuration Guide and Command Reference
video pme install-certificate
The video pme install-certificate command installs an existing ERS certificate. Use
the copy command to install the certificate file to NVRAM before issuing the video
pme install-certificate command to install the certificate in the system.
Modes
#
(diag)#
Syntax
# [no] video pme install-certificate
(diag)# no video pme install-certificate
Shows the current PME video configuration with the certificate uninstalled.
Casa Systems
Video 22-53
video pmt-interval
video pmt-interval
Purpose
The video pmt-interval command sets the maximum time between adjacent program
mapping tables (PMTs).
Mode
(config)#
Syntax
video pmt-interval {<50:10000> | default}
Properties
Property name Description
Example:
Casa Systems
22-54 RF Cable Configuration Guide and Command Reference
video power-key on
video power-key on
Purpose
CCAP PowerKey is a protocol for video encryption services that is widely supported
and implemented in North America. PowerKey systems include a video server (called
a “video pump”), Digital Network Control System/VOD System Resource Manager
(DNCS/VSRM), CCAP/QAMs, and management equipment to provide program
encryption to authorized subscribers.
Mode
(config)#
Syntax
video power-key on
no video power-key
Shows the video PowerKey settings, optionally for a specific session.The update and
setup periods are reported in milliseconds. The encrypt-data qualifier is available in
diagnostic mode only.
Casa Systems
Video 22-55
video power-key on
Override :No
Start Time :03/09/2016,14:32:36 UTC
ECM Update Period :100
CW Update Period :4000
CW Setup Period :450
CW update Counter :243
C10G-181#show video power-key session 1
Error: Length of session ID should be 20
Casa Systems
22-56 RF Cable Configuration Guide and Command Reference
video program-number pass-through
Mode
(config)#
Syntax
video program-number pass-through
no video program-number pass-through
Casa Systems
Video 22-57
video qam-domain
video qam-domain
Purpose
The video qam-domain command edits the QAM parameters for the Converged
Cable Access Platform (CCAP) device. A video QAM domain equates to a video
service group in deployment and the latter can be identified in the configuration.
Modes
(config)#
(conf-qam-domain <index>)#
Syntax
([no] video qam-domain <1:128>
(conf-qam-domain x)#
description “<text>”
no description
[no] edis <1:8>
[no] interface video <1:16>
qam-group <1:8> {<start_qam> <end_qam> | shared-channel <start_qam>
<end_qam>}
no qam-group <1:32>
video service group <0:4294967295>
no video service group
Properties
Property name Description
Example:
Casa Systems
22-58 RF Cable Configuration Guide and Command Reference
video qam-domain
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Video 22-59
video qam-domain
Properties (continued)
Property name Description
Example:
video service group A way of associating the QAM domain with a defined
<0:4294967295> video service group, default 0. Use the show video
session service-group <id> command to list the
video session IDs and QAM channels in the QAM
domain associated with the video service group.
Example:
Casa Systems
22-60 RF Cable Configuration Guide and Command Reference
video qam-domain
Casa Systems
Video 22-61
video qam-domain
Shows the current QAM groups in a particular QAM domain. The command is
available in the QAM domain context only.
Shows the related sessions and QAM channels in a particular video service group.
Casa Systems
22-62 RF Cable Configuration Guide and Command Reference
video qam export configuration slot
The video qam export configuration slot command sets the video QAM export
configuration slot to allow exporting the video topology into a vendor-specific format.
A file is generated for each EDIS assigned to a QAM domain on the selected modules
to the active SMM’s /tftpboot/ directory in the format edisip.slot.srmtype. Then copy
the file using TFTP to NVRAM, usually from the loopback interface.
The optional base value is the output port base in the config file, which should be
default base 0 for a Casa or Cisco System Resource Manager (SRM) QAM 8x96 or
QAM 8x192, or default base 1 for a BigBand QAM 8x96 or QAM 8x192.
Mode
#
Syntax
video qam export configuration slot <list> [base {0 | 1}] [filename
<file>} [in-service-state] [srm-num <1:8>]
Casa Systems
Video 22-63
video qam export configuration slot
Properties
Property name Description
<list> [base {0 | 1}] List of QAM slots, separated by commas (see the
[filename <file>} interface qam command). The base option indicates
[in-service-state] [srm-num the output port base type, either 0 for a Casa or Cisco
<1:8>] SRM, or 1 for a BigBand SRM. (Note that the base
setting is overwritten by the more general
video edis output-port-base <0 | 1> setting if not
base 0.)
Example:
Casa Systems
22-64 RF Cable Configuration Guide and Command Reference
video reserved-pid upper-limit
The video reserved-pid upper-limit command sets the upper limit of the range of
reserved packet IDs (PIDs) contained in video packets. Packets with reserved PIDs
should not appear in a Program Mapping Table (PMT) or video Program Association
Table (PAT), or they might be forwarded unconditionally without being processed,
causing the session to be stuck in the Initial state. PIDs 1–15 are the well-known
reserved PIDs (and the default upper limit), but other markets have other reserved PID
ranges, such as Digital Video Broadcasting (DVB) with PID ranges 16–31 reserved
for DVB metadata. Packets with reserved PIDs set in these ranges are either dropped
(with the video drop reserved-pids command) as they should, or passed through
(with the no video drop reserved-pids command).
Mode
(config)#
Syntax
video reserved-pid upper-limit <1:65535>
Properties
Property name Description
Example:
Casa Systems
Video 22-65
video session
video session
Purpose
The video session command adds a video session on a given QAM channel without
the presence of a Session Resource Manager (SRM) external signaling (EDIS) server.
The video session can be a data, multicast, or pass-through session, with only one
video session bound to a unicast stream. A pass-through session is a Multiple Program
Transport Stream (MPTS) broadcast video session over QAM 8x96 ports 0–7, where
one input MPTS can be output to one QAM multi-port shared channel. Configuring
QAM 8x96 for video broadcast requires configuring the multi-port shared channels on
the video, QAM, and QAM domain interfaces (see the “Broadcast video
configuration” section for details). There can be up to 96,000 Edge QAM sessions.
The video session initial-timeout command detects packet loss before a unicast or
multicast session timeout occurs. See also the no video sessions command.
Mode
(config)#
Syntax
video session <1:4294967295> data ip-address <dst_addr> qam-channels
<slot>/<port>/<chan> input-port <1:8> [bitrate <bps>]
[in-program-number <0:65535>] [pid-drop <pid_list>]
[pid-remapping] [src-ip <ip_addr> [<ip_addr>] [<ip_addr>]]
[udp-port <1:65535>]
video session <1:4294967295> data ip-address <dst_addr> qam-channels
shared-channel <slot>/<s_chan> input-port <1:8> [bitrate <bps>]
[in-program-number <0:65535>] [pid-drop <pid_list>]
[pid-remapping] [src-ip <ip_addr> [<ip_addr>] [<ip_addr>]]
[udp-port <1:65535>]
Casa Systems
22-66 RF Cable Configuration Guide and Command Reference
video session
Casa Systems
Video 22-67
video session
Properties
Property name Description
Example:
Casa Systems
22-68 RF Cable Configuration Guide and Command Reference
video session
Properties (continued)
Property name Description
Casa Systems
Video 22-69
video session
Properties (continued)
Property name Description
Casa Systems
22-70 RF Cable Configuration Guide and Command Reference
video session
Properties (continued)
Property name Description
Casa Systems
Video 22-71
video session
Properties (continued)
Property name Description
Example:
Example:
Example:
Example:
Casa Systems
22-72 RF Cable Configuration Guide and Command Reference
Broadcast video configuration
Properties (continued)
Property name Description
Example:
Example:
Example:
Casa Systems
Video 22-73
Broadcast video configuration
2. Configure the broadcast video configuration using the video session <identifier>
pass-through command.
Once a shared channel on one of the QAM 8x96 ports is created, this channel can then
be shared across one or more ports (up to seven additional) on the same module.
The following CLI session configures the shared channels on port 0 and shares them
with port 1 using the following steps.
1. Configure the number of narrowcast channels on module 0 and module 1.
2. Configure the shared channel identifier on the first module and number of
channels to be shared, then configure the second and any subsequent ports using
the same shared channel identifier. Execute a no shared-channel shutdown
command for each interface.
3. Execute the show module <slot> shared-channel mapping command to verify
the configuration.
Example
CASA(config)# module 0 narrowcast-channels 32
CASA(config)# module 1 narrowcast-channels 32
CASA(config)# show narrowcast-channels
module 0 narrowcast-channels 32
module 1 narrowcast-channels 32
Casa Systems
22-74 RF Cable Configuration Guide and Command Reference
Broadcast video configuration
0 37 5 753000000 0 37 255 ff 3 13 up
0 38 6 759000000 0 38 255 ff 3 14 up
0 39 7 765000000 0 39 255 ff 3 15 up
0 40 8 771000000 0 40 255 ff 3 16 up
0 41 9 777000000 0 41 255 ff 3 17 up
0 42 10 783000000 0 42 255 ff 3 18 up
0 43 11 789000000 0 43 255 ff 3 19 up
4. Add multi-port shared channels to the video QAM domain and QAM group. The
qam-group command in the video qam-domain configuration supports the range
of narrowcast and multi-port shared channels.
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group <id> shared-channel <first>
<last>
where id is the QAM group ID in the range 1–8, and first and last are the first and
last QAM channels in the block of multi-port shared channels.
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group 2 shared-channel 0/0 0/11
Create a video pass-through session on one QAM 8x96 module, then repeat the
command for additional QAM 8x96 modules. In the following example, the MPTS
broadcast video stream is being configured on slot/channel 0/0 and 1/0 (system slots 0
Casa Systems
Video 22-75
Broadcast video configuration
and 1, channel 0). In the example, the MPTS is destined for the multicast group
address at IP 227.0.0.0 on the system QAM modules in slots 0 and 1, where 0/0 is the
slot/channel in module slot 0, and 1/0 is the slot/channel in module slot 1. The video
source IP address for the MPTS is 17.56.102.2.
Example
CASA(config)# video session 1 pass-through ip-address 227.0.0.0
qam-channels shared-channel 0/0 src-ip 17.56.102.2
Example
CASA(config)# vrf definition VRF1
CASA(config-vrf)# end
Casa Systems
22-76 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows summary information for a particular video session. The ID must be the full
20-character hex value. Use the clear video session-parameters command to clear
the session statistics.
Input Stream:
Uptime : 0 days 01:56:27
Data State : On
Packets Detected : Yes
PSI Detected : Yes
Bitrate Requested : 9081000 bps
Bitrate Detected Avg: 9080000 bps
Bitrate Detected Max: 9108000 bps
Jitter Detected Avg : 2 ms
Jitter Detected Max : 25 ms
Stream Type : SPTS
SSM Address : 192.168.3.131(*)
Destination IP Addr : 199.175.2.1
Destination UDP Port: 1025
PIDs to be dropped :
Input Port : xgige 6/5
Casa Systems
Video 22-77
Related show command examples
IP Packets in : 6415723
TP Packets in : 42087081
TS Packets in : 41982972
PcrPackets : 972505 NonPcrPackets : 41114576
UnexpectedPackets : 559
ContinuityErrors : 0 SyncLossPackets : 0
PcrIntervalExceeds : 19
Shows brief information for all current video sessions, including session creation
parameters and uptime. The rows argument sets the number of rows to show, with the
starting and (optional) ending row numbers. With the <end> number omitted, the
output shows the starting row through the remaining rows. Bit rate statistics are also
shown.
Casa Systems
22-78 RF Cable Configuration Guide and Command Reference
Related show command examples
Shows the video service group information for the current video session.
Shows filtered packet statistics (unicast, multicast, or both) from the active video
sessions. The rows argument sets the number of rows to show, with the starting and
(optional) ending row numbers, or shows just the numerical count of the rows. With
the <end> number omitted, the output shows the starting row through the remaining
rows.
Casa Systems
Video 22-79
video signaling-mode
video signaling-mode
Purpose
The video signaling-mode command has been obsoleted in favor of setting Edge
Device Interface Specification (EDIS) or Next Generation on Demand (NGOD)
signaling, or both, using the video edis command for EDIS or the video module
command for NGOD. The video signaling-mode command returns a message to that
effect.
Mode
(config)#
Syntax
video signaling-mode {edis | ngod}
Properties
Property name Description
Example:
Casa Systems
22-80 RF Cable Configuration Guide and Command Reference
video simulcrypt
video simulcrypt
Purpose
QAM 8x96 with the DVB FPGA allows for 16 SimulCrypt channels. If there up to
eight DVB channels, they can be in the 40–47 numbered range. With more than eight
DVB channels, eight of them can be in the 32–39 range with the balance going into
the 40–47 range, with the remaining channels in that range as non-DVB. QAM 8x192
allows for 24 SimulCrypt channels numbered 40–63 of the possible 64 narrowcast
channels, with an additional 128 shared channels that can be up to 16 narrowcast per
port or 64 multiport shared. (The numbers are slightly different if Orthogonal
Frequency Division Multiplexing channels are in effect.)
Casa Systems
Video 22-81
video simulcrypt
Modes
(config)#
(config-ecmg <name>)#
Syntax
(config)#
video simulcrypt cp <10:6000>
video simulcrypt ecm-channel-id start <1:65535> end <1:65535>
no video simulcrypt cp
[no] video simulcrypt ecmg {<name> | load-balancing | vrf <id>}
(config-ecmg x)#
access-criteria <hex_string>
domain-name <ip_addr>
ip-address <ip_addr>
priority <1:8>
protocol-version <2:3>
subsystem-id <0:65535>
system-id <1:65535>
tcp-port <1:65535>
(config)#
video simulcrypt ecmg-retries <1:5>
no video simulcrypt ecmg-retries
video simulcrypt ecmg-timeout <1:60>
no video simulcrypt ecmg-timeout
video simulcrypt eis {tcp-port <1024:65535> | vrf <id>}
no video simulcrypt eis tcp-port
video simulcrypt session-mode
[no] video simulcrypt source-interface loopback <0:255>
video simulcrypt tier-mode
video simulcrypt version {1 | 2}
no video simulcrypt version
Casa Systems
22-82 RF Cable Configuration Guide and Command Reference
video simulcrypt
Properties
Property name Description
Example:
Example:
Casa Systems
Video 22-83
video simulcrypt
Properties (continued)
Property name Description
Example:
access-criteria Sets the access criteria for the ECMG, which applies
<hex_string> only to SimulCrypt tier-mode encryption and has no
effect in session-mode encryption. The hex string
should omit the 0x prefix, such as 0123, which
requires the leading 0 and is maximum length 1024.
Example:
CASA(config-ecmg E1)#
access-criteria 0123
Example:
CASA(config-ecmg E1)#
domain-name casa.test.com
Casa Systems
22-84 RF Cable Configuration Guide and Command Reference
video simulcrypt
Properties (continued)
Property name Description
Example:
CASA(config-ecmg E1)#
ip-address 192.168.8.8
Example:
Example:
CASA(config-ecmg E1)#
protocol-version 2
Example:
Example:
Casa Systems
Video 22-85
video simulcrypt
Properties (continued)
Property name Description
tcp-port <1:65535> TCP port for ECMG, which cannot be one of the
well-known ports.
Example:
ecmg-retries <1:5> Sets the retry time for ECMG communication. Use
the no form of the command to revert to the default
3 retries.
Example:
Example:
Casa Systems
22-86 RF Cable Configuration Guide and Command Reference
video simulcrypt
Properties (continued)
Property name Description
eis {tcp-port <1024:65535> Sets the TCP port or VRF ID for communication
| vrf <id>} between the SimulCrypt Synchronizer (SCS) and the
Event Information Scheduler (EIS). The configuration
applies only to session-mode encryption. The
configuration cannot use the well-known ports in the
range used by other applications. For example,
PCMM port 3918 and IPDR port 4737 cannot be
used.
Example:
Example:
Example:
Casa Systems
Video 22-87
video simulcrypt
Properties (continued)
Property name Description
Example:
Example:
Shows the start numbering of the DVB SimulCrypt channels for each QAM module.
Casa Systems
22-88 RF Cable Configuration Guide and Command Reference
video simulcrypt
Shows the Entitlement Control Message Generator (ECMG) configuration. Note that
the CP remaining time shows as N/A for session-mode SimulCrypt.
ECMG EEEE:
System Id : 18981
Subsystem Id : 0
IP Address : 172.16.8.199
TCP Port : 22288
Priority : 1
Protocol Version : 3
Access-criteria : N/A
ECMG Uptime : 0 d : 0 h : 11 m : 37 s
Connection Status : Connected
Channel Status : Open
ECM channel ID : 254
Stream Information:
Stream ID Stream ECM ID CP number Status
--------- ------------- --------- ------------
1 1 12 Open
Shows the Scrambling Control Group (SCG) configuration (unless not found) along
with the Entitlement Control Message (ECM) information. An SCG gathers together
in one logical set the list of streams scrambled at the same time with the same control
word and the list of ECMs generated with the identifier of their Conditional Access
(CA) system and with their respective access criteria. Up to 1000 SCGs are supported.
Casa Systems
Video 22-89
video stream-proc reset
The video stream-proc reset command resets the QAM video stream program clock
reference (PCR) processing or program mapping table (PMT) rebuild. With multiple
sets of PCRs in an input stream, one optimal PCR (PID) set is chosen as the reference.
NULL packets are forwarded to egress to maintain the scheduling parameters to
prevent triggering of drift correction. For SimulCrypt tier-mode encryption, the QAM
daemon rebuilds the PMT using global data, whereas in session-mode encryption the
PMT is built per stream.
Mode
(diag)#
Syntax
video stream-proc reset {pcr | pmt} ip-address <ip_addr> udp-port
<1:65535> [src-ip <ip_addr>]
Properties
Property name Description
Casa Systems
22-90 RF Cable Configuration Guide and Command Reference
video stream-switch
video stream-switch
Purpose
The video stream-switch command sets the transport rate or video bit rate thresholds
to signal stream-switching. The video switches streams at the transport-rate or
video-bitrate threshold. Use the show video global config command to see the
configuration settings.
Mode
(config)#
Syntax
video stream-switch <1:60> | default
Properties
Property name Description
transport-rate <1:5000> Sets the transport rate threshold, in kb/s, at which the
video switches streams.
Example:
video-bitrate <1:5000> Sets the video bitrate threshold, in kb/s, at which the
video switches streams.
Example:
Casa Systems
Video 22-91
video table
video table
Purpose
The video table command sets the system-wide Video On Demand (VOD) table
mode. Unlike external mode, table mode VOD does not require any EDIS signaling.
The eQAM simply parses the destination UDP port of the incoming unicast
single-program transport stream (SPTS) to decide what QAM channel and program
number to use. Table mode cannot be used over multi-port shared channels. The
eQAM can be configured to operate in one of seven table modes, plus a custom mode:
• mode0 — The two-byte UDP port is masked as 0qqqqqqq qqqppppp, where the
seven least significant bits (LSBs) of the upper byte and the three most significant
bits (MSBs) of the lower byte are combined to form the zero-based QAM channel
number on a given line card slot, and where ppppp is the 1-based program number
in the QAM channel. In this mode, an IP address can cover 1024 QAM channels,
and each QAM channel can have 63 programs.
• mode1 — The two-byte UDP port is preceded by the number 1 to protect the
known UDP port space, as 1qqqqqqq qqqppppp. In this mode, an IP address can
cover 1024 QAM channels, and each QAM channel can have 31 programs. This
leaves the lower 32K ports unused for video, as many of the UDP ports are
reserved for well-known UDP ports.
• mode2 — Only the mask is different: 1qqqqqqq qqqpppp0. In this mode, an IP
address can cover 1024 QAM channels, and each QAM channel can have 15
programs.
• mode3 — The applied mask is qqqqqqqq pppppppp. In this mode, an IP address
can cover 256 QAM channels, and each QAM channel can have 255 programs.
• mode4 — Identical to mode3 except that it uses 1-based instead of 0-based QAM
channel numbers.
• mode5 — In this mode, at most 16 channels per port are exported by the D6
interface. The UDP port mapping is 100qqqqq qqpppppp. If
video channel-id-offset is not configured, the channel used for mode5 ranges
from x/y/0 through x/y/7. If the offset is configured, the channel ranges from
x/y/offset through x/y/offset+7.
• mode6 — Similar to mode3 except the UDP port mapping is 00qqqqqq
pppppppp, with maximum eight channels.
Casa Systems
22-92 RF Cable Configuration Guide and Command Reference
video table
• custom — Sets special mapping properties for a custom video table mode.
Mode
(config)#
Syntax
video table {mode0 | mode1 | mode2 | mode3 | mode4 | mode5 | mode6}
video table custom prog-per-chan <32|64|256> chan-per-port <1:32>
[skip-chan <0:12>] [start-udp-offset <1:65535>]
no video table
Properties
Property name Description
{mode0 | mode1 | mode2 | Sets the system-wide VOD table mode to mode0
mode3 | mode4 | mode5 | (qqqqqqqq qqqppppp), mode1 (1qqqqqqq
mode6} qqqppppp), mode2 (1qqqqqqq qqqpppp0), mode3
(qqqqqqqq pppppppp), mode4 (identical to mode3,
except that it uses 1-based QAM channel numbers),
mode5 (1000qqqq qqpppppp), or mode6 (00qqqqqq
pppppppp). If omitted, sessions are exclusively
managed by the SRM. Both table mode and SRM
mode can coexist.
Example:
Casa Systems
Video 22-93
video table
Properties (continued)
Property name Description
Example:
Casa Systems
22-94 RF Cable Configuration Guide and Command Reference
video unicast-session-loss-timeout
video unicast-session-loss-timeout
Purpose
Mode
(config)#
Syntax
video unicast-session-loss-timeout {<1:172800> | default}
Properties
Property name Description
Example:
CASA(config)# video
unicast-session-loss-timeout 60
Casa Systems
Video 22-95
Related show command examples
Casa Systems
22-96 RF Cable Configuration Guide and Command Reference
no video sessions
no video sessions
Purpose
The no video sessions command removes video sessions based on a session index,
channel, port, or shared channel.
Mode
#
Syntax
no video sessions <1:9999>
no video sessions channel <slot>/<port>/<chan>
no video sessions port <slot>/<port>
no video sessions shared-channel <slot>/<s_chan>
Properties
Property name Description
Example:
Example:
Casa Systems
Video 22-97
no video sessions
Properties (continued)
Property name Description
Casa Systems
100 Old River Road
Andover, MA 01810
USA
978-688-6706
DOC-3022-01