Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions codeless banner

[Previous: Modem Emulator] [Next: Modem Emulator - Control and Status]

Modem Emulator - Call Control

The AT commands in this section are used for dialing, accepting, and manipulating voice and data calls.

AT+BLDN Bluetooth Last Dialed Number

The AT+BLDN command is used by Bluetooth hands-free (HF) devices to request that the last number dialed be re-dialed.

CommandPossible Responses
AT+BLDNOK
AT+BLDNERROR if the device is not a Bluetooth hands-free unit.

Conforms with: Bluetooth Hands-Free Profile 1.5

ATA Answer Incoming Call

The ATA command answers an incoming voice or data call.

CommandPossible Responses
ATA
  • CONNECT [<rate>]: Data call has connected at rate.
  • OK: Voice call has connected.
  • NO CARRIER: Connection could not be established.
  • ERROR: Command issues when already connected.

Conforms with: Recommendation V.250.

ATH Hangup Call

The ATH command hangs up the current connected, dialing, or incoming call. The AT+CHLD command is recommended instead for voice calls.

CommandPossible Responses
ATH[<n>]
  • OK
  • ERROR

If the parameter <n> is present, it must be zero.

Conforms with: Recommendation V.250.

ATO Return to Online Data State

The ATO command returns to the online data state if a data call is currently in progress.

CommandPossible Responses
ATO[<n>]
  • OK
  • ERROR

The parameter <n> is ignored in this implementation. If it is present, it should be zero according to Recommendation V.250.

Conforms with: Recommendation V.250.

AT+CBST Select Bearer Service Type

The AT+CBST command is used to select the GSM data bearer.

CommandPossible Responses
AT+CBST=[<speed>[,<name>[,<ce>]]]OK
AT+CBST?+CBST: <speed>,<name>,<ce>
AT+CBST=?+CBST: (list of supported <speed>s), (list of supported <name>s), (list of supported <ce>s)

Set command selects bearer <name> with data rate <speed>, and the connection element <ce> to be used when data calls are originated. See 3GPP TS 27.007 for more information on the valid values for these parameters.

Conforms with: 3GPP TS 27.007.

AT+CLCC List Current Calls

The AT+CLCC command lists the calls that are currently active within the system.

CommandPossible Responses
AT+CLCC
    +CLCC: <id1>,<dir>,<stat>,<mode>,<mpty>[,<number>,<type>[,<alpha>[,<priority>]]]
    +CLCC: <id2>,<dir>,<stat>,<mode>,<mpty>[,<number>,<type>[,<alpha>[,<priority>]]]
    ...

<id>Integer identifier for the call.
<dir>Direction of the call: 0 = outgoing MO, 1 = incoming MT.
<stat>State of the call:
  • 0 active
  • 1 held
  • 2 dialing (MO call)
  • 3 alerting (MO call)
  • 4 incoming (MT call)
  • 5 waiting (MT call)
<mode>Bearer/teleservice:
  • 0 voice
  • 1 data
  • 2 reserved for future use: fax
  • 3 voice followed by data, voice mode
  • 4 alternating voice/data, voice mode
  • 5 reserved for future use: alternating voice/fax, voice mode
  • 6 voice followed by data, data mode
  • 7 alternating voice/data, data mode
  • 8 reserved for future use: alternating voice/fax, fax mode
  • 9 unknown - used to indicate video calls
<mpty>Multiparty indicator: 1 = multi-party, 0 = no multi-party.
<number>String type phone number of calling address in format specified by <type>.
<type>Type of address octet in integer format (refer 3GPP TS 24.008).
<alpha>String indicating the name of a phonebook entry corresponding to <number>. Usually this is empty.
<priority>Digit indicating eMLPP priority level of incoming call (refer 3GPP TS 22.067).

Conforms with: 3GPP TS 27.007.

AT+CHLD Call Hold And Multiparty

The AT+CHLD command is used to control call hold, release, and multiparty states.

CommandPossible Responses
AT+CHLD=[<n>]
  • OK
  • +CME ERROR: <err>
AT+CHLD=?+CHLD: (0-4,11-19,21-29)

The parameter <n> is an integer value in accordance to 3GPP TS 22.030:

<n>Description
0Release all held calls or set the busy state for the waiting call.
1Release all active calls.
1xRelease only call x.
2Put active calls on hold and activate the waiting or held call.
2xPut active calls on hold and activate call x.
3Add the held calls to the active conversation.
4Add the held calls to the active conversation, and then detach the local subscriber from the conversation.

GSM modems typically cannot support more than 7 or 8 calls at once. This implementation can support up to 99 calls using two-digit call identifiers for x between 10 and 99. Test command only reports 9 call identifiers for backwards compatibility with existing client software.

Conforms with: 3GPP TS 27.007, 22.030.

AT+CHUP Hangup Call

The AT+CHUP command is an alias for ATH.

CommandPossible Responses
AT+CHUP
  • OK
  • ERROR

Conforms with: 3GPP TS 27.007.

AT+CMOD Call Mode

The AT+CMOD command is used to select the call mode of further dialing commands (D) or for the next answering command (A). The mode can be either single or alternating.

CommandPossible Responses
AT+CMOD=[<mode>]
AT+CMOD?+CMOD: <mode>
AT+CMOD=?CMOD:(list of supported <mode>s)

+CMOD shall be set to zero after a successfully completed alternating mode call. It shall be set to zero also after a failed answering. The power-up, factory (&F) and user-reset (Z) commands shall also set teh value to zero. This reduces the possibility that an alternating mode call could be originated or answered accidentally.

Possible values for <mode> are:

0Single mode (default)
1Reserved for future use: Alternating voice/fax (teleservice 61)
2Alternating voice/data (bearer service 61)
3Voice followed by data (bearer service 81)

Conforms with: 3GPP TS 27.007.

AT+CSDF Settings Date Format

The AT+CSDF command sets the date format via MMI of the date information presented to the user. It also sets the date format of the TE-TA interface, and therefore affects the <time> of +CCLK and +CALA.

CommandPossible Responses
AT+CSDF=[[<mode>][,<auxmode>]]+CME ERROR: <err>
AT+CSDF?
  • +CSDF:<mode>[,<auxmode>]
  • +CME ERROR: <err>
AT+CSDF=?+CSDF:(list of supported <mode>s) [,(list of supported <auxmode>s)]

The <mode> parameter can take the following values:

ValueDate Format
1DD-MMM-YYYY
2DD-MM-YY
3MM/DD/YY
4DD/MM/YY
5DD.MM.YY
6YYMMDD
7YY-MM-DD
8DDD/MMM/YY
9DDD/MMM/YYYY

The <auxmode> parameter can take the following values:

Conforms with: 3GPP TS 27.007.

/sa AT+CCLK, AT+CALA

AT+CSIL Silence Command

The AT+CSIL command enables or disables silent mode. When the phone is in silent mode, all sounds from MT are suppressed except voice.

CommandPossible Responses
AT+CSIL=[<mode>]+CME ERROR: <err>
AT+CSIL?
  • +CSIL: <mode>
  • +CME ERROR: <err>
AT+CSIL=?
  • +CSIL:(list of supported <mode?s)
  • +CME ERROR: <err>

<mode> can be either 0 (silent mode off) or 1 (silent mode on).

Conforms with: 3GPP TS 27.007.

AT+CSNS Single Number Scheme

The AT+CSNS command queries or selects the bearer or teleservice to be used when a mobile terminated, single numbering scheme call is established. If <mode> equals 4 ("data service"), the parameter values set with AT+CBST command shall be used.

CommandPossible Responses
AT+CSNS=[<mode>]
AT+CSNS?+CSNS: <mode>
AT+CSNS=?+CSNS:(list of supported <mode>s)

The following values are defined for <mode>:

0Voice (default)
1Reserved for future use: Alternating voice/fax - voice first
2Reserved for future use: Facsimile
3Alternating voice/data - voice first
4Data
5Reserved for future use: Alternating voice/fax - fax first
6Alternating voice/data - data first
7Voice followed by Data

Conforms with: 3GPP TS 27.007.

AT+CSTA Select type of address

The AT+CSTA command selects the type of number for dialing with the ATD command. This implementation only supports 129. If a dial string starts with +, then 145 will be implicitly selected. No other dial number types are supported.

CommandPossible Responses
AT+CSTA=[<type>]OK, +CME ERROR: 3
AT+CSTA?+CSTA: 129
AT+CSTA=?+CSTA: (129)

Conforms with: 3GPP TS 27.007.

AT+CSTF Settings Time Format

The AT+CSTF command sets the time format of the time information presented to the user.

CommandPossible Responses
AT+CSTF=[<mode>]+CME ERROR: <err>
AT+CSTF?
  • +CSTF: <mode>
  • +CME ERROR: <err>
AT+CSTF=?
  • +CSTF:(list of supported <mode>s)
  • +CME ERROR: <err>

This command has no effect in our current implementation.

Conforms with: 3GPP TS 27.007.

AT+VTD Tone Duration

The AT+VTD command can be used to define the length of tones emitted as a result of the AT+VTS command.

CommandPossible Responses
AT+VTD=<n>+CME ERROR: 3
AT+VTD?+VTD: <n>
AT+VTD=?+VTD: (0-255)

According to 3GPP TS 27.007, section C.2.12, the tone duration can only be queried, and never set. This implementation always returns zero to indicate "manufacturer specific".

Conforms with: 3GPP TS 27.007.

AT+VTS DTMF and Tone Generation

The AT+VTS command can be used to generate DTMF tones during a voice call.

CommandPossible Responses
AT+VTS=<tones>OK
AT+VTS=?+VTS: (0-9,*,#,A,B,C,D)

The <tones> parameter is a string containing the digits to be sent as DTMF tones. The dual tone frequencies and tone duration parameters from 3GPP TS 27.007 are not supported.

Conforms with: 3GPP TS 27.007.

AT+COPN Read Operator Names

This command returns the list of operator names from the MT. Each operator code that has an alphanumeric equivalent in the MT memory shall be returned.

CommandPossible Responses
AT+COPN+COPN: <numeric1>,<alpha1> [<CR><LF>+COPN: <number2><alpha2> [...]]
AT+COPN=?

Conforms with: 3GPP TS 27.007.

ATD Dial Call

The ATD command initiates a dial for a voice or data call.

CommandPossible Responses
ATDdialstring[i][;]
  • CONNECT [<rate>]: Data call has connected at rate.
  • OK: Voice call has connected.
  • NO CARRIER: Connection could not be established.
  • BUSY: Called party is busy.
  • ERROR: Command issues when already connected.

The command name is followed by a string of digits and control characters, according to the following table:

0-9, *, #, +, A, B, C, DDigits to be dialed. In GSM networks, D is ignored, in accordance with 3GPP TS 27.007.
,Insert a pause into the dialing sequence.
T, PSelect tone or pulse dialing. These are ignored.
!Insert a hook flash into the dialing sequence. This is ignored in GSM networks.
WWait for dial tone. This is ignored in GSM networks.
@Wait for quiet answer. This is ignored in GSM networks.
;This must be last character in the dialing string, and indicates a voice call rather than a data call. The system will issue OK and immediately return to command mode.
iAllow the local user's caller ID information to be presented to the called party.
ISuppress the local user's caller ID information from being presented to the called party.

If the dialing sequence begins with >, then the rest of the sequence, up until the semi-colon, is interpreted as a name in a direct-dialing phonebook. This will only work with GSM modems that support the feature. Dialing by explicit number is recommended.

If the system has been configured with support for VoIP, then VoIP calls can be placed with the ATD command by using the full URI of the called party. For example: ATDsip:fred@example.com;.

Conforms with: Recommendation V.250, 3GPP TS 27.007.

[Previous: Modem Emulator] [Next: Modem Emulator - Control and Status]


Copyright © 2009 Trolltech Trademarks
Qt Extended 4.4.3