Transcript
Data and Voice Modules AT Commands Manual
Abstract Description of standard and proprietary AT Commands used with u-blox Wireless Modules. .
www.u-blox.com
locate, communicate, accelerate
u-blox Wireless Modules
u-blox Wireless Modules - AT Commands Manual
Document Information Title
u-blox Wireless Modules
Subtitle
Data and Voice Modules
Document type
AT Commands Manual
Document number
WLS-SW-11000-B
Document status
Preliminary
Document status information Objective This document contains target values. Revised and supplementary data will be published Specification later. Advance This document contains data based on early testing. Revised and supplementary data will Information be published later. This document contains data from product verification. Revised and supplementary data Preliminary may be published later. Released This document contains the final product specification. This document applies to the following products: Name
Type number
Firmware version
PCN reference
LEON-G100
LEON-G100-04S-00 LEON-G100-05S-00 LEON-G100-06S-00 LEON-G100-06S-01 LEON-G100-06A-00 LEON-G100-07S-00 LEON-G100-07A-00 LEON-G200-04S-00 LEON-G200-05S-00 LEON-G200-06S-00 LEON-G200-06S-01 LISA-U100-00S-00 LISA-U100-01S-00 LISA-U110-00S-00 LISA-U110-01S-00 LISA-U120-00S-00 LISA-U120-01S-00 LISA-U130-00S-00 LISA-U130-01S-00 LISA-U130-01A-00 LISA-U200-00S-00 LISA-U200-01S-00 LISA-U200-01A-00 LISA-U230-01S-00 LISA-U230-01A-00
07.40.01 07.50.00 07.60.00 07.60.02 07.60.00 07.70 07.70 07.40.02 07.50.00 07.60.00 07.60.02 10.72 11.40 10.72 11.40 10.72 11.40 10.72 11.40 11.40 21.21 22.40 22.40 22.40 22.40
GSM.G1-SW-10007 GSM.G1-SW-10008 GSM.G1-SW-10012 GSM.G1-SW-10013 GSM.G1-SW-10012 GSM.G1-SW-12002 GSM.G1-SW-12002 GSM.G1-SW-10007 GSM.G1-SW-10008 GSM.G1-SW-10012 GSM.G1-SW-10013 3G.G2-SW-11000 UBX-TN-12008 3G.G2-SW-11000 UBX-TN-12008 3G.G2-SW-11000 UBX-TN-12008 3G.G2-SW-11000 UBX-TN-12008 UBX-TN-12008 UBX-TN-12009 UBX-TN-12027 UBX-TN-12027 UBX-TN-12027 UBX-TN-12027
LEON-G200
LISA-U100 LISA-U110 LISA-U120 LISA-U130
LISA-U200
LISA-U230
WLS-SW-11000-B Page 2 of 426
u-blox Wireless Modules - AT Commands Manual
This document and the use of any information contained therein, is subject to the acceptance of the u-blox terms and conditions. They can be downloaded from www.u-blox.com. u-blox makes no warranties based on the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. u-blox reserves all rights to this document and the information contained herein. Reproduction, use or disclosure to third parties without express permission is strictly prohibited. Copyright © 2012, u-blox AG. u-blox® is a registered trademark of u-blox Holding AG in the EU and other countries.
WLS-SW-11000-B Page 3 of 426
u-blox Wireless Modules - AT Commands Manual
Preface u-blox Technical Documentation As part of our commitment to customer support, u-blox maintains an extensive volume of technical documentation for our products. In addition to our product-specific technical data sheets, the following manuals are available to assist u-blox customers in product design and development. AT Commands Manual: This document provides the description of the supported AT commands by Wireless Modules to verify all implemented functionalities. System Integration Manual: This Manual provides hardware design instructions and information on how to set up production and final product tests.
How to use this Manual The u-blox Wireless Modules AT Commands Manual provides the necessary information to successfully design in and configure these u-blox wireless modules. For navigating this document please note the following: This manual has a modular structure. It is not necessary to read it from the beginning to the end. The following symbols are used to highlight important information within the manual: An index finger points out key information pertaining to module integration and performance. A warning symbol indicates actions that could negatively impact or damage the module.
Questions If you have any questions about u-blox Wireless Hardware Integration, please: Read this manual carefully Contact our information service on our homepage http://www.u-blox.com Read the questions and answers on our FAQ database
Technical Support Worldwide Web Our website (www.u-blox.com) is a rich pool of information. Product information, technical documents and helpful FAQ can be accessed 24h a day. By E-mail If you have technical problems or cannot find the required information in the provided documents, contact the nearest of the Technical Support offices by email. Use our service pool email addresses rather than any personal email address of our staff. This makes sure that your request is processed as soon as possible. You will find the contact details at the end of the document. Helpful Information when Contacting Technical Support When contacting Technical Support please have the following information ready: Module type (e.g. LEON-G100-00S-01) and firmware version (e.g. 07.30) Module configuration Clear description of your question or the problem A short description of the application Your complete contact details
WLS-SW-11000-B
Preliminary
Preface Page 4 of 426
u-blox Wireless Modules - AT Commands Manual
Contents Preface ................................................................................................................................ 4 Contents.............................................................................................................................. 5 1
2
3
AT command settings ................................................................................................ 16 1.1 1.2
Definitions .......................................................................................................................................... 16 Profiles ............................................................................................................................................... 19
1.3
S-parameters ...................................................................................................................................... 19
General operation ...................................................................................................... 20 2.1
Start up and initialization .................................................................................................................... 20
2.2
AT Commands mode .......................................................................................................................... 20
IPC – Inter Processor Communication........................................................................ 21 3.1
4
5
Multiplexing mode +CMUX ................................................................................................................ 21
General........................................................................................................................ 23 4.1 4.2
Manufacturer identification +CGMI .................................................................................................... 23 Request model identification +CGMM ................................................................................................ 23
4.3
Request Firmware version +CGMR ...................................................................................................... 23
4.4 4.5
Request for IMEI +CGSN ..................................................................................................................... 24 Set TE character set +CSCS ................................................................................................................. 24
4.6
Request international mobile subscriber identification +CIMI .............................................................. 25
4.7 4.8
Card identification +CCID ................................................................................................................... 25 Request complete capabilities list +GCAP ........................................................................................... 26
4.9
Repeat last command A/ ..................................................................................................................... 26
Mobile equipment control and status ...................................................................... 27 5.1
Phone activity status +CPAS ............................................................................................................... 27
5.2 5.3
Switch off MT +CPWROFF .................................................................................................................. 27 Set phone functionality +CFUN ........................................................................................................... 27
5.4
Battery charge +CBC .......................................................................................................................... 29
5.5 5.6
Indicator control +CIND ...................................................................................................................... 29 Mobile termination event reporting +CMER........................................................................................ 31
5.7
Clock +CCLK ...................................................................................................................................... 33
5.8 5.9
Alarm +CALA ..................................................................................................................................... 33 Delete alarm +CALD ........................................................................................................................... 34
5.10
Restricted SIM access +CRSM .......................................................................................................... 35
5.11 5.12
Alert sound mode +CALM .............................................................................................................. 36 Ringer sound level +CRSL ................................................................................................................ 37
5.13
Loudspeaker volume level +CLVL .................................................................................................... 37
5.14
Mute control +CMUT ...................................................................................................................... 38
WLS-SW-11000-B
Preliminary
Contents Page 5 of 426
u-blox Wireless Modules - AT Commands Manual
6
7
8
9
5.15 5.16
Call meter maximum event +CCWE ................................................................................................ 38 Set greeting text +CSGT ................................................................................................................. 39
5.17
Automatic Time Zone Update +CTZU .............................................................................................. 39
5.18 5.19
Time Zone Reporting +CTZR ........................................................................................................... 40 Report mobile termination error +CMEE ......................................................................................... 40
5.20
List all available AT commands +CLAC ............................................................................................ 41
Call control .................................................................................................................. 42 6.1
Select type of address +CSTA ............................................................................................................. 42
6.2
Dial command D ................................................................................................................................. 42
6.3 6.4
Direct calling from phonebooks D> .................................................................................................... 44 Select tone dialling T........................................................................................................................... 45
6.5
Select pulse dialling P.......................................................................................................................... 45
6.6 6.7
Call answer A ..................................................................................................................................... 45 Hook control H ................................................................................................................................... 46
6.8
Monitor speaker loudness L ................................................................................................................ 46
6.9 6.10
Monitor speaker mode M ................................................................................................................... 46 Call mode +CMOD ......................................................................................................................... 47
6.11
Hang up call +CHUP ....................................................................................................................... 47
6.12 6.13
Extended error report +CEER .......................................................................................................... 47 Single numbering scheme +CSNS ................................................................................................... 48
6.14
Tone duration +VTD ....................................................................................................................... 49
6.15 6.16
DTMF and tone generation +VTS .................................................................................................... 49 Redial last telephone number DL ..................................................................................................... 50
6.17
Automatic answer S0 ...................................................................................................................... 50
6.18
Set Voice Mail Number +CSVM ....................................................................................................... 51
Network service.......................................................................................................... 52 7.1 7.2
Subscriber number +CNUM ................................................................................................................ 52 Signal quality +CSQ ............................................................................................................................ 52
7.3
Operator selection +COPS .................................................................................................................. 53
7.4 7.5
Network registration +CREG ............................................................................................................... 55 Preferred operator list +CPOL ............................................................................................................. 57
7.6
Read operator names +COPN ............................................................................................................. 58
7.7
User to user signalling service 1 +CUUS1 ............................................................................................ 59
Security ....................................................................................................................... 61 8.1
Enter PIN +CPIN .................................................................................................................................. 61
8.2 8.3
Facility lock +CLCK ............................................................................................................................. 62 Change password +CPWD ................................................................................................................. 63
Phonebook .................................................................................................................. 64 9.1 9.2
Select phonebook memory storage +CPBS ......................................................................................... 64 Read phonebook entries +CPBR ......................................................................................................... 64
9.3
Find phonebook entries +CPBF ........................................................................................................... 66
WLS-SW-11000-B
Preliminary
Contents Page 6 of 426
u-blox Wireless Modules - AT Commands Manual
9.4
Write phonebook entry +CPBW .......................................................................................................... 67
10 Short Messages Service ............................................................................................. 69 10.1
Introduction .................................................................................................................................... 69
10.2 10.3
Select message service +CSMS ........................................................................................................ 69 Preferred message storage +CPMS .................................................................................................. 70
10.4
Preferred message format +CMGF .................................................................................................. 71
10.5 10.6
Save settings +CSAS ....................................................................................................................... 71 Restore Settings +CRES ................................................................................................................... 72
10.7
Show text mode parameters +CSDH ............................................................................................... 72
10.8 10.9
New message indication +CNMI ..................................................................................................... 73 Read message +CMGR ................................................................................................................... 75
10.10
New Message Acknowledgement to MT +CNMA ........................................................................... 78
10.11 10.12
List message +CMGL....................................................................................................................... 79 Send message +CMGS .................................................................................................................... 81
10.13
Write message to memory +CMGW ............................................................................................... 82
10.14 10.15
Send message from storage +CMSS ................................................................................................ 84 Set text mode parameters +CSMP ................................................................................................... 84
10.16
Delete SMS +CMGD ....................................................................................................................... 85
10.17 10.18
Service center address +CSCA ......................................................................................................... 86 Select cell broadcast message types +CSCB .................................................................................... 86
10.19
Read concatenated message +UCMGR ........................................................................................... 87
10.20 10.21
List concatenated message +UCMGL .............................................................................................. 90 Send concatenated message +UCMGS ........................................................................................... 93
10.22
Write concatenated message to memory +UCMGW ....................................................................... 94
10.23 10.24
More Messages to Send +CMMS .................................................................................................... 95 Peek message +UCMGP .................................................................................................................. 95
11 Supplementary services ............................................................................................. 97 11.1
Call forwarding +CCFC ................................................................................................................... 97
11.2
Call waiting +CCWA ....................................................................................................................... 98
11.3 11.4
Calling line identification restriction +CLIR ...................................................................................... 99 Calling line identification presentation +CLIP ................................................................................ 100
11.5
Connected line identification presentation +COLP ........................................................................ 101
11.6 11.7
Connected line identification restriction +COLR ............................................................................ 102 Advise of charge +CAOC .............................................................................................................. 102
11.8
Accumulated call meter +CACM ................................................................................................... 103
11.9 11.10
Accumulated call meter maximum +CAMM .................................................................................. 103 Price per unit and currency table +CPUC ....................................................................................... 104
11.11
Call related supplementary services +CHLD ................................................................................... 104
11.12 11.13
Call deflection +CTFR .................................................................................................................... 105 List current calls +CLCC ................................................................................................................ 105
11.14
Supplementary service notifications +CSSN ................................................................................... 106
11.15 11.16
Unstructured supplementary service data +CUSD .......................................................................... 107 Closed user group +CCUG ............................................................................................................ 108
WLS-SW-11000-B
Preliminary
Contents Page 7 of 426
u-blox Wireless Modules - AT Commands Manual
11.17
Calling name presentation +CNAP ................................................................................................ 109
12 Data ........................................................................................................................... 111 12.1
Select bearer service type +CBST ................................................................................................... 111
12.2 12.3
Service class selection and identification +FCLASS ......................................................................... 112 Service reporting control +CR ....................................................................................................... 112
12.4
Cellular result codes +CRC ............................................................................................................ 113
12.5
Radio link protocol +CRLP ............................................................................................................. 114
13 FAX class 2 ................................................................................................................ 115 13.1 13.2
Introduction .................................................................................................................................. 115 Adaptive answer +FAA ................................................................................................................. 115
13.3
Address & polling capabilities +FAP ............................................................................................... 115
13.4 13.5
Buffer size +FBS ............................................................................................................................ 116 Data bit order +FBO ...................................................................................................................... 116
13.6
HDLC frame reporting +FBU ......................................................................................................... 117
13.7 13.8
DS capabilities parameters +FCC ................................................................................................... 117 Copy quality checking +FCQ ......................................................................................................... 118
13.9
Capability to receive data +FCR ..................................................................................................... 118
13.10 13.11
Current session results +FCS ......................................................................................................... 119 DTE phase C response timeout +FCT............................................................................................. 119
13.12
Receive data +FDR ........................................................................................................................ 119
13.13 13.14
Transmit Data +FDT ...................................................................................................................... 120 Phase C received EOL alignment +FEA .......................................................................................... 120
13.15
Format conversion +FFC ................................................................................................................ 120
13.16 13.17
Report file transfer diagnostic frame +FFD..................................................................................... 121 Call termination status +FHS ......................................................................................................... 121
13.18
Procedure interrupt enable +FIE .................................................................................................... 122
13.19 13.20
Initialize facsimile parameters +FIP ................................................................................................ 122 Current session parameters +FIS ................................................................................................... 123
13.21
Inactivity timeout +FIT ................................................................................................................... 123
13.22 13.23
Session termination +FKS, +FK ...................................................................................................... 124 Local ID string +FLI ........................................................................................................................ 124
13.24
Set flow control +FLO ................................................................................................................... 124
13.25 13.26
Indicate document to poll +FLP ..................................................................................................... 125 Request manufacturer Identification +FMI ..................................................................................... 125
13.27
Request model identification +FMM .............................................................................................. 126
13.28 13.29
Request revision identification +FMR ............................................................................................. 126 Minimum phase C speed +FMS..................................................................................................... 126
13.30
Negotiation reporting +FNR .......................................................................................................... 127
13.31 13.32
Non-standard frame FIF octet string +FNS ..................................................................................... 127 NSF message data indication +FND ............................................................................................... 128
13.33
Selective polling address +FPA ...................................................................................................... 128
13.34 13.35
Local polling ID string +FPI ............................................................................................................ 128 Packet protocol control +FPP ......................................................................................................... 129
WLS-SW-11000-B
Preliminary
Contents Page 8 of 426
u-blox Wireless Modules - AT Commands Manual
13.36 13.37
Page status +FPS ........................................................................................................................... 129 Password parameter +FPW ........................................................................................................... 130
13.38
Receive quality thresholds +FRQ .................................................................................................... 130
13.39 13.40
Error correction mode retry count +FRY ........................................................................................ 130 SubAddress parameter +FSA ......................................................................................................... 131
13.41
Request to poll +FSP ..................................................................................................................... 131
13.42
Fax intermediate result codes ........................................................................................................ 132
14 V24 control and V25ter ............................................................................................ 133 14.1
Reset to default configuration Z .................................................................................................... 133
14.2 14.3
Set to factory defined configuration &F ......................................................................................... 133 Circuit 109 behavior &C ................................................................................................................ 134
14.4
Circuit 108/2 behavior &D ............................................................................................................. 134
14.5 14.6
DSR override &S ............................................................................................................................ 136 Flow control &K ............................................................................................................................ 136
14.7
Store current configuration &W .................................................................................................... 137
14.8 14.9
Display current configuration &V................................................................................................... 137 Designate a default reset profile &Y .............................................................................................. 138
14.10
Request identification information I............................................................................................... 138
14.11 14.12
Request manufacturer Identification +GMI .................................................................................... 139 Request model identification +GMM............................................................................................. 139
14.13
Request revision identification +GMR ............................................................................................ 139
14.14 14.15
Request product serial number identification +GSN ...................................................................... 140 DTE-DCE character framing +ICF ................................................................................................... 140
14.16
DTE-DCE local flow control +IFC ................................................................................................... 141
14.17 14.18
Set flow control \Q ........................................................................................................................ 142 Fixed DTE rate +IPR ....................................................................................................................... 143
14.19
System can Return to on-line data state O .................................................................................... 144
14.20 14.21
Escape character S2 ...................................................................................................................... 145 Command line termination character S3 ....................................................................................... 146
14.22
Response formatting character S4 ................................................................................................. 146
14.23 14.24
Command line editing character S5 .............................................................................................. 147 Pause before blind dialling S6 ....................................................................................................... 147
14.25
Connection completion timeout S7 ............................................................................................... 148
14.26 14.27
Command dial modifier time S8.................................................................................................... 148 Automatic disconnect delay S10 ................................................................................................... 149
14.28
Escape prompt delay (EPD) S12 ..................................................................................................... 149
14.29 14.30
Command echo E ......................................................................................................................... 150 Result code suppression Q ............................................................................................................ 150
14.31
DCE response format V ................................................................................................................. 150
14.32
Result code selection and call progress monitoring control X ........................................................ 151
15 SIM toolkit ................................................................................................................ 152 15.1 15.2
Introduction .................................................................................................................................. 152 Proactive command +STKPRO ....................................................................................................... 152
WLS-SW-11000-B
Preliminary
Contents Page 9 of 426
u-blox Wireless Modules - AT Commands Manual
15.3 15.4
Terminal response +STKTR ............................................................................................................ 155 Envelope +STKENV........................................................................................................................ 157
15.5
Terminal profile +STKPROF ............................................................................................................ 157
15.6 15.7
Call and short message control URC +STKCC ............................................................................... 158 Proactive session status URC +STKCNF .......................................................................................... 159
15.8
Raw Mode Envelope Download +SATE ......................................................................................... 159
15.9 15.10
Proactive Command Indication in RAW Mode +SATI ..................................................................... 160 Proactive Command Indication in RAW Mode +SATN ................................................................... 160
15.11
Send Terminal Response in RAW Mode +SATR ............................................................................. 161
15.12 15.13
Terminal Response Confirm +SATF ................................................................................................ 161 User confirmation for SET UP Call in RAW mode +SATD ............................................................... 162
15.14
Indication for Mo Call Control / Mo SMS Control +STKCTRLIND ................................................... 162
16 GPRS/PSD .................................................................................................................. 164 16.1
Parameters definition .................................................................................................................... 164
16.2
Define PDP context +CGDCONT ................................................................................................... 170
16.3 16.4
Quality of service profile (requested) +CGQREQ ............................................................................ 171 Quality of service profile (minimum acceptable) +CGQMIN ........................................................... 171
16.5
GPRS attach or detach +CGATT .................................................................................................... 172
16.6 16.7
PDP context activate or deactivate +CGACT .................................................................................. 173 Enter data state +CGDATA ........................................................................................................... 175
16.8
Enter IP state/GPRS IP dial D .......................................................................................................... 176
16.9 16.10
Show PDP address +CGPADDR ..................................................................................................... 177 GPRS mobile station class +CGCLASS ........................................................................................... 177
16.11
GPRS event reporting +CGEREP .................................................................................................... 178
16.12 16.13
GPRS network registration status +CGREG ................................................................................... 179 Select service for MO SMS messages +CGSMS .............................................................................. 180
16.14
Manual deactivation of a PDP context H ....................................................................................... 180
16.15 16.16
PDP Context Modify +CGCMOD ................................................................................................... 181 3G Quality of service profile (requested) +CGEQREQ ..................................................................... 181
16.17
3G Quality of service profile (minimum acceptable) +CGEQMIN .................................................... 183
16.18 16.19
3G Quality of Service Profile (negotiated) +CGEQNEG ................................................................... 185 Define Secondary PDP context +CGDSCONT ................................................................................. 186
16.20
Traffic Flow Template +CGTFT ...................................................................................................... 187
16.21 16.22
Multiple PDP contexts ................................................................................................................... 188 Primary and secondary PDP contexts ............................................................................................. 189
17 Specific ...................................................................................................................... 190 17.1
FOTA configuration +UFOTA ......................................................................................................... 190
17.2
Firmware Update over AT command (FOAT) +UFWUPD ................................................................ 191
17.3 17.4
Antenna Detection +UANTR ......................................................................................................... 193 ADC read command +UADC ........................................................................................................ 194
17.5
Power saving control (Power SaVing) +UPSV ................................................................................. 194
17.6 17.7
Tone generator (Tone GeNerator) +UTGN ..................................................................................... 195 Ringing tone selection command +URNG ..................................................................................... 196
WLS-SW-11000-B
Preliminary
Contents Page 10 of 426
u-blox Wireless Modules - AT Commands Manual
17.8 17.9
SMS Alert sound mode (Message Sound Muting) +UMSM ............................................................ 197 2 I S Digital Interface Mode +UI2S .................................................................................................... 198
17.10
Audio Path mode setting (Set Path Mode) +USPM ........................................................................ 205
17.11 17.12
Play audio resource (Play Audio Resource) +UPAR ......................................................................... 208 Stop audio resource (Stop Audio Resource) +USAR ....................................................................... 210
17.13
Play audio file +UPLAYFILE ............................................................................................................ 210
17.14 17.15
Stop AMR audio file +USTOPFILE .................................................................................................. 211 Jamming Detection +UCD ............................................................................................................. 211
17.16
Select Band +UBANDSEL ............................................................................................................... 213
17.17 17.18
Set reporting call status +UCALLSTAT ........................................................................................... 214 Display operator name +UDOPN ................................................................................................... 215
17.19
Device configuration +UDCONF .................................................................................................... 216
17.20 17.21
Display EONS names +UEONS ....................................................................................................... 221 PS Operator selection +UCGOPS ................................................................................................... 222
17.22
Cell environment description +CGED ............................................................................................ 223
17.23 17.24
Device class setting +UCLASS ........................................................................................................ 233 Read counters of sent or received PSD data +UGCNTRD ............................................................... 234
17.25
Set/reset counter of sent or received PSD data +UGCNTSET .......................................................... 235
17.26 17.27
Read remaining SIM PIN attempts +UPINCNT ................................................................................ 235 Help displaying all commands &H ................................................................................................. 236
17.28
Proprietary extended error report +UCEER .................................................................................... 237
17.29 17.30
Provide Cell information +UCELLINFO ........................................................................................... 237 Configuration of Indicator control +UCIND ................................................................................... 238
17.31
Customer service profile +UCSP .................................................................................................... 239
17.32 17.33
User setting for proactive DTMF tone generation +UDTMF............................................................ 239 Changing the startup MS class +UCGCLASS ................................................................................. 240
17.34
Generic SIM access +CSIM ............................................................................................................ 240
17.35 17.36
Selection of preferred PLMN list +CPLS ......................................................................................... 241 Read the SIM language +CLAN ..................................................................................................... 241
17.37
Check for UICC card +UUICC ....................................................................................................... 242
17.38 17.39
Home zone reporting +UHOMEZR ................................................................................................ 242 Configure the mode of HSDPA/HSUPA +UHSDUPA ....................................................................... 243
17.40
Information to in-band-tones availability +UPROGRESS ................................................................. 244
17.41 17.42
Selection of Radio Access technology +URAT ................................................................................ 245 Extended Packet Switched network registration status +UREG ...................................................... 245
17.43
Start and stop tone generation +UVTS .......................................................................................... 246
17.44 17.45
PCCA STD-101 [17] select wireless network +WS46 ..................................................................... 247 End User Test +UTEST ................................................................................................................... 247
17.46
Smart temperature Supervisor +USTS ............................................................................................ 252
17.47 17.48
Configure the Data Channel +UDATACHANNEL ........................................................................... 253 Custom SIM Lock +USIMLCK ........................................................................................................ 254
17.49
Network Selection Control +PACSP ............................................................................................... 256
17.50 17.51
Rx Diversity +URXDIV .................................................................................................................... 257 Message Waiting Indication +UMWI ............................................................................................. 258
WLS-SW-11000-B
Preliminary
Contents Page 11 of 426
u-blox Wireless Modules - AT Commands Manual
18 GPIO .......................................................................................................................... 260 18.1
Introduction .................................................................................................................................. 260
18.2
GPIO select configuration command +UGPIOC ............................................................................. 266
18.3 18.4
GPIO read command +UGPIOR ..................................................................................................... 268 GPIO set command +UGPIOW ...................................................................................................... 268
19 File System ................................................................................................................ 270 19.1
Download file +UDWNFILE ............................................................................................................ 270
19.2
Delete file +UDELFILE .................................................................................................................... 270
19.3 19.4
Read file +URDFILE ........................................................................................................................ 271 List files information +ULSTFILE ..................................................................................................... 271
19.5
Download file +URDBLOCK .......................................................................................................... 272
20 Audio parameters tuning ........................................................................................ 274 20.1
Introduction .................................................................................................................................. 274
20.2
Microphone Gain (Microphone Gain Control) +UMGC ................................................................. 276
20.3 20.4
Speaker Gain (Speaker Gain Control) +USGC ................................................................................ 278 Sidetone (SideToNe) +USTN .......................................................................................................... 279
20.5
Uplink Digital Filters (Uplink Biquad Filters) +UUBF ........................................................................ 280
20.6 20.7
Downlink Digital Filters (Downlink Biquad Filters) +UDBF ............................................................... 283 Hands-Free Parameters (Hands-Free Parameters) +UHFP ................................................................ 286
20.8
Master Clock Control +UMCLK ..................................................................................................... 292
21 Data Connection Setup ............................................................................................ 294 21.1
Packet Switched Data +UPSD ........................................................................................................ 294
21.2
Packet Switched Data Action +UPSDA .......................................................................................... 298
21.3 21.4
Packet Switched Network-assigned Data +UPSND ......................................................................... 299 Circuit Switched Data +UCSD ....................................................................................................... 300
21.5
Circuit Switched Data Action +UCSDA .......................................................................................... 300
21.6
Circuit Switched Network-assigned Data +UCSND ........................................................................ 301
22 DNS............................................................................................................................ 302 22.1
Resolve Name / IP Number through DNS +UDNSRN ...................................................................... 302
23 TCP/IP UDP/IP ............................................................................................................ 303 23.1
Introduction .................................................................................................................................. 303
23.2
Create Socket +USOCR ................................................................................................................. 303
23.3 23.4
Set Socket Option +USOSO ........................................................................................................... 304 Get Socket Option +USOGO ......................................................................................................... 305
23.5
Close Socket +USOCL ................................................................................................................... 306
23.6 23.7
Get Socket Error +USOER .............................................................................................................. 306 Connect Socket +USOCO ............................................................................................................. 306
23.8
Write Socket Data +USOWR ......................................................................................................... 307
23.9 23.10
Send To command +USOST (UDP only) ......................................................................................... 309 Read Socket Data +USORD ........................................................................................................... 310
WLS-SW-11000-B
Preliminary
Contents Page 12 of 426
u-blox Wireless Modules - AT Commands Manual
23.11 23.12
Receive From command +USORF (UDP only) ................................................................................. 311 Set Listening Socket +USOLI .......................................................................................................... 313
23.13
Firewall control +UFRW ................................................................................................................. 314
23.14 23.15
Set socket in Direct Link mode +USODL ........................................................................................ 315 Socket Control +USOCTL .............................................................................................................. 315
24 FTP ............................................................................................................................. 317 24.1 24.2
FTP Control +UFTP ........................................................................................................................ 317 FTP Command +UFTPC ................................................................................................................. 318
24.3
FTP Unsolicited Data URC +UUFTPCD............................................................................................ 321
24.4 24.5
FTP Command Result URC +UUFTPCR........................................................................................... 321 FTP Error +UFTPER......................................................................................................................... 322
25 HTTP .......................................................................................................................... 323 25.1
HTTP Control +UHTTP ................................................................................................................... 323
25.2
HTTP Command +UHTTPC ............................................................................................................ 324
25.3 25.4
HTTP Command Result URC +UUHTTPCR ..................................................................................... 326 HTTP Protocol Error +UHTTPER ...................................................................................................... 326
26 SMTP ......................................................................................................................... 328 26.1 26.2
SMTP Control +USMTP ................................................................................................................. 328 SMTP Mail Control +USMTPM ...................................................................................................... 329
26.3
SMTP Command +USMTPC .......................................................................................................... 331
26.4 26.5
SMTP Command Result URC +UUSMTPCR .................................................................................... 331 SMTP Error +USMTPER .................................................................................................................. 332
27 PING........................................................................................................................... 333 27.1
Ping Command +UPING ................................................................................................................ 333
28 GPS ............................................................................................................................ 335 28.1
GPS Power Management +UGPS .................................................................................................. 335
28.2 28.3
Assisted GPS unsolicited indication +UGIND .................................................................................. 336 GPS Profile configuration +UGPRF................................................................................................. 337
28.4
AssistNow Online configuration +UGAOP ..................................................................................... 339
28.5 28.6
AssistNow Offline configuration +UGAOF ..................................................................................... 340 GPS Aiding request command +UGAOS ....................................................................................... 340
28.7
Send of UBX string +UGUBX ......................................................................................................... 341
28.8 28.9
GPS Indications timer +UGTMR ..................................................................................................... 342 Get GPS Time and date +UGZDA .................................................................................................. 342
28.10
Get GPS fix data +UGGGA ............................................................................................................ 343
28.11 28.12
Get geographic position +UGGLL .................................................................................................. 344 Get number of GNSS satellites in view +UGGSV ........................................................................... 345
28.13
Get recommended minimum GNSS data +UGRMC ....................................................................... 345
28.14 28.15
Get course over ground and ground speed +UGVTG .................................................................... 346 Get satellite information +UGGSA ................................................................................................ 347
WLS-SW-11000-B
Preliminary
Contents Page 13 of 426
u-blox Wireless Modules - AT Commands Manual
28.16 28.17
Ask for localization information +ULOC ........................................................................................ 348 Configure GNSS sensor +ULOCGNSS ............................................................................................ 350
28.18
Configure cellular location sensor (CellLocate) +ULOCCELL ........................................................... 352
29 In-Band Modem ........................................................................................................ 353 29.1
Introduction .................................................................................................................................. 353
29.2
InBM status +UIBMSTAT ............................................................................................................... 353
29.3 29.4
InBM sends and receives data +UIBMDATA ................................................................................... 355 eCall status +UECALLSTAT ............................................................................................................ 356
29.5
eCall type +UECALLTYPE .............................................................................................................. 356
30 I2C............................................................................................................................... 358 30.1
Introduction .................................................................................................................................. 358
30.2 30.3
I C open logical channel +UI2CO .................................................................................................. 358 2 I C write to peripheral +UI2CW ..................................................................................................... 359
30.4
I C read from peripheral +UI2CR ................................................................................................... 360
30.5 30.6
I C read from peripheral register +UI2CREGR ................................................................................ 360 2 I C close logical channel +UI2CC ................................................................................................... 360
2
2 2
31 SAP ............................................................................................................................ 362 31.1 31.2
Introduction .................................................................................................................................. 362 SAP Mode activation +USAPMODE ............................................................................................... 362
31.3
SAP Mode indications +USAPIND .................................................................................................. 363
Appendix ........................................................................................................................ 365 A Appendix 1 ............................................................................................................... 365 A.1
Internet suite error classes ................................................................................................................ 365
A.1.1 A.1.2
FTP class error codes ..................................................................................................................... 365 HTTP class error codes ................................................................................................................... 368
A.1.3
SMTP class error codes .................................................................................................................. 369
A.1.4 File System Class Error codes ......................................................................................................... 369 A.2 Ping error codes................................................................................................................................ 371 A.3
Internal TCP/UDP/IP stack class error codes ....................................................................................... 371
A.4 A.5
FOAT Error Messages ........................................................................................................................ 373 FOTA Error codes .............................................................................................................................. 373
A.5.1
FOTA class - UA errors .................................................................................................................. 373
A.5.2 A.5.3
FOTA class - Data Connection errors ............................................................................................. 375 FOTA class - SMS Errors ................................................................................................................ 375
A.5.4
B
FOTA class - HTTP errors ............................................................................................................... 376
A.6 A.7
Mobile Termination error result codes +CME ERROR ........................................................................ 376 Message service failure result codes +CMS ERROR ............................................................................ 382
A.8
+CEER error codes ............................................................................................................................ 384
AT Commands List .................................................................................................... 392
WLS-SW-11000-B
Preliminary
Contents Page 14 of 426
u-blox Wireless Modules - AT Commands Manual
C
B.1 B.2
Parameters stored in profiles ............................................................................................................. 405 Parameters stored in non volatile memory ........................................................................................ 410
B.3
Saving AT commands configuration .................................................................................................. 415
B.4 B.5
Estimated command response time .................................................................................................. 415 Multiple AT command interfaces ...................................................................................................... 416
UDP Direct Link workflow ....................................................................................... 417 C.1 C.2
Data from the IP network to the external port .................................................................................. 417 Data from the external port to the IP network .................................................................................. 417
D Glossary .................................................................................................................... 419 Related documents......................................................................................................... 423 Revision history .............................................................................................................. 425 Contact ............................................................................................................................ 426
WLS-SW-11000-B
Preliminary
Contents Page 15 of 426
u-blox Wireless Modules - AT Commands Manual
1 AT command settings u-blox Wireless Modules provides at least a physical serial interface (UART) compliant to V.24ter which starts in the command mode. For more details on command mode please refer to chapter 1.1. For module and hyper terminal connection and settings see EVK-G25H Evaluation Kit Getting Started [43] or EVK-U12 EVK-U13 Getting Started [48] or EVK-G20 Evaluation Kit Getting Started [55] or EVK-U20 Getting Started [68].
1.1 Definitions In this document the following naming conventions are used: DCE (Data Communications Equipment) or MT (Mobile Terminal): u-blox wireless module TE (Terminal Equipment) or DTE (Data Terminal Equipment): terminal that sends the command to the module The terms DCE and DTE are used in the serial interface context. u-blox Wireless Modules implement more than one interface between DTE and DCE, either virtual interfaces (multiplexer channels) or physical interfaces (UART, USB, SPI, etc., when available). Each interface works as specified by the followings definitions. If not differently stated, all the subsequent descriptions are applicable to every interface. The differences among the interfaces in reference to the AT command interface are presented in the Appendix B.5. The DCE interface can operate in two different modes: Command mode: the DCE waits for AT command instructions. Any characters sent to the DCE are interpreted as commands for the DCE to execute. The DCE may send responses back to the DTE indicating the outcome of the command or further information without having received any commands by the DTE (e.g. unsolicited response code - URC). Any communication in command mode (in either direction) is terminated by the command line termination character Data mode: the DCE transfers data after having sent the “CONNECT” string; any character sent to the DCE is intended to be transmitted to the remote party. Any further characters received over the serial link are deemed to be from the remote party, and any characters sent are transmitted to the remote party. The DCE enters data mode immediately after it makes a CSD or PSD connection Online command mode: the DCE is communicating with a remote party, but treats signals from the DTE on TxD as command lines and sends responses to the DTE on RxD It is possible to switch between data and online command mode (when a data connection is established) in the following ways: with the escape sequence: for more details please refer to chapter S2 via a DTR ON to OFF transition: for more details please refer to +++ table To switch back to data mode from online command mode ATO command is used. For more details please refer to O command (chapter 14.19) and &D command (chapter 14.4).
WLS-SW-11000-B
Preliminary
AT command settings Page 16 of 426
u-blox Wireless Modules - AT Commands Manual
1.1.1 Command description AT commands configure and enable the wireless module functionalities in accordance to 3GPP normative and u-blox specifications. AT commands are provided to the module via a hyper terminal through a command line and are described in the following chapters. A general description of each command is provided including functionalities, correct syntax to be provided by the TE/DTE, possible responses, and an example. The command description defines each parameter of the command with its scope and parameter type, the supported values and the default value (when available). The commands that apply to each u-blox wireless module are listed in the chapter B. The example provided in the command description refers only to the handling provided by the command. It could be applied only to a product not to all products which the document is applied to. The list of allowed values for a specific product is provided in the corresponding Defined Values chapter. In this document
are intentionally omitted. If a parameter is omitted, no value will be inserted between the two commas indicating the interested parameter in the command line sent by the DTE. The following rules are used when describing the command syntax: <…>: Name in angle brackets is a parameter. The brackets themselves do not appear in the command line […]: the square brackets represent the optional parameters of a command or an optional part of the TA information response. Brackets themselves do not appear in the command line. When parameter is not given, the value will be set to the default value provided in the command description
1.1.2 Default values If the command parameters are optional, they can be also left out in the command line. In such cases normal default values are assumed as follows: In case of Number type parameters, the default value is 0, except the cases specified for each concerned command In case of String type parameters, the default value is an empty string, except the cases specified for each concerned command
1.1.3 Command line AT commands are typically provided to wireless modules using a command line with the following generic syntax: “AT” Where: “AT”: prefix to be set at the beginning of each command line : command name string; it can have a ‘+’ character as prefix : string consisting of the value parameters following the syntax provided in this manual : Command line termination character, the character can be set with ATS3 command; the default value is (for more details refer to chapter 14.21) The maximum number characters sent on the same command line is 512. This value depends on the hyper terminal used; in some cases the number of characters is lower. The command line is not case sensitive except the following case: if autobauding is enabled then the attention mark “AT” must be typed either as “AT” or “at”; other combinations (e.g “At”) are not allowed.
WLS-SW-11000-B
Preliminary
AT command settings Page 17 of 426
u-blox Wireless Modules - AT Commands Manual
When writing or sending an SMS, CtrlZ or ESC terminates the command; is used between the 2 parts of the SMS (address and text). More than one AT command can be entered on the same command line. The "AT" prefix must be provided only at the beginning of the command line. Each command must be separated by using a semicolon as delimiter only if the command has a ‘+’ character as prefix. Example: AT&VE1;+CMGF?;+COPS? Not all commands can be entered with other commands on the same command line: +CMGW, +CMGS, +USOWR, +USOST, + UDWNFILE must be used stand-alone.
1.1.4 Information responses and result codes The response format can be set with ATV command (for more details refer to the command description, section 14.31). The default setting (ATV1) is as follows: Information responses: Result codes: where : Command line termination character, the character can be set with S3 command (for more details refer to chapter 14.21) is the linefeed character, with value specified by command S4 (for more details refer to chapter 14.22) If the command line is performed successfully, the string “OK” is sent. If the command is not accepted by the MT an error message will be displayed. The format of the error message can be set with AT+CMEE command (see the command description form more details). The default setting adopted in this manual is AT+CMEE=2 and the error message is displayed with the format: +CMS ERROR: if it is the response to a SMS related AT command, and with the format: +CME ERROR: If it is the response to any other AT command. where represents the result code using verbose values. The most typical errors are listed as follows: If the command is not supported or unknown, either “+CME ERROR: unknown” or “+CME ERROR: operation not supported” is sent If the command syntax is wrong, +CME ERROR: operation not supported is sent (it will be +CMS ERROR: operation not supported for SMS related commands) The list of all allowed errors is available in Appendix A.6 and A.7. For some commands only the message “ERROR” is displayed and is documented in the command description. A different procedure will be followed for the following operations: o FTP, HTTP, SMTP, TCP, UDP connection o
PING operation
o Firmware Update over AT command and over the air More details for retrieving the error type for these operations are provided in the corresponding chapters.
WLS-SW-11000-B
Preliminary
AT command settings Page 18 of 426
u-blox Wireless Modules - AT Commands Manual
1.2 Profiles The default settings of some commands are stored in the memory of the wireless module (for a complete list of the command please refer to chapter B.1). While a subset of these commands is stored in the non volatile memory, other default settings of the commands are organized in two personal profiles. The first profile is the default profile and the data contained in him is used during the module power on (for the complete list of the commands and their values please refer to B.1. For more details related to the loading, storing and updating of the profiles please refer to AT&W (chapter 14.7), AT&V (chapter 14.8) command description.
1.3 S-parameters The S-parameters, as specified in ITU-T reccomandation V250 [20], constitute a group of commands that begin with the string “ATS”. They are generally indicated as S registers and are used to configure the way to operate of the module. Their syntax is: ATS? ATS= The number following the “ATS” is the referenced S parameter. u-blox Wireless Modules supports the following set of S-parameters (): 0: Automatic answer setting (for more details please refer to chapter 6.17) 2: Escape character setting (for more details please refer to chapter 14.19.2) 3: Command line termination character setting (for more details please refer to chapter 14.21) 4: Response formatting character setting (for more details please refer to chapter 14.22) 5: Command line editing character setting (for more details please refer to chapter 14.23) 6: Pause before blind dialling setting (for more details please refer to chapter 14.24) 7: Connection completion timeout setting (for more details please refer to chapter 14.25) 8: Command dial modifier time setting (for more details please refer to chapter 14.26) 10: Automatic disconnect delay setting (for more details please refer to chapter 14.27) 12: Escape prompt delay setting (for more details please refer to chapter 14.28) If a different from the aboves is introduced, the S command returns ERROR (+CME ERROR: operation not supported).
WLS-SW-11000-B
Preliminary
AT command settings Page 19 of 426
u-blox Wireless Modules - AT Commands Manual
2 General operation 2.1 Start up and initialization A complete start up can take place only with an SIM-card with disabled PIN-check. For a SIM-card with enabled PIN check the most commands are answered with +CME ERROR: SIM-PIN requested. After entering PIN via +CPIN command, which allows a start up completion, a lot of SIM-files will be read; it is possible that some commands are affected for a few seconds. The serial interface driver does not allow a new command, until the old one is terminated by OK or +CME ERROR: . If at start up the MT detects inconsistencies related to the NVRAM the following message is displayed: “! NVR DOES NOT FIT TO SW-VERSION. NVR-update is needed !”.
2.2 AT Commands mode 2.2.1 Action Command An Action Command is used to force the DCE to transmit an information or execute a specific action for the command. A typical usage of this command mode is to provide the manufacturer settings proper of the DCE like manufacturer name, firmware version, etc.
2.2.2 Set Command A Set Command is performed to set the preferred settings for the specific command. The set command is the only way to set the preferred settings in the DCE. For a subset of the commands is possible to store in the profile the current settings and retrieve them in another connection.
2.2.3 Read Command A Read Command provides the current values of the command parameters. It is used to know the last configuration of the parameters of the command.
2.2.4 Test Command A Test Command provides the complete list of the values supported by each parameter of the command. For a specific set of commands the information can be provided directly by the DCE when a specific event happens. This type of command is an unsolicited (or intermediate) result and can be enabled through a set command.
2.2.5 Unsolicited Result Code (URC) An unsolicited result code is a string message (provided by the DCE) which is not a response to a previous AT command and can be output, when enabled, at any time to inform the DTE of a specific event or status change. The URC can have the same name of the command that enables it (e.g. +CREG) or can be enabled by another command (e.g. unsolicited result code: +CMTI, command that enables it: +CNMI).
2.2.6 Intermediate Result Code (IRC) An intermediate result code is a string message (provided by the DCE) which informs the DTE of the processing status of the pending AT command.
WLS-SW-11000-B
Preliminary
General operation Page 20 of 426
u-blox Wireless Modules - AT Commands Manual
3 IPC – Inter Processor Communication 3.1 Multiplexing mode +CMUX 3.1.1 Description Enables the multiplexing protocol control channel as defined in 3GPP 27.010 (for more details please refer to [46]). The command sets parameters for the control channel. If parameters are no specified, the default values are used. The response code is returned using the old interface speed. The parameters become active only after sending OK. Usage of +CMUX command while multiplexing is not allowed. The multiplexer configuration is reported as follows: Channel 0: control channel Channel 1 – 5: AT commands /data connection Channel 6: GPS tunnelling Type
Syntax
Response
Example
Set
AT+CMUX=[,[,[,[,[,[,[, [,]]]]]]]
OK
AT+CMUX=0,0,,1500,50,3,90
AT+CMUX?
+CMUX: ,[],,,,,,[,]
Read
OK +CMUX: 0,0,0,1500,253,3,254,0,0 OK
OK Test
AT+CMUX=?
+CMUX: (list of supported s),(list of supported s),(list of supported s), (list of supported s), (list of supported s),(list of supported s),(list of supported s),(list of supported s), (list of supported s)
+CMUX: (0),(0),,(1-1509),,(0-5),,, OK
OK
3.1.2 Defined Values Parameter
Type
Description
Number
Multiplexer Transparency Mechanism:
Number
The way in which the multiplexer control channel is set up:
0: Basic option 0: UIH frames used only (default)
Number
Transmission rate: Valid range is 0-7 on LISA-U1 / LISA-U2 series; on LEON-G100 / LEON-G200 series can only be set to 0 Default value is 7 on LISA-U1 / LISA-U2 series, 0 on LEON-G100 / LEON-G200 series This parameter is ignored and the value 0 is always displayed in case of read command.
Number
Maximum frame size Valid range is 1-1509 Default value is 31
WLS-SW-11000-B
Preliminary
IPC – Inter Processor Communication Page 21 of 426
u-blox Wireless Modules - AT Commands Manual
Parameter
Type
Description
Number
Acknowledgement timer in units of ten milliseconds Valid range is 1-255 Default value is 10 On LISA-U1 / LISA-U2 series it must be lower than or equal to This parameter is ignored and the value 253 is always set.
Number
Maximum number of re-transmissions Valid range is 0-5 Default value is 3
Number
Response timer for the multiplexer control channel in units of ten milliseconds Valid range is 1-254 on LISA-U1 / LISA-U2 series; 0-255 on LEON-G100 / LEON-G200 series 0 means that the timer is ignored Default valueis 30 On LISA-U1 / LISA-U2 series, it must be greater than This parameter is ignored and the value 254 is always set
Number
Wake up response timer Valid range is 0-255 on LISA-U1 / LISA-U2 series; on LEON-G100 / LEON-G200 series can only be set to 0 This parameter is ignored and the value 0 is always displayed in case of read command.
Number
Window size, for Advanced operation with Error Recovery options; Valid range is 0-255 on LISA; on LEON can only be set to 0 This parameter is ignored and the value 0 is always displayed in case of read command
If the multiplexer protocol is not started (+CMUX set command has not been issued or returned ERROR) and +CMEE is set to 2, the +CMUX read command returns the following error message: +CME ERROR: operation not allowed. For complete compatibility between u-blox products, leave the unsupported/unused parameters blank (which are reported as blank by the +CMUX test).
WLS-SW-11000-B
Preliminary
IPC – Inter Processor Communication Page 22 of 426
u-blox Wireless Modules - AT Commands Manual
4 General 4.1 Manufacturer identification +CGMI 4.1.1 Description Text string, determined by the manufacturer, identifying the manufacturer. Type
Syntax
Response
Example
Action
AT+CGMI
u-blox
OK
OK
Test
AT+CGMI=?
OK
4.1.2 Defined Values Parameter
Type
Description
String
Manufacturer name
4.2 Request model identification +CGMM 4.2.1 Description Text string, determined by the manufacturer, identifying the model identification. Type
Syntax
Response
Example
Action
AT+CGMM
LEON-G200
OK
OK
Test
AT+CGMM=?
OK
4.2.2 Defined Values Parameter
Type
Description
String
Name of model
4.3 Request Firmware version +CGMR 4.3.1 Description Returns the firmware version of the module. Type
Syntax
Response
Example
Action
AT+CGMR
11.40
OK
OK
Test
AT+CGMR=?
WLS-SW-11000-B
OK
Preliminary
General Page 23 of 426
u-blox Wireless Modules - AT Commands Manual
4.3.2 Defined Values Parameter
Type
Description
String
Firmware version
4.4 Request for IMEI +CGSN 4.4.1 Description Returns the product serial number, IMEI (International Mobile Equipment Identity) of the MT. Type
Syntax
Response
Example
Action
AT+CGSN
004999010640000
OK
OK
Test
AT+CGSN=?
OK
4.4.2 Defined Values Parameter
Type
Description
String
IMEI
4.5 Set TE character set +CSCS 4.5.1 Description Selects the TE character set. Type
Syntax
Response
Example
Set
AT+CSCS=
OK
AT+CSCS=”IRA” OK
Read Test
AT+CSCS? AT+CSCS=?
+CSCS=
+CSCS="IRA"
OK
OK
+CSCS: (list of supported 's)
+CSCS: ("IRA","GSM","PCCP437","88591","UCS2","HEX")
OK
OK
WLS-SW-11000-B
Preliminary
General Page 24 of 426
u-blox Wireless Modules - AT Commands Manual
4.5.2 Defined Values Parameter
Type
String
Description "IRA": International Reference Alphabet (ITU-T T.50) "GSM": GSM default alphabet (3GPP TS 23.038) "PCCP437": PC character set Code Page 437 "8859-1": ISO 8859 Latin 1 character set "UCS2": 16-bit universal multiple-octet coded character set (USO/IEC10646); UCS2 character strings are converted to hexadecimal numbers from 0000 to FFFF; e.g. "004100620063" equals three 16-bit characters with decimal values 65, 98 and 99 "HEX": character strings consist only of hexadecimal numbers from 00 to FF; e.g. "032FE6" equals three 8-bit characters with decimal values 3, 47 and 230; no conversions to the original MT character set shall be done
4.6 Request international mobile subscriber identification +CIMI 4.6.1 Description Request the IMSI (International Mobile Subscriber Identity). Type
Syntax
Response
Example
Action
AT+CIMI
222107701772423
OK
OK
Test
AT+CIMI=?
OK
4.6.2 Defined Values Parameter
Type
String
Description
4.7 Card identification +CCID 4.7.1 Description Returns the ICCID (Integrated Circuit Card ID) of the SIM-card. ICCID is a serial number identifying the SIM. Type
Syntax
Response
Example
Action
AT+CCID
+CCID:
+CCID: 8939107800023416395
OK
OK
+CCID:
+CCID: 8939107900010087330
OK
OK
Read Test
AT+CCID? AT+CCID=?
OK
4.7.2 Defined Values Parameter
Type
Description
String
ICCID of the SIM card
WLS-SW-11000-B
Preliminary
General Page 25 of 426
u-blox Wireless Modules - AT Commands Manual
4.8 Request complete capabilities list +GCAP 4.8.1 Description This command requests the list of capabilities, containing the corresponding command names. The Complete Capabilities List command indicates the major capability areas of the MT. Each area is presented by the selection command name of the specific capability area or some other predefined response. The first response text (+FCLASS) informs that some fax or voice capabilities are present while the second supported area presented with +CGSM shows that all GSM commands of the present document are supported. Type
Syntax
Response
Example
Action
AT+GCAP
+GCAP: [, […]]
+GCAP: +FCLASS, +CGSM OK
OK Test
AT+GCAP=?
OK
4.8.2 Defined Values Parameter
Type
Description
String
Command name or predefined response of the specific capability area In the Example: +FCLASS response text informs that some fax or voice capabilities are present, while +CGSM response text shows that all GSM commands of the present document are supported by the MT
4.9 Repeat last command A/ 4.9.1 Description Repeats the previously executed command again. Only the A/ command cannot be repeated. Type
Syntax
Action
A/
Response
Example
If autobauding is active, the MT is not able to recognize the command and the the command A/ cannot be used.
WLS-SW-11000-B
Preliminary
General Page 26 of 426
u-blox Wireless Modules - AT Commands Manual
5 Mobile equipment control and status 5.1 Phone activity status +CPAS 5.1.1 Description Returns the activity status of the MT. Type
Syntax
Response
Action
AT+CPAS
+CPAS:
Example
OK Test
AT+CPAS=?
+CPAS: (list of supported s)
+CPAS: (0-5)
OK
OK
5.1.2 Defined Values Parameter
Type
Number
Description 0: ready (MT allows commands from DTE) 1: unavailable (MT does not allow commands from DTE) 2: unknown (MT is not guaranteed to respond to instructions) 3: ringing (MT is ready for commands from DTE, but the ringer is active) 4: call in progress (MT is ready for commands from DTE, but a call is in progress, e.g. call active, hold, disconnecting) 5: asleep (ME is unable to process commands from DTE because it is in a low functionality state)
5.2 Switch off MT +CPWROFF 5.2.1 Description Switches off the MT. During shut-down current settings are saved in module’s non-volatile memory. Using this command can result in following command line being ignored. Type
Syntax
Response
Action
AT+CPWROFF
OK
Test
AT+CPWROFF=?
OK
Example
5.3 Set phone functionality +CFUN 5.3.1 Description Selects level of functionality in the MT. If the syntaxes +CFUN=15 or +CFUN=16 (resets) are used, the rest of the command line, placed after that, will be ignored.
WLS-SW-11000-B
Preliminary
Mobile equipment control and status Page 27 of 426
u-blox Wireless Modules - AT Commands Manual
Type
Syntax
Response
Example
Set
AT+CFUN=[,]
OK
AT+CFUN=1 OK
Read
AT+CFUN?
Test
AT+CFUN=?
+CFUN: ,
+CFUN: 1,0
OK
OK
+CFUN: (list of supported ’s),(list of supported ’s)
+CFUN: (0,1,4,6,7,8,15,16),(0-1) OK
OK
5.3.2 Defined Values Parameter
Type
Description
Number
Selected functionality 0: sets the MT to minimum functionality (disable both transmit and receive RF circuits) 1: sets the MT to full functionality, e.g. from airplane mode or minimum functionality (factory-programmed setting) 4: disables both transmit and receive RF circuits (i.e. “airplane mode”) 6: enables the SIM-toolkit interface in dedicated mode and fetching of proactive commands by SIM-APPL from the SIM-card 7 or 8: disables the SIM-toolkit interface and enables fetching of proactive commands by SIM-APPL from the SIM-card 9: enables the SIM-toolkit interface in raw mode and fetching of proactive commands by SIM-APPL from the SIM-card 15: MT silent reset (with detach from network and saving of NVM parameters), without reset of the SIM card) 16: MT silent reset (with detach from network and saving of NVM parameters), with reset of the SIM card
Number
Reset mode. This parameter can be used only when is 1 or 4. 0 (default value): do not reset the MT before setting it to the selected , and save it in NVM for using also at every power on from now on 1: reset the MT before setting it to the selected (which is used only once)
Number
0: MT is switched on with minimum functionality 1: MT is switched on 4: MT is in “airplane mode”
Number
6: the SIM-toolkit interface in dedicated mode and fetching of proactive commands by SIM-APPL from the SIM-card are enabled 0, 7 or 8: the SIM-toolkit interface is disabled; fetching of proactive commands by SIM-APPL from the SIM-card is enabled 9: the SIM-toolkit interface in raw mode and fetching of proactive commands by SIM-APPL from the SIM-card are enabled
On LISA-U1x0-00S versions =9 and =9 are not supported. On LEON-G100 / LEON-G200 series, the following restrictions must be be considered: o
=4 is not supported (=0 can be used instead)
o o
=9 is not supported =15 behaves as =16: the MT is reset as well as the SIM card
o
parameter is not available on LEON-G100-05S / LEON-G200-05S and previous versions
o o
=1 can be used only if =1 =9 is not supported
WLS-SW-11000-B
Preliminary
Mobile equipment control and status Page 28 of 426
u-blox Wireless Modules - AT Commands Manual
5.4 Battery charge +CBC 5.4.1 Description Returns battery status and battery charge level of the MT. The charge level will be also used to build and display the indicator “battchg” i.e. battery charge level in the response code +CIND (refer to chapter 5.5) and in the URC +CIEV (refer to chapter 5.6). The following mapping of “battchg” to exists: “battchg”
0
< 17%
1
< 33%
2
< 50%
3
< 67%
4
< 83%
5
>= 83%
Type
Syntax
Response
Example
Action
AT+CBC
+CBC: ,
+CBC: 0,69
OK
OK
+CBC: (list of supported ’s), (list of supported ’s)
+CBC: (0-3),(0-100)
Test
AT+CBC=?
OK
OK
5.4.2 Defined Values Parameter
Type
Description
Number
Battery status 0: MT is powered by the battery 1: MT has a battery connected, but is not powered by it 2: RFU 3: Recognized power fault, calls inhibited
Number
Battery charge level 0: battery is exhausted, or MT does not have a battery connected; 1..100: battery has 1-100 percent remaining.
5.5 Indicator control +CIND 5.5.1 Description The command provides indication states related to network status, battery information and so on. In Set mode, the command does not allow setting the values for those indications which are set according to module state (see parameter). The list of indications for set and read follows the indexes reported in the parameter, so that the first corresponds to “battchg” and so on. For more details please refer to 3GPP 27.007 Technical Specification [2]. Type
Syntax
Response
Example
Set
AT+CIND=[[,[,…]]]
OK
AT+CIND= OK
WLS-SW-11000-B
Preliminary
Mobile equipment control and status Page 29 of 426
u-blox Wireless Modules - AT Commands Manual
Type
Syntax
Response
Example
Read
AT+CIND?
+CIND: [,[,…]]
+CIND: 5,0,0,0,0,0,0,0,0,0,0,0
OK
OK
+CIND: (list of s)
+CIND: ("battchg",(0-5)),("signal",(05)),("service",(0,1)),("sounder",(0,1)),(" message",(0,1)),("call",(0,1)),("roam",(0 ,1)),("smsfull",(0,1)),("gprs",(02)),("callsetup",(03)),("callheld",(0,1)),("simind",(0-2))
Test
AT+CIND=?
OK
OK
5.5.2 Defined Values Parameter
Type
Description
Number
Range of corresponding used to identify the service when an unsolicited indication is provided
String
Reserved by the norm and their ranges; it may have the values: "battchg": battery charge level (0-5); see also +CBC (refer to chapter 5.4) for details "signal": signal quality. See mapping in the note below. "service": network service availability o 0: Not registered to the network o 1: Registered to the network "sounder": sounder activity, indicating when the module is generating a sound o 0: no sound o 1: sound is generated "message": Unread message available in storage o 0: no messages o 1: unread message available "call": call in progress o 0: No call in progress o 1: Call in progress "roam": Registration on a roaming network o 0: Not in roaming o 1: Roaming "smsfull": Indication that an SMS has been rejected with the cause of SMS storage full o 0: SMS storage not full o 1: SMS Storage full "gprs": GPRS indication status: o 0: No GPRS available in the network o 1: GPRS available in the network but not registered o 2: Registered to GPRS "callsetup" : call set-up: o 0: no call set-up o 1: incoming call not accepted or rejected o 2: outgoing call in dialing state o 3: outgoing call in remote party alerting state "callheld" : call on hold: o 0: no calls on hold o 1: at least one call on hold "simind": SIM detection o 0: No SIM detected o 1: SIM detected o 2: not available
If the battery charging is not supported, “battchg” always returns 5 (full charge). The values cannot be changed with +CIND set. “simind” is not supported on LEON-G100/G200 series module.
WLS-SW-11000-B
Preliminary
Mobile equipment control and status Page 30 of 426
u-blox Wireless Modules - AT Commands Manual
To enable SIM detection status it is needed to opportunely configure the GPIO pin; for more details please refer to +UGPIOC command description, chapter 18.2. The following mapping of “signal” value to parameter (+CSQ AT command) exists: “signal” value
value
Power level
0
< 4 or 99
(<= -106 dBm or unknown)
1
< 10
(<= -94 dBm)
2
< 16
(<= -82 dBm)
3
< 22
(<= -70 dBm)
4
< 28
(<= -58 dBm)
5
>=28
(>= -57 dBm)
5.6 Mobile termination event reporting +CMER 5.6.1 Description Enables or disables sending of URCs from MT to DTE for indications. parameter controls the processing of URCs specified within this command. The URC is generated each time an indicator which is defined in +CIND command changes status. The code is actually submitted to MT according to the settings of +CMER. The command +UCIND allows enabling or disabling indicators (for more details refer to chapter 17.30). Type
Syntax
Response
Example
Set
AT+CMER=[[,[,[,< ind>[,]]]]]
OK
AT+CMER=1,0,0,2,1
AT+CMER?
+CMER: ,,,,
Read
OK +CMER: 1,0,0,0,1 OK
OK Test
AT+CMER=?
+CMER: (list of supported ’s), (list of supported ’s), (list of supported ’s), (list of supported ’s), (list of supported ’s)
+CMER: (0-3),(0),(0),(0-2),(0,1) OK
OK URC
+CIEV: ,
5.6.2 Defined Values Parameter
Type
Number
0: buffer URCs in the MT (default value) 1: discard URCs when the V.24 interface is reserved for data; otherwise display them on DTE directly 2: buffer URCs in MT when the V.24 interface is reserved and flush them after reservation; otherwise display them on DTE directly 3: same as 1
Number
0: no keypad event reporting
Number
0: no display event reporting
WLS-SW-11000-B
Description
Preliminary
Mobile equipment control and status Page 31 of 426
u-blox Wireless Modules - AT Commands Manual
Parameter
Type
Number
Description 0: no indicator event reporting 1: indicator event reporting using result code +CIEV: , where indicates the indicator order number and is the new value indicator. Only the indicator events which are not caused by +CIND shall be indicated by the MT to the DTE. 2: indicator event reporting using result code +CIEV: ,. All indicator events shall be directed from MT to DTE.
Number
Number
0: MT buffer of URCs defined within this command is cleared when 1…3 is entered 1: MT buffer of URCs defined within this command is flushed to the DTE when 1…3 is entered (OK response shall be given before flushing the codes). 1 ("battchg"): provides the battery charge level (0-5); see also +CBC (refer to chapter 5.4) for details 2 ("signal"): provides the signal quality o 0: < -107 dBm o 1: < -93 dBm o 2: < -71 dBm o 3: < -69 dBm o 4: < - 57 dBm o 5: >= -57 dBm 3 ("service"): provides the network service availability o 0: Not registered to the network o 1: Registered to the network 4 ("sounder"): provides the sounder activity, indicating when the module is generating a sound o 0: no sound o 1: sound is generated 5 ("message"): provides the unread message available in storage o 0: no messages o 1: unread message available 6 ("call"): provides the call in progress o 0: No call in progress o 1: Call in progress 7 ("roam"): provides the registration on a roaming network o 0: Not in roaming o 1: Roaming 8 ("smsfull"): provides the Indication that an SMS has been rejected with the cause of SMS storage full o 0: SMS storage not full o 1: SMS Storage full 9 ("gprs"): provides the GPRS indication status: o 0: No GPRS available in the network o 1: GPRS available in the network but not registered o 2: Registered to GPRS 10 ("callsetup"): provides the call set-up: o 0: no call set-up o 1: incoming call not accepted or rejected o 2: outgoing call in dialing state o 3: outgoing call in remote party alerting state 11 ("callheld") : provides the call on hold: o 0: no calls on hold o 1: at least one call on hold 12 ("simind"): provides the SIM detection o 0: No SIM detected o 1: SIM detected
=12 is not available on LEON-G100 / LEON-G200 series.
WLS-SW-11000-B
Preliminary
Mobile equipment control and status Page 32 of 426
u-blox Wireless Modules - AT Commands Manual
5.7 Clock +CCLK 5.7.1 Description Sets the real-time clock of the MT. Type
Syntax
Response
Example
Set
AT+CCLK=