Home · All Classes · Grouped Classes · Annotated · Functions

[Previous: Modem Emulator - Call Control] [Next: Modem Emulator - Identification]

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.

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.

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

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

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

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

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

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

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

CommandPossible Responses
AT&FOK

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.

CommandPossible Responses
AT&WOK

Conforms with: Recommendation V.250.

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.

CommandPossible 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+CBC Battery Charge

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

CommandPossible 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+CEER Extended error report

The AT+CEER command provides extended error information.

CommandPossible Responses
AT+CEER+CEER: <report>

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+CIND Indicator Control

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

CommandPossible 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:

NameDescriptionRange
battchgBattery charge level0-5
signalSignal quality0-5
serviceService availability0-1
messageMessage received0-1
callCall in progress0-1
roamRoaming indicator0-1
smsfullSMS memory state
  • 0 space is available
  • 1 memory has just become full
  • 2 memory is full and a message was just rejected
callsetupCall 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
callholdCall 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 callhold 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+CMEC Mobile Termination Control Mode

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

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

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

CommandPossible Responses
AT+CMER=[<mode>[,<keyp>[,<disp>[,<ind>[,<bfr>]]]]]OK, +CME ERROR: 3
AT+CMER?+CMER: 1,0,0,<ind>,0
AT+CMER=?+CMER: (1),(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 always be 1.

<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+CMUX Multiplexing Mode

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

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

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

CommandPossible 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+CRC Cellular Result Codes

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

CommandPossible 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:

ASYNCAsynchronous data
FAXFascimile
VOICENormal voice

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

Conforms with: 3GPP TS 27.007.

AT+CSCS Select TE Character Set

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

CommandPossible 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:

NameDescription
GSMGSM 7-bit default alphabet from 3GPP TS 23.038. This is the default value.
HEXHexadecimal encoding of GSM 7-bit default alphabet.
UCS216-bit universal multiple-octet coded character set. UCS2 character strings are converted to hexadecimal.
8859-1ISO-8859 Latin 1 character set.

Conforms with: Recommendation V.250.

AT+CSQ Signal Quality

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

CommandPossible 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+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.

CommandPossible Responses
AT+GCAP+GCAP: <functionality-list>

The following functionality values may be returned:

ValueDescription
+CGSMGSM commands according to 3GPP TS 27.007 and 27.005.
+FCLASSFax commands.
+VOIPVoIP calls can be dialed with ATD<uri>;.

Conforms with: Recommendation V.250.

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.

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

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

CommandPossible 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+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).

CommandPossible 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).

CommandPossible 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).

CommandPossible Responses
AT+NREC=0OK
AT+NREC=0ERROR 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).

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

CommandPossible Responses
AT+BINP=1+BINP:<PhoneNumber>, OK
AT+BINP=1ERROR 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.

CommandPossible 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 ValueDescription
0Put the incoming call on hold.
1Accept the call which was held.
2Reject the call which was held.

Conforms with: Bluetooth Hands-Free Profile 1.5

[Previous: Modem Emulator - Call Control] [Next: Modem Emulator - Identification]

Copyright © 2007 Trolltech Trademarks
Qtopia 4.2.5