Home » Cisco Manuals » Telephony » Cisco ATA188-I2-A » Manual Viewer

Cisco ATA188-I2-A Administration Guide - Page 119

Tone Parameter Syntax—Extended Formats, Extended Format

Get Cisco ATA188-I2-A PDF manuals and user guides

Add to My Manuals
Save this manual to your list of manuals

Page 119 highlights

Chapter 5 Parameters and Defaults Tone Configuration Parameters Tone Parameter Syntax-Extended Formats Two types of extended format exist for the Cisco ATA tone parameters: • Extended Format A, page 5-43-This format can be used for the following tone parameters: - DialTone - BusyTone - RingbackTone - CallWaitTone - AlertTone • Extended Format B, page 5-44-This format can be used only for the ReorderTone parameter. Extended Format A Each tone is specified by 11 integers, as follows: parametername:NumOfFreqs,Tfreq1,Tamp1,Tfreq2,Tamp2,NumOfOnOffPairs,OnTime1, OffTime1,OnTime2,OffTime2,TotalToneTime • parametername is the name of the tone. • NumOfFreqs = 100 + the number of frequencies in the tone. (Therefore, NumOfFreqs = 101 for one frequency, and 102 for two frequencies.) • Tfreq1 and Tfreq2 are the transformed frequencies of the first and second frequencies, respectively. Their values are calculated with the following formula: 32767 * cos (2*pi*F/8000) where F is the desired frequency in Hz. Set this value to 0 if the frequency does not exist. The range of each value is -32768 to 32767. For negative values, use the 16-bit 2's complement value. For example, enter -1 as 65535 or as 0xffff. • Tamp1 and Tamp2 are the transformed amplitudes of the first and second frequencies, respectively. Their values are calculated with the following formula: 32767 * A * sin(2*pi*F/8000) A (amplitude factor) = 0.5 * 10^((k+10-(n-1)*3)/20) where F is the desired frequency in Hz, k is the desired volume in dBm, and n is the number of frequencies. The ^ symbol means to the order of. • NumOfOnOffPairs is the number of on-off pairs in the cadence of the tone. Valid values are 0, 1 and 2. Use 0 if the tone is steady. • OnTime1 and OnTime2 values are the lengths of time the tone is played for the first and second on-off pairs of a cadence, respectively. (See Figure 5-1 for a graphical representation.) Specify each value as a number of samples with a sampling rate of 8 kHz. The range of each value is 0 to 0xffff. For example, for a length of 0.3 seconds, set the value to 2400. OL-4804-01 Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator's Guide for H.323 (version 3.0) 5-43

Section	Page
CiscoATA186 and CiscoATA188 Analog Telephone Adaptor Administrator’s Guide for H.323 (version...	1
Contents	3
Preface	11
Overview	11
Audience	11
Organization	12
Conventions	12
Related Documentation	16
Obtaining Documentation	16
World Wide Web	16
Documentation CD-ROM	17
Ordering Documentation	17
Documentation Feedback	17
Obtaining Technical Assistance	17
Cisco.com	18
Technical Assistance Center	18
Cisco TAC Web Site	18
Cisco TAC Escalation Center	19
Cisco Analog Telephone Adaptor Overview	21
H.323 Overview	22
H.323 Terminals	23
H.323 Gateways	23
H.323 Gatekeepers	24
H.323 MCUs	24
H.323 Proxy Server	24
Hardware Overview	25
Software Features	27
Voice Codecs Supported	27
Additional Supported Signaling Protocols	27
Other Supported Protocols	27
CiscoATA H.323 Services	28
Fax Services	29
Supplementary Services	29
Installation and Configuration Overview	29
Installing the CiscoATA	31
Safety Recommendations	31
What the CiscoATA Package Includes	32
What You Need	32
Installation Procedure	33
Power-Down Procedure	35
Configuring the CiscoATA for H.323	37
Default Boot Load Behavior	38
Specifying a Preconfigured VLAN ID or Disabling VLAN IP Encapsulation	39
Steps Needed to Configure the Cisco ATA	41
Basic Configuration Steps in a TFTP Server Environment	41
Basic Configuration Steps in a Non-TFTP Server Environment	43
Configuring the Cisco ATA Using a TFTP Server	44
Setting Up the TFTP Server with CiscoATA Software	44
Configurable Features and Related Parameters	44
Creating Unique and Common CiscoATA Configuration Files	45
Using atapname.exe Tool to Obtain MAC Address	47
Using Encryption With the cfgfmt Tool	48
Examples of Upgrading to Stronger Encryption Key	51
atadefault.cfg Configuration File	53
Configuring the Cisco ATA to Obtain its Configuration File from the TFTP Server	54
Using a DHCP Server	54
Without Using a DHCP Server	56
Voice Configuration Menu	56
Using the Voice Configuration Menu	57
Entering Alphanumeric Values	58
Resetting the CiscoATA to Factory Default Values	59
CiscoATA Web Configuration Page	59
Refreshing or Resetting the CiscoATA	61
Procedure to Refresh the CiscoATA	62
Procedure to Reset the CiscoATA	62
Obtaining CiscoATA Configuration File After Failed Attempt	62
Upgrading the H.323 Signaling Image	62
Basic and Additional H.323 Services	63
Important Basic H.323 Services	63
Required Parameters	63
Setting Up User IDs for the CiscoATA	65
Using the Cisco ATA with an H.323 Gatekeeper	65
Choosing Cisco ATA Registration Mode with an H.323 Gatekeeper	65
Setting Up Gatekeeper Time-To-Live Value	66
Setting Up an Alternate H.323 Gatekeeper	66
Establishing Authentication with Cisco H.323 Gatekeeper	67
Using the Cisco ATA Without an H.323 Gatekeeper	68
Using the Cisco ATA With an H.323 Gateway but Without an H.323 Gatekeeper	68
Using Multiple Cisco ATAs Without an H.323 Gatekeeper	68
Setting the Audio Codecs	69
Additional H.323 Services	69
Configurable Reboot of CiscoATA	70
Configuring Audio Packet Settings	70
Configuring Billable Features	70
Configuring the Call Waiting Permanent Default Setting	71
Configuring the CiscoATA Refresh Interval	71
Configuring Hook Flash Timing	71
Configuring the Mixing of Call Waiting Tone and Audio	71
Configuring Network Ringback Tone	72
Configuring Reverse Audio Cut-Through Behavior	72
Configuring Supplementary Service Behavior and Parameters	72
Debugging Diagnostics	72
Hardware Information Display	72
Network Timing	73
Polarity Settings	73
Progress Tones	73
Selecting DTMF and Hookflash Transmission Methods	73
Selecting H.323 Connection and H.245 Transmission Methods	74
Setting Dial Plans	74
Complete Reference Table of all CiscoATA H.323 Services	74
Parameters and Defaults	77
Configuration Text File Template	78
User Interface (UI) Security Parameter	79
UIPassword	79
Parameters for Configuration Method and Encryption	80
UseTFTP	80
TftpURL	81
CfgInterval	82
EncryptKey	82
EncryptKeyEx	83
Network Configuration Parameters	84
DHCP	84
StaticIp	85
StaticRoute	85
StaticNetMask	86
NTPIP	86
AltNTPIP	87
DNS1IP	87
DNS2IP	88
VLANSetting	88
H.323 Parameters	89
GkOrProxy	89
GkId	90
GkTimeToLive	90
AltGk	90
AltGkTimeOut	91
UID0	92
PWD0	92
UID1	93
PWD1	94
LoginID0	94
LoginID1	95
UseLoginID	95
AutMethod	96
Gateway	96
Audio Configuration Parameters	97
MediaPort	97
RxCodec	98
TxCodec	98
LBRCodec	99
AudioMode	100
NumTxFrames	101
TOS	102
Operational Parameters	102
CallFeatures	103
PaidFeatures	104
CallCmd	105
FeatureTimer	106
FeatureTimer2	107
SigTimer	107
ConnectMode	108
OpFlags	110
TimeZone	112
Telephone Configuration Parameters	113
CallerIdMethod	114
Polarity	115
FXSInputLevel	116
FXSOutputLevel	116
Tone Configuration Parameters	117
Tone Parameter Syntax—Basic Format	117
Tone Parameter Syntax—Extended Formats	119
Extended Format A	119
Extended Format B	120
Recommended Values	124
Specific Tone Parameter Information	124
DialTone	124
BusyTone	125
ReorderTone	125
RingbackTone	126
CallWaitTone	126
AlertTone	127
RingOnOffTime	127
Dial Plan Parameters	128
DialPlan	128
Dial Plan Commands	129
Dial Plan Rules	130
Dial Plan Examples	134
DialPlanEx	136
IPDialPlan	136
Diagnostic Parameters	136
NPrintf	137
SyslogIP	137
SyslogCtrl	138
CFGID—Version Parameter for CiscoATA Configuration File	139
Call Commands	141
Call Command Structure	141
Syntax	142
Context-Identifiers	143
Input Sequence Identifiers	144
Action Identifiers	144
Call Command Example	145
Call Command Behavior	147
Configuring and Debugging Fax Services	153
Using Fax Pass-through Mode	153
Configuring the Cisco ATA for Fax Pass-through mode	154
AudioMode	154
ConnectMode	155
Configuring Cisco IOS Gateways to Enable Fax Pass-through	155
Enable Fax Pass-through Mode	156
Disable Fax Relay Feature	157
Using FAX Mode	158
Configuring the Cisco ATA for Fax Mode	158
Configuring the Cisco ATA for Fax Mode on a Per-Call Basis	159
Configuring the Cisco IOS Gateway for Fax Mode	159
Debugging the Cisco ATA 186/188 Fax Services	159
Common Problems When Using IOS Gateways	159
Using prserv for Diagnosing Fax Problems	161
prserv Overview	161
Analyzing prserv Output for Fax Sessions	162
Using rtpcatch for Diagnosing Fax Problems	164
rtpcatch Overview	164
Example of rtpcatch	166
Analyzing rtpcatch Output for Fax Sessions	168
Using rtpcatch to Analyze Common Causes of Failure	170
rtpcatch Limitations	172
Upgrading the CiscoATA Signaling Image	173
Upgrading the Signaling Image from a TFTP Server	173
Upgrading the Signaling Image Manually	174
Preliminary Steps	175
Running the Executable File	175
Upgrade Requirements	175
Syntax	176
Upgrade Procedure and Verification	176
Confirming a Successful Signaling Image Upgrade	177
Using a Web Browser	177
Using the Voice Configuration Menu	178
Troubleshooting	179
General Troubleshooting Tips	179
Symptoms and Actions	180
Installation and Upgrade Issues	181
Debugging	182
Using System Diagnostics	183
Local Tone Playout Reporting	187
Obtaining Network Status Prior to Getting IP Connectivity	188
Obtaining Network Status After Getting IP Connectivity	189
DHCP Status HTML Page	190
Real-Time Transport Protocol (RTP) Statistics Reporting	190
Frequently Asked Questions	191
Contacting TAC	193
Using H.323 Supplementary Services	195
Changing Call Commands	195
Cancelling a Supplementary Service	195
Common Supplementary Services	195
Caller ID	196
Call-Waiting Caller ID	196
Making a Conference Call in the United States	196
Making a Conference Call in Sweden	197
Call Waiting in the United States	197
Call Waiting in Sweden	197
Calling Line Identification Presentation	197
About Calling Line Identification Restriction	198
Calling Line Identification Restriction in the United States	198
Calling Line Identification Restriction in Sweden	198
Voice Menu Codes	199
CiscoATASpecifications	203
Physical Specifications	203
Electrical Specifications	204
Environmental Specifications	204
Physical Interfaces	204
Ringing Characteristics	205
Software Specifications	205
H.323 Signaling	209
Supported H.323 Messages	209
H.323 Signaling Scenarios	210
H.323 Endpoint-to-Gatekeeper Registration	210
H.323 Endpoint-to-Endpoint Call Setup with a Common Gatekeeper	213
H.323 Call Setup from H.323 Network to Circuit Switched Network	222
Recommended CiscoATATone Parameter Values by Country	243
Glossary	259

Match case Limit results 1 per page

5-43

Cisco ATA 186 and Cisco ATA 188 Analog Telephone Adaptor Administrator’s Guide for H.323 (version 3.0)

OL-4804-01

Chapter 5

Parameters and Defaults

Tone Configuration Parameters

Tone Parameter Syntax—Extended Formats

Two types of extended format exist for the Cisco ATA tone parameters:

•

Extended Format A, page 5-43

—This format can be used for the following tone parameters:

–

DialTone

–

BusyTone

–

RingbackTone

–

CallWaitTone

–

AlertTone

•

Extended Format B, page 5-44

—This format can be used only for the ReorderTone parameter.

Extended Format A

Each tone is specified by 11 integers, as follows:

parametername

NumOfFreqs,Tfreq1,Tamp1,Tfreq2,Tamp2,NumOfOnOffPairs,OnTime1,

OffTime1,OnTime2,OffTime2,TotalToneTime

•

parametername

is the name of the tone.

•

NumOfFreqs

100 + the number of frequencies in the tone. (Therefore,

NumOfFreqs

= 101 for one

frequency, and 102 for two frequencies.)

•

Tfreq1

and

Tfreq2

are the transformed frequencies of the first and second frequencies, respectively.

Their values are calculated with the following formula:

32767 * cos (2*pi*F/8000)

where

is the desired frequency in Hz. Set this value to

if the frequency does not exist.

The range of each value is –32768 to 32767.

For negative values, use the 16-bit 2’s complement value. For example, enter

–1

as 65535 or as

0xffff.

•

Tamp1

and

Tamp2

are the transformed amplitudes of the first and second frequencies, respectively.

Their values are calculated with the following formula:

32767 * A * sin(2*pi*F/8000)

A (amplitude factor) = 0.5 * 10^((k+10-(n-1)*3)/20)

where

is the desired frequency in Hz,

is the desired volume in

dBm

, and

is the number of

frequencies. The

symbol means

to the order of

•

NumOfOnOffPairs

the number of on-off pairs in the cadence of the tone.

Valid values are 0, 1 and 2. Use 0 if the tone is steady.

•

OnTime1

and

OnTime2

values

are the lengths of time the tone is played for the first and second

on-off pairs of a cadence, respectively. (See

Figure 5-1

for a graphical representation.)

Specify each value as a number of samples with a sampling rate of 8 kHz. The range of each value

is 0 to 0xffff. For example, for a length of 0.3 seconds, set the value to 2400.