User`s manual

SIP User's Manual 15. Configuration Files
Version 5.0 325 December 2006
15 Configuration Files
This section describes the configuration dat files that are loaded (in addition to the ini file)
to the gateway. The configuration files are:
 Call Progress Tones file (refer to Section 15.1 on page 325).
 Prerecorded Tones file (refer to Section 15.2 on page 330).
 FXS Coefficient file (refer to Section 15.3 on page 331).
 User Information file (refer to Section 15.4 on page 332).
To load either of the configuration files to the MediaPack use the Embedded Web Server
(refer to Section 5.9.2 on page 202) or alternatively specify the name of the relevant
configuration file in the gateway’s ini file and load it (the ini file) to the gateway (refer to
Section 5.9.2.1 on page 203).
15.1 Configuring the Call Progress Tones and Distinctive
Ringing File
The Call Progress Tones and Distinctive Ringing, configuration file used by the MediaPack
is a binary file (with the extension dat) that is comprised of two sections. The first section
contains the definitions of the Call Progress Tones (levels and frequencies) that are
detected / generated by the MediaPack. The second section contains the characteristics of
the distinctive ringing signals that are generated by the MediaPack.
Users can either use, one of the supplied MediaPack configuration (dat) files, or construct
their own file. To construct their own configuration file, users are recommended, to modify
the supplied usa_tone.ini file (in any standard text editor) to suit their specific requirements,
and to convert it (the modified ini file) into binary format using the TrunkPack Downloadable
Conversion Utility. For the description of the procedure on how to convert CPT ini file to a
binary dat file, refer to Section E.1.1 on page 364.
Note that only the dat file can be loaded to the MediaPack gateway.
To load the Call Progress Tones (dat) file to the MediaPack, use the Embedded Web
Server (refer to Section 5.6.4 on page 166) or the ini file (refer to Section 5.9.2.1 on page
203).
15.1.1 Format of the Call Progress Tones Section in the ini File
Users can create up to 32 different Call Progress Tones, each with frequency and format
attributes.
The frequency attribute can be single or dual-frequency (in the range of 300 Hz to 1980
Hz), or an Amplitude Modulated (AM). In total, up to 64 different frequencies are supported.
Only eight AM tones, in the range of 1 to 128 kHz, can be configured (the detection range
is limited to 1 to 50 kHz). Note that when a tone is composed of a single frequency, the
second frequency field must be set to zero.
The format attribute can be one of the following:
 Continuous: (e.g., dial tone) a steady non-interrupted sound. Only the ‘First Signal
On time’ should be specified. All other on and off periods must be set to zero. In this
case, the parameter specifies the detection period. For example, if it equals 300, the
tone is detected after 3 seconds (300 x 10 msec). The minimum detection time is 100
msec.
 Cadence: A repeating sequence of on and off sounds. Up to four different sets of on /
off periods can be specified.
 Burst: A single sound followed by silence. Only the ‘First Signal On time’ and ‘First
Signal Off time’ should be specified. All other on and off periods must be set to zero.
The burst tone is detected after the off time is completed.