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

[Previous: Modem Emulator - Call Control] [Next: Modem Emulator - Phonebook Operations]

Modem Emulator - Control and Status

Control and Status

The AT commands in this section are used for controlling state information in the modem and for reporting the current status of the state information.

AT+BRSF Bluetooth Retrieve Supported Features

The AT+BRSF command is used by Bluetooth hands-free (HF) devices to report the features that are supported by the hands-free unit, and to request the phone's audio gateway (AG) feature set.

Command	Possible Responses
`AT+BRSF=<HF supported features bitmap>`	`+BRSF: <AG supported features bitmap>`
`AT+BRSF=<HF supported features bitmap>`	`ERROR` if the device is not a Bluetooth hands-free unit.

Set command is used by the hands-free device to send a bitmap of its supported features to the phone's audio gateway. The audio gateway in turn responds with a separate bitmap of its supported features.

`<HF supported features bitmap>`	Decimal integer containing the following bits: 0 - EC / NR function 1 - Call waiting and 3-way calling 2 - CLI presentation capability. 3 - Voice recognition activation. 4 - Remote volume control 5 - Enhanced call status 6 - Enhanced call control 7-31 - Reserved
`<AG supported features bitmap>`	Decimal integer containing the following bits: 0 - Three way calling 1 - EC / NR function 2 - Voice recognition 3 - In-band ring 4 - Attach a number to voice tag 5 - Ability to reject a call 6 - Enhanced call status 7 - Enhanced call control 8 - Extended error result codes 9-31 - Reserved

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+VGM Gain of Microphone

The AT+VGM command is used by a Bluetooth hands-free (HF) device to report its current microphone gain level setting to the phone's audio gateway (AG).

Command	Possible Responses
`AT+VGM=<gain>`	`OK`
`AT+VGM=<gain>`	`ERROR` if the device is not a Bluetooth hands-free unit.
`AT+VGM?`	`+VGM: <gain>`
`AT+VGM=?`	`+VGM: (0-15)`

<gain> Decimal integer indicating the microphone gain between 0 and 15, where 15 is the maximum gain.

Set command reports the HF's current gain level setting. Get command reports the previous setting. Test command returns the valid gain levels.

The audio gateway may also send unsolicited +VGM: <gain> messages whenever the gain changes on the AG.

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+VGS Gain of Speaker

The AT+VGS command is used by a Bluetooth hands-free (HF) device to report its current speaker gain level setting to the phone's audio gateway (AG).

Command	Possible Responses
`AT+VGS=<gain>`	`OK`
`AT+VGS=<gain>`	`ERROR` if the device is not a Bluetooth hands-free unit.
`AT+VGS?`	`+VGS: <gain>`
`AT+VGS=?`	`+VGS: (0-15)`

<gain> Decimal integer indicating the speaker gain between 0 and 15, where 15 is the maximum gain.

Set command reports the HF's current gain level setting. Get command reports the previous setting. Test command returns the valid gain levels.

The audio gateway may also send unsolicited +VGS: <gain> messages whenever the gain changes on the AG.

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+NREC Control Noise Reduction and Echo Cancellation

The AT+NREC command is used by a Bluetooth hands-free (HF) device to turn off the Noise Reduction and Echo Cancellation capabilities of the phone's audio gateway (AG).

Command	Possible Responses
`AT+NREC=0`	`OK`
`AT+NREC=0`	`ERROR` if the device is not a Bluetooth hands-free unit or functionality is not supported.

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+BVRA Control Bluetooth Voice Recognition

The AT+BVRA command is used by a Bluetooth hands-free (HF) device to turn on and off the Voice Recognition capabilities of the phone's audio gateway (AG).

Command	Possible Responses
`AT+BVRA=<num>`	`OK`
`AT+BVRA=<num>`	`ERROR` if the device is not a Bluetooth hands-free unit or functionality is not supported.

The AG can also initiate Bluetooth Voice Recognition events by sending the {+BVRA=<num>} unsolicited result code.

<num> Decimal integer. 0 indicates voice recognition functionality should be ended. 1 indicates voice recognition functionality should be started.

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+BINP Bluetooth: Attach Phone Number to a Voice Tag

The AT+BINP command can be used by the Bluetooth hands-free (HF) device to request Phone Number from the AG.

Command	Possible Responses
`AT+BINP=1`	+BINP:<PhoneNumber>, `OK`
`AT+BINP=1`	`ERROR` if the device is not a Bluetooth hands-free unit or functionality is not supported.

Each time this command is sent, the Audio Gateway shall respond with a different Phone Number.

Conforms with: Bluetooth Hands-Free Profile 1.5

AT+BTRH Bluetooth Respond and Hold

The AT+BTRH command can be used by the Bluetooth hands-free (HF) device to perform the Respond and Hold feature.

Command	Possible Responses
`AT+BTRH?`	[+BTRH:<number>], `OK`
`AT+BTRH = <num>`	+BTRH:<num>, `OK`
`AT+BTRH = <num>`	`ERROR` if the device is not a Bluetooth hands-free unit or functionality is not supported.

Num Value	Description
`0`	Put the incoming call on hold.
`1`	Accept the call which was held.
`2`	Reject the call which was held.

Conforms with: Bluetooth Hands-Free Profile 1.5

ATE Command Echo

The ATE command can be used to turn command echo on (ATE1) or off (ATE0). If no parameter is supplied (i.e. ATE), it is the same as ATE0.

Command	Possible Responses
`ATE[<n>]`	`OK` `ERROR`

Conforms with: Recommendation V.250.

ATQ Result Code Suppression

The ATQ command can be used to suppress (ATQ1) or not suppress (ATQ0) the reporting of result codes. If no parameter is supplied (i.e. ATQ), it is the same as ATQ0.

Command	Possible Responses
`ATQ[<n>]`	`OK` `ERROR`

Conforms with: Recommendation V.250.

ATS3 Command Line Termination Character

The ATS3 command can be used to query or alter the character character used to terminate AT command lines. There is usually no reason to set this to something other than the default of 13.

Command	Possible Responses
`ATS3=<n>]`	`OK`
`ATS3?`	`<n><CR><LF>OK`

Conforms with: Recommendation V.250.

ATS4 Response Formatting Character

The ATS4 command can be used to query or alter the response formatting (line feed) character used to format AT response lines. There is usually no reason to set this to something other than the default of 10.

Command	Possible Responses
`ATS4=<n>]`	`OK`
`ATS4?`	`<n><CR><LF>OK`

Conforms with: Recommendation V.250.

ATS5 Command Line Editing Character (Backspace)

The ATS5 command can be used to query or alter the backspace character that is used to edit AT command lines. There is usually no reason to set this to something other than the default of 8.

Command	Possible Responses
`ATS5=<n>]`	`OK`
`ATS5?`	`<n><CR><LF>OK`

Conforms with: Recommendation V.250.

ATV Verbose Result Codes

The ATV command can be used to turn on (ATV1) or off (ATV0) the use of verbose result codes such as OK, ERROR, NO CARRIER, etc. If no parameter is supplied (i.e. ATV), it is the same as ATV0.

Command	Possible Responses
`ATV[<n>]`	`OK` `ERROR`

Conforms with: Recommendation V.250.

ATZ Initialize Modem

The ATZ command initializes the modem and returns all status settings to their default values. In the current implementation, this command is identical to AT&F.

Command	Possible Responses
`ATZ[<n>]`	`OK`

The parameter <n> is ignored in this implementation.

Conforms with: Recommendation V.250.

AT&F Reset to Factory Defaults

The AT&F command resets all status settings to their factory default values.

Command	Possible Responses
`AT&F`	`OK`

Conforms with: Recommendation V.250.

AT&W Write Settings

The AT&W command saves all status settings so they can be restored the next time the modem is initialized. In the current implementation, this command is ignored.

Command	Possible Responses
`AT&W`	`OK`

Conforms with: Recommendation V.250.

AT+GCAP Request Capabilities

The AT+GCAP command requests the capabilities of the modem. It responds with a list of functionality areas, such as GSM, Fax, etc, that the modem supports.

Command	Possible Responses
`AT+GCAP`	`+GCAP: <functionality-list>`

The following functionality values may be returned:

Value	Description
`+CGSM`	GSM commands according to 3GPP TS 27.007 and 27.005.
`+FCLASS`	Fax commands.
`+VOIP`	VoIP calls can be dialed with `ATD<uri>;`.

Conforms with: Recommendation V.250.

AT+CALM Alert Sound Mode

This command is used to select the general alert sound mode of the MT.

Command	Possible Responses
`AT+CALM=<mode>`	`+CME ERROR: <err>`
`AT+CALM?`	`+CALM: <mode>` `+CME ERROR: <err>`
`AT+CALM=?`	`+CALM:`(list of supported `<mode>`s)

The list of <mode>s supported under qtopia are as follows:

0	"Normal" (callAlert and msgAlert set to "Once")
1	"Silent" (entire MT set to silent mode)
2	"CallSilent" (callAlert set to "Off")
3	"MsgSilent" (msgAlert set to "Off")
4	"AlertSilent" (callAlert and msgAlert set to "Off")

Conforms with: 3GPP TS 27.007.

AT+CBC Battery Charge

The AT+CBC command can be used to query the current battery charge.

Command	Possible Responses
`AT+CBC[?]`	`+CBC: <bcs>, <bcl>`
`AT+CBC=?`	`+CBC: (0-3),(0-100)`

Execution command returns battery connection status <bcs> and battery charge level <bcl> of the MT.

`<bcs>`	0 MT is powered by the battery 1 MT has a battery connected, but is not powered by it 2 MT does not have a battery connected 3 Recognized power fault, calls inhibited
`<bcl>`	0 battery is exhausted, or MT does not have a battery connected. 1...100 battery has 1-100 percent of capacity remaining.

Conforms with: 3GPP TS 27.007.

AT+CCLK Clock

The AT+CCLK command sets the real-time clock of the MT. If setting fails in an MT error, +CME ERROR: <err> is returned.

Command	Possible Responses
`AT+CCLK=<time>`	`+CME ERROR: <err>`
`AT+CCLK?`	`+CCLK: <time>` `+CME ERROR: <err>`
`AT+CCLK=?`

The <time> parameter is of the form specified via AT+CSDF.

In this implementation, we "fake" this command. When other time-related commands (such as AT+CALA) are performed, some operations are done to convert the presented time to the MT time, according to our fake time variable.

It is recommended that the auxillary time format is set to 4-digit year format (AT+CSDF=,2) before using this command, as the two digit year format assumes a base date of 1900 AD.

Conforms with: 3GPP TS 27.007.

/sa AT+CSDF

AT+CEER Extended error report

The AT+CEER command provides extended error information.

Command	Possible Responses
`AT+CEER`	`+CEER: <report>`
`AT+CEER=?`

Execution command causes the TA to return one or more lines of information text <report>, determined by the MT manufacturer, which should offer the user of the TA an extended report of the reason for the last failed operation.

Conforms with: 3GPP TS 27.007.

AT+CLVL Loudspeaker Volume Level

This command is used to select the volume of the internal loudspeaker of the MT.

Command	Possible Responses
`AT+CLVL=<level>`	`+CME ERROR: <err>`
`AT+CLVL?`	`+CLVL: <level>` `+CME ERROR: <err>`
`AT+CLVL=?`	`+CLVL:`(list of supported `<level>`s) `+CME ERROR: <err>`

Conforms with: 3GPP TS 27.007.

AT+CIND Indicator Control

The AT+CIND command is used to get the current indicator values.

Command	Possible Responses
`AT+CIND=[<ind>,[<ind>[,...]]]`	`+CME ERROR: 3`
`AT+CIND?`	`+CIND: <ind>[,<ind>[,...]]`
`AT+CIND=?`	`+CIND: (<descr>,(list of <ind>'s))[,...]`

Set command is used to set the indicator values. In this implementation, indicators cannot be set and the set command will always return an error.

Read command returns the current status of the indicators.

Test command returns pairs, where the string value <descr> is a description of the indicator, and the compound value is the allowable values for the indicator.

The following indicators are supported:

Name	Description	Range
`battchg`	Battery charge level	0-5
`signal`	Signal quality	0-5
`service`	Service availability	0-1
`message`	Message received	0-1
`call`	Call in progress	0-1
`roam`	Roaming indicator	0-1
`smsfull`	SMS memory state	0 space is available 1 memory has just become full 2 memory is full and a message was just rejected
`callsetup`	Call setup state	0 no call setup in progress 1 incoming call setup in progress 2 outgoing call setup in progress 3 outgoing call setup in the "alerting" phase
`callheld`	Call hold state	0 no calls are held 1 there are both active and held calls 2 there are held calls, but no active calls

The callsetup and callheld indicators are from the Bluetooth Hands-Free Profile version 1.5. The rest are from 3GPP TS 27.007.

Conforms with: 3GPP TS 27.007, Bluetooth Hands-Free Profile 1.5.

AT+CKPD Keypad Control

The AT+CKPD command is used to send keypad events to the phone.

Command	Possible Responses
`AT+CKPD=<keys>[,<time>[,<pause>]]`	`OK` `+CME ERROR: 3`
`AT+CKPD=?`	`+CKPD: (0123456789*#),(0-255),(0-255)`

Execution command is used to send keypad events to the phone. The following <keys> are defined by 3GPP TS 27.007:

Character	Description
`#`	Hash (number sign)
`%`	Percent sign
`*`	Star
`0` ... `9`	Digit keys
`:C`	Send `C` as a literal character
`;CCC...;`	Send `CCC...` as literal characters
`<`	Left arrow key
`>`	Right arrow key
`@`	Alpha key for switching input method modes
`C/c`	Clear
`D/d`	Volume down
`E/e`	Connection end (END or hangup key)
`F/f`	Function key
`L/l`	Phone lock
`M/m`	Menu
`Q/q`	Quiet/mute
`S/s`	Connection start (SEND or call key)
`U/u`	Volume up
`V/v`	Down arrow key
`W/w`	Pause character
`Y/y`	Delete last character (same as `C/c`)
`[`	Soft key 1 (same as `F/f`)
`]`	Soft key 2 (same as `C/c`)
`^`	Up arrow key

The following keys from 3GPP TS 27.007 are not currently supported:

Character	Description
`A/a`	Channel A
`B/b`	Channel B
`P/p`	Power
`R/r`	Recall last number
`T/t`	Store/memory
`X/x`	Auxillary key

The following additional non-27.007 keys are supported:

Character	Description
`H/h`	Key on headphones

`time`	Time that the key should be held down, in tenths of a second. The default is 1.
`pause`	The time to pause between keys, in tenths of a second. The default is 1.

Conforms with: 3GPP TS 27.007

AT+CLAE Language Event

This command is used to enable/disable unsolicited result code +CLAV: <code>, which is sent from the MT when the language in the MT is changed.

Command	Possible Values
`AT+CLAE=<mode>`	`+CME ERROR: <err>`
`AT+CLAE?`	`+CLAE: <mode>` `+CME ERROR: <err>`
`AT+CLAE=?`	`+CLAE:`(list of supported `<mode>`s) `+CME ERROR: <err>`

The <mode> param can be either 0 (disable unsolicited result code), or 1 (enable unsolicited result code). The +CLAV=<code> unsolicited result notification is disabled by default.

Conforms with: 3GPP TS 27.007.

AT+CLAN Set Language

This command sets the language in the MT.

Command	Possible Responses
`AT+CLAN=<code>`	`+CME ERROR: <err>`
`AT+CLAN?`	`+CLAN: <code>` `+CME ERROR: <err>`
`AT+CLAN=?`	`+CLAN:`(list of supported `<code>`s) `+CME ERROR: <err>`

The <code> parameter is a two letter abbreviation of the language. See ISO 639 for the complete list of codes.

Conforms with: 3GPP TS 27.007.

AT+CMEC Mobile Termination Control Mode

The AT+CMEC command is used to select the modes that can control the MT.

Command	Possible Responses
`AT+CMEC=[<keyp>,[<disp>[,<ind>]]]`	`OK` `+CME ERROR: 3`
`AT+CMEC?`	`+CMEC: 0,0,0`
`AT+CMEC=?`	`+CMEC: (0),(0),(0)`

In this implementation, keypad and display control are not supported, and indicators can only be read, never written. It is an error to use the set command with non-zero parameters.

Conforms with: 3GPP TS 27.007.

AT+CMEE Report Mobile Termination Error

The AT+CMEE command is used to select the error reporting mode for the MT.

Command	Possible Responses
`AT+CMEE=[<n>]`	`OK` `+CME ERROR: 4`
`AT+CMEE?`	`+CMEE: <n>`
`AT+CMEE=?`	`+CMEE: (0-2)`

Set command disables or enables the use of result code +CME ERROR: <err> as an indication of an error relating to the functionality of the MT. When enabled, MT related errors cause the +CME ERROR: <err> final result code instead of the regular ERROR result code. ERROR is still returned normally when the error is related to syntax, invalid parameters, or TA functionality.

<n>

0 disable +CME ERROR: <err> result code and use ERROR instead. This is the default value.
1 enable +CME ERROR: <err> result code and use numeric <err> values.
2 enable +CME ERROR: <err> result code and use verbose <err> values.

Conforms with: 3GPP TS 27.007.

AT+CMER Mobile Termination Event Reporting

The AT+CMER command enables or disables unsolicited result codes related to MT events.

Command	Possible Responses
`AT+CMER=[<mode>[,<keyp>[,<disp>[,<ind>[,<bfr>]]]]]`	`OK` `+CME ERROR: 3`
`AT+CMER?`	`+CMER: 1,0,0,<ind>,0`
`AT+CMER=?`	`+CMER: (1,3),(0),(0),(0-2),(0)`

Set command enables or disables unsolicited result codes for indicators. This implementation does not support the other event types and <mode> must be 1 or 3, which are treated as identical.

<ind>

0 no indicator event reporting.
1 indicator event reporting using result code +CIEV: <ind>,<value>. Only those indicator changes that are not caused by AT+CIND set command are reported.
2 indicator event reporting using result code +CIEV: <ind>,<value>. All indicator changes are reported.

In this implementation, AT+CIND set command is not supported, so <ind> values 1 and 2 are identical.

Conforms with: 3GPP TS 27.007.

AT+CMUT Mute Control

This command is used to enable and disable the uplink voice muting during a voice call.

Command	Possible Responses
`AT+CMUT=<n>`	`+CME ERROR: <err>`
`AT+CMUT?`	`+CMUT: <n>` `+CME ERROR: <err>`
`AT+CMUT=?`	`+CMUT:`(list of supported `<n>`s)

Where <n> is either 0 (mute off) or 1 (mute on)

Conforms with: 3GPP TS 27.007.

AT+CMUX Multiplexing Mode

The AT+CMUX enables multiplexing according to 3GPP TS 27.010.

Command	Possible Responses
`AT+CMUX=[<mode>[,<subset>[,<port_speed>[,<frame_size>[,...]]]]]`	`OK` `+CME ERROR: 4`
`AT+CMUX=?`	`+CMUX: (0),(0),(1-6),(1-32768),(1-255),(0-100),(2-255),(1-255),(1-7)`

Set command enables multiplexing mode according to the supplied parameters. This implementation supports basic mode, UIH frames, any port speed, and any frame size. Set command will report an error if some other mode is requested, or the command is used on a channel that already has multiplexing enabled.

`<mode>`	Multiplexer transparency mechanism: 0 Basic mode 1 Advanced mode; not supported
`<subset>`	Subset of `<mode>` to use: 0 UIH frames used only 1 UI frames used only; not supported 2 I frames used only; not supported
`<port_speed>`	Transmission rate; ignored.
`<frame_size>`	Maximum frame size, 1-32768. Default is 31.

Test command returns the parameter values that are supported, including additional parameters from 3GPP TS 27.007 which are ignored by this implementation.

Conforms with: 3GPP TS 27.007, 27.010.

AT+CPAS Phone Activity Status

The AT+CPAS returns information about the mode the phone is currently operating in.

Command	Possible Responses
`AT+CPAS`	`+CPAS: <pas>`
`AT+CPAS=?`	`+CPAS: (0-5)`

Execution command returns the activity status <pas> of the MT.

It can be used to interrogate the MT before requesting action from the phone.

Test command returns the values that are supported by the MT.

<pas>

0 ready
1 unavailable
2 unknown
3 ringing
4 call in progress
5 asleep

Conforms with: 3GPP TS 27.007.

AT+CPIN Enter PIN

The AT+CPIN command allows for querying and entering the PIN.

Command	Possible Responses
`AT+CPIN=<pin>[,<newpin]`	`+CME ERROR: 3`
`AT+CPIN?`	`+CPIN: READY`
`AT+CPIN=?`	`OK`

For security reasons, this implementation does not allow real access to the PIN through this interface. It is assumed that the user has already entered the PIN directly on the phone using some other means. If the user hasn't, then requests to use restricted features will be denied or delayed. Read command will always return READY and set command will always fail.

Conforms with: 3GPP TS 27.007.

AT+CR Service Reporting Control

This command controls whether or not the intermediate result code +CR: <serv> is returned from the TA to the TE. If enabled, the intermediate result code is transmitted at the point during connect negotiation at which the TA has determined which speed and quality of service will be used, before any error control or data compression reports are transmitted, and before the intermediate result code CONNECT is transmitted.

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

The <mode> parameter can be 0 (disable reporting; default) or 1 (enable intermediate result code reporting).

The <serv> parameter reports the type of service that the data call will use, and can take the following values:

`ASYNC`	Asynchronous Transparent
`SYNC`	Synchronous Transparent
`REL ASYNC`	Asynchronous Non-transparent
`REL SYNC`	Synchronous Non-transparent
`GPRS`	GRPS

Conforms with: 3GPP TS 27.007.

AT+CRC Cellular Result Codes

The AT+CRC command enables or disables the +CRING unsolicited response.

Command	Possible Responses
`AT+CRC=[<mode>]`	`OK` `+CME ERROR: 3`
`AT+CRC?`	`+CRC: <mode>`
`AT+CRC=?`	`+CRC: (0,1)`

Set command controls whether or not the extended format of incoming call indication is used. When enabled, an incoming call is indicated to the TE with unsolicited result code +CRING: <type> instead of the normal RING, where <type> is one of the following values:

`ASYNC`	Asynchronous data
`FAX`	Reserved for future use: Fascimile
`VOICE`	Normal voice

GPRS network requests are not supported in this implementation. They are handled internally within the phone.

Conforms with: 3GPP TS 27.007.

AT+CRMC Ring Melody Control

The AT+CRMC command selects a specific ring melody and volume for the selected call type and profile.

Command	Possible Responses
`AT+CRMC=<index>,<volume>[,[<call_type>][,<profile>]]`	`+CME ERROR: <err>`
`AT+CRMC?`	`+CRMC: <index>,<volume>[,[<call_type1>][,<profile1>]][<CR><LF> +CRMC: <index>,<volume>[,[<call_type2>][,<profile1>]][<CR><LF> +CRMC: <index>,<volume>[,[<call_type1>][,<profile2>]][<CR><LF> +CRMC: <index>,<volume>[,[<call_type2>][,<profile2>]] [...]]` `+CME ERROR: <err>`
`AT+CRMC=?`	`+CRMC: (list of supported <index>s), (list of supported <volume>s)[,[ (list of supported <call_type>s)][,(list of supported <profile>s)]]` `+CME ERROR: <err>`

Defined Values:

`<index>`	Integer; identifies a certain ring melody
`<volume>`	Integer; range of sound levels
`<call_type\i{x}>`	Integer; identifies a call type
`<profile\i{x}>`	Integer; identifies a profile

In this implementation, all of the parameters are ignored. Access to the ring tone settings is via the MT interface only.

Conforms with: 3GPP TS 27.007.

/sa AT+CRMP

AT+CRMP Ring Melody Playback

The AT+CRMP command causes the MT to play a specific ring type. The default values for the optional parameters are those currently selected in the MT.

Command	Possible Responses
`AT+CRMP=<call_type>[,<volume>[,<type>,<index>]]`	`+CME ERROR: <err>`
`AT+CRMP=?`	`+CRMP: (list of supported <call_type>s),(list of supported <volume>s), <type0>,(list of supported <index>s)[<CR><LF> +CRMP: (list of supported <call_type>s),(list of supported <volume>s), <type1>,(list of supported <index>s)]` `+CME ERROR: <err>`

Defined Values:

Parameter	Value / Meaning
`<call_type>`	Integer; defines the call type for which the melody is set
`<volume>`	Integer; defines the volume at which to play the melody
`<type>`	0 Manufacturer Defined 1 User Defined
`<index>`	Integer; defines which of the melodies for the given <call_type> to play

In this implementation, all parameters except for <volume> must be 0. The currently active profile's ring melody will be played at the given volume, or at the current volume if the <volume> is not supplied.

Conforms with: 3GPP TS 27.007.

/sa AT+CRMC

AT+CSCS Select TE Character Set

The AT+CSCS command selects the character set to use in commands that take or return string arguments.

Command	Possible Responses
`AT+CSCS=<chset>`	`OK` `+CME ERROR: 4`
`AT+CSCS?`	`+CSCS: <chset>`
`AT+CSCS=?`	`+CSCS:` (list of supported `<chset>`s)

Set command informs the TA which character set <chset> is used by the TE. TA is then able to convert character strings correctly between TE and MT character sets. +CME ERROR: 4 will be returned if the character set is not supported.

Read command shows the current setting, and test command displays the available character sets.

The following character sets are supported by this implementation:

Name	Description
`GSM`	GSM 7-bit default alphabet from 3GPP TS 23.038. This is the default value.
`HEX`	Hexadecimal encoding of GSM 7-bit default alphabet.
`UCS2`	16-bit universal multiple-octet coded character set. UCS2 character strings are converted to hexadecimal.
`8859-1`	ISO-8859 Latin 1 character set.

Conforms with: Recommendation V.250.

AT+CSGT Set Greeting Text

The AT+CSGT command sets and activates the greeting text in the MT. The greeting text is shown in the MT display when the MT is turned on.

Command	Possible Responses
`AT+CSGT=<mode>[,<text>]`	`+CME ERROR: <err>`
`AT+CSGT?`	`+CSGT: <text>, <mode>`
`AT+CSGT=?`	`+CSGT: (`list of supported `<mode>`s`)`,<ltext>} `+CME ERROR: <err>`

<ltext>, the maximum length of the greeting text supported is 20 characters.

The <mode> parameter may be 0 (off; default) or 1 (on). In this implementation, the value of mode is ignored; the greeting text is always off.

Conforms with: 3GPP TS 27.007.

AT+CSQ Signal Quality

The AT+CSQ command can be used to query the current signal quality.

Command	Possible Responses
`AT+CSQ[?]`	`+CBC: <rssi>, <ber>`
`AT+CSQ=?`	`+CBC: (0-31),(0-7)`

Execution command returns received signal strength indication <rssi> and channel bit error rate <ber> from the MT.

`<rssi>`	0 -113 dBm or less 1 -111 dBm 2...30 -109 to -53 sBm 31 -51 dBm or greater 99 not known or not detectable.
`<ber>`	0...7 RXQUAL values as defined in 3GPP TS 45.008. 99 not known or not detectable.

Conforms with: 3GPP TS 27.007.

AT+CSVM Set Voice Mail Number

The AT+CSVM command is used to set the number to the voice mail server.

Command	Possible Responses
`AT+CSVM=<mode>[,<number>[,<type>]]`	`+CME ERROR: <err>`
`AT+CSVM?`	`+CSVM: <mode>,<number>,<type>` `+CME ERROR: <err>`
`AT+CSVM=?`	`+CSVM:`(list of supported `<mode>`s), (list of supported `<type>`s) `+CME ERROR: <err>`

The <mode> parameter can take the value of 0 (disable voice mail; default) or 1 (enable voice mail).

The <number> parameter is a string, <0..9,+>

The <type> parameter is an integer type, default 129

129	ISDN/Telephony numbering, national/international unknown
145	ISDN/Telephony numbering, international number
161	ISDN/Telephony numbering, national number

Conforms with: 3GPP TS 27.007.

AT+CVHU Voice Hangup Control

The AT+CVHU command controls the behaviour of the MT upon receiving ATH or "drop DTR".

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

Values defined for <mode> are as follows:

0 (default)	"Drop DTR" ignored but OK response given. ATH disconnects.
1	"Drop DTR" and ATH ignored but OK response given.
2	"Drop DTR" behaviour according to &D setting. ATH disconnects.

Conforms with: 3GPP TS 27.007.

AT+CVIB Vibrator Mode

This command is used to enable and disable the vibrator alert feature of the MT.

Command	Possible Responses
`AT+CVIB=<mode>`	`+CME ERROR: <err>`
`AT+CVIB?`	`+CVIB: <mode>` `+CME ERROR: <err>`
`AT+CVIB=?`	`+CVIB:`(list of supported `<mode>`s) `+CME ERROR: <err>`

The following values for <mode> apply:

0	Disable
1	Enable
...15	Reserved
16...	Manufacturer Specific

This implementation supports only values 0 and 1 for <mode>.

Conforms with: 3GPP TS 27.007.

AT*QBC Enable Unsolicited Battery Charge Reporting

The AT*QBC command can be used to enable or disable the unsolicited reporting of battery charge changes.

Command	Possible Responses
`AT*QBC=<n>`	`OK` `+CME ERROR: <err>`
`AT*QBC?`	`*QBC: <n>`
`AT*QBC=?`	`*QBC: (0,1)`

Set command controls the presentation of an unsolicited result code *QBC: <bcs>,<bcl> when <n>=1 and there is a change in the battery charge information.

Read command returns the current state of the result code presentation value <n>. The default value is 0.

`<bcs>`	0 MT is powered by the battery 1 MT has a battery connected, but is not powered by it 2 MT does not have a battery connected 3 Recognized power fault, calls inhibited
`<bcl>`	0 battery is exhausted, or MT does not have a battery connected. 1...100 battery has 1-100 percent of capacity remaining.

AT*QCAM Call Status Monitoring

The AT*QCAM command can be used to enable or disable the unsolicited reporting of call status changes.

Command	Possible Responses
`AT*QCAM=<n>`	`OK` `+CME ERROR: <err>`
`AT*QCAM?`	`*QCAM: <n>`
`AT*QCAM=?`	`*QCAM: (0,1)`

Set command controls the presentation of an unsolicited result code *QCAV: <id>,<state>,<calltype>[,<number>,<type>] when <n>=1 and there is a change in the call status information.

Read command returns the current state of the result code presentation value <n>. The default value is 0.

`<id>`	Identifier for the call.
`<state>`	State of the call: 0 idle 1 calling 2 connecting 3 active 4 hold 5 waiting 6 alerting 7 busy
`<calltype>`	Type of call: 1 voice 2 data 4 reserved for future use: fax 32 video
`<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).

AT*QSQ Enable Unsolicited Signal Quality Reporting

The AT*QSQ command can be used to enable or disable the unsolicited reporting of battery charge changes.

Command	Possible Responses
`AT*QSQ=<n>`	`OK` `+CME ERROR: <err>`
`AT*QSQ?`	`*QBC: <n>`
`AT*QSQ=?`	`*QBC: (0,1)`

Set command controls the presentation of an unsolicited result code *QSQ: <rssi>,<ber> when <n>=1 and there is a change in the battery charge information.

Read command returns the current state of the result code presentation value <n>. The default value is 0.

`<rssi>`	0 -113 dBm or less 1 -111 dBm 2...30 -109 to -53 sBm 31 -51 dBm or greater 99 not known or not detectable.
`<ber>`	0...7 RXQUAL values as defined in 3GPP TS 45.008. 99 not known or not detectable.

AT+CACM Accumulated Call Meter

The AT+CACM command is used to reset or query the accumulated call meter advice of charge.

Command	Possible Responses
`AT+CACM=[<passwd>]`	`+CME ERROR: <err>`
`AT+CACM?`	`+CACM: <acm>` `+CME ERROR: <err>`
`AT+CACM=?`

The <passwd> parameter is equal to the SIM PIN2 locking password, and is usually required to reset the accumulated call meter value.

Conforms with: 3GPP TS 27.007.

AT+CAMM Accumulated Call Meter Maximum

The AT+CAMM command is used to set or query the Advice Of Charge related accumulated call meter maximum value in the SIM or active application in the UICC.

Command	Possible Responses
`AT+CAMM=[<acmmax>[,<passwd>]]`	`+CME ERROR: <err>`
`AT+CAMM?`	`+CAMM: <acmmax>` `+CME ERROR: <err>`
`AT+CAMM=?`

The <acmmax> parameter contains the maximum number of home units allowed to be consumed by the subscriber. When ACM (see AT+CACM) reaches <acmmax>, calls are prohibited. SIM PIN2 is usually required to set the value.

A zero or non-present value of <acmmax> disables the ACMmax feature.

Conforms with: 3GPP TS 27.007.

AT+CLCK Facility Lock

This command enables locking, unlocking and interrogation of a MT or network facility.

Command	Possible Responses
`AT+CLCK=<fac>,<mode>[,<passwd>[,<class>]]`	`+CME ERROR: <err>` when mode = 2 and command is successful: `+CLCK: <status>[,<class1>` `[<CR><LF>+CLCK: <status>,<class2>` `[...]]`
`AT+CLCK=?`	`+CLCK:`(list of supported `<fac>`s) `+CME ERROR: <err>`

Defined values for the facility <fac> are as follows:

Value	Meaning
"CS"	CNTRL (lock CoNTRoL surface (e.g. phone keyboard)
"PS"	PH-SIM (lock PHone to SIM/UICC card)
"PF"	PH-FSIM (lock PHone to the very First inserted SIM/UICC card)
"SC"	SIM (lock SIM/UICC card)
"AO"	BAOC (Barr All Outgoing Calls)
"OI"	BOIC (Barr Outgoing International Calls)
"OX"	BOIC-exHC (Barr Outgoing International Call except to Home Country)
"AI"	BAIC (Barr All Incoming Calls)
"IR"	BIC-Roam (Barr Incoming Calls when Roaming outside the home country)
"NT"	barr incoming calls from numbers Not stored in TA memory
"NM"	barr incoming calls from numbers Not stored to MT memory
"NS"	barr incoming calls from numbers not stored to SIM/UICC memory
"NA"	barr incoming calls from numbers Not stored in Any memory
"AB"	All Barring services (applicable for `<mode>` = 0)
"AG"	All outGoing barring services (applicable for `<mode>` = 0)
"AC"	All inComing barring services (applicable for `<mode>` = 0)
"FD"	SIM card or active application in the UICC fixed dialing memory feature
"PN"	Network Personalisation
"PU"	network sUbset Personalisation
"PP"	service Provider Personalisation
"PC"	Corporate Personalisation

Defined values for <mode> are 0 (unlock), 1 (lock) and 2 (query status). Defined values for <status> are 0 (not active) and 1 (active).

<classx> is a sum of integers that each represent a class of information (default 7) Defined values for <classx> are as follows:

1	voice (telephony)
2	data (refers to all bearer services)
4	reserved for future use: fax (facsimile services)
8	sms (short message service)
16	data circuit sync
32	data circuit async
64	dedicated packet access
128	dedicated PAD access

Conforms with: 3GPP TS 27.007.

AT+CCWE Call Meter Maximum Event

The AT+CCWE command is used to enable the +CCWV unsolicited notification result.

If enabled, the +CCWV unsolicited notification result will be returned when approximately 30 seconds of call time remains, or if less than 30 seconds of call time remains when a new call is started.

Command	Possible Responses
`AT+CCWE=<mode>`	`+CME ERROR: <err>`
`AT+CCWE?`	`+CCWE: <mode>` `+CME ERROR: <err>`
`AT+CCWE=?`	`+CCWE:`(list of supported `<mode>`s) `+CME ERROR: <err>`

The <mode> parameter can be:

0	Disable call meter warning event (default)
1	Enable call meter warning event

Conforms with: 3GPP TS 27.007.

AT+CPUC Price Per Unit and Currency Table

The AT+CPUC command is used to set the parameters of the Advice Of Charge related price per unit and currency table in the SIM card or active application in the UICC. PUCT information can be used to convert the home units (as used in AT+CAOC,AT+CACM and AT+CAMM) into currency units.

Command	Possible Responses
`AT+CPUC=<currency>,<ppu>[,<passwd>]`	`+CME ERROR: <err>`
`AT+CPUC?`	`+CPUC: <currency>,<ppu>` `+CME ERROR: <err>`
`AT+CPUC=?`

The SIM PIN2 password is usually required to set the Advice Of Charge price per unit parameters.

The <currency> parameter is a 3-character string currency code (e.g. "GBP", "DEM").

The <ppu> parameter is a string type price per unit; dot is used as a decimal separator (e.g. "2.66").

Conforms with: 3GPP TS 27.007.

AT+CPWD Change Password

The command allows a new password to be set for the facility lock function defined by the AT+CLCK command.

Command	Possible Responses
`AT+CPWD=<fac>,<oldpwd>,<newpwd>`	`+CME ERROR: <err>`
`AT+CPWD=?`	`+CPWD:`list of supported `(<fac>,<pwdlength>)`s `+CME ERROR: <err>`

All of the <fac>'s from AT+CLCK plus "P2" (SIM Pin 2) are defined for this command. <oldpwd>,<newpwd> are strings; the previous and new passwords for the facility. <pwdlength> is the maximum allowed length of a password for the facility.

Conforms with: 3GPP TS 27.007.

AT+CSIM General SIM Access

This command allows a direct control of the SIM by a distant application on the TE.

Comand	Possible Responses
`AT+CSIM=<length>,<command>`	`+CSIM: <length>,<response>` `+CME ERROR: <err>`
`AT+CSIM=?`

Conforms with 3GPP TS 27.007.

AT+CFUN Set Phone Functionality

The AT+CFUN command returns information about the current functionality level of the phone, and allows the level to be modified.

Command	Possible Responses
`AT+CFUN=<fun>[,<rst>]`	`OK`, `ERROR`
`AT+CFUN?`	`+CFUN: <fun>`
`AT+CFUN=?`	`+CFUN: (0-4),(0-1)`

Set command selects the level of functionality <fun> in the MT. Read command returns the current level. Test command returns the values that are supported by the MT.

`<fun>`	0 minimum functionality 1 full functionality 2 disable phone transmit RF circuits only 3 disable phone receive RF circuits only 4 disable phone both transmit and receive RF circuits
`<rst>`	0 do not reset the MT before setting it to `<fun>` 1 reset the MT before setting it to `<fun>` (not supported at present)

Conforms with: 3GPP TS 27.007.

[Previous: Modem Emulator - Call Control] [Next: Modem Emulator - Phonebook Operations]

Trademarks

Qt Extended 4.4.3