Comtrol AT Commands for SmartACFL User Manual

Page 150

Advertising
background image

Command Reference Manual

6-6

Conexant

100722A

6.2.2.3 +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.

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.

Advertising
This manual is related to the following products: