Troubleshooting Tips for the
Cisco uBR904 Cable Modem
The following sections are provided:
• Feature Summary on page 1
• Platforms on pag e 3
• Supp orted MIBs and RFCs on page 3
• CMTS to Cable Mod em Network Topology on page 4
• Troubleshooting Steps on page 5
• Co mmand Reference on page 16
• Debug Commands on page 49
• What to do Next on page 61
Feature Summary
This document describes the set of Cisco IOS troubleshooting commands that may be used by
multiple service operators (MSOs) to verify communication between a Cisco uBR904 cable modem
and other peripheral devices installed in the HFC network such as the headend Cisco uBR7246
router, a DHCP server, and a TFTP server.
Note For an explanation of error messages displayed by the uBR904, see Cisco Cable CPE Error
The uBR904 troubleshooting system provides the following benefits:
• A MAC-layer system log file exists which provides a snapshot of detailed reasons why an
interface might reset, along with all the negotiations that occurred between the uBR904 cable
modem and the CMTS (a Cisco uBR7246 positioned at the headend). Over 220 possible
description fields exist in this log, which is displayed using the show controllers cable-modem 0 mac log command from privileged EXEC mode.
• Debug does not need to be turned on to troubleshoot a uBR904 cable modem.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 1
Page 2
Feature Summary
• The progressi on of norm al data-over-cable communication events is clearly explained,
• A cable technician can remotely telnet into a Cisco uBR904 cable modem, which could be
List of Terms
CATV—Originally stood for Community Antenna Television. Now refers to any coaxial or fiber
cable-based system that provides television services.
Cable modem (CM)—Any device that modulates and demodulates digital data onto a CA TV plant.
Cable router—A modular chassis-based router optimized for data-over-CATV hybrid fiber-coaxial
(HFC) applications.
Channel—A specific frequency allocation and bandwidth. Downstream channels used for television
in the United States are 6 MHz wide.
CM—Cable modem.
CMTS—Cable Modem Termination System. Any DOCSIS-compliant headend cable router, such
as the Cisco uBR7246.
simplifying the resolution of faulty system connections.
installed in a customer’s home, and perform simple diagnostic tasks.
DHCP—Dynamic Host Configuration Protocol. This protocol provides a mechanism for allocating
IP addresses dynamically so that addresses can be reused when hosts no longer need them.
DOCSIS—Data Over Cable Service Interface Specification. Defines technical specifications for
equipment at both subscriber locations and cable operators’ headends.
Downstream—The set of frequencies used to send data from a headend to a subscriber.
Headend—Central distribution point for a CATV system. Video signals are received here from
satellite (either co-located or remote), frequency converted to the appropriate channels, combined
with locally originated signals, and rebroadcast onto the HFC plant. For a CATV data system, the
headend is the typical place to create a link between the HFC system and any external data networks.
HFC—Hybrid fiber-coaxial (cable network). Older CATV systems were provisioned using only
coaxial cable. Modern systems use fiber transport from the headend to an optical node located in the
neighborhood to reduce system noise. Coaxial cable runs from the node to the subscriber. The fiber
plant is generally a star configuration with all optical node fibers terminating at a headend. The
coaxial cable part of the system is generally a trunk-and-branch configuration.
Host—Any end-user computer system that connects to a network. In this document, the term host
refers to the computer system connected to the LAN interface of the cable modem.
MAC layer—Media Access Control sublayer. Controls access by the cable modem to the CMTS
and to the upstream data slots.
MCNS—Multimedia Cable Network System Partners Ltd. A consortium of cable companies
providing service to the majority of homes in the United States and Canada. This consortium has
decided to drive a standard with the goal of having interoperable cable modems.
MSO—Multiple Service Operator. A cable service provider that also provides other services such
as data and/or voice telephony.
QAM—Quadrature Amplitude Modulation. A method of modulating digital signals onto a
radio-frequency carrier signal involving both amplitude and phase coding. QAM is a modulation
scheme mostly used in the downstream direction (QAM-64, QAM-256). QAM-16 is expected to be
Cisco IOS Release 12.0(3)T
2
Page 3
Platforms
List of Terms
usable in the upstream direction. Numbers indicate number of code points per symbol. The QAM
rate or the number of points in the QAM constellation can be computed by 2 raised to the power of
<number of bits/symbol>.
QPSK—Quadrature Phase-Shift Keying. A method of modulating digital signals onto a
radio-frequency carrier signal using four phase states to code two digital bits.
Ranging—The process of acquiring the correct timing offset such that the transmissions of a cable
modem are aligned with the correct mini-slot boundary.
SID (Service ID)—A number that defines (at the MAC sublayer) a particular mapping between a
cable modem (CM) and the CMTS. The SID is used for the purpose of upstream bandwidth
allocation and class-of-service management.
Subscriber Unit (SU)—An alternate term for cable modem. See cable modem.
Upstream—The set of frequencies used to send data from a subscriber to the headend.
The uBR904 cable modem is a standalone device; it works in conjunction with the Cisco uBR7246
universal broadband router.
Prerequisites
See the companion to this document, “Bridging and Routing F eatures for the Cisco uBR904 Cable Modem”
for information regarding prerequisites.
Supported MIBs and RFCs
See the companion to this document, “Bridging and Routing F eatures for the Cisco uBR904 Cable Modem”
for information regarding supported MIBs and RFCs.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 3
Page 4
CMTS to Cable Modem Network Topology
CMTS to Cable Modem Network Topology
Figure 1 shows the physical relationship between the devices in the HFC network and the cable
modem.
Figure 1Sample Topology
Proxy server
Analog TV
Digital TV
100BT
Cisco
uBR7246
CMTS
ISP
WAN
ATM, FDDI, 100BT...
100BT
100BT
100BT
Upconvertor
DS-RF 54-860 Mhz
Fiber
Transceiver
IP-related
ISP @ home...
MSD: Maintenance Service
Organization, Cable companies
Fiber node
(Telephone pole,
underground box)
Cisco IOS Release 12.0(3)T
4
80 km
Distribution
amplifier
1000 ft
Top
amplifier
Drop box
13304
Cisco u BR904
cable modem
Page 5
Step 1—Understand How Basic Initialization Works
Troubleshooting Steps
To troubleshoot a malfunctioning cable modem, perform the following tasks:
• S tep 1— Understand How Basic Initialization Works
• Step 2—Connect to the Cable Modem
• Step 3— Display the Cable Modem’s MAC Log File
• S tep 4— Interpret the MAC Log File and Take Action
Before you troubleshoot a Cisco uBR904 cable modem, you should be familiar with the cable
modem initialization process. See Figure 2 and Table 1. Understanding this flowchart and sequence
of events will help you determine where and why connections fail.
The sequence numbers shown in Figure 2 are explained in Table 1, which appears after the
illustration. The cable modem will complete all the steps in this flowchart each time it needs to
reestablish ranging and registration with the CMTS.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 5
Page 6
Troubleshooting Steps
0
1
Figure 2Cable Modem Initialization Flowchart
Power
on
Scan for
1
2
3
4
downstream
channel
Downstream
sync
established
Obtain
upstream
parameters
Upstream
parameter
acquired
Start
Ranging
Ranging and
auto adjust
completed
Establish
IP
connectivety
Establish
security
Security
established
Transfer
operational
parameters
Transfer
complete
Register with
the Cisco
uBR7246
Registration
complete
Baseline
privacy
initialization
6
7
8
9
complete
Establish
5
Cisco IOS Release 12.0(3)T
6
time of
Time of day
established
IP
day
Baseline
privacy
initialized
Operational
1
2960
Page 7
Step 2—Connect to the Cable Modem
.
Table 1Cable Modem Initialization Sequences and Events
SequenceEventDescription
1Scan for a downstream channel and
establish synchronization with the
headend Cisco uBR7246.
2Obtain upsteam channel parameters. The cable modem waits for an upstream channel descriptor
3Start ranging for power adjustments. The ranging process adjusts the cable modem’s transmit
4Establish IP connectivity.The cable modem invokes DHCP requests to obtain an IP
5Establish the time of day.The cable modem accesses the TOD server for the current date
6Establish security.Keys for privacy are exchanged between the cable modem and
7Transfer operational parameters.After the DHCP and security operations are successful, the
8Perform registration.The cable modem registers with the headend Cisco uBR7246.
9Comply with baseline privacy.Link level encryption keys are exchanged between the
10Enter the operational maintenance
state.
The cable modem acquires a downstream channel from the
headend, saves the last operational frequency in non-volatile
memory, and tries to reacquire the saved downstream channel
the next time a request is made.
An ideal downstream signal is one that synchronizes QAM
symbol timing, FEC framing, MPEG packetization, and
recognizes downstream sync MAC layer messages.
(UCD) message from the headend Cisco uBR7246. This is
done to retrieve transmission parameters for the upstream
channel.
power. The cable modem performs ranging in two stages:
ranging state 1 and ranging state 2.
address, which is needed for IP connectivity. The DHCP
request also includes the name of a file that contains additio nal
configuration parameters, the TFTP server’s address, and the
Time of Day (TOD) server’s address.
and time, which is used to create time stamps for logged events
(such as those displayed in the MAC log file).
the headend Cisco uBR7246.
cable modem downloads operational parameters from a
configuration file stored on the cable company’s TFTP server.
The cable modem is authorized to forw ard traff ic into the cable
network after the cable modem is initialized, authenticated,
and configured.
Note The Cisco uBR904 cable modem supports baseline
privacy in Cisco IOS Release 11.3(5)NA and later , and in Cisco
IOS Release 12.0(2)XC and later.
headend and the cable modem.
As soon as the cable modem has successfully completed the
above sequence, it enters operational maintenance state.
Step 2—Connect to the Cable Modem
Telnet to the IP address assigned to the cable interface or Ethernet interface. If the interface is not
up, you need to access the Cisco IOS software via the RJ-45 console port, which is a physical port
on the back of the cable modem.
Because the MAC log file only holds a snapshot of 1023 entries at a time, you should try to display
the cable modem’s log file within 5 minutes after the reset or problem occurs.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 7
Page 8
Troubleshooting Steps
Step 3—Display the Cable Modem’s MAC Log File
A MAC-layer circular log file is stored inside the cable modem. This file contains the most valuable
information for troubleshooting the cable interface: a history of the log messages such as state e vent
activities and timestamps.
The MAC log file is displayed by entering the show controllers cable-modem 0 mac log command
from privileged EXEC mode.
The most useful display fields in this log file are the reported state changes. These fields are preceded
by the message
through the various processes involved in estab lishi ng communication and registration with the
CMTS. The
is the normal state when the interface is shut down.
The following is the normal progression of states as displayed by the MAC log:
CMAC_LOG_STATE_CHANGE. These fields show how the cable modem progresses
maintenance_state is the normal operational state, and the wait_for_link_up_state
Note To translate this outp ut int o more meaningful information, see “Step 4—Interpret the MAC
Log File and Take Action” on page 10.
Following is an example of what the MAC log file looks like when the cable modem interface
successfully comes up and registers with the CMTS. The output you see is directly related to the
messages that are exchanged between the cable modem and the headend Cisco uBR7246.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 9
Page 10
Troubleshooting Steps
You can display other aspects of the MAC layer by using variations of the show controllers
cable-modem 0 mac command:
uBR904# show controllers cable-modem 0 mac ?
errors Mac Error Log data
hardware All CM Mac Hardware registers
log Mac log data
resets Resets of the MAC
state Current MAC state
For examples and descriptions of how to use these keywords, see the show controllers
cable-modem mac command reference page.
Step 4—Interpret the MAC Log File and Take Action
The MAC log file giv es a detailed history of initialization events that occurred in the cable modem.
All pertinent troubleshooting information is stored here.
The following sample log file is broken down into the chronological sequence of events listed belo w .
Sample comments are also included in the log file.
• Event 1—Wait for the Link to Come Up
• Event 2—Scan for a Downstream Channel, then Synchronize
• Event 3—Obtain Upstream Parameters
• Event 4—Start Ranging for Power Adjustments
• Event 5—Establi sh IP Connectivity
• Event 6—Establish the Time of Day
• Event 7—Establish Security
• Event 8—Transfer Operational Parameters
• Event 9—Perform Registration
• Event 10—Comply wit h Basel ine Privacy
• Event 11—Enter the Maintenance State
Event 1—Wait for the Link to Come Up
The MAC layer informs the cable modem’s drivers that it needs to reset. This is the first event that
happens after the modem powers up and begins initialization. The fields
similar to the shut and no shut conditions on a standard Cisco interface.
Event 2—Scan for a Downstream Channel, then Synchronize
Different geographical regions and different cable plants use different frequency bands. The
Cisco uBR904 cable modem uses a built-in default frequency scanning feature to address this issue.
After the cable modem finds a successful downstream frequency channel, it saves the channel to
NVRAM. The cable modem recalls this value the next time it needs to synchron ize its freq uency.
The field
will scan for. The field
CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND tells you what frequency the cable modem
CMAC_LOG_WILL_SEARCH_SAVED_DS_FREQUENCY tells you the frequency the
cable modem locked onto and saved to NVRAM for future recall. The field
CMAC_LOG_DS_64QAM_LOCK_ACQUIRED communicates the same information. The field
CMAC_LOG_DS_CHANNEL_SCAN_COMPLETED indicates that the scanning and synchronization was
A frequency band is a group of adjacent channels. These bands are numbered from 88 to 99. Each
band has starting and ending digital carrier frequencies and a 6 MHz step size. For example, a search
of EIA channels 95-97 is specified using band 89. The starting frequency is 93 MHz, the ending
frequency is 105 MHz.
The cable modem’s default frequency bands correspond to the North American EIA CATV channel
plan for 6 MHz channel slots between 90 MHz and 858 MHz. For example, EIA channel 95 occupies
the slot 90-96 MHz. The digital carrier frequency is specified as the center frequency of 93 MHz.
Channel 95 is usually specified using the analog video carrier frequency of 91.25 MHz, which lies
1.75 MHz below the center of the slot.
The search table is arranged so that the first frequencies tried are above 450 MHz. Because many
CATV systems have been upgraded from 450 MHz to 750 MHz coaxial cable, digital channels have
a high chance of being assigned in the new spectrum. The search table omits channels below 90 MHz
and above 860 MHz since the DOCSIS specification does not mandate their coverage.
Some CATV systems use alternative frequency plans such as the IRC (Incrementally Related
Carrier) and HRC (Harmonically Related Carrier) plans. Most of the IRC channel slots overlap the
EIA plan. The HRC plan is not supported by Cisco’s cable modems since so few cable plants are
using this plan.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 11
Page 12
Troubleshooting Steps
Event 3—Obtain Upstream Parameters
The cable modem waits for an upstream channel descriptor (UCD) message from the headend
Cisco uBR7246. This is done to retrieve transmission parameters for the upstream channel.
508146.124 CMAC_LOG_STATE_CHANGE wait_ucd_state
508147.554 CMAC_LOG_UCD_MSG_RCVD 3
508147.558 CMAC_LOG_UCD_NEW_US_FREQUENCY 20000000
508147.558 CMAC_LOG_SLOT_SIZE_CHANGED 8
508147.622 CMAC_LOG_FOUND_US_CHANNEL 1
508147.624 CMAC_LOG_STATE_CHANGE wait_map_state
508148.058 CMAC_LOG_MAP_MSG_RCVD
508148.060 CMAC_LOG_INITIAL_RANGING_MINISLOTS 40
Event 4—Start Ranging for Power Adjustments
The ranging process adjusts the cable modem’s transmit power . The cable modem performs ranging
in two stages: ranging state 1 and ranging state 2.
The field
modem to adjust to. The field
CMAC_LOG_POWER_LEVEL_IS is the power level that the Cisco uBR7246 told the cable
CMAC_LOG_RANGING_SUCCESS indicates that the ranging adjustment was
After ranging is complete, the cable interface on the cable modem is UP. Now the cable modem
accesses a remote DHCP server to get an IP address. The DHCP request also includes the name of
a file that contains additional configuration parameters, the TFTP server’s address and the Time of
Day (TOD) server’s address.
The field
server to the cable modem interface. The field
TFTP server’s address. The field
server’s address. The field
transmission parameters. The field
CMAC_LOG_DHCP_ASSIGNED_IP_ADDRESS indicates the IP address assigned from the DHCP
CMAC_LOG_DHCP_TFTP_SERVER_ADDRESS marks the
CMAC_LOG_DHCP_TOD_SERVER_ADDRESS indicates the time of day
CMAC_LOG_DHCP_CONFIG_FILE_NAME shows the filename containing the
CMAC_LOG_DHCP_COMPLETE shows that the IP connectivity was
The Cisco uBR904 cable modem accesses the Time of Day server for the current date and time,
which is used to create time stamps for logged events. The f ield
a successful time of day sequence.
The cable modem establishes a security association. The security_association_state is normally
bypassed since “full security” as defined by the MCNS DOCSIS is not supported.
Note “Full security” was a request made by MSOs for a very strong authorization and
authentication check by the CMTS. This request has not been granted by cable modem
manufacturers. The Cisco uBR904 fully supports baseline privacy, which protects user’s data from
being “sniffed” on the cable network.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 13
Page 14
Troubleshooting Steps
Event 8—Transfer Operational Parameters
After the DHCP and security operations are successful, the cable modem downloads operational
parameters from the cable company’s TFTP server. These parameters are transferred via a
configuration file. The field
CMAC_LOG_DHCP_CONFIG_FILE_NAME shows the filename containing the
The cable modem registers with the headend Cisco uBR7246. After the cable modem is initialized,
authenticated, and configured, the cable modem is authorized to forward traffic into the cable
network. A successful registration is indicated by the field
Keys for baseline priv acy are exchanged between the cable modem and the headend Cisco uBR7246.
During this event, a link level encryption is performed so that a user’s data cannot be “sniffed” by
anyone else who is on the cable network.
Following is a trace that shows baseline privacy enabled. The key management protocol is
responsible for exchanging two types of keys: KEKs and TEKs. The KEK (key exchange key, also
referred to as the authorization key) is used by the headend CMTS to encrypt the TEKs (traffic
encryption keys) it sends to the cable modem. The TEKs are used to encrypt/decrypt the data. There
is a TEK for each SID configured to use privacy.
851.094 CMAC_LOG_PRIVACY_FSM_STATE_CHANGE machine: KEK, event/state:
EVENT_1_PROVISIONED/STATE_A_START, new state: STATE_B_AUTH_WAIT
851.102 CMAC_LOG_BPKM_REQ_TRANSMITTED
851.116 CMAC_LOG_BPKM_RSP_MSG_RCVD
851.120 CMAC_LOG_PRIVACY_FSM_STATE_CHANGE machine: KEK, event/state:
EVENT_3_AUTH_REPLY/STATE_B_AUTH_WAIT, new state: STATE_C_AUTHORIZED
856.208 CMAC_LOG_PRIVACY_FSM_STATE_CHANGE machine: TEK, event/state:
EVENT_2_AUTHORIZED/STATE_A_START, new state: STATE_B_OP_WAIT
856.220 CMAC_LOG_BPKM_REQ_TRANSMITTED
856.224 CMAC_LOG_BPKM_RSP_MSG_RCVD
856.230 CMAC_LOG_PRIVACY_FSM_STATE_CHANGE machine: TEK, event/state:
EVENT_8_KEY_REPLY/STATE_B_OP_WAIT, new state: STATE_D_OPERATIONAL
856.326 CMAC_LOG_PRIVACY_INSTALLED_KEY_FOR_SID 2
856.330 CMAC_LOG_PRIVACY_ESTABLISHED
Note In order for baseline privacy to work, you must use code image names containing the
characters “k1” on both the uBR904 (the subscriber end) and the uBR7246 (the headend). In
addition, privacy must be turned on in the configuration file that is downloaded to the uBR904.
Cisco IOS Release 12.0(3)T
14
Page 15
Step 5—Use Additional Troubleshooting Commands
Event 11—Enter the Maintenance State
As soon as the cable modem has successfully completed the above events, it enters the operational
maintenance state.
You can use other show controllers and debug cable modem commands to troubleshoot different
aspects of a cable modem. However, the most useful command is the show controllers cable-modem 0 mac command.
To display additional controller information inside a cable modem, enter one or more of the
following commands in privileged EXEC mode:
CommandPurpose
show controllers cable-modemDisplays high-level controller information.
show controllers cable-modem bpkmDisplays privacy state information.
show controllers cable-modem desDisplays information about the Data Encryption
Standard (DES) engine registers.
show controllers cable-modem filtersDisplays information about the MAC and SID cable
modem filters.
show controllers cable-modem lookup-tableDisplays the cable modem’s internal mini-slot lookup
table.
show controllers cable-modem mac
log | resets | state]
show controllers cable-modem phyDisplays physical-layer information such as recei ve and
show controllers cable-modem tunerDisplays tuning information.
show interface cable-modemDisplays information about the cable modem interface.
[errors | hardware |
Displays detailed MAC-layer information.
transmit physical registers.
T o deb ug dif ferent components of a cable modem, enter one or more of the following commands in
privileged EXEC mode:
{log [verbose] | messages}Displays and debugs the MAC-lay er log entries in
real time.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 15
Page 16
Command Reference
Command Reference
This section describees new and changed commands in Cisco IOS Re lease 12.0(3)T for
troubleshooting the Cisco uBR904 cable modem.
All other commands used with this feature are documented in the Cisco IOS Release 12.0 command
references.
• show controllers cable-modem
• show controllers cable-modem bpkm
• show controllers cable-modem des
• show controllers cable-modem filters
• show controllers cable-modem lookup-table
• show controllers cable-modem mac
• show controllers cable-modem phy
• show controllers cable-modem tuner
Cisco IOS Release 12.0(3)T
16
Page 17
show controllers cable-modem
To display high-level controller information about a cable modem, use the show controllers
cable-modem command in privileged EXEC mode.
show controllers cable-modem number
Syntax Description
numberController number inside the cable modem.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
The show controllers cable-modem display begins with information from the first fe w re gisters of
the Broadcom BCM3220 chip. Next is buffer information for the receive, receive MAC message,
buffer descriptor, and packet descriptor rings. Then comes MIB statistics from the BCM3220 chip,
DMA base registers to indicate where the rings start, global control and status information, and
finally interrupts for the interrupt code.
show controllers cable-modem
Examples
When using this command, be sure to check the tx_count and the tx_head and tx_tail values for the
buffer descriptor (TX BD) and packet descriptor (TX PD) rings. The tx_count should be greater than
0, and the tx_head and tx_tail values should not be equal. If these values do not change for a long
period of time, it indicates there are packets stuck on the ring. This condition is often caused by the
headend not giving grants.
Following is a sample output for this command:
uBR904# show controllers cable-modem 0
BCM Cable interface 0:
BCM3220 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask 0x80
station address 0010.7b43.aa01 default station address 0010.7b43.aa01
PLD VERSION: 32
MAC State is ranging_2_state, Prev States = 7
MAC mcfilter 01E02F00 data mcfilter 01000000
DS: BCM 3116 Receiver: Chip id = 2
US: BCM 3037 Transmitter: Chip id = 30B4
ds_data_dma_ctrl=0x98, ds_mac_dma_ctrl=0xD8
ds_dma_data_index=0x0007, ds_dma_msg_index=0x0000
upstream dma:
us_bd_base=0x001FB8, us_pd_base=0x002038
us_dma_ctrl=0x80, us_dma_tx_start=0x00
Global control and status:
global_ctrl_status=0x00
interrupts:
irq_pend=0x0008, irq_mask=0x00F7
Table 2 briefly describes some of the fields shown in the display. For more inform ation, see the
Broadcom documentation for the BCM3220 chip.
Table 2Show Controllers Cable-Modem Field Descriptions
FieldDescription
BCM3220 unitThe unit number of this BCM3220 chip.
idbInterface description block number.
dsDownstream channel.
regaddrIndicates the start of the BCM3220 registers.
reset_maskIndicates the bit to hit when resetting the chip.
station addressMAC address of this uBR904 cable modem interface.
default station addressDefault MAC address assigned by the factory for this uBR904 cable modem.
PLD VERSIONPLD version of the BCM3220 chip.
MAC stateCurrent MAC state of the cable modem.
Prev StatesNumber of states that have previously existed since initialization.
MAC mcfilterMAC control filter for MAC messages.
data mcfilterMAC control filter for data.
DSDownstream Broadcom receiver chip number and ID.
USUpstream Broadcom transmitter chip number and ID.
Tuner: statusCurrent status of the tuner.
Rx: tuner_freqDownstream frequency (in Hz) that the uBR904 searched for and found.
symbol_rateDownstream frequency in symbols per second.
local_freqFrequency on which the transmitter and the tuner communic at e.
snr_estimateEstimate of signal-to-noise ratio (SNR) in Db X 1000.
ber_estimateE st imate of bit error rate (always 0).
lock_thresholdMinimum signal-to-noise ratio (SNR) that the uBR904 will accept as a valid lock.
qam_modeThe modulation scheme used in the downstream direction.
Tx: tx_freqUpstream frequency sent to the uBR904 by the CMTS in the UCD message.
power_levelTransmit power level as set in the hardware, expressed as a hexadecimal value. The
units are unique to the hardware used. Use the show controllers cable-modem 0 mac state command to see the power level in dBmV.
symbol_rateUpstream frequency in symbols per second.
TFTP serverIP address of the TFTP server at the headend.
TOD serverIP address of the time-of-day server at the headend.
Security serverIP address of the security server at the headend.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 19
Page 20
Command Reference
Table 2Show Controllers Cable-Modem Field Descriptions (Continued)
FieldDescription
Timezone OffsetCorrection received from the DHCP server to synchronize the cable modem time clock
with the CMTS.
Config filenameName of the file stored on the cable company’s TFTP server that contains operational
parameters for the cable modem.
buffer sizeSize in bytes of the BCM3220 message buffers.
RX data PDU ring:
rx_head
rx_p
RX MAC message ring:
rx_head_mac
rx_p_mac
TX BD ring:
tx_count
tx_head
head_txp
Indicates the memory location of the beginning of buffer information for the receive
data ring.
Indicates current head buffer descriptor.
Indicates current head packet descriptor.
Indicates the memory location of the beginning of buffer information for the receive
MAC message ring.
Indicates current head buffer descriptor.
Indicates current head packet descriptor.
Indicates the memory location of the beginning of buffer information for the transmit
buffer descriptor ring.
If tx_count is 0, or if tx_head and tx_tail are equal and there is no change for a period of
time, it means there are packets stuck on the ring. This condition may be caused by the
headend not giving grants.
The next packet descriptor to get used, along with its index.
tx_tail
tail_txp
TX PD ring:
tx_head_pd
tx_tail_pd
ehdr
The next packet descriptor to get sent, along with its index. When head_txp and tail_txp
are the same, the transmit queue is empty.
Indicates the memory location of the beginning of buffer information for the transmit
packet descriptor ring.
Indicates current head packet descriptor.
Indicates current tail packet descriptor.
Extended MCNS header.
MIB Statistics:
DS fifo fullNumber of times the downstream input first-in first-out (FIFO) buffer became full on
the uBR904.
rerequestsNumber of times a bandwidth request generated by the uBR904 was not responded to
by the CMTS.
DS mac msg overrunsNumber of times the uBR904’s DMA controller had a downstream MAC message and
there were no free MAC message buffer descriptors to accept the message.
DS data overrunsNumber of times the uBR904’ s DMA controller had downstream data and there were no
free data PDU buffer descriptors to accept the data.
Qualified mapsNumber of times a MAP message passed all filtering requirements and was received b y
the uBR904.
Qualified syncsNumber of times a timestamp message was received by the uBR904.
CRC failsNumber of times a MAC message failed a cyclic redundancy (CRC) check.
HDR chk failsNumber of times a MAC header failed its 16-bit CRC check. The MA C header CRC is a
16-bit Header Check Sequence (HCS) field that ensures the integrity of the MAC
header even in a collision environment.
Data pdusTotal number of data PDUs (protocol data units) of all types received by the uBR904.
Cisco IOS Release 12.0(3)T
20
Page 21
Related Commands
show controllers cable-modem
Table 2Show Controllers Cable-Modem Field Descriptions (Continued)
FieldDescription
Mac msgsNumber of MAC messages received by the uBR904.
Valid hdrsNumber of valid headers receiv ed by the uBR904, including PDU headers, MAC
headers, and headers only.
Global control and status:Used to reset the BCM3220 chip.
interrupts:Hexadecimal values of the pending IRQ interrupt and IRQ mask.
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem phy
show controllers cable-modem tuner
Troubleshooting Tips for the Cisco uBR904 Cable Modem 21
Page 22
Command Reference
show controllers cable-modem bpkm
To display information about the baseline privacy key management exchange between the cable
modem and the headend CMTS, use the show controllers cable-modem bpkm command in
privileged EXEC mode.
show controllers cable-modem number bpkm
Syntax Description
numbercontroller number inside the cable modem.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Examples
The following output is displayed when the headend CMTS does not have baseline privacy enabled:
uBR904# show controllers cable-modem 0 bpkm
CM Baseline Privacy Key Management
configuration (in seconds):
authorization wait time: 10
reauthorization wait time: 10
authorization grace time: 600
operational wait time: 1
rekey wait time: 1
tek grace time: 600
authorization rej wait time: 60
kek state: STATE_B_AUTH_WAIT
sid 4:
tek state: No resources assigned
Table 3 describes the fields shown in the display.
Table 3Show Controllers Cable-Modem bpkm Field Descriptions
FieldDescription
authorization wait timeThe number of seconds the cable modem waits for a reply after sending the
Authorization Request message to the CMTS.
reauthorization wait timeThe number of seconds the cable modem waits for a reply after it has sent an
Authorization Request message to the CMTS in response to a reauthorization request or
an Authorization Invalid message from the CMTS.
authorization grace timeThe number of seconds before the current authorization is set to expire that the grace
timer begins, signaling the cable modem to begin the reauthorization process.
operational wait timeThe number of seconds the TEK state machine waits for a reply from the CMTS after
sending its initial Key Request for its SID’s keying material.
Cisco IOS Release 12.0(3)T
22
Page 23
Related Commands
show controllers cable-modem bpkm
Table 3Show Controllers Cable-Modem bpkm Field Descriptions (Continued)
FieldDescription
rekey wait timeThe number of seconds the TE K state machi ne waits for a replacement key for this SID
after the TEK grace timer has expired and the request for a replacement key has been
made.
tek grace timeThe number of seconds before the current TEK is set to expire that the TEK grace timer
begins, signaling the TEK state machine to request a replacement key.
authorization rej wait timeNumber of seconds the cable modem waits before sending another Authorization
Request message to the CMTS after it has receiv e d an Authorization Reject message.
kek stateThe current state of the key encryption key that the CMTS uses to encrypt the traffic
encryption keys it sends to the cable modem.
tek stateThe current state of the traffi c encryption key state machine for the specified SID.
show controllers cable-modem
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem phy
show controllers cable-modem tuner
Troubleshooting Tips for the Cisco uBR904 Cable Modem 23
Page 24
Command Reference
show controllers cable-modem des
To display information about the Data Encryption Standard (DES) engine registers, use the show
controllers cable-modem des command in privileged EXEC mode.
show controllers cable-modem number des
Syntax Description
numbercontroller number inside the cable modem.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Examples
DES engine registers are displayed in the following example:
uBR904# show controllers cable-modem 0 des
downstream des:
ds_des_key_table:
key 0: even 0, odd 0
key 1: even 0, odd 0
key 2: even 0, odd 0
key 3: even 0, odd 0
ds_des_cbc_iv_table:
iv 0: even 0, odd 0
iv 1: even 0, odd 0
iv 2: even 0, odd 0
iv 3: even 0, odd 0
ds_des_sid_table:
sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
ds_des_sid_enable=0x80, ds_des_ctrl=0x2E
ds_des_sv=0x0F00
ds_unencrypted_length=0x0C
upstream des:
us_des_key_table:
key 0: even 0, odd 0
key 1: even 0, odd 0
key 2: even 0, odd 0
key 3: even 0, odd 0
us_des_cbc_iv_table:
iv 0: even 0, odd 0
iv 1: even 0, odd 0
iv 2: even 0, odd 0
iv 3: even 0, odd 0
pb_req_bytes_to_minislots=0x10
us_des_ctrl=0x00, us_des_sid_1= 0x1234
ds_unencrypted_length=0x0C
Table 4 briefly describes some of the fields shown in the display. For more inform ation, see the
Broadcom documentation for the BCM3220 chip.
Cisco IOS Release 12.0(3)T
24
Page 25
show controllers cable-modem des
Table 4Show Controllers Cable-Modem DES Field Descriptions
FieldDescription
ds_des_key_tableTable showing downstream DES keys.
ds_des_cbc_iv_tableTable of downstream DES Cipher Block Chaining mode information.
ds_des_sid_tableTable showing the SID values to be enabled for DES encryption.
ds_des_sid_enableControls which SID entries in the SID table are enabled for encryption. In the above
example, none of the entries are enabled for encryption.
ds_des_ctrlControl register that controls the operating mode of the downstream DES engine.
ds_des_svDES security version register; the range of the version field in Baseline Privacy
interface (BPI) extended headers that will be accepted by the hardware. High byte is
upper limit, low byte is lower limit. The uBR904 will accept ve rsions 0 to 15.
ds_unencrypted_lengthSpecifies the number of bytes that will be unencrypted at the beginning of the MAC
frame. 0x0C means the first 12 bytes are not encrypted, which is what the DOCSIS
Baseline Privacy specification calls for.
us_des_key_tableTable showing upstream DES keys.
us_des_cbc_iv_tableTable of upstream DES Cipher Block Chaining mode information.
us_des_ctrlControl register that controls the operating mode of the upstream DES engine. The
value 0x24 means that the upstream is configured to enable decryption and to use CBC
mode
Related Commands
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem phy
show controllers cable-modem tuner
Troubleshooting Tips for the Cisco uBR904 Cable Modem 25
Page 26
Command Reference
show controllers cable-modem filters
T o display the registers in the MAC hardware that are used for f iltering received frames, use the show
controllers cable-modem filters command in privileged EXEC mode.
show controllers cable-modem number filters
Syntax Description
numberController number inside the cable modem.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Some of the filtering parameters are MAC hardware addresses, Service IDs (SIDs), and upstream
channel IDs.
Examples
MAC and SID filter information is displayed in the following example:
Table 5 briefly describes some of the fields shown in the display. For more inform ation, see the
Broadcom documentation for the BCM3220 chip.
Cisco IOS Release 12.0(3)T
26
Page 27
show controllers cable-modem filters
Table 5Show Controllers Cable-Modem Filters Field Descriptions
FieldDescription
ds_mac_da_filtersShows the MAC address of the cable interface and the MAC addr ess of any Ethernet
MAC it is bridging.
ds_mac_da_filter_ctrlDownstream MAC filter control for data.
ds_mac_msg_sofDownstream MAC message start of frame.
ds_mac_da_mcDownstream MAC control filter for data.
map_parser_sidsService IDs used for upstream bandwidth allocation.
ds_mac_filter_ctrlDownstream MAC filte r control for MAC messages.
us_channel_idUpstream channel ID.
ds_pidDownstream packet ID
mac_msg_proto_verVersion of the MAC management protocol in use.
reg_rang_req_sidService ID (SID) field of the ranging request message.
ds_data_da_filter_tableDownstream data processing filter table.
ds_data_da_filter_ctrlDownstream data processing filter control.
ds_pdu_sofDownstream PDU start of frame.
ds_data_da_mcDownstream data processing MAC control.
us_ctrl_statusUpstream control status.
Minislots per requestLength of each registration request in mini-slots.
burst_mapsMap the burst profiles sav ed in the BCM3037 registers to interv al u sage codes (IUCs).
bytes_per_minislot_expNumber of bytes per expansion mini-slot.
ticks_per_minislotNumber of time ticks (6.25-microsecond intervals) in each upstream mini-slot.
maint_xmitNumber of initial maintenance transmit opportunities.
us_sid_tableUpstream service ID table.
max_re_reqMaximum number of registration re-requests allowed.
rang_fifoNumber of ranging requests that can be held in the first-in-first-out buffer.
Related Commands
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem phy
show controllers cable-modem tuner
Troubleshooting Tips for the Cisco uBR904 Cable Modem 27
Page 28
Command Reference
show controllers cable-modem lookup-table
T o display the mini-slot lookup table inside a cable modem, use the show controllers cable-modem
lookup-table command in privileged EXEC mode.
show controllers cable-modem number lookup-table
Syntax Description
numberController number inside the cable modem.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
This command shows the details of the lookup table. The driver use s this table to convert the size of
a packet that the cable modem wants to transmit into a bandwidth request to the CMTS in mini-slots.
The contents of this table are affected by the upstream symbol rate that is negotiated between the
CMTS and the cable modem.
Examples
Use this table to look up the packet size and determine how many mini-slots will be needed.
The lookup table is displayed in the following example:
uBR904# show controllers cable-modem 0 lookup-table
Max Burst Size (minislots) = 0x6
Max Burst Length (bytes) = 0x4B
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem mac
show controllers cable-modem phy
show controllers cable-modem tuner
Cisco IOS Release 12.0(3)T
30
Page 31
show controllers cable-modem mac
To show detailed MAC-layer information for a cable modem, enter the show controllers
cable-modem mac command in privileged EXEC mode.
show controllers cable-modem number mac [errors | hardware | log | resets | state]
Syntax Description
numberThe controller number inside the cable modem.
errors(Optional) Displays a log of the error events that are reported to SNMP. This keyword
gives you a way of looking at the error events without using a MIB.
hardware(Optional) Displays all MAC hardware registers.
log(Optional) Displays a history of MAC log messages, up to 1023 entries. This is the same
output that is displayed when the debug cable-modem mac log command is entered.
resets(Optional) Extracts all the reset causes out of the MAC log file and summarizes them
into a mini report.
show controllers cable-modem mac
Command Mode
Usage Guidelines
state(Optional) Displays a summary of the MAC state.
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
MAC log messages are written to a circular log file even when debugging is not turned on. These
messages include timestamps, events, and information pertinent to these events. Enter the show controllers cable-modem mac log command to view MAC log messages.
If the cable modem interface fails to come up or resets periodically, the MAC log will capture what
happened. For example, if an address is not obtained from the DHCP server, an error is logged,
initialization starts over, and the cable modem scans for a downstream frequency.
The most useful keywords for troubleshooting a cable modem are log, errors, and resets. See
Example 1, Example 2, and Example 3.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 31
Page 32
Command Reference
Example 1
The following sample display shows the MAC log file for a cable-modem interface that has
successfully come up:
74376.112 R02.0 No Ranging Response received. T3 time-out.
74376.354 R02.0 No Ranging Response received. T3 time-out.
74376.778 R02.0 No Ranging Response received. T3 time-out.
74377.442 R02.0 No Ranging Response received. T3 time-out.
This output indicates that the cable modem acquired a downstream lock, successfully read a UCD,
and successfully read a MAP. However , it was unable to communicate with the CMTS after ranging
through all upstream transmit power levels (from 8 dBmv to 61 dBmv). The cable modem tried to
communicate with the CMTS 16 times without success, after which it reset the cable interface to try
to find a better downstream frequency.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 33
Page 34
Command Reference
Example 3
If the DHCP server could not be reached, the error would look like this in the MAC error display:
uBR904# show controllers cable-modem 0 mac errors
497989.804 D01.0 Discover sent no Offer received. No available DHCP Server.
498024.046 D01.0 Discover sent no Offer received. No available DHCP Server.
498058.284 D01.0 Discover sent no Offer received. No available DHCP Server.
The show contr ollers cable-modem 0 mac resets command shows only the entries in the MAC log
that begin with the field
CMAC_LOG_RESET. Collectively presenting these fields provides you with a
summary of the most recent reasons why the cable interface was reset.
Reset messages and brief explanations are included in the following examples and in Table 6;
however, the reset messages in Table 6 do not commonly occur.
In the following example, the configuration file downloaded from the TFTP server could not be read.
The file might not exist, or the file might have incorrect permissions.
uBR904# show controllers cable-modem 0 mac resets
62526.114 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62564.368 CMAC_LOG_RESET_T4_EXPIRED
62677.178 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62717.462 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62757.746 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62796.000 CMAC_LOG_RESET_T4_EXPIRED
62908.808 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62949.092 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62989.380 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63029.662 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63069.944 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63110.228 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63148.484 CMAC_LOG_RESET_T4_EXPIRED
63261.296 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
The following example shows that the DHCP server could not be reached. The DHCP server took
too long to respond.
uBR904# show controllers cable-modem 0 mac resets
497989.804 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
498024.046 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
498058.284 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
The following example indicates that an event in the cable interface driver caused the interface to
reset. This often occurs because a shut or clear command is currently being issued on the interface.
uBR904# show controllers cable-modem 0 mac resets
527986.444 CMAC_LOG_RESET_FROM_DRIVER
528302.042 CMAC_LOG_RESET_FROM_DRIVER
528346.600 CMAC_LOG_RESET_FROM_DRIVER
528444.494 CMAC_LOG_RESET_FROM_DRIVER
Cisco IOS Release 12.0(3)T
34
Page 35
Table 6Possible but Uncommon Cable Interface Reset Causes
MessageDescription
CMAC_LOG_RESET_CONFIG_FILE_PARSE_FAILED
The format of the DOCSIS configuration file acquired
from the TFTP server is not acceptable.
CMAC_LOG_RESET_LOSS_OF_SYNC
Synchronization with the CMTS has been lost (SYNC
messages are not being received).
CMAC_LOG_RESET_T4_EXPIRED
Maintenance ranging opportunities for this cable modem
are not being received from the CMTS.
CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
CMAC_LOG_RESET_TOD_WATCHDOG_EXPIRED
CMAC_LOG_RESET_PRIVACY_WATCHDOG_EXPIRED
The DHCP server took too long to respond.
The Time Of Day server took too long to respond.
The baseline privacy exchange with the CMTS took too
long.
CMAC_LOG_RESET_CHANGE_US_WATCHDOG_EXPIRED
The cable modem was unable to transmit a response to a
UCC-REQ message.
CMAC_LOG_RESET_SECURITY_WATCHDOG_EXPIRED
The “full security” exchange with the CMTS took too
long.
CMAC_LOG_RESET_CONFIG_FILE_WATCHDOG_EXPIRED
CMAC_LOG_RESET_ALL_FREQUENCIES_SEARCHED
The TFTP server took too long to respond.
All downstream frequencies to be searched have been
searched.
This message indicates that downstream frequencies were
found and the cable modem failed.
CMAC_LOG_RESET_T2_EXPIRED
CMAC_LOG_RESET_T3_RETRIES_EXHAUSTED
Initial ranging opportunities are not being received.
The CMTS failed too many times to respond to a
RNG-REQ message.
CMAC_LOG_RESET_RANGING_ABORTED
The CMTS commanded the cable modem to abort the
ranging process.
CMAC_LOG_RESET_NO_MEMORY
CMAC_LOG_RESET_CANT_START_PROCESS
The cable modem has run out of memory.
The cable modem was unable to start an internal process
necessary to complete ranging and registration.
CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
The reading of the configuration file from the TFTP
server failed. The file mi ght not exist, or it might have
incorrect permissions.
CMAC_LOG_RESET_AUTHENTICATION_FAILURE
The cable modem failed authentication as indicated in a
REG-RSP message from the CMTS.
CMAC_LOG_RESET_SERVICE_NOT_AVAILABLE
The CMTS has failed the cable modem’s registration
because a required or requested class of service is not
available.
CMAC_LOG_RESET_T6_RETRIES_EXHAUSTED
The CMTS failed too many times to respond to a
REG-REQ message.
CMAC_LOG_RESET_MAINTENANCE_WATCHDOG_DRIVER
The cable modem MAC layer fail ed to detect a change in
the interface drive r.
CMAC_LOG_RESET_NET_ACCESS_MISSING
The Network Access parameter was missing from the
DOCSIS configuration file.
CMAC_LOG_RESET_FAILED_WRITE_ACCESS_CONTROL
The cable modem was unable to set the Write Access
Control for an SNMP parameter, as specified by the
DOCSIS configuration file.
show controllers cable-modem mac
Troubleshooting Tips for the Cisco uBR904 Cable Modem 35
Page 36
Command Reference
Table 6Possible but Uncommon Cable Interface Reset Causes (Continued)
MessageDescription
CMAC_LOG_RESET_DHCP_FAILED
The DHCP server did not respond with all the required
values. The required values are: IP address, network
mask, TFTP server IP address, TOD server IP address,
DOCSIS configuration file name, and time zone offset.
CMAC_LOG_RESET_CANT_START_DS_TUNER_PRCESS
The cable modem was unable to start the internal process
used to manage the downstream tuner.
CMAC_LOG_RESET_TOO_MANY_DS_LOCKS_LOST
Downstream QAM/FEC lock has been lost too many
times.
CMAC_LOG_RESET_NO_SEND_TO_DS_TUNER_PROCESS
The cable modem MAC-layer process was unable to
communicate with the downstream tuner management
process.
CMAC_LOG_RESET_DS_TUNER_WATCHDOG
The downstream tuner process failed to report its
continuing operation for a long period of time.
CMAC_LOG_RESET_UNABLE_TO_SET_MIB_OBJECT
The cable modem was unable to set an SNMP parameter
as specified by the DOCSIS configuration file.
CMAC_LOG_RESET_MIB_OBJECT_PROCESS_WATCHDOG
The internal MIB object took too long to process the
entries in the DOCSIS configuration file.
Example 4
The following example display for the show controllers cable-modem 0 mac hardware command
shows the detailed configuration of the interface driver and MAC-layer hardware. The most
interesting bit is the station address (hardware address). The MIB statistics reflect the MAC
hardware counters for various events, but these counters are typically reset every few seconds, so
their contents are not accurate in this display.
uBR904# show controllers cable-modem 0 mac hardware
PLD VERSION: 32
BCM3220 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask
0x80
station address 0010.7b43.aa01 default station address 0010.7b43.aa01
MAC mcfilter 01E02F00 data mcfilter 01000000
Most of the fields in this display are described in Table 2, Show Controllers Cable-Modem Field
Descriptions. T able 7 describes the MIB statistics shown in the display.
Table 7Show Controllers Cable-Modem MIB Statistics Field Descriptions
FieldDescription
DS fifo fullNumber of times the downstream receive buffer on the cable modem became full.
RerequestsNumber of registration requests sent by the cabl e modem to the CMTS.
DS mac msg overrunsNumber of times the DMA controller had a downstream MAC message and there were
DS data overrunsNumber of times the DMA controller had downstream data and there were no free data
Qualified mapsNumber of valid MAP messages received by the cable modem.
Qualified syncsNumber of times the cable modem received synchronization with the downstream
Cisco IOS Release 12.0(3)T
38
no free MAC message buffer descriptors to accept the message.
PDU buffer descriptors to accept the data.
channel.
Page 39
Example 5
show controllers cable-modem mac
Table 7Show Controllers Cable-Modem MIB Statistics Field Descriptions (Continued)
FieldDescription
CRC failsNumber of cyclic redundancy checksums generated by the far-end device that do not
match the checksums calculated from the message portions of the packets received.
HDR check failsNumber of cyclic redundancy checksums generated by the far-end device that do not
match the checksums calculated from the MAC headers of the packets received. The
MAC header CRC is a 16-bit Header Check Sequence (HCS) field that ensures the
integrity of the MAC header e ven in a collision environment.
Data pdusTotal number of data PDUs (protocol data units) of all types received by the cable
interface.
Mac msgsNumber of MAC messages receiv ed by the cable interface.
Valid hdrsNumber of valid MAC headers received by the cable interface.
Below the MIB statistics in the display, the BCM3220 registers section shows the DMA locations of
the indicated processing routines of the Broadcom 3220 MAC chip within the Cisco uBR904.
The show controllers cable-modem mac state command summarizes the state of the cable MAC
layer. If the cable MAC layer is in the
wait_for_link_up_state, the information shown in the
display corresponds to the last time the interface was up. This allows useful information to be
acquired from this display even though the modem has not been able to range and register. The
normal operational state of the interface is the
uBR904# show controller cable-modem 0 mac state
MAC State: maintenance_state
Ranging SID: 5
Registered: TRUE
Privacy Established: TRUE
Troubleshooting Tips for the Cisco uBR904 Cable Modem 39
Page 40
Command Reference
97 141000000 171000000 6000000
98 219000000 225000000 6000000
99 177000000 213000000 6000000
US ID: 1
US Frequency: 20000000
US Power Level: 34.0 (dBmV)
US Symbol Rate: 1280000
Ranging Offset: 12460
Mini-Slot Size: 8
Change Count: 4
Preamble Pattern: CC CC CC CC CC CC CC CC CC CC CC CC CC CC 0D 0D
A9 17 D9 C3 52 2F B3 86 A4 5F 67 0D 48 BE CE 1A
91 7D 9C 35 22 FB 38 6A 45 F6 70 D4 8B EC E1 A9
17 D9 C3 52 2F B3 86 A4 5F 67 0D 48 BE CE 1A 91
F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3
F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 33 F7 33 F7
88 84 04 4C C4 84 C0 0C 44 08 08 CC 8C 0C 80 48
88 40 44 CC 48 4C 00 C4 40 80 8C C8 C0 C8 04 88
Burst Descriptor 0:
Interval Usage Code: 1
Modulation Type: 1
Differential Encoding: 2
Preamble Length: 64
Preamble Value Offset: 56
FEC Error Correction: 0
FEC Codeword Info Bytes: 16
Scrambler Seed: 338
Maximum Burst Size: 1
Guard Time Size: 8
Last Codeword Length: 1
Scrambler on/off: 1
Burst Descriptor 1:
Interval Usage Code: 3
Modulation Type: 1
Differential Encoding: 2
Preamble Length: 128
Preamble Value Offset: 0
FEC Error Correction: 5
FEC Codeword Info Bytes: 34
Scrambler Seed: 338
Maximum Burst Size: 0
Guard Time Size: 48
Last Codeword Length: 1
Scrambler on/off: 1
Burst Descriptor 2:
Interval Usage Code: 4
Modulation Type: 1
Differential Encoding: 2
Preamble Length: 128
Preamble Value Offset: 0
FEC Error Correction: 5
FEC Codeword Info Bytes: 34
Scrambler Seed: 338
Maximum Burst Size: 0
Guard Time Size: 48
Last Codeword Length: 1
Scrambler on/off: 1
Burst Descriptor 3:
Interval Usage Code: 5
Modulation Type: 1
Differential Encoding: 2
Preamble Length: 72
Preamble Value Offset: 48
FEC Error Correction: 5
FEC Codeword Info Bytes: 75
Cisco IOS Release 12.0(3)T
40
Page 41
Scrambler Seed: 338
Maximum Burst Size: 0
Guard Time Size: 8
Last Codeword Length: 1
Scrambler on/off: 1
Config File:
Network Access: TRUE
Vendor ID: 0.240.30
Baseline Privacy:
Auth. Wait Timeout: 10
Reauth. Wait Timeout: 10
Auth. Grace Time: 600
Op. Wait Timeout: 1
Retry Wait Timeout: 1
TEK Grace Time: 600
Auth. Reject Wait Time: 60
COS 1:
Assigned SID: 5
Max Downstream Rate: 4000000
Max Upstream Rate: 2000000
Upstream Priority: 7
Min Upstream Rate: 100000
Max Upstream Burst: 12
Privacy Enable: TRUE
Ranging Backoff Start: 0 (at initial ranging)
Ranging Backoff End: 4 (at initial ranging)
Data Backoff Start: 0 (at initial ranging)
Data Backoff End: 4 (at initial ranging)
IP Address: 0.0.0.0
Net Mask: 0.0.0.0
show controllers cable-modem mac
TFTP Server IP Address: 223.255.254.254
Time Server IP Address: 188.188.1.5
Config File Name: muck/ebuell/tftp/cm_conf
Time Zone Offset: -28800
Table 8 describes the fields shown in the display.
Table 8Show Controllers Cable-Modem MAC State Field Descriptions
FieldDescription
MAC StateCurrent operational state of the MAC layer of the cable modem.
Ranging SIDService ID used for ranging requ ests.
RegisteredIndicates whether or not the cable modem is currently registered with the CMTS.
Privacy Establish edIndicates whether or not keys for baseline privacy have been exchanged between the
cable modem and the CMTS, establishing privacy.
Mac ResetsNumber of times the uBR904 reset or initialized this interface.
Sync lostNumber of times the uBR904 lost synchronization with the downstream channel.
Invalid MapsNumber of times the uBR904 received invalid MAP messages.
Invalid UCDsNumber of times the uBR904 received invalid UCD messages.
Invalid Rng RspNumber of times the uBR904 received invalid ranging response messages.
Invalid Reg RspNumber of times the uBR904 received invalid registration response messages.
T1 TimeoutsNumber of timeouts caused by the uBR904 not receiving a valid upstream channel
descriptor (UCD) from the CMTS within the specified time.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 41
Page 42
Command Reference
Table 8Show Controllers Cable-Modem MAC State Field Descriptions (Continued)
FieldDescription
T2 TimeoutsNumber of timeouts caused by the uBR904 not receiving a maintenance broadcast
for ranging opportunities from the CMTS within a specified time.
T3 TimeoutsNumber of timeouts caused by the uBR904 not receiving a response within a
specified time from the CMTS to a RNG-REQ message during initial maintenance.
T4 TimeoutsNumber of timeouts caused by the uBR904 not receiving a response within a
specified time from the CMTS to a periodic maintenance request.
Range AbortsNumber of times the ranging process was aborted by the CMTS.
DS IDThe identifier of the downstream channel on which this MAC management message
has been transmitted. This identifier is arbitrarily chosen by the CMTS and is only
unique within the MAC-sublayer domain.
DS FrequencyDownstream frequency acquired by the cable modem during its last initialization
sequence.
DS Symbol RateDownstream frequency in symbols per second.
DS QAM ModeDownstream modulation scheme being used by the cable modem.
DS SearchFrequency bands scanned by the cable modem when searching for a downstream
channel. The uBR904’s default frequency bands correspond to the North American
EIA CATV channel plan for 6 MHz channel slots between 90 MHz and 858 MHz.
US IDThe identifier of the upstream channel to which this MAC management message
refers. This identifier is arbitrarily chosen by the CMTS and is only unique within
the MAC-sublayer domain.
US FrequencyTransmission frequ ency used by the cable modem in the upstream direction.
US Power LevelTransmit power level of the cable modem in the upstream direction.
US Symbol RateUpstream frequency in symbols per second.
Ranging OffsetDelay correction (in increments of 6.25 us/64) applied by the cable modem to the
CMTS upstream frame time derived at the cable modem. Used to synchronize the
upstream transmissions in the time division multiple access (TDMA) scheme, this
value is roughly equal to the round-trip delay of the cable modem from the CMTS.
Mini-Slot SizeSize T of the mini-slot for this upstream channel in units of the timebase tick of
6.25 us. Allowable values are 2, 4, 8, 16, 32, 64, or 128.
Change CountIncremented by 1 by the CMTS whene ver an y of the v alues of this channel descriptor
change. If the value of this count in a sebsequent upstream channel descriptor (UCD)
remains the same, the cable modem can quickly decide that the remaining f ields hav e
not changed, and may be able to disregard the remainder of the message.
Preamble PatternByte pattern used for the preamble.
Cisco IOS Release 12.0(3)T
42
Page 43
show controllers cable-modem mac
Table 8Show Controllers Cable-Modem MAC State Field Descriptions (Continued)
FieldDescription
Burst Descriptor:
A compound type/length/value (TLV) encoding that defines, for each type of
upstream usage interval, the physical-layer characteristics that are to be used during
that interval. Each burst descriptor is given an identifying number.
Interval Usage Code
Each upstream transmit burst belongs to a class which is given a number called the
IUC (interval usage code). Bandwidth maps messages (MAP) are used by IUC codes
to allocate upstream time slots. The following types are currently defined:
1. Request: bandwidth request slot
2. Request/Data: bandwidth request or data slot
3. Initial Maintenance: initial link registration contention slot
4. Station Maintenance: link keep-alive slot
5. Short Data Grant: short data burst slot
6. Long Data Grant: long data burst slot
Modulation TypeUpstream modulation format. (1 = QPSK; 2 = 16QAM)
Differential EncodingIndicates whether or not differential encoding is used. (1 = yes; 2 = no)
Preamble LengthLength of the preamble in bits. The value must be an integral number of symbols—a
multiple of 2 for QPSK; a multiple of 4 for 16QAM.
FEC Error CorrectionLength of the forward error correction in bytes. The range is 0-10 bytes; a value of 0
implies no forward error correction.
FEC Codeword Info BytesNumber of information bytes in the FEC codeword.
Scrambler Seed15-bit seed value loaded at the beginning of each burst after the register has been
cleared. Not used if scrambler is off.
Maximum Burst SizeMaximum number of mini-slots that can be transmitted during this burst type. Wh en
the interval type is Short Data Grant, th is valu e must be greater than 0. If this v alu e is
0, the burst size is limited elsewhere.
Guard Time SizeAmount of time in symbols between the center of the last symbol of one burst and
the center of the first symbol of the preamble of an immediatel y following b urst in an
upstream transmission from the cable modem to the CMTS.
Last Codeword LengthIndicates whether or not the length of the last codeword is fixed or shortened.
(1 = fixed; 2 = shortened)
Scrambler on/offIndicates whether or not a scrambler is enabled in the upstream modulator.
(1 = on; 2 = off)
Network AccessIndicates whether or not the cable modem has access to the HFC network.
Vendor IDUnique identifier specifying the cable modem manufacturer.
Auth. Wait TimeoutThe number of seconds the cable modem waits for a reply after sending the
Authorization Request message to the CMTS.
Reauth. W ait TimeoutThe number of seconds the cable modem waits for a reply after it has sent an
Authorization Request message to the CMTS in response to a reauthorization request
or an Authorization Invalid message from the CMTS.
Auth. Grace TimeThe number of seconds before the current authorization is set to expire that the grace
timer begins, signaling the cable modem to begin the reauthorization process.
Op. W ait TimeoutThe number of seconds the TEK state machine waits for a reply from the CMTS
after sending its initial Key Request for its SID’s keying material.
Retry W ait TimeoutThe number of seconds the TEK state machine waits for a replacement key for this
SID after the TEK grace timer has expired and the request for a replacement key has
been made.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 43
Page 44
Command Reference
Table 8Show Controllers Cable-Modem MAC State Field Descriptions (Continued)
FieldDescription
TEK Grace TimeThe number of seconds before the current TEK is set to expire that the TEK grace
timer begins, signaling the TEK state machine to request a replacement key.
Auth. Reject Wait TimeNumber of seconds the cable modem waits before sending another Authorization
Request message to the CMTS after it has receiv ed an Authorizat ion Reject message.
Assigned SIDService ID assigned by the CMTS for the corresponding service class.
Max Downstream RateMaximum downstream rate in bits per second that the CMTS is permit ted to forw ard
to CPE unicast MAC addresses learned or configured as mapping to this uBR904.
(This does not include MAC packets addressed to broadcast or multicast MAC
addresses.)
Max Upstream RateMaximum upstream rate in bits per second that the uBR904 is permitted to forward
to the RF network. This includes packet PDU data packets addressed to broadcast or
multicast addresses.
Upstream PriorityRelative priority assigned to this service class for dat a transmission in the upstream
channel. Higher numbers indicate higher priority.
Min Upstream RateDate rate in bits per second that will be guaranteed to this service class on the
upstream channel.
Max Upstream BurstMaximum transmit burst in bytes allowed for this service class on the upstream
channel.
Privacy Ena bleIndicates whether or not Baseline Priv acy is enabled for this service class.
Ranging Backoff StartInitial back-off window for initial ranging contention, expressed as a power of 2.
Valid values are from 0 to 15.
Ranging Backoff EndFinal back-off window for initial ranging contention, expressed as a power of 2.
Valid values are from 0 to 15.
Data Backoff StartInitial back-off window for contention data and requests, expressed as a power of 2.
Valid values are from 0 to 15.
Data Backoff EndFinal back-off window for contention data and requests, expressed as a power of 2.
Valid values are from 0 to 15.
IP AddressIP address of the cable interface.
Net MaskSubnet mask of the cable interface.
TFTP Server IP AddressIP address of the CMTS TFTP server.
Time Server IP AddressIP address of the CMTS Time of Day (TOD) server.
Config File NameName of the configuration file that is downloaded from the TFTP server to provide
the cable modem with operational parameters.
Time Zone OffsetCorrection received from the DHCP server to synchronize the cable modem time
clock with the CMTS.
Related Commands
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem phy
show controllers cable-modem tuner
Cisco IOS Release 12.0(3)T
44
Page 45
show controllers cable-modem phy
To display the contents of the registers used in the downstream physical hardware of the
Cisco uBR904 cable modem, use the show controllers cable-modem phy command in privileged
EXEC mode.
show controllers cable-modem phy {receive | transmit}
Syntax Description
receiveDisplays all receiver registers in the downstream physical hardware.
transmitDisplays all transmitter registers in the upstream physical hardware.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
show controllers cable-modem phy
Examples
T o understand the output from this command, consult the Broadcom specifications for the BCM3116
and BCM3037 chips.
Physical receive registers are displayed in the following example:
uBR904# show controllers cable-modem 0 phy receive
BCM3116 Receiver Registers: Chip ID = C2C1
Preamble values:
CC CC CC CC CC 0D 0D CC CC CC CC CC CC CC CC 0D
04 25 01 01 01 01 02 01 02 03 02 00 40 04 02 00
40 05 01 00 06 01 10 07 02 01 52 08 01 01 09 01
08 0A 01 01 0B 01 02 04 25 03 01 01 01 02 01 02
03 02 00 50 04 02 00 30 05 01 00 06 01 22 07 02
01 52 08 01 00 09 01 30 0A 01 01 0B 01 02 04 25
04 01 01 01 02 01 02 03 02 00 40 04 02 00 40 05
01 00 06 01 22 07 02 01 52 08 01 00 09 01 30 0A
Related Commands
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem tuner
Cisco IOS Release 12.0(3)T
46
Page 47
show controllers cable-modem tuner
To display the settings for the upstream and downstream tuners used by a Cisco uBR904 cable
modem, use the show controllers cable-modem tuner command in privileged EXEC mode.
show controllers cable-modem tuner
Syntax Description
There are no key words or arguments for this command.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Examples
The cable modem’s tuner settings are displayed in the following example. See Table 9 for output
field possibilities and descriptions.
uBR904# show controllers cable-modem 0 tuner
Tuner: status=0x00
Rx: tuner_freq 507000000, symbol_rate 5360736, local_freq 11520000
snr_estimate 17488, ber_estimate 0, lock_threshold 26000
QAM not in lock, FEC not in lock, qam_mode QAM_64
Tx: tx_freq 20000000, power_level 0x3E, symbol_rate 1280000
show controllers cable-modem tuner
Table 9 describes the fields shown in the display
Table 9Show Controllers Cable-Modem Tuner Field Descriptions
FieldDescription
tuner_freq
symbol_rate
local_freq
snr_estimate
ber_estimate
lock_threshold
QAM status
tx_freq
power_level
Indicates the current downstream frequency.
Indicates the downstream or upstream symbol rate in use.
Frequency on which the transmitter and tuner communicate.
Signal to noise estimate in dB X 1000.
Bit error rate estimate (always 0).
Minimum signal-to-noise ratio (SNR) that the uBR904 will accept as a valid lock.
Indicates if QAM/FEC lock has been acquired and the modulation mode in use.
Upstream frequency sent to the uBR904 by the CMTS in the UCD message.
Transmit power level as set in the hardware, given as a hexadecimal value. The units are
unique to the hardware used. Use the show controllers cable-modem 0 mac state
command to see the power level in dBmV.
Troubleshooting Tips for the Cisco uBR904 Cable Modem 47
Page 48
Command Reference
Related Commands
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem phy
Cisco IOS Release 12.0(3)T
48
Page 49
Debug Commands
The following new debug commands are available to troubleshoot a cable modem:
• debug cable-modem
• debug cable-modem bpkm
• debug cable-modem bridge
• debug cable-modem error
• debug cable-modem interrupts
• debug cable-modem mac
• debug cable-modem map
show controllers cable-modem tuner
Troubleshooting Tips for the Cisco uBR904 Cable Modem 49
Page 50
Debug Commands
debug cable-modem bpkm
To debug baseline privacy information on a cable modem, use the debug cable-modem mac
command in privileged EXEC mode. The no form of this command turns debugging messages off.
cm_bpkm_fsm(): machine: KEK, event/state: EVENT_4_TIMEOUT/STATE_B_AUTH_WAIT, new state:
STATE_B_AUTH_WAIT
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to down
cm_bpkm_fsm(): machine: KEK, event/state: EVENT_1_PROVISIONED/STATE_A_START, new state:
STATE_B_AUTH_WAIT
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to up
Troubleshooting Tips for the Cisco uBR904 Cable Modem 51
Page 52
Debug Commands
debug cable-modem bridge
Use the debug cable-modem bridge command in privileged EXEC mode to debug bridge filter
processing information on a cable modem. The no form of this command turns debugging messages
off.
[no] debug cable-modem bridge
Syntax Description
This command has no keywords or arguments.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
When the interface is down, all bridge table entries learned on the Ethernet interface are set to discard
because traffic is not bridged until the cable interface has c ompleted initialization. After the interface
(the line protocol) is completely up, bridge table entries learned on the Ethernet interface program
the cable’s MAC data filters. The cable MAC hardware filters out any received packets whose
addresses are not in the filters. In this way, the cable interface only receives packets addressed to its
own MAC address or an address it has learned on the Ethernet interface.
Examples
Related Commands
Figure 5 shows sample display output for the debug cable-modem bridge Privileged EXEC
command.
Figure 5Sample Debug Cable-Modem Bridge Output
uBR904# debug cable-modem bridge
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to downshut
cm_tbridge_add_entry(): MAC not initialized, discarding entry: 00e0.fe7a.186fno shut
cm_tbridge_add_entry(): MAC not initialized, discarding entry: 00e0.fe7a.186f
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to up
cm_tbridge_add_entry(): Adding entry 00e0.fe7a.186f to filter 2
Use the the debug cable-modem error command in privileged EXEC mode to enable debugging
messages for the cable interface driver . The no form of this command turns debugging messages of f.
[no] debug cable-modem error
Syntax Description
This command has no keywords or arguments.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
This command displays detailed output about the sanity checking of received frame formats, the
acquisition of downstream QAM/FEC lock, the receipt or non-receipt of SYNC messages from the
CMTS, reception errors, and bandwidth request failures.
debug cable-modem error
Examples
Related Commands
Figure 6 shows sample display output for the debug cable-modem error command.
Figure 6Sample Debug Cable-Modem Error Output
uBR904# debug cable-modem error
*Mar 7 20:16:29: AcquireSync(): Update rate is 100 Hz
*Mar 7 20:16:30: 1st Sync acquired after 1100 ms.
*Mar 7 20:16:30: Recovery loop is locked (7/9)
*Mar 7 20:16:30: 2nd Sync acquired after 100 ms.
*Mar 7 20:16:30: Recovery loop is locked (10/15)
Troubleshooting Tips for the Cisco uBR904 Cable Modem 53
Page 54
Debug Commands
debug cable-modem interrupts
Use the debug cable-modem interrupts command in privileged EXEC mode to debug cable
modem interrupts. The no form of this command turns debugging messages off.
[no] debug cable-modem interrupts
Syntax Description
This command has no keywords or arguments.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Examples
Figure 7 shows sample debug output for cable modem interrupts.
Use the debug cable-modem mac command in privileged EXEC mode to troubleshoot the cable
modem MAC layer. The no form of this command turns debugging messages off.
[no] debug cable-modem mac {log [verbose] | messages}
Syntax Description
logRealtime MAC log display.
verbose(Optional) Displays periodic MAC layer events, such as ranging.
messagesMAC layer management messages.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
debug cable-modem mac
Examples
Of all the available debug cable modem commands, the most useful is debug cable-modem mac
log.
Mac log messages are written to a circular log file even when debugging is not turned on. These
messages include timestamps, events, and information pertinent to these events. Enter the debug cable-modem mac log command to view Mac log messages. If you want to view this information
without entering debug mode, enter the show controllers cable-modem number mac log command.
The same information is displayed by both commands.
If the cable modem interface fails to come up or resets periodically, the Mac log will show what
happened. For example, if an address is not obtained from the DHCP server, an error is logged,
initialization starts over, and the cable modem scans for a downstream frequency. The debug cable-modem mac log command displays the log from oldest entry to newest entry.
After initial ranging is successful (dhcp_state has been reached), further
messages and watchdog timer entries are suppressed from output unless the verbose keyword is
used. Note that
using the verbose keyword.
Figure 8 shows sample display output from the debug cable-modem mac log command. The fields
of the output are the date, local time, seconds since bootup, the log message, and in some cases a
parameter that gives more detail about the log entry.
The line “
log entries were discarded due to a temporary lack of memory. This means the log is accurate and
reliable.
CMAC_LOG_WATCHDOG_TIMER entries while in the maintenance_state are normal when
0 events dropped due to lack of a chunk” at the end of a display indicates that no
RNG-REQ/RNG-RSP
Troubleshooting Tips for the Cisco uBR904 Cable Modem 55
Figure 9 compares the output of the debug cable-modem mac log command with the debug
cable-modem mac log verbose command. The verbose key word displays periodic events such as
ranging.
Figure 9Sample Debug Cable-Modem Mac Log and Verbose Output
uBR904# debug cable mac log
Cable Modem mac log debugging is on
uBR904#
uBR904#
uBR904# debug cable mac log verbose
Cable Modem mac log debugging is on (verbose)
uBR904#
574623.810 CMAC_LOG_RNG_REQ_TRANSMITTED
574623.812 CMAC_LOG_RNG_RSP_MSG_RCVD
574627.942 CMAC_LOG_WATCHDOG_TIMER
574633.880 CMAC_LOG_RNG_REQ_TRANSMITTED
574633.884 CMAC_LOG_RNG_RSP_MSG_RCVD
574643.950 CMAC_LOG_RNG_REQ_TRANSMITTED
574643.954 CMAC_LOG_RNG_RSP_MSG_RCVD
574654.022 CMAC_LOG_RNG_REQ_TRANSMITTED
574654.024 CMAC_LOG_RNG_RSP_MSG_RCVD
574657.978 CMAC_LOG_WATCHDOG_TIMER
574664.094 CMAC_LOG_RNG_REQ_TRANSMITTED
574664.096 CMAC_LOG_RNG_RSP_MSG_RCVD
574674.164 CMAC_LOG_RNG_REQ_TRANSMITTED
574674.166 CMAC_LOG_RNG_RSP_MSG_RCVD
uBR904# no debug cable mac log verbose
Cable Modem mac log debugging is off
uBR904#
574684.234 CMAC_LOG_RNG_REQ_TRANSMITTED
574684.238 CMAC_LOG_RNG_RSP_MSG_RCVD
Figure 10 shows display output for the debug cable mac messages command. This command causes
received cable MA C management messages to be displayed in a v erbose format. The message s that
are displayed are UCD, MAP, RNG-RSP , REG-RSP and UCC. In addition, transmitted REG-REQs
are displayed in hex dump format. The output from this command is very verbose and is usually not
needed for normal interface debugging. The command is most useful when attempting to attach a
cable modem to an uncertified CMTS. For a description of the displayed fields of each message,
refer to the MCNS DOCSIS RFI spec, v1.0.
Figure 10Sample Debug Cable-Modem Mac Messages Output
uBR904# debug cable mac messages
*Mar 7 01:44:06:
*Mar 7 01:44:06: UCD MESSAGE
*Mar 7 01:44:06: ----------*Mar 7 01:44:06: FRAME HEADER
*Mar 7 01:44:06: FC - 0xC2 == MAC Management
*Mar 7 01:44:06: MAC_PARM - 0x00
*Mar 7 01:44:06: LEN - 0xD3
*Mar 7 01:44:06: MAC MANAGEMENT MESSAGE HEADER
*Mar 7 01:44:06: DA - 01E0.2F00.0001
*Mar 7 01:44:06: SA - 00E0.1EA5.BB60
*Mar 7 01:44:06: msg LEN - C1
*Mar 7 01:44:06: DSAP - 0
*Mar 7 01:44:06: SSAP - 0
Troubleshooting Tips for the Cisco uBR904 Cable Modem 57
Page 58
Debug Commands
*Mar 7 01:44:06: control - 03
*Mar 7 01:44:06: version - 01
*Mar 7 01:44:06: type - 02 == UCD
*Mar 7 01:44:06: RSVD - 0
*Mar 7 01:44:06: US Channel ID - 1
*Mar 7 01:44:06: Configuration Change Count - 4
*Mar 7 01:44:06: Mini-Slot Size - 8
*Mar 7 01:44:06: DS Channel ID - 1
*Mar 7 01:44:06: Symbol Rate - 8
*Mar 7 01:44:06: Frequency - 20000000
*Mar 7 01:44:06: Preamble Pattern - CC CC CC CC CC CC CC CC CC CC CC CC CC
CC 0D 0D
*Mar 7 01:44:06: Burst Descriptor 0
*Mar 7 01:44:06: Interval Usage Code - 1
*Mar 7 01:44:06: Modulation Type - 1 == QPSK
*Mar 7 01:44:06: Differential Encoding - 2 == OFF
*Mar 7 01:44:06: Preamble Length - 64
*Mar 7 01:44:06: Preamble Value Offset - 56
*Mar 7 01:44:06: FEC Error Correction - 0
*Mar 7 01:44:06: FEC Codeword Info Bytes - 16
*Mar 7 01:44:06: Scrambler Seed - 0x0152
*Mar 7 01:44:06: Maximum Burst Size - 1
*Mar 7 01:44:06: Guard Time Size - 8
*Mar 7 01:44:06: Last Codeword Length - 1 == FIXED
*Mar 7 01:44:06: Scrambler on/off - 1 == ON
*Mar 7 01:44:06: Burst Descriptor 1
*Mar 7 01:44:06: Interval Usage Code - 3
*Mar 7 01:44:06: Modulation Type - 1 == QPSK
*Mar 7 01:44:06: Differential Encoding - 2 == OFF
*Mar 7 01:44:06: Preamble Length - 128
*Mar 7 01:44:06: Preamble Value Offset - 0
*Mar 7 01:44:06: FEC Error Correction - 5
*Mar 7 01:44:06: FEC Codeword Info Bytes - 34
*Mar 7 01:44:06: Scrambler Seed - 0x0152
*Mar 7 01:44:06: Maximum Burst Size - 0
*Mar 7 01:44:06: Guard Time Size - 48
*Mar 7 01:44:06: Last Codeword Length - 1 == FIXED
*Mar 7 01:44:06: Scrambler on/off - 1 == ON
*Mar 7 01:44:06: Burst Descriptor 2
*Mar 7 01:44:06: Interval Usage Code - 4
*Mar 7 01:44:06: Modulation Type - 1 == QPSK
*Mar 7 01:44:06: Differential Encoding - 2 == OFF
*Mar 7 01:44:06: Preamble Length - 128
*Mar 7 01:44:06: Preamble Value Offset - 0
*Mar 7 01:44:06: FEC Error Correction - 5
*Mar 7 01:44:06: FEC Codeword Info Bytes - 34
*Mar 7 01:44:06: Scrambler Seed - 0x0152
*Mar 7 01:44:06: Maximum Burst Size - 0
*Mar 7 01:44:06: Guard Time Size - 48
*Mar 7 01:44:06: Last Codeword Length - 1 == FIXED
*Mar 7 01:44:06: Scrambler on/off - 1 == ON
*Mar 7 01:44:06: Burst Descriptor 3
*Mar 7 01:44:06: Interval Usage Code - 5
*Mar 7 01:44:06: Modulation Type - 1 == QPSK
*Mar 7 01:44:06: Differential Encoding - 2 == OFF
*Mar 7 01:44:06: Preamble Length - 72
*Mar 7 01:44:06: Preamble Value Offset - 48
*Mar 7 01:44:06: FEC Error Correction - 5
*Mar 7 01:44:06: FEC Codeword Info Bytes - 75
*Mar 7 01:44:06: Scrambler Seed - 0x0152
*Mar 7 01:44:06: Maximum Burst Size - 0
*Mar 7 01:44:06: Guard Time Size - 8
*Mar 7 01:44:06: Last Codeword Length - 1 == FIXED
*Mar 7 01:44:06: Scrambler on/off - 1 == ON
*Mar 7 01:44:06:
Troubleshooting Tips for the Cisco uBR904 Cable Modem 59
Page 60
Debug Commands
debug cable-modem map
Use the debug cable-modem map command in privileged EXEC mode to display the timing from
MAP messages to sync messages and the timing between MAP messages. The no form of this
command disables debugging output.
[no] debug cable-modem map
Syntax Description
This command has no keywords or arguments.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3 NA.
Examples
Related Commands
Figure 11 shows display output for the debug cable map Privileged EXEC command.
Figure 11Sample Debug Cable-Modem Map Output
uBR904# debug cable-modem map
Cable Modem MAP debugging is on
uBR904#
*Mar 7 20:12:08: 595322.942: Min MAP to sync=72
*Mar 7 20:12:08: 595322.944: Max map to map time is 40
*Mar 7 20:12:08: 595322.982: Min MAP to sync=63
*Mar 7 20:12:08: 595323.110: Max map to map time is 41
*Mar 7 20:12:08: 595323.262: Min MAP to sync=59
*Mar 7 20:12:08: 595323.440: Max map to map time is 46
*Mar 7 20:12:09: 595323.872: Min MAP to sync=58