Vts - Send Voice Tone(S) - Conexant H08-15355F Reference Manual

5.2.2.4 +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:
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.
Reporting Supported Range of Parameter Values
Command: +VTS=?
Response: (<freq1> range), (<freq2> range), (<dur> range)
Example: (200-3000),(200-3000),(0-255)
OK
Result Codes
OK Valid command.
ERROR The <string> command is invalid, or a selected frequency is out of range.
5-6
Command Reference Manual
(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,
Conexant
1118