cc/td/doc/product/voice/ata/ataadmn
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Parameters and Defaults
Configuration Text File Template
User Interface (UI) Parameter
Parameters for Configuration Method and Encryption
Network Parameters
Account Information Parameters
SCCP Mode Parameter
Operating Parameters
Optional Feature Parameters

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 SCCP; only those used for SCCP are covered in this section.

Parameters are divided into categories based on their functionality. The following categories of parameters are covered in this section:

The following list contains general configuration information:

Configuration Text File Template

This is a listing of the sk_example.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 a Cisco ATA Default Configuration File" section and the "Creating a Configuration File for a Specific Cisco ATA" section.

The sk_example.txt file contains all the Cisco ATA default values. The sections that follow this listing describe all the parameters in this file.

#txt
UIPassword:0
UseTftp:1
TftpURL:0
cfgInterval:3600
EncryptKey:0
ToConfig:0
upgradecode:0,0x301,0x0400,0x0200,0.0.0.0,69,0,none
upgradelang:0,0x301,0x0400,0x0200,0.0.0.0,69,0,none
Dhcp:1
StaticIp:0
StaticRoute:0
StaticNetMask:0
CA0orCM0:0
CA1orCM1:0
CA0UID:0
CA1UID:0
EPID0orSID0:.
EPID1orSID1:.
PrfCodec:1
LBRCodec:3
AudioMode:0x00350035
NumTxFrames:2
CallerIdMethod:0x00019e60
ConnectMode:0x90000400
DNS1IP:0.0.0.0
DNS2IP:0.0.0.0
UDPTOS:0xA0
RingCadence:2,4,25
DialTone:2,31538,30831,1380,1740,1,0,0,0
BusyTone:2,30467,28959,1191,1513,0,4000,4000,0
ReorderTone:2,30467,28959,1191,1513,0,2000,2000,0
RingBackTone:2,30831,30467,1943,2111,0,16000,32000,0
CallWaitTone:1,30831,0,5493,0,0,2400,2400,4800
ConfirmTone:1,30467,0,5970,0,0,480,480,1920
MediaPort:16384
UseMGCP:0
MGCPPort:2427
RetxIntvl:500
RetxLim:7
MGCPVer:MGCP1.0
NPrintf:0
TraceFlags:0x00000000
SigTimer:0x00000064
CodecName:PCMU,PCMA,G723,G729
OpFlags:0x2
VLANSetting:0x0000002b

User Interface (UI) Parameter

This parameter type contains 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 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   When UIPassword contains letters, you cannot enter the password from the telephone keypad.

Value Type

Alphanumeric string

Range

Maximum nine characters

Default

0

Voice Configuration Menu Access Code

7387277

Related Parameter

OpFlags (bit 7)

Parameters for Configuration Method and Encryption

This section describes parameters for instructing the Cisco ATA how to locate its TFTP server and how to encrypt its configuration file. These parameters are:

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   From the voice configuration menu, you can only enter the IP address; from the web configuration page, you can enter the actual URL.

Value Type

Alphanumeric string

Range

Maximum 31 characters

Default

0

Voice Configuration Menu Access Code

905

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   If the Cisco ATA configuration file is not encrypted, the value must be set to 0.

Value Type

Alphanumeric string

Range

Maximum eight characters

Default

0

Voice Configuration Menu Access Code

320

Related Parameters

Network Parameters

This section describes the parameters 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

Configure the Cisco ATA IP address using this parameter 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

Configure the Cisco ATA statically assigned route in this parameter 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

Configure the statically assigned subnet mask using this parameter 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:

EPID0orSID0 and EPID1orSID1

SIDx specifies whether to enable the Phone 1 and/or Phone 2 ports on the Cisco ATA to register with Cisco Call Manager. (EPIDx is not for SCCP.) SIDx can be one of the following values:

Value Types

Alphanumeric string for each parameter

Range

Maximum 51 characters for each parameter

Voice Configuration Menu Access Codes

46 and 47 for EPID0orSID0 and EPID1orSID1, respectively

CA0orCM0 and CA1orCM1

Description

CMx specifies the IP address (with an optional port number) or the URL of the primary or secondary Cisco CallManager to which the Cisco ATA should register. Use the CM0 parameter for the primary Cisco CallManager and the CM1 parameter for the secondary Cisco CallManager parameter. (CAx is not for SCCP.)


Note   Use this parameter only if the default Cisco CallManager TFTP method is not desirable for configuring the Cisco CallManager IP address, in which case you must set the UseTftp parameter to 0.

If you specify a Cisco CallManager port, you must separate the port number from the host IP address with a colon (:).

Examples

Examples of CA0orCM0 values follow:

Value Type

Alphanumeric string

Range

Maximum 31 characters

Default

0

Voice Configuration Menu Access Code

5 and 6, respectively

Related Parameters

SCCP Mode Parameter

This parameter (UseMGCP) is located in the yellow portion of the Cisco ATA web configuration page. The other parameters in this portion of the screen are not for SCCP.

UseMGCP

Description

Set this parameter to 0 if you are using the Cisco ATA as an SCCP client. (Set this parameter to 1 if you are using the Cisco ATA as an MGCP client.)

Value Type

Boolean

Range

0 or 1

Default

0

Voice Configuration Menu Access Code

38

Other Parameters

This remaining parameters in the yellow portion of the configuration screen are not used for SCCP:

Operating Parameters

The parameters described in this section include parameters for configuring codecs, fax features and VLAN settings:

LBRCodec

Description

This parameter is used for selecting the low-bit-rate codec. The following values are valid:

If LBRCodec=0, then both Cisco ATA FXS ports can operate with the following codecs:

If LBRCodec=3, check the setting of bit 21 in the ConnectMode parameter (see the "ConnectMode" section) to determine if G.729 is enabled for the Phone 1 or Phone 2 FXS port.

If LBRCodec=3, then the Phone 1 FXS port can operate with the following codecs:

If LBRCodec=3, then the Phone 2 FXS port can operate with the following codecs:

Value Type

Integer

Range

0 or 3

Default

3

Voice Configuration Menu Access Code

300

Related Parameters

ConnectMode (bit 21)

AudioMode (bits 1 and 17)

PrfCodec

Description

Not used for SCCP.

AudioMode

Description

This parameter is used for the audio operating mode. The lower 16 bits are for the Phone 1 FXS port, and the upper 16 bits are for the Phone 2 FXS port. Table 5-1 provides definitions for each bit.

Value Type

Bitmap

Default

0x00350035

Voice Configuration Menu Access Code

312

Related Parameters

Table 5-1   AudioMode Parameter Bit Definitions 

Bit Number  Definition 

0

0/1—Disable/enable G.711 silence suppression for all codecs.

Note When Bit 0 is set to 1, the Cisco ATA checks the silence suppression setting on the Cisco CallManager to determine if silence suppression should be applied to the call. When Bit 0 is set to 0, the Cisco ATA will not use silence suppression regardless of the silence suppression setting on the Cisco CallManager.

1

0—Enable selected low-bit-rate codec in addition to G.711. This setting is the default.

1—Enable G.711 only.

2

0/1—Disable/enable fax CED tone detection.

3-15

Reserved.

ConnectMode

Description

This parameter is a 32-bit bitmap to control the connection mode of the selected call signalling protocol. Table 5-2 provides bit definitions for this parameter.

Value Type

Bitmap

Default

0x90000400

Voice Configuration Menu Access Code

311

Related Parameters

Table 5-2   ConnectMode Parameter Bit Definitions

Bit Number  Definition 

0-1

Reserved.

2

0—Use the dynamic payload type 126/127 as the RTP payload type (fax pass-through mode) for G.711 µ-law/G.711 A-law.

1—Use the standard payload type 0/8 as the RTP payload type (fax pass-through mode) for G.711 µ-law/G.711 A-law.

3-6

Reserved.

7

0/1—Disable/enable fax pass-through redundancy.

8-12

Specifies the fax pass-through NSE payload type. The value is the offset to the NSE payload base number of 96. The valid range is 0-23; the default is 4.

For example, if the offset is 4, the NSE payload type is 100.

13

0—Use G.711µ-law for fax pass-through codec.

1—Use G.711A-law for fax pass-through codec.

14-15

0—Use fax pass-through.

1—Use codec negotiation in sending fax.

2,3—Reserved.

16-20

Reserved.

21

0—Enable G729 on the Phone 1 FXS port.

1—Enable G729 on the Phone 2 FXS port.

22-27

Reserved.

28-29

0—Select the Cisco ATA Style for mid-call services. Services are call hold/resume, call transfer and conference call.

1—Select the Bellcore Style for mid-call services. Services are call transfer and conference call.

2—Select the Cisco VG248 Style for mid-call services. Services are three-way calling, call transfer and conference call.

For end-user procedures of each service that the Cisco ATA supports for each style, see "How to Use Pre-call and Mid-call Services."

30

0/1—Disable/enable Cisco IOS Telephony Solution (ITS). Cisco ITS runs on an IOS router and is a subset of Cisco CallManager. If you have Cisco ITS, refer to the documentation for that product.

31

0 - Disable XML configuration file support (use if you are running Cisco CallManager version 3.0).

1 - Enable XML configuration file support (use if you are running Cisco CallManager version 3.1 or later).

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

DNS1IP

Description

This parameter is for setting the primary domain name server (DNS) IP address, if the DHCP server does not provide one. If DHCP provides DNS1IP (and if it is non-zero), this parameter overwrites the DHCP-supplied value. You cannot 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

Related Parameter

DHCP

DNS2IP

Description

This parameter is for setting the secondary domain name server (DNS) IP, if the DHCP server does not provide one. If DHCP provides DNS2IP (if it is non-zero), this parameter overwrites the DHCP-supplied value. You cannot 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

Related Parameter

DHCP

Domain

Description

The Cisco ATA uses the value of this parameter for a DNS search if either the TftpUrl or CM0orCA0 parameters do not contain a fully qualified domain name. For example, if cm1 is specified as the Cisco CallManager URL, and cisco.com is the value of the Domain parameter, then the Cisco ATA uses cm1@cisco.com for its DNS search.

The following values are valid:

Value Type

Alphanumeric string

Range

Maximum 31 characters

Default

.

Voice Configuration Menu Access Code

931

Related Parameters

NumTxFrames

Description
Not used for SCCP. For information about RTP packet size configuration, which is controlled by the Cisco CallManager, refer to your Cisco CallManager documentation.

UDPTOS

Description

Use this parameter to specify the default 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

OpFlags

Description

Use this parameter to enable/disable various operational features.

See Table 5-3 for bit definitions of this parameter.

Value Type

Bitmap

Default

0x2

Voice Configuration Menu Access Code

323

Related Parameters

Table 5-3   OpFlags Parameter Operational Features to Turn On or Off 

Bit Number  Definition 

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 servers 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 disables 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-based configuration.

8-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-31

Reserved.

VLANSetting

Description

This parameter is used for specifying VLAN-related settings.

Bitmap definitions are as follows for the VLANSetting parameter:

Value Type

Bitmap

Default

0x0000002b

Voice Configuration Menu Access Code

324

Related Parameter

OpFlags

Optional Feature Parameters

This section includes the parameters used to configure various timeout values and call-progress tones:

SigTimer

Description

This parameter controls various timeouts. Table 5-4 contains bit definitions of this parameter.

Value Type

Bitmap

Default

0x00000064

Voice Configuration Menu Access Code

318

Related Parameter

CallWaitTone

Table 5-4   SigTimer Parameter Bit Definitions 

Bit Number  Definition 

0-7

Call waiting period—The period between each burst of call-waiting tone.

Range: 0 to 255 in 0.1 seconds

Default: 100 (0x64=100 seconds)

8-15

Not used for SCCP.

16-25

Reserved—Should be set to 0.

26-27

Minimum hook flash time—The minimum on-hook time required for a hook flash event.

Range: 0 to 3

Default: 0 (60 ms)

Other possible values: 1=100 ms, 2=200 ms, 3=300 ms.

28-31

Maximum hook flash time—The maximum on-hook time allowed for a hook flash event.

Range: 0 to 15

Default: 0 (1000 ms)

Other possible values: 1=100 ms, 2=200 ms, 3=300 ms, 4=400 ms, 5=500 ms, 6=600 ms, 7=700 ms, 8=800 ms, 9=900 ms, 10=1000 ms, 11=1100 ms, 12=1200 ms, 13=1300 ms, 14=1400 ms, 15=1500 ms.

RingCadence

Description

Use this parameter to specify the internal and external 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

Call-Progress Tone Parameters

This section covers all the call-progress tones that the Cisco ATA supports, and 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    Only positive values can be configured to the Cisco ATA 186. For negative values, use the 16-bit 2's-complement value. For example, enter -1 as 65535 or 0xffff.

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   All tones are persistent (until the Cisco ATA changes state) except for the call-waiting tone and the confirm tone. The call-waiting tone, however, repeats automatically once every 10 seconds while the call-waiting condition exists.

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 ^ 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, appear 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.

This parameter is for specifying the inside dial tone in SCCP. The outside dial tone in SCCP is fixed at 450Hz+540Hz@-6dBm. The inside dial tone is the tone that the telephone plays when a phone inside the PBX goes off-hook. The outside dial tone is the tone that the telephone plays when a phone inside the PBX is connected to the PSTN.

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

ConfirmTone
Description

The Cisco ATA plays the confirm 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

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

Related Parameter

TraceFlags

TraceFlags

Description

This parameter is for diagnostic use. Bit values are as follows:

Value Type

Bitmap

Default

0x00000000

Voice Configuration Menu Access Code

313

Related Parameters

NPrintf

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


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jul 30 16:44:53 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.