Point-to-Point Wireless Support for the Cisco uBR7200 Series Universal Broadband Router
This document describes how to configure point-to-point wireless support for the Cisco uBR7200 Series Universal Broadband Router, and includes the following sections:
The Cisco high-speed point-to-point broadband fixed wireless system provides a fixed, dedicated wireless link from one site to another. This link delivers full-duplex data in the licensed Microwave Multi-point Distribution System (MMDS) band (2.500 to 2.690 GHz), or Unlicensed National Information Infrastructure (U-NII) band (5.725 to 5.825 GHz).
The broadband fixed wireless system consists of a Cisco uBR7200 series universal broadband router (Cisco uBR7246 or Cisco uBR7223) and one or more wireless modem cards, each with a power feed panel and one or two wireless transverters.
Note The wireless transverter discussed in this document is manufactured and sold by Cisco for
MMDS links. Transverters for U-NII links must be purchased from third-party vendors. Refer to that
vendor's documentation for installation instructions.
The wireless modem cards are installed in a Cisco uBR7200 series router. Each modem card is cabled to a power feed panel installed either in the same equipment rack as the router or mounted on a wall. Cables from the power feed panel are attached to one or two wireless transverters, which are installed on antenna masts. The system is managed using a command-line interface (CLI) or CiscoView.
Wireless Modem Card
The wireless modem card provides:
The control and data interface between the system's digital motherboard and the radio frequency (RF) subsystem in the wireless transverter.
The up/down conversion from baseband to intermediate frequency (IF).
Wireless Transverter
The wireless transverter is the control and data interface to the indoor subsystems and provides up/down conversion from IF to RF frequencies and power amplification.
Benefits
The point-to-point wireless router system is a cost effective, high bandwidth access solution.
Related Documents
Cisco uBR7200 Series Universal Broadband Router Wireless Modem Card and Subsystem Installation and Configuration (Part Number 78-6030-01)
Supported Platforms
uBR7200
Supported Standards, MIBs, and RFCs
Standards
No new or modified standards are supported by this feature.
MIBs
No new or modified MIBs are supported by this feature.
RFCs
No new or modified RFCs are supported by this feature.
Prerequisites
Point-to-point wireless support
Configuration Tasks
See the following configuration tasks for the point-to-point wireless router system. Each task in the list indicates if the task is optional or required.
Configuring IF loopback (Optional)
Configuring RF loopback (Optional)
Configuring RF-to-RF link (Required)
Configuring IF Loopback (Optional)
An IF loopback confirms that the hardware is seated properly in the chassis and that the wireless modem card is functioning as expected.
Use the following commands to execute an IF loopback. These commands will shut down the radio link and initiate the IF loopback.
Step
Command
Purpose
1.
UBR1(config-if)# shut
Stops the interface.
2.
UBR1(config-if)# loopback local if
Starts the loopback.
3.
UBR1(config-if)# no shut
Restarts the interface.
Configuring RF Loopback (Optional)
An RF loopback confirms that the wiring to the transverter is correct, communication has been established, and that the transverter is operating correctly. (It does not test the duplexer, which is the final stage before the signal is sent to the antenna.) Because there is only one transmit path, the path to each transverter must be tested separately. Use the following commands:
Step
Command
Purpose
1.
UBR1(config-if)# shut
Stops the interface.
2.
UBR1(config-if)# loopback local rf main
Starts the loopback.
3.
UBR1(config-if)# loopback local rf diversity
Initiate a loopback to the diversity transverter if the loopback does not start and the Carrier and Out of Service LEDs do not light. Also, examine the data cable, the control cable, and the power supply for faults.
4.
UBR1(config-if)# no shut
Restarts the interface.
Configuring RF-to-RF Link (Over the Air)
The antenna-alignment command sends a voltage that is proportional to the received signal strength to the transverter.
Step
Command
Purpose
1.
UBR2(config-if)# no shut
Turns on the transmit signal from uBR2.
1.
UBR1(config-if)# shut
Stops the interface.
2.
UBR1(config-if)# radio antenna-alignment
Aligns the antenna on the uBR1.
3.
UBR1(config-if)# no shut
Restarts the interface.
4.
UBR1(config-if)# no shut
Turns on the transmit signal from the uBR1.
5.
UBR2(config-if)# shut
Stops the interface.
6.
UBR2(config-if)# radio antenna-alignment
Aligns the antenna on the uBR2.
7.
UBR2(config-if)# no shut
Restarts the interface.
8.
UBR1(config-if)# exit
Exits interface configuration mode.
9.
UBR1(config)# exit
Exits global configuration mode.
10.
UBR1# ping ip address
Tests the link on the uBR1.
11.
UBR2(config-if)# exit
Exits interface configuration mode.
12.
UBR2(config)# exit
Exits global configuration mode.
13.
UBR2# ping ip address
Tests the link on the uBR2.
Choosing Throughput Setting
Use the following steps to determine the best throughput settings. To help you choose the settings that will give you the most acceptable error performance, try the following procedures.
The simplified procedure:
Step
Command
Purpose
1.
UBR04(config-if) # radio channel-setup bandwidth 12.0 throughput low
Initiates the link using the low throughput setting
2.
UBR04 # clear radio interface radio slot/port link metrics
Clears the link-metrics counters.
3.
UUBR04 # show radio interface radio slot/port1second-metrics delta
UBR04 # show radio interface radioslot/portlink-metrics
Checks the error performance of the link.
4.
UBR1(config-if)# no shut
Restarts the interface.
5.
UBR1(config-if)# no shut
Turns on the transmit signal from the uBR1.
6.
UBR2(config-if)# shut
Stops the interface.
7.
UBR2(config-if)# radio antenna-alignment
Aligns antenna on the uBR2.
8.
UBR2(config-if)# no shut
Restarts the interface.
9.
UBR1(config-if)# exit
Exits interface configuration mode.
10.
UBR1(config)# exit
Exits global configuration mode.
11.
UBR1# ping ip address
Tests the link on the uBR1.
12.
UBR2(config-if)# exit
Exits interface configuration mode.
13.
UBR2(config)# exit
Exits global configuration mode.
14.
UBR2# ping ip address
Tests the link on the uBR2.
The expert procedure:
Step
Command
Purpose
1.
UBR04(config-if)# radio channel-setup bandwidth 12.0 throughput low
Initiates the link by using the low throughput setting.
2.
UBR04(config-if)# radio snapshot
Measures the multipath delay spread of the channel by examining the channel impulse response.
3.
UBR04(config-if)# radio histogram
Measures the signal-to-interference plus noise ratio (SINR) of the received signal by examining the constellation variance histogram.
Choose the throughput setting that is appropriate for the measured multipath delay spread and SINR. See the Cisco uBR7200 Series Universal Broadband Router Wireless Modem Card and Subsystem Installation and Configuration Guide for setting values.
4.
UBR04 # clear radio interface radio slot/port link metrics
Clears the link-metrics counters.
5.
UBR04 # show radio interface radio slot/port1second-metrics delta
UBR04 # show radio interface radioslot/portlink-metrics
Tests the accuracy of the selected throughput setting by checking the error performance of the link.
Verifying the Wireless Modem Card Configuration
Step 1 Enter the show running-configuration command in privileged EXEC mode to display the configuration currently in effect on the Cisco uBR7200 series router.
Step 2 Enter the show startup-configuration command in privileged EXEC mode to display the system startup configuration.
Step 3 If you reissue the show running-configuration command, the dual antenna IF loopback is selected. This is appropriate even if you are using a single antenna system.
Step 4 If you are using two antennas and problems occur with the dual antenna command, reissue the command specifying loopback local if main or loopback local if diversity to help isolate the problem.
Step 5 It may also be helpful to run a power-on self test (POST) once or perhaps every time the link is initiated. Enter the following commands to configure a self-test to run when the first no shut command is entered.
UBR1(config-if)# shut
UBR1(config-if)# radio self-test
UBR1(config-if)# no shut
Monitoring and Maintaining Point-to-Point Wireless Configurations
This section presents some useful show and debugging commands for understanding, maintaining, and troubleshooting your configuration.
Table 1 Debug and Show Commands for Maintaining and Troubleshooting Your Configuration
Command
Purpose
Router# show running-configuration interface radio number
Shows if the radio interface is operative.
Router# show call active voice
Shows statistics for currently active voice calls.
Router# show call active fax
Shows statistics for currently active fax calls.
Router# show call history voice
Shows statistics on previous voice calls.
Router# show call history fax
Shows statistics on previous fax calls.
Router# show voice port
Shows the status of voice ports.
Router# show controller E1 slot/port
Shows the status of the E1 controller.
Router# debug vpm all
Debugs the E1 signaling.
Router# debug vtsp all
Debugs the digits received and sent.
Router# debug voip ccapi inout
Debugs the call setup process.
The balance of this section shows the output of the commands listed in Table 1.
Show Commands
This section illustrates some of the privileged EXEC show commands that are useful for analyzing your system. Note that important information appears in bold, and bold text preceded by the "<<" characters explains the process.
Debug Commands
This section illustrates some of the EXEC mode debug commands that are useful when analyzing and troubleshooting your system. Note that important information appears in bold, and bold text preceded by the "<<" characters explains the process.
Configuration Examples
This section provides the following configuration examples:
See the following examples of the running configuration for the "master" end of a 6-MHz high-throughput link with a single antenna. In these examples, UBR1 and UBR2 refer to the two Cisco uBR7200 series routers used at the ends of the radio link. The wireless modem cards are assumed to be in slot 6 of each of the routers. The reference to radio 6/0 indicates that this interface occupies slot 6 and port 0.
The "slave" end of the link (UBR2) is configured in the same way except that the radio master command is omitted and the transmit and receive frequencies are reversed in the radio operating-band command.
UBR1# show running-configuration interface radio 6/0
Current configuration:
!
interface Radio6/0
ip address 10.0.0.1 255.255.255.0
radio master
radio receive-antennas 1
radio operating-band tx 2506.00 rx 2542.00
radio channel-setup bandwidth 6.0 throughput high
radio transmit-power 15
end
RF-to-RF Link
See the following example of an RF-to-RF link operating at 6 MHz/high, whichassumes that the IF cable-loss for uBR1 and uBR2 was determined to be 5 dB and 10 dB, respectively.
The configurations for both ends of the link are shown below.
uBR1 configuration:
UBR1# show running-configuration interface radio 6/0
Current configuration:
!
interface radio6/0
ip address 10.0.0.1 255.255.255.0
radio master
radio receive-antennas 1
radio operating-band tx 2506.00 rx 2542.00
radio channel-setup bandwidth 6.0 throughput high
radio transmit-power 30
radio cable-loss 1 5
end
uBR2 configuration:
UBR2# show running-configuration interface radio 6/0
Current configuration:
!
interface radio6/0
ip address 10.0.0.2 255.255.255.0
radio receive-antennas 1
radio operating-band tx 2542.00 rx 2506.00
radio channel-setup bandwidth 6.0 throughput high
radio transmit-power 30
radio cable-loss 1 10
end
Current Configuration
The following example shows the configuration currently in effect on the Cisco uBR7200 series router:
UBR04# show running-configuration
Building configuration...
Current configuration:
!
version 12.0
service udp-small-servers
service tcp-small-servers
!
hostname UBR04
!
enable password 1234FCX
!
username tech07
!
interface FastEthernet0/0
no ip address
no ip route-cache
shutdown
media-type MII
!
ip name-server 192.168.168.1
ip name-server 192.168.168.181
ip name-server 192.168.168.178
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
password 1234FCX
login local
!
interface BFWRadio3/0
radio master
radio channel-setup bandwidth 6.0 throughput medium
radio transmit-power 22
radio cable-loss 7
radio event-threshold ......
radio dsp-statistics .......
radio codec-statistics ......
!
end
Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications:
clear radio interface
loopback local
radio antenna-alignment
radio arq
radio byteErrorHist
radio cable-loss
radio channel-setup
radio duplexor
radio histdisplay
radio histogram
radio image-add
radio image-move
radio image-override
radio interface histclear
radio interface radio snapcapture
radio interface radio snapclear
radio interface radio timelinestart
radio interface radio timelinestop
radio led
radio master
radio metrics-threshold code-word
radio meterics-threshold 24hour
radio meterics-threshold 1hour
radio operating-band
radio privacy
radio receive-antennas
radio scope-output
radio self-test
radio snapshot
radio threshold
radio timeline
radio transmit-power
show controllers radio
show interfaces radio arq
show interfaces radio histdata
show interfaces radio histspec
show interfaces radio imagehdr
show interfaces radio scope-output
show interfaces radio snapdata
show interfaces radio snapshot
show interfaces radio thresholds
show interfaces radio tldata
show interfaces radio tlspec
show radio repository
shut
In Cisco IOS Release 12.0(1)T or later releases, you can search and filter the output for show and more commands. This functionality is useful when you need to sort through large amounts of output, or if you want to exclude output that you do not need to see.
To use this functionality, enter a show or more command followed by the "pipe" character (|), one of the keywords begin, include, or exclude, and an expression that you want to search or filter on:
command| {begin | include | exclude}regular-expression
See the following example of the show atm vc command where you want the command output to begin with the first line where the expression "PeakRate" appears:
show atm vc | begin PeakRate
For more information on the search and filter functionality, refer to the Cisco IOS Release 12.0(1)T feature module CLI String Search.
clear radio interface radio link-metrics
To clear link metrics settings, use the clear radio interface radio privileged EXEC command. To remove the loopback, use the no form of this command.
clear radio interface radio slot/port link-metrics
Syntax Description
slot/port
The slot and port address.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Example
By using the following command, you can clear all radio link-metrics details:
UBR04 # clear radio interface radio 6/0 link-metrics
loopback
To place the specified module in loopback mode, use the loopback interface configuration command. To remove the loopback, use the no form of this command.
loopback [local module]
no loopback [local module]
Syntax Description
local
(Optional) Specifics that the module is local.
module
Specifies the type of module: {codec | fir | if [diversity | dual | main] | rf [diversity | main]}
Defaults
Local IF loopback
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
12.0(7)XR
Support for the uBR7200 router and the local keyword was added.
Usage Guidelines
If you perform a loopback of the RF module while the transverter is attached to an antenna, some transmit power is radiated. Because of this, it is extremely important that you set the transmit frequency be set to your assigned and licensed MMDS frequency. If the transverter is not attached to an antenna, attach an RF termination device to the duplexer port. (For information regarding RF termination devices, refer to Cisco Broadband Fixed Wireless Site Planning Guide.)
Examples
See the following example which initiates a local RF loopback:
UBR04(config-if)# loopback local rf
The following example shows the set of loopbacks currently in effect for the modem card in slot 3, port 0 of the Cisco uBR7200 series router:
UBR04# show interfaces radio 3/0
Radio3/0 is up, line protocol is up (looped)
Hardware is CWR P2P
Internet address is 10.0.0.13/24
MTU 1500 bytes, BW 44419 Kbit, DLY 11000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation HDLC, loopback set
Keepalive set (10 sec)
Last input 00:00:01, output 00:00:01, output hang never
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
Related Commands
Command
Description
show interfaces radio
Displays the set of loopbacks currently in effect for the specified modem card.
radio antenna-alignment
To align the receive antenna to the transmitter, use the radio antenna-alignment interface configuration command. To cancel antenna alignment mode, use the no form of this command.
radio antenna-alignment no antenna-alignment
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
Do not use this command during normal operation; its use will degrade the performance of the radio link.
Examples
See the following example which initiates antenna alignment mode during installation:
UBR04(config-if)# radio antenna-alignment
Related Commands
Command
Description
show running-configuration interface
Displays the current interface settings.
radio arq
To configure the Automatic Repeat Query (ARQ) mechanism on the wireless modem card, use the radio arq interface configuration command. To use default values, use the no form of this command.
radio arq pctBw voiceLatency dataLatency [BurstSize] [on | off] [reset] no radio arq
Syntax Description
pctBw
Positive number representing the highest percentage of the link bandwidth to be used for the ARQ mechanism. The value can be 1 to 5000, representing 0.01 to 50 percent of the available bandwidth. The default value is 1250.
Note Regardless of the pctBw setting, link bandwidth is only consumed by ARQ when there are data errors that need to be corrected.
voiceLatency
Positive number specifying the expected latency value for voice. Latency values are measured in milliseconds. The default value is 11 ms.
dataLatency
Positive number specifying the expected latency value for normal data. Latency values are measured in milliseconds. The default value is 11 ms.
BurstSize
Positive number specifying the maximum number of consecutive ARQ codewords that will be transmitted. Small values result in less jitter. The default value is 16.
Defaults
11-ms latency
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
ARQ enables the transmitter to resend data that is received in error at the receiver. This allows the radio link to run at a substantially lower error rate in RF channels with rapid fading or bursty interference.
Enabling requires a small amount of additional overhead and increases the latency of the link. However, even with small maximum latency and maximum overhead settings, enabling ARQ can dramatically improve link performance.
Use the on/off option to turn on or off the ARQ feature on the link.(If ARQ is turned off, it may be difficult to establish the radio link in adverse environments.)
Use the reset option to reset the current ARQ values to consistent settings based on the channel-parameter configuration.
Examples
See the following command which sets the ARQ mechanism for 0.01% of the bandwidth, a 20-millisecond latency value, and 20 consecutive ARQ codewords:
UBR04(config-if)# radio arq 1 20 20
radio byteErrorHist
To specify the collection interval for the histogram for uncorrected codewords, and how often the collected histogram data is printed to the display screen, use the radio byteErrorHist interface configuration command.
To stop collecting and displaying histrogram data, use the no form of this command.
radio byteErrorHist [collectionIntervalinterval] [periodicinterval sum {true | false}]
no radio byteErrorHist [collectionIntervalinterval] [periodicinterval sum {true | false}]
Syntax Description
collectionInterval interval
Specifies, in seconds, the duration of histogram data collection.
periodic interval
Specifies, in seconds, how often the collected histogram data isprinted to the screen. The sum option specifies whether successive histogram sets retrieved from the hardware is added to replace the existing histogram data.
Use an interval of 0 to print the data to the screen only at termination of the collection.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Examples
See the following example which is entered to configure a collection interval of 1 hour and print to the screen every 30 seconds:
UBR04(config-if)# radio byteErrorHist collectionInterval 3600 periodic 30 sum false
radio cable-loss
To determine the effective cable loss (measured in dB at 400 MHz) of the cable between the wireless modem card and the specified wireless transverter, including the power feed panel, connectors, and lightning protection, use the radio cable-loss interface configuration command. To stop measuring cable loss, use the no form of this command.
radio cable-loss antenna_num positive number
no radio cable-loss
Syntax Description
antenna_num
Enter 1 (main antenna) or 2 (diversity antenna).
positive number
Positive number (less than or equal to 12 dB), reflecting effective cable loss.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
Do not set the cable loss parameter to a value greater than 12 dB. The exact cable loss value is determined by the transverter. The system checks against that value when you enter the a no shut command.
Examples
The following example adjusts the effective cable loss parameter for antenna 1 to 12 dB:
UBR04(config-if)# radio cable-loss 1 12
Related Commands
Command
Description
show running-configuration interface radio
Displays the current radio cable loss setting.
radio channel-setup
To adjust bandwidth and throughput to increase the reliability of the link, use the radio channel-setup interface configuration command. To reset the parameters to their default values, use the no form of this command.
radio channel-setup bandwidth bw throughput dataThroughput {high | medium | low}
no radio channel-setup
Syntax Description
bw
{6.0 | 12.0}
dataThroughput
{high | medium | low}
high (default)
At 12 MHz, maximum 44.4 Mbps At 6 MHz, maximum 22.2 Mbps
medium
At 12 MHz, maximum 39.1 Mbps At 6 MHz, maximum 19.6 Mbps
low
At 12 MHz, maximum 22.4 Mbps At 6 MHz, maximum 11.2 Mbps
Defaults
Bandwidth 6.0, throughput high
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
Multipath delay spread is one of two fundamental limits to the performance of a digital radio link. The other limit is the Signal to Interference plus Noise ratio (SINR) which is described in Cisco uBR7200 Series Universal Broadband Router Wireless Modem Card and Subsystem Installation and Configuration Guide.
Multipath delay spread occurs when the signal arrives at the receiver through multiple paths with differing path lengths. Signals that take long paths arrive later than signals that take shorter paths. The delay spread is the difference between the time it takes for the shortest path signal and the longest path signal to arrive. Typically, delay spread is the longest in urban areas with many buildings acting as reflectors. Delay spread is more important when the direct path between antennas is blocked, making the delayed signals stronger relative to the direct signal.
Both 6 MHz and 12 MHz bandwidths are available. For each of these bandwidths, there are three possible throughput setting: high, medium, and low.
The low setting uses the most error-correction coding and can handle the most multipath delay spread.
The medium setting uses less error-correction coding, but can still handle the most multipath delay spread.
The high setting uses less error-correction coding and can handle less multipath delay spread. For a selected bandwidth, data throughput can be reduced to increase reliability.
Enter this command at any time. If the link is up when you enter the command, it takes effect with the next shut/no shut. If the link is down when you enter the command, it takes effect with the next no shut.
Related Commands
Command
Description
shut
Stops the link (if it is up). no shut starts the link and implements any bandwidth changes.
show running-configuration interface radio
Displays the current settings.
radio duplexor
To enter duplexer specifications, use the radio duplexor interface configuration command.
Enter 1 (main antenna) or 2 (diversity antenna). Identifies the antenna to which the duplexer is connected.
PartNum
A string representing the duplexer's Cisco part number.
LoPassbandRange
Identifies the duplexer's low-frequency range. This range is lower than the range specified in the HiPassbandRange parameter.
HiPassbandRange
Identifies the duplexer's high-frequency range. This range is higher than the range specified in the LoPassbandRange parameter.
RxPassband
Identifies the frequency range used to receive transmissions.
CLEIcode
Common Language Equipment Identifier code.
VendorName
The name of the vendor of the duplexer.
SerialNumber
Serial number of the duplexer.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The duplexer is a mechanical device that acts as a band pass filter when installed in the wireless transverter. This filter restricts the transverter to operate in a specified part of the frequency spectrum. One duplexer provides a high- and low-frequency specification for one wireless transverter.
You can find most of the information on the tear-off label attached to the underside of the duplexor.
radio histdisplay
To control the printing of radio histogram information to the screen, use the radio histdisplay interface configuration command.
radio histdisplay statParam antenna_num [dsp dspId] {on | off}
Configures a histogram collection of radio traffic on the specified interface.
radio interface histclear
Removes radio histograms.
radio histogram
To configure a histogram collection specification, use the radio histogram interface configuration command. To delete existing histogram collections, use the no form of this command.
radio histogram statParam antenna_num[dsp dspId] StartBinValue BinDelta NumBins BitShift [collectionInterval interval] [periodicinterval sum {true | false}] [tone circulate | average | number tone-number]
no radio histogram statParam antenna_num [dsp dspId]
The data for the radio attribute is collected as a histogram.
in
(Interference + Noise) The interference plus noise power levels are computed by the hardware on a burst-by-burst basis.
inr
(Interference + Noise Ratio) The ratio of the interference plus noise power levels captured by the first antenna to the second antenna on a burst-by-burst basis. This value is specified as a log to base 2 number.
Note This parameter is available for a dual antenna system only.
constVariance
(Constellation Variance) The average energy of the constellation error signal - the error between the received (noisy) constellation symbol and the nearest ideal constellation symbol. Constellation Variance is a measure of the SINR for that tone. On a single antenna system, Constellation Varience is proportional to (SINR)-1. On a dual antenna system, it represents a composite value that is proportional to (SINR)-1.
timingOffset
Represents the timing delay variations detected in the radio link.
freqOffset
Represents the carrier frequency offset between the slave radio and the master radio.
syncStatus
Represents the synchronization status.
receivedPower
A measure of the analog signal power received by the radio system on a burst-by-burst basis.
gainSettingsIF
Represents the IF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the intermediate frequency (IF) module.
gainSettingsRF
Represents the RF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the radio frequency (RF) module.
totalGain
Represents the total attenuation commanded by the automatic gain control loop. This can be captured for each antenna.
Any value below this value is not stored in the histogram. Range is -231 to 232-1.
BinDelta
The "width" of each histogram bin. For example, if the StartBinValue is 10 and BinDelta is 64, then all values in the range 10 to 74 will be in the first bin. All values from 75 to 138 will be in the second bin, and so on. Range is 2 to 2^32 and must be a power of 2.
NumBins
The number of histogram bins to be configured for the collection. Range is 0 to 508.
BitShift
Specifies the number of bits by which the collected data is shifted to the right, providing a mechanism to control overflow of the values in the histogram. Range is 0 to 31.
collectionInterval
Specifies, in seconds, the interval in which histogram data will be collected.
periodic
Specifies, in seconds, how often the collected histogram data is printed to the screen. The sum option specifies whether successive histogram sets retrieved from the hardware are added to replace the existing histogram data.
Specifying a statistic collection to be periodic effectively reduces the size of the NumBins to half the possible amounts. The default is periodic. If the interval is 0, output is generated only at the termination of the collection.
tone
Identifies how the histogram sample is computed when sampling a burst. A burst contains data samples from N frequency tones.
circulate
Implies successive histogram data samples use successive frequency tones.
average
Implies successive histogram samples average the burst data over all the frequencies and use that value.
number
Specifies that a particular tone in the burst is used to report the histogram data. The frequency tone is passed in as a number specified in the tone-number parameter.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
A histogram is a collection of statistics sampled over time on a burst-by-burst basis and presented as a function of Bins. The number of Bins as well as the size of Bins is user defined.
The data for the histogram is collected as soon as the command succeeds and continues until either the specification is deleted using the no option, or the specified collectionInterval expires. The collected data is printed out to the console at user-specified intervals.
A histogram statistic is created when data is sampled for every burst. For each sampled burst, the count in a specific bin is incremented. The number of Bins in the histogram is specified by the NumBins parameter.
For every histogram defined, antenna_num and tone are conditional. The antenna_num is required for the attributes in, receivedPower, GainSettingsIF, gainSettingsRF, and totalGain. Optionally, You may specify Tone for the attributes in, inr, and constVariance.
Note There should be no measurable impact or degradation of router performance from running
histograms. Cisco recommends that you keep the number of histograms run simultaneously to a
minimum and that you terminate any histograms no longer needed.
Up to 1024 32-bit words are available for all histogram parameters on a single DSP. Each histogram requires (NumBins + 4) * 2 words. The attributes in in, inr, and constVariance can be captured on any DSP while the others can be captured only on certain DSPs. Distributing histogram requests across DSPs provides better memory utilization. In general, it is best not to specify the DSPs without special knowledge of the system.
For more information on DSPs, see Cisco uBR7200 Series Universal Broadband Router Wireless Modem Card and Subsystem Installation and Configuration Guide.
Examples
See the following example which configures a histogram specification. The histogram collection starts as soon as the command succeeds and collects a histogram for interference noise ratio. The histogram is collected with starting Bin of 2-4 (a starting ratio of 0.0625), bindelta of 1, 32 bins in total, and no bitshift. Then the results are averaged on all frequency tones for each sample. The collection continues for 1 hour, reports data every 30 seconds, and keeps the cumulative histogram.
UBR04(config-if)# radio histogram inr -4 1 32 0 collectionInterval 3600 periodic 30 tone average sum true
Related Commands
Command
Description
radio histdisplay
Displays radio histograms.
radio interface histclear
Removes radio histograms.
radio image-add
To add the specified image to the image repository, use the radio image-add privileged EXEC command. To delete the specified image from the repository, use the no form of this command.
radio image-add protocol://host/directory/filename
no radio image-add protocol://host/directory/filename
Syntax Description
protocol
{mem| tftp | flash}
host
IP address.
directory
Directory name. (No embedded spaces accepted.)
filename
Name of image file.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When an image has to be downloaded according to the specified configuration, the repository is searched for an appropriate file. If found, the file is retrieved and downloaded to the hardware.
Examples
See the following commands selects the image dspla.img at the address 192.168.33.44 to be added to the repository:
UBR04# radio image-add tftp://192.168.33.44/myDspImages/dspla.img
Related Commands
Command
Description
radio image-move
Moves the specified image to the beginning of the repository.
radio image-override
Attaches the specified image file name to the specified chip.
show radio repository
Displays the repository contents.
radio image-move
To move the specified image to the beginning of the repository list of images, use the radio image-move privileged EXEC command.
radio image-move protocol://host/directory/filename
Syntax Description
protocol
{mem| tftp | flash}
host
IP address.
directory
Directory name. (No embedded spaces accepted.)
filename
Name of image file.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When the radio card is initiated (no shut), the repository is searched for a firmware image with characteristics matching the current configuration. Once found, that image is downloaded. Moving an image to the beginning of the list ensures that the image is searched first when a configuration match is attempted.
Examples
See the following example which selects the image dspla.img at the address 192.168.33.44 to be moved to the start of the repository list:
UBR04# radio image-move tftp://192.168.33.44/myDspImages/dspla.img
Related Commands
Command
Description
radio image-add
Adds the specified image to the repository.
radio image-override
Attaches the specified image file name to the specified chip.
show radio repository
Displays the repository contents.
radio image-override
To attach the specified image file name to the specified chip, use the radio image-override interface configuration command. To remove the override, use the no form of this command.
radio image-override chipname image
no radio image-override chipname image
Syntax Description
chipname
Specifies the name of a chip.
image
Specifies the location of the image file in the form: protocol://host/directory/filename, where: protocol is mem(ory), tftp, or flash host is the IP address of the host machine directory is the name of the directory filename is the name of the image file
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When an image is to be downloaded to the specified chip for which an image override is in place, the configuration logic is ignored and the override attached file is downloaded instead.
Note When specifying the directory name for the image file, do not use embedded spaces.
Related Commands
Command
Description
radio image-add
Creates a radio image.
radio image-move
Moves the specified image to the beginning of the repository.
show radio repository
Displays the repository contents.
radio interface histclear
To clear collected radio histogram data, use the radio interface histclear interface configuration command.
radio interface slot/port histclear statParam antenna_num [dsp dspId]
The radio attribute whose data is to be collected as a histogram.
antenna_num
Enter 1 (main antenna) or 2 (diversity antenna).
dspnum
The DSP number.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Related Commands
Command
Description
radio timeline
Configures a timeline collection specification.
radio interface radio timelineStart
Starts a stopped timeline specification.
show interfaces radio tldata
Displays timeline data for the specified card.
show interfaces radio tlspec
Displays the details of the timeline specification.
radio led
To manually highlight specific conditions on a specified wireless modem card using the five LEDs on the card, use the radio led interface configuration command. To reset the settings of the LED to the default values, use the no form of this command.
radio led {latchLeds latchLedOptions | otherLeds otherLedOptions}
no radio led latchLeds
Syntax Description
latchLeds
{led-major-alarm | led-minor-alarm}
led-major-alarm
Indicates the occurrence of a major alarm in the radio subsystem. Unless you override the default mode, the LED remains illuminated for the duration of the alarm.
led-minor-alarm
Indicates the occurrence of a minor alarm in the radio subsystem. Unless you override the default mode, the LED remains illuminated for the duration of the alarm.
latchLedOptions
{latch | off | green | yellow | blinkGreen | blinkYellow | blinkBoth}
latch
The system turns the LED on indicating an alarm condition; the operator must turn off the alarm by entering the radio ledlatchLedslatch command.
Note The latch option is available only for led-major-alarm and led-minor-alarm.
off
This forces the LED to turn off and remain off under all conditions.
green
Lamp test for the LED. The LED turns green and remains green under all conditions.
yellow
Lamp test for the LED. The LED turns yellow and remains yellow under all conditions.
blinkGreen
The green LED blinks.
blinkYellow
The yellow LED blinks.
blinkBoth
Alternately blinks the LED yellow and green.
otherLeds
{led-carrier | led-service | led-ok}
led-carrier
Represents the state of the radio link. This LED cannot be latched, but the operator can turn these LEDs on or off manually.
led-service
Indicates the service availability on this radio link. This LED cannot be latched, but the operator can turn these LEDs on or off manually. This LED is operator-controlled only.
led-ok
Indicates that the wireless modem card is on, is receiving from the router midplane, and is enabled for operation. This LED remains on during normal operation of the router.
There are three categories of LEDs: alarm, user-controlled, and other LEDs. The two alarm LEDs normally remain illuminated only for the duration of the alarm. However, you can override this condition using the latch form of the command whichcauses the LEDs to remain illuminated until you enter the latch form of the command to clear the LEDs.
The led-service LED can only be controlled by entering an LED command. All the LEDs can be forced to illuminate or blink under operator control. This can be used as a "lamp test" to verify that the hardware is functional or to remotely indicate a specific wireless modem card to be examined.
Examples
See the following example which sets the behavior of the major alarm LED to be controlled by the system at all times:
UBR04(config-if)# no radio led led-major-alarm
Related Commands
Command
Description
show interfaces radio
Displays the current configuration and state of the LEDs.
radio master
To configure the wireless modem card to operate as the master radio, use the radio master interface configuration command. To force the radio card to operate as the slave, use the no form of this command.
radio master [external-clock-reference]
no radio master
Syntax Description
external clock-reference
Option. Indicates that an external reference is being used. In slave mode, the default is automatically set to internal clock reference.
Defaults
Slave mode
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The master radio acts as the frequency source; the radio designated as the slave tracks changes in the master's frequency.
Note To avoid unpredictable results, designate one end of the link as "master."
Ehter this command only when the radio link is down (shut), and takes effect only when the link is again active (no shut). Use the no version of the command to switch the modem card from master to slave mode.
Note Configure the center frequency of both master and slave by using the appropriate operating
band and channel parameters commands.
Examples
See the following example which configures the wireless modem card to operate as the master radio with internal clock reference:
UBR04(config-if)# radio master
Related Commands
Command
Description
show running-configuration interface radio
Displays the current setting.
radio metrics-threshold code-word
To configure thresholds that determine when a second is classified as ES, DS, SES, or CSES for the radio link to measure how well the radio link is performing over time, use the radio metrics-threshold code-word interface configuration command. To force the thresholds back to the default values, use the no form of this command.
radio metrics-threshold code-word ESThresh DSThresh SESThresh CSESThresh
no radio metrics-threshold code-word
Syntax Description
ESThresh
Specifies the number of codeword errors that must be detected within a 1-second interval for that second to be treated as an Errored Second. Typically, ESThresh = 1.
DSThresh
If the number of codeword errors detected within 1 second is greater than or equal to this threshold and less than SESThresh, that second is treated as a Degraded Second.
SESThresh
If the number of codeword errors detected within a 1-second interval is greater than or equal to this threshold, that second is treated as a Severely Errored Second.
CSESThresh
Specifies the number of consecutive severely errored seconds that must be detected for the sequence to be treated as one consecutively Severely Errored Second.
Defaults
TBC
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When the radio link is synchronized, the measurement parameters used are:
error free seconds (EFS).
errored seconds (ES).
severely errored seconds (SES).
consecutively errored seconds (CSES).
degraded seconds (DS).
degraded minutes (DM).
All link metrics are measured in terms of codewords which are in units (228 bytes) of data transmission over the radio link. Each unit contains user data, error counts, and collation information so that successive codewords are reconstructed at the receiving end into the transmitted data.
Use this command with care. Arbitrary changes will distort the performance metrics reported for the radio link.
Examples
See the following example which configures the link so that:
If more than 3 codeword errors are detected in a given second, that second is treated as an errored second.
If the number of errors detected in one second is between 30 and 150, that second is flagged as a degraded second.
If more than 150 errors are detected in one second, that second is flagged as a severely errored second.
If more than 4 severely errored seconds are detected in sequence, that sequence is flagged as 1 consecutively severely errored second.
UBR04(config-if)# radio metrics-threshold code-word 3 30 150 4
Related Commands
Command
Description
show interfaces radio slot/port metrics-threshold
Shows the thresholds set for link metrics.
radio metrics-threshold 1hour
Displays the link metrics for a one-hour period.
radio metrics-threshold 24hour
Displays the link metrics for a twenty-four hour period.
radio metrics-threshold 24hour
To set threshold values that configure limits on the ES, SES, CSES, and DM to measure how well the radio link is performing over a 24-hour period, use the radio metrics-threshold 24hour interface configuration command. To force the thresholds back to the default values, use the no form of this command.
radio metrics-threshold 24hour ESLimit SESLimit CSESLimit DMLimit
no radio metrics-threshold 24hour
Syntax Description
ESLimit
Specifies the number of errored seconds that are detected within the specified time period (24 operational hours) after which the ESLimit minor alarm is generated.
SESLimit
Specifies the number of codeword severely errored seconds that are detected within the specified time period 24 operational hours) after which the SESLimit minor alarm is generated.
CSESLimit
Specifies the number of codeword consecutively severely errored seconds that are detected within the specified time period (24 operational hours) after which the CSESLimit minor alarm are generated.
DMLimit
Specifies the number of codeword degraded minutes that is detected within the specified period (24 operational hours) after which the DMLimit minor error alarm are generated.
Defaults
TBC
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When the radio link is synchronized, the measurement parameters used are:
error free seconds (EFS).
errored seconds (ES).
severely errored seconds (SES).
consecutively errored seconds (CSES).
degraded seconds (DS).
degraded minutes (DM).
When these limits are exceeded in a 24-hour period, alarms are generated to notify the user. Minor alarms appear on the console when the specified 24-hour threshold is exceeded.
Use this command with care. Arbitrary changes distort the performance metrics reported for the radio link.
Examples
See the following example which configures the link alarms so that:
If the link has 24 errored seconds in one day, an alarm are generated.
If the link has errored severly more than 1% of the time in one day, an alarm is generated.
If the link has more than 12 consecutive severely errored second events in one day, an alarm is generated.
If the link has more than 5 degraded minutes in one hour, an alarm is generated.
UBR04(config-if)# radio metrics-threshold 24hour 24 36 12 5
Related Commands
Command
Description
show interfaces radio slot/port metrics-threshold
Shows the thresholds set for link metrics.
radio metrics-threshold code-word
Configures thresholds that determine when a second is classified as ES, DS, SES, or CSES for the radio link.
radio metrics-threshold 1hour
Displays the link metrics for the past one-hour period.
radio metrics-threshold 1hour
To to configure limits on the ES, SES, CSES, and Degraded Minutes (DM), use the radio metrics-threshold 1hour interface configuration command. To force the thresholds back to the default values, use the no form of this command.
radio metrics-threshold 1hour ESLimit SESLimit CSESLimit DMLimit
no radio metrics-threshold
Syntax Description
ESLimit
Specifies the number of errored seconds that are detected within the specified time period (1 operational hour) after which the ESLimit minor alarm is generated.
SESLimit
Specifies the number of codeword severely errored seconds that are detected within the specified time period (1 operational hour) after which the SESLimit minor alarm is generated.
CSESLimit
Specifies the number of codeword consecutively severely errored seconds that are detected within the specified time period (1 operational hour) after which the CSESLimit minor alarm is generated.
DMLimit
Specifies the number of codeword degraded minutes that are detected within the specified period (1 operational hour) after which the DMLimit minor error alarm is generated.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When the radio link is synchronized, the measurement parameters used are:
error free seconds (EFS).
errored seconds (ES).
severely errored seconds (SES).
consecutively errored seconds (CSES).
degraded seconds (DS), and degraded minutes (DM).
When these limits are exceeded in a 1-hour period, alarms are generated to notify the user. Minor alarms are displayed on the console when the specified 1-hour threshold is exceeded.
Use this command with care. Arbitrary changes distort the performance metrics reported for the radio link.
Examples
See the following example which configures the link alarms so that:
If the link has 6 errored seconds in one hour, an alarm is generated.
If the link detects 10 severely errored seconds in one hour, an alarm is generated.
If the link has more than 3 consecutive severely errored second events in one hour, an alarm is generated.
If the link has more than 2 degraded minutes, an alarm is generated.
UBR04(config-if)# radio metrics-threshold 1hour 6 10 3 2
Related Commands
Command
Description
show interfaces radio slot/port metrics-threshold
Shows the thresholds set for link metrics.
radio metrics-threshold code-word
Configures thresholds that determine when a second is classified as ES, DS, SES, or CSES for the radio link.
radio metrics-threshold 24hours
Displays the link metrics for the past 24 hour period.
radio operating-band
To specify the radio operating band and transmit/receive frequencies within the radio operating band, use the radio operating-band interface configuration command. To reset the operating band to the default values, use the no form of this command.
radio operating-band Tx transmit frequencyRxreceive frequency
no radio operating-band
Syntax Description
transmit frequency
Positive number in the range 2500.00 MHz to 2690.00 MHz (MMDS), or 5725.00 MHz to 5825.00 MHz (U-NII)
receive frequency
Positive number in the range 2500.00 MHz to 2690.00 MHz (MMDS), or 5725.00 MHz to 5825.00 MHz (U-NII)
Defaults
TBC
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
You can enter this command at any time. If the link is up when you enter the command, the command takes effect with the next shut/no shut. If the link is down when you enter the command, the command takes effect with the next no shut.
Use the channel-setup parameters to select the required bandwidth and data throughput beforespecifying the operating-band.
Transmit and receive frequencies must be consistent with the bandwidth the radio has been configured to operate in using the channel-setup command and must fall within the passband of the duplexer used in the transverter.
See the Cisco uBR7200 Series Universal Broadband Router Wireless Modem Card and Subsystem Installation and Configuration Guide for center frequencies for the MMDS band and center frequencies for the U-NII band.
For a complete list of channel designations and start, center, and end frequencies, see the Cisco Broadband Fixed Wireless Site Planning Guide.
The transmit frequency on the radio designated as "master" must be identical to the receive frequency on the radio designated as "slave."
Note To operate in the MMDS band, you must be licensed to use that part of the spectrum. No
license is required in the U.S. to operate in the U-NII band.
Examples
See the following example to set center frequencies in the MMDS band:
UBR04(config-if)# radio operating-band Tx 2533.00 Rx 2599.00
Related Commands
Command
Description
show running-configuration interface radio
Displays the current setting.
radio privacy
To configure the baseline encryption options provided by the wireless modem card, use the radio privacy interface configuration command. To turn off privacy options, use the no form of this command.
The number of seconds the slave radio waits before issuing a new authorization request to the master radio.
reauth-wait-time
The number of seconds the slave radio waits before issuing a new reauthorization request to the master.
auth-grace-time
Grace time for an authorization key. The slave radio tries to get a new authorization key beginning auth-grace-time seconds before the authorization key actually expires.
op-wait-time
Operational wait timeout.
rekey-wait-time
The amount of time (in seconds) that the slave radio waits before issuing a new request to the master radio for an encryption key.
tek-grace-time
Grace time for a traffic encryption key (TEK). The slave radio tries to get a new TEK beginning tek-grace-time seconds before the traffic encryption key actually expires.
auth-lifetime
The lifetime (in seconds) the master radio assigns to an authorization key for the slave radio.
tek-lifetime
The lifetime (in seconds) assigned to traffic encryption keys by the master radio.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The radio designated as "master" controls privacy authorization and encryption key distribution. The radio designated as "slave" tracks the master radio's signals. The default is on.
Use the enable option to enable baseline privacy options. Use the other options to configure timeout values. When privacy is enabled, the timeout values determine how long the master or the slave radio waits for either authentication or encryption keys to be revalidated. If this revalidation fails, meaningful communication between master and slave radios is not possible.
Note Using baseline privacy has no effect on throughput and only a negligible effect on latency.
Note You can only change these parameters when the radio link is down (shut).
Examples
By using the following command you can configure baseline privacy:
UBR04(config-if)# radio privacy enable
Related Commands
Command
Description
show running-configuration
Displays the current settings.
radio receive-antennas
To configure the wireless modem card to use a specified number of receive antennas, use the radio receive-antennas interface configuration command. To disable reception, use the no form of this command.
radio receive-antennas {1 | 2}
no radio receive-antennas
Syntax Description
1 | 2
Specifies which antenna to use. Enter 1 (main antenna) or 2 (diversity antenna).
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
You can enter this command only when the radio link is down (shut). The command takes effect when the link is again active (no shut). Use the no version of the command to set the number of receive antennas to 1 (the default value).
Note Before this command can take effect, the receive antennas and wireless transverters must be
available.
Examples
See the following example which configures the wireless modem card to use two receive antennas:
UBR04(config-if)# radio receive-antennas 2
Related Commands
Command
Description
show running-configuration interface radio>
Displays the current setting.
radio scope-output
To configure a single DSP to send the identified type of output to the serial port, use the radio scope-output privileged EXEC command. To to turn off the serial output, use the no form of this command.
An oscilloscope can be connected to the serial port to analyze the output of the DSP.
You can gather the output of only one DSP at a time.
Example
See the following example which sends an output of type rx-timedomainchannel-ant2-h2n to the serial port:
UBR04# radio scope-output dsprx1a RxTimeDomainChannelAnt2H2n
Related Commands
Command
Description
show interfaces radio slot/port scope-output
Displays the attribute being directed to the scope port.
radio self-test
To test the memory and hardware integrity of the wireless modem card, use the radio self-test interface configuration command. To configure a restart of the link without executing self-tests, use the no form of this command.
radio self-test [enable]
no radio self-test
Syntax Description
enable
(Optional) causes execution of self-tests each time the card is initiated.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
Use the enable option to execute self-tests each time the card is initiated (no shut). Use the command without the enable option to perform a self-test only on the first no shut after initiation. Each time the test is performed, the results appear on the console.
Example
See the following example which shows the configuration command used to download and execute self-tests each time the modem card is enabled:
UBR04(config-if)# radio self-test enable
Related Commands
Command
Description
show running-configuration interface radio
Displays the current settings.
radio snapshot
To to create a snapshot specification on the modem card, use the radio snapshot privileged configuration command. To delete a specification and its associated data, use the no form of this command.
Unsigned number. You can request up to four different snapshot types at once. When you request more than one snapshot is in a command, all snapshots are captured from the same DSP. See the snapshot type definitions below.
rx-rawburst-ant1-y1n (0x01)
Represents a snapshot of the received signal for RF resource 1. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-rawburst-ant2-y2n (0x02)
Represents a snapshot of the received signal for RF resource 2. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-spectrum-ant1-y1k (0x04)
Represents a snapshot of the spectrum of the received signal for RF resource 1. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-spectrum-ant2-y2k (0x08)
Represents a snapshot of the spectrum of the received signal for RF resource 2. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-timedomainchannel-ant1-halon (0x10)
Represents a snapshot of the time domain channel for RF resource 1. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-timedomainchannel-ant2-h2n (0x20)
Represents a snapshot of the time domain channel for RF resource 2. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-freqdomainchannel-ant1-hlk (0x40)
Represents a snapshot of the frequency domain channel for RF resource 1. For every sample, the real and imaginary components are captured. Units (I, q) Value: 32-bit quantities
rx-freqdomainchannel-ant2-h2k (0x80)
Represents a snapshot of the frequency domain channel for RF resource 2. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
rx-constellation-zhatk (0x100)
Represents a snapshot of the soft decisions. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
tx-codec-input (0x200)
Represents a snapshot of input values to the Tx Code. Units: Real values Value: 32-bit quantities
tx-ifft-input (0x400)
Represents a snapshot of the IFFT signal for the transmitted data. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
tx-round-output (0x800)
Represents a snapshot of the Rounded Constellation signal for the transmitted data. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
sync-burst-timecost-func (0x1000)
Represents the timing cost function for Sync bursts. Units: Real Values Value: 32-bit quantities
sync-freq-offset-costfunc (0x2000)
Represents a snapshot of the frequency offsets. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
sync-pwrsbtcffocf (0x4000)
Represents a snapshot of Sync power burst. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
sync-fll-freq-correlation (0x8000)
Represents a snapshot of Frequency correlation. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32 bit quantities
sync-fll-train-tone-correlation (0x10000)
Represents a snapshot of Frequency locked loops, Training tone correlation. For every sample, the real and imaginary components are captured. Units (I, q) Value: 32-bit quantities
sync-fll-fft-spectrum (0x20000)
Represents a snapshot of Frequency locked loop, FFT Spectrum. For every sample, the real and imaginary components are captured. Units: (I, q) Value: 32-bit quantities
Defaults
No default behavior or values.
Command Modes
Privileged configuration (TBC)
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
A snapshot is a specified amount of data captured from the wireless modem card.
When you issue a snapshot request, up to four simultaneous radio signal attributes can be captured. The four attributes are specified by adding the attribute numbers for up to four of the snapshot types identified below.
Note TDo not mix the Tx and Rx types. You can mix Rx and Sync types. When a radio snapshot
command is issued, you can request up to four signal attributes at once; one from each set.
Type
Set1
Set2
Set3
Set4
Rx
y1n(x1)
y2n(x2)
y2k(x8)
y1k(x4)
h2k(x80)
h1k(x40)
h1n(x10)
h2n(x20)
-
-
zhat(x100)
-
Sync
-
FreqCorr(x8000)
FreqOffCF(x2000) (*)
BrstTimeCF(x1000) (**)
-
FLL_FFT_Sp(x20000)
-
TT_FCorr(x10000)
Tx
CodecIn(x200)
IFFTIn(x400)
-
RoundOut(x800)
* FreqOffCF cannot be mixed with Set1.
** BrstTimeCF cannot be mixed with Set2.
Related Commands
Command
Description
show interfaces radio snapshot
Displays configured snapshot information.
show interfaces radio snapdata
Displays the data captured for the snapshot specification
radio interface radio snapcapture
Creates a snapshot on the specified DSP.
radio interface radio snapclear
Clears the snapshot data on the specified DSP.
radio threshold
To configure a threshold event specification, use the radio threshold interface configuration command. To terminate the event-threshold setup, use the no form of this command.
radio threshold threshParamantennaNum [dsp dspId] threshType threshValue repeatTime clearTime
no radio threshold threshParamantennaNum [dsp dspId] threshType
(Interference + Noise) The interference plus noise power levels are computed by the hardware on a burst-by-burst basis.
Note This parameter is available for a dual antenna system only.
inr
(Interference + Noise Ratio) The ratio of the interference plus noise power levels captured by the first antenna to the second antenna on a burst-by-burst basis. This value is specified as a log to base 2 number.
constVariance
(Constellation Variance) The average energy of the constellation error signal - the error between the received (noisy) constellation symbol and the nearest ideal constellation symbol. Constellation Variance is a measure of the Signal to Interference plus Noise ratio (SINR) for that tone. On a single antenna system, it represents (SINR)-1. On a dual antenna system, it represents a composite value providing (SINR)-1 after antenna combining.
timingOffset
Represents the timing delay variations detected in the radio link.
freqOffset
Represents the carrier frequency offset between the slave radio and the master radio.
syncStatus
Represents the synchronization status.
receivedPower
A measure of the analog signal power received by the radio system on a burst-by-burst basis.
gainSettingsIF
Represents the IF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the intermediate frequency (IF) module.
gainSettingsRF
Represents the RF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the radio frequency (RF) modules.
totalGain
Represents the total attenuation commanded by the automatic gain control loop. This can be captured for each antenna.
antennaNum
Enter either 1 (main antenna) or 2 (diversity antenna).
The upper limit for the threshParam being monitored.
lowThreshold
The lower limit for the threshParam being monitored.
upChange
The positive change limit allowed for the threshParam being monitored.
downChange
The negative change limit allowed for the threshParam being monitored.
posCrossing
The limit that applies only when the threshParam is increasing in value.
negCrossing
The limit that applies only when the threshParam is decreasing in value.
threshValue
A 32-bit integral value
repeatTime
When radio signals are monitored, they can oscillate across a specified threshold (such as highThreshold) very rapidly. In such a case, an event is generated for each crossing of the threshold, which could flood the system. The repeatTime parameter specifies the amount of time (in seconds) the system waits before another event of the same type is generated.
clearTime
When radio signals oscillate across a threshold, this parameter identifies when the signal stabilizes. The clearTime parameter specifies how many seconds the radio signal must stay below a threshold (after crossing it once) before the system generates the clear event.
Defaults
No default behavior or values.
Command Modes
Interface configuration (TBC)
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
When the specified threshold is crossed, an event of type threshParameventType is generated and the event is logged to the console.
Only one threshold can be defined for each of the identified threshParam threshType [dsp dspId]combination. When a threshold is crossed, the threshParam threshType [dsp dspId] combination identifies the threshold specification that caused the event.
For every threshold defined, antennaNum is conditional. Antenna number is applicable for the threshParam attributes in, receivedPower, gainSettingsIf,gainSettingsRF, and totalGain.
Note If an antenna number is used when a threshold is created, it must also be specified when the
threshold is deleted.
For each event, the threshParam [dsp dspId] threshType eventType is output identifying the threshold crossed.
The no radio threshold command requires the threshParam, threshType, and [dsp dspId] attributes.
Examples
See the following command sequence which sets up a threshold for totalGain. When the totalGain for the system on antenna2 falls below 70, the eventSet event type is generated.
UBR04(config-if)# radio threshold totalGain 2 lowThreshold 70
Related Commands
Command
Description
show interfaces radio thresholds
Displays the current threshold specifications.
radio timeline
To configure a timeline collection specification with the software, use the radio timeline privileged EXEC command. To delete a timeline, use the no form of this command.
radio timeline statParam antenna_num [dsp dspId] tlSize [decimationFactor df] [presummationShift pss] [print {on | off}] [tone {circular | average | number tone-number] [trigger threshParams threshType (antenna_num) postTrigBufMgt]
no radio timeline statParam antenna_num [dsp dspnum]
(Interference + Noise) The interference plus noise power levels are computed by the hardware on a burst-by-burst basis.
inr
(Interference + Noise Ratio) The ratio of the interference plus noise power levels captured by the first antenna to the second antenna on a burst-by-burst basis. This value is specified as a log to base 2 number.
Note This parameter is available for a dual antenna system only.
constVariance
(Constellation Variance) The average energy of the constellation error signal - the error between the received (noisy) constellation symbol and the nearest ideal constellation symbol. Constellation Variance is a measure of the Signal to Interference plus Noise ratio (SINR) for that tone. On a single antenna system, the error represents (SINR)-1. On a dual antenna system, it represents (SINR)-1 after antenna combining.
timingOffset
Represents the timing delay variations detected in the radio link.
freqOffset
This represents the carrier frequency offset between the slave radio and the master radio.
syncStatus
Represents the synchronization status.
receivedPower
A measure of the analog signal power received by the radio system on a burst-by-burst basis.
gainSettingsIF
Represents the IF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the intermediate frequency (IF) module.
gainSettingsRF
Represents the RF attenuation value commanded by the automatic gain control loop. This can be captured for each antenna and for the radio frequency (RF) modules.
totalGain
Represents the total attenuation commanded by the automatic gain control loop. This can be captured for each antenna.
The antenna for which the timeline data is collected.
tlSize
Positive number representing the number of values to collect.
decimationFactor
The rate at which data is received is high, so retrieving every successive data sample provides little information (due to memory limitations). The decimation factor specifies how many successive data samples are added together and reported as one data sample. If the decimation factor is not specified, every successive data sample is reported.
df
{0 . . 231}
presummationShift
If decimationFactor is specified, then successive data samples are added. This can potentially cause an overflow. The presummationShift value specifies the number of bits by which the data sample is right-shifted before it is added. Specifying a presummationShift value results in less precise individual data samples but provides a mechanism to analyze the behavior over long periods of time.
pss
(0 . . 32)
print
{on | off} Specifies whether or not the collected values are printed out when the collection completes. The default is on.
tone
{circular | average | number tone-number} Every burst of signal data contains samples from N frequency tones. This parameter identifies which tones are used.
circular
Implies successive data samples should use successive frequency tones.
average
Implies successive data samples should average the burst data over all the N frequencies and then use that value.
number
Specifies that data from a particular frequency in the burst are reported.
tone-number
for in and inr { {0 . . 27} for 12 MHz high, 6 MHz high } { {0 . . 33 } otherwise }
for constVariance { {0 . . 216} for 12 MHz high } { {0 . . 198} for 12 MHz med, low } { {0 . . 108 } for 6 MHz high } { {0 . . 99 } for 6 MHz med, low }
trigger
Specifies when the collection has to be stopped. The threshParamthreshTypeantenna_num parameters uniquely identify a threshold specification. When this threshold is reached, the timeline is stopped and the data collected.
An upper limit for the threshParam being monitored.
lowThreshold
A lower limit for the threshParam being monitored.
upChange
The positive change limit allowed for the threshParam being monitored.
downChange
The negative change limit allowed for the threshParam being monitored.
posCrossing
The limit that applies only when the threshParam increases in value.
negCrossing
The limit that applies only when the threshParam decreases in value.
postTrigBufMgt
Specifies the position of the trigger in the data collected. If the position is 1, then most of the data collected before the trigger is returned. If the position is 2, most of the data returned is captured after the occurrence of the trigger.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
A timeline is a sequence of data values collected for a specified attribute. The amount of data collected is controlled by the tlSize parameter. The maximum size is determined by the hardware memory size.
Collection starts as soon as the command succeeds and continues until the trigger occurs or the timelineStop command is executed.
For every timeline defined, antenna_num and tone are conditional. The antenna_num is required for the attributes in, receivedPower, GainSettingsIF, gainSettingsRF, and totalGain. The tone can be optionally specified for the attributes in, inr, and constVariance.
Up to 1024 32-bit words are available for all timeline parameters on a single DSP. Each timeline requires (tlsize+1) * 2 words. The attributes in in, inr, and constVariance can be captured on any DSP, while the others can be captured only on certain DSPs. Distributing timeline requests across DSPs provides better memory utilization.
Examples
See the following example which configures a timeline specification. The collection process starts as soon as the command succeeds. The inr parameter is monitored. A total of 640 values is collected.
Of the N tones in a burst, the average value of all the tones (for the burst) is retrieved as one data sample. Each data sample is right shifted by 2 bits. Twenty successive (right-shifted) data samples are added together and reported as one value (of the 640 values in total).
When the threshold inrlowThreshold2 is reached, the collection stops and the results are printed.
UBR04# radio timeline inr 640 dec 20 pre 2 tone average trigger inr lowThreshold 2
Related Commands
Command
Description
radio interface radio timelineStart
Starts a stopped timeline specification.
radio interface radio timelineStop
Stops a running timeline specification.
show interfaces radio tldata
Displays timeline data for the specified card.
show interfaces radio tlspec
Displays the details of the timeline specification.
radio transmit-power
To configure the transverter to transmit the specified amount of power (in dBm) when in operation, use the radio transmit-power interface configuration command. To disable, use the no form of this command.
radio transmit-power power
no radio transmit-power
Syntax Description
power
Positive number representing power stated in dBm.
Transmit power range for MMDS is between 15 and 35 dBm. Transmit power range for U-NII is between 5 and 25 dBm.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
Maximum transmission power is limited by the capabilities of the transverter. In addition, your country's telecommunications authority (the FCC in the United States) regulates the maximum power and/or the EIRP in the MMDS and U-NII bands. It is the responsibility of the installer and operator to comply with the relevant regulations.
To support the maximum number of users in an area, keep the power as low as possible while maintaining sufficient margin and performance. See Cisco Broadband Fixed Wireless Site Planning Guide for additional information.
Example
See the following example which sets the MMDS transmit power to +25 dBm:
UBR04(config-if)# radio transmit-power 25
Related Commands
Command
Description
show running-configuration interface radio
Displays the current setting.
show controllers radio
To display all or a subset of attributes of a particular modem card, use the show controllers radio privileged EXEC command.
show controllers radio slot number/port number [{if | rf | fir | codec | dsp | arq | pci | phy | driver}]
Syntax Description
slot number
Positive integer representing the Cisco uBR7200 series slot number.
port number
Positive integer representing the port number on that slot.
if
(version, freq, register1):
version is the name, version of the module.
freq is the current operating frequency.
register1 is the IF Register 1.
rf
(version, freq, power)
version is the name, version of the module.
freq is the current operating frequency.
power is the minimum, maximum power capacity.
fir
(version, firThresh,)
version is the name, version of the module.
firThresh is the queue threshold.
codec
(version, rsDecodeErrThresh, rdDecodeErrBytes)
version is the name, version of the module.
rsDecodeErrThresh is the decode error threshold.
rdDecodeErrBytes are the decode error bytes
dsp
(version)
version is the name, version of the module.
arq
(version, arqThresh)
version is the name, version of the module.
arqThresh is the ARQ threshold.
pci
(version)
version is the name, version of the module.
phy
(version)
version is the name, version of the module.
driver
TBC
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
If you do not specify any option, all the hardware subsystem(s) information appears. Actual output parameters depend on the hardware and implementation.
Examples
The following example shows the output received when the pci option is specified for the modem card in slot number 3, port number 0.
Normal Latency Tx ring 0x4B05A680 shadow 0x6139A1C0 head 0 tail 0 count 0
Low Latency Tx ring 0x4B05A220 shadow 0x61399D50 head 3 tail 3 count 0
PCI Configuration Registers
Device/Vendor IDs - 0x00141137
Command/Status - 0x02000086
Latency Timer - 0x0000FF00
Base Address 0 - 0x4E000000
Max Lat - 0x000001FF
PCI Interface FPGA
dmac_control - 0x00440002
dmac_status - 0x00004000
dmac_int_status - 0x99800001
dmac_int_enable - 0x66710FF8
dmac_tx0_ring_base - 0x4B05A220
dmac_tx1_ring_base - 0x4B05A680
dmac_rx_ring_base - 0x4B05A0C0
dmac_configuration - 0x66040303
local_bus_error_status - 0x00000000
local_bus_error_address - 0x010C0000
local_bus_reset - 0x00000000
fpga_configuration_control - 0x00000000
fpga_configuration_status - 0x000000FF
Table 5 describes the fields shown in the show controllers radio display.
Table 2 show controllers radio Field Descriptions
Field
Description
TBC
show interfaces radio arq
To see the current ARQ configuration on the wireless modem card, use the show interfaces radio arq privileged EXEC command.
show interfaces radio slot/port arq
Syntax Description
slot/port
The slot and port address.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
If you don't specify optional parameters, then all the timeline specifications on the modem card are displayed. If you only specify the statParam antenna_num combination, then the configuration setup on the default appears. If you specify the [dspdspId] parameter, then the configurations on that DSP appears.
Examples
See the following example which displays the ARQ configuration for the modem card in slot 3, port 0:
UBR04# show interfaces radio 3/0 arq
ARQ State = on
Data Latency = 20 ms
Voice Latency = 20 ms
Maximum ARQ Bandwidth Overhead = 12.50%
Typical Bit Rate = 10845152 bits/sec
Minimum Bit Rate = 9488600 bits/sec
Burst Size = 16 codewords
Maximum Latency Jitter = 2679 usec
Table 3 describes the fields shown in the show interfaces radio arq display.
Table 3
pctBW
The maximum percent link bandwidth being used for ARQ.
dataLatency
Tells the hardware to restrict the maximum latency for packet data to this value.
voiceLatency
Tells the hardware to restrict the maximum latency for voice data to this value.
BurstSize
Currently configured burst size—in number of codewords.
OnOff
Whether ARQ is turned on or off.
ARQPeakBitRate
The maximum possible peak bit rate that the link can handle based on the current channel-parameter and ARQ settings.
ARQMinBitRate
The minimum bit rate that can be seen on the link based on the current channel-parameter and ARQ settings.
ARQMaxLatencyJitter
The maximum jitter expected on this link based on the current configuration.
show interfaces radio arq Field Descriptions
Related Commands
Command
Description
radio arq
Configures Automatic Repeat Query.
show interfaces radio histdata
To see the collected histogram data for the identified histogram specification, use the show interfaces radio histdata privileged EXEC command.
show interfaces radio slot/port histdata statparam antenna_num dsp dspnum
Syntax Description
slot
Positive integer representing the Cisco uBR7200 series slot number.
port
Positive integer representing the port number on that slot.
Data for the radio attribute is to be collected as a histogram.
Note If <statParam> is specified, antenna_num is conditionally required.
in
(Interference + Noise) The interference plus noise power levels are computed by the hardware on a burst-by-burst basis.
inr
(Interference + Noise Ratio) The ratio of the interference plus noise power levels captured by the first antenna to the second antenna on a burst-by-burst basis. This value is specified as a log to base 2 number.
Note This parameter is available for a dual antenna system only.
constVariance
(Constellation Variance) The average energy of the constellation error signal - the error between the received (noisy) constellation symbol and the nearest ideal constellation symbol. Constellation Variance is a measure of the Signal to Interference + Noise ratio (SINR) for that tone. On a single antenna system, the variancerepresents (SINR)-1. On a dual antenna system, the variance represents a composite value providing (SINR)-1.
timingOffset
Represents the timing delay variations detected in the radio link.
freqOffset
Represents the carrier frequency offset between the slave radio and the master radio.
syncStatus
Represents the synchronization status.
receivedPower
A measure of the analog signal power received by the radio system on a burst-by-burst basis.
gainSettingsIF
Represents the IF attenuation value commanded by the automatic gain control loop. This value can be captured for each antenna and for the intermediate frequency (IF) module.
gainSettingsRF
Represents the RF attenuation value commanded by the automatic gain control loop. This value can be captured for each antenna and for the radio frequency (RF) module.
totalGain
Represents the total attenuation commanded by the automatic gain control loop. This value can be captured for each antenna.
antenna_num
Enter 1 (main antenna) or 2 (diversity antenna).
Note For every threshold defined, antenna_num is conditional. The attributes in, receivedPower, GainSettingsIF, gainSettingsRF, and totalGain are applicable for antenna_num.
dspnum
The DSP number.
Note If you don't specify the DSP number, the specification on the default DSP appears.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The values appear as a BinID:Value pair. BinId represents the sample value contained in that bin. Value represents the count in the histogram bin.
Examples
The following example shows the command used to display the histogram data for the histogram configured on the modem card in slot 6, port 0 of the uBR for receive DSP 1a.
UBR04# show interfaces radio 6/0 histdata inr dsp dsprx1a
Histogram 4/1/8 [*=100] min=-2 avg=0
157 0=<0 **
137 0=<1 **
115 1=<2 **
44 2=<MAX *
Table 4 describes the fields shown in the show interfaces radio histdata display.
Table 4 show interfaces radio histdata Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
show interfaces radio histspec
Displays the details of the histogram specifications currently configured.
show interfaces radio histspec
To see the details of the histogram specifications currently configured, use the show interfaces radio histspec privileged EXEC command.
show interfaces radio slot/port histspec [statParam antenna_num[dsp dspnum]]
Syntax Description
slot
Positive integer representing the Cisco uBR7200 series slot number.
port
Positive integer representing the port number on that slot.
Data for the radio attribute is to be collected as a histogram.
Note If you specify the statParam, antenna_num is conditionally required.
in
(Interference + Noise) The interference plus noise power levels are computed by the hardware on a burst-by-burst basis.
inr
(Interference + Noise Ratio) The ratio of the interference plus noise power levels captured by the first antenna to the second antenna on a burst-by-burst basis. This value is specified as a log to base 2 number.
Note This parameter is available for a dual antenna system only.
constVariance
(Constellation Variance) The average energy of the constellation error signal - the error between the received (noisy) constellation symbol and the nearest ideal constellation symbol. Constellation Variance is a measure of the Signal to Interference plus Noise ratio (SINR) for that tone. On a single antenna system, the value represents (SINR)-1. On a dual antenna system, the value represents a composite value providing (SINR)-1.
timingOffset
Represents the time delay variations detected in the radio link.
freqOffset
Represents the carrier frequency offset between the slave radio and the master radio.
syncStatus
Represents the synchronization status.
receivedPower
A measure of the analog signal power received by the radio system on a burst-by-burst basis.
gainSettingsIF
Represents the IF attenuation value commanded by the automatic gain control loop. This value can be captured for each antenna and for the intermediate frequency (IF) module.
gainSettingsRF
Represents the RF attenuation value commanded by the automatic gain control loop. This value can be captured for each antenna and for the radio frequency (RF) module.
totalGain
Represents the total attenuation commanded by the automatic gain control loop. This value can be captured for each antenna.
antenna_num
Enter 1 (main antenna) or 2 (diversity antenna).
Note For every histogram defined, antenna_num is conditional. The antenna_num is required for attributes in, receivedPower, GainSettingsIF, gainSettingsRF, and totalGain.
dspnum
The DSP number.
Note If you don't specify the DSP number, the specification on the default DSP appears.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
If you don't specify the optional parameters, all histogram specifications on the modem card appear.
Examples
The following example shows details of the histogram Constellation Variance specification configured for the modem card in slot 3, port 0 of the uBR:
UBR04# show interfaces radio 3/0 histspec constVariance
Class constVariance
Start Bin Value 0
Bin Delta 4
Number of Bins 100
Update Rate 10
Collection duration 20
Bit Shift 0
Tone Selection average
Dsp Number dsrx1a
Index 9
Periodic Sum false
Default Hist false
Display status on
Histogram Status captured
Table 5 describes the fields shown in the show interfaces radio histspec display.
Table 5 show interfaces radio histspec Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
show interfaces radio histdata
Displays the collected histogram data for the identified histogram specification.
show interfaces radio imagehdr
To see details of the images to be downloaded on a single chip or on all chips, use the show interfaces radio imagehdr privileged EXEC command.
show interfaces radio slot/port imagehdr [chip chipname[current | operational]]
Syntax Description
slot/port
The slot and port address.
chipName
A character string identifying a chip.
current
Display the image header (details) for the image currently loaded on the chip.
operational
Display the image header for the image that will be loaded on the chip for the current configuration.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
If you specify a particular chip, the details of the image to be loaded on that chip appear. If you don't specify a chip name, the current radio configuration is retrieved for every chip on the modem card. All the images in the repository are compared. The image that provides the closest match in capability is selected, and the details of that image appears.
Examples
See the following example to display the image details of the chip named dsp1a currently loaded on the chip on the modem card in slot 3, port 0:
UBR04# show interfaces radio 3/0 imagehdr dsp1a current
image details TBC
Table 6 describes the fields shown in the show interfaces radio imagehdr display.
Table 6 show interfaces radio imagehdr Field Descriptions
Field
Description
TBC
show interface radio scope-output
To display the attribute being sent to the scope port, use the show interfaces radio histspec privileged EXEC command.
show interfaces radio slot/port scope-output
Syntax Description
slot/port
The slot and port address.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Related Commands
Command
Description
radio scope-output
Configures the specified DSP to send the specified output to the serial port.
show interfaces radio snapdata
To display snapdata information, use the show interfaces radio snapdata privileged EXEC command.
show interfaces radio slot/portsnapdata dspId
Syntax Description
slot/port
The slot and port address.
dspId
Specifies the DSP number.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Examples
See the following example TBC:
command example TBC
Table 7 describes the fields shown in the show interfaces radio snapdata display.
Table 7 show interfaces radio snapdata Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
radio snapshot
Creates a snapshot specification.
radio interface radio snapclear
Clears the data collected for the specified snapshot.
show interfaces radio snapshot
To display snapshot information, use the show interfaces radio snapshot privileged EXEC command.
show interfaces radio slot/port snapshot dspId
Syntax Description
slot/port
The slot and port address.
dspId
Specifies the DSP number.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Examples
See the following example TBC:
command example TBC
Table 8 describes the fields shown in the show interfaces radio snapshot display.
Table 8 show interfaces radio snapshot Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
radio snapshot
Creates a snapshot specification.
radio interface radio snapclear
Clears the data collected for the specified snapshot.
show interfaces radio snapdata
Displays the data captured for the snapshot specification.
show interfaces radio thresholds
To display the set of currently configured thresholds on the modem card on the specified DSP, use the show interfaces radio privileged EXEC command.
show interfaces radio slot/port thresholds [dspNum]
Syntax Description
slot/port
The slot and port address.
dspNum
The DSP number.
Defaults
No default behavior or values.
Command Modes
privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
If dspNum is not specified, the thresholds for DSP 3 appear.
Examples
See the following command which displays the set of currently configured thresholds for the modem card in slot 6, port 0 for the Receive DSP 1b:
UBR04# show interfaces radio 6/0 thresholds dsp dsprx1b
Threshold Attribute in Threshold Type downChange Antenna Id 2 Threshold Value 200 Threshold Repeat Time 5 Threshold Clear Time 8 Threshold DSP Number dsprx1b
Index 2
Default Threshold false
Table 9 describes the fields shown in the show interfaces radio thresholds display.
Table 9 show interfaces radio thresholds Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
radio threshold
Configures a threshold event specification
show interfaces radio tldata
To display the timeline data collected for the identified specifications, use the show interfaces radio ltdata privileged EXEC command.
show interfaces radio slot/port tldata [statParam antenna_num[dsp dspId]]
If you don't specify optional parameters, then all the timeline specifications on the modem card appear. If you only the statParam antenna_num combination, then the configuration setup on the default appears. If you specify the [dspdspId] parameter, then the configurations on that DSP appears.
Examples
See the following example which displays the timeline inr data for the modem card installed in slot 3, port 0 of the uBR7200 series router:
If you don't specify optional parameters, then all the timeline specifications on the modem card appear. If the statParam antenna_num combination only is specified, then the configuration setup on the default will be displayed. If you specify the [dspdspId] parameter is specified, then the configurations on that DSP appears.
Examples
The following example shows the inr timeline specification configured for the modem card in port 3, slot 0 of the uBR7200 series router:
UBR04# show interfaces radio 3/0 tlspec inr
Class inr
Resource Id 1
Buffer size 50
Number of buffers 20
Collection method 30
Tone Selection average
Stop threshold attribute in
Stop threshold type downChange
Stop antenna number 1
Print options off
Dsp Number 3
Default T1 false
Table 5 describes the fields shown in the show interfaces radio tlspec display.
Table 11 show interfaces radio tlspec Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
radio timeline
Configures a timeline collection specification.
radio interface radio timelineStart
Starts a stopped timeline specification.
radio interface radio timelineStop
Stops a running timeline specification.
show interfaces radio tldata
Displays timeline data for the specified card.
show radio repository
To show the protocol-specific list of images in the repository, use the show radio repository privileged EXEC command.
show radio repository [header] [protocol]
Syntax Description
header
Image header details associated with the list of images will also appears.
protocol
{mem | tftp | flash}
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The repository is a list of current configuration images. When the modem card is initiated (no shut), this list is searched and the correct image downloaded. Privileged configuration access is required.
Examples
The following example shows a list of images related to memory:
UBR04# show radio repository mem
mem:/MyMemImages/dsp1Dual.img
mem:/MyMemImages/dsp2Dual.img
mem:/MyMemImages/dsp1Single.img
Table 5 describes the fields shown in the show interfaces radio repository display.
Table 12 show interfaces radio repository Field Descriptions
Field
Description
TBC
Related Commands
Command
Description
radio image-add
Adds images to the repository.
radio image-move
Moves the specified image to the beginning of the repository.
radio image-override
Attaches the specified image file name to the specified chip.
shut
To shut down the radio link, use the shut interface configuration command. To reinstate the radio link, use the no form of this command.
shut
no shut
Syntax Description
This command has no keywords or arguements.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
Modification
12.0(7)XR
This command was introduced.
Usage Guidelines
The state of the link appears on the console.
Examples
See the following command which shuts down the radio link:
UBR04(config-if)# shut
Debug Commands
This section documents the new debug radio command. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.
debug radio
To display debug messages for the radio link, use the debug radio EXEC command. To turn off debugging, use the no form of this command.
debug radio {lm_log | messages | phy}
no debug radio
Syntax Description
lm_log
log [verbose]
phy
{radioLog | cwrLog}
radioLog
radioslot/portsubModule
slot
Positive integer representing the Cisco uBR7200 series slot number.
port
Positive integer representing the port number on that slot.
