Cisco AS5350XM and Cisco AS5400XM Universal Gateways Software Configuration Guide
Managing and Troubleshooting the Voice Feature Card
Downloads: This chapterpdf (PDF - 183.0KB) The complete bookPDF (PDF - 3.06MB) | Feedback

Managing and Troubleshooting the Voice Feature Card

Table Of Contents

Managing and Troubleshooting the Voice Feature Card

Viewing DSP Performance Statistics

show voice dsp Commands

show voice dsp channel Commands

Managing DSPs

DSP Configuration Mode

DSP Configuration Mode Commands

Troubleshooting

Debugging Commands

DSP Recovery

Clear a DSP

Upgrading DSP Firmware

Important Upgrade Commands

Displaying DSP Firmware Versions

Using Unbundled DSP Firmware

Using DSP Firmware Bundled with Cisco IOS Software

Using the AMR-NB Codec

How the AMR-NB Codec Works

Restrictions for the AMR-NB Codec

Where to Go Next


Managing and Troubleshooting the Voice Feature Card


The information in this chapter applies to the Cisco AS5350XM and Cisco AS5400XM universal gateways, and includes the following sections:

Viewing DSP Performance Statistics

Managing DSPs

Troubleshooting

Upgrading DSP Firmware

Using the AMR-NB Codec

Where to Go Next

The high-density packet voice and fax feature card (AS5X-FC) supports up to six high-density packet voice and fax digital signal processor (DSP) modules (AS5X-PVDM2-64), providing scalability from 64 to 384 channels. The voice feature card converts voice and fax calls into IP packets or frames that can be transmitted as voice over IP (VoIP) over a variety of transport technologies on the Cisco AS5350XM or Cisco AS5400XM universal gateways.

You can manage the voice feature card at the slot level, digital signal processor (DSP) level, or channel level by using monitoring and troubleshooting commands. On the Cisco AS5350XM and Cisco AS5400XM universal gateways, the hierarchy designation is slot/dsp and slot/channel.

You can perform the following functions on a voice feature card:

General configuration such as busyout, shutdown, or clear

View statistics and states

Configure recovery processes

Upgrade firmware

Viewing DSP Performance Statistics

You can view DSP statistics by using the Cisco IOS software with the universal gateway. To view performance statistics for the voice feature cards, enter one or more of the following commands in privileged EXEC mode (at the AS5350XM# prompt).

show voice dsp Commands

show voice dsp activeDisplays the statistics for DSPs with active calls.

show voice dsp summaryDisplays summary information about the state, call types, and total calls for all the DSPs in a particular slot, a specified DSP, or a specified range of DSPs.

show voice dsp channel Commands

show voice dsp channel operational-status—Displays operational status of a channel or a range of channels. The channels should have active calls at the time the command is executed.

show voice dsp channel statistics—Displays error statistics for a channel or a range of channels. The channels should have active calls at the time the command is executed.

show voice dsp channel traffic—Displays traffic information for a channel or a range of channels. The channels should have active calls at the time the command is executed.

Managing DSPs

This section describes how to manage DSPs by entering DSP configuration mode, including upgrading the DSP firmware, performing busyout on DSPs, and clearing active calls on the DSPs.

DSP Configuration Mode

DSP configuration mode allows you to configure DSPs. You can configure a DSP by specifying a slot and a DSP associated with the slot or, you can choose to configure a range of DSPs by specifying the first and last DSP in the range.

The following example demonstrates how to enter DSP configuration mode:

AS5400# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
AS5400(config)# voice dsp slot/dsp slot/dsp
AS5400(config-voicedsp)#

DSP Configuration Mode Commands

Use the following commands in DSP configuration mode:

firmware locationAllows you to transfer a specified version of DSP firmware from system flash memory to the DSPs named upon entering DSP configuration mode. For further information on firmware upgrades, see the "Upgrading DSP Firmware" section.

firmware upgrade busyout | rebootAllows you to specify the upgrade method. Two methods of upgrade are available.

Busyout (the default) upgrades when all calls are terminated on an DSP.

Reboot upgrades at the next DSP reset or system reboot.

busyoutGracefully disables a DSP by waiting for all the active services on the specified DSP to terminate. If there are active calls on the specified DSP, the state of the DSP is changed to Busiedout. The DSP is temporarily disabled. Use the no form of this command to reenable the DSP.

shutdownClears all active calls on the DSP. Calls can no longer be placed on the DSP because the DSP state is changed to Out-of-Service. The state of the DSP is reflected in the show voice dsp command display. Use the no form of the shutdown command to reenable the channels on the DSP.

Troubleshooting

This section provides troubleshooting information for your voice feature card. You can view debug information, set automatic recovery options, and upgrade the DSP firmware.

Debugging Commands

Use the following debug commands in privileged EXEC mode:

debug voice dsp crash-dump—Displays debugging information for the crash dump feature details. No debug output is displayed until there is one DSP crash. When the crash dump feature is turned on, the detailed debug messages are displayed.

debug dsp-resource-manager flex—Displays debugging information about errors downloading the DSP firmware to the DSP, and DSP allocation statistics, errors, and functions.

debug voice hpi—Displays debugging information for Host Port Interface (HPI) message events, which are used to communicate with DSPs.

DSP Recovery

Automatic recovery (removal from service and reloading of DSP firmware) is enabled by default for the voice feature card.

You can disable automatic recovery using the voice dsp recovery disabled command in configuration mode.

Clear a DSP

Use the clear voice dsp command in privileged EXEC mode to manually restart a DSP. This command can be used to reset a DSP. This command causes the firmware that is configured for that DSP to be downloaded to the specified DSP or range of DSPs. This command can be executed regardless of the state of the DSPs. All active channels running on the DSP are prematurely terminated.

The following example shows a cold start on DSP 1 on slot 1:

AS5400# clear voice dsp 1/1
AS5400# Are you sure you want to clear voice dsp 1/1(Y/N)? Y

Upgrading DSP Firmware

With new systems, Cisco loads a Cisco IOS software-compatible version of DSP firmware into each DSP. A map of the version or versions of DSP firmware copied to RAM for each DSP is stored in NVRAM so that it is retained over power cycles.


Note You do not have to take any action to use the bundled version of DSP firmware with new systems.


You can acquire new DSP firmware from the Cisco Software Center in one of two ways:

Bundled in regular Cisco IOS releases. See the "Using DSP Firmware Bundled with Cisco IOS Software" section for details.

Unbundled from Cisco.com. This is a more up-to-date version of DSP firmware released before the next Cisco IOS release, or a special version of DSP firmware shipped with a new board. See the "Using Unbundled DSP Firmware" section for details.

When you have the new firmware, you can configure different firmware versions onto individual DSPs or ranges of DSPs on a voice feature card. You can also configure different upgrade methods by using the firmware upgrade command.


Note Do not store more than nine DSP firmware images in system flash memory. If you store more than nine DSP firmware images in system flash memory, the firmware upgrade command will fail. You will need to delete at least one firmware image from the system flash memory and reboot the gateway to use one of the remaining unbundled DSP firmware images.


Important Upgrade Commands

There are several commands you use to upgrade DSP firmware. For examples on using the commands, see the "Using Unbundled DSP Firmware" section and the "Using DSP Firmware Bundled with Cisco IOS Software" section.

Use the copy tftp flash filename command to copy any version of DSP firmware (no matter how it is obtained) into system flash memory. You can store several versions of the DSP firmware in system flash memory under different filenames.

Use the firmware location command in DSP configuration mode to transfer a specified version of DSP firmware from system flash memory to the DSPs specified in DSP configuration mode.

Use the firmware upgrade busyout | reboot command in DSP configuration mode to configure when the file named in the firmware location command will be loaded to the DSPs. Two methods of upgrade are available:

Busyout (the default) upgrades when all calls are terminated on an DSP.

Reboot upgrades at the next DSP reset or system reboot.


Note The copy ios-bundled command is not necessary with the voice feature card. By default, the version of DSP firmware bundled with the Cisco IOS software release is transferred to all DSPs that are not specifically configured for a different DSP firmware file.


Displaying DSP Firmware Versions

Use the show voice dsp version command to list the versions of DSP firmware running on the DSPs, residing in system flash memory, and bundled with Cisco IOS software. This helps you decide whether you need to change the version running on the DSPs.


Note The version number displayed may not match the filename for a short period of time while a range of DSPs is in the process of downloading new firmware. The version number is updated at the beginning of the upgrade process, whereas the filename is updated upon completion of the process. This is done intentionally to enable you to recognize the upgrade process from the show voice dsp version output.


AS5400# show voice dsp version

IOS-Bundled Default               Version     Firmware-Type
==========================        =======     =============
system:/bundled_fw_image          7.3.0       c5510
 
On-Flash Dspware-Filename         Version     Firmware-Type
=========================         =======     =============
flash:dsp_c5510_flex.rbf          4.4.5       c5510
flash:big.rbf                     4.5.985x    c5510
 
  DSP#     Type       Version     Filename  
  5/1      C5510      4.4.5       flash:dsp_c5510_flex.rbf
  5/2      C5510      7.3.0       system:/bundled_fw_image
  5/3      C5510      7.3.0       system:/bundled_fw_image
  5/4      C5510      7.3.0       system:/bundled_fw_image
  5/5      C5510      7.3.0       system:/bundled_fw_image

Using Unbundled DSP Firmware

Use this procedure to configure DSPs to use unbundled DSP firmware. For more information about unbundled DSP firmware releases for the voice feature card, see the "Using the AMR-NB Codec" section.


Note By default, the version of DSP firmware bundled with the Cisco IOS software release is transferred to all DSPs that are not specifically configured for a different DSP firmware file. This procedure is only necessary if you are using DSP firmware that is not bundled with the Cisco IOS software release.



Step 1 Enter the enable command.

AS5400> enable

Step 2 Enter your password.

Password: password
AS5400# 

You are in privileged EXEC mode when the prompt changes to AS5350# or AS5400#.

Step 3 Display DSP firmware versions to obtain the filename of the firmware on flash memory.


Note The version number and filename may not match until the upgrade is complete.


AS5400# show voice dsp version

IOS-Bundled Default               Version     Firmware-Type
==========================        =======     =============
system:/bundled_fw_image          7.0.200x    c5510

On-Flash Dspware-Filename         Version     Firmware-Type
=========================         =======     =============
No voice dsp in the slot range 1 to 7

Step 4 Enter global configuration mode by typing the configure terminal command.

AS5400# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
AS5400(config)#

You are in global configuration mode when the prompt changes to AS5350(config)# or AS5400(config)#.


Step 5 Enter DSP configuration mode. You can choose to configure a single DSP or range of DSPs by specifying the first and last DSP in the range.

AS5400(config)# voice dsp slot/dsp 

or

AS5400(config)# voice dsp slot/dsp slot/dsp

You are in DSP configuration mode when the prompt changes to AS5350(config-voicedsp)#.


Step 6 Specify the DSP firmware file in flash memory to use for the selected DSPs. This is the firmware filename that you obtained in Step 3.

AS5400(config-voicedsp)# firmware location vfc-dsp-upw-7.0.1.2.bin

Step 7 Specify when the DSP firmware upgrade is to occur.

AS5400(config-voicedsp)# firmware upgrade busyout | reboot

Step 8 Type the exit command to exit DSP config mode.

AS5400(config-voicedsp)# exit
AS5400(config)#

Step 9 Press the Enter key to make the changes, and then type Ctrl-Z to return to privileged EXEC mode.

AS5400(config)# Ctrl-Z
AS5400#

Step 10 Save your changes.

AS5400# copy running-config startup-config


Using DSP Firmware Bundled with Cisco IOS Software

Use this procedure to update DSP firmware on the DSPs in your gateway if the DSPs are currently configured with any non-bundled DSP firmware version.


Note This process does not delete any existing DSP firmware that resides in system flash memory in case you later want to revert to it. If you decide to delete the code from system flash memory, remember that all files in system flash memory are deleted; therefore, save and restore any important files (for example, the Cisco IOS software image).



Note If the new Cisco IOS image contains the same DSP firmware as the old one, no new code is downloaded to the DSPs.


To set the DSP firmware to the DSP firmware version bundled with Cisco IOS software, enter the following commands:


Step 1 Enter the enable command.

AS5400> enable

Step 2 Enter your password.

Password: password
AS5400# 

You are in privileged EXEC mode when the prompt changes to AS5350# or AS5400#.

Step 3 Enter global configuration mode by typing the configure terminal command.

AS5400# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
AS5400(config)#

You are in global configuration mode when the prompt changes to AS5350(config)# or AS5400(config)#.


Step 4 Enter DSP configuration mode. You can either delete the configuration for a single DSP, or a range of DSPs by specifying the first and last DSP in the range. The DSP firmware used by the DSPs automatically reverts to the version bundled with the current Cisco IOS image.

AS5400(config)# voice dsp slot/dsp

or

AS5400(config)# voice dsp slot/dsp slot/dsp

You are in DSP configuration mode when the prompt changes to AS5400(config-voicedsp)#.

Step 5 If the previous download was unbundled firmware, enter the no form of the firmware location command to revert to the default Cisco IOS bundled DSP firmware:

AS5400(config-voicedsp)# no firmware location

Step 6 Type the exit command to exit DSP configuration mode.

AS5400(config-voicedsp)# exit
AS5400(config)# 

Step 7 Press the Enter key to verify your command registers, and then type Ctrl-Z to return to privileged EXEC mode.

AS5400(config)# Ctrl-Z
AS5400#

Step 8 Save your changes.

AS5400# copy running-config startup-config


Using the AMR-NB Codec


Note You must buy a license to access the DSPWare that supports the AMR-NB codec. It is recommended that you purchase a Cisco SMARTnet contract in order to streamline the process of getting the AMR-NB codec DSPWare. When obtaining your license, use the following part numbers:
FR535XM-AMR-LIC for the Cisco AS5350XM
FR54XM-AMR-LIC for the Cisco AS5400XM
For more information, contact your Cisco representative or visit the following Cisco.com website to obtain a Cisco SMARTnet contract:
http://www.cisco.com/en/US/partner/products/svcs/ps3034/ps2827/ps2978/serv_datasheet09186a0080092491.html


The Adaptive Multirate Narrow Band (AMR-NB) codec is a high complexity multimode codec that supports eight narrowband speech encoding modes with bit rates between 4.75 and 12.2 kbps. The sampling frequency used in AMR-NB is 8000 Hz and the speech encoding is performed on 20 ms speech frames. Therefore, each encoded AMR-NB speech frame represents 160 samples of the original speech.

The AMR-NB codec was originally developed and standardized by the European Telecommunications Standards Institute (ETSI) for Groupe Speciale Mobile (GSM) cellular systems. and chosen by the Third Generation Partnership Project (3GPP) as the mandatory codec for third generation (3G) cellular systems.

Table 11 contains codec mode and bit rate information for the AMR codec.

Table 11 AMR Codec Modes and Bit Rates

Codec Mode
Bit Rate (kbps)

0

4.75

1

5.15

2

5.90

3

6.70

4

7.40

5

7.95

6

10.2

7

12.2

81

1.80

1 Used for Silence Indication Detection(SID) frames.


How the AMR-NB Codec Works

The multirate encoding (or multimode) capability of AMR-NB is designed for preserving high speech quality under a wide range of transmission conditions. Unlike other codecs, the AMR-NB codec can adapt to different bit rates (see Table 11) based on channel conditions during the call.

To perform mode adaptation, the decoder (speech receiver) sends a signal to the encoder (speech sender) to indicate which new mode it prefers. This mode-change signal is called codec mode request (CMR). Because speech is sent in both directions between the two ends in most sessions, the mode requests from the decoder at one end to the encoder at the other end are sent in a piggyback form over the speech frames in the reverse direction; there is no out-of-band signaling needed for sending CMRs. The Cisco AS5400XM and Cisco AS5350XM cannot initiate CMRs and received CMRs can be processed. For more information about AMR-NB codecs, see RFC3267.

Restrictions for the AMR-NB Codec

The following message is displayed when an upgrade takes place if a version of DSPWare other than the recommended version is uploaded:

WARNING: Recommended GSM AMR-NB supported DSPWare for this Cisco IOS image is X.Y.Z Where 
X.Y.Z changes depending on the Cisco IOS image that is used by the customer.

This warning has no impact on the firmware upgrade and calls can be brought up with a version of DSPWare that is not the recommended version.

Where to Go Next

At this point you can go to these references:

Chapter 7, "Configuring Voice over IP," to learn how to configure voice and fax traffic over an IP network.

Appendix C, "Comprehensive Configuration Examples"


Tip The following publications are available on the Documentation DVD, or on the World Wide Web from the Cisco home page.


The High-Density Packet Voice Feature Card for Cisco AS5350XM and AS5400XM Universal Gateways document, available online at:
http://www.cisco.com/en/US/products/ps6706/products_feature_guide09186a008060df15.html

For more advanced configuration topics, see the Cisco IOS software configuration guide, feature modules, and command reference publications Dial Solutions Configuration Guide and Dial Solutions Command Reference Guide for your Cisco IOS release.