voice-cmds.html

VoiFax is a program that manage voice/data/fax modem in the same manner of vgetty and mgetty.VoiFax

Result Code:
<dl><dt>VCON </dt><dd>Issued in Voice Mode (#CLS=8) immediately after going off-hook.
</dd></dl>


<table border="1">
<caption>Table 8-4.  AT Voice Commands</caption>
<tbody><tr><th> Command
</th><th> Function
</th></tr><tr><td> A
 </td><td>Answering in Voice Mode.

</td></tr><tr><td> D
 </td><td>Dial command in Voice Mode.

</td></tr><tr><td> H
 </td><td>Hang up in Voice Mode.

</td></tr><tr><td> Z
 </td><td>Reset from Voice Mode.

</td></tr><tr><td> #BDR
 </td><td>Select baud rate (turn off autobaud).

</td></tr><tr><td> #CID
 </td><td>Enable Caller ID detection and select reporting format.

</td></tr><tr><td> #CLS
 </td><td>Select data, fax, or voice.

</td></tr><tr><td> #MDL?
 </td><td>Identify model.

</td></tr><tr><td> #MFR?
 </td><td>Identify manufacturer.

</td></tr><tr><td> #REV?
 </td><td>Identify revision level.

</td></tr><tr><td> #VBQ?
 </td><td>Query buffer size.

</td></tr><tr><td> #VBS
 </td><td>Bits per sample (ADPCM).

</td></tr><tr><td> #VBT
 </td><td>Beep tone timer.

</td></tr><tr><td> #VCI?
 </td><td>Identify compression method (ADPCM).

</td></tr><tr><td> #VLS
 </td><td>Voice line select (ADPCM).

</td></tr><tr><td> #VRA
 </td><td>Ringback goes away timer (originate).

</td></tr><tr><td> #VRN
 </td><td>Ringback never came timer (originate).

</td></tr><tr><td> #VRX
 </td><td>Voice Receive Mode (ADPCM)

</td></tr><tr><td> #VSD
 </td><td>Silence deletion tuner (voice receive, ADPCM).

</td></tr><tr><td> #VSK
 </td><td>Buffer skid setting.

</td></tr><tr><td> #VSP
 </td><td>Silence detection period (voice receive, ADPCM).

</td></tr><tr><td> #VSR
 </td><td>Sampling rate selection (ADPCM).

</td></tr><tr><td> #VTD
 </td><td>DTMF/tone reporting capability.

</td></tr><tr><td> #VTX
 </td><td>Voice Transmit Mode (ADPCM).
</td></tr></tbody></table>

<h5>ATD - Dial Command in Voice</h5>

The dial action command works analogously to the way it works in Data or
Fax modes. When in Voice Mode (#CLS=8):
<ol>
<li>The modem attempts to determine when the remote has picked up the
telephone line and once this determination has been made,
the VCON message is sent to the DTE. This determination is initially made
based upon ringback detection and disappearance.
(See #VRA and #VRN commands.)

</li><li>Once connected in Voice Mode, the modem immediately enters the command
state and switches to Online Voice Command Mode which
enables unsolicited reporting of DTMF and answer tones to the DTE.
</li></ol>

Parameters: Same as Data and Fax modes.<p>

Result Codes:</p><p>
</p><dl><dt>VCON </dt><dd>Issued in Voice Mode (#CLS=8) when the modem determines that the
remote modem or handset has gone off-hook, or when returning
to the Online Voice Command Mode. (See #VRA and #VRN.)

</dd><dt>NO ANSWER </dt><dd>Issued in Voice Mode (#CLS=8) when the modem determines
that the remote has not picked up the line before the S7
timer expires.
</dd></dl>

<h5>ATH - Hang Up in Voice</h5>

This command works the same as in Data and Fax modes by hanging up
(disconnecting) the telephone line. There are, however,
some specific considerations when in Voice Mode:
<ol>
<li>The H command forces #CLS=3D0, but does not destroy any of the voice
parameter settings such as #VBS, #VSP, etc. Therefore,
if the DTE wishes to issue an H command and then pursue another voice call,
 it must issue a subsequent #CLS=8 command, but
it needn't reestablish the voice parameter settings again unless a change
in the settings is desired.

</li><li>The #BDR setting is forced back to 0, re-enabling autobaud.

</li><li>If the #VLS setting is set to select a device which is not, or does not
include the telephone line (such as a local handset
or microphone), the H command deselects this device and reselects the
normal default setting (#VLS=0). Normally, the DTE should
not issue the H command while connected to a local device such as a handset,
because merely selecting this device results in
VCON. The normal sequence of terminating a session with such a device is to
 use the #VLS command to select the telephone line,
which by definition makes sure it is on-hook.
</li></ol>

Parameters: Same as Data and Fax modes.<p>

Result Codes: Same as Data and Fax modes.</p><p>

</p><h5>ATZ - Reset from Voice Mode</h5>

This command works the same as in Data and Fax modes. In addition, the Z
command resets all voice related parameters to default
states, forces the #BDR=0 condition (autobaud enabled), and forces the
telephone line to be selected with the handset on-hook.
No voice parameters are stored in NVRAM so the profile loaded does not
affect the voice aspects of this command.<p>

Parameters: Same as Data and Fax modes.</p><p>

Result Codes: Same as Data and Fax modes.</p><p>

</p><h5>#BDR - Select Baud Rate (Turn off Autobaud)</h5>

This command forces the modem to select a specific DTE/modem baud rate
without further speed sensing on the interface. When
a valid #BDR=n command is entered, the OK result code is sent at the
current assumed speed. After the OK has been sent, the
modem switches to the speed indicated by the #BDR=n command it has just
received.<p>

When in Online Voice Command Mode and the #BDR setting is nonzero (no
autobaud selected), the modem supports a full duplex
DTE interface. This means that the DTE can enter commands at any time, even
 if the modem is in the process of sending a shielded
code indicating DTMF detection to the DTE. When in Online Voice Command
Mode and the #BDR setting is zero (autobaud selected),
shielded code reporting to the DTE is disabled. [Note that when #BDR has
been set nonzero, the modem employs the S30 Deadman
Timer, and this timer starts at the point where #BDR is set nonzero. If
this period expires (nominally 60 seconds) with no
activity on the DTE interface, the modem reverts to #BDR=0 and #CLS=0.]</p><p>

Parameters: n = 0 - 48 (New baud rate is n*2400 bps)</p><p>

Default: 0</p><p>

Result Codes:
</p><dl><dt>OK </dt><dd>If n = 0 - 48.

</dd><dt>ERROR  </dt><dd>Otherwise.
</dd></dl>

Command options:
<dl><dt>#BDR? </dt><dd>Returns the current setting of the #BDR command as an ASCII
decimal value in result code format.

</dd><dt>#BDR=? </dt><dd>Returns a message indicating the speeds that are supported.

</dd><dt>#BDR=0 </dt><dd>Enables autobaud detection on the DTE interface.

</dd><dt>#BDR=n </dt><dd>Where 1&lt;n&lt;48. Sends OK message at current speed,
then switches to the new speed defined by n*2400 bps unless and until
another #BDR=n command is received. Autobaud is disabled, and the character
format is maintained at the format most recently detected.
</dd></dl>

<h5>#CID - Enable Caller ID Detection and Select Reporting Format</h5>

This command selects or disables Caller ID recognition and reporting in any
 mode.<p>

Parameters: n = 0, 1, or 2</p><p>

Default: 0</p><p>

Result Codes:
</p><dl><dt>OK </dt><dd>n = 0, 1, or 2.

</dd><dt>ERROR  </dt><dd>Otherwise.
</dd></dl>

Command options:
<dl><dt>#CID? </dt><dd>Returns the current setting (0,1 or 2) of the #CID command
as an ASCII decimal value in result code format.

</dd><dt>#CID=? </dt><dd>Returns the message, "0,1,2".

</dd><dt>#CID=0 </dt><dd>Disables Caller ID.

</dd><dt>#CID=1 </dt><dd>Enables formatted Caller ID reporting of ICLID SDM
(Single Data Message) and MDM (Multiple Data Message) packets.

</dd><dt>#CID=2 </dt><dd>Enables unformatted Caller ID reporting of any ICLID
packet received after the first RING cycle including SDM, MDM,
or call waiting packets.
</dd></dl>

<h5>#CLS - Select Data, Fax, or Voice</h5>

This command selects Data, Fax, or Voice Mode from operation in any mode.<p>

Parameters: n = 0, 1, 2, or 8</p><p>

Default: 0</p><p>

Result Codes:
</p><dl><dt>OK </dt><dd>If n = 0, 1, 2, or 8.

</dd><dt>ERROR  </dt><dd>Otherwise.
</dd></dl>

Command options:
<dl><dt>#CLS? </dt><dd>Returns the current setting (0,1,2, or 8) of the #CLS command
as an ASCII decimal value in result code format.

</dd><dt>#CLS=? </dt><dd>Returns the message, "0,1,2,8".

</dd><dt>#CLS=0 </dt><dd>Data. This is similar to setting +FCLASS=0, and instructs
the modem to act like a data modem on subsequent answer or
originate operations.<p>

 When a disconnect or inactivity time out in the non-autobaud mode is
detected, the modem automatically sets the #CLS setting
to 0 and hangs up. This ensures that the modem is always in a known state
despite disorderly DTE behavior.

</p></dd><dt>#CLS=1 </dt><dd>Class 1 fax. This is similar to setting +FCLASS=1,
and instructs the modem to be a Class 1 fax modem. Once this is set,
either the +FAA or +FAE command can be used to force subsequent answers to
be Class 1 adaptive answers.

</dd><dt>#CLS=2 </dt><dd>Class 2 fax. This is similar to setting +FCLASS=2,
and instructs the modem to be a Class 2 fax modem. Once this is set,
the +FAA command can be used to force subsequent answers to be Class 2
adaptive answers.

</dd><dt>#CLS=8 </dt><dd>Voice Mode. This is the main setting the DTE uses to effect
directed or adaptive answer or originate sequences involving
voice modes. All telephone calls initialized by #CLS=8 result (after
answer or successful call progress) in the modem in Online
Voice Command Mode.
</dd></dl>

<h5>#MDL? - Identify Model</h5>

This command requests the model number or name of the modem. (The response
returned may be altered by the OEM via the ConfigurACE
utility program.)<p>

Command option:
</p><dl><dt>#MDL? </dt><dd>-  RC96V24AC
</dd></dl>

<h5>#MFR? - Identify Manufacturer</h5>

This command requests the modem manufacturer. (The response returned may be
 altered by the OEM via the ConfigurACE utility
program.)<p>

Command option:
</p><dl><dt>#MFR? </dt><dd>-  ROCKWELL
</dd></dl>

<h5>#REV? - Identify Revision Level</h5>

This command requests the revision level of the modem. (The response
returned may be altered by the OEM via the ConfigurACE
utility program.)<p>

Command option:
</p><dl><dt>#REV? </dt><dd>- XXXX-XXXX-XXX YYY (Those places occupied by "X"'s represent
the part number, while those places occupied by `Y"'s represent
the revision number. The values are determined at time of production.)
</dd></dl>

<h4>8.3.2. AT#V Commands Enabled Only in Voice Mode (#CLS=8)</h4>

The commands described in the following subsection are extensions to the
command set which the modem recognizes only when configured
for Voice Mode with the #CLS=8 command.<p>

</p><h5>#VBQ? - Query Buffer Size</h5>

This query-only command returns the size of the modem's voice transmit and
voice receive buffers in ASCII decimal, followed
by the OK result code.<p>

Parameters: None</p><p>

Command option:
</p><dl><dt>#VBQ? </dt><dd>Returns the size of the modem voice transmit and voice
receive buffers.
</dd></dl>

<h5>#VBS - Bits Per Sample (Compression Factor)</h5>

This command selects the degree of ADPCM voice compression to be used.<p>

Parameters: n = 2, 3, or 4  (Voice compression bits per sample)</p><p>

Default: 4</p><p>

Result Codes:
</p><dl><dt>OK </dt><dd>If n = 2, 3, or 4.

</dd><dt>ERROR </dt><dd>Otherwise.
</dd></dl>

Command options:
<dl><dt>#VBS? </dt><dd>Returns the current setting of the #VBS command as an ASCII