-
Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator's Guide (H.323)(2.15)
-
Index
-
Preface
-
Cisco Analog Telephone Adaptor Overview
-
Installing the Cisco ATA
-
Configuring the Cisco ATA for H.323
-
Basic and Additional H.323 Services
-
Parameters and Defaults
-
Call Commands
-
Configuring and Debugging Fax Services
-
Upgrading the Cisco ATA Signaling Image
-
Troubleshooting
-
Using H.323 Supplementary Services
-
Voice Menu Codes
-
Cisco ATA Specifications
-
H.323 Signaling
-
Glossary
-
Feedback
Table Of Contents
Configuration Text File Template
Configuration-Complete Parameter
Parameters for Configuration Method and Encryption
Account Information Parameters
'H' Rule to Support Hotline/Warmline
'P' Rule to Support Dial Prefix
List of Call-Progress Tone Parameters
How to Calculate Scaling Factors
Specific Call-Progress Tone Parameter Information
Parameters and Defaults
This section provides information on the parameters and defaults that you can use to create your own Cisco ATA configuration file. This section also includes the voice configuration menu code for each parameter that has such a code.
Some parameters on the Web Configuration screen are not used for H.323; only those used for H.323 are covered in this section.
Parameters are divided into categories based on their functionality. The following categories of parameters are covered in this section:
•
User Interface (UI) Parameter
•
•
•
The following list contains general configuration information:
•
•
–
–
–
–
–
–
–
–
Note
Note
Configuration Text File Template
This is a listing of the example_uprofile.txt text file, without its annotations, that comes bundled with the Cisco ATA software.
You can make a copy of this file and use it as a template for creating your own default configuration file or Cisco ATA-specific configuration file. For instructions on how to create these configuration files, see the "Creating Unique and Common Cisco ATA Configuration Files" section.
The example_uprofile.txt file contains all the Cisco ATA default values. The sections that follow this listing describe all the parameters in this file.
#txtUIPassword:0UseTftp:1TftpURL:0cfgInterval:3600EncryptKey:0ToConfig:0upgradecode:0,0x301,0x0400,0x0200,0.0.0.0,69,0,noneupgradelang:0,0x301,0x0400,0x0200,0.0.0.0,69,0,noneDhcp:1StaticIp:0StaticRoute:0StaticNetMask:0GkOrProxy:0AltGk:0AltGkTimeOut:0GkTimeToLive:300GateWay:0GateWay2:0.0.0.0UseLoginID:0UID0:0UID1:0PWD0:0PWD1:0LoginID0:0LoginID1:0GkId:.RxCodec:1TxCodec:1LBRCodec:0AudioMode:0x00150015NumTxFrames:2CallWaitCallerId:0x003c33d0Polarity: 0ConnectMode:0x00060000AutMethod:0TimeZone:17NTPIP:0AltNTPIP:0DNS1IP:0.0.0.0DNS2IP:0.0.0.0UDPTOS:0xA0RingOnOffTime:2,4,25DialTone:2,31538,30831,1380,1740,1,0,0,1500BusyTone:2,30467,28959,1191,1513,0,4000,4000,0ReorderTone:2,30467,28959,1191,1513,0,2000,2000,0RingBackTone:2,30831,30467,1943,2111,0,16000,32000,0CallWaitTone:1,30831,0,5493,0,0,2400,2400,4800AlertTone:1,30467,0,5970,0,0,480,480,1920DialPlan:*St4-|#St4-|911|1>#t8.r9t2-|0>#t811.rat4-|^1t4>#.-IPDialPlan: 1CallCmd:Af;AH;BS;NA;CS;NA;Df;EB;Ff;EP;Kf;EFh;HQ;Jf;AFh;HQ;I*67;gA*82;fA#90v#;OI;H#72v#;bA# 74v#;cA#75v#;dA#73;eA*67;gA*82;fA*70;iA*69;DA*99;xA;Uh;GQ;SIPPort:5060SIPRegOn:0SIPRegInterval:120MaxRedirect:5OutBoundProxy:0NatServer:0NatTimer:0NPrintf:0TraceFlags:0x00000000EchoIP:192.168.2.9SigTimer:0x01418564OpFlags:0x2VLANSetting:0x0000002bFeatureTimer:0x00000000The sections that follow describe these parameters.
User Interface (UI) Parameter
This section contains only one parameter—UIPassword.
UIPassword
Description
This parameter controls access to web page or voice configuration menu interface. To set a password, enter a value other than zero. To have the user prompted for this password when attempting to perform a factory reset or upgrade using the voice configuration menu, see the "OpFlags" section.
To clear a password, change the value to 0.
You cannot recover a forgotten password unless you reset the entire configuration of the Cisco ATA (see the "Resetting the Cisco ATA to Factory Default Values" section). If you forget a password, you can contact your Cisco representative.
Note
Value Type
Alphanumeric string
Range
Maximum nine characters
Default
0
Voice Configuration Menu Access Code
7387277
Related Parameters
OpFlags—Bit 7
Configuration-Complete Parameter
This section contains only one parameter—ToConfig.
ToConfig
Description
After you configure the Cisco ATA, set the parameter to 0, or the Cisco ATA will unnecessarily contact the TFTP server.
Value Type
Boolean
Range
0 or 1
Default
1—This indicates that the operating parameters have not previously been set.
Voice Configuration Menu Access Code
80001
Parameters for Configuration Method and Encryption
This section describes parameters for instructing the Cisco ATA about how to locate its TFTP server and how to encrypt its configuration file:
UseTFTP
Settings
1—Use the TFTP server for Cisco ATA configuration.
0—Do not use the TFTP server for Cisco ATA configuration.
Value Type
Boolean
Range
0 or 1
Default
1
Voice Configuration Menu Access Code
305
Related Parameters
•
TftpURL
Description
Use this parameter to specify the IP address or URL of the TFTP server. This string is needed if the DHCP server does not provide the TFTP server IP address. When the TftpURL parameter is set to a non-zero value, this parameter has priority over the TFTP server IP address supplied by the DHCP server.
Optionally, you can include the path prefix to the TFTP file to download.
For example, if the TFTP server IP address is 192.168.2.170 or www.cisco.com, and the path to download the TFTP file is in /ata186, you can specify the URL as 192.168.2.170/ata186 or www.cisco.com/ata186.
Note
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
905
Related Parameters
CfgInterval
Description
Use this parameter to specify the number of seconds between each configuration update. The Cisco ATA will also upgrade its signaling image if it detects that the TFTP server contains an upgraded image.
For example, when using TFTP for configuration, the Cisco ATA contacts TFTP each time the interval expires to get its configuration file.
You can set CfgInterval to a random value to achieve random contact intervals from the Cisco ATA to the TFTP server.
Value Type
Decimal
Range
60 to 4294967295
Default
3600
Voice Configuration Menu Access Code
80002
Related Parameters
EncryptKey
Description
This parameter specifies the encryption key that is used to encrypt the Cisco ATA configuration file on the TFTP server.
The cfgfmt tool, which is used to create a Cisco ATA binary configuration file (see the "Using the EncryptKey Parameter and cfgfmt Tool" section), automatically encrypts the binary file, using the rc4 encryption algorithm, when the EncryptKey parameter has a value other than 0.
Note
Value Type
Alphanumeric string
Range
Maximum number of characters: 8
Default
0
Voice Configuration Menu Access Code
320
Related Parameters
Network Parameters
This section describes the parameter for enabling or disabling the use of a DHCP server to obtain IP address information, and parameters that you need to statically configure if you disable DHCP:
•
DHCP
Description
A DHCP server can be used to automatically set the Cisco ATA IP address, the network route IP address, the subnet mask, DNS, NTP, TFTP, and other parameters.
•
•
Value Type
Boolean
Range
0 or 1
Default
1
Voice Configuration Menu Access Code
20
Related Parameters
•
StaticIp
Description
Use this parameter to statically assign the Cisco ATA IP address if the DHCP parameter is set to 0.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
1
Related Parameters
•
StaticRoute
Description
Use this parameter to statically assign the Cisco ATA route if the DHCP parameter is set to 0.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
2
Related Parameters
•
StaticNetMask
Description
Use this parameter to statically assign the Cisco ATA subnet mask if the DHCP parameter is set to 0
Value Type
IP address
Default
255.255.255.0
Voice Configuration Menu Access Code
10
Related Parameters
•
Account Information Parameters
This section describes the following identification parameters:
•
•
•
•
UID0
Description
This parameter is the User ID (E.164 phone number) for the Phone 1 port. If the value is set to zero, the port will be disabled and no dial tone will sound.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
3
Related Parameters
•
•
•
PWD0
Description
This parameter is the password for the Phone 1 port.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
4
Related Parameters
•
•
•
UID1
Description
This parameter is the User ID (E.164 phone number) for the Phone 2 port. If the value is set to zero, the port will be disabled and no dial tone will sound.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
13
Related Parameters
•
•
•
PWD1
Description
This parameter is the password for the Phone 2 port.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
14
Related Parameters
•
•
•
Gateway
Description
Use this parameter to specify the H.323 gateway IP address if the network does not contain an H.323 gatekeeper. In this scenario, all calls originating from the Cisco ATA will be directed to the gateway specified in this parameter.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
11
UseLoginID
Description
0—Use UID0 and UID1 as the authentication ID.
1—Use LoginID0 and LoginID1 as the authentication ID.
Value Type
Boolean
Range
0 or 1
Default
0
Voice Configuration Menu Access Code
93
LoginID0
Description
This parameter is the H.323 login ID for the Phone 1 port of the Cisco ATA.
This value is used for registration and authentication if the UseLoginID parameter is set to 1.
If the LoginID0 and LoginID1 parameter values are identical, only one gatekeeper registration is performed for both ports, in which case the LoginID0 value is used as the H.323 ID, and the UID0 and UID1 parameter values are used for the two E.164 phone numbers.
Value Type
Alphanumeric string
Range
Maximum number of characters: 51
Default
0
Voice Configuration Menu Access Code
46
Related Parameters
•
•
LoginID1
Description
This parameter is the H.323 login ID for the Phone 2 port of the Cisco ATA.
This value is used for registration and authentication if the UseLoginID parameter is set to 1.
If the LoginID0 and LoginID1 parameter values are identical, only one gatekeeper registration is performed for both ports, in which case the LoginID0 value is used as the H.323 ID, and the UID0 and UID1 parameter values are used for the two E.164 phone numbers.
Value Type
Alphanumeric string
Range
Maximum number of characters: 51
Default
0
Voice Configuration Menu Access Code
47
Related Parameters
•
•
AutMethod
Description
Use this parameter to select the desired authentication method, with the following possible values:
•
•
•
Value Type
Bitmap
Default
0x00000000
Voice Configuration Menu Access Code
92
Related Parameters
•
•
Gatekeeper Parameters
This section describes the following parameters that are related to H.323 gatekeeper configuration:
•
GkOrProxy
Description
This parameter is the IP address of the primary H.323 gatekeeper.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0—Disables gatekeeper-routed calls.
Voice Configuration Menu Access Code
5
Related Parameters
•
AltGk
Description
You have the option of using this parameter to statically specify the IP address of an alternate H.323 gatekeeper.
Value Type
Alphanumeric string
Range
Maximum number of characters: 31
Default
0
Voice Configuration Menu Access Code
6
Related Parameter
AltGkTimeOut
Description
You can use this parameter to specify the timeout in seconds before the Cisco ATA fails back to the primary gatekeeper from the backup gatekeeper. When the Cisco ATA switches to a different H.323 gatekeeper, the setting of Bit 3 of the ConnectMode parameter (see the "ConnectMode" section) determines whether the Cisco ATA re-registers with the H.323 gatekeeper.
Value Type
Integer
Default
0—The Cisco ATA continues to use the backup gatekeeper until it fails before attempting to fail back to the primary gatekeeper.
Range
30 to 4294967295 seconds
Voice Configuration Menu Access Code
251
Related Parameters
•
GkTimeToLive
Description
This parameter specifies the "time to live" value that is used when the Cisco ATA registers with the H.323 gatekeeper. The registration is valid until the configured time expires.
Value Type
Integer
Default
0
Range
30 to 4294967295 seconds
Voice Configuration Menu Access Code
250
GkId
Description
This parameter is the identifier for the primary H.323 gatekeeper.
Value Type
Alphanumeric string
Default
. (not specified)
Range
Maximum 31 characters
Voice Configuration Menu Access Code
91
H.323 Mode Parameter
This section describes the UseSIP parameter, which is used to set the Cisco ATA to H.323 mode if you are using the H.323 signaling protocol.
UseSIP
Description
0—Use H.323 mode.
1—Use SIP mode.
Value Type
Boolean
Range
0 or 1
Default
0
Voice Configuration Menu Access Code
38
Operating Parameters
The parameters for configuring codecs, fax features and VLAN settings are included in this section:
MediaPort
Description
Use this parameter to specify the base port where the Cisco ATA transmits and receives RTP media. This parameter must be an even number. Each connection uses the next available even-numbered port for RTP.
Value Type
Integer
Range
1 to 65535
Default
16384
Voice Configuration Menu Access Code
202
Related Parameters
LBRCodec
Description
This parameter allows you to specify which low-bit-rate codecs are available. The Cisco ATA is capable of supporting two G.723.1 connections or one G.729 connection. When G.723.1 is selected as the low-bit-rate codec, each FXS port is allocated with one G.723.1 connection. When G.729 is selected, only one FXS port is capable of operating with the G.729 codec. The allocation of the G.729 resource to the FXS port is dynamic. The G.729 resource, if available, is allocated to an FXS port when a call is initiated or received; the resource is released when a call is completed.
The following values are valid:
•
•
Related Parameters
Value Type
Integer
Range
0 or 3
Default
0
Voice Configuration Menu Access Code
300
Related Parameters
•
AudioMode
Description
This parameter represents the audio operating mode. The lower 16 bits are for the Phone 1 port, and the upper 16 bits are for the Phone 2 port. Table 5-1 provides definitions for each bit.
Value Type
Bitmap
Default
0x00150015
Voice Configuration Menu Access Code
312
Related Parameters
RxCodec
Description
Use this parameter to specify receiving-audio codec preference. The following values are valid:
•
•
•
•
Value Type
Integer
Range
0-3
Default
2
Voice Configuration Menu Access Code
36
Related Parameters
TxCodec
Description
Use this parameter to specify the transmitting-audio codec preference. The following values are valid:
•
•
•
•
Value Type
Integer
Range
0-3
Default
2
Voice Configuration Menu Access Code
37
Related Parameters
NumTxFrames
Description
Use this parameter to select the number of frames per packet that the Cisco ATA transmits:
•
•
Note
Examples
•
•
Note
Value Type
Integer
Range
1-6
Default
2
Voice Configuration Menu Access Code
35
Related Parameters
CallFeatures
Description
Disable/enable CallFeatures by setting each corresponding bit to 0 or 1.
The lower 16 bits are for the Phone 1 port, and the upper 16 bits are for the Phone 2 port. Table 5-2 provides definitions of each bit.
Note
Value Type
Bitmap
Default
0xffffffff
Voice Configuration Menu Access Code
314
Related Parameters
PaidFeatures
Description
Unsubscribe/subscribe to CallFeatures by setting each corresponding bit to either 0 or 1. The lower 16 bits are for the Phone 1 port, and the upper 16 bits are for the Phone 2 port. Table 5-3 provides definitions of each bit.
Value Type
Bitmap
Default
0xffffffff
Voice Configuration Menu Access Code
315
Related Parameters
CallerIdMethod
Description
This 32-bit parameter specifies the signal format to use for both FXS ports for generating Caller ID format. Possible values are:
•
If method=0, set the following bits:
•
•
•
•
•
•
If method=1, set the following bits:
•
•
•
•
•
•
•
•
•
Examples
The following examples are recommended values for the CallerID Method parameter:
•
•
•
Value Type
Bitmap
Default
0x00019e60
Voice Configuration Menu Access Code
316
Polarity
Description
You can control line polarity of the Cisco ATA FXS ports when a call is connected or disconnected by configuring the Polarity bitmap parameter as follows:
•
–
–
•
–
–
•
–
–
•
–
–
Note
Value Type
Bitmap
Default
0x00000000
Voice Configuration Menu Access Code
304
ConnectMode
Description
This parameter is a 32-bit bitmap used to control the connection mode of the selected call signaling protocol. Table 5-4 provides bit definitions for this parameter.
Value Type
Bitmap
Default
0x00060400
Voice Configuration Menu Access Code
311
TimeZone
Description
This parameter is the timezone offset from Greenwich Mean Time (GMT) for time-stamping incoming calls with local time (to use for Caller ID display, for example).
Local time is generated by the following formula:
•
•
Value Type
Integer
Range
0-24
Default
17
Voice Configuration Menu Access Code
302
Related Parameters
NTPIP
Description
This parameter is the NTP IP address, required if DHCP server does not provide one.
The Cisco ATA requires an NTP Server from which to obtain Coordinated Universal Time (UTC) to time-stamp incoming calls (H.323 and SIP) to drive an external Caller-ID device.
DHCP may also supply a NTP server. If NTPIP is specified, it overwrites the value supplied by DHCP. NTPIP is ignored if its value is 0 or 0.0.0.0.
The user must not specify a port parameter. The Cisco ATA uses the default NTP port only.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
141
Related Parameters
AltNTPIP
Description
This parameter is the alternate NTP IP address, if you want redundancy. You can set this parameter to 0 or point to the same NTPIP if only one NTP server exists.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
142
Related Parameters
DNS1IP
Description
This parameter is the primary domain name server (DNS) IP address, if the DHCP server does not provide one. If DHCP provides DNS, DNS1IP and DNS2IP (if they are non-zero) overwrite the DHCP-supplied values. The user must not specify a port parameter. The Cisco ATA uses the default DNS port only.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
916
DNS2IP
Description
This parameter is the secondary domain name server (DNS) IP address, if the DHCP server does not provide one. If DHCP provides DNS, DNS1IP and DNS2IP (if they are non-zero) overwrite the DHCP-supplied values. The user must not specify a port parameter. The Cisco ATA uses the default DNS port only.
Value Type
IP address
Default
0.0.0.0
Voice Configuration Menu Access Code
917
UDPTOS
Description
This parameter specifies the IP precedence (ToS bit) of UDP packets. Set the lower eight bits only, as follows:
•
•
•
•
•
Value Type
Bitmap
Default
0xB8
Voice Configuration Menu Access Code
255
SigTimer
Description
This parameter controls various timeout values. Table 5-5 contains bit definitions of this parameter.
Value Type
Bitmap
Default
0x01418564
Voice Configuration Menu Access Code
318
OpFlags
Description
This parameter enables/disables various operational features.
See Table 5-6 for bit definitions of this parameter.
Value Type
Bitmap
Default
0x2
Voice Configuration Menu Access Code
323
Related Parameters
•
Table 5-6 OpFlags Parameter Operational Features to Turn On or Off
0
If Bit 0 = 0, the TFTP configuration filename supplied by the DHCP server overwrites the default filename for each Cisco ATA.
If Bit 0 = 1, the default Cisco ATA filename is always used.
1
If Bit 1 = 0, the Cisco ATA probes the static network router during the power-up process.
If Bit 1 = 1, static network router probing is disabled.
2
Reserved.
3
If Bit 3=1, the Cisco ATA does not request DHCP option 150 in the DHCP discovery message; some DHCP server do not respond if option 150 is requested.
4
If Bit 4 = 1, the Cisco ATA use the VLAN ID specified in the VLANSetting parameter for VLAN IP encapsulation (see the "VLANSetting" section).
5
If Bit 5=1, the Cisco ATA does not use VLAN IP encapsulation.
6
If Bit 6=1, the Cisco ATA does not perform CDP discovery.
7
If Bit 7=1, the Cisco ATA does not allow web configuration. Once the web server is disabled, you must configure the Cisco ATA with the TFTP or voice configuration menu methods.
Examples
1.
If you later attempt to access the Cisco ATA web configuration page, the following error messages will be displayed.
–
–
2.
8
If Bit 8=1, the Cisco ATA does not allow HTTP refresh access with the http://ip/refresh command.
9
If Bit 9=1, the Cisco ATA does not allow HTTP reset access with the http://ip/reset command.
10
Reserved.
11
If Bit 11=0, the Cisco ATA requests the device hostname from the DHCP server.
If Bit 11=1, the Cisco ATA uses the device hostname that is specified in DHCP option 12.
12-13
Reserved.
14-27
Reserved.
28-31
To configure the Cisco ATA to prompt the user for the UIPassword when the user attempts to perform a factory reset or upgrade using the voice configuration menu, configure bits 28 to 31 with the value of 6. Any other value for these bits means that the Cisco ATA will not prompt the user for the UIPassword in these cases.
VLANSetting
Description
This parameter is for firmware version 2.15 and 2.14ms, and above.
Bitmap definitions are as follows for the VLANSetting parameter:
•
•
•
•
•
Value Type
Bitmap
Default
0x0000002b
Voice Configuration Menu Access Code
324
Related Parameter
Optional Feature Parameters
This section includes the parameters used to configure various timeout values and call-progress tones:
•
NPrintf
Description
Use this parameter to specify the IP address and port of a host to which all Cisco ATA debug messages are sent. The program prserv.exe, which comes bundled with the Cisco ATA software, is needed to capture the debug information.
Syntax
<HOST_IP>,<HOST_PORT>
Example
If the program prserv.exe is running on a host with IP address 192.168.2.170 and listening port 9001, set NPrintf to 192.168.2.170.9001. This causes the Cisco ATA to send all debug traces to that IP address.
Value Type
Extended IP address
Default
0
Voice Configuration Menu Access Code
81
RingOnOffTime
Description
This parameter specifies the ringer cadence pattern, expressed as a triplet of integers "a,b, and c".
•
•
•
Value Type
List of three integer values, separated by commas
Range
1-65535
Default
2, 4, 25
Recommended Values:
•
•
Voice Configuration Menu Access Code
929
IPDialPlan
Description
This parameter allows for detection of IP-like destination address in DialPlan. Three values are valid:
•
•
•
All other values are currently undefined.
Value Type
Integer
Range
0, 1 or 2
Default
1
Voice Configuration Menu Access Code
310
DialPlan
Description
The programmable dial plan is designed for the service provider to customize the behavior of the Cisco ATA for collecting and sending dialed digits. The dial plan allows the Cisco ATA user to specify the events that trigger the sending of dialed digits. These events include the following:
•
•
•
•
Value Type
Alphanumeric string
Range
Maximum number of characters is 199.
Default
*St4-|#St4-|911|1>#t8.r9t2-|0>#t811.rat4-|^1t4>#.-
Voice Configuration Menu Access Code
926
Additional DialPlan Information
The DialPlan section contains the following additional topics that describe commands and rules for creating your own dial plan:
•
•
About Dial Plan Commands
The following list contains rules for Cisco ATA dial plans:
•
•
•
•
•
Note
•
•
•
Note
Note
Dial Plan Example 1 (Default Dial Plan)
The following dial plan:
*St4-|#St4-|911|1>#t8.r9t2-|0>#t811.rat4-|^1t4>#.-consists of the following rules:
•
•
•
•
•
•
Dial Plan Example 2
The following dial plans:
.t7>#......t4-|911|1t7>#..........t1-|0t4>#.t7-or.t7>#r6t4-|911|1t7>#.r9t1-|0t4>#.t7-consist of the following rules:
•
•
•
•
Dial Plan Blocking (In Rule)
Dial plan blocking can be used to reduce the occurrences of invalid dialed digits being sent and can prevent the dialed string of a specified pattern from being sent. By adding dial plan blocking, dialed digits are discarded after the interdigit timer expires unless one of the specified matching rules is met.
In addition, the default nine-second global interdigit timeout value is also modified with the value specified in the dial plan blocking command:
In
where n specifies the global interdigit timeout and the valid values are 1-9 and a-z (10-35).
For example, to enter an interdigit timeout of 12 seconds and discard dialed digits unless 911 is entered, you would use the following command:
Ic| 911
Specifying your own interdigit timeout also changes the behavior of the dial plan so that the entire dial string, rather than being sent at timeout, is sent only as a result of a matching rule or time intended by a matching rule.
'H' Rule to Support Hotline/Warmline
Hotline/Warmline, also known as Private Line Automatic Ringdown (PLAR), is a line used for priority telephone service. If the Hotline feature is configured, the Cisco ATA immediately dials a pre-configured number as soon as the handset goes off hook. If the Warmline feature is configured, the Cisco ATA dials a pre-configured number if no digits were entered before the specified timer value expired when the handset went off hook.
Syntax
Hdnnnn
where d is a delay-in-seconds parameter 0-9,a-z (to support 0 to 35 seconds delay), and nnnn is the variable-length phone number to call when no digits are entered for d seconds after the handset goes off hook.
•
•
'P' Rule to Support Dial Prefix
This rule is for automatic pre-pending the dial string as entered by the user with a specified prefix.
Syntax
Ptnnnn
where t is a single leading trigger character; if t is the first entered digit when making a new call, it triggers the prepending of a variable-length prefix (as specified by nnnn) in the dial string. The t character can take one of the following values:
0-9,*,#, 'n' (= any of 1-9), 'N' (any of 'n' and 0), 'a' (any of 'n',* and #), or 'A' (any of 'a' and 0);
Example:
Pn12345: Prepends 12345 to the dial string when the first entered digit is any of 1-9. The triggered digit is not removed from the dial string.
Call-Progress Tone Parameters
This section contains the following topics:
•
•
•
List of Call-Progress Tone Parameters
The following list contains the names of the call-progress tone parameters:
•
•
•
•
•
•
Tone Parameter Syntax
Each tone is specified by nine integers, as follows:
ntone, freq0, freq1, level0, level1, steady, on-time, off-time, total-tone-time
•
•
Note
•
•
•
•
•
•
•
For the other tones, the value is the number of samples at 8000 samples/second, where the following information applies:
–
–
–
–
The scaling factor A determines the volume level of the tone. To calculate scaling factors, see the "How to Calculate Scaling Factors" section.
Note
How to Calculate Scaling Factors
Use the following formula to calculate the scaling factor A:
A=0.5 * 10^((k+10-(n-1)*3)/20)
In this formula, k is the desirable volume in dBm; n is the number of frequency components. The ^ symbol means to the order of.
Example
If a one-frequency component of -20 dBm volume level is desirable, then:
A=0.5 * 10^((-20+10)/20) = 0.16
Recommended Values
The following settings are recommended for the US:
•
•
•
•
•
•
The following settings are recommended for Sweden:
•
•
•
•
•
•
Specific Call-Progress Tone Parameter Information
Brief descriptions, and lists of default values and the voice configuration menu code for each Cisco ATA tone parameter, are described in the following sections:
DialTone
Description
The Cisco ATA plays the dial tone when it is ready to accept the first digit of a remote address to make an outgoing call.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
920
BusyTone
Description
The Cisco ATA plays the busy tone when the callee is busy.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
921
ReorderTone
Description
The Cisco ATA plays the reorder tone (also known as congestion tone) if the outgoing call failed for reasons other than busy.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
922
RingbackTone
Description
The Cisco ATA plays the ring-back tone when the callee is being alerted by the called device.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
923
CallWaitTone
Description
The Cisco ATA plays the call-waiting tone when an incoming call arrives while the user is connected to another party.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
924
AlertTone
Description
The Cisco ATA plays the alert tone to prompt the user to enter a phone number when invoking a supplementary service, such as call-forwarding, or blind transfer.
Default values for the nine-integer array
•
•
•
•
•
•
•
•
•
Voice Configuration Menu Access Code
925
CallCmd
Description
Command table that controls call commands such as turning on/off caller ID.
For detailed information on the CallCmd parameter, see "Call Commands."
Value Type
Alphanumeric string
Range
Maximum of 248 characters
Default
•
CallCmd:Af;AH;BS;NA;CS;NA;Df;EB;Ff;EP;Kf;EFh;HQ;Jf;AFh;HQ;I*67;gA*82;fA#90v#;OI;H#72v#;bA#74v#;cA#75v#;dA#73;eA*67;gA*82;fA*70;iA*69;DA*99;xA;Uh;GQ;
•
CallCmd:BS;NA;CS;NA;Df;EB;Ff0;ARf1;HPf2;EPf3;AP;Kf1;HFf2;EFf3;AFf4;HQ;Jf1;HFf2;EFf3;AFf4;HQ;Af4;HQ;I*31#;gA#31#;gA*90*v#;OI;H*21*v#;bA*61*v#;dA*67*v#;cA#21#;eA#61#;eA#67#;eA*31#;gA#31#;gA*43#;hA#43#;iA*69#;DA*99#;xA
Voice Configuration Menu Access Code
930
Related Parameters
