VP 15 MT Book PDF
VP 15 MT Book PDF
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
CHAPTER 10 Configuring Hardware Echo Cancellation on T1 E1 Multiflex Voice WAN Interface Cards 147
Finding Feature Information 147
Prerequisites for Hardware Echo Cancellation 148
Cisco IOS Image 148
Baseboard and Daughter Card Configuration 148
Restrictions for Hardware Echo Cancellation 148
Hardware Echo Cancellation Tail Length 148
Accurate TDM ERL Readings for Echo Cancellation 148
devices at both ends of the call segment (that is, those directly connected to each other) must use the same
type of signaling.
The devices in the packet network must be configured to convey signaling information in a way that the
circuit-switched network can understand. They must also be able to understand signaling information received
from the circuit-switched network. This is accomplished by installing appropriate voice hardware in the router
or access server and by configuring the voice ports that connect to telephony devices or the circuit-switched
network.
The following illustrations show examples of how voice ports are used.
• The "Telephone to WAN" figure shows one voice port connecting a telephone to the WAN through the
router.
• The "Telephone to PSTN" figure shows one voice port connected to the PSTN and another to a telephone;
the router acts like a small PBX.
• The "PBX-to-PBX over a WAN" figure shows how two PBXs can be connected over a WAN to provide
toll bypass.
Cisco provides a variety of Cisco IOS commands for flexibility in configuring voice ports to match the physical
attributes of the voice connections that are being made. Some of these connections are made using analog
means of transmission, while others use digital transmission. The table below shows the analog and digital
voice-port connection support of the router platforms discussed in this document.
The next three illustrations show how the different signaling interfaces are associated with different uses of
voice ports. In the "FXS Signaling Interfaces" figure, FXS signaling is used for end-user telephony equipment,
such as a telephone or fax machine. The "FXS and FXO Signaling Interfaces" figure shows an FXS connection
to a telephone and an FXO connection to the PSTN at the far side of a WAN; this might be a telephone at a
local office going over a WAN to a router at headquarters that connects to the PSTN. In the "E&M Signaling
Interfaces" figure, two PBXs are connected across a WAN by E&M interfaces. This illustrates the path over
a WAN between two geographically separated offices in the same company.
FXO and FXS interfaces indicate on-hook or off-hook status and the seizure of telephone lines by one of two
access signaling methods: loop-start or ground-start. The type of access signaling is determined by the type
of service from the CO; standard home telephone lines use loop-start, but business telephones can order
ground-start lines instead.
Loop-start is the more common of the access signaling techniques. When a handset is picked up (the telephone
goes off-hook), this action closes the circuit that draws current from the telephone company CO and indicates
a change in status, which signals the CO to provide dial tone. An incoming call is signaled from the CO to
the handset by sending a signal in a standard on/off pattern, which causes the telephone to ring.
Loop-start has two disadvantages, however, that usually are not a problem on residential telephones but that
become significant with the higher call volume experienced on business telephones. Loop-start signaling has
no means of preventing two sides from seizing the same line simultaneously, a condition known as glare.
Also, loop-start signaling does not provide switch-side disconnect supervision for FXO calls. The telephony
switch (the connection in the PSTN, another PBX, or key system) expects the router’s FXO interface, which
looks like a telephone to the switch, to hang up the calls it receives through its FXO port. However, this
function is not built into the router for received calls; it operates only for calls originating from the FXO port.
Another access signaling method used by FXO and FXS interfaces to indicate on-hook or off-hook status to
the CO is ground-start signaling. It works by using ground and current detectors that allow the network to
indicate off-hook or seizure of an incoming call independent of the ringing signal and allow for positive
recognition of connects and disconnects. For this reason, ground-start signaling is typically used on trunk
lines between PBXs and in businesses where call volume on loop-start lines can result in glare. See the
"Configuring Disconnect Supervision" and "Configuring FXO Supervisory Disconnect Tones" sections in
the "Fine-Tuning Analog and Digital Voice Ports" chapter for voice port commands that configure additional
recognition of disconnect signaling.
In most cases, the default voice port command values are sufficient to configure FXO and FXS voice ports.
E and M Interfaces
Trunk circuits connect telephone switches to one another; they do not connect end-user equipment to the
network. The most common form of analog trunk circuit is the E&M interface, which uses special signaling
paths that are separate from the trunk’s audio path to convey information about the calls. The signaling paths
are known as the E-lead and the M-lead. The name E&M is thought to derive from the phrase Ear and Mouth
or rEceive and transMit although it could also come from Earth and Magnet. The history of these names
dates back to the days of telegraphy, when the CO side had a key that grounded the E circuit, and the other
side had a sounder with an electromagnet attached to a battery. Descriptions such as Ear and Mouth were
adopted to help field personnel determine the direction of a signal in a wire. E&M connections from routers
to telephone switches or to PBXs are preferable to FXS/FXO connections because E&M provides better
answer and disconnect supervision.
Like a serial port, an E&M interface has a data terminal equipment/data communications equipment (DTE/DCE)
type of reference. In telecommunications, the trunking side is similar to the DCE, and is usually associated
with CO functionality. The router acts as this side of the interface. The other side is referred to as the signaling
side, like a DTE, and is usually a device such as a PBX. Five distinct physical configurations for the signaling
part of the interface (Types I-V) use different methods to signal on-hook/off-hook status, as shown in the
table below. Cisco voice implementation supports E&M Types I, II, III, and V.
E&M Type E-Lead M-Lead Signal Battery Lead Signal Ground Lead
Configuration Configuration Configuration Configuration
I Output, relay to Input, referenced to -- --
ground ground
The physical E&M interface is an RJ-48 connector that connects to PBX trunk lines, which are classified as
either two-wire or four-wire. This refers to whether the audio path is full duplex on one pair of wires (two-wire)
or on two pair of wires (four-wire). A connection may be called a four-wire E&M circuit although it actually
has six to eight physical wires. It is an analog connection although an analog E&M circuit may be emulated
on a digital line. For more information on digital voice port configuration of E&M signaling, see the "DS0
Groups on Digital T1/E1 Voice Ports" section in the "Configuring Digital Voice Ports" chapter .
PBXs built by different manufacturers can indicate on-hook/off-hook status and telephone line seizure on the
E&M interface by using any of the following three types of access signaling:
• Immediate-start is the simplest method of E&M access signaling. The calling side seizes the line by
going off-hook on its E-lead and sends address information as dual-tone multifrequency (DTMF) digits
(or as dialed pulses on Cisco 2600 and Cisco 3600 series routers) following a short, fixed-length pause.
• Wink-start is the most commonly used method for E&M access signaling, and is the default for E&M
voice ports. Wink-start was developed to minimize glare, a condition found in immediate-start E&M,
in which both ends attempt to seize a trunk at the same time. In wink-start, the calling side seizes the
line by going off-hook on its E-lead, then waits for a short temporary off-hook pulse, or "wink," from
the other end on its M-lead before sending address information. The switch interprets the pulse as an
indication to proceed and then sends the dialed digits as DTMF or dialed pulses.
• In delay-dial signaling, the calling station seizes the line by going off-hook on its E-lead. After a timed
interval, the calling side looks at the status of the called side. If the called side is on-hook, the calling
side starts sending information as DTMF digits; otherwise, the calling side waits until the called side
goes on-hook and then starts sending address information.
public-switched telephone network (PSTN) gateways, and Cisco contact-center VoiceXML gateways. These
features include, but are not limited to, the following:
• Disable secondary dial tone on voice ports--By default, secondary dial tone is presented on voice ports
on Cisco router gateways. Use private line automatic ringdown (PLAR) for foreign exchange office
(FXO) ports and direct-inward-dial (DID) for T1/E1 ports to prevent secondary dial tone from being
presented to inbound callers.
• Cisco router access control lists (ACLs)--Define ACLs to allow only explicitly valid sources of calls to
the router or gateway, and therefore to prevent unauthorized Session Initiation Protocol (SIP) or H.323
calls from unknown parties to be processed and connected by the router or gateway.
• Close unused SIP and H.323 ports--If either the SIP or H.323 protocol is not used in your deployment,
close the associated protocol ports. If a Cisco voice gateway has dial peers configured to route calls
outbound to the PSTN using either time division multiplex (TDM) trunks or IP, close the unused H.323
or SIP ports so that calls from unauthorized endpoints cannot connect calls. If the protocols are used
and the ports must remain open, use ACLs to limit access to legitimate sources.
• Change SIP port 5060--If SIP is actively used, consider changing the port to something other than
well-known port 5060.
• SIP registration--If SIP registration is available on SIP trunks, turn on this feature because it provides
an extra level of authentication and validation that only legitimate sources can connect calls. If it is not
available, ensure that the appropriate ACLs are in place.
• SIP Digest Authentication--If the SIP Digest Authentication feature is available for either registrations
or invites, turn this feature on because it provides an extra level of authentication and validation that
only legitimate sources can connect calls.
• Explicit incoming and outgoing dial peers--Use explicit dial peers to control the types and parameters
of calls allowed by the router, especially in IP-to-IP connections used on CME, SRST, and Cisco UBE.
Incoming dial peers offer additional control on the sources of calls, and outgoing dial peers on the
destinations. Incoming dial peers are always used for calls. If a dial peer is not explicitly defined, the
implicit dial peer 0 is used to allow all calls.
• Explicit destination patterns--Use dial peers with more granularity than .T for destination patterns to
block disallowed off-net call destinations. Use class of restriction (COR) on dial peers with specific
destination patterns to allow even more granular control of calls to different destinations on the PSTN.
• Translation rules--Use translation rules to manipulate dialed digits before calls connect to the PSTN to
provide better control over who may dial PSTN destinations. Legitimate users dial an access code and
an augmented number for PSTN for certain PSTN (for example, international) locations.
• Tcl and VoiceXML scripts--Attach a Tcl/VoiceXML script to dial peers to do database lookups or
additional off-router authorization checks to allow or deny call flows based on origination or destination
numbers. Tcl/VoiceXML scripts can also be used to add a prefix to inbound DID calls. If the prefix plus
DID matches internal extensions, then the call is completed. Otherwise, a prompt can be played to the
caller that an invalid number has been dialed.
• Host name validation--Use the "permit hostname" feature to validate initial SIP Invites that contain a
fully qualified domain name (FQDN) host name in the Request Uniform Resource Identifier (Request
URI) against a configured list of legitimate source hostnames.
• Dynamic Domain Name Service (DNS)--If you are using DNS as the "session target" on dial peers, the
actual IP address destination of call connections can vary from one call to the next. Use voice source
groups and ACLs to restrict the valid address ranges expected in DNS responses (which are used
subsequently for call setup destinations).
For more configuration guidance, see the " Cisco IOS Unified Communications Toll Fraud Prevention " paper.
• Install appropriate voice processing and voice interface hardware on the router. See the Information
About Analog Voice Hardware, on page 10.
• Gather the following information about the telephony connection of the voice port:
• Telephony signaling interface: FXO, FXS, or E&M
• Locale code (usually the country) for call progress tones
• If FXO, type of dialing: DTMF (touch-tone) or pulse
• If FXO, type of start signal: loop-start or ground-start
• If E&M, type: I, II, III, or V
• If E&M, type of line: two-wire or four-wire
• If E&M, type of start signal: wink, immediate, delay-dial
If you are connecting a voice-port interface to a PBX, it is important to understand the PBX’s wiring scheme
and timing parameters. This information should be available from your PBX vendor or the reference manuals
that accompany your PBX.
Note The slot and port numbering of interface cards differs for each of the voice-enabled routers. For the specific
slot and port designations for your hardware platform, refer to the Cisco Interface Cards Hardware
Installation Guides. More current information may be available in the release notes for the Cisco IOS
software you are using.
Note For current information about supported hardware, refer to the release notes for the platform and Cisco
IOS release being used.
Note If the primary voice interface is FXS and the backup is BRI, then ports 0, 1, 2, and 3 are analog voice
ports, and ports 4 and 5 are digital. If the primary voice interface is BRI, then ports 1, 2, 3, and 4 are
digital.
The C881 and C888 SRST models automatically detect a failure occuring in the network and initiate a process
to auto-configure the router. This process provides call-processing backup redundancy for the IP and FXS
phones and helps to ensure that telephony capabilities stay operational. All the IP or analog phones hanging
off of a telecommuter site are controlled by the headquarters office call control (Cisco Unified CallManager
or CallManager Express). In case of a WAN failure, the telecommuter router allows all phones to re-register
to it in SRST mode and allow all inbound and outbound dialing to be routed off to the PSTN (using back up
FXO or BRI port). Upon restoration of WAN connectivity, the system automatically shifts call processing
back to the primary Cisco Unified Call Manager cluster.
Cisco MC3810
To support analog voice circuits, a Cisco MC3810 must be equipped with an AVM, which supports six analog
voice ports. When you install specific signaling modules known as analog personality modules (APMs), the
analog voice ports may be equipped for the following signaling types in various combinations: FXS, FXO,
and E&M. For FXS, the analog voice ports use an RJ-11 connector interface to connect to analog telephones
or fax machines (two-wire) or to a key system (four-wire). For FXO, the analog voice ports use an RJ-11
physical interface to connect to a CO trunk. For E&M connections, the analog voice ports use an RJ-1CX
physical interface to connect to an analog PBX (two-wire or four-wire).
Optional high-performance voice compression modules (HCMs) can replace standard voice compression
modules (VCMs) to operate according to the voice compression coding algorithm (codec) specified when the
Cisco MC3810 concentrator is configured. The HCM2 provides four voice channels at high codec complexity
and eight channels at medium complexity. The HCM6 provides 12 voice channels at high complexity and 24
channels at medium complexity. One or two HCMs can be installed in a Cisco MC3810, but an HCM may
not be combined with a VCM in one chassis.
For more information, refer to the Cisco MC3810 Multiservice Concentrator Hardware Installation Guide .
Note For current information about supported hardware, refer to the release notes for the platform and Cisco
IOS release you are using.
Note If you have a Cisco MC3810 or Cisco 3660 router, the compand-type a-law command must be configured
on the analog ports only. The Cisco 2660, Cisco 3620, and Cisco 3640 routers do not require the
configuration of the compand-type a-law command. However, if you request a list of commands, the
compand-type a-law command will display.
In addition to the basic voice port parameters described in this section, there are commands that allow voice
port configurations to be fine-tuned. In most cases, the default values for fine-tuning commands are sufficient
for establishing FXO and FXS voice port configurations. E&M voice ports are more likely to require some
configuration. If it is necessary to change some of the voice port values to improve voice quality or to match
parameters on proprietary PBXs to which you are connecting, use the commands in this section and also in
the "Fine-Tuning Analog and Digital Voice Ports" chapter.
After the voice port has been configured, make sure that the ports are operational by performing the tasks
described in the following chapters:
• "Verifying Analog and Digital Voice-Port Configuration"
For more information on these and other voice port commands, refer to the Cisco IOS Voice Command
Reference.
Note The commands, keywords, and arguments that you are able to use may differ slightly from those presented
here, based on your platform, Cisco IOS release, and configuration. When in doubt, use Cisco IOS command
help to determine the syntax choices that are available.
Codec Complexity for Analog Voice Ports on the Cisco MC3810 with
High-Performance Compression Modules
The term codec stands for coder-decoder. A codec is a particular method of transforming analog voice into
a digital bit stream (and vice versa) and also refers to the type of compression used. Several different codecs
have been developed to perform these functions, and each one is known by the number of the International
Telecommunication Union-Telecommunication Standardization Sector (ITU-T) standard in which it is defined.
For example, two common codecs are the G.711 and the G.729 codecs. The various codecs use different
algorithms to encode analog voice into digital bit-streams and have different bit rates, frame sizes, and coding
delays associated with them. The codecs also differ in the type of perceived voice quality they achieve.
Specialized hardware and software in the digital signal processors (DSPs) perform codec transformation and
compression functions, and different DSPs may offer different selections of codecs.
Select the same type of codec as the one that is used at the other end of the call. For instance, if a call was
coded with a G.729 codec, it must be decoded with a G.729 codec. Codec choice is configured in dial peers.
For more information, refer to the "Dial Peer Configuration on Voice Gateway Routers" document.
Codec complexity refers to the amount of processing power that a codec compression method requires. The
greater the codec complexity, the fewer the calls that the DSP interfaces can handle. Codec complexity is
either medium or high. The default is medium. All medium-complexity codecs can also run in high-complexity
mode, but fewer (usually half as many) channels are available per DSP. The codec complexity value determines
the choice of codecs that are available in the dial peers when the codec command has been configured. For
details on the number of calls that can be handled simultaneously using each of the codec standards, refer to
the entries for the codecand codec complexity commands in the Cisco IOS Voice Command Reference.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
• voice-port slot / port
5. cptone locale
6. dial-type {dtmf | pulse}
7. operation {2-wire | 4-wire}
8. type {1 | 2 | 3 | 5}
9. Do one of the following:
• ring frequency {25 | 50}
•
•
• ring frequency {20 | 30}
DETAILED STEPS
Example:
Router# configure terminal
Step 4 Do one of the following: Selects the access signaling type to match that of the telephony
connection you are making.
• signal {loop-start | ground-start}
Note Configuring the signal keyword for one voice port on a Cisco
2600 or Cisco 3600 series router VIC changes the signal value
Example: for both ports on the VIC.
Router(config-voiceport)# signal
ground-start
Example:
signal {wink-start | immediate-start |
delay-dial}
Example:
Router(config-voiceport)# signal
wink-start
Step 5 cptone locale Selects the two-letter locale for the voice call progress tones and other
locale-specific parameters to be used on this voice port.
Example: • Cisco routers comply with the ISO 3166 locale name standards.
Router(config-voiceport)# cptone us To see valid choices, enter a question mark (?) following the
cptone command.
• The default is us.
Step 6 dial-type {dtmf | pulse} (FXO only) Specifies the dialing method for outgoing calls.
Example:
Router(config-voiceport)# dial-type dtmf
Step 8 type {1 | 2 | 3 | 5} (E&M only) Specifies the type of E&M interface to which this voice
port is connecting. See Table 2 in the "Voice Port Configuration
Example: Overview" chapter for an explanation of E&M types.
Step 9 Do one of the following: (FXS only) Selects the ring frequency, in hertz, used on the FXS
interface. This number must match the connected telephony equipment
• ring frequency {25 | 50} and may be country-dependent. If the ring frequency is not set properly,
• the attached telephony device may not ring or it may buzz.
• • The keyword default is 25 on the Cisco 1750 router, Cisco 2600
• ring frequency {20 | 30} and Cisco 3600 series routers; and 20 on the Cisco MC3810.
Example:
Router(config-voiceport)# ring frequency
50
Example:
Router(config-voiceport)# ring frequency
30
Step 10 ring number number (FXO only) Specifies the maximum number of rings to be detected
before an incoming call is answered by the router.
Example: • The default is 1.
Router(config-voiceport)# ring number 1
Step 11 ring cadence {[pattern01 | pattern02 | (FXS only) Specifies an existing pattern for ring, or defines a new one.
pattern03 | pattern04 | pattern05 | pattern06 Each pattern specifies a ring-pulse time and a ring-interval time.
| pattern07 | pattern08 | pattern09 | pattern10
| pattern11 | pattern12] | [define pulse • The default is the pattern specified by the cptone locale that has
been configured.
interval]}
Example:
Router(config-voiceport)# ring cadence
pattern01
Step 13 no shutdown Activates the voice port. If a voice port is not being used, shut the voice
port down with the shutdown command.
Example:
Router(config-voiceport)# no shutdown
SUMMARY STEPS
1. enable
2. show voice dsp
3. configure terminal
4. voice-card 0
5. codec complexity {high | medium}
DETAILED STEPS
Step 2 show voice dsp Checks the DSP voice channel activity. If any DSP voice channels are
in the busy state, the codec complexity cannot be changed. When all
Example: the DSP channels are in the idle state, continue to Step 3.
Example:
Router# configure terminal
Step 4 voice-card 0 Enters voice-card configuration mode and specifies voice card 0.
Example:
Router(config)# voice-card 0
Step 5 codec complexity {high | medium} Specifies codec complexity based on the codec standard being used.
This setting restricts the codecs available in dial peer configuration.
Example: All voice cards in a router must use the same codec complexity setting.
Router(config-voicecard)# codec Note If two HCMs are installed, this command configures both
complexity high HCMs at once.
For signaling to pass between the packet network and the circuit-switched network, both networks must use
the same type of signaling. The voice ports on Cisco routers and access servers can be configured to match
the signaling of most COs and PBXs, as explained in this document.
The memory required for high-volume applications may be greater than that listed. Support for digital T1
packet voice trunk network modules is included in Plus feature sets. The IP Plus feature set requires 8 MB of
flash memory; other Plus feature sets require 16 MB.
• (Cisco 2600 and Cisco 3600 series routers) For digital E1 packet voice trunk network modules, install
Cisco IOS Release 12.2(1) or a later release. The minimum DRAM memory requirements are:
• 48 MB, with one or two E1s
• 64 MB, with three to eight E1s
• 128 MB, with 9 to 12 E1s
For high-volume applications, the memory required may be greater than these minimum values. Support for
digital E1 packet voice trunk network modules is included in Plus feature sets. The IP Plus feature set requires
16 MB of flash memory.
• Before you can run the IP Communications High-Density Digital Voice/Fax Network Module feature
on T1/E1 interfaces, you must install an IP Plus image (minimum) of Cisco IOS Release 12.3(7)T or a
later release.
• (Cisco MC3810 concentrators) HCMs require Cisco IOS Release 12.2(1) or a later release.
• (Cisco 7200 and Cisco 7500 series routers) For digital T1/E1 voice port adapters, install Cisco IOS
Release 12.2(1) or a later release. The minimum DRAM memory requirement to support T1/E1
high-capacity digital voice port adapters is 64 MB.
The memory required for high-volume applications may be greater than that listed. Support for T1/E1
high-capacity digital voice port adapters is included in Plus feature sets. The IP Plus feature set requires 16
MB of flash memory.
• Gather the following information about the telephony network connection of the voice port:
• Line interface: T1 or E1
• Signaling interface: FXO, FXS, or E&M. If the interfaces are PRI or BRI, refer to the Cisco IOS
ISDN Voice Configuration Guide, and Cisco IOS Terminal Services Configuration Guide.
• Line coding: AMI or B8ZS for T1, and AMI or HDB3 for E1
• Framing format: SF (D4) or ESF for T1, and CRC4 or no-CRC4 for E1
• Number of channels
After the controllers have been configured, the show voice port summarycommand can be used to determine
available voice port numbers. If the show voice port command and a specific port number is entered, the
default voice-port configuration for that port displays.
The following is show voice port summary sample output for a Cisco MC3810:
Note The slot and port numbering of interface cards differs for each of the voice-enabled routers. For specific
slot and port designations, refer to the hardware installation documentation for your router platform. More
current information may be available in the release notes that accompany the Cisco IOS software you are
using.
Note For current information about supported hardware, refer to the release notes for the platform and Cisco
IOS release you are using.
Note If the primary voice interface is FXS and the backup is BRI, then ports 0, 1, 2, and 3 are analog voice
ports, and ports 4 and 5 are digital. If the primary voice interface is BRI, then ports 1, 2, 3, and 4 are
digital.
The digital T1 or E1 packet voice trunk network module contains five 72-pin Single In-line Memory Module
(SIMM) sockets or banks, numbered 0 through 4, for PVDMs. Each socket can be filled with a single 72-pin
PVDM, and there must be at least one packet voice data module (PVDM-12) in the network module to process
voice calls. Each PVDM holds three DSPs, so with five PVDM slots populated, a total of 15 DSPs are provided.
High-complexity codecs support two simultaneous calls on each DSP, and medium-complexity codecs support
four calls on each DSP. A digital T1 or E1 packet voice trunk network module can support the following
numbers of channels:
• When the digital T1 or E1 packet voice trunk network module is configured for high-complexity codec
mode, up to six voice or fax calls can be completed per PVDM-12, using the following codecs: G.711,
G.726, G.729, G729 Annex A (E1), G.729 Annex B, G.723.1, G723.1 Annex A (T1), G.728, and fax
relay.
• When the digital T1 or E1 packet voice trunk network module is configured for medium-complexity
codec mode, up to 12 voice or fax calls can be completed per PVDM-12, using the following codecs:
G.711, G.726, G.729 Annex A, G.729 Annex B with Annex A, and fax relay.
Note For current information about supported hardware, refer to the release notes for the platform and Cisco
IOS release you are using.
Cisco AS5300
The Cisco AS5300 includes three expansion slots. One slot is for either an Octal T1/E1/PRI feature card (eight
ports) or a Quad T1/E1/PRI feature card (four ports), and the other two can be used for voice/fax or modem
feature cards. Because a single voice/fax feature card (VFC) can support up to 48 (T1) or 60 (E1) voice calls,
the Cisco AS5300 can support a total of 96 or 120 simultaneous voice calls.
Cisco AS5300 VFCs are coprocessor cards, each with a powerful reduced instruction set computing (RISC)
engine and dedicated, high-performance DSPs to ensure predictable, real-time voice processing. The design
couples this coprocessor with direct access to the Cisco AS5300 routing engine for streamlined packet
forwarding.
Cisco AS5800
The Cisco AS5800 has two primary system components: the Cisco 5814 dial shelf (DS), which holds
channelized trunk cards and connects to the PSTN, and the Cisco 7206 router shelf (RS), which holds port
adapters and connects to the IP backbone.
The dial shelf acts as the access concentrator by accepting and consolidating all types of remote traffic,
including voice, dial-in analog and digital ISDN data, and industry-standard WAN and remote connection
types. The dial shelf also contains controller cards voice feature cards, modem feature cards, trunk cards, and
dial shelf interconnect cards.
One or two dial shelf controllers (DSCs) provide clock and power control to the dial shelf cards. Each DSC
contains a block of logic that is referred to as the common logic and system clocks. This block of logic can
use a variety of sources to generate the system timing, including an E1 or T1/T3 input signal from the BNC
connector on the front panel of the DSC. The configuration commands for the master clock specify the various
clock sources and a priority for each source (see the Clock Sources on Digital T1 E1 Voice Ports, on page
40).
The Cisco AS5800 voice feature card is a multi-DSP coprocessing board and software package that adds VoIP
capabilities to the Cisco AS5800 platform. The Cisco AS5800 voice feature card, when used with other cards
such as LAN/WAN and modem cards, provides a gateway for up to 192 packetized voice/fax calls and 360
data calls per card. A Cisco AS5800 can support up to 1344 voice calls in split-dial-shelf configuration with
two 7206VXR router shelves.
For more information, refer to the following publications:
• Cisco AS5800 Access Server Hardware Installation Guide
• Cisco AS5800 Operation, Administration, Maintenance, and Provisioning Guide
Cisco Catalyst 6500 Series Switches and Cisco 7600 Series Routers
The Communication Media Module (CMM) acts as the VoIP gateway and media services module by using
Media Gateway Control Protocol (MGCP), H.323, and SIP protocols with Cisco CallManager and other call
agents. The CMM can support single or multiple Cisco CallManagers in an IP communication network.
These VoIP gateway and media services features are provided through the four different types of CMM port
adapters as shown in the table below.
For specific configuration information for the Catalyst 6500 series and Cisco 7600 series, see the following
documents:
• Cisco 6500 and 7600 series Manager Installation Guide, Release 2.1
• Cisco 6500 and 7600 series Manager User Guide, Release 2.1
• Cisco 6500 and 7600 series Manager Release Notes, Release 2.1
For specific installation and configuration information for the CMM, see the following document:
• Catalyst 6500 Series and Cisco 7600 Series CMM Installation and Verification Note
• Cisco Communication Media Module Voice Features for Catalyst 6500 Series and Cisco 7600 Series
Cisco MC3810
To support a T1 or E1 digital voice interface, the Cisco MC3810 must be equipped with a digital voice interface
card (DVM). The DVM interfaces with a digital PBX, channel bank, or video codec. It supports up to 24
channels of compressed digital voice at 8 kbps, or it can cross-connect channelized data from user equipment
directly onto the router’s trunk port for connection to a carrier network.
The DVM is available with a balanced interface using an RJ-48 connector or with an unbalanced interface
using BNC connectors.
Optional HCMs can replace standard VCMs to operate according to the voice compression coding algorithm
(codec) specified when the Cisco MC3810 is configured. The HCM2 provides 4 voice channels at high codec
complexity and 8 channels at medium complexity. The HCM6 provides 12 voice channels at high complexity
and 24 channels at medium complexity. You can install one or two HCMs in a Cisco MC3810, but an HCM
cannot be combined with a VCM in the same chassis.
For more information, refer to the following publications:
• Cisco MC3810 Multiservice Concentrator Hardware Installation Guide
• Cisco MC3810 Multiservice Concentrator Configuration Guide
Note On Cisco 2600, Cisco 3600, and Cisco 3700 series routers with digital T1/E1 packet voice trunk network
modules, codec complexity cannot be configured if DS0 or PRI groups are configured. If DS0 or PRI
groups are configured, see the Changing Codec Complexity, on page 29.
To configure codec complexity for digital voice ports on the Cisco 880 series, Cisco 2600 series, Cisco 3600
series, and Cisco 3700 series routers, and for voice ports on HCMs on the Cisco MC3810, use the following
commands:
SUMMARY STEPS
1. enable
2. show voice dsp
3. configure terminal
4. voice-card slot
5. codec complexity {high | medium}
DETAILED STEPS
Step 2 show voice dsp Checks the DSP voice channel activity. If any DSP voice channels are in
the busy state, codec complexity cannot be changed. When all DSP
Example: channels are in the idle state, continue to Step 2.
Example:
Router# configure terminal
Step 4 voice-card slot Enters voice card-configuration mode for the card or cards in the slot
specified. Range is 0 to 5.
Example:
Router(config)# voice-card 0
Step 5 codec complexity {high | medium} Specifies codec complexity based on the codec standard being used. This
setting restricts the codecs available in dial peer configuration. All voice
Example: cards in a router must use the same codec complexity setting. Default is
medium.
Router(config-voicecard)# codec
complexity high Note On the Cisco MC3810, this command is valid only with one or
more HCMs installed, and voice card 0 must be specified. If two
HCMs are installed, this command configures both HCMs at
once.
Note Use the show voice dsp command to check the DSP voice channel activity. If any DSP voice channels
are in the busy state, the codec complexity cannot be changed. You must clear all calls before performing
the following task.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port:ds0-group-number
4. shutdown
5. exit
6. controller {t1 | e1} slot/port
7. Do one of the following:
• no ds0-group ds0-group-number
•
•
• no pri-group timeslots timeslot-list
8. exit
9. voice-card slot
10. codec complexity {high | medium} [ecan-extended]
11. exit
12. Repeat Step 6, then continue with Step 13.
13. Do one of the following:
• ds0-group ds0-group-number timeslots timeslot - list type {e&m-immediate | e&m-delay
| e&m-wink-start | fxs-ground-start | fxs-loop-start | fxo-ground-start | fxo-loop-start}
•
•
• pri-group timeslots timeslot - list
14. exit
15. Repeat Step 3, then continue with Step 16.
16. no shutdown
17. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-port slot / port:ds0-group-number Enters voice-port configuration mode on the selected slot, port, and
DS0 group.
Example: Note The syntax of this command is platform-specific. For the
Router(config)# voice-port 1/0:23 syntax for your platform, refer to the Cisco IOS Voice
Command Reference.
Note For the Cisco 880 series platforms, the command syntax
does not include a slot number, only the port is identified.
If the primary voice interface is FXS and the backup is BRI,
then ports 0, 1, 2, and 3 are analog voice ports, and ports 4
and 5 are digital. If the primary voice interface is BRI, then
ports 1, 2, 3, and 4 are digital.
Step 4 shutdown Shuts down all voice ports assigned to the T1 interface on the voice
card.
Example:
Router(config-voiceport)# shutdown
Example:
Router(config-voiceport)# exit
Step 6 controller {t1 | e1} slot/port Enters controller configuration mode on the T1 controller on the
selected slot and port.
Example:
Router(config)# controller t1 1/0
Example:
Router(config-controller)# no ds0-group
1
Example:
Router(config-controller)# no pri-group
timeslots 1,7,9
Step 8 exit Exits controller configuration mode and returns to global configuration
mode.
Example:
Router(config-controller) exit
Step 9 voice-card slot Enters voice-card configuration mode on the specified slot.
• slot--Slot number of the voice card. Range is 0 to 6, depending
Example: on platform.
Router(config)# voice-card 1
Step 10 codec complexity {high | medium} Changes codec complexity or changes the echo canceller (EC) from
[ecan-extended] the proprietary Cisco G.165 EC to the G.168 extended EC.
• high --Supports up to six voice or fax calls per DSP module
Example: (PVDM-12), using the codecs: G.723, G.728, G.729, G.729
Router(voice-card)# codec complexity high Annex B, GSMEFR, GSMFR, fax relay, or any of the medium
ecan-extended complexity codecs.
• medium --Supports up to 12 voice or fax calls per DSP module
Example: (PVDM-12), using the codecs: G.711, G.726, G.729 Annex A,
G.729 Annex A with Annex B, and fax relay. Default value.
• ecan-extended --(Optional) Selects the G.168 extended echo
canceller. For more information, see the "How to Configure the
Extended G.168 Echo Canceller" section.
Step 13 Do one of the following: Defines the T1 or E1 channels for use by compressed voice calls and
the signaling method that the router uses to connect to the PBX or
• ds0-group ds0-group-number timeslots CO.
timeslot - list type {e&m-immediate |
e&m-delay | e&m-wink-start | Note If you are configuring PRI groups instead of DS0 groups,
fxs-ground-start | fxs-loop-start | omit this step and proceed to Step 15.
fxo-ground-start | fxo-loop-start} or
Example:
Router(config-controller)# ds0-group 0
timeslots 1-24 type e&m-wink-start
Example:
Router(config-controller)# pri-group
timeslots 1,7,9
Step 14 exit Exits controller configuration mode and completes the process for
adding back the PRI groups or DS0 groups.
Example:
Router(config-controller)# exit
Step 16 no shutdown Saves the controller configurations on the slot and port specified.
Example:
Router(config-controller)# no shutdown
Step 17 end Exits controller configuration mode and completes the process for
bringing the T1 controller back up.
Example:
Router(config-controller)# end
• When the IP Communications High-Density Digital Voice/Fax Network Module feature is used in a
Cisco CallManager network, the CCM 4.0(1) SR1 or CCM 3.3(4) release must be installed.
• Software echo cancellation is the default configuration--G.168-compliant echo cancellation is enabled
by default with a coverage of 64 milliseconds.
• Only Packet Fax/Voice DSP modules (PVDM2s) are supported on the IP Communications High-Density
Digital Voice/Fax Network Module.
• Only voice interface cards that start with VIC2 are supported in the IP Communications High-Density
Digital Voice/Fax Network Module feature except for VIC-1J1, VIC-2DID, and VIC-4FXS/DID.
• The direct inward dial (DID) feature in VIC-4FXS/DID is not supported.
• The CAMA card (VIC-2CAMA) is not supported. Any port on the VIC2-2FXO and the VIC2-4FXO
can be software configured to support analog CAMA for dedicated E-911 services (North America only).
Caution If you are configuring a Cisco 2600 XM router, you should not use the network-clock-participate
command for slot 1 of the router. This may cause a disruption in service to the router.
Table 4: Codec Complexity Settings for DSP Resource Sharing Between Local and Remote Sources
To enable the IP Communications Voice/Fax Network Module feature, perform this task to configure the
voice card for the flex option in codec complexity.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-card slot
4. codec complexity flex [reservation - fixed {high | medium}]
5. voice local-bypass
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-card slot Enters voice-card configuration mode and specifies the slot location.
• For the slotargument, specify a value from 1 to 4, depending on your router.
Example:
Router(config)# voice-card 1
Step 4 codec complexity flex Specifies the flex option for codec complexity.
[reservation - fixed {high | medium}]
• flex --Up to 16 calls can be completed per DSP. The number of supported
calls varies from 6 to 16, depending on the codec used for a call. In this
Example: mode, reservation for analog VICs may be needed for certain appplications
Router(config-voicecard)# codec such as CAMA E-911 calls because oversubscription of DSPs is possible.
complexity flex If this is true, then the reservation-fixed option may be enabled. There is
no reservation by default.
• reservation-fixed--Appears as an option only when there is an analog
VIC present. Ensures that sufficient DSP resources are available to
handle a call. If you enter this keyword, then specify if the complexity
should be high or medium.
Note You cannot change codec complexity while DS0 groups are defined.
If they are already set up, perform the steps in the Changing Codec
Complexity, on page 29.
Step 5 voice local-bypass Configures local calls to bypass the DSP. This is the default.
Note Use the show interfaces dspfarmcommand to check the DSP voice channel activity. If any DSP voice
channels are in the busy state, the codec complexity cannot be changed. You must clear all calls before
performing the following task.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
• dspint dspfarm slot /0
•
•
• dspint dspfarm slot / port-adapter / port
DETAILED STEPS
Example:
Router# configure terminal
Step 3 Do one of the following: Enters DSP interface configuration mode for the Cisco 7200 series.
• dspint dspfarm slot /0 or
• Enters DSP interface configuration mode for the Cisco 7500 series.
•
• dspint dspfarm slot / port-adapter /
port
Example:
Router(config)# dspint dspfarm 2/0
Example:
Router(config-dspfarm)# exit
What to Do Next
Cisco 7200 Series:
On the Cisco 7200 series, the PA-MCX-2TE1 port adapter (PA) card can be used for making voice calls. This
PA does not have any DSPs but uses the DSP resources of the PA-VXC-2TE1+ card present in another slot.
If the PA-MCX card is used, codec complexity is configured for PA-VXC, while all other echo cancellation
configurations are done for PA-MCX.
The PA-MCX card borrows the DSP resources from the PA-VXC, PA-VXB, or PA-VXA card. If one of the
PA-VXC, PA-VXB, or PA-VXA cards has extended echo cancellation configured on the DSP interface,
extended echo cancellation is enabled for the PA-MCX card. It is recommended that you have the same codec
complexity and echo cancellation configuration on all the PA-VXC, PA-VXB, or PA-VXA cards in the router.
Cisco AS5300:
Codec support on the Cisco AS5300 is determined by the capability list on the voice feature card, which
defines the set of codecs that can be negotiated for a voice call. The capability list is created and populated
when VCWare is unbundled and DSPWare is added to VFC flash memory. The capability list does not indicate
codec preference; it simply reports the codecs that are available. The session application decides which codec
to use. Codec support is configured on dial peers rather than on voice ports; refer to the "Dial Peer Configuration
on Voice Gateway Routers" document.
Cisco AS5800:
Codec support is selected on Cisco AS5800 access servers during dial peer configuration. Refer to the "Dial
Peer Configuration on Voice Gateway Routers" document.
Note All controller commands shown in the figure below, other than ds0-group, apply to all time slots in the
T1 line.
Voice port controller configuration includes setting the parameters described in the following sections:
Another controller command that might be needed, cablelength, is discussed in the Cisco IOS Interface and
Hardware Component Command Reference.
This section describes the five basic timing scenarios that can occur when a digital voice port is connected to
a PBX or CO. In all the examples that follow, the PSTN (or CO) and the PBX are interchangeable for purposes
of providing or receiving clocking.
• Single voice port providing clocking--In this scenario, the digital voice hardware is the clock source for
the connected device, as shown in the figure below. The PLL generates the clock internally and drives
the clocking on the line. Generally, this method is useful only when connecting to a PBX, key system,
or channel bank. A Cisco VoIP gateway rarely provides clocking to the CO because CO clocking is
much more reliable. The following configuration sets up this clocking method for a digital E1 voice
port:
controller E1 1/0
framing crc4
linecoding hdb3
clock source internal
ds0-group timeslots 1-15 type e&m-wink-start
• Single voice port receiving internal clocking--In this scenario, the digital voice hardware receives clocking
from the connected device (CO telephony switch or PBX) (see the figure below). The PLL clocking is
driven by the clock reference on the receive (Rx) side of the digital line connection.
controller T1 1/0
framing esf
linecoding ami
clock source line
ds0-group timeslots 1-12 type e&m-wink-start
• Dual voice ports receiving clocking from the Line--In this scenario, the digital voice port has two
reference clocks, one from the PBX and another from the CO, as shown in the figure below.
Because the PLL can derive clocking from only one source, this case is more complex than the two preceding
examples. Before looking at the details, consider the following as they pertain to the clocking method:
• • Looped-time clocking--The voice port takes the clock received on its Rx (receive) pair and
regenerates it on its Tx (transmit) pair. While the port receives clocking, the port is not driving the
PLL on the card but is "spoofing" (that is, fooling) the port so that the connected device has a
viable clock and does not see slips (that is, loss of data bits). PBXs are not designed to accept slips
on a T1 or E1 line, and such slips cause a PBX to drop the link into failure mode. While in
looped-time mode, the router often sees slips, but because these are controlled slips, they usually
do not force failures of the router’s voice port.
• Slips--These messages indicate that the voice port is receiving clock information that is out of
phase (out of synchronization). Because the router has only a single PLL, it can experience controlled
slips while it receives clocking from two different time sources. The router can usually handle
controlled slips because its single-PLL architecture anticipates them.
Note Physical layer issues, such as bad cabling or faulty clocking references, can cause slips. Eliminate these
slips by addressing the physical layer or clock reference problems.
In the dual voice ports receiving clocking from the line scenario, the PLL derives clocking from the CO and
puts the voice port connected to the PBX into looped-time mode. This is usually the best method because the
CO provides an excellent clock source (and the PLL usually requires that the CO provide that source) and a
PBX usually must receive clocking from the other voice port.
The following configuration sets up this clocking method (controller E1 1/0 is connected to the CO; controller
E1 1/1 is connected to the PBX:
controller E1 1/0
framing crc4
linecoding hdb3
clock source line primary
ds0-group timeslots 1-15 type e&m-wink-start
!
controller E1 1/1
framing crc4
linecoding hdb3
clock source line
ds0-group timeslots 1-15 type e&m-wink-start
The clock source line primary command tells the router to use this voice port to drive the PLL. All other
voice ports configured as clock source line are then put into an implicit loop-timed mode. If the primary voice
port fails or goes down, the other voice port instead receives the clock that drives the PLL. In this configuration,
port 1/1 might see controlled slips, but these should not force it down. This method prevents the PBX from
seeing slips.
Note When two T1/E1 lines terminate on a two-port interface card, such as the VWIC-2MFT, and both controllers
are set for line clocking but the lines are not within clocking tolerance of one another, one of the controllers
is likely to experience slips. To prevent slips, ensure that the two T1 or E1 lines are within clocking
tolerance of one another, even if the lines are from different providers.
• Dual voice ports (one receives clocking and one provides clocking)--In this scenario, the digital voice
hardware receives clocking for the PLL from E1 0 and uses this clock as a reference to clock E1 1 (see
the figure below). If controller E1 0 fails, the PLL internally generates the clock reference to drive E1
1.
controller E1 1/0
framing crc4
linecoding hdb3
clock source line
ds0-group timeslots 1-15 type e&m-wink-start
!
controller E1 1/1
framing crc4
linecoding hdb3
clock source internal
ds0-group timeslots 1-15 type e&m-wink-start
• Dual voice ports (router provides both clocks)--In this scenario, the router generates the clock for the
PLL and, therefore, for both voice ports (see the figure below).
controller E1 1/0
framing crc4
linecoding hdb3
clock source internal
ds0-group timeslots 1-15 type e&m-wink-start
!
controller E1 1/1
framing esf
linecoding b8zs
clock source internal
ds0-group timeslots 1-15 type e&m-wink-start
Slips are caused by the inability of an equipment buffer store (or other mechanisms) to accommodate differences
between the phases or frequencies of the incoming and outgoing signals in cases where the timing of the
outgoing signal is not derived from that of the incoming signal.
A T1 or E1 interface sends traffic inside repeating bit patterns called frames. Each frame is a fixed number
of bits, allowing the device to see the start and end of a frame. The receiving device also knows exactly when
to expect the end of a frame simply by counting the appropriate number of bits that have come in. Therefore,
if the timing between the sending and receiving device is not the same, the receiving device may sample the
bit stream at the wrong moment, resulting in an incorrect value being returned.
Even though Cisco IOS software can be used to control the clocking on these platforms, the default clocking
mode is effectively free running, meaning that the received clock signal from an interface is not connected to
the backplane of the router and used for internal synchronization between the rest of the router and its interfaces.
The router will use its internal clock source to pass traffic across the backplane and other interfaces.
For data applications, this clocking generally does not present a problem as a packet is buffered in internal
memory and is then copied to the transmit buffer of the destination interface. The reading and writing of
packets to memory effectively removes the need for any clock synchronization between ports.
Digital voice ports have a different issue. It would appear that unless otherwise configured, Cisco IOS software
uses the backplane (or internal) clocking to control the reading and writing of data to the DSPs. If a PCM
stream comes in on a digital voice port, it will be using the external clocking for the received bit stream.
However, this bit stream will not necessarily be using the same reference as the router backplane, meaning
the DSPs may misinterpret the data coming in from the controller.
This clocking mismatch is seen on the router’s E1 or T1 controller as a clock slip--the router is using its internal
clock source to send the traffic out the interface but the traffic coming in to the interface is using a completely
different clock reference. Eventually, the difference in the timing relationship between the transmit and receive
signal becomes so great that the controller registers a slip in the received frame.
To eliminate the problem, change the default clocking behavior through Cisco IOS configuration commands.
It is absolutely critical to set up the clocking commands properly.
Even though these commands are optional, we strongly recommend you enter them as part of your configuration
to ensure proper network clock synchronization:
network-clock-participate [slot slot-number | wic wic-slot | aim aim-slot-number network-clock-select
priority{bri | t1 | e1} slot / port
The network-clock-participate command allows the router to use the clock from the line via the specified
slot/WIC/AIM and synchronize the onboard clock to the same reference.
If multiple VWICS are installed, the commands must be repeated for each installed card. The system clocking
can be confirmed using the show network clocks command.
Caution If you are configuring a Cisco 2600 XM voice gateway with an NM-HDV2 or NM-HD-2VE installed in
slot 1, do not use the network-clock-participate slot 1 command in the configuration. In this particular
hardware scenario, the network-clock-participate slot 1 command is not necessary. If the
network-clock-participate slot 1 command is configured, voice and data connectivity on interfaces
terminating on the NM-HDV2 or NM-HD-2VE network module may fail to operate properly. Data
connectivity to peer devices may not be possible, and even loopback plug tests to the serial interface
spawned via a channel group configured on the local T1/E1 controller will fail. Voice groups such as CAS
DS0 groups and ISDN PRI groups may fail to signal properly. The T1/E1 controller may accumulate large
amounts of timing slips and Path Code Violations (PCVs) and Line Code Violations (LCVs).
The numbering for the logical voice port created as a result of this command is controller:ds0-group-number
, where controller is defined as the platform-specific address for a particular controller. On a Cisco 3640
router, for example, ds0-group 1 timeslots 1-24 type e&m-wink automatically creates the voice port 1/0:1
when issued in the configuration mode for controller 1/0. On a Cisco MC3810 universal concentrator, when
you are in the configuration mode for controller 0, the ds0-group 1 timeslots 1-24 type e&m-winkcommand
creates logical voice port 0:1.
To map individual DS0s, define additional DS0 groups under the T1/E1 controller, specifying different time
slots. Defining additional DS0 groups also creates individual DS0 voice ports.
• Defines the emulated analog signaling method that the router uses to connect to the PBX or PSTN.
Most digital T1/E1 connections used for switch-to-switch (or switch-to-router) trunks are E&M connections,
but FXS and FXO connections are also supported. These are normally used to provide emulated-OPX
(Off-Premises eXtension) from a PBX to remote stations. FXO ports connect to FXS ports. The FXO or FXS
connection between the router and switch (CO or PBX) must use matching signaling, or calls cannot connect
properly. Either ground-start or loop-start signaling is appropriate for these connections. Ground-start provides
better disconnect supervision to detect when a remote user has hung up the telephone, but ground-start is not
available on all PBXs.
Digital ground start differs from digital E&M because the A and B bits do not track each other as they do in
digital E&M signaling (that is, A is not necessarily equal to B). When the CO delivers a call, it seizes a channel
(goes off-hook) by setting the A bit to 0. The CO equipment also simulates ringing by toggling the B bit. The
terminating equipment goes off-hook when it is ready to answer the call. Digits are usually not delivered for
incoming calls.
E&M connections can use one of three different signaling types to acknowledge on-hook and off-hook states:
wink start, immediate-start, and delay-start. E&M wink start is usually preferred, but not all COs and PBXs
can handle wink-start signaling. The E&M connection between the router and switch (CO or PBX) must
match the CO or PBX E&M signaling type, or calls cannot be connected properly.
E&M signaling is normally used for trunks. It is normally the only way that a CO switch can provide two-way
dialing with DID. In all the E&M protocols, off-hook is indicated by A=B=1 and on-hook is indicated by
A=B=0 (robbed-bit signaling). If dial pulse dialing is used, the A and B bits are pulsed to indicate the addressing
digits. The are several further important subclasses of E&M robbed-bit signaling:
In the original wink start handshaking protocol, the terminating side responds to an off-hook from the originating
side with a short wink (transition from on-hook to off-hook and back again). This wink tells the originating
side that the terminating side is ready to receive addressing digits. After receiving addressing digits, the
terminating side then goes off-hook for the duration of the call. The originating endpoint maintains off-hook
for the duration of the call.
• • E&M wink-start--Feature Group D
In Feature Group D wink-start with wink acknowledge handshaking protocol, the terminating side responds
to an off-hook from the originating side with a short wink (transition from on-hook to off-hook and back
again) just as in the original wink-start. This wink tells the originating side that the terminating side is ready
to receive addressing digits. After receiving addressing digits, the terminating side provides another wink
(called an acknowledgment wink ) that tells the originating side that the terminating side has received the
dialed digits. The terminating side then goes off-hook to indicate connection. This last indication can be due
to the ultimate called endpoint’s having answered. The originating endpoint maintains an off-hook condition
for the duration of the call.
• • E&M immediate-start
In the immediate-start protocol, the originating side does not wait for a wink before sending addressing
information. After receiving addressing digits, the terminating side then goes off-hook for the duration of the
call. The originating endpoint maintains off-hook for the duration of the call.
Note Feature Group D is supported on Cisco AS5300 platforms, and on Cisco 2600, Cisco 3600, and Cisco
7200 series with digital T1 packet voice trunk network modules. Feature Group D is not supported on E1
or analog voice ports.
To configure controller settings for digital T1/E1 voice ports, use the following commands:
SUMMARY STEPS
1. enable
2. configure terminal
3. card type {t1 | e1} slot
4. Do one of the following:
• controller {t1 | e1} slot / port
•
• controller {t1 | e1} number
•
• controller {t1 | e1} shelf / slot / port
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# card type t1 0
Step 4 Do one of the following: Enters controller configuration mode and specifies either T1
or E1 for the line.
• controller {t1 | e1} slot / port
• For the Cisco 2600, Cisco 3600 series, Cisco MC3810,
•
and Cisco 7200 series, identifies the slot and port.
• controller {t1 | e1} number
• For the Cisco AS5300, identifies the port number.
•
• controller {t1 | e1} shelf / slot / port • For the Cisco AS5800 and Cisco 7500 series, identifies
the shelf, slot, and port number.
Example:
Router(config)# controller t1 1/0
Example:
Example:
Router(config)# controller t1 1
Example:
or
Example:
Router(config)# controller t1 1/0/0
Example:
Router(config-controller)# framing esf
Example:
Example:
Example:
Router(config-controller)# framing crc4
Step 6 clock source {line [primary | secondary] | internal} Configures the clock source.
• Default is line.
Example:
• For more information about clock sources, see the
Router(config-controller)# clock source line
primary Clock Sources on Digital T1 E1 Voice Ports, on page
40.
Step 7 Do one of the following: Specifies the line encoding to use for T1 or E1 line.
• linecode {ami | b8zs} • For T1, the line encoding can be ami or b8zs. Default
for T1 is ami.
•
• linecode {ami | hdb3} • For E1, the line encoding can be ami or hdb3. Default
for E1 is hdb3.
Example:
Router(config-controller)# linecode b8zs
Example:
Example:
Router(config-controller)# linecode hdb3
Step 8 ds0-group ds0-group-number timeslots timeslot-list Defines the T1 channels for use by compressed voice calls
type {e&m-delay-dial | e&m-fgd | and the signaling method that the router uses to connect to
e&m-immediate-start|e&m-wink-start | ext-sig | the PBX or CO.
fgd-eana | fxo-ground-start | fxo-loop-start | Note This step shows the basic syntax and signaling types
fxs-ground-start | fxs-loop-start} available with the ds0-group command. For the
complete syntax, refer to the Cisco IOS Voice
Example: Command Reference.
Router(config-controller)# ds0-group 30 timeslots
0 type e&m-immediate-start
Example:
Router(config-controller)# no shutdown
Note The commands, keywords, and arguments that you are able to use may differ slightly from those presented
here, based on your platform, Cisco IOS release, and configuration. When in doubt, use Cisco IOS command
help to determine the syntax choices that are available.
To configure basic parameters for digital T1/E1 voice ports, use the following commands:
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
• voice-port port
•
• voice-port slot / port:ds0-group-number
•
• voice-port slot / port-adapter :ds0-group-number
•
• voice-port slot / port-adapter/slot :ds0-group-number
•
• voice-port controller :{ds0-group-number | D}
•
• voice-port slot / controller :{ds0-group-number | D}
•
• voice-port shelf / slot / port:ds0-group-number
4. type {1 | 2 | 3 | 5}
5. cptone locale
6. compand-type {u-law | a-law}
7. ring frequency {25 | 50}
8. ring number number
9. ring cadence {[pattern01 | pattern02 | pattern03 | pattern04 | pattern05 | pattern06 | pattern07 |
pattern08 | pattern09 | pattern10 | pattern11 | pattern12] [define pulse interval]}
10. description string
11. no shutdown
DETAILED STEPS
Example:
Router# configure terminal
Step 3 Do one of the following: Enters voice-port configuration mode and identifies the port to be
configured.
• voice-port port
• For the Cisco 880 series, specify the port number.
•
• voice-port slot / • For the Cisco 2600, Cisco 3600, and Cisco 3700 series, specify the
port:ds0-group-number slot, port, and DS0 group number.
• • For the Cisco 7200 series, specify the slot, port adapter,and DS0
• voice-port slot / port-adapter group number.
:ds0-group-number • For the Cisco 7500 series, specify the slot, port adapter, slot, and DS0
• group number.
• voice-port slot / port-adapter/slot • For the Cisco AS5300, specify the controller and DS0 group number
:ds0-group-number or the keyword D.
• • For the Cisco AS5350, Cisco AS5400, and Cisco AS5850 universal
• voice-port controller gateways, specify the slot, controller, and DS0 group number or the
:{ds0-group-number | D} keyword D.
• • For the Cisco AS5800, specify the shelf, slot, port, and DS0 group
• voice-port slot / controller number.
:{ds0-group-number | D}
•
• voice-port shelf / slot /
port:ds0-group-number
Example:
Router(config)# voice-port 1:0
Example:
Example:
Router(config)# voice-port 1/1:0
Example:
Router(config)# voice-port 1/1/1:1
Example:
Router(config)# voice-port 1:1
Example:
Router(config)# voice-port 1/0 D
Example:
Router(config)# voice-port 1/2/0:1
Step 4 type {1 | 2 | 3 | 5} (E&M only) Specifies the type of E&M interface to which this voice port
is connected. See Table 3 in the "Voice Port Configuration Overview"
Example: chapter for an explanation of E&M types.
Router(config-voiceport)# • Default is 1.
type 1
Step 5 cptone locale Selects a two-letter locale keyword for the voice call progress tones and
other locale-specific parameters to be used on this voice port. Voice call
Example: progress tones include dial tone, busy tone, and ringback tone, which vary
with geographical region.
Router(config-voiceport)# cptone us
• Other parameters include ring cadence and compand type. Cisco
routers comply with the ISO3166 locale name standards; to see valid
choices, enter a question mark (?) following the cptone command.
• Default is us.
Step 6 compand-type {u-law | a-law} (Cisco 2600 and Cisco 3600 series routers.) Specifies the companding
standard used. This command is used in cases when the DSP is not used,
Example: such as local cross-connects, and overwrites the compand-type value set
by the cptone command.
Router(config-voiceport)# compand-type
u-law • The default for E1 is a-law.
• The default for T1 is u-law.
Note If you have a Cisco 3660 router, the compand-type a-law command
must be configured on the analog ports only. The Cisco 2660,
3620, and 3640 routers do not require the compand-type a-law
command configured. However, if you request a list of commands,
the compand-type a-law command will display.
Step 8 ring number number (FXO only) Specifies the maximum number of rings to be detected before
an incoming call is answered by the router.
Example: • Default is 1.
Router(config-voiceport)# ring number
1
Step 9 ring cadence {[pattern01 | pattern02 | (FXS only) Specifies an existing pattern for ring, or defines a new one.
pattern03 | pattern04 | pattern05 | pattern06 Each pattern specifies a ring-pulse time and a ring-interval time. The
| pattern07 | pattern08 | pattern09 | keywords and arguments are as follows:
pattern10 | pattern11 | pattern12] [define
pulse interval]} • pattern01 through pattern12--Specifies preset ring cadence
patterns. Enter ring cadence ? to see ring pattern explanations.
Example: • define pulse interval --Specifies a user-defined pattern as follows:
Router(config-voiceport)# ring cadence • pulse is a number (1 or 2 digits from 1 to 50) specifying ring
pattern01 define 12 15 pulse (on) time in hundreds of milliseconds.
• interval is a number (1 or 2 digits from 1 to 50) specifying ring
interval (off) time in hundreds of milliseconds.
Step 10 description string Attaches a text string to the configuration that describes the connection for
this voice port. This description appears in various displays and is useful
Example: for tracking the purpose or use of the voice port. The string argument is a
character string from 1 to 255 characters in length.
Router(config-voiceport)# description
1 • The default is that no description is attached to the configuration.
Example:
Router(config-voiceport)# no shutdown
Note The commands, keywords, and arguments that you are able to use may differ slightly from those presented
here, based on your platform, Cisco IOS release, and configuration. When in doubt, use Cisco IOS command
help to determine the syntax choices that are available.
• Modification of Bit Patterns for Digital Voice Ports--Enables commands for digital voice ports to modify
sent or received bit patterns. Different versions of E&M use different ABCD signaling bits to represent
idle and seize.
• ANI for Outbound Calling--Allows the automatic number identification (ANI) to be sent for outgoing
calls on the Cisco AS5300 (if T1 CAS is configured with the Feature Group-D (FGD)--Exchange Access
North American (FGD-EANA) signaling).
• Disconnect Supervision--Configures the router to recognize the type of signaling in use by the PBX or
PSTN switch connected to the voice port. These methods include the following:
• Battery reversal disconnect
• Battery denial disconnect
• Supervisory tone disconnect (STD)
• FXO Supervisory Disconnect Tones--Prevents an analog FXO port from remaining in an off-hook state
after an incoming call is ended. FXO supervisory disconnect tone enables interoperability with PSTN
and PBX systems whether or not they transmit supervisory tones.
• Timeouts Parameters--Modifies values for timeouts. For example, you can adjust the wait time for the
caller input of the initial digit and the subsequent digit of the dialed string. If the wait time expires before
the destination is identified, a tone sounds and the call ends.
• Timing Parameters--Changes a wide range of timing values. For example, you can specify the minimum
delay time, in milliseconds, from outgoing seizure to outdial address.
• DTMF Timer--Modifies the value for the DTMF interdigit timer.
• Comfort Noise and Music Threshold for VAD--Specifies the minimal decibel level of music played
when calls are put on hold and creates subtle background noise to fill silent gaps during calls when VAD
is enabled on voice dial peers. If comfort noise is not generated, the resulting silence can fool the caller
into thinking the call is disconnected instead of being merely idle.
Note The commands, keywords, and arguments that you are able to use may differ slightly from those presented
here, based on your platform, Cisco IOS release, and configuration. When in doubt, use Cisco IOS command
help to determine the syntax choices that are available. Full descriptions of the commands in this section
can be found in the Cisco IOS Voice Command Reference.
To establish a channel bank connection between an analog voice port and a T1 DS0, configure the connect
(voice-port) command in global configuration mode. To verify the channel bank connection, use the show
connection all command.
Restrictions for Channel Bank Support:
• The configuration for cross-connect must be on the same network module.
• A maximum of four Foreign Exchange Service (FXS) or Foreign Exchange Office (FXO) ports can be
cross-connected to a T1 interface.
• A BRI-to-PRI cross-connect cannot be configured.
• Analog-to-BRI/PRI cross-connect cannot be configured; the only connection for analog is analog-to-T1/E1
CAS (ds0-group).
• The local-bypasscommand has no effect when cross-connect is configured. It is applicable only to calls
that are hairpinned via POTS-to-POTS dial peers.
• The DS0 group must contain only one time slot. The signaling type of the DS0 group must match that
of the analog voice port.
• If the channel bank feature is used for the T1 controller, the rest of the unused DS0 group cannot be
used for fractional PRI signaling.
SUMMARY STEPS
1. enable
2. configure terminal
3. controller {t1 | e1} slot/port
4. ds0-group ds0-group-number timeslots timeslot-list type {e&m-delay-dial | e&m-fgd |
e&m-immediate-start | e&m-wink-start | fxs-ground-start | fxs-loop-start | fxo-ground-start |
fxo-loop-start}
5. exit
6. voice-port slot / port
7. operation {2-wire | 4-wire}
8. type {1 | 2 | 3 | 5}
9. Do one of the following:
• signal {loop-start | ground-start}
•
•
• signal {wink-start | immediate | delay-dial}
10. exit
11. connect connection-name voice-port voice-port-number {t1 | e1} controller-number ds0-group-number
12. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 controller {t1 | e1} slot/port Enters controller configuration mode and identifies the controller
type (T1 or E1) and a slot and port for configuration commands that
Example: specifically apply to the T1 or E1 interface.
Router(config)# controller t1 1/0 • Valid values for the slot and port arguments are 0 and 1.
Step 4 ds0-group ds0-group-number timeslots Defines the T1 or E1 channels for use by compressed voice calls and
timeslot-list type {e&m-delay-dial | e&m-fgd the signaling method the router uses to connect to the PBX or central
| e&m-immediate-start | e&m-wink-start | office (CO).
fxs-ground-start | fxs-loop-start |
fxo-ground-start | fxo-loop-start} • The ds0-group command automatically creates a logical voice
port.
Router(config-controller)# exit
Step 6 voice-port slot / port Enters voice-port configuration mode and identifies a slot and port
for configuration parameters.
Example:
Step 7 operation {2-wire | 4-wire} Selects a specific cabling scheme for E&M ports:
• This command is not applicable to FXS or FXO interfaces
Example: because they are, by definition, 2-wire interfaces.
Router(config-voiceport)# operation 4-wire
• Using this command on a voice port changes the operation of
both voice ports on a VPM card. The voice port must be shut
down and then opened again for the new value to take effect.
Example:
Router(config-voiceport)# type 2
Example:
Router(config-voiceport)# signal
loop-start
Example:
Example:
Router(config-voiceport)# signal
wink-start
Router(config-voiceport)# exit
Step 11 connect connection-name voice-port Creates a named connection between two voice ports associated with
voice-port-number {t1 | e1} controller-number T1 or E1 interfaces where you have already defined the groups by
ds0-group-number using the ds0-group command.
Example:
Step 12 exit Exits the current configuration session and returns to privileged EXEC
mode.
Example:
Router(config)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. auto-cut-through
5. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 auto-cut-through (E&M only) Enables call completion on a router if a PBX does
not provide an M-lead response.
Example:
Router(config-voiceport)# auto-cut-through
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot /port
4. condition {tx-a-bit | tx-b-bit | tx-c-bit | tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit} {on | off |
invert}
5. define {tx-bits | rx-bits} {seize | idle} {0000 | 0001 | 0010 | 0011 | 0100 | 0101 | 0110 | 0111 | 1000 |
1001 | 1010 | 1011 | 1100 | 1101 | 1110 | 1111}
6. ignore {rx-a-bit | rx-b-bit | rx-c-bit | rx-d-bit}
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 condition {tx-a-bit | tx-b-bit | tx-c-bit | Manipulates sent or received bit patterns to match expected patterns on a
tx-d-bit} {rx-a-bit | rx-b-bit | rx-c-bit | connected device. Repeat the command for each transmit or receive bit to be
rx-d-bit} {on | off | invert} modified, but be careful not to destroy the information content of the bit
pattern.
Example: • The default is that the signaling format is not manipulated (for all
Router(config-voiceport)# condition transmit or receive A, B, C, and D bits).
tx-a-bit on
Note The show voice port command reports at the protocol level, and
the show controller command reports at the driver level. The driver
is not notified of any bit manipulation using the condition command.
As a result, the show controller command output does not account
for the bit conditioning.
Step 5 define {tx-bits | rx-bits} {seize | idle} (Digital E1 E&M voice ports on Cisco 2600 and Cisco 3600 series routers
{0000 | 0001 | 0010 | 0011 | 0100 | 0101 | only) Defines specific transmit or receive signaling bits to match the bit
0110 | 0111 | 1000 | 1001 | 1010 | 1011 | patterns required by a connected device for North American E&M and E&M
1100 | 1101 | 1110 | 1111} MELCAS voice signaling, if patterns different from the preset defaults are
required.
Example: • Also specifies which bits a voice port monitors and which bits it ignores,
Router(config-voiceport)# define if patterns that are different from the defaults are required.
tx-bits seize 0000
• See the define command for the default signaling patterns as defined
in American National Standards Institute (ANSI) and European
Conference of Posts and Telecommunication Administration (CEPT)
standards.
Step 6 ignore {rx-a-bit | rx-b-bit | rx-c-bit | (Digital E1 E&M voice ports on Cisco 2600 and Cisco 3600 series routers
rx-d-bit} only) Configures the voice port to ignore the specified receive bit for North
American E&M or E&M MELCAS, if patterns different from the defaults
Router(config-voiceport)# ignore
rx-a-bit
Step 7 exit Exits voice-port configuration mode and completes the configuration.
Example:
Router(config-voiceport)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. calling-number outbound range string1 string2
5. calling-number outbound sequence [string1] [string2] [string3] [string4] [string5]
6. calling-number outbound null
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 calling-number outbound range string1 (Cisco AS5300 only) Specifies ANI to be sent out when the T1-CAS
string2 fgd-eana command is configured as signaling type. The string1 and
string2arguments are valid E.164 telephone number strings. Both strings
Example: must be of the same length and cannot be more than 32 digits long.
Router(config-voiceport)# • Only the last four digits are used for specifying the range (string1
calling-number outbound range 3000 4000 to string2) and for generating the sequence of ANI by rotating
through the range until string2 is reached and then starting from
string1 again. If strings are fewer than four digits in length, then
entire strings are used.
Step 5 calling-number outbound sequence [string1] (Cisco AS5300 only) Specifies ANI to be sent out when the T1-CAS
[string2] [string3] [string4] [string5] fgd-eana command is configured as signaling type. This option
configures a sequence of discrete strings (string1...string5) to be passed
Example: out as ANI for successive calls using the dial peer or voice port. Limit
is five strings. All strings must be valid E.164 numbers, up to 32 digits
Router(config-voiceport)# in length.
calling-number outbound sequence 2000
3000 4000
Step 6 calling-number outbound null (Cisco AS5300 only) Suppresses ANI. No ANI is passed when this voice
port is selected.
Example:
Router(config-voiceport)#
calling-number outbound null
Step 7 exit Exits voice-port configuration mode and completes the configuration.
Example:
Router(config-voiceport)# exit
Battery reversal occurs when the connected switch changes the polarity of the line in order to indicate changes
in call state (such as off-hook or, in this case, call disconnect). This is the signaling looked for when the
battery reversal command is enabled on the voice port, which is the default configuration.
Battery denial (sometimes called power denial ) occurs when the connected switch provides a short
(approximately 600 milliseconds) interruption of line power to indicate a change in call state. This is the
signaling looked for when the supervisory disconnect command is enabled on the voice port, which is the
default configuration.
Supervisory tone disconnect occurs when the connected switch provides a special tone to indicate a change
in call state. Some PBXs and PSTN CO switches provide a 600-millisecond interruption of line power as a
supervisory disconnect, and others provide STD. This is the signal that the router is looking for when the no
supervisory disconnect command is configured on the voice port.
Note In some circumstances, you can use the FXO Disconnect Supervision feature to enable analog FXO ports
to monitor call progress tones for disconnect supervision that are returned from a PBX or from the PSTN.
For more information, see the Configuring FXO Supervisory Disconnect Tones, on page 67.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. no battery-reversal
5. no supervisory disconnect
6. disconnect-ack
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 no battery-reversal (Analog only) Enables battery reversal. The default is that battery reversal is
enabled.
Example: • For FXO ports--Use the no battery-reversal command to configure a
Router(config-voiceport)# no loop-start voice port not to disconnect when it detects a second battery
battery-reversal reversal. The default is to disconnect when a second battery reversal is
detected.
Note This functionality is supported on Cisco 1750, Cisco 2600 series, and
Cisco 3600 series routers; only analog voice ports on VIC-2FXO cards
are able to detect battery reversal.
Also use the no battery-reversal command when a connected FXO port does
not support battery reversal detection.
• For FXS ports--Use the no battery-reversal command to configure the
voice port not to reverse battery when it connects calls. The default is to
reverse battery when a call is connected, then return to normal when the
call is over, providing positive disconnect.
Step 5 no supervisory disconnect (FXO only) Enables the PBX or PSTN switch to provide STD. The supervisory
disconnect command is enabled by default.
Example:
Router(config-voiceport)# no
supervisory disconnect
Step 6 disconnect-ack (FXS only) Configures the voice port to return an acknowledgment upon receipt
of a disconnect signal. The FXS port removes line power if the equipment on
Example: the FXS loop-start trunk disconnects first. This is the default.
Router(config-voiceport)# The no disconnect-ack command prevents the FXS port from responding to
disconnect-ack the on-hook disconnect with a removal of line power.
Example:
Router(config-voiceport)# exit
Note In the following procedure, the following commands were not supported until Cisco IOS Release 12.2(2)T:
freq-max-deviation, freq-max-power, freq-min-power, freq-power-twist, and freq-max-delay.
To create a voice class that defines the specific tone or tones to be detected and then apply the voice class to
the voice port, use the following commands:
SUMMARY STEPS
1. enable
2. configure terminal
3. voice class dualtone tag
4. freq-pair tone-id frequency-1 frequency-2
5. freq-max-deviation hertz
6. freq-max-power dBmO
7. freq-min-power dBmO
8. freq-power-twist dBmO
9. freq-max-delay time
10. cadence-min-on-time time
11. cadence-max-off-time time
12. cadence-list cadence-id cycle-1-on-time cycle-1-off-time [cycle-2-on-time cycle-2-off-time]
[cycle-3-on-time cycle-3-off-time ] [cycle-4-on-time cycle-4-off-time ]
13. cadence-variation time
14. exit
15. voice-port slot / subunit / port
16. supervisory disconnect dualtone {mid-call | pre-connect} voice-class tag
17. supervisory disconnect anytone
18. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice class dualtone tag Enters voice-class configuration mode and creates a voice class
for defining one tone detection pattern. Range is 1 to 10000. The
Example: tag number must be unique on the router.
Router(config)# voice class dualtone 1 • For more information about configuring voice classes, refer
to "Dial Peer Configuration onVoice Gateway Routers".
Router(config-voice-class)# freq-pair 16 Note Repeat this command for each additional tone to be
300 0 specified.
Step 5 freq-max-deviation hertz Specifies the maximum frequency deviation that will be detected,
in Hz. Range is 10 to 125. Default is 10.
Example:
Router(config-voice-class)#
freq-max-deviation 10
Step 6 freq-max-power dBmO Specifies the maximum tone power that will be detected, in
dBmO. Range is 0 to 20. Default is 10.
Example:
Router(config-voice-class)# freq-max-power
20
Step 7 freq-min-power dBmO Specifies the minimum tone power that will be detected, in
dBmO. Range is 10 to 35. Default is 30.
Example:
Router(config-voice-class)# freq-min-power
35
Step 8 freq-power-twist dBmO Specifies the power difference allowed between the two
frequencies, in dBmO. Range is 0 to 15. Default is 6.
Example:
Router(config-voice-class)# freq-power-twist
15
Step 9 freq-max-delay time Specifies the timing difference allowed between the two
frequencies, in 10-millisecond increments. Range is 10 to 100
Example: (100 ms to 1 second). Default is 20 (200 ms).
Router(config-voice-class)# freq-max-delay
10
Step 10 cadence-min-on-time time Specifies the minimum tone on time that will be detected, in
10-millisecond increments. Range is 0 to 100 (0 ms to 1 second).
Example:
Router(config-voice-class)#
cadence-min-on-time 10
Router(config-voice-class)#
cadence-max-off-time 2000
Step 12 cadence-list cadence-id cycle-1-on-time (Optional) Specifies a tone cadence pattern to be detected. Specify
cycle-1-off-time [cycle-2-on-time cycle-2-off-time] an on time and off time for each cycle of the cadence pattern.
[cycle-3-on-time cycle-3-off-time ] [cycle-4-on-time The arguments are as follows:
cycle-4-off-time ]
• cadence-id --Range is 1 to 10. There is no default.
Example: • cycle-N-on-time --Range is 0 to 1000 (0 ms to 10 seconds).
Router(config-voice-class)# cadence-list 1 Default is 0.
0 1000
• cycle-N-off-time --Range is 0 to 1000 (0 ms to 10 seconds).
Default is 0.
Step 13 cadence-variation time (Optional) Specifies the maximum time that the tone onset can
vary from the specified onset time and still be detected, in
Example: 10-millisecond increments. Range is 0 to 200 (0 ms to 2 seconds).
Default is 0.
Router(config-voice-class)#
cadence-variation 200
Example:
Router(config-voice-class)# exit
Example:
Router(config)# voice-port 0/1/0
Step 16 supervisory disconnect dualtone {mid-call | Assigns an FXO supervisory disconnect tone voice class to the
pre-connect} voice-class tag voice port.
Example:
Router(config-voiceport)# supervisory
disconnect dualtone mid-call voice-class 1
Step 17 supervisory disconnect anytone Configures the voice port to disconnect on receipt of any tone.
Example:
Router(config-voiceport)# supervisory
disconnect anytone
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. timeouts call-disconnect seconds
5. timeouts initial seconds
6. timeouts interdigit seconds
7. timeouts ringing {seconds | infinity}
8. timeouts wait-release {seconds | infinity}
9. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 5 timeouts initial seconds Sets the number of seconds that the system waits between the caller
input of the initial digit and the subsequent digit of the dialed string. If
Example: the wait time expires before the destination is identified, a tone sounds
and the call ends.
Router(config-voiceport)# timeouts
initial 10 • The seconds argument is the initial timeout duration. Range is 0
to 120. Default is 10.
Step 6 timeouts interdigit seconds Configures the number of seconds that the system waits after the caller
has input the initial digit or a subsequent digit of the dialed string. If
Example: the timeout ends before the destination is identified, a tone sounds and
the call ends. This value is important when you are using variable-length
Router(config-voiceport)# timeouts dial peer destination patterns (dial plans).
interdigit 10
• The seconds argument is the interdigit timeout wait time in
seconds. Range is 0 to 120. Default is 10.
Step 7 timeouts ringing {seconds | infinity} Specifies the duration that the voice port allows ringing to continue if
a call is not answered.
Example: • Default for secondsis 180.
Router(config-voiceport)# timeouts
ringing infinity
Step 8 timeouts wait-release {seconds | infinity} Specifies the duration that a voice port stays in the call-failure state
while the Cisco device sends a busy tone, reorder tone, or an
Example: out-of-service tone to the port.
Step 9 exit Exits voice-port configuration mode and completes the configuration.
Example:
Router(config-voiceport)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. timing clear-wait milliseconds
5. timing delay-duration milliseconds
6. timing delay-start milliseconds
7. timing delay-with-integrity milliseconds
8. timing dial-pulse min-delay milliseconds
9. timing dialout-delay milliseconds
10. timing digit milliseconds
11. timing guard-out milliseconds
12. timing hookflash-out milliseconds
13. timing interdigit milliseconds
14. timing percentbreak percent
15. timing pulse pulses-per-second
16. timing pulse-digit milliseconds
17. timing pulse-interdigit milliseconds
18. timing wink-duration milliseconds
19. timing wink-wait milliseconds
20. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 5 timing delay-duration milliseconds (E&M only) Specifies the delay signal duration for delay-dial
signaling, in milliseconds.
Example: • Range is 100 to 5000. Default is 2000.
Router(config-voiceport)# timing
delay-duration 100
Step 6 timing delay-start milliseconds (E&M only) Specifies minimum delay time, in milliseconds, from
outgoing seizure to outdial address.
Example: • Range is 20 to 2000. Default is 300.
Router(config-voiceport)# timing
delay-start milliseconds
Step 7 timing delay-with-integrity milliseconds (Cisco MC3810 E&M ports only) Specifies duration of the wink
pulse for the delay dial, in milliseconds.
Example: • Range is 0 to 5000. Default is 0.
Router(config-voiceport)# timing
delay-with-integrity 0
Step 8 timing dial-pulse min-delay milliseconds Specifies time, in milliseconds, between the generation of wink-like
pulses when the type is pulse.
Example: • Range is 0 to 5000. Default is 300 for Cisco 3600 series and
Router(config-voiceport)# timing dial-pulse 140 for Cisco MC3810.
min-delay 300
Step 9 timing dialout-delay milliseconds (Cisco MC3810 only) Specifies dial-out delay, in milliseconds,
for the sending digit or cut-through on an FXO trunk or an E&M
Example: immediate trunk.
Step 10 timing digit milliseconds Specifies the DTMF digit signal duration in milliseconds.
• Range is 50 to 100. Default is 100.
Example:
Router(config-voiceport)# timing digit 50
Step 11 timing guard-out milliseconds (FXO ports only) Specifies the duration in milliseconds of the
guard-out period that prevents this port from seizing a remote FXS
Example: port before the remote port detects a disconnect signal.
Step 13 timing interdigit milliseconds Specifies the dual-tone multifrequency (DTMF) interdigit duration,
in milliseconds.
Example: • Range is 50 to 500. Default is 100.
Router(config-voiceport)# timing interdigit
100
Step 14 timing percentbreak percent (Cisco MC3810 FXO and E&M ports only) Specifies the
percentage of the break period for the dialing pulses, if different
Example: from the default.
Step 15 timing pulse pulses-per-second (FXO and E&M only) Specifies the pulse dialing rate in pulses
per second.
Example: • Range is 10 to 20. Default is 20.
Router(config-voiceport)# timing pulse 20
Step 16 timing pulse-digit milliseconds (FXO only) Configures the pulse digit signal duration.
• Range is 10 to 20. Default is 20.
Example:
Router(config-voiceport)# timing
pulse-digit 10
Step 17 timing pulse-interdigit milliseconds (FXO and E&M only) Specifies pulse dialing interdigit timing in
milliseconds.
Example: • Range is 100 to 1000. Default is 500.
Router(config-voiceport)# timing
pulse-interdigit 500
Step 18 timing wink-duration milliseconds (E&M only) Specifies maximum wink-signal duration, in
milliseconds, for a wink-start signal.
Example: • Range is 100 to 400. Default is 200.
Router(config-voiceport)# timing
wink-duration 200
SUMMARY STEPS
1. enable
2. configure terminal
3. controller T1 number
4. ds0-group channel-number timeslots range type signaling-type dtmf dnis
5. cas-custom channel
6. dtmf timer-inter-digit milliseconds
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 ds0-group channel-number timeslots range type Configures channelized T1 time slots, which enables a
signaling-type dtmf dnis Cisco AS5300 modem to answer and send an analog call.
Example:
Router(config-controller)# ds0-group 0 timeslots
1-4 type e&m-immediate-start dtmf dnis
Router(config-controller)# cas-custom 2
Step 6 dtmf timer-inter-digit milliseconds Configures the DTMF interdigit timer for a DS0 group.
Example:
Router(conf-ctrl-cas)# dtmf timer-inter-digit
100
VAD is configured in dial peers; by default it is enabled. Two parameters associated with VAD, music threshold
and comfort noise, are configured on voice ports.
If VAD is enabled, use the following commands to adjust music threshold and comfort noise:
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag voip
4. vad [aggressive]
5. exit
6. voice vad-time milliseconds
7. voice-port slot / port
8. music-threshold number
9. comfort-noise
10. exit
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# dial-peer voice 555 voip
Step 4 vad [aggressive] Enables VAD for calls using this dial peer.
Note VAD is enabled by default. Use the vad command only if
Example: you have previously disabled the feature by using the no
Router(config-dial-peer)# vad vad command.
Example:
Router(config-dial-peer)# exit
Step 6 voice vad-time milliseconds Modifies the minimum silence detection time for VAD.
Example:
Router(config)# voice vad-time 500
Step 8 music-threshold number Specifies the minimal decibel level of music played when calls are
put on hold. The decibel level affects how VAD treats the music data.
Example: • Valid values range from -70 to -30. If the music threshold is set
Router(config-voiceport)# too high and VAD is configured, the remote end hears no music;
music-threshold -70 if the level is set too low, there is unnecessary voice traffic.
Default is -38.
Step 9 comfort-noise Creates subtle background noise to fill silent gaps during calls when
VAD is enabled on voice dial peers. If comfort noise is not generated,
Example: the resulting silence can fool the caller into thinking the call is
disconnected instead of being merely idle.
Router(config-voiceport)# comfort-noise
• Comfort noise is enabled by default.
Example:
Router(config-voiceport)# exit
Note The Cisco SAA functionality in Cisco IOS software was formerly known as Response Time Reporter
(RTR). In the How to Configure PSTN Fallback, on page 83 section, note that the command-line interface
still uses the keyword rtr for configuring RTR probes, which are now actually the SAA probes.
• A small additional call setup delay can be expected for the first call to a new IP destination.
Caution Configuring call fallback active in a gateway creates an SAA jitter probe against other (target) gateways
to which the calls are sent. In order for the call fallback active to work properly, the target gateways must
have the rtr responder command (in Cisco IOS releases prior to 12.3(14)T) or the ip sla monitor
responder command (in Cisco IOS Release 12.3(14)T or later) in their configurations. If one of these
commands is not included in the configuration of each target gateway, calls to the target gateway will fail.
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback active
4. call fallback key-chain name-of-chain
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback active Enables the PSTN fallback feature to alternate dial peers in
case of network congestion.
Example:
Router(config)# call fallback active
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback monitor
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback monitor Enables the monitoring of destinations without fallback to
alternate dial peers.
Example:
Router(config)# call fallback monitor
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback cache-size number
4. call fallback cache-timeout seconds
5. clear call fallback cache [ip-address]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback cache-size number Specifies the call fallback cache size.
Example:
Router(config)# call fallback cache-size 5
Step 4 call fallback cache-timeout seconds Specifies the time after which the cache entry is purged,
in seconds. Default: 600.
Example:
Router(config)# call fallback cache-timeout 300
Step 5 clear call fallback cache [ip-address] Clears the current ICPIF estimates for all IP addresses
or a specific IP address in the cache.
Example:
Router(config)# clear call fallback cache 10.1.1.1
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback jitter-probe num-packets number-of-packets
4. call fallback jitter-probe precedence precedence
5. call fallback jitter-probe priority-queue
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback jitter-probe num-packets Specifies the number of packets for jitter. Default: 15.
number-of-packets
Example:
Router(config)# call fallback jitter-probe
num-packets 10
Step 4 call fallback jitter-probe precedence precedence Specifies the treatment of the jitter-probe transmission. Default:
2.
Example: Specifies the differentiated services code point (dscp) packet of
or the jitter-probe transmission.
Note The call fallback jitter-probe precedence command is
mutually exclusive with the call fallback jitter-probe
Example:
dscp command. Only one of these command can be
enabled on the router. Usually, the call fallback
call fallback jitter-probe dscp jitter-probe precedence command is enabled. When the
dscp-number call fallback jitter-probe dscp command is configured,
the precedence value is replaced by the DSCP value. To
Example: disable DSCP and restore the default jitter probe
precedence value, use the no call fallback jitter-probe
Router(config)# call fallback jitter-probe dscpcommand.
precedence 2
Example:
or
Example:
Router(config)# call fallback jitter-probe
dscp 2
Step 5 call fallback jitter-probe priority-queue Assigns a priority to the queue for jitter probes.
Example:
Router(config)# call fallback jitter-probe
priority-queue
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback probe-timeout seconds
4. call fallback instantaneous-value-weight percent
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# call fallback probe-timeout
20
Step 4 call fallback instantaneous-value-weight percent Configures the call fallback subsystem to take an average from
the last two probes registered in the cache for call requests:
Example: • percent --Instantaneous value weight, expressed as a
Router(config)# call fallback percentage. Range: 0 to 100. Default: 66.
instantaneous-value-weight 50
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback threshold delay delay-value loss loss-value
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback threshold delay delay-value Specifies fallback threshold to use packet delay and loss values. No
loss loss-value defaults.
Example:
or
Example:
Router(config)# call fallback threshold
icpif 100
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback wait-timeout milliseconds
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback wait-timeout Configures the waiting timeout interval for a response to a probe in milliseconds.
milliseconds Default: 300 milliseconds.
Note The time-to-wait period set by the call fallback wait-timeout command
Example: should always be greater than or equal to twice the amount of the
Router(config)# call fallback threshold delay time set by the call fallback threshold delay loss
wait-timeout 200 command; otherwise the probe will fail. The delay configured by the
call fallback threshold delay loss command corresponds to a one-way
delay, whereas the time-to-wait period configured by the call fallback
wait-timeout command corresponds to a round-trip delay. The
threshold delay time should be set at half the value of the time-to-wait
value.
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback active
4. snmp-server enable traps voice fallback
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call fallback active Enables the PSTN fallback feature to alternate dial peers
in case of network congestion.
Example:
Router(config)# call fallback active
Step 4 snmp-server enable traps voice fallback Configures the SNMP trap parameters.
Example:
Router(config)# snmp-server enable traps voice
fallback
What to Do Next
Configure the rtr responder command on the terminating voice gateway. If the rtr responder is enabled on
the terminating gateway, the terminating gateway responds to the probe request when the originating gateway
sends an Response Time Report (RTR) probe to the terminating gateway to check the network conditions.
SUMMARY STEPS
1. enable
2. configure terminal
3. Do one of the following:
• call fallback map map target ip-address address-list ip-address1 ip-address2 ... ip-address7
•
• call fallback map map target ip-address subnet ip-network netmask
DETAILED STEPS
Example:
Router# configure terminal
Step 3 Do one of the following: Specifies the call fallback router to keep a cache table (by IP addresses)
of distances for several destination peers sitting behind the router.
• call fallback map map target
ip-address address-list ip-address1 • map --Fallback map. Range is from 1 to 16. There is no default.
ip-address2 ... ip-address7
• target ip-address --Target IP address.
•
• ip-address1 ip-address2 ... ip-address7 --Lists the IP addresses
• call fallback map map target that are kept in the cache table. The maximum number of IP
ip-address subnet ip-network netmask addresses is seven.
Specifies the call fallback router to keep a cache table (by subnet
addresses) of distances for several destination peers sitting behind the
router.
• DNS
• IP version 4
• SIP-server
• enum
To configure call-fallback monitor probes to ping IP destinations, complete one of the following tasks:
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag voip
4. call fallback [icmp-ping| rtr]
5. monitor probe {icmp-ping| rtr} [ip address]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 dial-peer voice tag voip Enters dial peer configuration mode, specifies the method of voice
encapsulation, and defines a particular dial peer:
Example: tag --Digits that define a particular dial peer. Range is from 1 to 2147483647.
Router(config)# dial-peer voice
10 voip
Step 4 call fallback [icmp-ping| rtr] Configures dial-peer parameters for pings to IP destinations:
• icmp-ping --Uses ICMP pings to monitor the IP destinations.
Example:
• rtr --Uses RTR probes to monitor the session target and update the status
Router(config-dial-peer)# call
fallback icmp-ping of the dial peer. RTR probes are the default.
Global Configuration
To configure global parameters to use ICMP pings to monitor IP destinations, complete this task.
SUMMARY STEPS
1. enable
2. configure terminal
3. call fallback active [icmp-ping| rtr]
4. call fallback icmp-ping [count number] [codec type] | size bytes] interval seconds [loss number] [timeout
milliseconds]
DETAILED STEPS
Example:
Router# configure terminal
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port
4. busyout monitor probe icmp-ping ip address [codec type | size bytes][loss percent]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-port slot / port Enters voice-port configuration mode and identifies the slot and port
where the configuration parameters take effect.
Example: Note The syntax for this command varies by platform. For more
Router(config)# voice-port 1/0 information, see the Cisco IOS Voice Command Reference
Step 4 busyout monitor probe icmp-ping ip Specifies the parameters for ICMP pings for monitoring under voice-port
address [codec type | size bytes][loss configuration:
percent]
• ip address --IP address of the destination to which the ping is sent.
Example: • codec --(Optional) Codec type for deciding the ping packet size.
Router(config-voiceport)# busyout • type --Acceptable codec types are g711a, g711u, g729, and g729b.
monitor probe 10.1.1.1 g711u loss 10
delay 2000 • size --(Optional) Size (in bytes) of the ping packet. Default is 32.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice class busyout tag
4. busyout monitor probe icmp-ping ip address [codec type | size bytes][loss percent]
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice class busyout tag Creates a voice class for local voice busyout functions:
tag --Unique identification number assigned to one voice class. Range
Example: is 1 to 10000.
Router(config)# voice class busyout 10
Step 4 busyout monitor probe icmp-ping ip address Configures the parameters for ICMP pings for monitoring under
[codec type | size bytes][loss percent] voice-port:
• ip address --IP address of the destination to which the ping is
Example: sent.
Router(config-class)# busyout monitor
probe icmp-ping 10.1.1.1 codec g729b size • codec --(Optional) Codec type for deciding the ping packet size.
32
• type --Acceptable codec types are g711a, g711u, g729, and
g729b.
• size --(Optional) Size (in bytes) of the ping packet. Default is
32.
• loss --(Optional) Threshold packet loss, expressed as a
percentage. Default is 20.
• show call fallback cache --Displays the current Calculated Planning Impairment Factor (ICPIF) estimates
for all IP addresses in the call fallback cache.
• show call fallback config --Displays the current configuration.
• show call fallback stats --Displays the call fallback statistics.
What To Do Next
The Configuring ICMP Pings to Monitor IP Destinations, on page 92 describes the mechanism whereby a
dial-peer becomes temporarily disabled because of poor SAA/RTR probe results (for example, ICPIF, jitter,
or loss), or because of failure of the ICMP ping test. When this occurs, the normal alternate dial-peer selection
process (hunting) is triggered to search for an alternate dial-peer that represents an alternate route.
The global configuration voice hunt command controls whether hunting (continue to look or "hunt" for an
alternate dial-peer match) occurs, based on the specific cause code that describes why the initial dial-peer
path failed. Hunting is usually appropriate if the cause code indicates network congestion, but usually
inappropriate if the failure cause code indicates that the called user is actually busy. Even if an alternate path
is taken to reach the called user, and if the user is actually busy, the user will be busy regardless of which path
is used.
For more information about the voice hunt command, see the Cisco IOS Voice Command Reference .
• Receive path (also called the return or Rx path)--The receive path is created when a person hears the
conversation. The sound is received by the ear of the listener from the mouth of the speaker.
The figure below shows a simple voice call between caller A and caller B. The top line represents the Tx path
for caller A, which becomes the Rx path for caller B. The bottom line represents the Tx path for caller B,
which becomes the Rx path for caller A.
Echo Cancellation
Echo is the sound of your own voice reverberating in the telephone receiver while you are talking. When
timed properly, echo is not a problem in the conversation; however, if the echo interval exceeds approximately
25 milliseconds (ms), it can be distracting to the speaker. In the traditional telephony network, echo is generally
caused by an impedance mismatch when the four-wire network is converted to the two-wire local loop. Echo
is controlled by echo cancellers (ECs).
A packet voice gateway, which operates between a digital packet network and the PSTN, can include both
digital (time division multiplexing [TDM]) and analog links. The analog circuit is known as the tail circuit.
It forms the tail or termination of the call from the perspective of the person experiencing the echo. The tail
circuit is everything connected to the PSTN side of a packet voice gateway--all the switches, multiplexers,
cabling, and PBXs between the voice gateway and the telephone.
The figure below shows a common voice network where echo cancellation might be used.
An echo canceller reduces the level of echoes that leak from the Rx path (from the gateway out into the tail
circuit) into the Tx path (from the tail circuit into the gateway). From the perspective of the echo canceller in
a voice gateway, the Rx signal is a voice coming across the network from another location. The Tx signal is
a mixture of the voice call in the other location and the echo of the original voice, which comes from the tail
circuit on the initiating end and is sent to the receiving end.
Echo cancellers face into the PSTN tail circuit. They eliminate echoes in the tail circuit on its side of the
network.The echo canceller in the originating gateway looks out into the tail circuit and is responsible for
eliminating the echo signal from the initiation Tx signal and allowing a voice call to go through unimpeded.
By design, ECs are limited by the total amount of time they wait for the reflected speech to be received, which
is known as an echo tail. The echo tail is normally 32 ms.
Note Delay and jitter in the WAN do not affect the operation of the echo canceller because the tail circuit, where
the echo canceller operates, is static.
Echo cancellation is implemented in digital signal processor (DSP) firmware (DSPWare) on Cisco voice
gateways and is independent of other functions implemented in the DSP (the DSP protocol and compression
algorithm). In voice packet-based networks, ECs are built into the low-bit-rate codecs and are operated on
each DSP.
The figure below shows a typical DSP channel configured for voice processing.
• Echo return loss enhancement (ERLE)--Additional reduction in echo level accomplished by the echo
canceller. An echo canceller is not a perfect device; the best it can do is attenuate the level of the returning
echo. ERLE is a measure of this echo attenuation. It is the difference between the echo level arriving
from the tail circuit at the echo canceller and the level of the signal leaving the echo canceller.
• Acombined (ACOM)--Total ERL seen across the terminals of the echo canceller. ACOM is the sum of
ERL + ERLE, or the total ERL seen by the network.
For more information about the echo canceller, refer to the "Echo Analysis for Voice over IP" document.
Convolution Processor
The CP first stage captures and stores the outgoing signal toward the far-end hybrid. The CP then switches
to monitoring mode and, when the echo signal returns, estimates the level of the incoming echo signal and
subtracts the attenuated original voice signal from the echo signal.
The time required to adjust the level of attenuation needed in the original signal is called the convergence
time. Because the convergence process requires that the voice signal be stored in memory, the EC has limited
coverage of tail circuit delay, normally 64, 96, and up to 128 ms. After convergence, the CP provides about
18 dB of ERLE. Because a typical analog phone circuit provides at least 12 dB of ERL (that is, the echo path
loss between the echo canceller and the far-end hybrid), the expected permanent ERL of the converged echo
canceller is about 30 dB or greater.
Nonlinear Processor
In single-talk mode, that is, when one person is talking and the other is silent, the NLP replaces the residual
echo at the output of the echo canceller with comfort noise based on the actual background noise of the voice
path. The background noise normally changes over the course of a phone conversation, so the NLP must adapt
over time. The NLP provides an additional loss of at least 25 dB when activated. In double-talk mode, the
NLP must be deactivated because it would create a one-way voice effect by adding 25 to 30 dB of loss in
only one direction.
To completely eliminate the perception of echo, the talker echo loudness rating (TELR) should be greater
than 65 dB in all situations. To reflect this reality, ITU-T standard G.168 requires an ERL equal to or greater
than 55 dB. Segmentation local reference (SLR), receive loudness rating (RLR), and cell loss ratio (CLR)
along the echo path should allow another 10 dB to meet the expected TELR. CP, NLP and loudness ratings
(LRs) must be optimized to make sure that echo is canceled effectively.
known as the ringing time of the tail circuit--the time required for all of the ripples to disperse. To fully
eliminate all echoes, the coverage of the echo canceller must be as long as the ringing time of the tail circuit.
Release Modification
12.2(13)T This feature was introduced.
Release Modification
12.3(4)XD The G.168 extended EC became the only EC on all
voice packet platforms that support the extended
G.168 EC; the Cisco G.165 EC is no longer a
selectable option.
Note The Cisco AS5300 still supported choosing
between the Cisco G.165 EC and the
extended G.168 EC.
12.3(3) The G.148 extended EC was configurable with no
codec restriction on the Cisco AS5300.
Extended EC Comparison
The table below contains comparison information for G.165 and G.168 echo cancellation.
WS-SVC-CMM-24FXS 12.3(8)XY -- -- -- --
12.3(14)T
WS-SVC-CMM-24FXS 12.3(8)XY -- -- -- --
12.3(14)T
Cisco MC3810 HCM 549 12.2(13)T 12.2(13)T 12.3(1) mainline 12.3(1) mainline --
Note Extended echo cancellation is configured differently depending on the version of Cisco IOS software that
you are using. If you are using Cisco IOS Release 12.3(4)XD or a later release, you do not have to use
any Cisco IOS commands to enable the Extended ITU-T standard G.168 Echo Cancellation feature because
the extended G.168 EC is the only available echo canceller. You have the option of disabling the extended
EC, but it is highly recommended that you leave it enabled.
To configure the NextPort dual-filter G.168 echo canceller, see the "NextPort-Based Voice Tuning and Echo
Cancellation" chapter in this guide.
The table below lists the Cisco IOS commands that are used for selecting the extended G.168 EC based on
your platform and Cisco IOS release.
Table 8: Cisco IOS Commands for Selecting Extended E.168 EC by Platform and Cisco IOS Release
12.2(13)T
Router(config)# voice echo-canceller extended
12.2(15)ZJ 12.3(4)T
Router(voice-card)# codec complexity medium
12.2(13)T
Router(config-dspfarm)# codec complexity
medium ecan-extended
Cisco AS5300
12.2(13)T
Router(config)# voice echo-canceller extended
codec small codec large codec
12.3(3)
Router(config)# voice echo-canceller extended
[codec small codec large codec]
Cisco 2600 Series, Cisco 3600 Series, Cisco 3700 Series, Cisco MC3810, and Cisco VG200
• Changing Codec Complexity on Cisco 2600 Series, Cisco 3600 Series, Cisco 3700 Series, and Cisco
MC3810 in the "Configuring Digital Voice Ports" chapter.
Note See the table above for extended EC algorithm coverage by platform.
Note You must clear all calls on the system before using the following commands. If there are active calls on
the system, the commands are ignored and a warning message is issued.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice echo-canceller extended
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice echo-canceller extended Enables the G.168 extended echo canceller on the Cisco 1700 series or
Cisco ICS 7750.
Example: • You do not have to shut down all the voice ports on the Cisco
Router(config)# voice echo-canceller 1700 or Cisco ICS 7750 to switch the echo canceller, but you
extended should make sure that when you switch the echo canceller, there
are no active calls on the router.
• To return to the proprietary Cisco G.165 default EC, use the no
form of the command.
Example:
Router(config)# exit
Note You must clear all calls on the system before using the following commands. If there are active calls on
the system, the commands are ignored and a warning message is issued.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-card slot
4. codec complexity medium
5. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-card slot Enters voice card configuration mode on the specified slot.
Example:
Router(config)# voice-card 1
Example:
Router(voice-card)# codec complexity medium
Step 5 end Exits voice-card configuration mode and completes the steps
for configuring the extended EC on the Cisco 1700 series and
Example: Cisco ICS 7750.
Router(voice-card)# end
Note A firmware upgrade can be made by upgrading Cisco VCWare. For upgrade information, refer to the
Combined Version Release Notes and Compatibility Matrix for Cisco VCWare on Cisco AS5300 Universal
Access Servers/Voice Gateways .
• Review your existing configuration and look for all dial peers that select codecs or fax-relay specification
that are different from the codecs that you decide on. After choosing the codecs to be supported by the
extended echo canceller, either remove all dial peers with different codecs not supported by your new
configuration or modify the dial-peer codec selection by selecting a voice codec or fax-relay that is
supported by the new configuration.
• Ensure that modem relay is not configured in any of the dial-peer configurations. If modem relay is
configured, it should be disabled using the no modem relaycommand.
Note • The extended G.168 EC can be used only in one of the following ways on the Cisco AS5300:
◦With a restricted set of codecs with C542 or C549 DSP firmware. Two channels of voice are
supported per DSP, and full call handling capacity is supported.
◦With no restrictions on codecs with C549 DSP firmware. One channel of voice is supported
per DSP, and call handling capacity is reduced by half.
• Not all Cisco platforms that use C542 or C549 DSPs support the extended EC. Other platforms
continue to use the proprietary Cisco G.165 EC if they do not support the extended EC.
>
SUMMARY STEPS
1. enable
2. configure terminal
3. no dial-peer voice tag voip
4. dial-peer voice tag voip
5. codec {g711alaw | g711ulaw | g723ar53 | g723ar63 | g723r53 | g723r63 | g726r16 | g726r24 | g726r32
| g726r53 | g726r63 | g728 | g729abr8 | g729ar8 | g729br8 | g729r8 | gsmefr | gsmfr} [bytes payload-size]
6. exit
7. Do one of the following:
• voice echo-canceller extended
•
• voice echo-canceller extended [codec small codec large codec]
8. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 no dial-peer voice tag voip (Optional) Removes VoIP dial peers, one dial peer at a time.
• When configuring the extended EC in global configuration
Example: mode, you must remove or modify all existing VoIP dial
Router(config)# no dial-peer voice 1 voip peers before the voice echo-canceller extendedcommand is
accepted.
Step 4 dial-peer voice tag voip Enters dial-peer configuration mode so that you can modify a codec
type.
Example:
Router(config)# dial-peer voice 1 voip
Step 5 codec {g711alaw | g711ulaw | g723ar53 | g723ar63 Specifies the voice codec rate for the dial peer.
| g723r53 | g723r63 | g726r16 | g726r24 | g726r32
| g726r53 | g726r63 | g728 | g729abr8 | g729ar8 |
Example:
Router(config-dialpeer)# codec g711alaw
Step 7 Do one of the following: Enables the extended echo canceller with no restriction on codecs.
• voice echo-canceller extended or
Example:
Router(config)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port:ds0-group-number
4. echo-cancel enable
5. echo-cancel coverage {24 | 32 | 48 | 64 | 80 | 96 | 112 | 128}
6. echo-cancel erl worst-case [0 | 3 | 6]
7. non-linear
8. echo-cancel suppressor seconds
9. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-port slot / Enters voice-port configuration mode on the selected slot, port, and DS0 group.
port:ds0-group-number Note The syntax of this command is platform-specific. For the syntax for your
platform, refer to the Cisco IOS Voice Command Reference.
Example:
Router(config)# voice-port
1/0:0
Note This command is supported only when the echo-cancel coverage command
is enabled.
Worst-case ERL does not directly modify the inbound or outbound signals. This is
purely a configuration parameter for the EC to help it distinguish between echo and
a new signal.
Note This command is supported for the extended G.168 EC only; it is not
supported for the G.165 EC.
Step 7 non-linear (Optional) Selects nonlinear processing (residual echo suppression) in the EC, which
either shuts off any signal or mixes in comfort noise if no near-end speech is detected.
Example: Note This command is supported only when echo cancellation is enabled. See
Router(config-voiceport)# Step 4 .
non-linear
• Nonlinear processing is enabled when the extended G.168 EC is enabled. Use
the no form of this command to disable the NLP.
Step 8 echo-cancel suppressor seconds (Optional) Applies echo suppression for the number of seconds specified when using
the G.165 EC.
Example: • This command cannot be used with the extended G.168 EC in Cisco IOS
Router(config-voiceport)# Release 12.2(15)ZJ or later releases, or on NextPort (Cisco AS5350 and Cisco
echo-cancel suppressor 10 AS5400) platforms.
Note This command is required to configure the Extended ITU-T standard G.168
Echo Cancellation feature in Cisco IOS Release 12.2(13)T.
• For the AS5300, the Cisco G.165 EC is enabled by default with echo
suppression disabled. The echo suppressor can be used only on T1 DSPs when
the default Cisco G.165 EC is used.
• This command enables echo cancellation for voice that is sent out an interface
and received back on the same interface within the configured amount of time.
• This command reduces the initial echo before the echo canceller can converge.
In case of double-talk in the first number of seconds, the code automatically
disables the suppressor.
Step 9 end Exits voice-port configuration mode and completes the configuration.
Example:
Router(config-voiceport)# end
Enabling the Extended EC on the Cisco 1700 Series and Cisco ICS 7750 Example
The following example enables the G.168 extended EC on a Cisco 1700 series or a Cisco ICS 7750. The
extended EC is enabled by default when the medium keyword is used in Cisco IOS Release 12.2(13)ZH and
later.
voice-card 1
codec complexity medium
Note The extended G.168 EC is the only EC in Cisco IOS Release 12.3(4)XD and later releases. Because it is
enabled by default, it does not display in the configuration output in Cisco IOS Release 12.3(4)XD and
later releases.
.
.
.
voice-card 1
codec complexity high ecan-extended
.
.
.
controller T1 1/0
framing esf
linecode b8zs
pri-group timeslots 1-24
!
voice-port 1/0:23
.
.
.
dial-peer voice 104001 voip
destination-pattern 104001
session target ipv4:10.2.0.104
dtmf-relay cisco-rtp
codec g711alaw
fax rate 14400
fax protocol cisco
.
.
.
Enabling the Extended EC on the Cisco 7200 and Cisco 7500 Series Example
The following example changes codec complexity on a Cisco 7200 series or Cisco 7500 series:
!
version 12.3
no service pad
service timestamps debug datetime msec
service timestamps log uptime
no service password-encryption
service internal
!
hostname router
!
boot-start-marker
boot-end-marker
!
enable secret 5 $123
enable password temp
!
!
resource-pool disable
!
no aaa new-model
ip subnet-zero
ip rcmd rcp-enable
ip rcmd rsh-enable
ip domain name cisco.com
ip host router1 10.10.101.14
!
!
isdn switch-type primary-5ess
!
v
oice echo-canceller extended codec small g711 large fax-relay
!
!
!
fax interface-type fax-mail
!
!
controller T1 0
framing esf
clock source line primary
linecode b8zs
pri-group timeslots 1-24
.
.
.
voice-port 1/0:0
echo-cancel coverage 64
voice-port 0:D
echo-canceller erl worst-case 3
playout-delay mode fixed
no comfort-noise
Note PCM capture is a CPU-intensive feature, and you must not enable several PCM capture sessions while
running heavy traffic.
1. enable
2. configure terminal
3. voice pcm capture buffer number
4. voice pcm capture destination url
5. voice pcm capture on-demand-trigger
6. voice pcm capture user-trigger-string start-string stop-string stream bitmap duration call-duration
7. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice pcm capture buffer number Configures the number of PCM capture buffers. The Range is from
0 to 200000. To change the PCM capture buffer size, you must first
Example: configure it with 0 and then configure it with the desired number.
Router(config)# voice pcm capture buffer
10
Step 4 voice pcm capture destination url Configures or changes the destination URL for storing captured
data.
Example:
Router(config)# voice pcm capture
destination tftp://10.10.1.2/acphan/
Example:
Router(config)# voice pcm capture
on-demand-trigger
Step 6 voice pcm capture user-trigger-string start-string Changes the default user trigger PCM capture start and stop string,
stop-string stream bitmap duration call-duration stream, and duration.
• The start and stop string must have different values.
Example:
Router(config)# voice pcm capture #132 #543 • PCM stream bitmap is in hexadecimal. The range is from 1
stream ff duration 230
to FFFFFFF.
Example:
Router(config)# end
SUMMARY STEPS
1. enable
2. show voice pcm capture
DETAILED STEPS
Step 1 enable
Example:
Router> enable
Example:
Router# show voice pcm capture
PCM Capture is on and is logging to URL tftp://10.10.1.2/acphan/
50198 messages sent to URL, 0 messages dropped
Message Buffer (total:inuse:free) 200000:0:200000
Displays the configured PCM capture buffer and destination, number of saved messages/packets, number of dropped
messages/packets, and number of buffers allocated, both used and free.
Voice commands
• Cisco IOS Voice Command
Reference - A through C
• Cisco IOS Voice Command
Reference - D through I
• Cisco IOS Voice Command
Reference - K through R
• Cisco IOS Voice Command
Reference - S Commands
• Cisco IOS Voice Command
Reference - T through Z
Commands
Technical Assistance
Description Link
The Cisco Support and Documentation website http://www.cisco.com/cisco/web/support/index.html
provides online resources to download documentation,
software, and tools. Use these resources to install and
configure the software and to troubleshoot and resolve
technical issues with Cisco products and technologies.
Access to most tools on the Cisco Support and
Documentation website requires a Cisco.com user ID
and password.
Table 9: Feature Information for Pulse Code Modulation (PCM) Audio Capture
Pulse Code Modulation (PCM) Cisco IOS XE Release 3.6S The PCM Capture feature is used
Audio Capture for debugging audio quality issues.
In Cisco IOS XE Release 3.6S, this
feature was implemented on the
Cisco Unified Border Element
(Enterprise)
The following commands were
introduced or modified: show voice
pcm capture, voice pcm capture.
• No support for H.32x video call, complex forking calls, and fax and modem calls.
• No support for TDM hairpin call.
• The configuration under dial peer has higher priority than the configuration at the global level.
• No support for conference calls, IP/SIP phones, and the Skinny Client Control Protocol (SCCP).
• CLI supports enabling ASP but not disabling ASP.
• No support for dynamically enabling or disabling ASP during a call.
If an offending tone is present, the audio path in that direction is muted temporarily, and a quiet, alerting signal
is played out to the listener side. The call is never dropped; only the audio is muted temporarily. If or when
the tone disappears from the input, the mute is removed. ASP does not disrupt low-frequency tones (below
650 Hz) such as ringback, dial, and so forth. Since ASP is designed to mute only single-frequency tones, it
allows multi-tone signals such as Dual Tone Multi-Frequency (DTMF) to pass unhindered. ASP is supported
on TDM gateways (TDM-VoIP and TDM-TDM) and on the Cisco Unified Border Element (Cisco UBE).
Note ASP is for voice calls only and not for faxes and modems.
SUMMARY STEPS
1. enable
2. configure terminal
3. media profile asp tag
4. mode mode
5. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 media profile asp tag Creates the media profile to configure ASP and enters media profile
configuration mode. The range for the media profile tag is from 1 to 10000.
Example:
Device(config)# media profile asp 5
Step 4 mode mode Sets the ASP sensitivity mode to preset = auto (which is default). Auto
mode provides a good tradeoff between ASP speed and false trigger
Example: rejection.
Device(cfg-mediaprofile)# mode auto
The other modes are:
• slow—Presets ASP sensitivity mode to 1. This mode provides slower
detection speed for reduced chance of false triggers.
• fast—Presets ASP sensitivity mode to 2. This mode provides faster
detection speed but higher chance of false triggers.
• expert—This mode exposes direct control of individual ASP
parameters and is recommended for test use only.
Example:
Device(config)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. media class tag
4. asp profile tag
5. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 media class tag Creates the media class to enable the acoustic shock protection
feature and enters media class configuration mode. The range
Example: for the media class tag is from 1 to 10000.
Device(config)# media class 2
Example:
Device(cfg-mediaclass)# end
1. enable
2. configure terminal
3. dial-peer voice tag pots
4. media-class tag
5. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 dial-peer voice tag pots Defines a particular dial peer and enters dial-peer voice
configuration mode. The range for the dial-peer voice tag is
Example: from 1 to 1073741823.
Device(config)# dial-peer voice 20 pots
Example:
Device(config-dial-peer)# end
1. enable
2. configure terminal
3. media service
4. enhancement
5. tdm tag
6. end
DETAILED STEPS
Example:
Device# configure terminal
Example:
Device(config)# media service
Example:
Device(cfg-mediaservice)# enhancement
Step 5 tdm tag Applies the TDM call globally. The range for the media
class tag number is from 1 to 10000.
Example:
Device(cfg-service-enhance)# tdm 2
Example:
Device(config-dial-peer)# end
Verifying ASP
Perform this task to verify the voice quality metrics.
SUMMARY STEPS
1. enable
2. show call active voice stats | b pid:
DETAILED STEPS
Step 1 enable
Example:
Device> enable
Example:
Device# show call active voice stats | b pid:1300
11EC : 5 09:14:25.971 PDT Thu Jul 28 2011.1 +1130 pid:1300 Answer 1300 active dur 00:01:36 tx:17/321
rx:17/321 dscp:0 media:0
DSP/TX: PK=17, SG=0, NS=1, DU=90570, VO=320
DSP/RX: PK=17, SG=0, CF=1, RX=90570, VO=320, BS=0, BP=0, LP=0, EP=0
….
Displays information about digital signal processing (DSP) voice quality metrics.
Troubleshooting Tips
The following commands can help troubleshoot ASP:
• debug voip hpi all
• debug voip dsmp all
• debug voip dsm all
• debug voip vtsp all
• debug vpm dsp all
media-class 1
port 0/2/0:1
forward-digits all
dial-peer voice 1300 voip
destination-pattern 1300 session target ipv4:1.2.146.102 media-class 1
Acoustic Shock Protection Cisco IOS XE Release 3.6S Acoustic Shock Protection (ASP)
is a voice circuit-breaker feature
that is designed to protect users,
especially those wearing headsets,
from exposure to loud, sustained,
and piercing tones, such as those
produced by a fax machine. It is a
workplace-safety feature for voice
calls. ASP is supported on TDM
gateways and on Cisco UBE.
In Cisco IOS XE Release 3.6S, this
feature was implemented on the
Cisco Unified Border Element
(Enterprise)
The following commands were
introduced or modified: media
profile asp, media service.
Restrictions for NR
• Supported only on PVDM3.
• Supported only on flex codec complexity.
• No support for H.32x video call, complex forking calls, and fax and modem calls.
• No support for Time-Division Multiplexing (TDM) hairpin call.
• Configurations under POTS dial peer has higher priority over VoIP dial peer for NR.
• Configurations under the dial peer has higher priority than configurations at the global level.
• No support for conference calls, IP/SIP phones, and the Skinny Client Control Protocol (SCCP).
• CLI supports enabling NR but not disabling NR.
• No support for dynamically enabling or disabling NR during a call.
Information About NR
Noise Reduction
Noise Reduction (NR) is an adaptive signal processing algorithm on the Digital Signal Processor (DSP) that
analyzes incoming audio, extracts a fingerprint of the background noise during talker pauses, and then performs
ongoing spectral subtraction of this noise after a short training period (a few seconds). NR constantly adapts
to changes in background noises over time.
NR can affect music on hold signals by making the music quieter. NR may disrupt fax/modem/TDD devices,
although it is designed to self-disable in those cases. Use modem-relay mode for reliable fax/modem
transmission. NR is supported on TDM gateways (TDM-VoIP and TDM-TDM) and on the Cisco Unified
Border Element (Cisco UBE).
Some of the best practices for NR are as follows:
• Use default values.
• Do not use NR on dial peers associated with fax machines. Use fax or modem-relay modes for those
dial peers.
• NR, when used without dynamic user control of intensity (as is the case with gateways), must be used
at a low intensity (default or lower) since it is always on. High intensity is dramatic for demonstrations
with loud background noises, but the NR process itself will degrade “normal” calls if NR is run at high
intensity.
How to Configure NR
SUMMARY STEPS
1. enable
2. configure terminal
3. media profile nr tag
4. intensity level
5. noisefloor level
6. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 media profile nr tag Creates the media profile to configure noise reduction parameters
and enters media profile configuration mode. The range for the
Example: media profile tag is from 1 to 10000.
Device(config)# media profile nr 2
Step 4 intensity level Configures the intensity level or depth of the noise reduction
process. The range is from 0 to 6.
Example:
Device(cfg-mediaprofile)# intensity 2
Step 5 noisefloor level Configures the noise level, in dBm, above which NR will operate.
NR will allow noises quieter than this level to pass without
Example: processing. The range is from -58 to -20.
Device(cfg-mediaprofile)# noisefloor -50
Example:
Device(config)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. media class tag
4. nr profile tag
5. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 media class tag Creates the media class to enable the noise reduction feature
and enters media class configuration mode. The range for the
Example: media class tag is from 1 to 10000.
Device(config)# media class 2
Example:
Device(config)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag pots
4. media-class tag
5. end
DETAILED STEPS
Example:
Device# configure terminal
Step 3 dial-peer voice tag pots Defines a particular dial peer and enters the dial-peer voice
configuration mode. The range for the dial-peer voice tag is
Example: from 1 to 1073741823.
Device(config)# dial-peer voice 20 pots
Example:
Device(config-dial-peer)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. media service
4. enhancement
5. tdm tag
6. end
DETAILED STEPS
Example:
Device# configure terminal
Example:
Device(config)# media service
Example:
Device(cfg-mediaservice)# enhancement
Step 5 tdm tag Applies the TDM call globally. The range for the media
class tag number is from 1 to 10000.
Example:
Device(cfg-service-enhance)# tdm 2
Example:
Device(config-dial-peer)# end
Verifying NR
Perform this task to verify the voice quality metrics.
SUMMARY STEPS
1. enable
2. show call active voice stats | b pid:
DETAILED STEPS
Step 1 enable
Example:
Device> enable
Example:
Device# show call active voice stats | b pid:1300
11EC : 5 09:14:25.971 PDT Thu Jul 28 2011.1 +1130 pid:1300 Answer 1300 active dur 00:01:36 tx:17/321
rx:17/321 dscp:0 media:0
DSP/TX: PK=17, SG=0, NS=1, DU=90570, VO=320
DSP/RX: PK=17, SG=0, CF=1, RX=90570, VO=320, BS=0, BP=0, LP=0, EP=0
….
DSP/DL: RT=0, ED=0
MIC Direction:
DSP/NR: NR=1, ND=0, LV=257, IN=1, PN=0, ON=0
DSP/AS: AE=1, AD=0, AV=0, AM=0, NT=0, DT=0, TT=0, TD=0, LF=0, LD=0
EAR Direction:
DSP/NR: NR=0, ND=0, LV=0, IN=0, PN=0, ON=0
DSP/AS: AE=0, AD=0, AV=0, AM=0, NT=0, DT=0, TT=0, TD=0, LF=0, LD=0
11EC : 6 09:14:25.973 PDT Thu Jul 28 2011.2 +1130 pid:2300 Originate 2300 active dur 00:01:36 tx:17/457
rx:17/321 dscp:0 media:0
Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 1
Displays information about digital signal processing (DSP) voice quality metrics.
Troubleshooting Tips
The following commands can help troubleshoot NR:
• debug voip hpi all
• debug voip dsmp all
• debug voip dsm all
• debug voip vtsp all
• debug vpm dsp all
media profile nr 1
intensity 1
!
media profile nr 2
!
media profile nr 3
intensity 2
!
media profile nr 4
intensity 3
!
media profile nr 5
intensity 2
!
media profile nr 7
intensity 2
!
media profile asp 6
!
media class 1
nr profile 5
asp profile 6
!
media service
enhancement
tdm 1
media profile nr 1
intensity 1
!
media profile nr 2
intensity 2
!
media profile nr 3
intensity 2
!
media profile asp 4
!
media class 1
nr profile 2
asp profile 4
!
dial-peer voice 2100 pots
destination-pattern 2100
incoming called-number 1100
media-class 1
port 0/2/0:1
forward-digits all
Noise Reduction Cisco IOS XE Release 3.6S Noise Reduction (NR) is a voice
enhancement or restoration process
that improves the quality of
incoming speech that has already
been corrupted with background
noise. NR is supported on TDM
gateways and on Cisco UBE.
In Cisco IOS XE Release 3.6S, this
feature was implemented on the
Cisco Unified Border Element
(Enterprise).
The following commands were
introduced or modified: intensity,
media profile nr, media service,
noisefloor.
.
.
***DSP LEVELS***
TDM Bus Levels(dBm0): Rx -12.5 from PBX/Phone, Tx -16.4 to PBX/Phone
TDM ACOM Levels(dBm0): +27.0, TDM ERL Level(dBm0): +27.0
TDM Bgd Levels(dBm0): -84.4, with activity being silence
***DSP VOICE ERROR STATISTICS***
Rx Pkt Drops(Invalid Header): 0, Tx Pkt Drops(HPI SAM Overflow): 0
Router# show voice call 0/0/0:23.2
0/0/0:23 2
vtsp level 0 state = S_CONNECT
callid 0x0002 B02 state S_TSP_CONNECT clld 9011202 cllg 9011205
Router# ***DSP VOICE TX STATISTICS***
Tx Vox/Fax Pkts: 1800, Tx Sig Pkts: 0, Tx Comfort Pkts: 0
Tx Dur(ms): 36000, Tx Vox Dur(ms): 36000, Tx Fax Dur(ms): 0
.
.
.
***DSP LEVELS***
TDM Bus Levels(dBm0): Rx -23.5 from PBX/Phone, Tx -36.5 to PBX/Phone
TDM ACOM Levels(dBm0): +6.0, TDM ERL Level(dBm0): +6.0
TDM Bgd Levels(dBm0): +0.0, with activity being silence
***DSP VOICE ERROR STATISTICS***
Rx Pkt Drops(Invalid Header): 0, Tx Pkt Drops(HPI SAM Overflow): 0
The following is sample output showing hardware echo cancellation--note that the TDM ERL level is +6.0
in both cases.
***DSP LEVELS***
TDM Bus Levels(dBm0): Rx -24.9 from PBX/Phone, Tx -35.7 to PBX/Phone
TDM ACOM Levels(dBm0): +6.0, TDM ERL Level(dBm0): +6.0
TDM Bgd Levels(dBm0): +0.0, with activity being silence
***DSP VOICE ERROR STATISTICS***
Rx Pkt Drops(Invalid Header): 0, Tx Pkt Drops(HPI SAM Overflow): 0
Figure 16: Sample Network Topology for the T1/E1 Multiflex Voice/WAN Interface Cards with Echo Cancellation Module
SUMMARY STEPS
1. enable
2. configure terminal
3. card type {e1 | t1} slot subslot
4. voice-card slot
5. voice-port {slot-number / subunit-number / port | slot / port : ds0-group-number}
6. echo-cancel enable type [hardware | software]
7. echo-cancel coverage {24| 32| 48| 64| 80| 96| 112| 128}
8. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 card type {e1 | t1} slot subslot Sets or changes the card type to E1 or T1.
• slot --Specifies the slot number. Range can be 0 to 6, depending on the platform.
Example:
• subslot --Specifies the VWIC slot number. Range can be 0 to 3, depending on
Router(config)# card type t1
1 0 the host module or platform.
• When the command is used for the first time, the configuration takes effect
immediately.
• A subsequent change in the card type will not take effect unless you enter the
reloadcommand or reboot the router.
Note When you are using the card type command to change the configuration of
an installed card, you must enter the no card type e1 | t1} slot subslot
command first. Then enter the card type {e1 | t1} slot subslot command for
the new configuration information.
Step 4 voice-card slot Enters voice card configuration mode.
• Specify the slot location using a value from 0 to 5.
Example:
Router(config)# voice card 1
Step 5 voice-port {slot-number / Enters voice port configuration mode and specifies the voice port.
subunit-number / port | slot / port :
ds0-group-number} • The slot-numberargument identifies the slot where the voice interface card (VIC)
is installed. Valid entries are from 0 to 3, depending on the slot in which it has
been installed.
Example:
• The subunit-number identifies the subunit on the VIC where the voice port is
Router(voice-card)# voice-port
3/0:0 located. Valid entries are 0 or 1.
• The port argument identifies the voice port number. Valid entries are 0 and 1.
or
• The slot argument is the slot in which the voice port adapter is installed. Valid
entries are from 0 to 3.
Note The commands, keywords, and arguments that you are able to use may differ
slightly from those presented here, based on your platform, Cisco IOS release,
and configuration. When in doubt, use Cisco IOS command help to determine
the syntax choices that are available.
Step 6 echo-cancel enable type Enables hardware echo cancellation.
[hardware | software]
• The hardware keyword is the default. Echo cancel coverage is hardcoded for
128 ms.
Example:
• This command is needed only to configure the software keywordto effect
router(config-voiceport)#
echo-cancel enable type software-based (DSP) echo cancellation or to restore the hardware default.
hardware
Note The hardware and software keywords are available only when the optional
hardware echo cancellation module (EC-MFT-32 or EC-MFT-64) is installed
on the multiflex VWIC.
Note If you need to obtain accurate, real-time readings for the quality of the TDM
connection and the echo canceller's ability to discern and cancel out echo,
you should enter the echo-cancel enable type software command. See
theRestrictions for Hardware Echo Cancellation, on page 148 for more
information.
Step 7 echo-cancel coverage {24| 32| 48| Adjusts the echo canceller by the specified number of milliseconds.
64| 80| 96| 112| 128}
• These coverage options are applicable only if you configured the echo-cancel
enable type software command in the previous step.
Example:
• If you configured the echo-cancel enable type hardware command in the
Router (config-voiceport) #
echo-cancel coverage 96 previous step, this value is set to 128 ms.
• Beginning with Release 12.4(20)T, the default for software echo cancellation
is 128 ms. Prior to Release 12.4(20)T, the default is 64 ms.
Step 8 exit Exits controller cofiguration mode and returns the router to privileged EXEC mode.
Example:
Router(config-voiceport)# exit
Examples
This section provides the following examples for verifying echo cancellation:
============================================
============================================
Note Detailed information for all Cisco IOS commands mentioned in this section can be found in the Cisco
IOS Voice Command Reference.
The NextPort dual-filter G.168 echo canceller uses the same voice-tuning (VC tune) interface for configuring
voicecap parameters as the Cisco-proprietary G.164 echo canceller. To adjust the dual-filter echo canceller,
use a voicecap or the Cisco IOS command-line interface (CLI) during configuration. You can also adjust
settings while the system is running by using the show port log and show port operational-statuscommands.
However because of the differences in internal operation of these ECs, there are some changes in the set of
available parameters for voice tuning.
See the echo-cancel coverage command for updated Cisco IOS command usage with this feature. The NextPort
dual-filter G.168 echo canceller adds the following benefits on NextPort platforms:
• Configurable parameters--Range checking that is performed on the voicecap parameters in the I960
NextPort layer has been updated. (Voicecap parameters in "raw mode" are never range-checked.)
• Up to 128 ms of echo tail coverage--Beginning with Cisco IOS Release 12.4(20)T, the NextPort dual-filter
G.168 echo canceller supports echo tails from 24-ms to 128-ms in 16-ms increments. The echo-cancel
coverage command limits the echo canceller coverage to 128-ms on NextPort platforms. For backward
compatibility, a voicecap used in "raw mode" will still configure older SPEware to settings greater than
64-ms when used with newer releases of Cisco IOS software. For situations when new SPEware is
loaded onto an older Cisco IOS release, the NextPort dual-filter G.168 echo canceller automatically sets
coverage time to 64 ms.
• Updated set of reported statistics--Text in the show voice port command output has been changed to
describe voicecap parameters and reported statistics. The show port operational-status command output
has been updated to report TX/RX mean speech level statistics.
• Power statistics (RX and TX)--These statistics average only the power that is received during signal
periods that are classified as speech.
• Unchanged configuration steps--Use voicecaps and the echo-cancel coverage command to configure
this feature. See the Voicecap Strings, on page 157.
• SPE firmware and Cisco IOS software packaging support--The SPEware that contains the dual-filter
G.168 echo canceller is field-upgradeable and can be used interchangeably with previous firmware
versions with no effect on platform call density. The new SPEware interoperates with any Cisco IOS
software release that supports voicecaps.
Note When older Cisco IOS software releases are used, voicecaps must be used in raw mode for some parameters.
Some statistics may not be displayed or recorded properly with older software releases.
Note To use the NextPort Voice Tuning and Background Noise Statistics feature, you must use the default
bundled NextPort SPE firmware code that runs with Cisco IOS software. The NextPort-Based Voice
Tuning and Background Noise feature uses SPE firmware version 8.8.1 or a later version. The NextPort
dual-filter G.168 echo canceller uses NextPort firmware version 10.2.2, which is bundled with Cisco IOS
Release 12.3(11)T. NextPort firmware version 10.2.2 can be used with Cisco IOS Release 12.3(7)T,
12.3(10), and later releases.
For more information about NextPort SPE firmware, see the NextPort SPE Release Notes on Cisco.com.
Voicecap Strings
Additional configuration of voice services on NextPort DFCs is achieved by configuring the voice tuning
configuration capability (called voicecaps) using voicecap strings. Voicecap strings are created with the the
voicecap entry command and are applied with the voicecap configure command.
Voice Tuning
This feature allows the following parameters, among others, to be configured:
• PSTN gains--PSTN gains adjust the power levels at the PSTN side of a VoIP connection to make up
for loss plan imbalances and to ensure minimum echo return losses (ERLs) in a call. PSTN gain is
configured with the CLI rather than with voicecaps.
• IP gains--IP gains adjust IP-side levels and are applied to the signal before it is propagated through the
echo canceller. This point is also known as the reference signal.
• Dynamic attenuation--Dynamic attenuation mitigates low volume calls when attenuation has been added
on the PSTN call leg to compensate for low ERL calls.
Note You must have specific knowledge of the behavior of the telephone network in order to use these voicecap
capabilities.
Background Noise
The NextPort Voice Tuning and Background Noise Statistics feature reports EC background noise level, voice
activity detection (VAD) background noise level, ERL level, and Acombined (ACOM) statistics by averaging
the combined values that are computed over the duration of the call. These statistics are appended to the end
of each entry in the voice log, which you can see in the output from the show port log and show port
operational-status commands.
SUMMARY STEPS
1. enable
2. configure terminal
3. spe {first slot | first slot / spe} {last slot | last slot / spe}
4. firmware location [IFS :[/]]filename
5. end
6. copy running-config startup-config
DETAILED STEPS
Example:
Router# configure terminal
Step 3 spe {first slot | first slot / spe} Enters SPE configuration mode and sets the range of SPEs.
{last slot | last slot / spe}
• first slot and last slot--Identifies slots for the range. For the Cisco AS5350, slot
values range from 1 to 3. For the Cisco AS5400, slot values range from 1 to 7.
Example: All ports on the specified slot are affected.
Router(config)# spe 1 1/17
• first slot / spe and last slot/spe--Identifies slots for the range. For the Cisco
AS5350, slot values range from 1 to 3. For the Cisco AS5400, slot values range
from 1 to 7. SPE values range from 1 to 17. You must include the slash mark. All
ports on the specified slot and SPE are affected.
Step 4 firmware location [IFS Downloads SPE modem code to all modems in a particular slot (that is, all modems on
:[/]]filename a feature card that contains 18 6-port modem modules).
• IFS --(Optional) Cisco IOS file specification (IFS), which can be any valid IFS
Example: on any local file system. Examples of legal specifications include:
Router(config-spe)# firmware
location flash:np.8.8.1.spe • bootflash:--Loads the firmware from a separate flash memory device.
• flash:--Loads the firmware from the flash NVRAM located within the router.
• null:--Specifies a firmware file from null: File System.
• system:/--Loads the firmware from a built-in file within the Cisco IOS image.
The optional forward slash (/) and system path must be entered with this
specification.
• filename --The firmware filename. When the filename is entered without an IFS
specification, this name defaults to the file in flash memory.
• Use the dir all-filesystems EXEC command to display legal IFSs.
• The no form of the command reverts the router back to the system-embedded
default. When the access server is booted, the firmware location command
displays the location for the firmware that is embedded in the Cisco IOS image.
If the firmware locationcommand is issued to download a firmware image from
flash and then the no version of the exact command is subsequently issued, then
the firmware location command downloads the embedded firmware in Cisco
IOS software.
Step 5 end Completes the download and exits SPE configuration mode.
Example:
Router(config-spe)# end
Note If the configuration is not saved as described in this step, download of the
firmware specified with the spe command will not occur after the next reboot.
• For detailed information on the spe command, see the following Cisco document:
"SPE and Firmware Download Enhancements".
Restrictions
• Voicecaps are configured in global configuration mode. A maximum of five voicecap entries can be
defined.
• Applying a voicecap is possible only in voice-port configuration mode. Once applied to a voice port,
the voicecap affects all calls associated with that voice port.
• To achieve the specified functionality, an SPE image capable of voice tuning must be used in conjunction
with the Cisco IOS software and module controller software.
• For backward compatibility, a voicecap used in raw mode will configure older SPEware to allow echo
canceller coverage settings greater than 64 ms when the older SPEware is used with newer releases of
Cisco IOS software. For situations when new SPEware is loaded onto an older Cisco IOS software
release, the NextPort dual-filter G.168 echo canceller automatically sets coverage time to 64 ms.
For a list of available voicecap parameters and code words that are used with the NextPort dual-filter G.168
echo canceller feature, see the "NextPort-Based Voice Tuning and Echo Cancellation Guide".
Note All data specified in dB is entered in the form (dB * 10). So, for example, to specify 6.0 dB, 60 must be
entered.
Note Too much attenuation may cause some calls to have low volume speech. For more information, see the
dynamic attenuation feature described in the "NextPort-Based Voice Tuning and Echo Cancellation Guide".
Note Use the Cisco IOS CLI, not voicecap indexes, to set PSTN gains.
Set IP Gains
To adjust IP-side levels that are applied to the signal before it is propagated through the echo canceller, use
IP gains. IP gains are controlled with the following V registers. The valid range for both input and output gain
is -14 dB to 14 dB.
• v261--IP output gain.
• v263--IP input gain.
Note There have been some instances where the IP-side power has been too high. Using index v263 can mitigate
this problem.
SUMMARY STEPS
1. enable
2. configure terminal
3. voicecap entry name string
4. voice-port slot / port :D
5. voicecap configure name
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 voice-port slot / port :D Enters voice-port configuration mode on the selected slot and port.
Example:
Router(config)# voice-port 3/0:D
Note To configure multiple voice ports, repeat Step 4 and Step 5 for
each voice port.
Step 6 exit Exits voice-port configuration mode and completes the configuration.
Example:
Router(config-voiceport)# exit
SUMMARY STEPS
DETAILED STEPS
Example:
Router# show voice port
ISDN 2/0:D - 2/0:D
Type of VoicePort is ISDN
Operation State is DORMANT
Administrative State is UP
No Interface Down Failure
Description is not set
.
.
.
Station name None, Station number None
Translation profile (Incoming):
Translation profile (Outgoing):
Voicecap:EXAMPLE
Example:
Router# show port operational-status 1/0
Slot/SPE/Port -- 1/0
Service Type :Voice service
Voice Codec :G.711 u-law
Echo Canceler Length :8 ms
Echo Cancellation Control :Echo cancellation - enabled
Echo update - enabled
Non-linear processor - enabled
Echo reset coefficients - disabled
High pass filter enable - disabled
Digit detection enable :DTMF signaling - enabled
Voice activity detection :Disabled
Comfort noise generation :Generate comfort noise
Digit relay enable :OOB Digit relay - disabled
IB Digit relay - disabled
Information field size :20 ms
Playout de-jitter mode :adaptive
Encapsulation protocol :RTP
Input Gain :0.0 dB
Output Gain :0.0 dB
Tx/Rx SSRC :20/0
Current playout delay :65 ms
Min/Max playout delay :65/105 ms
Clock offset :142003 ms
Predictive concealment :0 ms
Interpolative concealment :0 ms
Silence concealment :0 ms
Buffer overflow discards :1
End-point detection errors :0
Tx/Rx Voice packets :1337/1341
Tx/Rx signaling packets :0/0
Tx/Rx comfort noise packets :0/0
Tx/Rx duration :26745/26745 ms
Tx/Rx voice duration :0/0 ms
Out of sequence packets :0
Bad protocol headers :0
Num. of late packets :0
Num. of early packets :1
Tx/Rx Power :-87.0/-57.3 dBm
Tx/Rx Talker Level :-86.3/-57.0 dBm
TX/RX Mean Speech level :-86.3/-57.0 dBm
VAD Background noise level :6.2 dBm
ERL level :127.0 dB
ACOM level :127.0 dB
Tx/Rx current activity :silence/silence
Tx/Rx byte count :213920/214240
ECAN Background noise level :-83.4 dBm
Latest SSRC value :391643394
Number of SSRC changes :1
Number of payload violations :0
Example:
Router# show port voice log
Port 1/00 Events Log
*Aug 22 07:59:27.515:Voice Terminate event:
Disconnect Reason : normal call clearing (16)
Call Timer : 57 secs
Current playout delay : 65 ms
Min/Max playout delay : 65/105 ms
Clock offset : 142003 ms
Predictive concealment : 0 ms
Interpolative concealment : 0 ms
Silence concealment : 0 ms
Buffer overflow discards : 1
End-point detection errors : 0
Tx/Rx Voice packets : 2813/2816
Tx/Rx signaling packets : 0/0
Tx/Rx comfort noise packets : 0/0
Tx/Rx duration : 56260/56260 ms
Tx/Rx voice duration : 0/0 ms
Out of sequence packets : 0
Bad protocol headers : 0
Num. of late packets : 0
Num. of early packets : 1
Tx/Rx Power : -87.0/-57.3 dBm
Tx/Rx Mean Speech Level : -86.7/-57.0 dBm
Tx/Rx Talker Level : -86.3/-57.0 dBm
Average VAD Background noise level : 6.2 dBm
SUMMARY STEPS
DETAILED STEPS
Example:
Router# debug nextport vsmgr detail
NextPort Voice Service Manager:
NP Voice Service Manager Detail debugging is on
.
.
.
Example:
Router# debug dspapi detail
DSP API:
DSP API Command debugging is on
DSP API Detail debugging is on
.
.
.
Example:
Router# show debug
NextPort Voice Service Manager:
NP Voice Service Manager Detail debugging is on
DSP API:
DSP API Command debugging is on
DSP API Detail debugging is on
*Aug 22 08:34:47.399:dspapi [2/1:1 (4)] dsp_init
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-port slot / port :D
4. echo-cancel coverage {24 | 32 | 48 | 64 | 80 | 96 | 112 | 128}
5. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 echo-cancel coverage {24 | 32 | 48 | 64 | 80 | 96 | Adjusts the size of the echo canceller (EC) and selects the
112 | 128} extended EC when the Cisco default EC is present.
• Starting with Cisco IOS Release 12.4(20)T, the default
Example: coverage time and maximum possible coverage is 128 ms
Router(config-voiceport)# echo-cancel for both 8.x and 10.2.2 SPEware versions.
coverage 64
Router> enable
Router# configure terminal
Router(config)# voicecap entry qualityERL v270=120
Router(config)# end
Router> enable
Router# configure terminal
Router(config)# voice-port
3/0:D
Router(config-voiceport)# output attenuation 1
Router(config-voiceport)# input gain -1
Router(config-voiceport)# end
Router> enable
Router# configure terminal
Router(config)# voicecap entry qualityERL v270=120
Router(config)# voice-port 3/0:D
Router(config-voiceport)# voicecap configure qualityERL
Router(config-voiceport)# output attenuation 4
Router(config-voiceport)# input gain -4
Router(config-voiceport)# end
Router> enable
Router(config) voice-port 1
/0:0
Router(config-voiceport)# echo-cancel coverage 64
Enabling NextPort Echo Canceller Control for G.711 Encoded VoIP Packets
This section describes how to enable NextPort echo canceller control on the Cisco AS5350, AS5400,
AS5400HPX, and AS5850 universal gateways when these gateways detect 2100 Hz tones, received in G.711
encoded VoIP packets. You can enable NextPort voicecaps to control the echo canceller from either the PSTN
or IP side of the network.
Note NextPort control over the echo canceller is possible only in G.711 codec modes. Cisco recommends that
you do not enable NextPort control over the echo canceller in conjunction with modem pass-through.
IP tone detection and NextPort control over the echo canceller is enabled using the command-line interface.
Use the following commands to enable NextPort control over the echo canceller by creating a voicecap entry
and applying it to the voice port.
SUMMARY STEPS
1. enable
2. configure terminal
3. voicecap entry name string
4. voice-port slot / port
5. voicecap configure name
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 4 voice-port slot / port Enters voice-port configuration mode on the selected slot and port.
Example:
Router(config)# voice-port 3/0
Step 5 voicecap configure name Applies a voicecap entry to the voice port.
• The name argument designates which of the newly created voicecaps to
Example: use on this voice port. This character value must be identical to the value
Router(config-voiceport)# entered when you created the voicecap entry.
voicecap configure npecho_ctrl
Note To configure multiple voice ports, repeat Step 4 and Step 5 for each
voice port.
Step 6 exit Exits voice-port configuration mode.
Example:
Router(config-voiceport)# exit
Troubleshooting NextPort Echo Canceller Control for G.711 Encoded VoIP Packets
You can display the EST trace messages that show the tone detections and the resultant echo operations if
you enter the debug trace module f080 0010 s / d / m command. NextPort enables and disables the NLP and
the echo canceller based on reception of 2100 Hz answer tones from the IP side or PSTN side and generates
EST trace messages for each tone detected and its echo operation. NextPort also detects the 250 ms of silence
and generates EST trace messages to indicate such detection and to indicate that the echo state has been
restored.
When the default configuration values for Index 51 and Index 52 are used, IP tone detection and notification
are disabled, and all existing features continue to function normally.
The following example shows EST trace messages collected from the console:
Router#
*Apr 26 21:40:51.735: 00:00:14: Port Trace Event:
*Apr 26 21:40:51.735: Port : 3/00
*Apr 26 21:40:51.735: Address : 0x3000000
*Apr 26 21:40:51.735: Trace Event: 0x2
*Apr 26 21:40:51.735: Data Format: ASCII
*Apr 26 21:40:51.735: Data Len : 56
*Apr 26 21:40:51.735: Data : Session 0x0144 Received Early ANS tone 0x01 from
IP side
*Apr 26 21:40:51.735: 00:00:14: Port Trace Event:
*Apr 26 21:40:51.735: Port : 3/00
*Apr 26 21:40:51.735:
Router# Address : 0x3000000
*Apr 26 21:40:51.735: Trace Event: 0x2
*Apr 26 21:40:51.735: Data Format: ASCII
*Apr 26 21:40:51.735: Data Len : 63
*Apr 26 21:40:51.735: Data : Session 0x0144 Received Tone Off ntf for code 0x01
from IP side
*Apr 26 21:40:51.735: 00:00:14: Port Trace Event:
*Apr 26 21:40:51.735: Port : 3/00
*Apr 26 21:40:51.735: Address : 0x3000000
*Apr 26 21:40:51.735: Trace Event: 0x2
*Apr 26 21:40:51.735: Data Format: ASCII
Router#*Apr 26 21:40:51.735: Data Len : 45
*Apr 26 21:40:51.735: Data : Session 0x0144 Received ANS tone 0x03 from IP
*Apr 26 21:40:51.735: 00:00:14: Port Trace Event:
*Apr 26 21:40:51.735: Port : 3/00
*Apr 26 21:40:51.735: Address : 0x3000000
*Apr 26 21:40:51.735: Trace Event: 0x2
*Apr 26 21:40:51.735: Data Format: ASCII
*Apr 26 21:40:51.735: Data Len : 47
*Apr 26 21:40:51.735: Data : Session 0x0144 Non-linear Processor Is Disabled
*Apr
Router# 26 21:40:51.735: 00:00:14: Port Trace Event:
*Apr 26 21:40:51.735: Port : 3/00
*Apr 26 21:40:51.735: Address : 0x3000000
*Apr 26 21:40:51.735: Trace Event: 0x2
*Apr 26 21:40:51.735: Data Format: ASCII
*Apr 26 21:40:51.735: Data Len : 63
*Apr 26 21:40:51.735: Data : Session 0x0144 Received Tone Off ntf for code 0x03
from IP side
*Apr 26 21:40:51.735: 00:00:14: Port Trace Event:
SUMMARY STEPS
DETAILED STEPS
Cisco 2600 series Cisco 3600 series Analog show voice port [slot / port |
Cisco 3700 series summary]
Cisco AS5350 Cisco AS5400 Cisco Digital show voice port [slot/controller
AS5850 :{ds0-group-number | D}] [summary]
Example:
Router# show running-config
.
.
.
hostname router-alpha
voice-card 0
codec complexity high
.
.
.
Example:
Router# show controller
{t1
| e1
}
controller-number
Example:
Router# show voice dsp
Example:
Router# show voice call summary
Example:
Router# show call active voice
Example:
Router# show call history voice
[last
| number
| brief
Examples
This section contains output examples for the following commands on different platforms and for different
configurations:
1/0
E&M Slot is 1, Sub-unit is 0, Port is 0
Type of VoicePort is E&M
Operation State is unknown
Administrative State is unknown
The Interface Down Failure Cause is 0
Alias is NULL
Noise Regeneration is disabled
Non Linear Processing is disabled
Music On Hold Threshold is Set to 0 dBm
In Gain is Set to 0 dB
Out Attenuation is Set to 0 dB
Echo Cancellation is disabled
Echo Cancel Coverage is set to 16ms
Connection Mode is Normal
Connection Number is
Initial Time Out is set to 0 s
Interdigit Time Out is set to 0 s
Analog Info Follows:
Region Tone is set for northamerica
Currently processing none
Maintenance Mode Set to None (not in mtc mode)
Number of signaling protocol errors are 0
RemoteUDPPort=16580
RoundTripDelay=29 ms
SelectedQoS=best-effort
tx_DtmfRelay=inband-voice
SessionProtocol=cisco
SessionTarget=ipv4:172.16.235.18
OnTimeRvPlayout=63690
GapFillWithSilence=0 ms
GapFillWithPrediction=180 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=70 ms
LoWaterPlayoutDelay=30 ms
ReceiveDelay=40 ms
LostPackets=0 ms
EarlyPackets=1 ms
LatePackets=18 ms
VAD = disabled
CoderTypeRate=g729r8
CodecBytes=20
cvVoIPCallHistoryIcpif=0
SignalingType=cas
VAD = disabled
CoderTypeRate=g729r8
CodecBytes=20
cvVoIPCallHistoryIcpif=0
Troubleshooting Chart
The table below lists some problems that you might encounter after configuring voice ports. It also provides
some suggested remedies.
No connectivity Enter the show voice port command with the voice
port number that you are troubleshooting, which will
tell you:
• If the voice port is up. If it is not, use the no
shutdown command to make it active.
• What parameter values have been set for the
voice port, including default values (these do
not appear in the output for the show
running-config command). If these values do
not match those of the telephony connection
you are making, reconfigure the voice port.
Telephony device buzzes or does not ring Use the show voice port command to confirm that
the ring frequency command is configured correctly.
It must match the connected telephony equipment
and may be country-dependent.
Distorted speech Use the show voice port command to confirm the
cptone keyword setting (also called region tone) is
US.
Setting a wrong cptone could result in faulty voice
reproduction during analog-to-digital or
digital-to-analog conversions.
Music on hold is not heard Reduce the configured level for the music-threshold
command.
Long pauses occur in conversation; like speaking on Overall delay is probably excessive; the standard for
a walkie-talkie adequate voice quality is 150 milliseconds (ms)
one-way transit delay. Measure delay by using ping
tests at various times of the day with different network
traffic loads. If delay must be reduced, areas to
examine include propagation delay of signals between
the sending and receiving endpoints, voice encoding
delay, and the voice packetization time for various
VoIP codecs.
Clipped speech Reduce the input level at the listener’s router. (Refer
to the Cisco IOS Voice Troubleshooting and
Monitoring Guide.)
Volume too low or missed Dual-Tone Multifrequency Increase speaker’s output level or listener’s input level.
(DTMF) (Refer to the Cisco IOS Voice Troubleshooting and
Monitoring Guide.)
Echo interval is greater than 25 ms (sounds like a Configure the echo-cancel enable command and
separate voice) increase the value for the echo-cancel coverage
keyword. (See the "Configuring Echo Cancellation"
section.)
Note For information on test commands that force voice ports into specific states for testing refer to the Cisco
IOS Voice Troubleshooting and Monitoring Guide.
A D
auto-cut-through command 60 define command 61
dial-type command 13
disconnect-ack command 65
ds0-group command 19, 45
B DSC (dial shelf controller) 25
battery reversal command 65 digital voice port clock source 25
dspint dspfarm command 36
C
E
cadence-list command 67
cadence-min-on-time command 67 E1 23
cadence-variation command 67 digital packet voice trunk network module 23
calling-number outbound command 63
calling-number outbound sequence command 63
card type command 45 F
Cisco 7200 series routers 24
digital voice port adapters 24 framing command 45
Cisco 7600 series routers 26 freq-max-delay command 67
Communication Media Modules 26 freq-max-deviation command 67
Cisco AS5300 access servers 24, 36, 63 freq-max-power command 67
codec support 36 freq-min-power command 67
FGD-EANA signaling 63 freq-pair command 67
voice/fax feature card 24 freq-power-twist command 67
Cisco MC3810 concentrators 27 FXO (foreign exchange office) 65, 67
digital voice interface card 27 Disconnect Supervision feature 65
clock source command 45 supervisory disconnect tone 67
codec complexity command 17, 28
comfort-noise command 77
compand-type command 50
condition command 61
I
connections 1, 55, 60 ignore command 61
PBX to WAN 1
PBX without M-lead response 55, 60
voice port to PSTN 1
voice port to WAN 1 L
cptone command 13, 50 linecode command 45
S V
show call active voice command 175, 184 voice class dualtone command 67
(examples) 184 voice ports 1, 9, 12, 13, 19, 20, 28, 33, 38, 45, 50, 55, 61, 71, 72, 77, 175,
187
show call history voice command 175, 185
(examples) 185 analog 9, 12, 13, 28, 33, 55, 175, 187
show controller command 175, 182 codec complexity, configuring 13, 28, 33
(examples) 182 configuring 9, 12
show voice call summary command 175, 184 fine tuning 55
(examples) 184 troubleshooting 187
show voice dsp command 17, 28, 175, 183 verifying configuration 175
show voice port command 179 analog and digital transmission support (table) 1
(examples) 179 basic parameters 13, 28
show voice port summary command 20, 175, 178 configuring 13
(examples) 178 configuration mode 50
signal command 13 configuration overview 1
signaling techniques 4 digital 19, 20, 55, 61, 77
ground start 4 bit modifications 61
loop-start 4 configuring 19, 77
supervisory disconnect anytone command 67 fine tuning 55
supervisory disconnect dualtone command 67 requirements 20
DS0 groups on digital T1/E1 45
E1 configuration 38
T1 configuration 38
T timeouts, configuring 71
timing parameters 72
T1 38 voice activity detection 77
voice port configuration 38 voice-card command 17, 28
timeouts call-disconnect command 71 voice-port command 13, 50
timeouts initial command 71