cc/td/doc/product/software/ios120/120newft/120limit
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Point-to-Point Wireless Support for the Cisco uBR7200 Series Universal Broadband Router
Feature Overview
Wireless Modem Card and Subsystem Overview
Benefits
Related Documents
Supported Platforms
Supported Standards, MIBs, and RFCs
Prerequisites
Configuration Tasks
Configuring IF Loopback (Optional)
Configuring RF Loopback (Optional)
Configuring RF-to-RF Link (Over the Air)
Choosing Throughput Setting
Verifying the Wireless Modem Card Configuration
Monitoring and Maintaining Point-to-Point Wireless Configurations
Show Commands
Debug Commands
Configuration Examples
Single Antenna
RF-to-RF Link
Current Configuration
Command Reference
clear radio interface radio link-metrics
loopback
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 metrics-threshold 24hour
radio metrics-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 interface 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
Debug Commands
debug radio
Glossary

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:

Feature Overview


Wireless Modem Card and Subsystem Overview

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:

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)

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/port 1second-metrics delta

UBR04 # show radio interface radio slot/port link-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/port 1second-metrics delta

UBR04 # show radio interface radio slot/port link-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:

Single Antenna

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:

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
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 8 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
620 packets input, 203300 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 output errors, 0 collisions, 4 interface resets
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 [collectionInterval interval] [periodic interval sum {true | false}]

no radio byteErrorHist [collectionInterval interval] [periodic interval 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.

radio duplexor antenna_num PartNum LoPassbandRange HiPassbandRange RxPassband [low-passband | hi-passband] CLEIcode VendorName SerialNumber

Syntax Description

antenna_num

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}

Syntax Description

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

The data for the radio attribute is collected as a histogram.

antenna_num

Enter 1 (main antenna) or 2 (diversity antenna).

dsp dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

Defaults

No default behavior or values.

Command Modes

Interface configuration

Command History

Release Modification

12.0(7)XR

This command was introduced.

Related Commands

Command Description

radio histogram

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] [periodic interval sum {true | false}] [tone circulate | average | number tone-number]

no radio histogram statParam antenna_num [dsp dspId]

Syntax Description

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

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.

antenna_num

Enter 1 (main antenna) or 2 (diversity antenna).

dspId

{dsprx1a (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b)}

StartBinValue

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]

Syntax Description

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

The radio attribute whose data is to be collected as a histogram.

antenna_num

Enter 1 (main antenna) or 2 (diversity antenna).

dspId

{dsprx1a (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b)}

The DSP where the timeline data is collected.

Defaults

No default behavior or values.

Command Modes

Interface configuration

Command History

Release Modification

12.0(7)XR

This command was introduced.

Related Commands

Command Description

radio histdisplay

Controls how the histogram data appears.

radio histogram

Configures a histogram collection specification.

radio interface radio snapcapture

To capture another snapshot on the identified DSP, use the radio interface radio snapcapture interface configuration command.

radio interface radio slot/port snapcapture dspId

Syntax Description

slot/port

The slot and port address.

dspId

The DSP ID:
{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

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 snapshot specification already configured on the DSP is used.

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.

radio interface radio snapclear

To clear the data collected for the specified snapshot on the identified DSP, use the radio interface radio snapclear interface configuration command.

radio interface radio slot/port snapclear dspId

Syntax Description

slot/port

The slot and port address.

dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

Defaults

No default behavior or values.

Command Modes

Interface configuration

Command History

Release Modification

12.0(7)XR

This command was introduced.

Related Commands

Command Description

radio snapshot

Creates a snapshot specification.

radio interface radio snapcapture

Captures a snapshot on the specified DSP.

show interfaces radio snapdata

Displays the data captured for the snapshot specification.

radio interface radio timelineStart

To start a stopped timeline specification, use the radio interface radio timelineStart privileged EXEC command.

radio interface radio slot/port timelineStart statParam antenna_num [dsp dspnum]

Syntax Description

slot/port

The slot and port of the interface.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF}

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.

Usage Guidelines

Unless an error occurs, no notifications appear on the console.

Related Commands

Command Description

radio timeline

Configures a timeline collection 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 interface radio timelineStop

To stop a currently executing timeline specification, use the radio interface radio timelineStop privileged EXEC command.

radio interface radio slot/port timelineStop statParam antenna_num [dsp dspnum]

Syntax Description

slot/port

The slot and port of the interface.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF}

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 led latchLeds latch 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.

otherLedOptions

{off | green | yellow | blinkGreen | blinkYellow | blinkBoth}

Defaults

LEDs controlled by system

Command Modes

Interface configuration

Command History

Release Modification

12.0(7)XR

This command was introduced.

Usage Guidelines

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:

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:

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:

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:

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:

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:

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 frequency Rx receive 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.

radio privacy {enable | auth-wait-time secs | reauth-wait-time secs | auth-grace-time secs | op-wait-time secs | rekey-wait-time secs | tek-grace-time secs | auth-lifetime secs | tek-lifetime secs}

no radio privacy

Syntax Description

auth-wait-time

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.

radio scope-output dspId outputType

no radio scope-output dspId

Syntax Description

dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

outputType

{rx-rawburst-ant1-y1n | rx-rawburst-ant1-y2n | rx-spectrum-ant1-y1k | rx-spectrum-ant1-y2k | rx-timedomainchannel-ant1-h1n | rx-timedomainchannel-ant2-h2n | rx-freqdomainchannel-ant1-h1k | rx-freqdomainchannel-ant2-h2k | rx-constellation-zhatk | tx-codec-input | tx-ifft-input | tx-round-output | sync-burst-timecost-func | sync-freq-offset-costfunc | sync-pwrsbtcffocf | sync-fll-freq-corelation | sync-fll-train-tone-corelation | sync-fll-fft-spectrum}

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

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.

radio snapshot dspId snapshotType

no radio snapshot dspId snapshotType

Syntax Description

dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

snapshotType

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 threshParam antennaNum [dsp dspId] threshType threshValue repeatTime clearTime

no radio threshold threshParam antennaNum [dsp dspId] threshType

Syntax Description

threshParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

in

(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).

dspId

{dsprx1a (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b)}

threshType

{highThreshold | lowThreshold | upChange | downChange | posCrossing | negCrossing}

highThreshold

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 threshParam eventType 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]

Syntax Description

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF}

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 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.

dspId

{dsprx1a (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b)}

The DSP on which to collect the timeline data.

antenna_num

Enter 1 (main antenna) or 2 (diversity 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 threshParam threshType antenna_num parameters uniquely identify a threshold specification. When this threshold is reached, the timeline is stopped and the data collected.

threshParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF}

threshType

{highThreshold | lowThreshold | upChange | downChange | posCrossing | negCrossing}

highThreshold

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 inr lowThreshold 2 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.

UBR04# show controllers radio 3/0 pci
Interface Radio 3/0
Hardware is CW Radio Point-to-Point Line Card
throttled 0 enabled 0 disabled 0
Rx: spurious 0 framing_err 0 no_buffer 0, pause_no_err_ints 0
no_enqueue 0 no_stp 0 no_enp 0
Tx: full 0 drop 0
rx ring entries 32 tx ring entries 128
Rx ring 0x4B05A0C0 shadow 0x61399C60 head 2
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 [dsp dspId] 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.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain | codewordError}

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.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

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/port snapdata 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]]

Syntax Description

slot/port

The slot and port address.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

Data for the radio attribute is to be collected as a histogram.

antenna_num

Enter 1 (main antenna) or 2 (diversity antenna).

dsp dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

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 appear. If you only the statParam antenna_num combination, then the configuration setup on the default appears. If you specify the [dsp dspId] 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:

UBR04# show interfaces radio 3/0 tldata inr
Number of Points Captured=100 Trigger Location=54
0 :0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
10 :0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
20 :0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
30 :0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
40 :0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
50 :FFFFFFFF FFFFFFFF 0000 0000 0000 0000 0000 0001 FFFFFFFF FFFFFFFF
60 :0000 0002 FFFFFFFF FFFFFFFF 0000 0001 0000 0000 0000 0000
70 :0000 0000 0000 0001 FFFFFFFF FFFFFFFF 0000 0000 0000 0001
80 :FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 0000 0002 FFFFFFFF FFFFFFFF 0000 0002
90 :FFFFFFFF FFFFFFFF 0000 0000 0000 0001 FFFFFFFF FFFFFFFF 0000 0000

Table 10 describes the fields shown in the show interfaces radio tldata display.

Table 10   show interfaces radio tldata 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 tlspec

Displays the details of the timeline specification.

show interfaces radio tlspec

To display the details of the currently configured timeline specifications, use the show interfaces radio tlspec privileged EXEC command.

show interfaces radio slot/port tlspec [statParam antenna_num [dsp dspId]]

Syntax Description

slot/port

The slot and port address.

statParam

{in | inr | constVariance | timingOffset | freqOffset | syncStatus | receivedPower | gainSettingsIF | gainSettingsRF | totalGain}

Data for the radio attribute whose data is to be collected as a histogram.

antenna_num

Enter 1 (main antenna) or 2 (diversity antenna).

dsp dspId

{dsprxla (Receive DSP 1a) | dsprx1b (Receive DSP 1b) | dsprx2a (Receive DSP 2a) | dsprx2b (Receive DSP 2b) | dsprx3a (Receive DSP 3a) | dsprx3b (Receive DSP 3b) |
dsptx1 (Transmit DSP 1) | dsptx2 (Transmit DSP 2)}

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 appear. If the statParam antenna_num combination only is specified, then the configuration setup on the default will be displayed. If you specify the [dsp dspId] 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

radio slot/port subModule

slot

Positive integer representing the Cisco uBR7200 series slot number.

port

Positive integer representing the port number on that slot.

subModule

{cli | gal | snmp} logLevel

cli

Tracing the radio interface CLI commands.

gal

Tracing the the GAL (TBC) module.

snmp

Tracing the the radio SNMP module.

logLevel

Acceptable values are: {all | controlFlow | dataFlow | validation | verbose}

cwrLog

cwrLog modName

modName

Name of the module.

Defaults

No default behavior or values.

Command History

Release Modification

12.0(7)XR

This command was introduced.

Examples

Various logLevels determine what and how much debug log output is generated.

UBR04# debug radio phy radio 3/0 snmp verbose

This command causes various physical layer entities to log debug output:

UBR04(config-if)# debug radio phy cwrLog modName

Related Commands

Command Description

show debug

Displays current debug settings.

Glossary


DSP—Digital Signal Processor

MMDS—TBC

SINR—The ratio of the received strength of the desired signal to the received strength of undesired signals (noise and interference).

U-NII—TBC


hometocprevnextglossaryfeedbacksearchhelp
Posted: Fri Jan 17 03:19:14 PST 2003
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.