TrunkPack Downloadable Conversion Utility

(DConvert)

This document describes and explains the file design used by the TrunkPack
Downloadable Convention Utility (DConvert) for:

1. Call Progress Tones File Design below

2. Voice Prompts File(s) Design on page 4

3. CAS File Design on page 5

4. VXML File Design on page 6

This is a NEW DESIGN for version 2.4 and higher.

Following are the file design descriptions for CPT Version 3:

A. Call Progress Tones File Design

Field Description Size

Magic Number A predefined value Uint
Varies; Identification
of the Call Progress
Tones file and
information for which
of the types are
included in the file
(Call Progress tones,
User Defined Tones and
Ring Types).
Offset Size of offset (from Uint [offset value is
the beginning of the 199, computed as
file pointing to the 1+1+1+1+1+64+1+1+64+64]
“Number of Call
Progress Tones
processed”)
Length Length of file in Uint
bytes, everything but
the checksum
File type As is Uint
AC version As is Uint
Vendor As is Char[256]
Hi version x. Uint
Low version .x Uint
Version description As is Char[256]
Date + time The date and time the Char[256]
file was created
Number of Call Progress Number of data records Uint
Tones processed (if found in the current
included) INI file processed
File data The outcome of the Pre-unknown; (Note that
converted INI file the size of the File
(described in the data can be calculated
following table) by subtracting the
 Field Description Size
header and checksum)
Number of User Defined Number of data records Uint
Tones processed (if found in the current
included) INI file processed
File data The outcome of the Pre-unknown; (Note that
converted INI file the size of the File
data can be calculated
by subtracting the
header and checksum)
Number of Ring Types Number of Ring types Uint
processed (if included) found in the current
INI file
Ring Types Data The outcome of the Pre-Unknown, number of
converted ring types ring types may vary
data
Checksum A standard checksum, An unsigned short (16-
computed by unsigned bit) converted to an
chars[8-bit] into an unsigned int
unsigned short (16-bit)

The Call Progress Tones INI File Design

The Call Progress Tones file can includes three types of data: Call Progress Tones, User
Defined Tones and Ring Types. Following is the syntax of each type:

1. Call Progress Tones.

Field Description Size

Number of Call The number of Call Progress Uint
Progress Tones Tones exists
ToneType The "logical" tone type Uint
Tone Modulation Type 0-no modulation or 1-AM
modulation.
Tone Form 1-contonuous tone, 2-cadence Uint
tone, 3-burst tone
LowFreq [Hz] [Hz] Freq of the lower Uint
component of the dual tone
HighFreq [Hz] [Hz] Freq of the higher Uint
component of the dual tone
LowFreqLevel [-dBm] [-dBm] Generation level of the Uint
lower component of the dual
tone, can also be coded (refer
to the table below)
HighFreqLevel [-dBm] [-dBm] Generation level of the Uint
higher component of the dual
tone, can also be coded (refer
to the table below)
First Signal On Time [10msec] First signal on time Uint
[10msec] interval
First Signal Off Time [10msec] First signal off time Uint
[10msec] interval
Second Signal On Time [10msec] Second signal on time Uint
[10msec] interval
Second Signal Off [10msec] Second signal off time Uint
Time [10msec] interval
 Field Description Size
Third Signal On Time [10msec] Third signal on time Uint
[10msec] interval
Third Signal Off Time [10msec] Third signal off time Uint
[10msec] interval
Fourth Signal On Time [10msec] Fourth signal on time Uint
[10msec] interval
Fourth Signal Off [10msec] Fourth signal off time Uint
Time [10msec] interval
Default Duration [msec] default duration time Uint
[msec] for the tone generation

In case the tone is AM (Tone Modulation Type=1), the LowFreq [Hz], HighFreq [Hz],
LowFreqLevel [-dBm] and HighFreqLevel [-dBm] fields are replaced with the following
fields:

Field Description Size

Carrier Freq [Hz] [Hz] The Carrier Frequency of Uint
the AM tone
Modulation Freq [Hz] [Hz] The Modulation Frequency Uint
of the AM tone
Signal Level [-dbm] [-dBm] level of the AM tone Uint
AM Factor [in steps The AM Factor in steps of 0.02 Uint
of 0.02] (e.g., if required factor is
0.1, the configuration of the
AM factor parameter should be
5)

2. User Defined Tones.

Field Description Size

Number of User The number of User Defined Uint
Defined Tones Tones exists
ToneType The "logical" tone type Uint
LowFreq [Hz] [Hz] Freq of the lower Uint
component of the dual tone
HighFreq [Hz] [Hz] Freq of the higher Uint
component of the dual tone
LowFreqLevel [-dBm] [-dBm] Generation level of the Uint
lower component of the dual
tone, can also be coded (refer
to the table below)
HighFreqLevel [-dBm] [-dBm] Generation level of the Uint
higher component of the dual
tone, can also be coded (refer
to the table below)
Default Duration [msec] default duration time Uint
[msec] for the tone generation
 3. Ring Types Part

Field Description Size

Number of Ringing The number of Ringing patterns Uint
Patterns Tones exists
Ring type As is Uint
Freq (Hz) Uint
Ring on time First [Burst] ring on time Uint
Ring off time First [Burst] ring off time Uint
State The following ring state Uint
Ring on time Second [Burst] ring on time Uint
Ring off time Second [Burst] ring off time Uint
State The following ring state Uint
Ring on time First [Burst] ring on time Uint
Ring off time Second [Burst] ring off time Uint
State The following ring state Uint
Ring on time First [Burst] ring on time Uint
Ring off time Second [Burst] ring off time Uint
State The following ring state Uint

“Use dbm units for Tone Levels” checkbox

The “Use dbm units for Tone Levels” checkbox enables the user to define the tone
components’ level in [-dbm] units. For CPT Version 3 the checkbox must always be
enabled.

B. Voice Prompts File(s) Design

Field Description Size

Magic Number A predefined value Uint
Offset Points to the first Uint
“Sub magic” value,
calculated from the
beginning of the file
Length Length of file in Uint
bytes, everything but
the checksum
File type As is Uint
AC version As is Uint
Number of Voice Prompts The current number of Uint
Voice Prompts in this
file
The data for each Voice Refer to the table
Prompt, described below
separately
Checksum A standard checksum, An unsigned short (16-
computed by unsigned bit) converted to an
chars [8-bit] into an unsigned int
unsigned short (16-bit)
Voice Prompt Record File Design

Field Description Size

Sub magic A predefined value found before Uint
each record
Offset Points to the beginning of the Uint
current Voice Prompt data,
counting from the current “Sub
magic”
Length Size of the current Voice Uint
Prompt data
Id A serial number (unique, Uint
incremented for each Voice
Prompt)
Coder A predefined value describing Uint
the current coder used
Description A general description Char[20]
Data As is Changeable, may
vary from one
Voice Prompt to
another

C. CAS File Design

Note: All CAS files processed by the TrunkPack Downloadable Conversion Utility go through
a utility called “CPP” (as a part of the conversion process).
This program is not an internal part of the DConvert, rather an external utility.
Therefore, to execute any CAS files, ensure that the CPP utility is located in the same
directory as the directory in which the DConvert is located.
Ensure that you have also the file “cassetup.h”, which is required by CPP, located in
the same directory.

Field Description Size

Magic Number A predefined value Uint
Offset Size of offset Uint [offset value is 37,
(32-bit, from the computed as
beginning of the 1+1+1+1+1+8+1+1+8+8+1+1+1+1+1+1]
file pointing to
the data file
size)
Length Length of file in Uint
bytes, not
including the
checksum
File type As is Uint
AC version As is Uint
Vendor As is Char[32]
Hi version x. Uint
Low version .x Uint
Version description As is Char[32]
Date + time The date and time Char[32]
the file was
created
Header version The header format Uint
version
 Field Description Size
Number of states As is Uint
Number of events As is Uint
Number of elements As is Uint
T.B.D(1) As is Uint
T.B.D.(2) As is Uint
Data file size The size of the Uint
data written (in
ints, not chars)
File data The output of the Uint
text file (three Data file size
dimension array
written)
Checksum A standard An unsigned short (16-bit)
checksum, computed converted to an unsigned int
by unsigned
chars[8-bit] into
an unsigned short
(16-bit)

D. VXML File design

Field Description Size

Magic Number A predefined value Uint
Offset Points to the first Uint
“Sub magic” value,
calculated from the
beginning of the
file
Length Length of file in Uint
bytes,everything
but the checksum
File type As is Uint
AC version As is Uint
Number of files The current number Uint
of Vxml data files
in this file
Here comes the data Found one table
for each Vxml, below
described separately
Checksum A standard An unsigned short
checksum, computed (16-bit) converted
by unsigned to an unsigned int
chars[8-bit] into a
unsigned short (16-
bit)
VXML Record File Design

Field Description Size

Sub magic A predefined value found Uint
before each record
Offset points to the beginning of the Uint
current Vxml data, counting
from the current “Sub magic”
Length Size of the current Vxml data Uint
Id A serial number (unique, Uint
incremented for each Vxml
file)
Data As is Vxml data