C H A P T E R 5 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.
Chapter 5 Parameters and Defaults Configuration Text File Template Note The term Cisco ATA is used throughout this manual to refer to both the Cisco ATA 186 and the Cisco ATA 188, unless differences between the Cisco ATA 186 and Cisco ATA 188 are explicitly stated. Note This section contains recommended values for the United States and Sweden as configuration examples for certain parameters. For information about other countries, contact the Cisco equipment provider for a specific country.
Chapter 5 Parameters and Defaults User Interface (UI) Parameter NTPIP:0 AltNTPIP:0 DNS1IP:0.0.0.0 DNS2IP:0.0.0.0 UDPTOS:0xA0 RingOnOffTime:2,4,25 DialTone:2,31538,30831,1380,1740,1,0,0,1500 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 AlertTone:1,30467,0,5970,0,0,480,480,1920 DialPlan:*St4-|#St4-|911|1>#t8.r9t2-|0>#t811.rat4-|^1t4>#.
Chapter 5 Parameters and Defaults Configuration-Complete Parameter Range Maximum nine characters Default 0 Voice Configuration Menu Access Code 7387277 Related Parameters OpFlags, page 5-33—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.
Chapter 5 Parameters and Defaults Parameters for Configuration Method and Encryption UseTFTP Settings 1—Use the TFTP server for Cisco ATA configuration. 0—Do not use the TFTP server for Cisco ATA configuration.
Chapter 5 Parameters and Defaults Parameters for Configuration Method and Encryption Default 0 Voice Configuration Menu Access Code 905 Related Parameters • UseTFTP, page 5-5 • CfgInterval, page 5-6 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.
Chapter 5 Parameters and Defaults Network Parameters Note If the Cisco ATA configuration file is not encrypted, the value must be set to 0.
Chapter 5 Parameters and Defaults Network Parameters Default 1 Voice Configuration Menu Access Code 20 Related Parameters • StaticIp, page 5-8 • StaticRoute, page 5-8 • StaticNetMask, page 5-9 • OpFlags, page 5-33—Bits 3 and 11 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.
Chapter 5 Parameters and Defaults Account Information Parameters Voice Configuration Menu Access Code 2 Related Parameters • DHCP, page 5-7 • StaticIp, page 5-8 • StaticNetMask, page 5-9 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.
Chapter 5 Parameters and Defaults Account Information 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.
Chapter 5 Parameters and Defaults Account Information Parameters Voice Configuration Menu Access Code 4 Related Parameters • UID0, page 5-10 • UID1, page 5-11 • PWD1, page 5-12 • UseLoginID, page 5-13 • LoginID0, page 5-13 • LoginID1, page 5-14 • AutMethod, page 5-14 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.
Chapter 5 Parameters and Defaults Account Information 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 • UID0, page 5-10 • UID1, page 5-11 • PWD0, page 5-10 • UseLoginID, page 5-13 • LoginID0, page 5-13 • LoginID1, page 5-14 • AutMethod, page 5-14 Gateway Description Use this parameter to specify the H.
Chapter 5 Parameters and Defaults Account Information Parameters 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.
Chapter 5 Parameters and Defaults Account Information 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.
Chapter 5 Parameters and Defaults Gatekeeper Parameters Voice Configuration Menu Access Code 92 Related Parameters • LoginID0, page 5-13 • LoginID1, page 5-14 • PWD0, page 5-10 • PWD1, page 5-12 • NTPIP, page 5-30 • AltNTPIP, page 5-30 Gatekeeper Parameters This section describes the following parameters that are related to H.
Chapter 5 Parameters and Defaults Gatekeeper Parameters AltGk Description You have the option of using this parameter to statically specify the IP address of an alternate H.323 gatekeeper.
Chapter 5 Parameters and Defaults Gatekeeper 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 .
Chapter 5 Parameters and Defaults H.323 Mode Parameter 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.
Chapter 5 Parameters and Defaults Operating Parameters • DNS2IP, page 5-31 • UDPTOS, page 5-31 • SigTimer, page 5-32 • OpFlags, page 5-33 • VLANSetting, page 5-34 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.
Chapter 5 Parameters and Defaults Operating Parameters Related Parameters • RxCodec, page 5-21 • TxCodec, page 5-22 Value Type Integer Range 0 or 3 Default 0 Voice Configuration Menu Access Code 300 Related Parameters • AudioMode, page 5-20—Bits 1 and 17 • TxCodec, page 5-22 • RxCodec, page 5-21 • NumTxFrames, page 5-23 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.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-1 AudioMode Parameter Bit Definitions Bit Number Definition 0 and 16 0/1—Disable/enable silence suppression for all audio codecs. Silence suppression is enabled by default. 1 and 17 0—Enable selected low-bit-rate codec in addition to G.711. This setting is the default. 1—Enable G.711 only. 2 and 18 0/1—Disable/enable fax CED tone detection. This feature is enabled by default. 3 and 19 Reserved.
Chapter 5 Parameters and Defaults Operating Parameters Voice Configuration Menu Access Code 36 Related Parameters • LBRCodec, page 5-19 • NumTxFrames, page 5-23 • TxCodec, page 5-22 • AudioMode, page 5-20 TxCodec Description Use this parameter to specify the transmitting-audio codec preference. The following values are valid: • 0—G.723 (can be selected only if LBRCodec is set to 0) • 1—G.711A-law • 2—G.711µ-law • 3—G.
Chapter 5 Parameters and Defaults Operating Parameters NumTxFrames Description Use this parameter to select the number of frames per packet that the Cisco ATA transmits: Note • The frame size for each G.729 data packet is 10 ms. • The frame size for each G.723 data packet is 30 ms. The frame size for G.711 is fixed at 20 ms per packet and is not configurable. Examples • To obtain 60 ms of G.723 audio, set the parameter value to 2. • To obtain 120 ms of G.723 audio, set the parameter value to 4.
Chapter 5 Parameters and Defaults Operating 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 The subscribed features that can be permanently disabled by the user are CLIP_CLIR, call waiting and Fax mode.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-2 CallFeatures Parameter Bit Definitions (continued) Bit Number Definition 12-14 and 28-30 Reserved. 15 and 31 Fax mode. This service allows the user to set the Cisco ATA to Fax mode on a per-call basis. 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.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-3 PaidFeatures Parameter Bit Definitions (continued) Bit Number Definition 10 and 26 Not used for H.323. 11 and 27 Call Waiting Caller ID. 12-14 and 28-30 Reserved. 15 and 31 Fax mode. This service allows the user to set the Cisco ATA to Fax mode on a per-call basis. CallerIdMethod Description This 32-bit parameter specifies the signal format to use for both FXS ports for generating Caller ID format.
Chapter 5 Parameters and Defaults Operating Parameters Examples The following examples are recommended values for the CallerID Method parameter: • USA=0x19e60 • Sweden=0x0ff61 or 0x006aff61 • Denmark=0x0fde1 or 0x033efde1 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: • Bit 0: CALLER_CONNE
Chapter 5 Parameters and Defaults Operating Parameters 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 on page 5-28 provides bit definitions for this parameter.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-4 ConnectMode Parameter Bit Definitions (continued) Bit Number Definition 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—Reserved. 3—Reserved. 16—18 Not used for H.323. 19 0—Disable sending ringback tone to the caller. 1—Enable sending ringback tone to the caller. 20-22 Not used by H.323.
Chapter 5 Parameters and Defaults Operating Parameters Related Parameters • NTPIP, page 5-30 • AltNTPIP, page 5-30 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.
Chapter 5 Parameters and Defaults Operating Parameters Related Parameters • NTPIP, page 5-30 • TimeZone, page 5-29 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.
Chapter 5 Parameters and Defaults Operating Parameters • Bit 3: Throughput bit—1=request high throughput • Bit 4: Delay bit—1=request low delay • Bits 5-7: Specify datagram precedence. Values range from 0 (normal precedence) to 7 (network control). Value Type Bitmap Default 0xB8 Voice Configuration Menu Access Code 255 SigTimer Description This parameter controls various timeout values. Table 5-5 on page 5-32 contains bit definitions of this parameter.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-5 SigTimer Parameter Bit Definitions (continued) Bit Number Definition 20-25 Not used by H.323. 26-27 Minimum hook flash time—The minimum on-hook time required for 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 hook flash event.
Chapter 5 Parameters and Defaults Operating Parameters Table 5-6 OpFlags Parameter Operational Features to Turn On or Off (continued) Bit Number Definition 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 on page 5-34).
Chapter 5 Parameters and Defaults Optional Feature Parameters • Bits 18-29—User-specified 802.1Q VLAN ID. • Bits 30-31—Reserved.
Chapter 5 Parameters and Defaults Optional Feature Parameters 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”. • a—Number of seconds to turn the ring ON. • b—Number of seconds to turn the ring OFF. • c—The ring frequency, fixed at 25.
Chapter 5 Parameters and Defaults Optional Feature Parameters 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: • The termination character has been entered.
Chapter 5 Parameters and Defaults Optional Feature Parameters About Dial Plan Commands The following list contains rules for Cisco ATA dial plans: Note • . —Wildcard, match any digit entered. • - —Additional digits can be entered. This command can be used only at the end of a dial plan rule (for example, 1408t5- is legal usage of the - command, but 1408t5-3... is illegal). • >#—Defines the # character as a termination character.
Chapter 5 Parameters and Defaults Optional Feature Parameters • 0>#t811.rat4—If the first digit entered is 0, the timeout before automatic send is eight seconds, and the terminating character # can be entered at any time to manually send the dial string. If the first three digits entered are 011, then, after an additional 11 digits are entered, the timeout before an automatic send changes to four seconds.
Chapter 5 Parameters and Defaults Optional Feature Parameters 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.
Chapter 5 Parameters and Defaults Optional Feature Parameters Call-Progress Tone Parameters This section contains the following topics: • List of Call-Progress Tone Parameters, page 5-41 • Tone Parameter Syntax, page 5-41 • How to Calculate Scaling Factors, page 5-42 • Recommended Values, page 5-42 • Specific Call-Progress Tone Parameter Information, page 5-43 List of Call-Progress Tone Parameters The following list contains the names of the call-progress tone parameters: • DialTone • BusyTon
Chapter 5 Parameters and Defaults Optional Feature Parameters • off-time controls the length of time between audible tones in milliseconds (ms) expressed as an integer from 0 to 0xffff sample at 8000 samples/second. • total-tone-time controls the length of time the tone is audible (0 to 0xffff). If this value is set to 0, the tone will play until another call event stops the tone.
Chapter 5 Parameters and Defaults Optional Feature Parameters The following settings are recommended for Sweden: • DialTone = "1,30959,0,4253,0, 1, 0, 0,1500" (approximately -5 dBm) • BusyTone = "1,30959,0,2392,0, 0, 2000, 2000,0" (approximately -10 dBm) • ReorderTone = "1,30959,0,2392,0, 0, 2000, 6000,0" (approximately -10 dBm) • RingBackTone = "1,30959,0,2392,0, 0, 8000, 40000,0" (approximately -10 dBm) • CallWaitTone = "1,30959,0,2392,0, 0, 1600, 4000,11200" (approximately -10 dBm) • AlertTo
Chapter 5 Parameters and Defaults Optional Feature Parameters BusyTone Description The Cisco ATA plays the busy tone when the callee is busy.
Chapter 5 Parameters and Defaults Optional Feature Parameters RingbackTone Description The Cisco ATA plays the ring-back tone when the callee is being alerted by the called device.
Chapter 5 Parameters and Defaults Optional Feature Parameters 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.
Chapter 5 Parameters and Defaults Optional Feature Parameters Voice Configuration Menu Access Code 930 Related Parameters • CallFeatures, page 5-24 • PaidFeatures, page 5-25 • CallerIdMethod, page 5-26 • SigTimer, page 5-32 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide (H.
Chapter 5 Parameters and Defaults Optional Feature Parameters Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide (H.