Telenetics 56 User Manual

Page 192

Advertising
background image

AT Commands

Page 184

+VTS - Send Voice Tone(s)

This command causes the modem to send DTMF digit or hookflash tones with the
duration specified by +VTD, to send DTMF digit or hookflash tones with
duration specified by this command, or to send single or dual tone frequencies
with duration specified with this command.

Syntax

+VTS=<string>

Defined Values

<string> The tone generation consists of elements in a list where each

element is separated by a comma. Each element can be:

1. A single character which the modem interprets as

a DTMF digit (0 - 9, #, *, or A-D) or hookflash (!),
with a duration given by the +VTD command.

2. A 3-element string enclosed in square brackets,

"[freq1,freq2,dur]", which the modem interprets as
a general dual tone and duration selection, or

3. A 2-element string enclosed in curly braces,

"{X,dur}", which the modem interprets as a DTMF
digit (0 - 9, #, *, or A-D), or hookflash (!) with a
duration (dur) different than that given by the +VTD
command.

Missing subparameters assume the default value. Unspecified values always
default to zero for frequencies, DTMF * for DTMF tones, and +VTD for duration.
The omission of commas (and associated subparameters) are valid.

The quantity in the square brackets consists of a 3-element list (freq1,freq2,dur),
which can be used to send single or dual tones. The first element is the first
frequency (freq1) with range 0 or 200-3000 Hz. The second element is the second
frequency (freq2), with range 0 or 200-3000 Hz. The third element is the duration
(dur) in 0.01 second intervals with range 0-255 (ASCII units of 10 ms). A list may
contain null elements. For example [3000] means that the DCE generates a single
tone at 3000 Hz for the default duration, [3000,3300] means that the DCE
generates a dual tone at 3000 and 3300 Hz for the default duration, and [,3300]
means that the DCE generates a single tone at 3300 Hz for the default duration.

The quantity in the curly braces consists of a 2-element list (X,dur), which can be
used to send DTMF tones or hookflash. The first element is the DTMF tone or
hookflash (!) character (X), and the second element is the duration (dur) in 0.01
seconds. The characters are of the same set given above. A list may contain null
elements. For example, {2} means DTMF tone "2" for the default duration, and
{} means silence for the default duration.

The modem will stop the tone generation at the point in the string where the
modem detects a parsing error, encounters an invalid frequency range, encounters
a <CR>, or encounters a semi-colon.

Advertising