U Blox AT Commands Manual
u-blox%20AT%20Commands%20Manual
User Manual: Pdf
Open the PDF directly: View PDF .
Page Count: 875
Download | |
Open PDF In Browser | View PDF |
CELLULAR u-blox Cellular Modules Data and Voice Modules AT Commands Manual Abstract Description of standard and proprietary AT commands used with u-blox cellular modules. www.u-blox.com UBX-13002752 - R56 u-blox Cellular Modules - AT Commands Manual Document Information Title u-blox Cellular Modules Subtitle Data and Voice Modules Document type AT Commands Manual Document number UBX-13002752 Revision and date R56 22-Nov-2017 Disclosure restriction u-blox reserves all rights to this document and the information contained herein. Products, names, logos and designs described herein may in whole or in part be subject to intellectual property rights. Reproduction, use, modification or disclosure to third parties of this document or any part thereof without the express permission of u-blox is strictly prohibited. The information contained herein is provided “as is” and u-blox assumes no liability for the use of the information. No warranty, either express or implied, is given, including but not limited, with respect to the accuracy, correctness, reliability and fitness for a particular purpose of the information. This document may be revised by u-blox at any time. For most recent documents, visit www.u-blox.com. Copyright © 2017, u-blox AG u-blox is a registered trademark of u-blox Holding AG in the EU and other countries. UBX-13002752 - R56 Page 2 of 875 u-blox Cellular Modules - AT Commands Manual Preface Applicable products This document applies to the following products: Name LEON-G100 Type number LEON-G100-06S-02 Modem version 07.60.17 LEON-G100-07S-01 07.92 UBX-13005361 LEON-G100-08S-01 LISA-U100-01S-00 LISA-U110-01S-00 07.92 11.40 11.40 UBX-13005361 UBX-TN-12008 UBX-TN-12008 LISA-U110-50S-00 11.46 UBX-TN-12081 LISA-U120 LISA-U110-60S-00 LISA-U120-01S-00 11.43 11.40 UBX-TN-12050 UBX-TN-12008 LISA-U130 LISA-U120-01S-01 LISA-U130-01S-00 11.50 11.40 UBX-13002821 UBX-TN-12008 LISA-U200 LISA-U130-60S-00 LISA-U200-00S-00 11.43 21.21 - UBX-TN-12050 UBX-TN-12009 LISA-U200-01S-00 22.40 - UBX-TN-12040 LISA-U200-02S-01 22.90 A01.01 UBX-14005768 LISA-U200-03S-00 23.41 A01.01 UBX-15020745 LISA-U200-52S-01 22.86 A01.01 UBX-14005768 LISA-U200-62S-01 22.90 A01.01 UBX-14005768 LISA-U200-62S-02 LISA-U200-83S-00 LISA-U201-03A-00 22.90 23.41 23.41 A01.02 A01.01 A01.01 UBX-16017712 UBX-15020745 UBX-16010501 LISA-U201-03A-01 23.41 A01.02 UBX-17010533 LISA-U201 FOTA LISA-U230 LISA-U260 LISA-U201-03S-00 LISA-U201-83S-00 LISA-U230-01S-01 LISA-U260-01S-02 23.41 23.41 22.40 22.61 A01.01 A01.02 A01.00 A01.02 UBX-15020745 UBX-16006079 UBX-TN-12040 UBX-14042086 LISA-U270 LISA-U260-02S-02 LISA-U270-01S-02 22.90 22.61 A01.02 A01.02 UBX-14042086 UBX-TN-12061 LISA-U270-02S-02 22.90 A01.02 UBX-13003492 LISA-U270-62S-04 22.93 A01.02 UBX-13003492 LISA-U270-62S-05 22.93 A01.04 UBX-15029938 LISA-U270-62S-06 22.93 A01.05 UBX-16009934 LISA-U270-63S-00 22.93 A01.06 UBX-16010383 SARA-G300 LISA-U270-68S-00 SARA-G300-00S-00 22.93 08.58 A01.03 - UBX-15019240 GSM.G2-TN-13007 SARA-G310 SARA-G300-00S-01 SARA-G310-00S-00 08.58 08.58 A01.01 - UBX-16010060 GSM.G2-TN-13007 SARA-G340 SARA-G310-00S-01 SARA-G340-00S-00 08.58 08.49 A01.01 - UBX-16010060 UBX-14000382 SARA-G340-01S-00 08.70 - UBX-14039634 SARA-G340-02S-00 SARA-G340-02X-00 SARA-G350-00S-00 08.90 08.90 08.49 A00.02 A00.02 - UBX-16001074 UBX-16017766 GSM.G2-TN-13002 LISA-U100 LISA-U110 LISA-U200 FOTA LISA-U201 SARA-G340 ATEX SARA-G350 UBX-13002752 - R56 Application version PCN reference UBX-13005361 Preface Page 3 of 875 u-blox Cellular Modules - AT Commands Manual Name Type number SARA-G350-01S-00 Modem version 08.70 Application version - PCN reference UBX-14039634 SARA-G350-02A-01 08.90 A00.06 UBX-17002293 SARA-G350-02S-00 08.90 A00.02 UBX-16001074 SARA-G350 ATEX SARA-G350-01B-00 SARA-G350-00X-00 TBD 08.49 - TBD GSM.G2-TN-13002 SARA-U201 SARA-G350-02X-00 SARA-U201-03A-00 08.90 23.60 A00.02 A01.02 UBX-16001074 UBX-17012748 SARA-U201-03B-00 23.60 A01.01 UBX-16018086 SARA-U201-63B-00 23.62 A01.01 UBX-17053345 SARA-U201-04A-00 23.60 A01.06 UBX-17058162 SARA-U201 ATEX SARA-U201-04B-00 SARA-U201-03X-00 23.60 23.60 A01.06 A01.01 UBX-17058162 UBX-16030157 SARA-U260 SARA-U201-04X-00 SARA-U260-00S-01 23.60 23.20 A01.06 A01.01 UBX-17058162 UBX-15013844 SARA-U270 SARA-U260-03S-00 SARA-U270-00S-00 23.41 23.20 A01.01 A01.00 UBX-15020745 UBX-14015739 SARA-U270-00S-01 23.20 A01.01 UBX-16006754 SARA-U270-03A-00 23.41 A01.01 UBX-17004455 SARA-U270-03S-00 23.41 A01.01 UBX-15020745 SARA-U270-53S-00 23.41 A01.03 UBX-16008757 SARA-U270-53S-01 23.41 A01.04 UBX-17011151 SARA-U270 ATEX SARA-U280 SARA-U270-73S-00 SARA-U270-00X-00 SARA-U280-00S-00 23.41 23.20 23.28 A01.02 A01.00 A01.00 UBX-16028821 TBD UBX-15013708 TOBY-L4906 SARA-U280-03S-00 TOBY-L4906-00A-00 23.41 TBD A01.01 TBD UBX-15020745 TBD TOBY-L4906-00B-00 TBD TBD TBD TOBY-L4906-50A-00 TOBY-L200-00S-00 40.19 09.71 A00.02 A01.15 UBX-17058711 UBX-14044437 TOBY-L200-00S-01 09.71 A01.30 UBX-16026448 TOBY-L200-02S-00 15.90 A01.00 UBX-15029946 TOBY-L200-02S-01 15.90 A01.10 UBX-16031212 TOBY-L200-03S-00 TOBY-L201-01S-00 15.90 09.93 A01.50 A01.07 UBX-17022983 UBX-15021135 TOBY-L201-02S-00 For AT&T: A02.50 For VZW: A01.02 A01.15 UBX-17013932 TOBY-L210-00S-00 For AT&T: 09.93 For VZW: 09.94 09.71 TOBY-L210-02S-00 15.63 A01.03 UBX-15029946 TOBY-L210-02S-01 15.63 A01.10 UBX-16031212 TOBY-L210-03S-00 15.63 A01.50 UBX-17022983 TOBY-L210-60S-00 09.94 A01.00 UBX-15021694 TOBY-L210-60S-01 09.94 A01.01 UBX-16005471 TOBY-L220 TOBY-L210-62S-00 TOBY-L220-02S-00 16.05 15.93 A01.02 A01.00 UBX-17003573 UBX-16025501 TOBY-L280 TOBY-L220-62S-00 TOBY-L280-02S-00 16.04 15.63 A01.00 A01.03 UBX-17013073 UBX-15029946 TOBY-L280-02S-01 15.63 A01.10 UBX-16031212 TOBY-L200 TOBY-L201 TOBY-L210 UBX-13002752 - R56 UBX-14044437 Preface Page 4 of 875 u-blox Cellular Modules - AT Commands Manual Name TOBY-R200 Type number TOBY-L280-03S-00 TOBY-R200-02B-00 Modem version 15.63 30.31 Application version A01.50 A01.01 PCN reference UBX-17022983 UBX-17006265 TOBY-R202 TOBY-R200-02B-01 TOBY-R202-02B-00 30.31 30.31 A02.00 A01.01 UBX-17048314 UBX-17006265 LARA-R202 LARA-R203 LARA-R204 LARA-R211 LARA-R220 LARA-R280 MPCI-L200 TOBY-R202-02B-01 LARA-R202-02B-00 LARA-R203-02B-00 LARA-R204-02B-00 LARA-R211-02B-00 LARA-R220-62B-00 LARA-R280-02B-00 MPCI-L200-00S-00 30.31 30.42 30.39 31.34 30.31 30.43 30.43 09.71 A02.00 A01.00 A01.00 A01.00 A01.02 A01.01 A01.00 A01.15 UBX-17048314 UBX-17057959 UBX-17048311 UBX-17012269 UBX-17012270 UBX-17061668 UBX-17056887 UBX-14044437 MPCI-L200-00S-01 09.71 A01.30 UBX-16026448 MPCI-L200-02S-00 15.90 A01.00 UBX-15029946 MPCI-L200-02S-01 15.90 A01.10 UBX-16031212 MPCI-L280-03S-00 MPCI-L201-01S-00 15.90 09.93 A01.50 A01.07 UBX-17022983 UBX-15031360 MPCI-L201-02S-00 For AT&T: A02.50 For VZW: A01.02 A01.15 UBX-17013932 MPCI-L210-00S-00 For AT&T: 09.93 For VZW: 09.94 09.71 MPCI-L210-02S-00 15.63 A01.03 UBX-15029946 MPCI-L210-02S-01 15.63 A01.10 UBX-16031212 MPCI-L210-03S-00 15.63 A01.50 UBX-17022983 MPCI-L210-60S-00 09.94 A01.00 UBX-15021694 MPCI-L220 MPCI-L210-60S-01 MPCI-L220-02S-00 09.94 15.93 A01.01 A01.00 UBX-16005471 UBX-16025501 MPCI-L280 MPCI-L220-62S-00 MPCI-L280-02S-00 16.04 15.63 A01.00 A01.03 UBX-17013073 UBX-15029946 MPCI-L280-02S-01 15.63 A01.10 UBX-16031212 MPCI-L280-03S-00 15.63 A01.50 UBX-17022983 MPCI-L201 MPCI-L210 UBX-14044437 How to use this Manual The u-blox Cellular Modules AT Commands Manual provides the necessary information to successfully design in and configure the applicable u-blox cellular modules. 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. Summary table The summary table on the top of each command section is a quick reference for the user. UBX-13002752 - R56 Preface Page 5 of 875 u-blox Cellular Modules - AT Commands Manual command_name Modules TOBY-L2 MPCI-L2 LISA-U110 LISA-U120 LISA-U130 LISA-U2 LEON-G1 SARA-G3 Attributes Syntax PIN required Settings saved full No No Can be aborted No Response time - Error reference - It is composed of two sections: • Modules: lists all the modules that support the command. The modules are grouped in rows by cellular standard (i.e. L for LTE high data rate (Cat 3 and above), R for LTE low data rate (Cat 1 and below), U for UMTS/ HSPA, G for GSM/GPRS). In each row the modules are grouped by: form factor (i.e. SARA, LISA), platform technology (e.g. SARA-G), platform generation (e.g. SARA-G3), product name (e.g. SARA-G350) and ordering code (e.g. SARA-G350-00S). In example: if 'LISA-U2' is reported, the command applies to all the modules having LISA form factor, second chipset version provided with any release of firmware. • Attributes o Syntax - full: the command syntax is fully compatible among all the products listed in the "Modules" section - partial: the products support different syntaxes (usually backward compatible with respect to previous cellular standards) o PIN required - Yes: it is necessary to insert the PIN before the set and/or read command execution - No: the PIN insertion is not needed to execute the command o Settings saved - Profile: the command setting can be saved in a personal profile as specified in Chapter 1.2 - NVM: the command setting is saved in the non-volatile memory as specified in Chapter 1.2 - No: the current command setting is volatile and cannot be saved o Can be aborted - Yes: the command execution can be aborted if a character is sent to the DCE during the command execution - No: the command cannot be aborted during the command execution o Response time: estimated maximum time to get the final result code for the AT command execution. More precisely, the command response time measures the time from the complete acquisition of the command line to the issuing of the command result code. This kind of response time is generally lower than the time measured by the application on the DTE, because the issuing of the command on the DTE is influenced by the AT interface characteristics (e.g. the synchronous/asynchronous transfer type, the selected baudrate, etc.), by power saving and flow control, which introduce a variable latency in the command acquisition by the DCE. For example, the maximum expected response time shall be extended if the communication with the module is carried out on a MUX virtual port, because in this case the command line and the result code are transferred via a specific protocol running on the physical port, that might introduce additional communication delay due to framing and retransmissions. Similarly, the maximum expected response time of AT commands accessing the SIM shall be extended if the module is using a remote SIM card via SAP instead of the local SIM card. If the response time for a command is left blank (actually "-"), it is an "immediate" response. It means that the command is executed without asynchronous requests to the protocol stack or the internal applications, which usually require time to be answered: the command execution is synchronous (implying that no long blocking processing is done) and lasts a negligible time (the command response is issued by the module in typically less than 10 ms, and in any case less than 1 s). The response time shall be extended if the issued AT command triggers a service that cannot be served immediately due to concurrent access to the same service or resource via AT commands issued on a different communication port or from internal applications; typical examples are registration commands UBX-13002752 - R56 Preface Page 6 of 875 u-blox Cellular Modules - AT Commands Manual and SIM access, that can be also autonomously triggered by the module (e.g. auto-COPS) and can therefore postpone the execution of the AT commands issued by the user. o Error reference: reference to the error result codes listed in the Appendix A 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 AT commands supported by u-blox cellular modules. System Integration Manual: This document describes u-blox cellular modules from the hardware and the software point of view. It provides hardware design guidelines for the optimal integration of the cellular module in the application device and it provides information on how to set up production and final product tests on application devices integrating the cellular module. Application Notes: These documents provide guidelines and information on specific u-blox cellular module hardware or software topics. See Related documents for application notes related to your cellular module. Questions If you have any questions about u-blox Cellular Hardware Integration, please: • Read this manual carefully • Contact our information service on our homepage 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. SARA-G350-00S-00) and firmware version (e.g. 08.49) • Module configuration • Clear description of your question or the problem • A short description of the application • Your complete contact details UBX-13002752 - R56 Preface Page 7 of 875 u-blox Cellular Modules - AT Commands Manual Contents 1 AT command settings..................................................................................................21 1.1 Definitions....................................................................................................................................21 1.2 Profiles...........................................................................................................................................26 1.3 S-parameters................................................................................................................................. 26 2 General operation........................................................................................................27 2.1 Start up and initialization.............................................................................................................. 27 2.2 AT commands types......................................................................................................................28 3 IPC - Inter Processor Communication......................................................................... 30 3.1 Multiplexing mode +CMUX...........................................................................................................30 4 General..........................................................................................................................33 4.1 Manufacturer identification +CGMI............................................................................................... 33 4.2 Manufacturer identification +GMI................................................................................................. 33 4.3 Model identification +CGMM........................................................................................................33 4.4 Model identification +GMM.......................................................................................................... 34 4.5 Firmware version identification +CGMR.........................................................................................34 4.6 Firmware version identification +GMR........................................................................................... 35 4.7 IMEI identification +CGSN............................................................................................................. 35 4.8 IMEI identification +GSN............................................................................................................... 36 4.9 Identification information I............................................................................................................ 36 4.10 TE character set configuration +CSCS......................................................................................... 37 4.11 International mobile subscriber identification +CIMI.................................................................... 37 4.12 Card identification +CCID........................................................................................................... 38 4.13 Request complete capabilities list +GCAP.................................................................................... 38 4.14 Display FGI settings +UFGI.......................................................................................................... 39 4.15 Repeat last command A/............................................................................................................. 39 4.16 List all available AT commands +CLAC........................................................................................40 4.17 Help displaying all commands &H............................................................................................... 40 5 Mobile equipment control and status....................................................................... 42 5.1 Phone activity status +CPAS..........................................................................................................42 5.2 Module switch off +CPWROFF...................................................................................................... 42 5.3 Set module functionality +CFUN................................................................................................... 43 5.4 Indicator control +CIND.................................................................................................................45 5.5 Configuration of indicator control +UCIND................................................................................... 47 5.6 Mobile termination event reporting +CMER.................................................................................. 48 5.7 Clock +CCLK.................................................................................................................................50 5.8 Alarm +CALA................................................................................................................................ 50 5.9 Delete alarm +CALD..................................................................................................................... 52 5.10 Alert sound mode +CALM.......................................................................................................... 53 5.11 Ringer sound level +CRSL............................................................................................................53 5.12 Loudspeaker volume level +CLVL................................................................................................ 54 5.13 Mute control +CMUT.................................................................................................................. 55 5.14 Set greeting text +CSGT............................................................................................................. 56 5.15 Automatic time zone update +CTZU........................................................................................... 56 5.16 Time zone reporting +CTZR........................................................................................................ 57 5.17 List current calls +CLCC.............................................................................................................. 58 5.18 IMS single radio voice call continuity +CISRVCC..........................................................................60 UBX-13002752 - R56 Contents Page 8 of 875 u-blox Cellular Modules - AT Commands Manual 5.19 Report mobile termination error +CMEE..................................................................................... 60 5.20 Extended error report +CEER.......................................................................................................61 5.21 Proprietary extended error report +UCEER...................................................................................62 6 Call control................................................................................................................... 64 6.1 Select type of address +CSTA....................................................................................................... 64 6.2 Dial command D........................................................................................................................... 64 6.3 Direct calling from phonebooks D>...............................................................................................66 6.4 Select tone dialling T.....................................................................................................................67 6.5 Select pulse dialling P....................................................................................................................67 6.6 Call answer A................................................................................................................................68 6.7 Hook control H............................................................................................................................. 68 6.8 Monitor speaker loudness L.......................................................................................................... 69 6.9 Monitor speaker mode M............................................................................................................. 69 6.10 Call mode +CMOD..................................................................................................................... 70 6.11 Hang up call +CHUP................................................................................................................... 70 6.12 Single numbering scheme +CSNS................................................................................................71 6.13 Set reporting call status +UCALLSTAT......................................................................................... 72 6.14 Information to in-band-tones availability +UPROGRESS................................................................73 6.15 Tone duration +VTD....................................................................................................................74 6.16 DTMF and tone generation +VTS................................................................................................ 75 6.17 Start and stop tone generation +UVTS........................................................................................76 6.18 Redial last telephone number DL.................................................................................................76 6.19 Automatic answer S0.................................................................................................................. 77 6.20 Set voice mail number +CSVM....................................................................................................78 6.21 Emergency call reporting configuration +UEMC.......................................................................... 78 6.22 Emergency number verification +UEMN...................................................................................... 79 7 Network service........................................................................................................... 80 7.1 Subscriber number +CNUM...........................................................................................................80 7.2 Signal quality +CSQ...................................................................................................................... 80 7.3 Extended signal quality +CESQ......................................................................................................83 7.4 Operator selection +COPS............................................................................................................. 84 7.5 MCC update table +UNVMMCC................................................................................................... 90 7.6 PLMN information list +UNVMPLMN............................................................................................. 92 7.7 Radio Access Technology (RAT) selection +URAT...........................................................................95 7.8 Display EONS names +UEONS....................................................................................................... 97 7.9 Display operator name +UDOPN................................................................................................... 98 7.10 Preferred PLMN list selection +CPLS............................................................................................ 99 7.11 PS operator selection +UCGOPS................................................................................................100 7.12 Network registration status +CREG........................................................................................... 101 7.13 HSDPA/HSUPA mode configuration +UHSDUPA........................................................................ 104 7.14 Preferred operator list +CPOL....................................................................................................106 7.15 Read operator names +COPN....................................................................................................108 7.16 Network emergency bearer services support +CNEM.................................................................108 7.17 Steering of Roaming configuration +UDCONF=20.....................................................................109 7.18 Fast Dormancy activation +UFDAC............................................................................................ 110 7.19 Fast Dormancy configuration +UDCONF=61..............................................................................111 7.20 Network selection control +PACSP............................................................................................ 112 7.21 Integrity check on test networks configuration +UDCONF=81................................................... 113 7.22 Select band +UBANDSEL........................................................................................................... 113 7.23 Select band +UACT................................................................................................................... 115 7.24 Cell environment description +CGED.........................................................................................118 7.25 Neighbour cells configuration +UDCONF=83.............................................................................129 7.26 Channel and network environment description +UCGED...........................................................129 UBX-13002752 - R56 Contents Page 9 of 875 u-blox Cellular Modules - AT Commands Manual 7.27 7.28 7.29 7.30 7.31 7.32 7.33 7.34 7.35 7.36 7.37 7.38 7.39 7.40 7.41 7.42 7.43 7.44 7.45 7.46 7.47 Provide cell information +UCELLINFO........................................................................................ 134 Lock on a specific cell +UCELLLOCK..........................................................................................136 Wireless service selection +WS46.............................................................................................. 141 Service specific access control restriction status +CSSAC........................................................... 142 Home zone reporting +UHOMEZR.............................................................................................144 Jamming detection +UCD......................................................................................................... 144 Smart jamming detection +UJAD.............................................................................................. 147 IMSI detach +UCSDETACH........................................................................................................ 148 MNO configuration +UMNOCONF.............................................................................................149 PLMN list extensions +UMNOPLMN........................................................................................... 152 LTE category configuration +ULTECAT.......................................................................................154 Edit Verizon wireless APN table +VZWAPNE.............................................................................. 154 Read RSRP values +VZWRSRP.................................................................................................... 156 Read RSRQ values +VZWRSRQ.................................................................................................. 156 Closed Subscriber Group +UCSG.............................................................................................. 157 Network Friendly Mode (NFM) activation +UNFM...................................................................... 158 Network Friendly Mode (NFM) configuration +UNFMCONF....................................................... 159 Radio Policy Manager (RPM) activation +URPM......................................................................... 161 Device Aggresion Management configuration +UDAMCFG....................................................... 161 PLMN search configuration in Out Of Coverage +UDCONF=55................................................. 162 Smart radio coverage manager configuration +UDCONF=57..................................................... 163 8 IP Multimedia Subsystem (IMS)................................................................................165 8.1 Introduction.................................................................................................................................165 8.2 IMS client configuration +UIMSCFG............................................................................................ 165 8.3 IMS client registration / deregistration in network +UIMSREG......................................................168 8.4 IMS configuration setting +UIMSCONF........................................................................................169 8.5 Read IMS configuration +UIMSRCONF.........................................................................................172 8.6 IMS registration information +CIREG........................................................................................... 173 8.7 IMS network reporting +CIREP.................................................................................................... 174 8.8 Availability for SMS using IMS +CASIMS..................................................................................... 175 8.9 Availability for voice calls with IMS +CAVIMS..............................................................................175 8.10 UE's Mobility Management IMS Voice Termination +CMMIVT................................................... 176 8.11 UE's voice domain preference UTRAN +CVDP........................................................................... 176 8.12 UE's voice domain preference E-UTRAN +CEVDP.......................................................................177 8.13 Domain configuration for MO SMS messages +UISMS.............................................................. 178 8.14 MO SMS mode configuration +UICMGSMODE......................................................................... 178 8.15 Send 3GPP2 SMS message +UCMGS3GPP2.............................................................................. 179 8.16 Enable/disable the 3GPP2 SMS URC +UCMT3GPP2................................................................... 179 9 Security....................................................................................................................... 182 9.1 9.2 9.3 9.4 9.5 Enter PIN +CPIN.......................................................................................................................... 182 Read remaining SIM PIN attempts +UPINCNT.............................................................................. 183 Facility lock +CLCK......................................................................................................................184 Change password +CPWD.......................................................................................................... 186 Custom SIM lock +USIMLCK....................................................................................................... 186 10 Phonebook................................................................................................................189 10.1 10.2 10.3 10.4 10.5 Select phonebook memory storage +CPBS................................................................................ 189 Read phonebook entries +CPBR................................................................................................ 190 Find phonebook entries +CPBF..................................................................................................191 Write phonebook entry +CPBW................................................................................................ 193 Read/rename phonebook group +UPBGR.................................................................................. 195 11 Short Messages Service...........................................................................................196 11.1 Introduction...............................................................................................................................196 UBX-13002752 - R56 Contents Page 10 of 875 u-blox Cellular Modules - AT Commands Manual 11.2 Select message service +CSMS.................................................................................................. 197 11.3 Preferred message storage +CPMS............................................................................................ 198 11.4 Preferred message format +CMGF............................................................................................ 200 11.5 Save settings +CSAS..................................................................................................................200 11.6 Restore settings +CRES..............................................................................................................201 11.7 Show text mode parameters +CSDH......................................................................................... 201 11.8 New message indication +CNMI................................................................................................202 11.9 Incoming SMS/CBM indication via different AT interfaces +UDCONF=82................................... 205 11.10 Select service for MO SMS messages +CGSMS........................................................................206 11.11 Read message +CMGR............................................................................................................207 11.12 New message acknowledgement to MT +CNMA.................................................................... 209 11.13 List message +CMGL...............................................................................................................210 11.14 Send message (+CMGS/+CMSS) set commands conclusion configuration +UDCONF=13......... 212 11.15 Send message +CMGS............................................................................................................ 213 11.16 Write message to memory +CMGW....................................................................................... 214 11.17 Send message from storage +CMSS........................................................................................215 11.18 Set text mode parameters +CSMP...........................................................................................216 11.19 Delete message +CMGD......................................................................................................... 217 11.20 Primary notification event reporting +CPNER........................................................................... 217 11.21 Service center address +CSCA.................................................................................................218 11.22 Select cell broadcast message types +CSCB.............................................................................219 11.23 Read concatenated message +UCMGR....................................................................................220 11.24 List concatenated message +UCMGL.......................................................................................222 11.25 Send concatenated message +UCMGS....................................................................................225 11.26 Write concatenated message to memory +UCMGW............................................................... 226 11.27 More messages to send +CMMS.............................................................................................227 11.28 Peek message +UCMGP.......................................................................................................... 227 11.29 Message waiting indication +UMWI........................................................................................ 229 11.30 Earthquake and Tsunami Warning System configuration +UETWCFG...................................... 230 11.31 Start ETWS notifications +UETWNTFYSTART............................................................................ 231 11.32 Stop ETWS notifications +UETWNTFYSTOP.............................................................................. 232 12 Supplementary services...........................................................................................234 12.1 Introduction...............................................................................................................................234 12.2 Call forwarding +CCFC............................................................................................................. 234 12.3 Call waiting +CCWA................................................................................................................. 236 12.4 Calling line identification restriction +CLIR.................................................................................238 12.5 Calling line identification presentation +CLIP.............................................................................239 12.6 Connected line identification presentation +COLP..................................................................... 240 12.7 Connected line identification restriction +COLR.........................................................................241 12.8 Advice of charge +CAOC..........................................................................................................241 12.9 Accumulated call meter +CACM............................................................................................... 242 12.10 Call meter maximum event +CCWE........................................................................................ 243 12.11 Accumulated call meter maximum +CAMM............................................................................ 243 12.12 Price per unit and currency table +CPUC................................................................................ 244 12.13 Call related supplementary services +CHLD............................................................................. 245 12.14 Call deflection +CTFR.............................................................................................................. 246 12.15 Supplementary service notifications +CSSN............................................................................. 246 12.16 User to user signalling service 1 +CUUS1................................................................................ 248 12.17 Unstructured supplementary service data +CUSD.................................................................... 249 12.18 Closed user group +CCUG......................................................................................................250 12.19 Calling name presentation +CNAP.......................................................................................... 251 12.20 eMLPP priority registration and interrogation +CAEMLPP.........................................................252 12.21 eMLPP subscriptions +CPPS..................................................................................................... 253 12.22 Automatic answer for eMLPP service +CAAP...........................................................................253 UBX-13002752 - R56 Contents Page 11 of 875 u-blox Cellular Modules - AT Commands Manual 13 Circuit switched data services................................................................................ 255 13.1 Introduction...............................................................................................................................255 13.2 Select bearer service type +CBST...............................................................................................255 13.3 Connection type groups configuration +UDCONF=32............................................................... 257 13.4 Circuit switched data (CSD) configuration +UCSD..................................................................... 258 13.5 Circuit switched data (CSD) action +UCSDA..............................................................................259 13.6 Circuit switched network-assigned data +UCSND......................................................................260 13.7 Service class selection and identification +FCLASS..................................................................... 261 13.8 Service reporting control +CR....................................................................................................262 13.9 Cellular result codes +CRC........................................................................................................ 262 13.10 Radio link protocol +CRLP....................................................................................................... 264 14 FAX class 2............................................................................................................... 265 14.1 Introduction...............................................................................................................................265 14.2 Adaptive answer +FAA..............................................................................................................265 14.3 Address & polling capabilities +FAP...........................................................................................265 14.4 Buffer size +FBS........................................................................................................................ 266 14.5 Data bit order +FBO..................................................................................................................266 14.6 HDLC frame reporting +FBU......................................................................................................267 14.7 DS capabilities parameters +FCC............................................................................................... 267 14.8 Copy quality checking +FCQ..................................................................................................... 268 14.9 Capability to receive data +FCR................................................................................................ 268 14.10 Current session results +FCS................................................................................................... 269 14.11 DTE phase C response timeout +FCT...................................................................................... 269 14.12 Receive data +FDR...................................................................................................................270 14.13 Transmit Data +FDT.................................................................................................................270 14.14 Phase C received EOL alignment +FEA.................................................................................... 270 14.15 Format conversion +FFC.......................................................................................................... 271 14.16 Report file transfer diagnostic frame +FFD...............................................................................272 14.17 Call termination status +FHS................................................................................................... 272 14.18 Procedure interrupt enable +FIE.............................................................................................. 272 14.19 Initialize facsimile parameters +FIP...........................................................................................273 14.20 Current session parameters +FIS..............................................................................................274 14.21 Inactivity timeout +FIT............................................................................................................. 274 14.22 Session termination +FKS, +FK................................................................................................ 275 14.23 Local ID string +FLI..................................................................................................................275 14.24 Set flow control +FLO............................................................................................................. 276 14.25 Indicate document to poll +FLP............................................................................................... 276 14.26 Request manufacturer identification +FMI............................................................................... 277 14.27 Request model identification +FMM........................................................................................ 277 14.28 Request revision identification +FMR....................................................................................... 277 14.29 Minimum phase C speed +FMS.............................................................................................. 278 14.30 Negotiation reporting +FNR.....................................................................................................278 14.31 Non-standard frame FIF octet string +FNS............................................................................... 279 14.32 NSF message data indication +FND......................................................................................... 279 14.33 Selective polling address +FPA.................................................................................................280 14.34 Local polling ID string +FPI...................................................................................................... 280 14.35 Packet protocol control +FPP...................................................................................................281 14.36 Page status +FPS..................................................................................................................... 281 14.37 Password parameter +FPW......................................................................................................282 14.38 Receive quality thresholds +FRQ.............................................................................................. 282 14.39 Error correction mode retry count +FRY.................................................................................. 283 14.40 SubAddress parameter +FSA................................................................................................... 283 14.41 Request to poll +FSP............................................................................................................... 284 UBX-13002752 - R56 Contents Page 12 of 875 u-blox Cellular Modules - AT Commands Manual 14.42 Fax intermediate result codes.................................................................................................. 284 15 V24 control and V25ter........................................................................................... 285 15.1 Introduction...............................................................................................................................285 15.2 Circuit 109 behavior &C............................................................................................................285 15.3 Circuit 108/2 behavior &D.........................................................................................................286 15.4 DSR override &S........................................................................................................................ 287 15.5 Flow control &K........................................................................................................................ 288 15.6 DTE-DCE character framing +ICF...............................................................................................290 15.7 DTE-DCE local flow control +IFC............................................................................................... 292 15.8 Set flow control \Q................................................................................................................... 294 15.9 UART data rate configuration +IPR............................................................................................295 15.10 Return to on-line data state O................................................................................................ 299 15.11 Escape character S2................................................................................................................ 300 15.12 Command line termination character S3................................................................................. 301 15.13 Response formatting character S4........................................................................................... 302 15.14 Command line editing character S5........................................................................................ 302 15.15 Pause before blind dialling S6................................................................................................. 303 15.16 Connection completion timeout S7......................................................................................... 303 15.17 Command dial modifier time S8............................................................................................. 304 15.18 Automatic disconnect delay S10..............................................................................................305 15.19 Escape prompt delay (EPD) S12...............................................................................................305 15.20 Command echo E................................................................................................................... 306 15.21 Result code suppression Q...................................................................................................... 306 15.22 DCE response format V...........................................................................................................307 15.23 Result code selection and call progress monitoring control X...................................................307 15.24 Reset to default configuration Z.............................................................................................. 308 15.25 Set to factory defined configuration &F...................................................................................308 15.26 Store current configuration &W.............................................................................................. 309 15.27 Display current configuration &V.............................................................................................309 15.28 Designate a default reset profile &Y........................................................................................310 15.29 Parity bit transmission over the air +UTPB............................................................................... 311 16 SIM management.....................................................................................................314 16.1 Generic SIM access +CSIM........................................................................................................ 314 16.2 Restricted SIM access +CRSM....................................................................................................314 16.3 Read the SIM language +CLAN.................................................................................................316 16.4 Check for UICC card +UUICC................................................................................................... 316 16.5 Customer service profile +UCSP................................................................................................ 317 16.6 SIM hot insertion configuration +UDCONF=50.......................................................................... 317 16.7 UICC application discovery +CUAD........................................................................................... 319 16.8 Open logical channel +CCHO....................................................................................................319 16.9 Close logical channel +CCHC....................................................................................................320 16.10 Generic UICC logical channel access +CGLA........................................................................... 321 16.11 Restricted UICC logical channel access +CRLA.........................................................................322 16.12 SIM states reporting +USIMSTAT.............................................................................................323 16.13 Answer To Reset contents +USIMATR..................................................................................... 324 16.14 Perform SIM switch +XSIMSWITCH......................................................................................... 325 17 SIM toolkit................................................................................................................326 17.1 17.2 17.3 17.4 17.5 Introduction...............................................................................................................................326 Terminal profile +STKPROF........................................................................................................ 327 Proactive command in dedicated mode +STKPRO......................................................................327 Terminal response in dedicated mode +STKTR.......................................................................... 330 Proactive session status in dedicated mode +STKCNF................................................................ 333 UBX-13002752 - R56 Contents Page 13 of 875 u-blox Cellular Modules - AT Commands Manual 17.6 Bearer Independent Protocol status indication +UBIP.................................................................334 17.7 Default BIP APN configuration +UBIPAPN.................................................................................. 335 17.8 Envelope in dedicated mode +STKENV......................................................................................335 17.9 Call and short message control in dedicated mode +STKCC......................................................336 17.10 Proactive command indication in raw mode +SATI.................................................................. 337 17.11 Proactive command notification in raw mode +SATN.............................................................. 337 17.12 Send terminal response in raw mode +SATR........................................................................... 337 17.13 Terminal response confirmation in raw mode +SATF............................................................... 338 17.14 User confirmation for setup call in raw mode +SATD.............................................................. 338 17.15 Envelope download in raw mode +SATE................................................................................. 339 17.16 Call and Short Message Control in Raw Mode +STKCTRLIND.................................................. 339 17.17 Terminal profile +UCATPROF................................................................................................... 340 17.18 Proactive command indication in dedicated mode +UCATPROI................................................341 17.19 Proactive command notification in dedicated mode +UCATPRON............................................ 342 17.20 Terminal response in dedicated mode +UCATTR..................................................................... 343 17.21 Proactive Session Status in Dedicated Mode +UCATCNF..........................................................344 17.22 Envelope in Dedicated Mode +UCATENV................................................................................ 344 17.23 Call and Short Message Control in Dedicated Mode +UCATCC...............................................345 17.24 Proactive Command Indication in Raw Mode +URCATI........................................................... 345 17.25 Proactive Command Notification in Raw Mode +URCATN....................................................... 346 17.26 Terminal response in Raw Mode +URCATR............................................................................. 346 17.27 Proactive Session Status in Raw Mode +URCATF..................................................................... 347 17.28 Envelope in Raw Mode +URCATE........................................................................................... 347 17.29 Call and Short Message Control in Raw Mode +URCATCC..................................................... 347 17.30 User setting for proactive DTMF tone generation +UDTMF...................................................... 348 17.31 Refresh delay events management +UDCONF=54................................................................... 349 18 Packet switched data services................................................................................ 350 18.1 Introduction and common parameters definition....................................................................... 350 18.2 PPP LCP handshake behaviour...................................................................................................352 18.3 Printing IP address format +CGPIAF.......................................................................................... 353 18.4 PDP context definition +CGDCONT........................................................................................... 354 18.5 Protocol configuration options configuration +UPCO................................................................ 357 18.6 IPv6 configuration +UDCONF=66.............................................................................................. 360 18.7 Packet switched data configuration +UPSD............................................................................... 361 18.8 Packet switched data action +UPSDA........................................................................................367 18.9 Packet switched network-assigned data +UPSND...................................................................... 369 18.10 Read PDP context DNS information +UDCONF=11.................................................................. 370 18.11 Dynamic DNS request +UDNS................................................................................................. 370 18.12 Quality of service profile (requested) +CGQREQ...................................................................... 372 18.13 Quality of service profile (minimum acceptable) +CGQMIN......................................................373 18.14 GPRS attach or detach +CGATT.............................................................................................. 374 18.15 Configure the auto attach to PS domain on power on +UCGATT............................................375 18.16 PDP context activate or deactivate +CGACT............................................................................376 18.17 Control ESM cause 52 handling +UDCONF=12....................................................................... 379 18.18 Manual response to a network request for PDP context activation +CGANS............................ 380 18.19 Automatic response to a network request for PDP context activation +CGAUTO......................381 18.20 Enter data state +CGDATA..................................................................................................... 382 18.21 Enter PPP state/GPRS dial-up D*............................................................................................. 384 18.22 Show PDP address +CGPADDR............................................................................................... 385 18.23 GPRS MS class configuration +CGCLASS.................................................................................386 18.24 GPRS MS class configuration at start up +UCGCLASS............................................................. 387 18.25 Device class setting +UCLASS..................................................................................................388 18.26 GPRS event reporting +CGEREP.............................................................................................. 390 18.27 GPRS network registration status +CGREG..............................................................................393 UBX-13002752 - R56 Contents Page 14 of 875 u-blox Cellular Modules - AT Commands Manual 18.28 18.29 18.30 18.31 18.32 18.33 18.34 18.35 18.36 18.37 18.38 18.39 18.40 18.41 18.42 18.43 18.44 18.45 18.46 18.47 18.48 18.49 18.50 18.51 18.52 18.53 18.54 18.55 Extended Packet Switched network registration status +UREG.................................................395 Manual deactivation of a PDP context H................................................................................. 396 PDP context modify +CGCMOD.............................................................................................. 396 3G Quality of service profile (requested) +CGEQREQ............................................................... 397 3G Quality of service profile (minimum acceptable) +CGEQMIN.............................................. 401 3G Quality of Service Profile (negotiated) +CGEQNEG............................................................. 404 Define secondary PDP context +CGDSCONT........................................................................... 407 UE modes of operation for EPS +CEMODE..............................................................................408 EPS network registration status +CEREG................................................................................. 410 Delete non-active PDP contexts +CGDEL................................................................................. 412 Traffic flow template read dynamic parameters +CGTFTRDP....................................................412 Configure the authentication parameters of a PDP/EPS bearer +UAUTHREQ............................ 414 Send custom packets over a context +UTGSINK...................................................................... 415 Define EPS quality of service +CGEQOS.................................................................................. 416 EPS quality of service read dynamic parameters +CGEQOSRDP................................................ 417 Secondary PDP context read dynamic parameters +CGSCONTRDP...........................................418 UE's usage setting for EPS +CEUS...........................................................................................419 PDP Context Read Dynamic Parameters +CGCONTRDP........................................................... 419 Configure the initial EPS bearer / PDP context +UCGDFLT....................................................... 421 Always-On mode parameters settings +CGPERMSET............................................................... 423 Always-On mode settings +CGPERMACT................................................................................ 424 Always-On mode check state +CGPERMSTATE........................................................................425 Traffic Flow Template +CGTFT................................................................................................ 425 Read counters of sent or received PSD data +UGCNTRD......................................................... 428 Set/reset counter of sent or received PSD data +UGCNTSET.................................................... 429 Uplink user data plane configuration +UDCONF=9..................................................................430 Multiple PDP contexts..............................................................................................................430 Primary and secondary PDP contexts....................................................................................... 431 19 System features....................................................................................................... 432 19.1 Firmware installation +UFWINSTALL.......................................................................................... 432 19.2 Firmware update Over AT (FOAT) +UFWUPD.............................................................................435 19.3 Antenna detection +UANTR...................................................................................................... 438 19.4 RX antenna selection +UANT.................................................................................................... 439 19.5 Rx diversity +URXDIV.................................................................................................................440 19.6 ADC read command +UADC.....................................................................................................441 19.7 Power saving control (Power SaVing) +UPSV............................................................................. 441 19.8 End user test +UTEST................................................................................................................ 445 19.9 Smart temperature supervisor +USTS.........................................................................................454 19.10 MSPR profile handling configuration +UDCONF=40................................................................ 455 19.11 Data channel configuration +UDATACHANNEL....................................................................... 456 19.12 RING line handling +URING.....................................................................................................458 19.13 CTS line state in case of disabled HW flow control +UCTS...................................................... 459 19.14 PPP/LCP silent mode configuration +UDCONF=0..................................................................... 459 19.15 F-DPCH/enhanced F-DPCH configuration +UDCONF=60.......................................................... 460 19.16 USB profiles configuration +UUSBCONF.................................................................................. 461 19.17 Serial interfaces configuration selection +USIO........................................................................ 463 19.18 Establish ECM data connection +UCEDATA.............................................................................465 19.19 Start, stop and configure the OMA-DM client +UOMADM...................................................... 467 19.20 OMA-DM alert +UOMADMALERT........................................................................................... 468 19.21 OMA-DM repository access +UOMADMREP............................................................................ 469 19.22 Enable/disable OMA-DM unsolicited status messages +UOMASTAT......................................... 470 19.23 Restore factory configuration +UFACTORY.............................................................................. 471 19.24 KT remote reset KTCFUN........................................................................................................ 473 19.25 KT reading quality information KTDEVSTAT.............................................................................473 UBX-13002752 - R56 Contents Page 15 of 875 u-blox Cellular Modules - AT Commands Manual 19.26 19.27 19.28 19.29 19.30 KT configuration command KTUBXCONF................................................................................ 475 Reject international calls KTUCALLREJ......................................................................................475 Request KT OTA opening *KTF*OPENING............................................................................... 476 Display the current UMTS environment KTUUMTSENV............................................................ 476 Last gasp configuration +ULGASP........................................................................................... 478 20 GPIO.......................................................................................................................... 480 20.1 20.2 20.3 20.4 Introduction...............................................................................................................................480 GPIO select configuration command +UGPIOC..........................................................................489 GPIO read command +UGPIOR................................................................................................. 492 GPIO set command +UGPIOW.................................................................................................. 492 21 File System............................................................................................................... 494 21.1 21.2 21.3 21.4 21.5 21.6 21.7 File tags.....................................................................................................................................494 Download file +UDWNFILE........................................................................................................ 495 List files information +ULSTFILE................................................................................................. 496 Read file +URDFILE.................................................................................................................... 498 Partial download file +URDBLOCK.............................................................................................499 Delete file +UDELFILE................................................................................................................ 500 File system limits....................................................................................................................... 500 22 Audio interface........................................................................................................ 502 22.1 Audio path mode setting +USPM..............................................................................................502 2 22.2 I S digital interface mode +UI2S................................................................................................508 22.3 Play audio resource +UPAR....................................................................................................... 517 22.4 Stop audio resource +USAR...................................................................................................... 520 22.5 Play audio file +UPLAYFILE........................................................................................................ 521 22.6 Record audio file +URECFILE..................................................................................................... 523 22.7 Stop audio file +USTOPFILE....................................................................................................... 525 22.8 Play audio file +UAPLAY........................................................................................................... 526 22.9 Record audio file +UAREC.........................................................................................................527 22.10 Tone generator +UTGN........................................................................................................... 530 22.11 Ringing tone selection +URNG................................................................................................ 531 22.12 SMS alert sound mode (Message Sound Muting) +UMSM.......................................................532 22.13 Master clock control +UMCLK.................................................................................................533 22.14 External device configuration +UEXTDCONF............................................................................ 534 22.15 Speech codec information +USPEECHINFO.............................................................................. 537 22.16 Speech codec configuration +UDCONF=30............................................................................. 538 22.17 Waiting call tone configuration +UDCONF=33........................................................................ 540 22.18 Hardware audio path test +UMAAT........................................................................................ 540 23 Audio parameters tuning........................................................................................542 23.1 Introduction...............................................................................................................................542 23.2 Microphone gain (Microphone Gain Control) +UMGC.............................................................. 554 23.3 Speaker Gain (Speaker Gain Control) +USGC............................................................................556 23.4 Sidetone configuration +USTN.................................................................................................. 558 23.5 Uplink Digital Filters (Uplink Biquad Filters) +UUBF.................................................................... 559 23.6 Downlink Digital Filters (Downlink Biquad Filters) +UDBF........................................................... 561 23.7 Hands-Free Parameters (Hands-Free Parameters) +UHFP............................................................ 564 23.8 Audio parameters tuning +UAPT...............................................................................................572 23.9 Audio parameters tuning +UTI.................................................................................................. 575 23.10 Volume gain control +UVGC...................................................................................................575 23.11 Microphone analog and digital gains +UMAFE........................................................................ 577 23.12 Speaker analog and digital gains +USAFE................................................................................578 23.13 Microphone select +UMSEL..................................................................................................... 578 UBX-13002752 - R56 Contents Page 16 of 875 u-blox Cellular Modules - AT Commands Manual 24 DNS............................................................................................................................580 24.1 Resolve name / IP number through DNS +UDNSRN................................................................... 580 24.2 Dynamic DNS update +UDYNDNS............................................................................................. 581 25 Internet protocol transport layer........................................................................... 585 25.1 Introduction...............................................................................................................................585 25.2 IPv4/IPv6 addressing.................................................................................................................. 586 25.3 Create Socket +USOCR............................................................................................................. 587 25.4 SSL/TLS mode configuration on TCP socket +USOSEC............................................................... 588 25.5 Set socket option +USOSO........................................................................................................589 25.6 Get Socket Option +USOGO..................................................................................................... 590 25.7 Close Socket +USOCL............................................................................................................... 592 25.8 Get Socket Error +USOER..........................................................................................................592 25.9 Connect Socket +USOCO..........................................................................................................593 25.10 Write socket data +USOWR.................................................................................................... 594 25.11 SendTo command (UDP only) +USOST.................................................................................... 596 25.12 Read Socket Data +USORD..................................................................................................... 598 25.13 Receive From command (UDP only) +USORF........................................................................... 600 25.14 Set Listening Socket +USOLI....................................................................................................601 25.15 Firewall control +UFRW........................................................................................................... 602 25.16 HEX mode configuration +UDCONF=1.................................................................................... 603 25.17 Set socket in Direct Link mode +USODL..................................................................................604 25.18 UDP Direct Link Packet Size configuration +UDCONF=2.......................................................... 606 25.19 UDP Direct Link Sending timer configuration +UDCONF=3...................................................... 607 25.20 Timer Trigger configuration for Direct Link +UDCONF=5......................................................... 607 25.21 Data Length Trigger configuration for Direct Link +UDCONF=6............................................... 608 25.22 Character trigger configuration for Direct Link +UDCONF=7................................................... 608 25.23 Congestion timer configuration for Direct Link +UDCONF=8................................................... 609 25.24 Direct Link disconnect DSR line handling +UDCONF=10.......................................................... 610 25.25 Socket control +USOCTL......................................................................................................... 610 25.26 IP Change Notification +UIPCHGN.......................................................................................... 612 25.27 Socket Always On +USOAO.................................................................................................... 616 26 SSL/TLS......................................................................................................................621 26.1 26.2 26.3 26.4 26.5 Introduction...............................................................................................................................621 SSL/TLS certificates and private keys manager +USECMNG........................................................621 SSL/TLS security layer profile manager +USECPRF...................................................................... 624 AT+USECMNG command example............................................................................................ 626 Notes.........................................................................................................................................627 27 FTP............................................................................................................................. 628 27.1 FTP service configuration +UFTP................................................................................................ 628 27.2 FTP command +UFTPC.............................................................................................................. 631 27.3 FTP error +UFTPER.....................................................................................................................634 28 HTTP.......................................................................................................................... 635 28.1 28.2 28.3 28.4 HTTP HTTP HTTP HTTP control +UHTTP................................................................................................................ 635 advanced control+UHTTPAC.............................................................................................638 command +UHTTPC......................................................................................................... 639 protocol error +UHTTPER..................................................................................................642 29 SMTP......................................................................................................................... 643 29.1 29.2 29.3 29.4 SMTP SMTP SMTP SMTP UBX-13002752 - R56 control +USMTP.............................................................................................................. 643 mail control +USMTPM....................................................................................................645 command +USMTPC....................................................................................................... 646 error +USMTPER.............................................................................................................. 647 Contents Page 17 of 875 u-blox Cellular Modules - AT Commands Manual 30 Ping........................................................................................................................... 648 30.1 Ping command +UPING.............................................................................................................648 30.2 ICMP echo reply configuration +UDCONF=4............................................................................. 650 31 GNSS..........................................................................................................................651 31.1 NMEA........................................................................................................................................651 31.2 GNSS power management +UGPS............................................................................................ 651 31.3 Assisted GNSS unsolicited indication +UGIND............................................................................653 31.4 GNSS profile configuration +UGPRF.......................................................................................... 655 31.5 AssistNow Online configuration +UGAOP..................................................................................657 31.6 AssistNow Offline configuration +UGAOF................................................................................. 658 31.7 Aiding server configuration +UGSRV......................................................................................... 659 31.8 GNSS aiding request command +UGAOS.................................................................................. 661 31.9 Send of UBX string +UGUBX.....................................................................................................661 31.10 GNSS indications timer +UGTMR.............................................................................................663 31.11 Get GNSS time and date +UGZDA.......................................................................................... 664 31.12 Get GNSS fix data +UGGGA................................................................................................... 664 31.13 Get geographic position +UGGLL............................................................................................665 31.14 Get number of GNSS satellites in view +UGGSV..................................................................... 666 31.15 Get recommended minimum GNSS data +UGRMC................................................................. 667 31.16 Get course over ground and ground speed +UGVTG.............................................................. 668 31.17 Get satellite information +UGGSA...........................................................................................668 31.18 Ask for localization information +ULOC.................................................................................. 669 31.19 Ask for time information +UTIME............................................................................................672 31.20 Localization information request status unsolicited indication +ULOCIND.................................674 31.21 Specify the device autonomous solution +ULOCAID................................................................ 675 31.22 GNSS sensor configuration +ULOCGNSS................................................................................. 676 31.23 Configure cellular location sensor (CellLocate®) +ULOCCELL................................................... 678 32 Location Services......................................................................................................680 32.1 32.2 32.3 32.4 32.5 32.6 LCS positioning capabilities configuration +UDCONF=70...........................................................680 Mobile originated location request +CMOLR............................................................................. 681 Mobile terminated location request notification +CMTLR.......................................................... 683 Mobile terminated location request disclosure allowance +CMTLRA.......................................... 684 Report mobile originated location request error +CMOLRE........................................................685 LCS event notification +ULCSEVT.............................................................................................. 686 33 DTMF......................................................................................................................... 687 33.1 DTMF detection +UDTMFD........................................................................................................687 33.2 Local and in-band DTMF tone generation configuration +UDCONF=31..................................... 689 34 eCall...........................................................................................................................690 34.1 34.2 34.3 34.4 34.5 34.6 34.7 Introduction...............................................................................................................................690 eIM sends and receives data +UECALLDATA............................................................................. 691 IVS eIM voice control +UECALLVOICE....................................................................................... 693 eCall configuration +UECALLSTAT.............................................................................................697 eCall and InBM test configuration +UDCONF=90...................................................................... 698 eCall type +UECALLTYPE...........................................................................................................700 Initiate eCall +CECALL...............................................................................................................701 2 35 I C.............................................................................................................................. 702 35.1 35.2 35.3 35.4 35.5 Introduction...............................................................................................................................702 2 I C open logical channel +UI2CO..............................................................................................702 2 I C write to peripheral +UI2CW................................................................................................ 703 2 I C read from peripheral +UI2CR.............................................................................................. 704 2 I C read from peripheral register +UI2CREGR............................................................................704 UBX-13002752 - R56 Contents Page 18 of 875 u-blox Cellular Modules - AT Commands Manual 2 35.6 I C close logical channel +UI2CC.............................................................................................. 705 36 SAP............................................................................................................................ 706 36.1 Introduction...............................................................................................................................706 36.2 SAP mode activation +USAPMODE............................................................................................706 36.3 SAP mode indications +USAPIND.............................................................................................. 708 37 Networking...............................................................................................................709 37.1 37.2 37.3 37.4 37.5 37.6 37.7 37.8 Introduction...............................................................................................................................709 Change the boot mode configuration +UBMCONF................................................................... 710 Configure the Ethernet over USB IP network +UIPCONF............................................................711 Get the USB IP configuration +UIPADDR................................................................................... 712 IP routing configuration +UIPROUTE..........................................................................................714 IP tables configuration +UIPTABLES........................................................................................... 715 Configure PDP/EPS bearer connection type over USB +UDPDP...................................................717 RNDIS driver optimization configuration +UDCONF=67............................................................. 718 38 Wi-Fi.......................................................................................................................... 719 38.1 Introduction...............................................................................................................................719 38.2 Web User Interface (WebUI)...................................................................................................... 722 38.3 Wi-Fi module power mode, connection manager and Cellular / Wi-Fi conflict detection +UWCFG...................................................................................................................................... 723 38.4 Wi-Fi access point physical layer configuration +UWAPCFG....................................................... 724 38.5 Wi-Fi access point network layer configuration +UWAPIPCFG....................................................726 38.6 Wi-Fi station physical layer configuration +UWSTACFG............................................................. 727 38.7 Wi-Fi station network layer configuration +UWSTAIPCFG.......................................................... 729 38.8 Wi-Fi station signal level indicator +UWSTACSQ........................................................................730 38.9 Wi-Fi access point connected stations list +UWAPSTALIST......................................................... 731 38.10 Wi-Fi access point MAC address +UWAPMACADDR............................................................... 731 38.11 Web user interface configuration +UWWEBUI......................................................................... 732 38.12 Web user interface customization through FTP service +UWWEBUIFTP.................................... 732 38.13 Wi-Fi module firmware reset +UWFWRESET............................................................................ 733 38.14 Wi-Fi network scan +UWSCAN............................................................................................... 734 38.15 Maximum allowed output power configuration +UWMP.........................................................735 38.16 Wi-Fi regulatory domains block configuration +UWREGBLOCK................................................736 38.17 Wi-Fi test mode +UWTEST...................................................................................................... 737 A Appendix: Error result codes................................................................................... 739 A.1 Mobile termination error result codes +CME ERROR................................................................... 739 A.2 Message service error result codes +CMS ERROR........................................................................743 A.3 +CEER error result codes............................................................................................................ 747 A.4 Firmware install final result codes............................................................................................... 758 A.5 FOAT error result codes.............................................................................................................. 760 A.6 Dynamic DNS unsolicited indication codes.................................................................................. 760 A.7 Internal TCP/UDP/IP stack class error codes................................................................................. 761 A.8 Internet suite error classes.......................................................................................................... 763 A.9 IP change notification error result codes..................................................................................... 767 A.10 Ping error result codes.............................................................................................................. 768 A.11 Mobile termination error result codes....................................................................................... 768 B Appendix: AT Commands List.................................................................................. 769 B.1 B.2 B.3 B.4 B.5 Parameters stored in profiles....................................................................................................... 841 Parameters stored in non volatile memory...................................................................................846 Saving AT commands configuration............................................................................................ 854 Estimated command response time............................................................................................. 854 Multiple AT command interfaces.................................................................................................855 UBX-13002752 - R56 Contents Page 19 of 875 u-blox Cellular Modules - AT Commands Manual C Appendix: UDP Direct Link workflow......................................................................857 C.1 Data from the IP network to the external port............................................................................857 C.2 Data from the external port to the IP network............................................................................857 D Appendix: Glossary................................................................................................... 859 Related documents...................................................................................................... 862 Revision history........................................................................................................... 867 Contact..........................................................................................................................875 UBX-13002752 - R56 Contents Page 20 of 875 u-blox Cellular Modules - AT Commands Manual 1 AT command settings u-blox cellular modules provide at least one physical serial interface, which is compliant to V.24ter [26]. At the module power on the module enters the command mode. For more details on command mode see the Chapter 1.1. For module and hyper terminal connection and settings see the corresponding evaluation kit user guide. 1.1 Definitions In this document the following naming conventions are used: • MT (Mobile Terminal) or DCE (Data Communications Equipment): u-blox cellular module • TE (Terminal Equipment) or DTE (Data Terminal Equipment): terminal that issues the command to the module • TA (Terminal Adaptor): the function, integrated in the MT, of supporting AT command interface according to the applicable standards • ME (Mobile Equipment): equivalent to MT, it is used to refer to the device itself regardless of the inserted SIM card The terms DCE and DTE are used in the serial interface context. TOBY-L4 / TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 u-blox cellular modules can implement more than one interface between the DTE and the 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 each interface. Appendix B.5 describes the different behaviour among the interfaces in reference to the AT command interface. See the corresponding module data sheet for the list of available AT command interfaces. SARA-U201-04A / SARA-U201-04B / SARA-U201-04X / SARA-G340-02S / SARA-G340-02X / SARA-G350-02A / SARA-G350-02S / SARA-G350-02X Two UART AT interfaces can be used at the same time (it is not the default behaviour). See +USIO command description for details on how to set such behaviour. According to the terminology used in the data sheet, UART is the 9-wire asynchronous serial interface, while AUX UART is the 3-wire auxiliary asynchronous interface. The same naming will be used in the rest of the document (when not clearly specified, the description shall be considered applicable to both the interfaces). The DCE/MT interface can operate in these modes: • Command mode: the DCE waits for AT command instructions. The DCE interprets all the characters received as commands 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 the command mode (in both directions) is terminated by the command line termination character. • Data mode: the DCE transfers data after having sent the "CONNECT" string; all the characters sent to the DCE are 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 Circuit Switched Data (CSD) or Packet Switched Data (PSD) connection. • Online command mode: the DCE has a data connection established with a remote party, but treats signals from the DTE as command lines and sends back responses and unsolicited indications to the DTE. TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 For more details on PSD connection see the +UPSD, +UPSDA and +UPSND commands description. SARA-G3 / LEON-G1 For more details on CSD connection see the +UCSD, +UCSDA and +UCSND commands description. UBX-13002752 - R56 1 AT command settings Page 21 of 875 u-blox Cellular Modules - AT Commands Manual SARA-U201-04A / SARA-U201-04B / SARA-U201-04X / SARA-G340-02S / SARA-G340-02X / SARA-G350-02A / SARA-G350-02S / SARA-G350-02X The AUX UART only supports the command mode. CSD or PSD connection are not allowed. TOBY-L4 The online command mode is not supported. 1.1.1 Switch from data mode to online command mode It is possible to switch from data mode to online command mode (when a data connection is established) in the following ways: • with the escape sequence: for more details see the S2 command description • via a DTR transition: during data mode, the current DTR state is not important, but only its transition. Furthermore, only the DTR transition from ON to OFF is detected; it can be used to control the switch to online command mode, or to command mode (the data connection is released). For more details see the Table 17 and the Table 18 To switch back to data mode from online command mode the O command is used. For more details see also the &D command. 1.1.2 Command description The AT commands configure and enable the cellular module functionalities according to 3GPP normative and u-blox specifications. The AT commands are issued to the module via a hyper terminal through a command line and are described in the following sections. A general description of each command is provided including the functionalities, the correct syntax to be provided by the TE/DTE, the allowed responses and an example. The command description defines each named parameter with its type, its range (valid / acceptable values), the default value (when available) and the factory-programmed value (when applicable). For default value it is intended the value automatically set if the parameter is omitted and at the module power-on (if the command setting is not stored in NVM/profile). For factory-programmed value it is intended the value set at the module power-on when the setting is not modified respect with the manufacturer setting; it is valid for the commands that store the setting in NVM/profile. The summary table on the top of each command section and the Appendix B lists all the u-blox cellular modules that support that command. The example provided in the command description refers only to the handling provided by the command. It may be not valid for all the products which the document is applied to. The list of allowed values for a specific product is provided in the corresponding "Defined values" section. In this documentare intentionally omitted in the command syntax. 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. 1.1.3 Default values If the command parameters are optional, they can be left out in the command line. If not otherwise specified, the default values are assumed as follows: • For parameters of type Number, the default value is 0 • For parameters of type String, the default value is an empty string 1.1.4 Command line The AT commands are typically issued to the cellular modules using a command line with the following generic syntax: "AT" Where: UBX-13002752 - R56 1 AT command settings Page 22 of 875 u-blox Cellular Modules - AT Commands Manual • "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 parameters value following the syntax provided in this manual The following rules are used when describing the command syntax: o <...>: the name in angle brackets is a parameter. The brackets themselves do not appear in the command line o [...]: the square brackets represent the optional parameters of a command or an optional part of the DCE information text response. Brackets themselves do not appear in the command line. When a parameter is not given, the value will be set to the default value provided in the command description Parameter types: o Number: positive and negative counting numbers, as well as zero {..., -2, -1, 0, 1, 2,...}. o String: sequence of characters enclosed within quotation marks (" "). • : command line termination character; the factory-programmed termination character is The maximum length of the command line is the maximum number of characters which can be accepted on a single command line (including the command line termination character). The command line is not case sensitive unless autobauding is enabled; in this case the prefix "AT" must be typed either as "AT" or "at"; other combinations ("aT" or "Ta") are not allowed. When writing or sending an SMS, Ctrl-Z or ESC terminates the command; is used between the two parts of the SMS (address and text). The serial interface driver generally does not allow a new command until the previous one has been terminated by "OK" final result code or by an error result code. In specific cases (see the abortability attribute), the command execution may be aborted if a character is sent to DCE before the command has ended. 1.1.4.1 Concatenation of AT commands TOBY-L4 It is not possible to concatenate the AT commands. 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: ATI;+CGATT?;+COPS? If a command in the command line causes an error, or is not recognized as a valid command, then the execution is terminated, the remaining commands in the command line are ignored and an error result code is returned. If all the commands are correctly executed, only the "OK" final result code of the last command is returned. TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 Not all the commands can be entered with other commands on the same command line: +CMGW, +CMGS, +USOWR, +USOST, +UDWNFILE must be used by themselves. 1.1.5 Notes TOBY-L2 / MPCI-L2 • Any character entered at the end of the command line (e.g. after the has been entered) will not be discarded but will be processed at the end of the current command execution, namely after the result code has been issued. This usage is deprecated; it is warmly recommended to always wait for the command to end before entering new commands. • The maximum length of the command line is 1024 characters. • String parameter type limitations - The following characters are not allowed in the parameter string: o From 0x00 to 0x1F (from NUL to US) o 0x22 (") UBX-13002752 - R56 1 AT command settings Page 23 of 875 u-blox Cellular Modules - AT Commands Manual o o o o 0x5C (\) 0xA2 (¢) 0xDC (Ü) From 0x80 to 0x9F (From ? to Y) TOBY-L4 / LARA-R2 / TOBY-R2 • The maximum length of the command line is 1024 characters. • String parameter type limitations - The following characters are not allowed in the parameter string: o 0x00 (NUL) o 0x0D (CR) o 0x15 (NAK) o 0x22 (") o 0x2C (,) SARA-U2 / LISA-U2 / LISA-U1 • The maximum length of the command line is 1024 characters. • String parameter type limitations - The following characters are not allowed in the parameter string: o 0x00 (NUL) o 0x0D (CR) o 0x15 (NAK) o 0x22 (") SARA-G3 / LEON-G1 • The maximum length of the command line is 544 characters. • String parameter type limitations - The following characters are not allowed in the parameter string: o 0x00 (NUL) o 0x0D (CR) o 0x15 (NAK) o 0x22 (") 1.1.6 Information text responses and result codes The AT command response comprises an optional information text string and a final result code. The V command configures the result code in numeric or verbose format: • Verbose format: Information text response(s): Final result code: • Numerical format: Information text response(s): Final result code: where • is the command line termination character • is the linefeed character TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 The command line termination character can be set with S3 AT command. The linefeed character can be set with S4 AT command. Table 1 lists the allowed result codes. Verbose OK CONNECT RING UBX-13002752 - R56 Numeric 0 1 2 Result code type Final Intermediate Unsolicited Description Command line successfully processed and the command is correctly executed Data connection established Incoming call signal from the network 1 AT command settings Page 24 of 875 u-blox Cellular Modules - AT Commands Manual Verbose NO CARRIER Numeric 3 Result code type Final ERROR NO DIALTONE BUSY NO ANSWER CONNECT 4 6 7 8 9 Final Final Final Final Intermediate Command aborted 3000 Final Description Connection terminated from the remote part or attempt to establish a connection failed General failure. The AT+CMEE command configures the error result format No dialtone detected Engaged signal detected (the called number is busy) No hang up detected after a fixed network timeout Same as CONNECT including also the data rate (data call). See the +CBST AT command for the allowed values of . In case of data/fax call, see Circuit 108/2, +++ behaviour for the different &D: summarizing table to return in command mode and disconnect the call. Command execution aborted issuing a character to the DCE Table 1: Allowed result codes LARA-R2 / TOBY-R2 In case of a VoLTE call redirected to CS plane the NO CARRIER final result code will be printed when the CSFB call is terminated from the remote part or the CSFB call establishment fails. In case of a VoLTE call experiencing entrance into out of coverage area, if service coverage cannot be regained within 10 s the call will be locally dropped and NO CARRIER will be printed; if the call is a VoLTE emergency call, NO CARRIER will not be printed and no local call release will be performed because the emergency call shall be maintained despite the speech interruption. TOBY-L2 / MPCI-L2 The AT commands can not be aborted, except if explicitly stated in the corresponding AT command description. LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 When a command is aborted the ABORTED final result code (numeric result code: 18) is displayed. SARA-G3 / LEON-G1 When a command is aborted the OK result code (numeric result code: 0) is displayed. Intermediate outputs as well as descriptive outputs of a command are formatted as information text responses; if more than one string has to be printed out (see for example the +CGDCONT command description), additional command line termination and linefeed characters may be inserted for sake of readability. If the command is not accepted by the MT an error result code will be displayed. The AT+CMEE command configures the error result code format. In this manual it is assumed that AT+CMEE=2, which results in error result code of the format: • "+CMS ERROR: " for SMS-related AT commands • "+CME ERROR: " for any other AT commands where represents the verbose error result code. If AT+CMEE=1 command is issued, represents the numeric error result code. The most typical error result codes are the following: • 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 ("+CMS ERROR: operation not supported" for SMS related commands) TOBY-L2 / MPCI-L2 The AT command parser accepts optional commas at the end of the command line, as well as String parameters not delimited by "". The list of all the possible error result codes is available in Appendix A.1 and Appendix A.2. For some commands only the "ERROR" final result code is displayed and is documented in the command description. UBX-13002752 - R56 1 AT command settings Page 25 of 875 u-blox Cellular Modules - AT Commands Manual The proprietary AT commands supporting the following features implement a different error management and provide different error result codes: • Firmware update Over AT command and over the air: see the Appendix A.4 and Appendix A.5 • DNS: see the Appendix A.6 and Appendix A.7 • TCP and UDP connections, FTP, HTTP and SMTP: see the Appendix A.7, Appendix A.8, Appendix A.8.1, Appendix A.8.2, Appendix A.8.3 • IP change notification: see the Appendix A.9 • Ping: see the Appendix A.10 The corresponding sections provide more details for retrieving the error result codes for these operations. 1.2 Profiles Several user settings may be stored in the cellular module's memory. Some are directly stored in the non volatile memory (NVM), while the others are organized into two personal profiles. The first profile is the default profile, whose data is by default loaded during the module's power on. Appendix B.2 lists the complete settings that can be directly stored in NVM and the corresponding commands. Appendix B.1 lists the complete settings stored in the profiles and the corresponding commands. TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 More details about loading, storing and updating profiles can be found in the command descriptions for: ATZ, AT&F, AT&W, AT&V, and AT&Y. TOBY-L4 The module does not store the AT commands setting in the profiles. 1.3 S-parameters The S-parameters, as specified in ITU-T recommendation 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 the module operates. Their syntax is: ATS ? ATS = The number following the "ATS" is the referenced S parameter. u-blox cellular modules support the following set of S-parameters ( ): AT command S0 S2 S3 S4 S5 S6 S7 S8 S10 S12 S Number 0 2 3 4 5 6 7 8 10 12 Description Automatic answer setting Escape character setting Command line termination character setting Response formatting character setting Command line editing character setting Pause before blind dialling setting Connection completion timeout setting Command dial modifier time setting Automatic disconnect delay setting Escape prompt delay setting If a other than those listed above is introduced, the S command returns an error result code (+CME ERROR: operation not supported). UBX-13002752 - R56 1 AT command settings Page 26 of 875 u-blox Cellular Modules - AT Commands Manual 2 General operation 2.1 Start up and initialization The characteristics of the boot of the cellular device vary from module to module and are described in the corresponding System Integration Manual; during this phase the module might be not responsive on the AT interface until all necessary SW modules have been installed (e.g. USB drivers); monitoring of greeting text (see +CSGT command) where supported can help in detecting the successful end of the boot phase. TOBY-L4 After a successful boot and successful AT command interface initialization an +AT: READY URC is sent to the AT command interface. AT commands can be issued only after +AT: READY URC is received. A complete start up to be able to operate on the cellular network can take place only with a SIM card. If the SIM card has enabled the PIN check, some commands answer with "+CME ERROR: SIM PIN required" and most cellular functionalities are not started. After entering the required PIN via the +CPIN command, or if booting with a SIM with disabled PIN check, SIM initialization is carried out and a lot of SIM files are read: it is possible that some commands (e.g. phonebook AT commands) are affected by this preliminary phase, resulting in a temporary error response. 2.1.1 Auto-registration If the +COPS parameter in the profiles or in NVM is left to its factory-programmed value 0 or set to 1, after SIM initialization, all u-blox modules will automatically perform PLMN selection and registration for circuit switched/non EPS services as well as packet switched/EPS services. Auto-registration (sometimes called also "auto-COPS", not to be confused with automatic =0) will be triggered also at SIM insertion, for modules supporting SIM hot insertion, or at SIM driver recovery, occurring when the communication with the SIM card is re-established by the module after an unrecoverable error, caused e.g. by mechanical vibrations or electrical interference. If no SIM is inserted in the module, the module will anyway select a cell of the cellular network and try to maintain synchronization with it in limited service. The radio access technology selected by the module at start up is defined by the parameter of the +URAT command; afterwards the module will reselect the RAT based on the requirements of the cellular standards it complies with and it is not possible to force it to remain in a given RAT unless it is locked on it via +URAT or on a specific cell via +UCELLLOCK (if supported). The user can retrieve the result of the auto-registration by polling the registration status commands (e.g. +CREG/ +CGREG/+CEREG/+CIREG) or enabling their unsolicited notifications. If auto-COPS is running, at boot time or at SIM insertion, network service commands issued by the user might have a longer response time than expected; this is particularly visible when the module is switched on in a jammed condition, or with a roaming SIM card that shall perform several registration attempts before gaining access to a VPLMN. In case of failures of the automatic registration whose cause cannot be retrieved via +CEER, it is suggested to disable auto-COPS starting the module in +COPS:2 or in airplane mode +CFUN:4 and trigger registration with AT commands. 2.1.2 Operational restrictions Operational restrictions may derive from several settings: PIN required, SIM lock, invalidation of the IMEI or SIM credentials by the Mobile Network Operator (MNO) during the registration procedure, FDN enabled. Restrictions to access the network are applied by the module also in one of these conditions: • In eCall only state (for all modules supporting the eCall feature) • In minimum functionality power modes (+CFUN: 0, +CFUN: 4, +CFUN: 19, +CFUN: 127), and even if the module is restarted in +CFUN: 4 or +CFUN: 19 modes, because that are persistent • MPCI-L2 only - when the W_DISABLE# line is asserted • TOBY-L2 / SARA-U2 / LISA-U2 - The Radio Policy Manager has reached the maximum number of registrations or PDP contexts activation per hour (only with AT&T SIM cards [61]) UBX-13002752 - R56 2 General operation Page 27 of 875 u-blox Cellular Modules - AT Commands Manual In case the module is in operational restricted state, it may reject all or specific service requests (e.g. operator selection, connection establishment). MPCI-L2 When the W_DISABLE# line is asserted, to SW reset the module, AT+CFUN=0,1 or AT+CFUN=4,1 may be used as they refer to minimum functionality power modes. TOBY-L2 / MPCI-L2 If the SIM is not inserted or the PIN is required and not inserted, the network scan (+COPS=?) is not allowed. 2.2 AT commands types 2.2.1 Action command An action command forces the DCE to print information text or execute a specific action for the command. A typical example of this command type is the provision of the factory-programmed settings of the DCE like manufacturer name, firmware version, etc. 2.2.2 Set command A set command configures the preferred settings for the specified command. The set command is the only way to set the preferred settings in the DCE. For some commands it is possible to store the current settings in the profile or in the non volatile memory and retrieve them in another connection. TOBY-L2 / MPCI-L2 The set command without parameters (e.g. AT+CGEQREQ=) is syntactically equivalent to the action command (e.g. AT+CGEQREQ). 2.2.3 Read command A read command provides the current setting of the command parameters. It is used to find out the current command configuration. 2.2.4 Test command A test command provides the list of the values allowed by each parameter of the command. 2.2.5 Unsolicited Result Code (URC) An unsolicited result code is a string message (provided by the DCE) that is not triggered as a information text 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. the +CMTI URC must be enabled by AT+CNMI AT command). 2.2.5.1 URCs presentation deferring Since the URCs are text responses issued by the DCE without being requested by the DTE, their occurrence is completely uncorrelated to an AT command execution. Therefore, a collision between a URC and an AT command response might occur and it may lead the DTE to misunderstand the URC as part of the AT command's text response or viceversa. The module avoids this collision by delaying the URCs presentation in case the AT command interface is busy. The AT command interface can be busy in the following cases: • During a data call (data mode) • During the execution of an AT command in command or online command mode The command execution starts when the command line is completed by the command line termination character and the AT interpreter in the module accepts it; the command execution ends when the final result code for the command is sent out. Inside this period, the module is not allowed to send the not buffered URCs. For most of the UBX-13002752 - R56 2 General operation Page 28 of 875 u-blox Cellular Modules - AT Commands Manual messages, the DCE needs to be configured whether or not to send a URC. After enabling, for most of the URCs, if the AT command interface is busy, the pending URCs are buffered and their sending to the DCE is deferred. The RING indication is always generated as an unsolicited result code. The NO CARRIER indication is generated as an unsolicited result code when it has not to be considered the final response for the executing command (e.g.: ATH); in case it is handled as an unsolicited result code, it follows the rule of the other URCs. Generally, the buffered URCs are sent to the terminal as soon as the terminal exits the data mode or the command execution is terminated. An exception to this behavior is implemented for the following URCs classes: Class Reception of a new SMS related URCs +CIEV URCs +CGEV URCs AT command to configure the class AT+CNMI AT command AT+CMER AT command AT+CGEREP AT command For the above classes, it is possible to select the presentation strategy in case of AT interface busy according the 3GPP TS 27.007 [2]; the buffering or discarding are the two possible choices (URCs are lost in the latter case). This is done by means of the corresponding AT command (see the AT command listed in the table above). If the URCs are enabled or for the three described classes of URCs, the buffered URCs are sent out only when the AT interface is in idle again; this occurs as soon as: • The data mode is released (the data call is disconnected) • The final result code for an AT command is issued LARA-R204 The presentation of +UCMT3GPP2 URCs is not deferred and is always routed to the AT interface. LEON-G1 The modules does not support the full URCs buffering/deferring capability: only the presentation deferring of the three above specified URCs classes is supported. The DTE should wait some time (the recommended value is at least 20 ms) after the reception of an AT command final result code or URC before issuing a new AT command to give the DCE the opportunity to transmit the buffered URCs. Otherwise the collision of the URCs with the subsequent AT command is still possible. In case multiple AT interfaces are available, it should be advisable to use one of the different AT interfaces to manage all the user enabled URCs, while use the others ones to send AT commands and receive their responses. Anyway URCs related to external causes (e.g. RING) are issued on all interfaces. 2.2.6 Intermediate Result Code (IRC) An intermediate result code is a string message (provided by the DCE) which provides to the DTE some information about the processing status of the pending AT command. UBX-13002752 - R56 2 General operation Page 29 of 875 u-blox Cellular Modules - AT Commands Manual 3 IPC - Inter Processor Communication 3.1 Multiplexing mode +CMUX +CMUX Modules Attributes TOBY-L200-02S TOBY-L200-03S TOBY-L201 TOBY-L210-02S TOBY-L210-03S TOBY-L210-60S TOBY-L210-62S TOBY-L220 TOBY-L280 LARA-R2 TOBY-R2 SARA-U2 LISA-U2 LISA-U1 SARA-G3 LEON-G1 Syntax PIN required Settings saved Can be aborted Response time Error reference partial No No No +CME Error 3.1.1 Description Enables the multiplexing protocol control channel as defined in 3GPP TS 27.010 [46]. The command sets the parameters for the control channel. The result code is returned using the old interface speed. The parameters become active only after sending the OK result code. The usage of +CMUX command during the multiplexing is not allowed. The multiplexer configuration is as follows: Channel Control channel TOBY-L2 TOBY-R2 LARA-R202 / LARA-R203 / LARA-R220 / LARA-R280 LARA-R204 / LARA-R211 SARA-U2 LISA-U2 LISA-U200-00S LISA-U1 SARA-G340 SARA-G350 SARA-G300 SARA-G310 LEON-G1 Channel 0 Channel 0 Channel 0 AT commands / data GNSS tunneling connection Channel 1 - 5 1 Channel 1 - 5 Channel 6 Channel 1 - 5 Channel 6 Channel 0 Channel 0 Channel 0 Channel 0 Channel 0 Channel 0 Channel 0 Channel 0 Channel 1 - 5 Channel 1 - 5 Channel 1 - 5 Channel 1 - 5 Channel 1 - 5 Channel 1 - 5 Channel 1 - 2 Channel 1 - 5 Channel 6 Channel 6 Channel 6 Channel 6 Channel 6 SAP (SIM Access Profile) Channel 7 Channel 7 Channel 6 Table 2: Multiplexer configuration 3.1.2 Syntax Type Set Read Test 1 Syntax AT+CMUX= [, [, [, [, [, [, [, [, ]]]]]]] AT+CMUX? AT+CMUX=? Response OK Example AT+CMUX=0,0,,1500,50,3,90 OK +CMUX: ,[ ], , , , , , [, ] OK +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,0,1500,253,3,254,0,0 OK +CMUX: (0),(0),,(1-1509),(1-255),(0-5), (2-255),, OK Not supported by TOBY-R200-02B-00 and TOBY-R202-02B-00 UBX-13002752 - R56 3 IPC - Inter Processor Communication Page 30 of 875 u-blox Cellular Modules - AT Commands Manual Type Syntax Response OK Example 3.1.3 Defined values Parameter Type Number Description Multiplexer transparency mechanism: • 0: basic option The way in which the multiplexer control channel is set up: • 0 (default value): UIH frames used only • 1: UI frames used only See Notes for the parameter applicability. Transmission rate. The allowed range is 0-7. Number Number Number Number Number Number Number This parameter is ignored and the value 254 is always set. Wake up response timer. The allowed range is 0-255. Number This parameter is ignored and the value 0 is always displayed in case of the read command. Window size, for advanced operation with Error Recovery options. The allowed range is 0-255. This parameter is ignored and the value 0 is always displayed in case of read command. Maximum frame size: • Allowed range is 1-1509. • The default value is 31. Acknowledgement timer in units of ten milliseconds. The allowed range is 1-255. This parameter is ignored and the value 253 is always set. Maximum number of re-transmissions: • Allowed range is 0-5. • The default value is 3. Response timer for the multiplexer control channel in units of ten milliseconds. The allowed range is 2-255. This parameter is ignored and the value 0 is always displayed in case of the read command. 3.1.4 Notes • If the multiplexer protocol is not started (the +CMUX set command has not been issued or returned an error result code) and AT+CMEE is set to 2, the +CMUX read command returns the following error result code: +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 command). • must be lower than or equal to . TOBY-L2 • can only assume the value 0. LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 • can only assume the value 0. • , , values are ignored, since the related timers are not implemented. SARA-U201-04A / SARA-U201-04B / SARA-U201-04X • On the AUX UART interface, the multiplexer protocol is not supported. SARA-G3 • can assume the value 0 and 1. • The range of is 0-255 (0 means that the timer is ignored). SARA-G300 / SARA-G310 / SARA-G340-00S / SARA-G340-01S / SARA-G350-00S / SARA-G350-00X / SARA-G350-01B / SARA-G350-01S • can only assume the value 0. UBX-13002752 - R56 3 IPC - Inter Processor Communication Page 31 of 875 u-blox Cellular Modules - AT Commands Manual SARA-G340-02S / SARA-G340-02X / SARA-G350-02A / SARA-G350-02S / SARA-G350-02X • On the AUX UART interface, the multiplexer protocol is not supported. LEON-G1 • can only assume the value 0. • The requested value is correctly set, but the +CMUX read command returns a value higher ( +6 or +7), since it returns the maximum multiplexer protocol frame size (including the 6 or 7 bytes of the frame header). This does not affect the multiplexer protocol behavior, which uses the requested value. • The range of is 0-255 (0 means that the timer is ignored). LEON-G100-06S • , and can only assume the value 0. UBX-13002752 - R56 3 IPC - Inter Processor Communication Page 32 of 875 u-blox Cellular Modules - AT Commands Manual 4 General 4.1 Manufacturer identification +CGMI +CGMI Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.1.1 Description Text string identifying the manufacturer. 4.1.2 Syntax Type Action Syntax AT+CGMI Response Example u-blox AT+CGMI=? OK OK OK Test 4.1.3 Defined values Parameter Type String Description Manufacturer name 4.2 Manufacturer identification +GMI +GMI Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.2.1 Description Text string identifying the manufacturer. 4.2.2 Syntax Type Action Syntax AT+GMI Response Example u-blox OK OK 4.2.3 Defined values Parameter Type String Description Manufacturer name 4.3 Model identification +CGMM +CGMM Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.3.1 Description Text string identifying the model identification. UBX-13002752 - R56 4 General Page 33 of 875 u-blox Cellular Modules - AT Commands Manual 4.3.2 Syntax Type Action Syntax AT+CGMM Response Example LISA-U200 AT+CGMM=? OK OK OK Test 4.3.3 Defined values Parameter Type String Description Name of model 4.4 Model identification +GMM +GMM Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.4.1 Description Text string identifying the model identification. 4.4.2 Syntax Type Action Syntax AT+GMM Response Example LISA-U120 OK OK 4.4.3 Defined values Parameter Type String Description Name of model 4.5 Firmware version identification +CGMR +CGMR Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.5.1 Description Returns the firmware version of the module. 4.5.2 Syntax Type Action Syntax AT+CGMR Response Example 11.40 AT+CGMR=? OK OK OK Test 4.5.3 Defined values Parameter UBX-13002752 - R56 Type String Description Firmware version 4 General Page 34 of 875 u-blox Cellular Modules - AT Commands Manual 4.6 Firmware version identification +GMR +GMR Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.6.1 Description Returns the firmware version of the module. 4.6.2 Syntax Type Action Syntax AT+GMR Response Example 11.40 OK OK 4.6.3 Defined values Parameter Type String Description Firmware version 4.7 IMEI identification +CGSN +CGSN Modules Attributes All products Syntax partial PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.7.1 Description Returns the product serial number, the International Mobile Equipment Identity (IMEI) of the MT. 4.7.2 Syntax Type Action Syntax AT+CGSN[= ] Response Example 004999010640000 Test AT+CGSN=? OK +CGSN: (list of supported s) OK +CGSN: (0-3,255) OK OK 4.7.3 Defined values Parameter Type String Number Description Serial number, by default the IMEI It indicates the requested serial number type. Depending on value, the parameter in the information text response provides different information: • 0: International Mobile station Equipment Identity (IMEI) • 1: International Mobile station Equipment Identity (IMEI) • 2: International Mobile station Equipment Identity and Software Version number (IMEISV) • 3: Software Version Number (SVN) • 255: IMEI (not including the spare digit), the check digit and the SVN 4.7.4 Notes TOBY-L4 / TOBY-L2 / MPCI-L2 / SARA-U260-00S / SARA-U270-00S / SARA-U270-00X / SARA-U280-00S / LISA-U200-00S / LISA-U200-01S / LISA-U200-02S / LISA-U200-52S / LISA-U200-62S / LISA-U230 / LISA-U260 / LISA-U270 / LISA-U1 / SARA-G3 / LEON-G1 • The parameter is not supported. • The response to the test command does not provide the information text response. UBX-13002752 - R56 4 General Page 35 of 875 u-blox Cellular Modules - AT Commands Manual 4.8 IMEI identification +GSN +GSN Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.8.1 Description The commands handling is the same of +CGSN. 4.8.2 Syntax Type Action Syntax AT+GSN[= ] Response Example 004999010640000 AT+GSN=? OK OK OK Test 4.8.3 Defined values See +CGSN AT command. 4.9 Identification information I I Modules Attributes All products Syntax partial PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.9.1 Description Returns some module information as the module type number and some details about the firmware version. The information text response of ATI9 contains the modem version and the application version of the module where applicable; it returns "Undefined" where not applicable. 4.9.2 Syntax Type Action Syntax Ordering code request ATI[0] Response Example ATI0 OK SARA-G350-00S-00 Modem and application version request ATI9 , OK OK ATI9 29.90,A01.00 OK 4.9.3 Defined values Parameter UBX-13002752 - R56 Type String String String Description Product type number Module modem version Module application version. Where not applicable the module provides "Undefined" 4 General Page 36 of 875 u-blox Cellular Modules - AT Commands Manual 4.10 TE character set configuration +CSCS +CSCS Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.10.1 Description Selects the TE character set. The selected character set is actually used for encoding/decoding of only the AT commands' string type parameters whose description explicitly references the +CSCS setting itself. 4.10.2 Syntax Type Set Syntax AT+CSCS= Response OK Example AT+CSCS="IRA" Read AT+CSCS? +CSCS: OK +CSCS: "IRA" Test AT+CSCS=? OK +CSCS: (list of supported 's) OK OK +CSCS: ("IRA","GSM","PCCP437", "8859-1","UCS2","HEX") OK 4.10.3 Defined values Parameter Type String Description • • • • • • "IRA" (factory-programmed value): 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.10.4 Notes TOBY-L4 • ="PCCP437" and "8859-1" are not supported. TOBY-L2 / MPCI-L2 • ="PCCP437" is not supported. 4.11 International mobile subscriber identification +CIMI +CIMI Modules Attributes All products Syntax full PIN required Yes Settings saved No Can be aborted No Response time - Error reference +CME Error 4.11.1 Description Request the IMSI (International Mobile Subscriber Identity). UBX-13002752 - R56 4 General Page 37 of 875 u-blox Cellular Modules - AT Commands Manual 4.11.2 Syntax Type Action Syntax AT+CIMI Response Example 222107701772423 AT+CIMI=? OK OK OK Test 4.11.3 Defined values Parameter Type Number Description International Mobile Subscriber Identity 4.12 Card identification +CCID +CCID Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.12.1 Description Returns the ICCID (Integrated Circuit Card ID) of the SIM-card. ICCID is a serial number identifying the SIM. 4.12.2 Syntax Type Action Syntax AT+CCID Response +CCID: Example +CCID: 8939107800023416395 Read AT+CCID? OK +CCID: OK +CCID: 8939107900010087330 AT+CCID=? OK OK OK Test 4.12.3 Defined values Parameter Type String Description ICCID of the SIM card 4.12.4 Notes • The command needs of the SIM to correctly work. 4.13 Request complete capabilities list +GCAP +GCAP Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.13.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. UBX-13002752 - R56 4 General Page 38 of 875 u-blox Cellular Modules - AT Commands Manual 4.13.2 Syntax Type Action Syntax AT+GCAP Test Response +GCAP: [, [...]] Example +GCAP: +FCLASS, +CGSM OK OK OK AT+GCAP=? 4.13.3 Defined values Parameter Type String Description 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.14 Display FGI settings +UFGI +UFGI Modules Attributes TOBY-L200-03S TOBY-L210-03S TOBY-L210-62S TOBY-L280-03S MPCI-L200-03S MPCI-L210-03S MPCI-L280-03S LARA-R2 TOBY-R2 Syntax PIN required Settings saved Can be aborted Response time Error reference full No No No +CME Error 4.14.1 Description Displays the contents of the FGI bits stored on the module that are reported during the LTE registration to the network as part of the UE-EUTRA-Capability information element. The description of each bit can be found in 3GPP TS 36.331 [109], Annex B. 4.14.2 Syntax Type Read Syntax AT+UFGI? Response +UFGI: , Example +UFGI: 2131754144,2155872256 OK OK 4.14.3 Defined values Parameter Type Number Number Description 32 bits number that describes bits 1-32 of featureGroupIndicators. The leftmost bit represents index 1 in the field featureGroupIndicators 32 bits number that describes bits 33-64 of featureGroupIndRel9Add. The leftmost bit represents index 33 in the field featureGroupIndRel9Add. 4.15 Repeat last command A/ A/ Modules Attributes TOBY-L2 MPCI-L2 LARA-R2 TOBY-R2 SARA-U2 LISA-U2 LISA-U1 SARA-G3 LEON-G1 Syntax PIN required full No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.15.1 Description Repeats the previously executed command again. Only the A/ command cannot be repeated. If autobauding is active, the MT is not able to recognize the command and the command A/ cannot be used. UBX-13002752 - R56 4 General Page 39 of 875 u-blox Cellular Modules - AT Commands Manual 4.15.2 Syntax Type Action Syntax A/ Response Example 4.16 List all available AT commands +CLAC +CLAC Modules TOBY-L2 MPCI-L2 LARA-R2 TOBY-R2 SARA-U2 LISA-U2 LISA-U1 SARA-G3 LEON-G1 Syntax PIN required full No Attributes Settings saved No Can be aborted No Response time - Error reference +CME Error 4.16.1 Description Causes the MT to return one or more lines of AT commands that are available for the DTE user. Each line contains one AT command. 4.16.2 Syntax Type Action Syntax AT+CLAC Response Example [ [...]] Test OK OK AT+CLAC=? 4.16.3 Defined values Parameter Type String Description AT command name 4.17 Help displaying all commands &H &H Modules Attributes TOBY-L2 MPCI-L2 LARA-R2 TOBY-R2 SARA-U2 LISA-U2 LISA-U1 SARA-G3 LEON-G1 Syntax PIN required partial No Settings saved No Can be aborted No Response time - Error reference +CME Error 4.17.1 Description Lists all the supported commands. 4.17.2 Syntax Type Action Syntax AT&H Response Example : [ : ATH : Hook Control [...]] ATV : Enable/Disable verbose response OK ... AT+UTEST : End User Test ATS : Query or Set an S-register UBX-13002752 - R56 4 General Page 40 of 875 u-blox Cellular Modules - AT Commands Manual Type Syntax Response Example ATD : Dial OK 4.17.3 Defined values Parameter Type String String Description AT command name AT command title 4.17.4 Notes TOBY-L2 / MPCI-L2 / SARA-G3 / LEON-G1 • The response is: , , ..., [, , ..., [...]] OK Example: &W, &Y, A, B, E, H, I, L, M, O, P, Q, S0, S10, S12, S2, S3, S4, S5, S6, S7, S8, T, V, X, Z, \Q, ... +USORD, +USORF, +USOSO, +USOST, +USOWR, +USPM, +USTN, +USTOPFILE, +USTS, +UTEST, +UTGN, +UUBF OK UBX-13002752 - R56 4 General Page 41 of 875 u-blox Cellular Modules - AT Commands Manual 5 Mobile equipment control and status 5.1 Phone activity status +CPAS +CPAS Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 5.1.1 Description Returns the activity status of the MT. 5.1.2 Syntax Type Action Syntax AT+CPAS Response +CPAS: Example +CPAS: 0 Test AT+CPAS=? OK +CPAS: (list of supported s) OK +CPAS: (0-5) OK OK 5.1.3 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.1.4 Notes TOBY-L2 / MPCI-L2 • During a MO call the information text response of the action command returns 4 (call in progress). • The reported status of the MT is tied to network status registration. 5.2 Module switch off +CPWROFF +CPWROFF Modules Attributes All products Syntax full PIN required No Settings saved No Can be aborted No Response time < 40 s Error reference +CME Error 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 the following command line being ignored. See the corresponding System Integration Manual for the timing and the electrical details of the module power-off sequence via the +CPWROFF command. MPCI-L2 The command does not switch off the PCIe module but it causes a reset (reboot). The current parameter settings are stored in the NVM performing a network detach, with a subsequent module reset (reboot). UBX-13002752 - R56 5 Mobile equipment control and status Page 42 of 875 u-blox Cellular Modules - AT Commands Manual 5.2.2 Syntax Type Action Test Syntax AT+CPWROFF AT+CPWROFF=? Response OK OK Example 5.3 Set module functionality +CFUN +CFUN Modules Attributes All products Syntax partial PIN required No Settings saved No Can be aborted No Response time Up to 3 min Error reference +CME Error 5.3.1 Description Selects the level of functionality in the MT. If the syntax +CFUN=15 or +CFUN=16 (resets) or +CFUN=127 is used, the rest of the command line, placed after that will be ignored. TOBY-L4 / TOBY-L2 / MPCI-L2 / LARA-R2 / TOBY-R2 / SARA-U2 / LISA-U2 / LISA-U1 / SARA-G3 / LEON-G1 A SW reset via AT+CFUN=1,1 triggers signalling attempts whose number is internally counted by the SW and limited based on mobile network operators' thresholds. The AT&T RPM feature (see also the +URPM AT command) limits the number of SW resets per hour, and might cause the AT command to return an error result code. 5.3.2 Syntax Type Set Syntax AT+CFUN= [, ] Response OK Example AT+CFUN=1 Read AT+CFUN? +CFUN: , OK +CFUN: 1,0 Test AT+CFUN=? OK OK +CFUN: (list of supported 's),(list of +CFUN: (0,1,4,6,7,8,15,16),(0-1) supported 's) OK OK 5.3.3 Defined values Parameter UBX-13002752 - R56 Type Number Description Selected functionality: • 0: sets the MT to minimum functionality (disable both transmit and receive RF circuits by deactivating both CS and PS services) • 1 (factory-programmed value): sets the MT to full functionality, e.g. from airplane mode or minimum functionality • 4: disables both transmit and receive RF circuits by deactivating both CS and PS services and sets the MT into airplane mode. Airplane mode is persistent between power cycles triggered by +CFUN=16 or +CPWROFF (where supported) • 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 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 SIMAPPL 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 • 19: sets the MT to minimum functionality by deactivating CS and PS services and the SIM card • 127: sets the MT in a deep low power state "HALT" (with detach from the network and saving of the NVM parameters); the only way to wake up the module is a power cycle or a module reset 5 Mobile equipment control and status Page 43 of 875 u-blox Cellular Modules - AT Commands Manual Parameter Type Number Description Reset mode. This parameter can be used only when is 1, 4 or 19. • 0 (default value): do not reset the MT before setting it to the selected • 1: performs a MT silent reset (with detach from network and saving of NVM parameters) with reset of the SIM card before setting it to the selected Number • • • • 0: MT is switched on with minimum functionality 1: MT is switched on 4: MT is in "airplane mode" 19: MT is in minimum functionality with SIM deactivated Number • 6: the SIM-toolkit interface in dedicated mode and fetching of proactive commands by SIMAPPL 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 • • 5.3.4 Notes TOBY-L4 • =9, 127 are not supported. • AT+CFUN=19 does not support the parameter. • =9 is not supported. • The MT silent reset without the SIM card reset ( =15) restarts the protocol stack tasks (without triggering a detach if the module is attached) while retaining the SIM status, i.e. the PIN shall not be inserted again. This mimics a silent reset and sets the module in a known initial state. Drivers and applications are not restarted, therefore if e.g audio was active, it might be negatively affected by the AT+CFUN=15 command. Additionally, most volatile parameters (e.g. URC) are lost and need to be reconfigured. TOBY-L2 / MPCI-L2 • After enabling the STK interface in raw mode it is not possible to switch to dedicated mode (and vice versa) without performing a reset. • =7 and 8 are not supported • =15 restarts the protocol stack tasks (without triggering a detach if the module is attached) while retaining the SIM status, i.e. the PIN shall not be inserted again. This mimics a silent reset and sets the module in a known initial state. Drivers and applications are not restarted, therefore if e.g. a MUX port was opened, communication with it is maintained, unless the AT+CFUN=15 interrupts a pending AT command requiring interaction with the protocol stack, in which case communication on MUX channels can be negatively affected. Additionally, most non-volatile parameters are not saved, as this kind of reset does not imply a complete module restart • parameter is ignored when entered after a not supporting reset. • In case the application needs to interact with the SIM, the AT+CFUN=1 command must be issued after the AT+CFUN=19 command. TOBY-L210-03S / TOBY-L210-03S / TOBY-L280-03S / MPCI-L200-03S / MPCI-L210-03S / MPCI-L280-03S • The AT+CFUN=15 command issued in SAP client mode (+USAPMODE: 1) will disable the remote SIM connection and restart the protocol stack on the local SIM card. TOBY-L200-00S / TOBY-L201 / TOBY-L210-00S / TOBY-L210-60S / MPCI-L200-00S / MPCI-L201 / MPCI-L210-00S / MPCI-L210-60S • =15 behaves as =16: the MT is reset as well as the SIM card. • =4 is not persistent between power cycles. LARA-R2 / TOBY-R2 • A change of module functionality via =0, 1 or 4 also triggers the reset of the UICC driver, hence can be used to refresh the SIM card status after a SIM insertion or removal. • =19 and 127 are not supported. UBX-13002752 - R56 5 Mobile equipment control and status Page 44 of 875 u-blox Cellular Modules - AT Commands Manual SARA-U2 / LISA-U2 / LISA-U1 • =19 and 127 are not supported. • =19 is not supported. • The AT+CFUN=15 command shall not be issued in SAP client mode (+USAPMODE: 1). SARA-G3 / LEON-G1 • =4 is not supported ( =0 can be used instead). • =9, 19 and 127 are not supported. • =15 behaves as =16: the MT is reset as well as the SIM card. • =1 can be used only if =1. • =19 is not supported. • =9 is not supported. 5.4 Indicator control +CIND +CIND Modules Attributes All products Syntax partial PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 5.4.1 Description Provides indication states related to network status, battery information and so on. The set 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 commands follows the indexes reported in the parameter, so that the first corresponds to "battchg" and so on. For more details see the 3GPP TS 27.007 [2]. 5.4.2 Syntax Type Set Syntax AT+CIND=[ [, [,...]]] Response OK Example AT+CIND= Read AT+CIND? +CIND: [, [,...]] OK +CIND: 5,0,0,0,0,0,0,0,0,0,0,0 Test AT+CIND=? OK +CIND: (list of s) OK OK +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",(0-2)), ("callsetup",(0-3)),("callheld",(0,1)), ("simind",(0-2)) OK 5.4.3 Defined values Parameter Type Number String Description Range of corresponding used to identify the service when an unsolicited indication is provided Reserved by the norm and their ranges; it may have the values: • • • UBX-13002752 - R56 "battchg": battery charge level (0-5) "signal": signal quality. See mapping in the note below "service": network service availability o 0: not registered to any network o 1: registered to the network o 65535: indication not available 5 Mobile equipment control and status Page 45 of 875 u-blox Cellular Modules - AT Commands Manual Parameter Type Description • "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 or not registered o 1: roaming o 65535: indication not available • "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": PS indication status: o 0: no PS available in the network o 1: PS available in the network but not registered o 2: registered to PS o 65535: indication not available • "callsetup": call set-up: o 0: no call set-up o 1: incoming call not accepted or rejected o 2: outgoing call in dialling 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 5.4.4 Notes • If the battery charging is not supported, "battchg" always returns 5 (full charge). • The values cannot be changed with +CIND set. • The following mapping of "signal" value to the power level exists: "signal" value 0 1 2 3 4 5 Power level (< -105 dBm or unknown) (< -93 dBm) (< -81 dBm) (< -69 dBm) (< -57 dBm) (>= -57 dBm) TOBY-L4 • ="battchg", "signal", "service", "sounder", "message", "smsfull", "gprs", "callsetup", "callheld" are not supported. TOBY-L2 / MPCI-L2 • The set command is actually a dummy command always returning the "OK" final result code. TOBY-L200-00S / TOBY-L201-01S / TOBY-L210-00S / TOBY-L210-60S / MPCI-L200-00S / MPCI-L201-01S / MPCI-L210-00S / MPCI-L210-60S • ="simind" is not supported. UBX-13002752 - R56 5 Mobile equipment control and status Page 46 of 875 u-blox Cellular Modules - AT Commands Manual • The "callsetup", "callheld", "sounder" indications are not provided. TOBY-L201-02S / MPCI-L201-02S • The "callsetup", "callheld", "sounder" indications are not provided. SARA-U2 / LISA-U2 / LISA-U1 • To enable the "SIM detection" feature the SIM_DET pin must be properly configured (if not already set); for more details see the GPIO introduction and +UGPIOC command description. SARA-G340 / SARA-G350 • If the battery charging is not supported, "battchg" always returns 0 (full charge). • ="sounder" indication is always set to 0, hence the +CIEV: 4,x URC is never displayed. SARA-G300 / SARA-G310 / LEON-G1 • ="simind" is not supported. • ="sounder" indication is always set to 0, hence the +CIEV: 4,x URC is never displayed. 5.5 Configuration of indicator control +UCIND +UCIND Modules Attributes TOBY-L2 MPCI-L2 LARA-R2 TOBY-R2 SARA-U2 LISA-U2 LISA-U1 Syntax PIN required full No Settings saved No Can be aborted No Response time - Error reference +CME Error 5.5.1 Description Allows the configuration of unsolicited results for indications with +CIEV. 5.5.2 Syntax Type Set Syntax AT+UCIND=[ ] Response OK Example AT+UCIND=7 Read AT+UCIND? +UCIND: OK +UCIND: 7 Test AT+UCIND=? OK OK OK 5.5.3 Defined values Parameter Type Number Description The unsigned integer (0 to 4095) is a bitmask representing the list of the indications active for +CIEV URC reporting. The bit position corresponds to the indicator order number (see the parameter of +CMER). The least significant bit is used for the first indicator. The bits corresponding to unused indicator order numbers (greater than 13) must be set to 0 (setting a greater than 4095 causes an error). The default value is 4095 (all the indications are enabled). UBX-13002752 - R56 5 Mobile equipment control and status Page 47 of 875 u-blox Cellular Modules - AT Commands Manual 5.6 Mobile termination event reporting +CMER +CMER Modules Attributes All products Syntax partial PIN required No Settings saved No Can be aborted No Response time - Error reference +CME Error 5.6.1 Description Configures sending of URCs from MT to DTE for indications. The 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 +CMER settings. The command +UCIND allows enabling or disabling indicators. 5.6.2 Syntax Type Set Syntax AT+CMER=[ [, [, [, [, ]]]]] Read AT+CMER? Test AT+CMER=? Response OK Example AT+CMER=1,0,0,2,1 OK +CMER: , , , , +CMER: 1,0,0,0,1 OK OK +CMER: (list of supported 's),(list +CMER: (0-3),(0),(0),(0-2),(0,1) of supported 's),(list of supported OK 's),(list of supported 's),(list of supported 's) OK +CIEV: , URC 5.6.3 Defined values Parameter Type Number Description • • • 0 (default value): buffer URCs in the MT 1: discard URCs when the V.24 interface is reserved for data; otherwise directly display them on the DTE 2: buffer URCs in MT when the V.24 interface is reserved and flush them after reservation; otherwise directly display them on the DTE 3: same as 1 Number • 0: no keypad event reporting Number • 0: no display event reporting Number • • 0: no indicator event reporting 1: indicator event reporting using the +CIEV URC. Only the indicator events which are not caused by +CIND shall be indicated by the MT to the DTE. 2: indicator event reporting using the +CIEV URC. All the indicator events shall be directed from MT to DTE. • • Number