Specify Tone Parameters for Global Tone Detection

$global_tone line toneid parmlist

The syntax for this command depends on whether the line hardware is Dialogic or Dialogic Diva. For the latter, a $global_tone_parms command is also required.

This command specifies a tone which is recognized during CopiaFacts operations and can be used for application purposes, for example for detecting a specific answering machine type. To determine the parameters to enter, it is easiest to prepare a recording of the tone in a VOX or WAV file use a utility such as Adobe Audition (formerly CoolEdit 2000) to analyze the frequencies.

The parameters on this command are used as follows:

line the line number or line group(s) affected, or * for all lines. Up to 32 tones may be defined for each line.
toneid The tone ID number to identify the tone (a value 1 to 32).  Note that each Dialogic board can support a different number of tones per channel.  For some older boards, this number is substantially less than 32. For Dialogic Diva boards, CopiaFacts will analyze up to 32 separate tones.
parmlist a list of nine (Dialogic) or two (Dialogic Diva) white-space-separated values as follows:
freq1 the first or only tone frequency in Hz.
fq1dev the deviation of the above tone in Hz. This is currently the last of the parameters used for Dialogic Diva boards.
freq2 the second tone frequency in Hz of a dual tone (or zero for a single tone)
fq2dev the deviation of the above tone in Hz (or zero for a single tone)
ontime the cadence on-time in 10ms units. If the tone is continuous, enter here half the minimum time value.
ontdev the cadence on-time deviation in 10ms units. If the tone is continuous, enter here minus half the minimum time value.
offtime the cadence off-time in 10ms units. If the tone is continuous, enter zero.
offtdev the cadence off-time deviation in 10ms units. If the tone is continuous, enter zero.
repcnt the cadence minimum repetition count. If the tone is continuous, enter zero.

To enable tone detection, assign values to the GTD_CHECK system variable. When a tone is detected, the tone ID is returned in the GTD_TONEID variable.

Hardware Issues: Dialogic or Dialogic Diva only

Example:

Specify a continuous single tone of 375Hz with a minimum time of .2 seconds (Dialogic):

$global_tone * 1 375 20 0 0 10 -10 0 0 0

Specify a single tone of between 372Hz and 378Hz (Dialogic Diva):

$global_tone * 1 375 3