advertisement
UMTS Modems
Supported AT Command Reference
Includes:
AC850
AC860
AC875 / AC875U
AC880 / AC880E / AC880U
AC881 / AC881E / AC881U
MC8755 / MC8755V / MC8765
MC8775 / MC8775V
MC8780 / MC8781
2130617
Rev 2.4
Preface
Important Notice
Limitation of
Liability
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 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 Hazards
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 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.
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 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
Rev 2.4 Jan.08
Proprietary and Confidential 1
Supported AT Command Reference
Patents
Copyright
Trademarks
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.
Portions of this product may be covered by some or all of the following US patents:
5,515,013 5,629,960 5,845,216 5,847,553 5,878,234
5,890,057 5,929,815 6,169,884 6,191,741 6,199,168
6,339,405 6,359,591 6,400,336 6,516,204 6,561,851
6,643,501 6,653,979 6,697,030 6,785,830 6,845,249
6,847,830 6,876,697 6,879,585 6,886,049 6,968,171
6,985,757 7,023,878 7,053,843 7,106,569 7,145,267
7,200,512 D442,170 D459,303 and other patents pending.
This product includes technology licensed from:
QUALCOMM
®
3G
Licensed by QUALCOMM Incorporated under one or more of the following United States patents and/or their counterparts in other nations:
4,901,307 5,056,109 5,101,501 5,109,390 5,228,054
5,267,261 5,267,262 5,337,338 5,414,796 5,416,797
5,490,165 5,504,773 5,506,865 5,511,073 5,535,239
5,544,196 5,568,483 5,600,754 5,657,420 5,659,569
5,710,784 5,778,338
Manufactured or sold by Sierra Wireless or its licensees under one or more patents licensed from InterDigital Group.
©2008 Sierra Wireless. All rights reserved.
AirCard
®
and “Heart of the Wireless Machine
®
” are registered trademarks of Sierra Wireless. Watcher
®
is a trademark of
Sierra Wireless, registered in the European Community.
Sierra Wireless, the Sierra Wireless logo, the red wave design, and the red‐tipped antenna are trademarks of Sierra Wireless.
2 Proprietary and Confidential 2130617
Preface
Windows
®
is a registered trademark of Microsoft Corporation.
QUALCOMM
®
is a registered trademark of QUALCOMM
Incorporated. Used under license.
Other trademarks are the property of the respective owners.
Contact
Information
Sales Desk: Phone: 1-604-232-1488
Hours: 8:00
AM
to 5:00
PM
Pacific Time
E-mail: [email protected]
Post: Sierra Wireless
13811 Wireless Way
Richmond, BC
Canada V6V 3A4
Fax: 1-604-231-1109
Web: www.sierrawireless.com
Consult our website for up‐to‐date product descriptions, documentation, application notes, firmware upgrades, trouble‐ shooting tips, and press releases: www.sierrawireless.com
Revision History
Revision number
2.3
Release date
Jul 2007
2.4
Jan 2008
Changes
•
•
•
added detail for
!SMSRETRY
•
Rev 2.4 Jan.08
Proprietary and Confidential 3
Supported AT Command Reference
4 Proprietary and Confidential 2130617
Table of Contents
Supported GSM / WCDMA AT Commands . . . . . . . . . . . . . . . . . .15
Modem Status, Customization, and Reset Commands . . . . . . . .25
Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Rev 2.4 Jan.08
5
Supported AT Command Reference
Memory Management Commands . . . . . . . . . . . . . . . . . . . . . . . . . 59
SIM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6 2130617
1: About this Guide
•
•
•
•
•
•
Introduction
This document describes standard and proprietary AT commands that are available for users of UMTS AirCard modems and Mini Card embedded modules.
The standard 3GPP AT commands for UMTS devices are described in two standards documents available from the
3GPP (3rd Generation Partnership Project) web site, www.3gpp.org
:
•
TS 27.007 AT command set for User Equipment (UE)
•
TS 27.005 Use of Data Terminal Equipment ‐‐ Data Circuit
terminating Equipment (DTE‐DCE) interface for Short Message
Service (SMS) and Cell Broadcast Service (BSE)
The proprietary AT commands are supplemental to the standard AT commands.
For normal operation of the modem, consult the GSM AT
Command Reference (document number 2130213). You may also want to consult the other documents available in the AC8xx/
MC87xx Development Kit or on our Internet site at www.sierrawireless.com
Note: Some standard 3GPP commands are NOT supported, or are
partially supported. These commands are identified in Supported
GSM / WCDMA AT Commands , page 15 .
1
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.
Rev 2.4 Jan.08
7
8
Supported AT Command Reference
Note: Revision codes that include letters, such as 2.1A, are to be considered drafts and are subject to change before final release.
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 will be returned if the command is not recognized or is not permitted in the current state or condition of the modem.
Terminology and acronyms
This document makes use of acronyms that are in common use in data communications and cellular technology. Our Internet site provides a Glossary of Terms and Acronyms (document number 2130891) that may be helpful in understanding some acronyms and terminology used in this guide.
Current firmware versions
Versions
Document
This document is revised periodically as new firmware versions are released. This edition is:
Rev 2.4 Jan.08
Applicability of commands to different modules
Each command listed in this guide includes a list of supporting
AC8xx and MC87xx modules. Unless otherwise noted, the following minimum firmware revisions are required to support the listed commands:
•
AC850 / AC860 / MC8755 / MC8765 – Revision U1_2_0 or higher
•
AC875 / MC8775 / MC8775V – Revision H1_0_0_0 or higher
•
AC880 / MC8780 / MC8781 – Revision D1_0_3_0ap /
F1_0_0_0ap or higher
To determine your firmware revision:
•
Enter the identification command
AT+GMR
The modem responds with version information for software, firmware, and hardware.
The details following the revision number include Sierra
Wireless information on the specific build followed by the date and time of the build.
+GMR: … F/W VER: R1_0_0_…
2130617
Upgrading
If your modem firmware is an earlier version, you can acquire updated firmware by contacting your account manager.
Document structure
This document assumes you have the 3GPP TS 27.007 AT
command documentation (see page 7
). This reference includes a chapter covering
the proprietary commands listed in the tables below. Each table corresponds to one chapter in this guide.
Note: The ‘Supporting modems’ column indicates which Mini Card embedded module (MC) and AirCard modem (AC) models support each command. If an entry is marked with an asterisk (‘*’), a firmware upgrade may be required. See the detailed command entry for details.
Modem Status, Customization, and Reset Commands
This chapter describes commands used to determine modem status, adjust customization settings, and reset the modem.
Table 1-1: Modem status and reset commands
Cmnd Pg Description
Supporting modems
All
Selects a set of frequency bands / queries current selection
Returns the bootloader version
Resets modem and waits in bootloader for firmware download
Returns SIM card mode (card type)
Sets / returns internal loudspeaker volume
Enables / disables uplink voice muting
Returns current, available, and supported network technologies
Returns or enables / disables return of averaged CQI
(Channel Quality Indicator) value (WCDMA only)
Configures secondary SIO port for circuit-switched data
Returns total Energy per chip per power density value
Returns the current active band
All
All
All*
All*
All
All
All*
All*
All*
All
Rev 2.4 Jan.08
9
Supported AT Command Reference
Table 1-1: Modem status and reset commands (Continued)
Cmnd Pg Description
Supporting modems
Returns the current active radio access technology (RAT)
All
Returns the modem’s production IMEI
All*
Displays 2G network information
Returns the modem hardware version
Assigns appropriate USB endpoint AT port
All
All
All
All
All*
AC880 / 881
MC8780 / 81
!REL
!RESET
Returns current temperature information
Returns current power supply voltage information
Queries the active protocol / revision
Returns Received Signal Code Power (RSCP) (WCDMA only)
MC (all)
MC (all)
All
All
All
All*
!SCACT
!SCDFTPROF
!SCDNS
!SCPROF
!SCPADDR
!SMSRETRY
Activates / deactivates PDP context for FIFO interface
Queries / sets the default profile ID
Queries / sets profile ID DNS address
Queries / sets SWI-specific profile information
Displays IP address for specified PDP context
Queries / sets current service domain
Queries / sets current radio access technology (RAT)
Queries / sets SMS retry period and interval
All
All
All
All
All
All
All
MC8780 / 81
AC880 / 881
43 Enables / disables SMS status reports
Enables / disables Call Progress Notification
Queries / sets system configuration information
MC8775 /
75V / 80 / 81
AC875 / 880 /
881
All
All*
10 2130617
Table 1-1: Modem status and reset commands (Continued)
Cmnd Pg Description
Returns service status information
Queries / sets current time of day
Queries / sets current time of day
Displays Primary Scrambling Code (WCDMA only)
Displays WCDMA set information
Return operating mode AT configuration parameters
* A firmware upgrade may be required, as noted in the detailed listing for this command.
All*
All
All
All
Supporting modems
All*
All
This chapter describes commands used to select frequency bands and diagnose problems.
Table 1-2: Diagnostic commands
Cmnd Pg Description
Enables / disables ciphering and integrity settings
55 Displays / clears 27.010 statistics
* A firmware upgrade may be required, as noted in the detailed listing for this command.
Supporting modems
All*
All
All
This chapter describes commands required to place the modem in particular modes of operation, test host connectivity, and configure the transmitters and receivers for test measurements.
Table 1-3: Test commands
Cmnd Pg
!ERR
Description
Displays diagnostic information
Supporting modems
All
All
All
This chapter describes commands that control the data stored in non‐volatile memory of the modem.
Rev 2.4 Jan.08
11
Supported AT Command Reference
Table 1-4: Memory management commands
Cmnd Pg Description
59 Backs up items stored in non-volatile memory
Supporting modems
All
This chapter describes commands that communicate with an installed (U)SIM.
Table 1-5: SIM commands
Cmnd Pg Description
61 Returns (U)SIM card’s ICCID
Supporting modems
All
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; param‐ eters 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.
12 2130617
Result Code
This is a numeric or text code that is returned after all commands (except resets). 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
Rev 2.4 Jan.08
13
Supported AT Command Reference
14 2130617
2: Supported GSM / WCDMA AT
Commands
This chapter identifies which ITU‐T Recommendation V.250,
3GPP TS 27.005, and 3GPP TS 27.007 AT commands are supported on regular and voice‐enabled Sierra Wireless
AirCard modems (850/860/875/880/881) and Mini Card embedded modules (MC8755/65/75/80/81). These commands are used to:
•
Control serial communications over an asynchronous interface (ITU‐T Recommendation V.250)
•
Control SMS functions for devices on GSM/WCDMA networks (3GPP TS 27.005)
•
Control devices operating on GSM/WCDMA networks
(3GPP TS 27.007)
The ITU‐T specification, Serial Asynchronous Dialling and
Control (Recommendation V.250), is available on the International
Telecommunication Union web site, www.itu.int
, and the
3GPP specification documents, 3GPP TS 27.007 V3.13.0 (2003‐
03) and 3GPP TS 27.007 V3.13.0 (2003‐03), are available on the
3GPP web site, www.3gpp.org
.
The tables below identify whether each command is supported on AirCard modems and Mini Card embedded modules. An
“N/A” in the Supported column of the table indicates that the command is related to a feature (such as voice) that is not available on the modems.
Some commands are partially supported—the descriptions for these commands identify any limitations on command usage.
Also, some commands are described in more detail in later chapters—the descriptions for these commands link to those
detailed entries (for example, &V in Table 1).
Table 1: Supported ITU-T Recommendation V.250 AT commands
Command Description
&C
Set Data Carrier Detected (Received line signal detector) function mode
No
Set Data Terminal Ready function mode No
Supported
&D
&F
&S
&T
Set all current parameters to manufacturer’s defaults
Set DSR signal
Auto tests
No
No
No
2
Rev 2.4 Jan.08
15
Supported AT Command Reference
Table 1: Supported ITU-T Recommendation V.250 AT commands (Continued)
Command Description Supported
M
O
I
L
P
Q
DL
E
H
+GMR
+GOI
+GSN
+ICF
+IFC
+ILRR
+IPR
A
&V
&W
+DR
+DS
+GCAP
+GMI
+GMM
A/
D
D><MEM><N>
D><N>
D><STR>
Return operating mode AT configuration parameters
Store current parameter to user-defined profile
V42bis data compression report
V42bis data compression
Request complete TA capabilities list
Request manufacturer identification
Request TA model identification
Request TA revision identification
Request global object identification
Request TA serial number identification
Set TE-TA control character framing
Set TE-TA local data flow control
Set TE-TA local rate reporting mode
Set fixed local rate
Answer incoming call
Re-issues last AT command given
Dial
Originate call to phone number in memory <MEM>
Originate call to phone number in current memory
Originate call to phone number in memory which corresponds to alphanumeric field <STR>
Redial last telephone number used
Set command echo mode
Disconnect existing connections
Display product identification information
Set monitor speaker loudness
Set monitor speaker mode
Switch from command mode to data mode
Select pulse dialing
Set Result code presentation mode
No
Yes
Yes
Yes
No
No
No
No
No
Yes
No
Yes
Yes
Yes
No
Yes
Yes
No
Yes
No
Yes
No
Yes
No
Yes
No
Yes
Yes
Yes
16 2130617
Supported GSM / WCDMA AT Commands
Table 1: Supported ITU-T Recommendation V.250 AT commands (Continued)
Command Description Supported
S4
S5
S6
S7
S0
S10
S3
V
X
S8
T
Z
Set number of rings before automatically answering the call
Set disconnect delay after indicating the absence of data carrier
Set command line termination character
Set response formatting character
Set command line editing character
Set pause before blind dialing
Set number of seconds to wait for connection completion
Set number of seconds to wait when comma dial modifier used
Select tone dialing
Set result code format mode
Set connect result code format and call monitoring
Set all current parameters to user-defined profile
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Table 2: Supported 27.005 AT commands
Command Description
+CMNA
+CNMI
+CPMS
+CRES
+CSAS
+CSCA
+CSCB
+CMGC
+CMGD
+CMGF
+CMGL
+CMGR
+CMGS
+CMGW
+CMSS
Send command
Delete message
Message format
List messages
Read message
Send message
Write message to memory
Send message from storage
New message acknowledgement to ME/TA
New message indications to TE
Preferred message storage
Restore settings
Save settings
Service centre address
Select cell broadcast message types
Yes
No
No
Yes
Yes
Yes
Yes
Yes
Yes
Supported
Yes
Yes
Yes
Yes
Yes
Yes
Rev 2.4 Jan.08
17
Supported AT Command Reference
Table 2: Supported 27.005 AT commands (Continued)
Command Description
+CSDH
+CSMP
+CSMS
+CBM
+CMT
+CDS
+CBMI
Show text mode parameters
Set text mode parameters
Select message service
Cell broadcast message directly displayed
Incoming message directly displayed
SMS status report after sending a SMS
Cell broadcast message stored in memory at specified <index> location
+CMTI
Incoming message stored in <mem> (“SM” - (U)SIM message storage) at location <index>
Incoming SMS status report
+CDSI
+CMS ERROR:
<err>
SMS error (mobile or network error)
Supported
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
Yes
Yes
Table 3: Supported 27.007 AT commands
Command Description
C
+CACM
+CACSP
+CAEMLPP
Support
Partial ITU T V.24 circuit 109 carrier detect signal behavior command
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
Accumulated call meter No
Voice Group or Voice Broadcast Call State Attribute Presentation N/A eMLPP Priority Registration and Interrogation No
+CAHLD
+CAJOIN
+CALA
+CALCC
+CALD
+CALM
Leave an ongoing Voice Group or Voice Broadcast Call
Accept an incoming Voice Group or Voice Broadcast Call
Alarm
List current Voice Group and Voice Broadcast Calls
Delete alarm
Alert sound mode
N/A
N/A
N/A
N/A
N/A
No
18 2130617
Supported GSM / WCDMA AT Commands
Table 3: Supported 27.007 AT commands (Continued)
Command Description
+CBC
+CBST
+CCCM
+CCFC
+CCLK
+CCUG
+CCWA
+CCWE
+CAMM
+CANCHEV
+CAOC
+CAPD
+CAPTT
+CAREJ
+CAULEV
+CDIP
+CDIS
+CEER
+CFUN
+CGACT
+CGANS
+CGATT
+CGAUTO
+CGCLASS
Accumulated call meter maximum
NCH Support Indication
Advice of Charge
Postpone or dismiss an alarm
Talker Access for Voice Group Call
Reject an incoming Voice Group or Voice Broadcast Call
Voice Group Call Uplink Status Presentation
Battery charge
Select bearer service type
Current call meter value
Call forwarding number and conditions
Clock
Closed user group
Call waiting
Call Meter maximum event
Called line identification presentation
Display control
Extended error report
Set phone functionality
Format
•
+CFUN = [ <fun> [, <rst>] ]
Limitations
•
Valid <fun> values:
·
0 (minimum functionality, low power draw)
·
1 (full functionality, high power draw)
PDP context activate or deactivate Yes
Manual response to a network request for PDP context activation No
PS attach or detach Yes
No Automatic response to a network request for PDP context activation
GPRS mobile station class Yes
No
No
No
Partial
N/A
Yes
Yes
No
Yes
Yes
No
Yes
No
No
No
N/A
N/A
N/A
N/A
Support
Rev 2.4 Jan.08
19
Supported AT Command Reference
Table 3: Supported 27.007 AT commands (Continued)
Command Description
+CGQREQ
+CGREG
+CGSMS
+CGSN
+CGTFT
+CHLD
+CHSA
+CHSC
+CHSD
+CHSR
+CHST
+CHSU
+CHUP
+CIEV
+CGCLOSP
+CGCMOD
+CGDATA
+CGDCONT
+CGDSCONT
+CGEQMIN
+CGEQNEG
+CGEQREQ
+CGEREP
+CGEV
+CGMI
+CGMM
+CGMR
+CGPADDR
+CGQMIN
Configure local octet stream PAD parameters
PDP Context Modify
Enter data state
Define PDP Context
Define Secondary PDP Context
3G Quality of Service Profile (Minimum acceptable)
3G Quality of Service Profile (Negotiated)
3G Quality of Service Profile (Requested)
Packet Domain event reporting
GPRS network event indication
Request manufacturer identification
Request model identification
Request revision identification
Show PDP address
Quality of Service Profile (Minimum acceptable)
Quality of Service Profile (Requested)
GPRS network registration status
Select service for MO SMS messages
Request product serial number identification
Traffic Flow Template
Call related supplementary services
HSCSD non-transparent asymmetry configuration
HSCSD current call parameters
HSCSD device parameters
HSCSD parameters report
HSCSD transparent call configuration
HSCSD automatic user initiated upgrading
Hangup call
Indicator event
20
Yes
Yes
N/A
N/A
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
N/A
N/A
N/A
N/A
Yes
No
No
No
No
Yes
Yes
Yes
Yes
Support
2130617
Supported GSM / WCDMA AT Commands
Table 3: Supported 27.007 AT commands (Continued)
Command Description
+CMEE
+CMER
+CMOD
+CMUT
+CMUX
+CNUM
+COLP
+COPN
+COPS
+CPAS
+CPBF
+CPBR
+CPBS
+CPBW
+CIMI
+CIND
+CKEV
+CKPD
+CLAC
+CLAE
+CLAN
Request international mobile subscriber identity
Indicator control
Key press or release event
Keypad control
List all available AT commands
Language Event
Set Language
+CLCC
+CLCK
+CLIP
+CLIR
List current calls
Facility lock
Calling line identification presentation
Calling line identification restriction
+CLVL
+CMAR
Sets / returns internal loudspeaker volume
Master Reset
+CME ERROR:
<err>
Mobile Termination error result code
+CMEC
Mobile Termination control mode
Report Mobile Termination error
Mobile Termination event reporting
Call mode
Enables / disables uplink voice muting
Multiplexing mode
Subscriber number
Connected line identification presentation
Read operator names
Operator selection
Phone activity status
Find phonebook entries
Read phonebook entries
Select phonebook memory storage
Write phonebook entry
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
No
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
No
No
No
Yes
Yes
Support
No
No
No
No
Rev 2.4 Jan.08
21
Supported AT Command Reference
Table 3: Supported 27.007 AT commands (Continued)
Command Description
+CSCS
+CSDF
+CSGT
+CSIL
+CSIM
+CSNS
+CSQ
+CSSN
+CSTA
+CSTF
+CSVM
+CTFR
+CTZR
+CTZU
+CPIN
+CPOL
+CPROT
+CPUC
+CPWC
+CPWD
+CR
+CRC
+CREG
+CRING
+CRLP
+CRMP
+CRSL
+CRSM
+CSCC
Enter PIN
Preferred operator list
Enter protocol mode
Price per unit and currency table
Power class
Change password
Service reporting control
Cellular result codes
Network registration
Incoming call type
Radio link protocol
Ring Melody Playback
Ringer sound level
Restricted SIM access
Secure control command
Select TE character set
Settings date format
Set Greeting Text
Silence Command
Generic SIM access
Single numbering scheme
Signal quality
Supplementary service notifications
Select type of address
Settings time format
Set Voice Mail Number
Call deflection
Time Zone Reporting
Automatic Time Zone Update
22
No
No
N/A
No
Yes
Yes
Yes
Yes
N/A
N/A
Yes
No
Yes
No
Yes
N/A
Yes
Yes
N/A
N/A
Yes
Yes
Yes
Yes
Yes
Support
No
No
No
No
2130617
Supported GSM / WCDMA AT Commands
Table 3: Supported 27.007 AT commands (Continued)
Command Description
+CUSD
+CV120
+CVHU
+CVIB
D
D*99#
D*99***<n>#
+WS46
Yes
Support
Unstructured supplementary service data
V.120 rate adaption protocol
Voice Hangup Control
Vibrator mode
ITU T V.25ter [14] dial command
Sets up a packet data call (PDP context) based on profile ID #1 Yes
Sets up a packet data call (PDP context) based on profile ID #<n>
(<n> is the <cid> in the +CGDCONT command)
Yes
PCCA STD 101 [17] select wireless network No
No
No
N/A
Yes
Rev 2.4 Jan.08
23
Supported AT Command Reference
24 2130617
3: Modem Status, Customization, and Reset Commands
•
•
•
Introduction
This chapter describes commands used to reset the modem, adjust customization settings, retrieve the firmware version, and monitor the temperature, voltage, and modem status.
Command summary
The table below lists the commands described in this chapter.
Table 3-1: Modem status commands
!BAND
!BCINF
Command
!BOOTHOLD
^CARDMODE
+CLVL
+CMUT
!CNTI
+CQI
+CSDONSIO2
+ECIO
!GETBAND
!GETRAT
!GRELIMEI
!GRESET
!GSMINFO
!GSTATUS
!GVER
^HVER
Description
Selects a set of frequency bands / queries current selection
Returns the bootloader version
Resets modem and waits in bootloader for firmware download 28
Returns SIM card mode (card type) 28
Sets / returns internal loudspeaker volume
Enables / disables uplink voice muting
Returns current, available, and supported network technologies 29
Returns or enables / disables return of averaged CQI (Channel
Quality Indicator) value (WCDMA only)
Configures secondary SIO port for circuit-switched data
Returns total Energy per chip per power density value
Returns the current active band
Returns the current active radio access technology (RAT)
Returns the modem’s production IMEI
Displays 2G network information
Returns the modem hardware version
Page
3
Rev 2.4 Jan.08
25
Supported AT Command Reference
Table 3-1: Modem status commands (Continued)
Command
!NVPORTSET
!PCTEMP
!PCVOLT
!POWERDOWN
!REL
!RESET
+RSCP
!SCACT
!SCDFTPROF
!SCDNS
!SCPROF
!SCPADDR
!SELMODE
!SELRAT
!SMSRETRY
!SMSSTSEN
!SWICALLPROG
^SYSCONFIG
^SYSINFO
!TIME
!UDINFO
+UPSC
+USET
&V
Description
Assigns appropriate USB endpoint AT port
Returns current temperature information
Returns current power supply voltage information
Queries the active protocol / revision
Returns Received Signal Code Power (RSCP) (WCDMA only) 37
Activates / deactivates PDP context for FIFO interface 38
Queries / sets the default profile ID
Queries / sets profile ID DNS address
Queries / sets SWI-specific profile information
Displays IP address for specified PDP context
Queries / sets current service domain
Queries / sets current radio access technology (RAT)
Page
Queries / sets SMS retry period and interval
Enables / disables SMS status reports
Enables / disables Call Progress Notification
Queries / sets system configuration information
Returns service status information
Queries / sets current time of day
Returns information from active USB descriptor
Displays Primary Scrambling Code (WCDMA only)
Displays WCDMA set information
Return operating mode AT configuration parameters
26 2130617
Modem Status, Customization, and Reset Commands
Command reference
Table 3-2: Modem status, customization, and reset commands
Command Description
!BAND=<bandsetInd>
!BAND=?
!BAND?
Supporting modems:
•
All
Selects a set of frequency bands / queries current selection
This command is used to configure the modem to operate on a set of frequency bands, to look up the sets available, and to query the current selection. These band sets are preconfigured by your device’s manufacturer.
Usage:
•
AT!BAND=? reports allowed values for <bandsetInd> and the corresponding frequency bands.
•
AT!BAND=<bandsetInd> is used to select a set of bands.
•
AT!BAND? reports the current band selection.
Parameters:
<bandsetInd> (band index value):
•
00 = All bands
•
01 = WCDMA 2100
•
02 = WCDMA 850/1900
•
03 = GSM 900/1800
•
04 = GSM 850/1900
•
05 = GSM ALL
•
06 = WCDMA 2100 GSM 900/1800
•
07 = WCDMA 850/1900 GSM 850/1900
•
08 = WCDMA ALL
•
09 = WCDMA 850/2100
•
0A = WCDMA 800/2100
•
0B = WCDMA 850/2100 GSM 900/1800
Rev 2.4 Jan.08
27
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!BCINF
Supporting modems:
•
All
!BOOTHOLD
Supporting modems:
•
All
Returns the bootloader version
This command is used to return the module’s bootloader version.
Usage:
•
AT!BCINF returns several values—the bootloader version is the second parameter returned.
Example:
AT!BCINF returns:
BOOT
Address: <...>
Version: <version>
...
Parameters:
<version> (bootloader version):
•
ASCII string
•
Maximum length: 84 characters
•
Example: H1_0_0_0ACBT G:/WS/FW/H1_0_0_0ACBT/MSM6280/
SRC 2006/09/01 16:33:30
Resets modem and waits in bootloader for firmware download
This command is used to prepare for a firmware download by resetting the modem and waiting in ‘boot and hold’ mode.
Usage:
•
AT!BOOTHOLD forces the modem to backup user NV options, reset, and then wait in boot and hold mode for a firmware download.
^CARDMODE
Supporting modems:
•
All
Returns SIM card mode (card type)
This command is used to identify the type of SIM card being used.
Returned parameters:
<sim_type> (the type of sim card)
•
0 = unknown
•
1 = SIM
•
2 = USIM
28 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
+CLVL=<level>
+CLVL=?
+CLVL?
Supporting modems:
•
All (with exceptions below)
•
MC8755/55V/65 (minimum
FW rev: U1_2_9mcap)
•
AC850/860 (minimum
FW rev:U1_2_7acap)
Sets / returns internal loudspeaker volume
This command is used to set or report the modem’s internal loudspeaker volume.
Usage:
•
AT+CLVL=<level> sets the volume within a specified range
•
AT+CLVL=? reports allowed values for <level>
•
AT+CLVL? reports the current volume
Parameters:
<level> (Sound level):
•
Manufacturer-specific volume levels
•
Valid range: 0(lowest)–7(highest)
+CMUT=<enableFlag>
+CMUT=?
Supporting modems:
•
All voice-enabled modems
Enables / disables uplink voice muting
This command is used to enable or disable uplink voice muting during a voice call.
Usage:
•
AT+CMUT=<enableFlag> turns muting on or off
•
AT+CMUT=? returns valid <enableFlag> values
Parameters:
<enableFlag> (Enable / disable muting):
•
0 = Mute off
•
1 = Mute on
*CNTI=<n>
Supporting modems:
•
All
Returns current, available, and supported network technologies
This command is used to report the network technology currently being used, the technologies available for use, or the technologies supported by the modem.
Usage:
•
AT*CNTI=<n> returns
*CNTI: <n>,<tech>[,<tech>[...]]
Parameters:
<n> (reporting option):
•
0 = Network technology currently in use
•
1 = Available technologies on current network
•
2 = All technologies supported by the modem
<tech> (technology type):
•
ASCII string
•
Valid values: “GSM”, “GPRS”, “EDGE”, “UMTS”, “HSDPA”, “HSUPA”
(only when <n> = 1)
Rev 2.4 Jan.08
29
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
+CQI?
+CQI=<enableFlag>
Supporting modems:
•
All
CSDONSIO2?
!CSDONSIO2=<port#>
Supporting modems:
•
All
Returns or enables / disables return of averaged CQI
(Channel Quality Indicator) value (WCDMA only)
This command returns the averaged CQI from the modem.
Usage:
•
AT!CQI? returns the average CQI and the number of samples used to determine the average. For example:
+CQI: total valid samples 1600, average cqi 26
•
AT!CQI=<enableFlag> enables or disables the query version of the command (+CQI?)
Parameters:
<enableFlag> (enable / disable CQI value retrieval):
•
0 = Disable retrieval
•
1 = Enable retrieval
Configures secondary SIO port for circuit-switched data
This command configures the secondary serial I/O (SIO) port for circuitswitched data over the main AT port, MUX1/MUX2/MUX3, or a virtual serial port (VSP1/VSP2/VSP3).
Note: The modem must be reset before any change takes effect.
Usage:
•
AT!CSDONSIO2? returns the current port number currently used for the SIO port. For example:
+CSDONSIO2:
<port#>
•
AT!CSDONSIO2=<port#> sets the port number to use for the SIO port.
Parameters:
<port#> (Port used for circuit-switched data):
•
0 = CSD on main AT port (Default)
•
1 = CSD on MUX1 (VSP1 on AirCard modems)
•
2 = CSD on MUX2 (VSP2 on AirCard modems)
•
3 = CSD on MUX3 (VSP3 on AirCard modems)
30 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
+ECIO?
Supporting modems:
•
All
!GETBAND?
Supporting modems:
•
All
!GETRAT?
Supporting modems:
•
All
Returns total Energy per chip per power density value
(WCDMA only)
This command returns the total energy per chip per power density (Ec/Io) value of the active set’s three strongest cells.
Usage:
•
AT!ECIO? returns the signed dB value as a range from strongest to weakest cell, based on RSCP. For example:
+ECIO:
Ec/Io: -3.5 dB -24.5 dB
•
Valid range = -31.5 dB to 0 dB
Returns the current active band
This command returns the active band currently being used by the modem.
Usage:
•
AT!GETBAND? returns a description of the current active band, or returns an error message.
Returns the current active radio access technology
(RAT)
This command returns the RAT currently being used by the modem.
Usage:
•
AT!GETRAT? returns a description of the current RAT, or returns an error message.
!GRELIMEI?
Supporting modems:
•
All
!GRESET
Supporting modems:
•
All
Returns the modem’s production IMEI
This command returns the modem’s 15-character unique IMEI.
Usage:
•
AT!GRELIMEI? returns the <imei> assigned to the modem.
Parameters:
<imei>
•
15-character IMEI assigned to the modem
Resets the modem
This command performs a modem reset.
Note: This command is identical in function to
.
Rev 2.4 Jan.08
31
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!GSMINFO?
Supporting modems:
•
MC8775 (minimum
FW rev: H1_1_8_13mcap)
•
MC8780 / 81
•
AC875 (minimum
FW rev: H1_1_8_13acap)
•
AC880 / 881
Displays 2G network information
This command returns 2G network information for the ‘serving’ cell and up to 6 ‘neighbor’ cells.
Parameters: (referenced in example below)
<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
<rac>: Routing Area Code
•
8-bit decimal
<minrx>: Minimum Rx level (dBm) needed to register
•
16-bit decimal
<maxrach>: Reserved for future use
•
16-bit decimal
<band>: Indicates the 2G network band
•
Valid values: “E900”, “P900”, “1900”, “1800”, “850”, “Unknown”
<arfcn>: Absolute Radio Frequency Channel Number
•
16-bit decimal
<rxlvl>: Received BCCH frequency level (dBm)
•
16-bit decimal
<c1>: C1 cell selection criteria
•
16-bit decimal
<c2>: C2 cell selection criteria
•
16-bit decimal
<c31>: C31 cell selection criteria
•
16-bit decimal
<c32>: C32 cell selection criteria
•
16-bit decimalf
(Continued on next page)
32 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Description Command
!GSMINFO
(Continued)
Displays 2G network information
Example
AT!GSMINFO?
returns:
!gsminfo:
Serving Cell:
PLMN:
LAC:
Cell ID:
<mccmnc>
<lac>
<cellid>
<bsic> BSIC:
NCC:
BSCC:
<ncc>
<bscc>
RAC: <rac>
Min Rx Lvl Rqd: <minrx>
Max Rach:
Band:
<maxrach>
<band>
ARFCN: <arfcn>
RX level (dBm): <rxlvl>
C1:
C2:
C31:
<c1>
<c2>
<c31>
C32: <c32>
Neighbour Cells:
Band:
ARFCN:
RAC:
RX level (dBm):
<band> <band> <band>
<arfcn> <arfcn> <arfcn>
<rac>
<rxlvl>
<rac>
<rxlvl>
<rac>
<rxlvl>
C1:
C2:
C31:
<c1>
<c2>
<c31>
<c1>
<c2>
<c31>
<c1>
<c2>
<c31>
C32: <c32> <c32> <c32>
Rev 2.4 Jan.08
33
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!GSTATUS?
Supporting modems:
•
All
Returns operational status
This command returns specific details about the current operational status of the modem.
Parameters:
<ctime>: Current time (Seconds from bootup)
<temperature>: Approximate temperature (
±
5
°
C)
<btime>: Bootup Time (Seconds from reset)
<mode>: Current modem mode
•
(“POWERING OFF”, “FACTORY TEST”, “OFFLINE”, “ONLINE”,
“LOW POWER MODE”, “RESETTING”, “NETWORK TEST”,
“OFFLINE REQUEST”, “PSEUDO ONLINE”, “Unknown”)
<smode>: System mode acquired by modem
•
(“No service”, “AMPS”, “CDMA”, “GSM”, “HDR”, “WCDMA”, “GPS”,
“WCDMA+GSM”, “Unknown”)
<PSstate>: Current PS state
•
(“Attached”, “Not attached”)
<wband>: Current WCDMA band being accessed
•
(“CDMA cell”, “CDMA PCS”, “IMT2000”, “WCDMA1900”,
“WCDMA1800”, “WCDMA800”, “GSM EGSM900”, “GSM DCS1800”,
“GSM 850”, “GSM1900”, “GPS”, “No band”)
<gband>: Current GSM band, either TCH or BCCH
•
(“GSM850”, “GSM900”, “DCS1800”, “PCS1900”, “Unknown”)
<wchan>: WCDMA channel number
<gchan>: GSM channel number
<gmmstate>: Current GMM state
•
(“IDLE”, “DEREGISTERED”, “Registering”, “REGISTERED”,
“Deregistering”, “RA updating”, “Requesting srvc”)
<gmmsubstate>: Current GMM sub-state
•
(“NORMAL SERVICE”, “LIMITED SERVICE”, “ATT NEEDED”,
“ATTEMPTING ATT”, “NO IMSI”, “NO SERVICE”, “PLMN SEARCH”,
“SUSPENDED”, “UPDATE NEEDED”, “UPDATING”, “DEATACHING”,
“---”)
Note: “---” indicates ‘undefined sub-state’
<mmstate>: Current MM state
•
(“NULL”, “IDLE”, “LA Rejected”, “LA Start”, “CONNECTED”,
Network Command”, “---”)
Note: “---” indicates ‘undefined state’
<mmsubstate>: Current MM sub-state
•
(“NORMAL SERVICE”, “LIMITED SERVICE”, “NO IMSI”,
“NO SERVICE”, “PLMN SEARCH”, “UPDATE NEEDED”,
“UPDATING”, “---”)
Note: “---” indicates ‘undefined sub-state’
34 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!GVER?
Supporting modems:
•
All
^HVER
Supporting modems:
•
All
Returns the firmware version
This command returns the firmware version as a string in the format version yyyy/mm/dd hh:mm:ss.
!NVPORTSET?
!NVPORTSET=
<mapping>
Supporting modems:
•
MC8780 / 81
•
AC880 / 881
!PCTEMP?
Supporting modems:
•
All MC modems
Returns the modem hardware version
This command returns the modem’s hardware version number based on the FSN.
The version number is returned as a short string representing the actual version.
Examples:
•
“E2” – Eng2 device
•
“1.0” – Production v1.0
•
“1.1” – Production v1.1
•
etc.
Assigns appropriate USB endpoint AT port
This command maps the AT port to either endpoint 5 or endpoint 2 in non-
MUX mode, or reports the current mapping.
Usage:
•
AT!NVPORTSET? returns the current endpoint <mapping>
•
AT!NVPORTSET=<mapping> maps the AT port to the appropriate
USB endpoint
Parameters:
<mapping> (mapping type):
•
0 = endpoint 5 (Default value)
•
1 = endpoint 2
Returns current temperature information
This command returns the module’s temperature state and actual temperature.
Usage:
•
AT!PCTEMP? returns the <state> and <temperature>.
Parameters:
<state> (temperature state):
•
“Normal”
•
“High Warning”
•
“High Critical”
•
“Low Critical”
<temperature> (current temperature):
•
Current temperature in degrees Celsius – this is the highest temperature reported by the two thermistors (one measures the PA (Power
Amplifier) used by the WCDMA transceiver, the other measures the temperature of the PA used by the GSM transceiver).
Rev 2.4 Jan.08
35
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!PCVOLT?
Supporting modems:
•
All MC modems
!POWERDOWN
Supporting modems:
•
All
Returns current power supply voltage information
This command returns the module’s power supply state and actual voltage.
Usage:
•
AT!PCVOLT? returns the <state>, <voltage>, and <raw> (Analog/
Digital Convertor reading).
Parameters:
<state> (power supply state):
•
“Normal”
•
“High Critical”
•
“Low Warning”
•
“Low Critical”
<voltage>:
•
Current voltage reading in mV.
<raw>:
•
Analog/Digital Convertor reading
Powers down the system
This command powers down the system. After using this command, the modem will not communicate with the host until it has been power cycled.
Usage:
•
AT!POWERDOWN returns “OK” and powers 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.
36 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!REL?
Supporting modems:
•
All
!RESET
Supporting modems:
•
All
Queries the active protocol / revision
This command is used to indicate the modem’s current protocol, SGSN, and MSC revision settings.
Usage:
•
AT!REL? reports the current operating protocol, SGSN revision, and
MSC revision in the format <wcdmarrc> <sgsnr> <mscr> (each value appears on a separate line).
Parameters:
<wcdmarrc>: WCDMA RRC Revision (Protocol)
•
00 = Release 99
•
01 = Release 5 (Default)
<sgsnr>: SGSN Revision
•
00 = Release 97
•
01 = Release 99
•
02 = Release 5
•
03 = Dynamic (Default)—uses whichever protocol is broadcast by the network
<mscr>: MSC Revision
•
00 = Release 97
•
01 = Release 99
•
02 = Release 5
•
03 = Dynamic (Default)—uses whichever protocol is broadcast by the network
Resets the modem
This command performs a modem reset.
Note: This command is identical in function to
+RSCP?
Supporting modems:
•
All
Returns Received Signal Code Power (RSCP) (WCDMA only)
This command returns the RSCP of the active set’s three strongest cells.
Usage:
•
AT!RSCP? returns the signed dBm value, from weakest to strongest cell. For example:
+RSCP:
RSCP: -73 dBm -84 dBm
•
Valid return values: -120 dBm to -20 dBm
Rev 2.4 Jan.08
37
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SCACT? [<pid>]
!SCACT=<state>[, <pid>]
Supporting modems:
•
All
!SCDFTPROF?
!SCDFTPROF=<pid>
Supporting modems:
•
All
Activates / deactivates PDP context for FIFO interface
This command is used to activate or deactivate the specified PDP context for FIFO interface.
Usage:
•
AT!SCACT?[<pid>] reports the status of the identified profile (<pid>). If no <pid> is specified, the status of all profiles is returned.
•
AT!SCACT=<state>[,<pid>] is used to set the state of the identified profile (<pid>). If no <pid> is specified, profile 1 is updated.
Parameters:
<state> (PDP context activation state):
•
0 = Deactivated
•
1 = Activated
•
During assignment, any <state> other than 1 or 2 will return an
ERROR response.
<pid> (PDP context definition):
•
Valid range: 1–16
Queries / sets the default profile ID
This command is used to query / set the default profile ID.
Usage:
•
AT!SCDFTPROF? returns the default profile ID (<pid>).
•
AT!SCDFTPROF=<pid> sets the default profile ID to <pid>.
Parameters:
<pid> (Profile ID):
•
Valid range: 1–16 — a valid profile ID that will be used as the default
38 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SCDNS?<pid>
!SCDNS=<pid>,
<pri_dns>,<sec_dns>
Supporting modems:
•
All
Queries / sets profile ID DNS address
This command is used to query / set the primary and secondary DNS addresses of a profile.
Usage:
•
AT!SCDNS?<pid> returns the primary (<pri_dns>) and secondary
(<sec_dns>) DNS addresses for the specified profile (<pid>).
•
AT!SCDNS=<pid>,<pri_dns>,<sec_dns> sets the default primary and secondary IP addresses for domain name services.
Parameters:
<pid> (PDP context definition)
•
Valid range: 1–16 — a valid profile ID that will be used as the default
<pri_dns> (Default primary IP address for DNS lookup):
•
‘Dot format’ IP address. For example, 10.10.10.1
•
Used by modem when no DNS server address is received over the air during PDP context activation
<sec_dns>: Default secondary IP address for DNS lookup
•
‘Dot format’ IP address. For example, 10.10.10.1
•
Used by modem when no DNS server address is received over the air during PDP context activation
Rev 2.4 Jan.08
39
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SCPROF?<pid>
!SCPROF=<pid>,<label>,
<autoconnect>,
<promptforpassword>,
<autolaunchapp>,
<rffu>
Supporting modems:
•
All
!SCPADDR=<pid>
Supporting modems:
•
All
Queries / sets SWI-specific profile information
This command is used to query / set the SWI specific information for a profile.
Usage:
•
!SCPROF?<pid> reports current SWI-specific information for the specified profile (<pid>) in the format <pid> <label> <autoconnect>
<promptforpassword> <autolaunchapp> <pdplingertimer>.
•
!SCPROF=<pid>...<rffu> sets the SWI-specific information for the specified profile (<pid>).
Parameters:
<pid>: PDP context definition
•
Valid range: 1–16 — a valid profile ID that will be used as the default
<label>: Configuration buffer label
•
30-character string surrounded by quotation marks
<autoconnect>: Automatic context activation mode
•
0 = manual activation
•
1 = auto activation
<promptforpassword>: Flag value (prompt for password)
•
0 = do not prompt for password
•
1 = prompt for password
<autolaunchapp>: Flag value (auto launch application)
•
0 = do not auto launch the application
•
1 = auto launch the application
<rffu>: Reserved for future use
•
0–32767 = Reserved for future use
Displays IP address for specified PDP context
This command is used to display the IP address of the specified PDP context (profile), or for all profiles.
Usage:
•
AT!SCPADDR=<pid> returns the IP address for the specified <pid> in the format <pid>, <addr>.
•
AT!SCPADDR= returns the IP addresses for all defined profiles.
Parameters:
<pid> (profile ID (PDP context))
•
Valid range: 1–16
<addr> (IP address of <pid>)
•
‘Dot’ format IP address (for exampel, 255.255.255.0)
40 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SELMODE?
!SELMODE=?
!SELMODE=<sdInd>
Supporting modems:
•
All
!SELRAT?
!SELRAT=?
!SELRAT=<ratInd>
Supporting modems:
•
All
Queries / sets current service domain
This command is used to configure the modem to use a specific service domain.
Usage:
•
AT!SELMODE? returns the current service domain index (<sdInd>) and description. If the <sdInd> is undefined, an error message is returned.
•
AT!SELMODE=? returns a list of supported service domain indexes in the format <sdInd>, <description>.
•
AT!SELMODE=<sdInd> sets the desired service domain.
Parameters:
<sdInd> (service domain index):
•
00 = CS only
•
01 = PS only
•
02 = CS and PS
Queries / sets current radio access technology (RAT)
This command is used to configure the modem to use a specific (or preferred) RAT.
Usage:
•
AT!SELRAT? returns the current RAT configuration index (<ratInd>) and description. If the <ratInd> is undefined, an error message is returned.
•
AT!SELRAT=? returns a list of supported RAT configurations in the format <ratInd>, <description>.
•
AT!SELRAT=<ratInd> sets the desired RAT configuration.
Parameters:
<ratInd> (RAT configuration index):
•
00 = Automatic
•
01 = UMTS 3G only
•
02 = GSM 2G only
•
03 = UMTS 3G preferred
•
04 = GSM 2G preferred
Rev 2.4 Jan.08
41
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SMSRETRY?
!SMSRETRY=?
!SMSRETRY=<period>,
<interval>
Supporting modems:
•
MC8780 / 81
•
AC880 / 881
Queries / sets SMS retry period and interval
This command is used to configure the SMS retry period and interval for
MO-SMS.
Usage:
•
AT!SMSRETRY? returns the current <period> and <interval> settings.
•
AT!SMSRETRY=? reports the format used for AT!SMSRETRY.
•
AT!SMSRETRY=<period>, <interval> sets the retry period and retry interval
Parameters:
<period> (Number of seconds allowed for MO-SMS retry attempts):
•
0–255
<interval> (Number of seconds to wait between MO-SMS retry attempts):
•
0–255
Note: If <interval> is greater than <period>, a single retry attempt is made.
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.
42 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SMSSTSEN?
!SMSSTSEN=?
!SMSSTSEN=<enable>,
<mode>
Supporting modems:
•
MC8775 / 75V (minimum
FW rev: H1_1_8_14mcap)
•
MC8780 / 81
•
AC875 (minimum FW rev:
H1_1_8_14Acap)
•
AC880 / 881
Enables / disables SMS status reports
This command is used to enable / disable SMS status reports for MO-SMS messages, and to indicate if the user should be able to enable / disable the reports.
The status report indicates when a message is delivered to its intended recipient (in addition to the report that is sent when the network first receives the message).
Usage:
•
AT!SMSSTSEN? returns the current <enable> and <mode> settings.
•
AT!SMSSTSEN=? reports the format used for AT!SMSSTSEN.
•
AT!SMSSTSEN=<enable>, <mode> enables / disables status reports, and indicates if the user can enable / disable the feature.
Parameters:
<enable> (Enable / Disable SMS status reports):
•
0 = Disable
•
1 = Enable
<mode> (User access to reporting feature):
•
0 = Read / Write (User can enable / disable the feature)
•
1 = Read only (User cannot enable / disable the feature—the feature status is preset by the device provider)
Rev 2.4 Jan.08
43
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SWICALLPROG?
!SWICALLPROG
=<cpnStatus>
Supporting modems:
•
All
Enables / disables Call Progress Notification
This command is used to enable or disable call progress notification. This allows the host to receive call status updates such as type of call, answered, on hold, etc.
Usage:
•
AT!SWICALLPROG? returns the current <cpnStatus>.
•
AT!SWICALLPROG=<cpnStatus> Information on current calls is returned, when the call status changes, in the format:
!SWICALLPROG:<idx e>,<alpha>
1
>,<dir>,<stat>,<mode>,<mpty>,<number>,<typ
!SWICALLPROG:<idx e>,<alpha>
2
>,<dir>,<stat>,<mode>,<mpty>,<number>,<typ
...
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)
44 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!SWICALLPROG
(Continued)
Enables / disables Call Progress Notification
(Continued)
<mpty> (Multiparty status):
•
0 = Not part of a multiparty (conference) call
•
1 = Part of a multiparty (conference) call
<number> (Telephone number of other end of connection):
•
format specified by next parameter (<type>)
<type> (Address octet type):
•
Two bitfields identifying the type of telephone number and numbering plan type (national / international).
•
Format specified in 3GPP TS 24.008 Section 10.5.4.7
<alpha> (Tag associated with <number> in the phonebook):
•
Example: “John Doe”
Rev 2.4 Jan.08
45
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
^SYSCONFIG?
^SYSCONFIG=<mode>,
<acqorder>, <roam>,
<srvDomain>
Supporting modems:
•
All
Queries / sets system configuration information
This command is used to set and retrieve the modem’s configuration.
Usage:
•
AT^SYSCONFIG= sets the various configuration parameters. You must specify all of the parameters.
•
AT^SYSCONFIG? returns the current modem configuration information in the format <mode> <netAccessOrder> <roaming>
<srvDomain>.
Parameters:
<mode> (Supported system mode):
•
2 = Auto-select
•
13 = GSM only
•
14 = WCDMA only
•
16 = No change—use this value with AT^SYSCONFIG= if you do not want to change the current setting.
<acqOrder> (Network acquisition order)
•
0 = Automatic
•
1 = GSM, then WCDMA
•
2 = WCDMA, then GSM
•
3 = No change—use this value with AT^SYSCONFIG= if you do not want to change the current setting.
<roam> (Roaming support)
•
0 = Not supported
•
1 = Supported
•
2 = No change—use this value with AT^SYSCONFIG= if you do not want to change the current setting.
<srvDomain> (Service domain support)
•
0 = Circuit-switched only
•
1 = Packet-switched only
•
2 = Circuit- and packet-switched
•
3 = Any
•
4 = No change—use this value with AT^SYSCONFIG= if you do not want to change the current setting.
<simStatus> (SIM status)
•
0 = SIM is not available
•
1 = SIM is available
•
255 = No SIM, or the SIM has been PIN-locked (invalid PIN was entered and must be reset)
46 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
^SYSINFO
Supporting modems:
•
All
Returns service status information
This command returns current service type and availability information, and the current status of the module’s SIM in the format <srvStatus>
<srvDomain> <roamStatus> <sysMode> <simState>.
Parameters:
<srvStatus> – Service availability
•
0 = No service
•
1 = Limited service
•
2 = Service
•
3 = Limited regional service
•
4 = Power save mode or deep sleep mode
<srvDomain> – Service domain
•
0 = No service
•
1 = Circuit-switched service only
•
2 = Packet-switched service only
•
3 = Circuit- and packet-switched service
<roamStatus> – Roaming status indicator
•
0 = Not roaming
•
1 = Roaming
<sysMode> – System mode
•
0 = No service
•
3 = GSM / GPRS mode
•
5 = WCDMA mode
<simStatus> – SIM status
•
0 = SIM is not available
•
1 = SIM is available
•
255 = No SIM, or the SIM has been PIN-locked (invalid PIN was entered and must be reset)
Rev 2.4 Jan.08
47
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!TIME=<YYYY>, <MM>,
<DD>, <hh>, <mm>, <ss>
[, <TZ>, <DST>]
!TIME?
!TIME=?
Supporting modems:
•
All
Queries / sets current time of day
This command is used to set and retrieve the current time of day—the time of day can be set using this command, or could be set by the network. If the time has not been set, the command returns ERROR.
Usage:
•
AT!TIME= <YYYY>,<MM>,<DD>,<hh>,<mm>,<ss> [, <TZ>, <DST>] sets the current time.
•
AT!TIME? returns four lines of data. Lines 1-2 show local date and time, lines 3-4 show UTC date and time. Date format is YYYY/MM/DD; time format is hh:mm:ss.
Example response:
!TIME:
2007/10/21
10:23:38 (local)
2007/10/21
17:23:38 (UTC)
OK
Note: In this example, <tz> is -32 (-8 hours) and DST is 1 (+1 hour).
•
AT!TIME=? reports the format used for AT!TIME
Parameters:
<YYYY> – year
•
4 digits required
<MM> – month
•
Valid values: 01–12
<DD> – day
•
Valid values: 01–31
<hh> – hour
•
Valid values: 00-23
<mm> – minute
•
Valid values: 00–59
<ss> – second
•
Valid values: 00–59
<TZ> – time zone offset from UTC in 15-minute increments
•
Valid values: -48 to 48
•
<DST> must also be set if <TZ> is used
<DST> – Daylight Saving Time offset in 1-hour increments
•
Valid values: 0 to 2
•
<TZ> must also be set if <DST> is used
48 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
!UDINFO?
Supporting modems:
•
All
+UPSC
Supporting modems:
•
All
Returns information from active USB descriptor
This command returns information from the active USB descriptor in the format <vid> <pid> <manuf string> <product string> (each parameter on a separate line).
Parameters:
<vid> – Vendor ID
•
Valid range: 0000–FFFF
<pid> – Product ID
•
Valid range: 0000–FFFF
<manuf string> – Manufacturer string
•
ASCII string (29 characters maximum)
•
Example: “Sierra Wireless, Incorporated”
<product string> – Product string
•
ASCII string (64 characters maximum)
•
Example: “Mini Card”
Displays Primary Scrambling Code (WCDMA only)
This command displays the Primary Scrambling Code (PSC) of the reference WCDMA cell.
Example:
AT!UPSC returns:
+UPSC: <psc>
Parameters:
<psc> – Primary Scrambling Code of reference WCDMA cell
•
Valid range: 0-255
•
255 = No valid cell
Rev 2.4 Jan.08
49
Supported AT Command Reference
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
+USET?<set>
+USET=?
Supporting modems:
•
All
Displays WCDMA set information
This command displays WCDMA set information (Active Set, Candidate
Set, etc.).
Usage:
•
AT+USET?<set> returns detailed information about each item in the
<set>.
•
AT+USET=? returns the list of valid <set> values
Example:
AT+USET?<set> returns:
+USET: <setName>
Count: <count>
PSC: <psc> <ref>
SSC: <ssc>
STTD: <sttd>
Tot Ec/Io: <totEcIo>
Ec/Io: <EcIo>
RSCP: <rscp>
Window Size: <winSize>
... (repeats for <count> items)
Parameters:
<set> – Set for which details are requested
•
Valid range: 0–11 (see <setName> for descriptions)
<setName> – Description of <set> value
•
ASCII string
•
Valid values:
0-Active Set
1-Sync Neighbour Set
2-Async Neighbour Set
3-Unlisted Set
4-Add-Candidate Set
5-Drop-Candidate Set
6-After failed W2G Set
7-DCH-Only Set
8-HHO Active Set
9-HHO Active No PN Set
10-Candidate to Unlisted Set
11-Saved Set
<count> – Number of items in <set>
•
Valid range: 0-255
<psc> – Primary Scrambling Code
•
Valid range: 0–FFFF
(Continued on next page)
50 2130617
Modem Status, Customization, and Reset Commands
Table 3-2: Modem status, customization, and reset commands (Continued)
Command Description
+USET
&V
Supporting modems:
•
All
Displays WCDMA set information (Continued)
<ref> – Reference PSC designator string
•
Displays “(REF)” if this is the reference PSC
<ssc> – Secondary Scrambling Code
•
Valid range: 0–FFFF
<sttd> – Common Pilot Channel (CPICH) supports Space Time Transit
Diversity
•
0 = Not supported
•
1 = Supported
<totEcIo> – Total Ec/Io
•
Valid range: 00–FF
<EcIo> – Best path Ec/Io
•
Valid range: 00–FF
<rscp> – Received Signal Code Power
•
Valid range: 0-FFFF
<winSize> – Search window size
•
Valid range: 0000–FFFFFFFF
Return operating mode AT configuration parameters
This command returns the status of all AT command parameters that apply to the current operating mode.
Example:
“AT&V <Enter>
&C: 2; &D: 2; &F: 0; E: 1; L: 0; M: 0; Q: 0; V: 1; X: 0; Z: 0; S0: 0; S2: 43;
S3: 13; S4: 10; S5: 8; S6: 2; S7: 50; S8: 2; S9: 6; S10: 14; S11: 95;
+FCLASS: 0; +ICF: 3,3; +IFC: 2,2; +IPR: 115200; +DR: 0; +DS:
0,0,2048,6;+WS46: 12; +CBST: 0,0,1;+CRLP:
(61,61,48,6,0),(61,61,48,6,1),(240,240,52,6,2);+CV120: 1,1,1,0,0,0;
+CHSN: 0,0,0,0; +CSSN: 0,0; +CREG: 0; +CGREG: 0;+CFUN:; +CSCS:
"IRA"; +CSTA: 129; +CR: 0; +CRC: 0; +CMEE: 2; +CGDCONT:
(1,"IP","","",0,0); +CGDSCONT: ; +CGTFT: ; +CGEQREQ: ; +CGEQMIN: ;
+CGQREQ: ; +CGQMIN: ;+CGEREP: 0,0; +CGDATA: "PPP";
+CGCLASS: "A"; +CGSMS: 3; +CSMS: 0;+CMGF: 0; +CSCA: "",;
+CSMP: ,,0,0; +CSDH: 0; +CSCB: 0,"",""; +FDD: 0;+FAR: 0; +FCL: 0;
+FIT: 0,0; +ES: ,,; +ESA: 0,,,,0,0,255,; +CMOD: 0;+CVHU: 0; +CPIN: ,;
+CMEC: 0,0,0; +CKPD: 1,1; +CGATT: 0; +CGACT: 0;+CPBS: "SM";
+CPMS: "SM","SM","SM"; +CNMI: 0,0,0,0,0; +CMMS: 0; +FTS: 0;+FRS:
0; +FTH: 3; +FRH: 3; +FTM: 96; +FRM: 96; +CCUG: 0,0,0;+COPS: 0,0,"";
+CUSD: 0; +CAOC: 1; +CCWA: 0; +CPOL: 0,2,""; +CTZR: 0;+CLIP: 0;
+COLP: 0; +CMUX: 0,0,5,31,10,3,30,10,2;!CMUX: 0,0,5,31,10,3,30,10,2
OK”
Rev 2.4 Jan.08
51
Supported AT Command Reference
52 2130617
4: Diagnostic Commands
•
•
•
Introduction
This chapter describes commands used to diagnose modem problems.
Command summary
The table below lists the commands described in this chapter.
Table 4-1: Diagnostic commands
Cmnd
!AUTH
Description
!GCIPHER
!MXSTATS
Enables / disables ciphering and integrity settings
Displays / clears 27.010 statistics
Page
Command reference
Table 4-2: Diagnostic command details
Command
!AUTH = <randNumber>
Supporting modems:
•
All
Description
Runs GSM algorithm on SIM
This command is used to authenticate the SIM using a random number.
The command returns the SIM’s response and a 64–bit ciphering key in the format: <key>, <SRES>
Parameters:
<randNumber>
•
32 hexadecimal digit random number.
Example: 123A567B9012C4567D90123E56789012
<SRES> - SIM response
•
Example: 500e2879
<key> - Ciphering key
•
Example: ec793ac5662e7000
4
Rev 2.4 Jan.08
53
Supported AT Command Reference
Table 4-2: Diagnostic command details (Continued)
Command Description
!GCIPHER = <setting>
!GCIPHER?
Supporting modems:
•
All
Enables / disables ciphering and integrity settings
To register onto a network with WCDMA service, the modem’s ciphering and integrity settings must be enabled or disabled to match the network settings. Most carriers enable both ciphering and integrity.
When testing the modem, you may be using a SIM that has different codes for ciphering and integrity than those used by the test system. In this case, you may need to disable ciphering and integrity checking to use the test system.
Usage:
•
AT!GCIPHER=<setting> sets the ciphering and integrity settings.
•
AT!GCIPHER? reports the current ciphering and integrity settings
(0=disabled, 1=enabled).
Parameters:
<setting> (enable / disable ciphering and integrity):
•
0 = ciphering disabled; integrity disabled
•
1 = ciphering enabled; integrity disabled
•
2 = ciphering enabled; integrity enabled
•
3 = ciphering disabled; integrity enabled
54 2130617
Table 4-2: Diagnostic command details (Continued)
Command Description
!MXSTATS=0
!MXSTATS?
Supporting modems:
•
All
Displays / clears 27.010 statistics
TS 27.010 is a standard that defines a multiplexing protocol between a mobile station and a terminal. This standard is supported on the modem and AT!MXSTATS is used to display statistics related to that protocol for debugging purposes.
Usage:
•
AT!MXSTATS=0 clears the statistics.
•
AT!MXSTATS? reports the statistics.
The command AT!MXSTATS? returns these statistics:
•
Sessions Started
•
Sessions Ended
•
SABM (Tx/Rx)
•
DISC (Tx/Rx)
•
UA (Tx/Rx)
•
DM (Tx/Rx)
•
UIH (Tx/Rx)
•
T1 expiry
•
T2 expiry
•
T3 expiry
•
N1 count
•
N2 count
•
Bad Frame (addr)
•
Bad Frame (ctl)
•
Bad Frame (len)
•
Bad Frame (F9)
•
Bad Frame (fcs)
•
Bad Frame (mem)
Values are accumulated until cleared (by issuing the command
AT!MXSTATS=0).
Rev 2.4 Jan.08
55
Supported AT Command Reference
56 2130617
5: Test commands
•
•
•
Introduction
This chapter describes commands used to display and clear data that is stored if the modem crashes.
Command summary
The table below lists the commands described in this chapter.
Table 5-1: Test commands
Cmnd
!ERR
Description
Displays diagnostic information
!GCCLR
!GCDUMP
Page
Command reference
Table 5-2: Test command details
Command
!ERR
Supporting modems:
•
All
!GCCLR
Supporting modems:
•
All
!GCDUMP
Supporting modems:
•
All
Description
Displays diagnostic information
This command is used to display diagnostic information that Sierra Wireless uses to assist in resolving technical issues.
Clears crash dump data
This command clears the crash dump and assert data.
Displays the crash dump data
This command displays crash dump data. If there is no crash dump data, it displays the string “No crash data available”.
5
Rev 2.4 Jan.08
57
Supported AT Command Reference
58 2130617
6: Memory Management
Commands
•
•
•
Introduction
The modem has 2 MB of non‐volatile memory that is used to store:
•
Factory calibration data
•
Settings made in a host application such as Watcher
The commands in this chapter allow you to back up and restore the data in non‐volatile memory.
Command summary
The table below lists the commands described in this chapter:
Table 6-1: Memory management command passwords
Command Description
!NVBACKUP
Backs up items stored in non-volatile memory
Page
Command reference
Table 6-2: Memory management command details
Command Description
!NVBACKUP
=<category>
Supporting modems:
•
All
Backs up items stored in non-volatile memory
This command creates a backup that is stored in the modem’s flash memory.
Parameters:
<category> (specify items to back up):
•
0 = Factory items (includes calibration data)
•
1 = OEM items (includes the PRI file)
•
2 = User items (includes settings made in Watcher or another host application)
The command returns:
•
NV Items saved
•
NV Items skipped
The items skipped represent memory to which nothing has been written.
6
Rev 2.4 Jan.08
59
Supported AT Command Reference
60 2130617
7: SIM Commands
•
•
•
Introduction
This chapter describes commands used to communicate with an installed (U)SIM.
Command summary
The table below lists the commands described in this chapter:
Table 7-1: SIM command passwords
Command
!ICCID
Description
Page
Command reference
Table 7-2: SIM command details
Command
!ICCID
Supporting modems:
•
All
Description
Returns (U)SIM card’s ICCID
(Supporting modems: All; MC8775/75V requires fw revision
H0_2_2_0mcap or higher; AC875 requires fw revision H0_2_2_3acap or higher)
This command returns a (U)SIM’s ICCID (Integrated Circuit Card ID).
Usage:
•
AT!ICCID?
returns !ICCID: <iccid>
Parameters:
<iccid> (ICCID of the (U)SIM currently being tested):
•
<tbd> 10-digit hexadecimal number / 19-20 digit regular number
7
Rev 2.4 Jan.08
61
Supported AT Command Reference
62 2130617
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project