cc/td/doc/product/wanbu/825
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Voice Port Commands

Voice Port Commands

This chapter describes commands used to configure the voice port parameters on a Cisco 3800 system and display their statistics. The majority of voice interface configuration parameters handle electrical configuration of the actual interface, tuning the quality of the voice you hear over the connection.

Voice traffic is switched rather than routed, so many voice parameters are unique to the switching environment, although they retain the functionality and features required by routing applications. Commands are listed in Table 4-1, Table 4-2, and Table 4-3 and are described in detail later in this chapter.


Table  4-1: Commands to Assign Characteristics to Voice Ports
Command Description
accept-qos Specify minimum quality-of-service of calls for the voice-peer
coder Configure coder for voice compression
cptone Configure call progress tones
dest-pat Associate a dialed number with the current voice-peer
dial-peer Create, delete, and configure dial-peer table entries
dial-prefix Specify a dial prefix to use for outbound calls
dial-type Configure dialing mode as pulse or dtmf on voice port
echo-cancel Enable echo cancellation
em signal Configure E&M tie line trunk signaling
fax-relay Enable or disable the fax and set the fax transmission rate
gain Configure input or output gain for a selected voice port
gen-noise Enable automatic noise generation
group Assign a dial-peer group's dialed number with a voice peer
number-expansion Specify a speed dial number
port Bind a voice port to the current voice-peer
pvc signaling Configure PVC signaling for transparent or translated mode
request-qos Request quality-of-service for calls to the voice-peer
shutdown Take voice interface off line
svc Specify SVC bandwidth negotiation and quality of service
timing Configure timing requirements
vad Configure voice activity detection on a line

Table  4-2:
Commands to Display the Status of Voice Ports
Command Description
show dial-peer Display a summary of dial peers or a detail of a dial peer
show number-expansion Display all speed dial codes and their contents
show voice call-volume Display call volume for the specified trunk
show voice port Display all voice configuration statistics and information
show voice qos Display quality of service statistics for each call

Table  4-3:
Command to Clear or Reset Voice Ports
Command Description
clear voice-counters Clear all voice statistics and error counters

Quick Reference of Voice Commands and Modes

Figure 4-1 illustrates configuration modes and the voice commands.


Figure 4-1: Voice Commands with Modes and Prompts



accept-qos

Specifies the minimum quality-of-service of calls to be accepted by the current voice-peer. Enter this command from the dial peer configuration mode.

Europa(conf-dial-peer)# accept-qos { best-effort | controlled-load | controlled-delay | predicted-delay | guaranteed-delay }
Syntax Description
best-effort Requires incoming calls to have a minimum of the highest quality of service.
controlled-load Requires incoming calls to be accepted within a controlled load (is there a specified amount of time or bandwidth).
controlled-delay Requires incoming calls be accepted after a controlled delay of the specified time.
predicted-delay Requires incoming calls to be accepted after a predicted delay of the specified time.
guaranteed-delay Sets the current voice-peer to respond after a guaranteed delay of the specified time.
Example

The following example specifies that a minimum quality of service for the currently selected voice peer will be best effort:

Europa(conf-dial-peer)# accept-qos best-effort
Related commands

request-qos

show voice qos

clear voice-counters

Clears all voice statistics and error counters for a port.

Europa(conf-voice) #clear voice counters slot/port
Syntax Description
slot/port Optional. With this parameter, only the voice-interface you specify is cleared. Otherwise, all are cleared.
Examples

The first voice port (0) on the card installed in the third slot (2) has all its statistics and error counters reset to zero in this example:

Europa(conf-voice) #clear voice-port 2/0

All voice ports on all cards installed in the Cisco 3800 system have their statistics and error counters reset to zero in this example:

Europa(conf-voice) #clear voice-port

coder

Configures the algorithm for voice compression.


Note The actual algorithm being used for a call may differ as a result of call negotiation.
Europa(conf-voice) #coder { adpcm32k | adpcm24k |adpcm16k | ldcelp16k | csacelp8k}
Syntax Description
adpcm32k ITU G.726 standard, 32k rate
adpcm24k ITU G.726 standard, 24k rate
adpcm16k ITU G.726 standard, 16k rat.
ldcelp16k ITU G.728 standard, 16k rate (default)
csacelp8k ITU G.729 standard, 8k rate

cptone

Each country has a standard set of ring cadences or call progress tones that indicate the state of the call, such as call ringing, line busy, all circuits busy, and so forth. This commands configures the call progress tones to use according to your area's local convention.

Europa(conf-voice)#cptone country
Syntax Description
country Choose one of the parameters describing the type of tone used locally:

· northamerica

· unitedkingdom

· germany

· france

· japan

· australia

· brazil

· china

dest-pat

Associates a dialed number with the current voice-peer.

Europa(conf-dial-peer)#group tag destination-pattern number
Syntax Description
tag The numeric identifier of the voice dial peer.
number E.164 number or prefix.
Related Commands

show dial-peer

dial-peer

To create and configure dial-peer table entries to bind E.164 numbers to voice interfaces:

Europa(conf)#dial-peer voice tag pots

To delete dial-peer table entries:

Europa(conf)#no dial-peer voice tag pots
Syntax Description
tag A numeric identifier for this peer, unique to this node.

Note Once you enter the dial-peer command, whether creating a new entry or referring to an existing tag, the prompt changes to reflect dial peer configuration mode, characterized by the config-dial-peer prompt.
Related Commands

accept-qos

dest pat

dial-prefix

group

number-expansion

port

request-qos

svc

svc dial-peer voice

dial-prefix

Specifies a dial prefix that will be automatically dialed out on the interface terminating the voice call. Used for outbound calls coming from the interface associated with the current voice-peer.

Europa(conf-dial-peer)#dial-prefix dial-string
Syntax Description
dial-string A string of digits with commas (,) indicating pauses, and plus signs (+) indicating substitutions in the destination path.

dial-type

Configures the dialing type of the selected voice interface. Your telephone may have both settings. Make sure the setting on your phone matches the setting here.

Europa(conf-voice)#dial-type { pulse | dtmf }
Syntax Description
pulse Sets the dial-type to pulse. Dial digits are transmitted using a series of pulses.
dtmf Sets the dial-type to dual tone multifrequency dialing, also known as touch tone.
Related Commands

timing

echo-cancel

Enables the integrated echo cancellation feature with optional nonlinear processing. Use the no form of this command to disable the echo canceller selected.

Europa(conf-voice)#echo-cancel non-linear
Europa(conf-voice)#no echo-cancel
Syntax Description
non-linear Specifies that you would like to enable the nonlinear echo canceller option.


em signal

Configures E&M tie line signaling.

Europa(conf-voice)#em signal { wink-start | immediate | delay-dial }
Syntax Description
wink-start Start on receiving wink.
immediate Start immediately.
delay-dial Delay before dialing.

fax-relay

Enables and disables the fax relay on detecting a fax signal and sets the desired fax transmission rate. All choices are bit rates, except for voice, which means use the currently configured voice rate.

To enable the fax relay:

Europa(conf-voice)#fax-relay rate { voice | r2400 | r4800 | r7200 | r9600 | r14400}

To enable the fax relay at the default rate:

Europa(conf-voice)#no fax-relay

To disable the fax relay:

Europa(conf-voice)#fax-relay disable
Syntax Description
rate Indicates that you will enable the fax relay at the rate you specify.
voice Uses the currently configured voice rate.
r2400 Uses 2,400 bps fax rate.
r4800 Uses 4,800 bps fax rate.
r7200 Uses 7,200 bps fax rate.
r9600 Uses 9,600 bps fax rate.
r14400 Uses 14,400 bps fax rate.
disable Disables the fax relay.
Example

To enable the fax relay on a selected voice port at 9600 bps:

Europa(conf-voice)# fax-relay rate r9600

gain

Configures the input or output gain of the selected voice interface.


Note The gain is set from global configuration mode once you specify a slot and port.
Europa(conf-voice)# gain input gain-level
Europa(conf-voice)# gain output gain-level
Syntax Description
gain-level The level of input or output gain in decibels. The accepted range is from -6 to +14.
Examples

The following example sets the V2 voice port's input gain to -6 dB. The voice and data card is installed in the first slot:

voice-port 0/1 
gain input -6

The following example sets the V1 voice port's output gain to 11 dB. The voice and data card is installed in the first slot.

voice-port 0/0
gain output 11

gen-noise

Enables an automatically generated background noise during dead time, providing listeners with reassurance that the line has not been dropped. Use the no form of this command to disable automatic background noise generation.

To enable automatic background noise generation:

Europa(conf-voice)# gen-noise
Europa(conf-voice)# no gen-noise
Related commands

echo-cancel

vad

group

Associates a dialed number with the current voice-peer.

Europa(conf-dial-peer)# group tag destination-pattern number
Syntax Description
tag The numeric identifier of the voice dial peer.
number E.164 number or prefix.

number-expansion

Sets a translation between an abbreviated number and a full E.164 (telephone) number. This feature is also referred to as speed dial. Use the no form of this command to delete a speed dial reference.

Europa (conf)#number-expansion dialed-number translation
Europa (conf)#no number-expansion dialed-number translation
Syntax Description
dialed-number A simple regular expression, which may contain the following:

· Digits, characters, and symbols: 0-9, #, *, A, B, C, or D.

· "." represents any single digit as defined above.

· * to indicate collecting digits until a timeout.

For example, to indicate a 7 followed by 4 required digits and 0-3 optional digits, enter 7...[.]{0,3}.

translation An E.164 number or prefix used to translate the dialed number. If this translation is a prefix, it will be prepended to all nonspecified digits in the dialed number pattern.
Example

If the number expansion entry is 7...[.]{0,3} +1408527, and the number dialed is 74321, the resulting translation would be +14085274321.

port

Binds a voice interface to the current voice-peer.

Europa(conf-dial-peer)#port slot/port
Syntax Description
slot/port Defines the slot the port's card is installed in and the actual port number.

pvc signaling

Configures PVC signaling for translated or transparent mode. Translated mode is necessary for FXS-to-FXS connections and FXS-to-E&M connections.

Europa(conf-dial-peer)# pvc signaling { normal | translated }
Syntax Description 2
normal Pass and receive bits with their normal settings, as if through a wire.
translated Translate signaling bits between their native interface significance and E&M protocol.

request-qos

Requests a quality-of-service for calls to the current voice-peer.

Europa(conf-dial-peer)# request-qos { best-effort | controlled-load | controlled-delay | predicted-delay | guaranteed-delay }
Syntax Description
best-effort Requires incoming calls to have a minimum of the highest quality of service.
controlled-load Requires incoming calls to be accepted within a controlled load.
controlled-delay Requires incoming calls be accepted after a controlled delay of the specified time.
predicted-delay Requires incoming calls to be accepted after a predicted delay of the specified time.
guaranteed-delay Sets the current voice-peer to respond after a guaranteed delay of the specified time.
Example

To request best-effort quality of service for the currently selected voice-peer's calls:

Europa(conf-dial-peer)# request-qos best-effort
Related Commands

accept-qos

show voice qos

show dial-peer

Display a summary of all dial-peers or detailed information about the configuration of a specific dial- peer you identify with a tag.

Europa# show dial-peer voice tag
Syntax Description
tag Optional. If present, only the one dial-peer specified is shown in detail. Otherwise, all are shown in summary.
Example

The following example shows the display resulting from a request to list a dial peer's associated destination patterns:

Europa#sh dial-peer voice
C3800 Database Dial Plan Table:
   ATM Address 0800.3e01.0228-8.64.2, Destination Pattern 4000
   ATM Address 0800.3e01.0228-8.64.1, Destination Pattern 2000
   ATM Address 0800.3e01.02ad-8.64.1, Destination Pattern 1000
   ATM Address 0800.3e01.02ad-8.64.2, Destination Pattern 3000
Europa#
Related Commands

dest pat

dial-peer

show number-expansion

Display all dialed number strings and their translations.

Europa# show number-expansion

show voice call-volume

Display call volume for the trunk specified.

Europa# show voice call-volume trunk

show voice port

Display all voice configuration information as well as statistics and other information.

Europa# show voice port slot/port
Syntax Description
slot/port Optional. Indicates the specific voice interface you would like to display. If not, all are shown.
Example

Displays the status of the second voice port, V2, on the first card installed:

Europa# show voice port 0/1

show voice qos

Display quality of service statistics for each call.

Europa# show voice qos

shutdown

Takes the voice interface off-line. During configuration or testing, a voice interface can be taken off-line. This will busy out the interface and prevent connections from being made. Use the no form of this command to bring voice interface back on-line.

Europa(conf-voice)# shutdown
Europa(conf-voice)# no shutdown

svc

Allows switched virtual circuit calls. If a call is initiated at the voice port, the dial peer you specify with this command is used to negotiate bandwidth and quality of service. Use the no form of this command to disable switched virtual circuit calls.

Europa(conf-voice)# svc dial-peer voice tag
Europa(conf-voice)# no svc dial-peer voice 
Syntax Description
tag The numeric identifier of the voice dial peer.

timing

Configures timing requirements. The Cisco 3800 can connect to a variety of products with different timing requirements for detecting digits, pulses, and winks.

Europa(conf-voice)# timing { digit | inter-digit | pulse | pulse-inter-digit | clear-wait | wink-wait | wink-duration | delay-start | delay-duration } amount_of_time
Syntax Description
digit DTMF digit duration in milliseconds (50-500, default 100).
inter-digit DTMF interdigit duration in milliseconds (50-500, default 100).
pulse Pulse dialing rate in pulses per second (pps) (10-20, default 20).
pulse-inter-digit Pulse dialing interdigit timing in microseconds (100-1000, default 500).
clear-wait Time of Inactive seizure signal to declare a call cleared (100-2000, default 500).
wink-wait Maximum wink wait duration for wink start signaling (100-5000, default 50).
wink-duration Maximum wink duration for wink start signaling (100-400, default 50).
delay-start Timing of the generation of the delay start signal from detection of incoming seizure (20-200, default 50).
delay-duration Maximum delay signal duration for delay dial signaling (100-5000, default 50).
amount_of_time Enter the actual value within the acceptable range of the timing selection you have made. If you do not enter a value, the default indicated will be used.
Example

The following command sets the maximum wink wait duration for wink-wait signaling to 30 milliseconds.

Europa(conf-voice)# timing wink-wait 30

vad

Enables voice activity detection. With VAD enabled, data cannot be transmitted when no sound is detected. Use the no form of this command to disable VAD.

To enable VAD:

Europa(conf-voice)# vad
Europa(conf-voice)# no vad
Related commands

gen-noise

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.