Table 9. AT Voice Command Description
- Command
|
- Function
|
- ATA
|
- Answering in Voice
- This command works similarly to the way it works in Data and Fax Modes.
- Result Code: VCON
|
- ATD
|
- Dial Command in Voice
- This command will perform the dial action in Voice Mode.
- Result Codes:
- VCON
- Issued in Voice Mode when the modem determines that the remote modem or handset has gone
off-hook.
- NO ANSWER
- Issues in Voice Mode when the modem determines that the remote has not picked up the
line before the S7 timer expires.
|
- ATH
|
- Hang Up in Voice
- This command works the same as in Data and Fax modes by hanging up the phone line.
- 1. This command forces the #CLS=0, but does not destroy any of the voice parameter
setting such as #VBS, #VSP, etc.
- 2. The #BDR setting is forced back to 0.
|
- ATZ
|
- Reset from Voice Mode
- This command works the same as in Data and Fax modes. In addition, it will also reset
all voice related parameters to default states, forces the #BDR=0 condition, and forces
the telephone line to be selected with the handset on-hook.
|
- #BDR
|
- Select Baud Rate (Turn Off Autobaud)
- This command select a specific DTE/modem baud rate.
- Parameters: n = 0 - 48 (Baud Rate = n * 2400 bps)
- Default: 0
- Result Codes:
- OK if n is between 0 and 48
- ERROR Otherwise
- Command options:
- #BDR? Return the current setting
- #BDR=? Return a message indicating the speeds that are supported
- #BDR=0 Enable autobaud detection on the DTE interface
- #BDR=n Select the baud rate
|
- #CID
|
- Enable Caller ID Detection and Select Reporting Format
- This command enables or disables Caller ID recognition and reporting in any mode.
- Parameters: n = 0, 1, or 2
- Default: 0
- Result Codes: OK n = 0, 1, or 2
- ERROR Otherwise
- Command Options:
- #CID? Return the current setting (0, 1, or 2)
- #CID=? Return the message, "0-2"
- #CID=0 Disables Caller ID
- #CID=1 Enable formatted Caller ID reporting of SDM (Single Data Message) and MDM
(Multiple Data Message) packets.
- #CID=2 Enable unformatted Caller ID reporting.
|
- #CLS
|
- Select Data, Fax, or Voice
- This command select Data, Fax, or Voice Mode
- Parameters: n=0, 1, 2, or 8
- Default: 0
- Result Codes: OK if n = 0, 1, 2, or 8
- ERROR Otherwise
- Command options:
- #CLS? Return the current setting (0, 1, 2, or 8)
- #CLS=? Return the message, "0, 1, 2, 8"
- #CLS=0 Select Data Mode.
- #CLS=1 Select Class 1 Fax Mode.
- #CLS=2 Select Class 2 Fax Mode.
- #CLS=8 Select Voice Mode.
|
- #MDL
|
- Identify Model
- This command identifies the model number of the modem.
- Command option:
- #MDL? "PCT288DFV"
|
- #MFR?
|
- Identify Manufacturer
- This command identifies the modem manufacturer.
- Command option:
- #MFR? "PCtel"
|
- #REV?
|
- Request Revision Level
- This command request the revision number of PCtel Driver.
- #REV? "PCtel 2.00"
|
- #RG
|
- Record Gain Control
- This command sets the record gain.
- Parameters: n = 0000 - 7FFF
- Default: 7FFF
- Result Codes:
- OK if n = 0000 - 7FFF
- ERROR Otherwise
- Command options:
- #RG? Return the current setting
- #RG=? Return the message, "0000-7FFF"
- RG=n Set the record gain to n
|
- #SPK
|
- Change the setting of Speakerphone
- This command set the parameters for speakerphone.
- Parameters: #SPK=<mute>, <spk>, <mic>
- <mute> Microphone state
- 0 microphone mute
- 1 microphone on (default)
- 2 Room Monitor mode (mic on max. AGC, speaker off)
- <spk> Speaker Output Level
- Range: 0 to 15 (speaker attenuation in 2 dB steps)
- Default: 5 (10 dB attenuation) Speaker mute is achieve by a value of 16
- <mic> Microphone Gain Parameter
- 0 0 dB
- 1 6 dB gain (default)
- 2 9.5 dB gain
- 3 12 dB gain
- Command options:
- It is not necessary to enter all three parameters,
- #SPK=,<spk>,<mic>
- #SPK=,,<mic>
|
- #TL
|
- Transmit Level Control
- This command sets the transmit level.
- Parameters: n = 0000 - 7FFF
- Default: 3FFF
- Result Codes: OK if n = 0000 - 7FFF
- ERROR Otherwise
- Command options:
- #TL? Return the current setting
- #TL=? Return the message, "0000-7FFF"
- #TL=n Set the record gain to n
|
- #VBQ?
|
- Query Buffer Size
- This command query the modems voice transmit and voice receive buffers size.
- Parameters: None
- Command option:
- #VBQ? Return the size of buffers.
|
- #VBS
|
- Bits Per Sample (Compression Factor)
- This command selects the degree of ADPCM voice compression to be used.
- Parameters: n = 4 (Only 4 bits per sample compression ratio is supported)
- Default: 4
- Result Codes: OK if n = 4
- ERROR Otherwise
- Command options:
- #VBS? Return the current setting
- #VBS=? Return "4"
- #VBS=4 Selects 4 bits per samples.
|
- #VBT
|
- Beep Tone Timer
- This command sets the duration for DTMF tone generation
- Parameters: n = 0 - 40 ( duration = n /10 seconds)
- Default: 10
- Result Codes:
- OK if n = 0 - 40
- ERROR Otherwise
- Command options:
- #VBT? Return the current setting
- #VBT=? Returns the message, "0-40"
- #VBT=0 Disables the tone generation capability.
- #VBT=n Sets tone duration
|
- #VCI?
|
- Identify Compression Method
- This command identifies the compression method used by the modem.
- Parameter: None
- Command option:
- #VCI? Returns the message, "PCtel;ADPCM;32"
|
- #VLS
|
- Voice Device Selection
- This command select which devices is routed through the modem.
- Parameter: n = 0, 1, 2, 3, 4, or 6
- Default: 0
- Result Codes:
- OK if n = 0, 1, 2, 3, 4, or 6
- ERROR Otherwise
- Command options:
- #VLS? Return current setting
- #VLS=? Return the device types supported by the modem.
- #VLS=n Select Device Type (see table below)
Device Type Device Description
0 Phone Line with Telephone handset
1 Handset
2 On-Board Speaker
3 Microphone
4 Telephone line with on-board speaker ON and handset
6 Speaker Phone
|
- #VRA
|
- Ringback Goes Away Timer (Originate)
- When originate a voice call, this command can set the "Ringback Goes Away"
timer value, an amount of time measures from when the ringback cadence stops once
detected. If ringback is not detected within this period, the modem assumes that the
remotes has picked up the line and switches to Online Voice Command Mode. Every time a
ringback cadence is detected, this timer is reset.
- Parameters: n = 0 - 255 (0 - 2.55 seconds)
- Default: 70
- Result Codes:
- OK if n = 0 - 255
- ERROR Otherwise
- Command options:
- #VRA? Return the current setting
- #VRA=? Return the message, "0-255"
- #VRA=0 Turn off the timer. The dialing modem sends VCON and enters Online Voice Command
Mode after one ringback.
- #VRA=n Set the timer (timer = n * 0.01 seconds)
|
- #VRN
|
- Ringback Never Came Timer (Originate)
- When originating a voice call, this command set the "Ringback Never Came"
timer value, an amount of time measured from completion of dialing. If ringback is not
detected within this period, the modem assumes the remote has picked up the line and
switches to Online Voice Command Mode.
- Parameters: n = 0 - 255 (0 - 2.55 seconds)
- Result Codes:
- OK if n = 0 - 255
- ERROR Otherwise
- Command option:
- #VRN? Return the current setting
- #VRN=? Return the message, "0-255"
- #VRN=0 Turn off the "Ringback Never Came timer". After dialing, the modem
sends VCON and enters Online Voice Command Mode immediately.
- #VRN=n Set the timer (duration = n * 0.01 second)
|
- #VRX
|
- Voice Receive
- This command set the modem in Voice Receive Mode.
- Parameters: None
- Result Codes:
- CONNECT When voice transfer from modem to DTE can begin
- ERROR if #VLS=0 and not connected to any input device
|
- #VSD
|
- Silence Deletion Tuner (Voice Receive)
- This command can enable/disable Voice Receive Mode silence detection. Silence Deletion
is not supported in PCtel HSP Modem.
- Parameters: n = 0
- Default: 0
- Result Codes:
- OK if n = 0
- ERROR Otherwise
- Command options:
- #VSD? Return current setting
- #VSD=? Return the message, "0"
- #VSD=0 Disable Silence Deletion
|
- #VSK
|
- Buffer Skid Setting
- This command queries and sets the number of bytes of spare space, after the XOFF
threshold is reached, in the modems buffer during Voice Transmit Mode. This equates to the
"skid" spare buffer space, or the amount of data the DTE can continue to send
after being told to stop sending data by the modem, before the modem voice transmit buffer
overflows.
- Parameters: n = 0 - 255
- Default: 255
- Result Code:
- OK if n = 0 - 255
- ERROR Otherwise
- Command options:
- #VSK? Return the current setting
- #VSK=? Return the message, "0-255"
- #VSK=n Set the skid buffer size to n bytes
|
- #VSP
|
- Silence Detection Period (Voice Receive)
- This command sets the Voice Receive Mode silence detection period value. If the modem
does not receive any ADPCM data after the timer expired, it will cause the modem to send
<DLE>s or <DLE>q codes.
- Parameters: n = 0 - 255 (0 - 25.5 seconds)
- Default: 55
- Result Code:
- OK if n = 0 - 255
- ERROR Otherwise
- Command options:
- #VSP? Return current setting
- #VSP=? Return the message, "0-255"
- #VSP=0 Disable the silence period detection timer
- #VSP=n timer = n * 0.1 second
|
- #VSR
|
- Sampling Rate Selection
- This command sets the audio codec sampling rate.
- Parameters: n = 8000 (8000 Hz sampling rate)
- Default: 8000
- Result Codes: OK if n = 8000
- ERROR Otherwise
- Command options:
- #VSR? Return the current setting
- #VSR=? Return the message, "8000"
- #VSR=8000 Set the sample rate to 8000
|
- #VSS
|
- Silence Sensitivity Tuner (Voice Receive)
- This command set the sensitivity in Voice Receive Mode silence detection.
- Parameters: n = 0 - 3
- Default: 2
- Result Codes:
- OK if n = 0 -3
- ERROR Otherwise
- Command options:
- #VSS? Return current setting
- #VSS=? Return the message, "0-3"
- #VSS=0 Disable silence detection by the modem in Voice Receive Mode
- #VSS=1 Least sensitive setting #VSS=2 Medium sensitive setting
- #VSS=3 Most sensitive setting
|
- #VTD
|
- Tone Reporting Capability
- This command sets which types of tones can be detected and reported to the DTE via
shielded codes in Voice Transmit, Voice Receive, and Online Voice Command Modes.
- Parameters: i, j, k
- Default: 3F, 3F, 3F
- Result Codes:
- OK if setting are supported by the modem.
- ERROR Otherwise
- Command options:
- #VTD? Return current setting
- #VTD=? Returns the tone reporting capabilities of the modem.
- #VTD=i,j,k Where i, j, k corresponds to the desired capabilities (see table below), i
for Voice Transmit, j for Voice Receive, and k for Online Voice Command Modes.
Bit Description
0 0/1=Disable/Enable DTMF tone capability
1 0/1=Disable/Enable V.25 1300 Hz Calling tone capability
2 0/1=Disable/Enable V.30 1100 Hz Facsimile Calling tone
capability
3 0/1=Disable/Enable V.25/T.30 2100 Hz Answer tone capability
4 0/1=Disable/Enable Bell 2225 Hz Answer tone capability
5 0/1=Disable/Enable call progress tone and cadence
tone capability
|
- #VTS
|
- Play Tone String (Online Voice Command Mode)
- This command can play one or more DTMF or other tones. No key abort is allowed.
- Dual or Single Tones:
- These are represented by a substring enclosed in square brackets ("[ ]")
within the parameter. Each such substring consists of three sub-elements corresponding to
2 frequencies in Hertz (0, or 2000-3000) and a duration (ASCII decimal in units of 100ms).
- Varying DTMF Digits:
- This is represented by a substring enclosed in curly braces ("{ }") within the
parameter. Each such substring consists of two sub-elements corresponding to a DTMF digits
(0-9, A-D, *, #), and alternate duration in units of 100ms.
- Parameters:
- The tone generation consists of elements in a list with each element separated by
commas.
- Result Codes:
- OK Command to play tones on currently selected device is accepted.
- ERROR Command was not issued in Online Voice Command Mode or string is grammatically
incorrect.
|
- #VTX
|
- Voice Transmit
- This command set the modem in Voice Transmit Mode. The #VLS command should have been
previously issued correctly.
- Parameters:
- None
- Result Codes:
- CONNECT When voice transmission by DTE can begin.
- ERROR If #VLS=0 and output device is not connected.
|