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

[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.

Command	Possible Responses
`AT+BLDN`	`OK`
`AT+BLDN`	`ERROR` 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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
0	Release all held calls or set the busy state for the waiting call.
1	Release all active calls.
1x	Release only call `x`.
2	Put active calls on hold and activate the waiting or held call.
2x	Put active calls on hold and activate call `x`.
3	Add the held calls to the active conversation.
4	Add 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.

Command	Possible 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.

Command	Possible 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:

0	Single mode (default)
1	Reserved for future use: Alternating voice/fax (teleservice 61)
2	Alternating voice/data (bearer service 61)
3	Voice 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.

Command	Possible 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:

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

The <auxmode> parameter can take the following values:

1 yy/MM/dd (default)
2 yyyy/MM/dd

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.

Command	Possible 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.

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

The following values are defined for <mode>:

0	Voice (default)
1	Reserved for future use: Alternating voice/fax - voice first
2	Reserved for future use: Facsimile
3	Alternating voice/data - voice first
4	Data
5	Reserved for future use: Alternating voice/fax - fax first
6	Alternating voice/data - data first
7	Voice 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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.

Command	Possible 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, D`	Digits to be dialed. In GSM networks, `D` is ignored, in accordance with 3GPP TS 27.007.
`,`	Insert a pause into the dialing sequence.
`T`, `P`	Select tone or pulse dialing. These are ignored.
`!`	Insert a hook flash into the dialing sequence. This is ignored in GSM networks.
`W`	Wait 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.
`i`	Allow the local user's caller ID information to be presented to the called party.
`I`	Suppress 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]

Trademarks

Qt Extended 4.4.3