Professional Documents
Culture Documents
Standard at Commands
Standard at Commands
Supported AT Command
Reference
2130617
Rev 7
Preface
Important Due to the nature of wireless communications, transmission and reception of data
can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be
Notice totally lost. Although significant delays or losses of data are rare when wireless
devices such as the Sierra Wireless modem are used in a normal manner with a
well-constructed network, the Sierra Wireless modem should not be used in
situations where failure to transmit or receive data could result in damage of any
kind to the user or any other party, including but not limited to personal injury,
death, or loss of property. Sierra Wireless accepts no responsibility for damages
of any kind resulting from delays or errors in data transmitted or received using
the Sierra Wireless modem, or for failure of the Sierra Wireless modem to
transmit or receive such data.
Safety and Do not operate the Sierra Wireless modem in areas where blasting is in progress,
where explosive atmospheres may be present, near medical equipment, near life
Hazards
support equipment, or any equipment which may be susceptible to any form of
radio interference. In such areas, the Sierra Wireless modem MUST BE
POWERED OFF. The Sierra Wireless modem can transmit signals that could
interfere with this equipment.
Do not operate the Sierra Wireless modem in any aircraft, whether the aircraft is
on the ground or in flight. In aircraft, the Sierra Wireless modem MUST BE
POWERED OFF. When operating, the Sierra Wireless modem can transmit
signals that could interfere with various onboard systems.
Note: Some airlines may permit the use of cellular phones while the aircraft is on the
ground and the door is open. Sierra Wireless modems may be used at this time.
The driver or operator of any vehicle should not operate the Sierra Wireless
modem while in control of a vehicle. Doing so will detract from the driver or
operator's control and operation of that vehicle. In some states and provinces,
operating such communications devices while in control of a vehicle is an offence.
Limitation of The information in this manual is subject to change without notice and does not
represent a commitment on the part of Sierra Wireless. SIERRA WIRELESS AND
Liability
ITS AFFILIATES SPECIFICALLY DISCLAIM LIABILITY FOR ANY AND ALL
DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL,
PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO,
LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE
ARISING OUT OF THE USE OR INABILITY TO USE ANY SIERRA WIRELESS
PRODUCT, EVEN IF SIERRA WIRELESS AND/OR ITS AFFILIATES HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE
FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
Notwithstanding the foregoing, in no event shall Sierra Wireless and/or its
affiliates aggregate liability arising under or in connection with the Sierra Wireless
product, regardless of the number of events, occurrences, or claims giving rise to
liability, be in excess of the price paid by the purchaser for the Sierra Wireless
product.
Patents This product may contain technology developed by or for Sierra Wireless Inc.
This product includes technology licensed from QUALCOMM®.
This product is manufactured or sold by Sierra Wireless Inc. or its affiliates under
one or more patents licensed from InterDigital Group.
Contact
Information Sales Desk: Phone: 1-604-232-1488
Hours: 8:00 AM to 5:00 PM Pacific Time
E-mail: sales@sierrawireless.com
Post: Sierra Wireless
13811 Wireless Way
Richmond, BC
Canada V6V 3A4
Fax: 1-604-231-1109
Web: www.sierrawireless.com
Revision
History
2.5 Mar 2008 • Added band indexes (0C,0D) and clarified query use for !BAND
• Clarified !NVBACKUP options
• Clarified +ECIO and +USET
2.7 Sep 2008 • Added MC8791V and MC8792V to supported modems list
• Added WCDMA900 content to !BAND and !GSTATUS
Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Command reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Test commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Command reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
SIM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Command reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Index—AT Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Note: You may also want Proprietary AT commands are supplemental to the standard AT
to consult other documents commands.
available on our Internet
The commands in this document apply to the Sierra Wireless devices
site at
listed in Table 1-1.
www.sierrawireless.com.
Note: When designing applications that use these AT commands, use Watcher® (and
other Sierra Wireless applications) as functionality templates to ensure proper use of
command groups. For questions or concerns relating to command implementation, please
contact your Sierra Wireless account representative.
Command timing
Interval timing
Some commands require time to process before additional commands are
entered.
When building automated test scripts, ensure that sufficient delays are embedded
where necessary to avoid these errors.
Result codes
Result codes are not shown in the command tables unless special conditions
apply. Generally the result code OK is returned when the command has been
executed. ERROR may be returned if parameters are out of range, and is
returned if the command is not recognized or is not permitted in the current state
or condition of the modem.
Upgrading
If your modem firmware is an earlier version, you can acquire updated firmware
by contacting your account manager.
Document structure
This document includes a chapter covering Supported 27.007 AT commands, as
well as the proprietary commands listed in the tables below. Each table
corresponds to a specific chapter.
+ECIO Return total Energy per chip per power density value (WCDMA 37
only)
Conventions
The following format conventions are used in this reference:
Character codes or keystrokes that are described with words or standard
abbreviations are shown within angle brackets using a different font, such as
<CR> for Carriage Return and <space> for a blank space character.
Numeric values are decimal unless prefixed as noted below.
Hexadecimal values are shown with a prefix of 0x, i.e. in the form 0x3D.
Binary values are shown with a prefix of 0b, i.e. in the form 0b00111101.
Command and register syntax is noted using an alternate font: !CHAN=<c>[,b].
The “AT” characters are not shown but must be included before all commands
except as noted in the reference tables.
Characters that are required are shown in uppercase; parameters are noted in
lowercase. Required parameters are enclosed in angle brackets (<n>) while
optional parameters are enclosed within square brackets ([x]). The brackets are
not to be included in the command string.
Commands are presented in table format. Each chapter covers the commands
related to that subject and presents a summary table to help you locate a needed
command. Commands are in ASCII alphabetical order in the body of each
chapter.
Any default settings are noted in the command tables. Note that these are the
factory default settings and not the default parameter value assumed if no
parameter is specified.
Result Code This is a numeric or text code that is returned after all commands
(except resets)—text codes are returned if verbose responses are enabled. Only
one result code is returned for a command line regardless of the number of
individual commands contained on the line.
Response This term indicates a response from the modem that is issued prior to
a result code. Reading registers or issuing commands that report information will
provide a response followed by a result code unless the command generates an
error.
Responses and result codes from the modem, or host system software prompts,
are shown in this font:
CONNECT 14400
&C Set Data Carrier Detected (Received line signal detector) function
mode
D Dial
S10 Set disconnect delay after indicating the absence of data carrier
C ITU T V.24 circuit 109 carrier detect signal behavior command Partial
Format
• C<value>
Limitations
• Default <value> = 2
• <value> = 2 causes the AT/Data carrier detect pin to ‘wink’
(briefly switch off and on) when data calls end.
• <value> = 0 or 1 performs as defined in the standard
+CACM Accumulated call meter
+CACSP Voice Group or Voice Broadcast Call State Attribute Presentation N/A
+CALCC List current Voice Group and Voice Broadcast Calls N/A
D*99***<n># Sets up a packet data call (PDP context) based on profile ID #<n>
(<n> is the <cid> in the +CGDCONT command)
Command summary
Table 3-1 lists the commands described in this chapter.
Command reference
Table 3-2: Modem status, customization, and reset commands
Command Description
APPL
Address: <address>
Version: <version>
Date: <date>
Size: <size>
Purpose: List the CWE headers in the devices flash memory. The bootloader
version is in the BOOT section.
Parameters:
<version> (Bootloader version):
• ASCII string
• Maximum length: 84 characters
• Example: M2_0_11_14BT G:/WS/FW/M2_0_11_14BT/MDM8200/SRC 2009/10/17
15:33:00
• Query: AT+CPIN2?
Response: +CPIN2: SIM PIN2
(appears if PIN2 is enabled, but not verified)
or +CPIN2: READY
(appears if PIN2 is disabled, or if it is enabled and verified)
Purpose: Show the status of PIN2.
Parameters:
<PIN2> (The SIM card’s PIN2 code):
• Decimal ASCII
OK
Purpose: Return download statistics for single/dual carriers.
Parameters:
<status> (DLMOD retrieval state):
• 0=Enabled
• 1=Disabled
+ECIO Return total Energy per chip per power density value (WCDMA
Supporting chipsets: only)
• All Return the total energy per chip per power density (Ec/Io) value of the active set’s three
strongest cells.
Usage:
• Query: AT+ECIO?
Response (Single carrier cells):
+ECIO:
Ec/Io: <value1> dB [<value2> dB [<value3> dB]]
Response (Dual carrier cells):
+ECIO:
Car0 Ec/Io: <value1> dB [<value2> dB [<value3> dB]]
Car1 Ec/Io: <value4> dB [<value5> dB [<value6> dB]]
Purpose: Return the signed dB values of the three strongest cells in the active
set. The values are listed from strongest to weakest, based on RSCP,
and separated by tabs. If there are less than three cells, only those
values appear. For example:
+ECIO:
Ec/Io: -3.5 dB -14.0 dB -24.5 dB
—or—
+ECIO:
Ec/Io: -7.5 dB
Parameters:
<value n> (Ec/Io of cell in the active set):
• Valid range: -31.5 dB to 0 dB
Note: The command +USET also displays Tot Ec/Io as one of its outputs.
Usage:
• Execution: AT+ETFCI=<status>
Response: +ETFCI:
ENABLED!
OK
or +ETFCI:
DISABLED!
OK
Purpose: Enable or disable the ability to check the average E-TFCI value.
• Query: AT+ETFCI?
Response: +ETFCI:
Status: <status>
total samples 1280, average etfci <etfci>
OK
Purpose: Indicate if E-TFCI checking is enabled, and report the total number of
samples and average E-TFCI value.
Parameters:
<status> (E-TFCI reporting status):
• 0=Disabled
• 1=Enabled
<etfci> (Average E-TFCI value over sampling period):
• Valid range: 0–127
Note: Due to stack implementation requirements, !GETBAND reports W800 for both
W800 and W850.
Neighbor Cells:
Band: <band> <band> <band>
ARFCN: <arfcn> <arfcn> <arfcn>
RAC: <rac> <rac> <rac>
RX level (dBm): <rxlvl> <rxlvl> <rxlvl>
C1: <c1> <c1> <c1>
C2: <c2> <c2> <c2>
C31: <c31> <c31> <c31>
C32: <c32> <c32> <c32>
OK
Purpose: Display serving cell and neighbor cell information.
Parameters:
<mccmnc> (Mobile Country Code and Mobile Network Code (combine to form the
PLMN)):
• 16-bit decimal
<lac> (Location Area Code):
• 16-bit decimal
<cellid> (Cell ID):
• 16-bit decimal
<bsic> (Base Station Identity Code):
• 8-bit decimal
<ncc> (Network Color Code):
• 8-bit decimal
<bscc> (Base Station Color Code):
• 8-bit decimal
(Continued on next page)
Usage:
• Execution: AT!POWERDOWN
Response: OK
Purpose: Power the system down.
Note: This command should only be used when testing using an appropriate testing
jig—do not use it when the modem is installed in a computer.
Note: Some parameter values may differ (or not appear) based on device or firmware
revision.
<wcdmarrc> (Protocol):
• Default value is the highest release supported by the device.
• Two-digit number corresponding to 3GPP release (!REL=? shows valid values)
• Example: 00=Release 99
<sgsnr> (SGSN revision):
• Two-digit number corresponding to SGSN revision (!REL=? shows valid values)
• Example: 00=Release 97
• nn=Dynamic—Uses the revision broadcast by the network
<mscr> (MSC revision):
• Two-digit number corresponding to MSC revision (!REL=? shows valid values)
• Example: 00=Release 97
• nn=Dynamic—Uses the revision broadcast by the network
!RESET Reset modem
Supporting chipsets: Perform a modem reset.
• All Usage:
• Execution: AT!RESET
Response: OK
Purpose: Reset the modem.
Note: <interval> ignores the time spent actually performing a retry attempt. If
<interval> = 5, attempts are made at elapsedTime = 0, 5, 10, etc. until an attempt is
successful or <period> - elapsedTime < <interval>.
Example 1:
Assume a retry attempt takes 2 seconds.
If <period> = 1 and <interval> = 8, and no attempts are successful:
• Time=0: Retry attempt fails at time = 2. No more attempts are made because
<period> has expired.
Example 2:
Assume a retry attempt takes 2 seconds.
If <period> = 3 and <interval> = 5, and no attempts are successful:
• Time=0: Retry attempt fails at time = 2. No more attempts are made because
<period> will expire before the <interval> passes.
Example 3:
Assume a retry attempt takes 2 seconds.
If <period> = 14 and <interval> = 5, and no attempts are successful:
• Time=0: Retry attempt fails at time = 2; next attempt will begin at time=5 (the
<interval> counts from the beginning of the previous attempt)
• Time=5: Retry attempt fails at time = 7; next attempt will begin at time=10
• Time=10: retry attempt fails at time = 12; No more attempts will be made because
the <period> will expire before another <interval> of 5 seconds can pass.
Note: When call progress notification is enabled, the standard AT command +CLCC
(List Current Calls) is disabled.
Parameters:
<cpnStatus> (Call progress notification status):
• 0=Disabled
• 1=Output on AT channel if AT is not blocked
• 2=Output on AT channel even if AT is blocked
• Any other value will return an ERROR response
<idx> (Call identification number):
• Integer value as described in GSM 02.30 Section 4.5.5.1
• Can be used in +CHLD command
<dir> (Call direction):
• 0=Mobile-originated (MO)
• 1=Mobile-terminated (MT)
<state> (Call state):
• 0=Active
• 1=Held
• 2=Dialing (MO calls)
• 3=Alerting (MO calls)
• 4=Incoming (MT calls)
• 5=Waiting (MT calls)
• 6=Disconnected
<mode> (Bearer/teleservice):
• 0=Voice
• 1=Data
• 2=Fax
(Continued on next page)
OK
Purpose: Enable/disable logging of WCDMA power information.
• Query: AT+WPOWER?
Response: +WPOWER:
Status: 1
average RxM Power <rxm>dBm, total samples <numRXM>
no valid WCDMA RxD Power value available!
no valid WCDMA Tx Power value available!
OK
or
+WPOWER:
Status: 1
average RxM Power <rxm>dBm, total samples <numRXM>
average RxD Power <rxd>dBm, total samples <numRXD>
average Tx Power <txd>dBm, total samples <numTXD>
OK
or
+WPOWER:
Status: 1
average Car0 RxM Power <rxm0>dBm, total samples
<numRXM0>
average Car0 RxD Power <rxd0>dBm, total samples
<numRXD0>
average Car1 RxM Power <rxm1>dBm, total samples
<numRXM1>
average Car1 RxD Power <rxd1>dBm, total samples
<numRXD1>
average Tx Power <txd>dBm, total samples <numTXD>
OK
or
+WPOWER:
Status: 0
no valid WCDMA Power value available!
Purpose: Display the power information.
Parameters:
<state> (WCDMA logging):
• 0=Disabled (Default)
• 1=Enabled
(Continued on next page)
+WPOWER (Continued) Return average WCDMA power level over time period (continued)
<rxm> (Average Rx main power, single carrier)
<rxm0> (Average Rx main power, first carrier for dual carrier device)
<rxm1> (Average Rx main power, second carrier for dual carrier device)
<rxd> (Average Rx diversity power, single carrier)
<rxd0> (Average Rx diversity power, first carrier for dual carrier device)
<rxd1> (Average Rx diversity power, second carrier for dual carrier device)
<tx> (Average Tx power on main antenna):
• Signed int16 (2 bytes)
• Typical range -120dBm to -20dBm
+WTBI Enable/disable GSM/GPRS Tx Burst indication
Supporting chipsets: Enable use of DIO channel 1 (GPIO_0) to indicate an upcoming GPRS Tx burst. (GSM/
• MDM6200 (min f/w rev: GPRS/EDGE mode only)
P0_0_7_1) When enabled, the modem:
• Asserts the GPIO ~200 µs before a Tx burst starts. (Provides time for the host to
turn off peripherals before the burst.)
• Deasserts ~40 µs after the burst completes. (Provides time to ensure RF activity is
finished.)
Note: If DIO channel 1 has been programmed as an input or output using AT!DIOCFG,
the indication cannot be enabled.
Usage:
• Execution: AT+WTBI=<state>
Response: OK
Purpose: Enable/disable the Tx Burst indication.
• Query: AT+WTBI?
Response: +WTBI: <state>
OK
Purpose: Display the current indication state (enabled/disabled).
• Query List: AT+WTBI=?
Purpose: Display valid parameter values.
Parameters:
<state> (Indication state, stored in NV memory):
• 0=Disabled (Default)
• 1=Enabled
Command summary
Table 4-1 lists the commands described in this chapter.
Command reference
Table 4-2: Diagnostic command details
Command Description
Command summary
Table 5-1 lists the commands described in this chapter.
Command reference
Table 5-2: Test command details
Command Description
Command summary
Table 6-1 lists the commands described in this chapter:
Table 6-1: Memory management command passwords
Command Description Page
Command reference
Table 6-2: Memory management command details
Command Description
Command summary
Table 7-1 lists the commands described in this chapter:
Command reference
Table 7-2: SIM command details
Command Description
Note: This command can only be used when the second bit (Bit 1) of the
“PCSCDISABLE” customization bitmap is not set. (See !CUSTOM in
AirPrime MC8xxx Embedded Modules Extended AT Command
Reference.)
Parameters:
<randNumber>:
• 16 bytes (32 hexadecimal digits) random number), without leading ‘0x’.
• Example: 123A567B9012C4567D90123E56789012
<SRES> (SIM response):
• 4 bytes (8 hexadecimal digits), without leading ‘0x’.
• Example: 500e2879
<key> (Ciphering key):
• 8 bytes (16 hexadecimal digits), without leading ‘0x’.
• Example: ec793ac5662e7000
!ICCID Return (U)SIM card’s ICCID
Supporting modems: Return a (U)SIM’s ICCID (Integrated Circuit Card ID).
• All Usage:
• Query: AT!ICCID?
Response: !ICCID: <iccid>
OK
Purpose: Display the ICCID.
Parameters:
<iccid> (ICCID of the (U)SIM currently being tested):
• 20 digit decimal number—This number is often printed on the (U)SIM
card.
R V
&V, return AT configuration parameters, 17, 72
!REL, query the active protocol/revision, 52
V, set result code format mode, 19
!RESET, reset the modem, 52
acronyms, 11
application auto-launch, query/set, 56
D
ARFCN, 2G, return, 41
diagnostic information, display, 78
AT command parameters, display, 72
DISC (Tx/Rx) statistics, display/clear, 76
AT commands
DL modulation values, return, 36
3GPP 27.005 commands, list, 19 DM (Tx/Rx) statistics, display/clear, 76
3GPP 27.007 commands, list, 20
DNS address
3GPP, standard, 9
all profiles, query, 55
guard time, escape sequence, 11 query/set, 54
ITU-T V.250 commands, list, 17
timing, entry, 10
E
B Ec/Io
display, 69
bad frame statistics, display/clear, 76
strongest cell values, return, 37
band erase profile information, 57
2G network, return, 41
escape sequence guard time, 11
current active band, return, 39
E-TFCI average values, enable/disable/query, 38
current GSM, return, 43
current WCDMA, return, 43
bands F
available/current/set, 30
base station, color code and identity code, 2G, return, 41 FIFO interface, activate/deactivate PDP context, 53
BCCH frequency level, 2G, return, 41 firmware
bearer, call progress notification, 63 update, wait in bootloader mode, 31
boot and hold. See bootloader. upgrading, 11
bootloader version, return, 49, 49
version, return, 31 frequency bands. See bands.
wait for firmware update, 31
bootup time, return, 43
G
C glossary, 11
GMM state, return, 43
call identification number, call progress notification, 63 guard time, AT escape sequence, 11
call progress notification, enable/disable, 63
call state, call progress notification, 63
cell ID, 2G, return, 41
H
cell selection criteria, 2G, return, 41 hardware version, 49
channel number
current GSM, return, 43
I PIN2, query/verify, 34
power down system, 51
ICCID, display, 82, 83 primary scrambling code, display, 68, 69
IP address display, profile ID, 56 profile
ITU-T V.250 commands, list, 17 WINS addresses, 57
profile ID
application auto-launch, query/set, 56
L default, query/set, 54
DNS address, query/set, 54
LAC, 2G, return, 41
DNS addresses for all profiles, query, 55
loudspeaker volume query/set, internal, 32 erase information, 57
for LTE network attach, 55
M IP address, display, 56
password prompt, query/set, 56
MCC, 2G, return, 41 See also PDP context.
MM SWI-specific information, query/set, 56
state and substate, return, 43 protocol, current, 52
MNC, 2G, return, 41 PS state, return, 43
mode acquired by modem, return, 43 PSC, display, 68
mode, query/set, 65 PUK attempts remaining, number of, 34
modem
configuration, query/set, 65
mode, query/set, 65
R
mode, return, 43 radio access technology. See RAT.
network acquisition order, query/set, 65 RAT
networks, supported, 33
current, display description, 40
operational status, return, 43
current, query/set, 59
reset, 40, 52 received signal code power
reset, wait for firmware update, 31
display, 69
roaming support, query/set, 65
return, 53
service domain support, query/set, 65 reset modem, 31, 40, 52
SIM status, query/set, 65
roaming support, query/set, 65
status commands, list, 12, 27
routing area code, 2G, return, 41
modulation values, return, 36 RSCP, return, 53
MSC revision, current, 52
Rx, minimum level to register, 2G, return, 41
multi-party status, call progress notification, 63
muting voice call, enable/disable, 32
MUX, secondary SIO port, configure for CS, 36 S
SABM (Tx/Rx) statistics, display/clear, 76
N scrambling codes, display, 69
scripts
N1/N2 counts, display/clear, 76
testing, command timing, 10
network
SD card
acquisition order, query/set, 65 installation status, 57
available for use, 33
search window size, display, 69
color code, 2G, return, 41
secondary scrambling code, display, 69
currently in use, 33 serial I/O. See SIO.
information, 2G, return, 41
service
supported by modem, 33
availability, display, 66
domain, display, 66
P domain, query/set, 58
service domain support, query/set, 65
password session counters, display/clear, 76
profile ID prompt, query/set, 56 SGSN revision, current, 52
PDP context SIM
activate/deactivate for FIFO interface, 53 authentication, 82
See also profile ID card type, return, 31
PIN attempts remaining, number of, 34 ICCID, display, 82, 83