Vts - send voice tone(s), Syntax, Defined values – Longshine LCS-8056C2 User Manual

Page 139

Advertising
background image

Commands for Host-Processed Modems Reference Manual

100498E

Conexant

5-7

+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