Datasheet

ManualsBrandsSeeed Studio ManualsDevelopment Boards & KitsWio LTE Cat M1/NB1

SARA-R4/N4 series

Size-optimized LTE Cat M1 / NB1 / GPRS modules

AT Commands Manual

Abstract

Description of standard and proprietary AT commands used with u-blox

cellular modules.

www.u-blox.com

UBX-17003787 - R09

Summary of content (307 pages)

PAGE 1
SARA-R4/N4 series Size-optimized LTE Cat M1 / NB1 / GPRS modules AT Commands Manual Abstract Description of standard and proprietary AT commands used with u-blox cellular modules. www.u-blox.
PAGE 2
SARA-R4/N4 series - AT Commands Manual Document Information Title SARA-R4/N4 series Subtitle Size-optimized LTE Cat M1 / NB1 / GPRS modules Document type AT Commands Manual Document number UBX-17003787 Revision and date R09 15-Jun-2018 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.
PAGE 3
SARA-R4/N4 series - AT Commands Manual Preface Applicable products This document applies to the following products: Name SARA-R404M SARA-R410M SARA-R412M SARA-N410 Type number SARA-R404M-00B-00 SARA-R410M-01B-00 Modem version K0.0.00.00.07.06 L0.0.00.00.02.03 Application version N.A. N.A. PCN reference UBX-17047084 UBX-17051617 SARA-R410M-02B-00 L0.0.00.00.05.06 A02.00 UBX-18010263 SARA-R410M-52B-00 SARA-R412M-02B-00 SARA-N410-02B-00 L0.0.00.00.06.04 M0.04.01 L0.0.00.00.07.04 A02.05 A01.04 A02.
PAGE 4
SARA-R4/N4 series - AT Commands Manual 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.
PAGE 5
SARA-R4/N4 series - AT Commands Manual 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.
PAGE 6
SARA-R4/N4 series - AT Commands Manual Contents 1 AT command settings......................................................................................................11 1.1 1.2 1.3 2 General operation.............................................................................................................16 2.1 2.2 3 Multiplexing mode +CMUX............................................................................................................................ 19 General....................
PAGE 7
SARA-R4/N4 series - AT Commands Manual 7.11 Read RSRQ values +VZWRSRQ................................................................................................................. 56 7.12 eDRX setting +CEDRXS............................................................................................................................... 57 7.13 eDRX read dynamic parameters +CEDRXRDP....................................................................................... 58 7.14 Set MNO profile +UMNOPROF.....
PAGE 8
SARA-R4/N4 series - AT Commands Manual 10.25 10.26 11 SIM management.......................................................................................................... 112 11.1 11.2 11.3 12 Firmware installation +UFWINSTALL..................................................................................................... 144 Firmware update Over AT (FOAT) +UFWUPD...................................................................................... 145 Antenna detection +UANTR..................
PAGE 9
SARA-R4/N4 series - AT Commands Manual 16.8 17 DNS................................................................................................................................... 178 17.1 18 Introduction...................................................................................................................................................180 IPv4/IPv6 addressing..................................................................................................................................
PAGE 10
SARA-R4/N4 series - AT Commands Manual 23 22.13 Get recommended minimum GNSS data +UGRMC..........................................................................235 22.14 Get course over ground and ground speed +UGVTG........................................................................236 22.15 Get satellite information +UGGSA........................................................................................................237 22.16 Ask for localization information +ULOC..........................
PAGE 11
SARA-R4/N4 series - AT Commands Manual 1 AT command settings u-blox cellular modules provide at least one physical serial interface that is compliant to V.24 [26]. When the module is powered on, it enters the command mode. For more details on command mode, see Chapter 1.1. For module and hyper terminal connection and settings see the corresponding evaluation kit user guide. 1.
PAGE 12
SARA-R4/N4 series - AT Commands Manual 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).
PAGE 13
SARA-R4/N4 series - AT Commands Manual 1.1.4.1 Concatenation of 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.
PAGE 14
SARA-R4/N4 series - AT Commands Manual Verbose Numeric Command aborted 3000 Result code type Description 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. Final Command execution aborted issuing a character to the DCE Table 1: Allowed result codes SARA-R4 / SARA-N4 The AT commands can not be aborted, except if explicitly stated in the corresponding AT command description.
PAGE 15
SARA-R4/N4 series - AT Commands Manual 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
PAGE 16
SARA-R4/N4 series - 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 the greeting text, where supported, can help in detecting the successful end of the boot phase.
PAGE 17
SARA-R4/N4 series - AT Commands Manual 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. 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.
PAGE 18
SARA-R4/N4 series - AT Commands Manual 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.
PAGE 19
SARA-R4/N4 series - AT Commands Manual 3 IPC - Inter Processor Communication 3.1 Multiplexing mode +CMUX +CMUX Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Attributes Error reference +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.
PAGE 20
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number Number Number Number Description 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.
PAGE 21
SARA-R4/N4 series - AT Commands Manual 4 General 4.1 Manufacturer identification +CGMI +CGMI Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Attributes 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.
PAGE 22
SARA-R4/N4 series - AT Commands Manual 4.3 Model identification +CGMM +CGMM Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 4.3.1 Description Text string identifying the model identification. 4.3.2 Syntax Type Action Syntax AT+CGMM Response Example LISA-U200 AT+CGMM=? OK OK OK Test 4.3.
PAGE 23
SARA-R4/N4 series - AT Commands Manual 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 Type String Description Firmware version 4.6 Firmware version identification +GMR +GMR Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 4.6.
PAGE 24
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Description It indicates the requested serial number type.
PAGE 25
SARA-R4/N4 series - AT Commands Manual Type Syntax Modem and application version request ATI9 Response , OK Example ATI9 29.90,A01.00 OK 4.9.3 Defined values Parameter Type String String String Description Product type number Module modem version Module application version. Where not applicable the module provides "Undefined" 4.
PAGE 26
SARA-R4/N4 series - AT Commands Manual 4.11 International mobile subscriber identification +CIMI +CIMI Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No - Error reference +CME Error 4.11.1 Description Request the IMSI (International Mobile Subscriber Identity). 4.11.2 Syntax Type Action Syntax AT+CIMI Response Example 222107701772423 AT+CIMI=? OK OK OK Test 4.11.
PAGE 27
SARA-R4/N4 series - AT Commands Manual 4.13 Repeat last command A/ A/ Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 4.13.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. 4.13.
PAGE 28
SARA-R4/N4 series - AT Commands Manual 5 Mobile equipment control and status 5.1 Module switch off +CPWROFF +CPWROFF Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No < 40 s Error reference +CME Error 5.1.1 Description Switches off the MT. During shut-down current settings are saved in module's non-volatile memory.
PAGE 29
SARA-R4/N4 series - AT Commands Manual 5.2.3 Defined values Parameter 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.
PAGE 30
SARA-R4/N4 series - AT Commands Manual 5.3 Indicator control +CIND +CIND Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference +CME Error 5.3.1 Description Provides indication states related to network status, battery information and so on.
PAGE 31
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • "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
PAGE 32
SARA-R4/N4 series - AT Commands Manual 5.4.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.
PAGE 33
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number UBX-17003787 - R09 Description • 0: MT buffer of URCs defined within this command is cleared when 1...3 is entered • 1: MT buffer of URCs defined within this command is flushed to the DTE when 1...3 is entered (the OK final result code shall be given before flushing the codes). Indicates the indicator order number.
PAGE 34
SARA-R4/N4 series - AT Commands Manual 5.6 Clock +CCLK +CCLK Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No NVM No - Error reference +CME Error 5.6.1 Description Sets and reads the real-time clock of the MT. 5.6.
PAGE 35
SARA-R4/N4 series - AT Commands Manual Type Syntax Test AT+CSGT=? Response Example OK OK +CSGT: (list of supported s), +CSGT: (0-1),49 OK OK 5.7.3 Defined values Parameter Type String Number Number Description Greeting text. The factory-programmed value is the empty string. • 0: turn off the greeting text • 1: turn on the greeting text Maximum length of the parameter. 5.
PAGE 36
SARA-R4/N4 series - AT Commands Manual 5.9 Report mobile termination error +CMEE +CMEE Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 5.9.1 Description Configures the formatting of the result code +CME ERROR: as an indication of an error relating to the functionality of the MT.
PAGE 37
SARA-R4/N4 series - AT Commands Manual 6 Call control 6.1 Dial command D D Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M Syntax PIN required Settings saved Can be aborted Response time full Yes No Yes Up to 3 min Error reference +CME Error 6.1.1 Description Lists characters that may be used in a dialling string for making a call (voice, data or fax call) or controlling supplementary services in accordance with 3GPP TS 22.
PAGE 38
SARA-R4/N4 series - AT Commands Manual 6.2 Call answer A A Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M Syntax PIN required Settings saved Can be aborted Response time full No No No < 20 s Error reference +CME Error 6.2.1 Description Instructs the DCE to immediately connect to the line and start the answer sequence as specified for the underlying DCE. Any additional command that appears after A on the same command line is ignored. The command is abortable.
PAGE 39
SARA-R4/N4 series - AT Commands Manual is set to ON. Otherwise, if DTR is OFF, then the call is rejected. If the parameter of &D command is not set to 2, the DTR state has no impact on autoanswering. 6.4.2 Syntax Type Set Syntax ATS0= Response OK Example ATS0=2 Read ATS0? OK 000 OK OK 6.4.3 Defined values Parameter Type Number Description Value in the range 0-255; the answer to the read command is in "xxx" format.
PAGE 40
SARA-R4/N4 series - AT Commands Manual 7 Network service 7.1 Subscriber number +CNUM +CNUM Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No < 10 s Attributes Error reference +CME Error 7.1.1 Description Returns the MSISDNs related to this subscriber. If the subscriber has different MSISDN for different services, each MSISDN is returned in a separate line. MSISDN is read from the SIM. 7.1.
PAGE 41
SARA-R4/N4 series - AT Commands Manual 7.2.2 Syntax Type Action Syntax AT+CSQ Response +CSQ: , Example +CSQ: 2,5 Test AT+CSQ=? OK +CSQ: (list of supported s), (list of supported s) OK +CSQ: (0-31,99),(0-7,99) OK OK 7.2.3 Defined values Parameter Type Number Number Description The allowed range is 0-31 and 99.
PAGE 42
SARA-R4/N4 series - AT Commands Manual 7.3 Extended signal quality +CESQ +CESQ Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 7.3.
PAGE 43
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Description • 255: not known or not detectable Reference Signal Received Power (RSRP): • 0: -141 dBm or less • 1..96: from -140 dBm to -45 dBm with 1 dBm steps • 97: -44 dBm or greater • 255: not known or not detectable 7.
PAGE 44
SARA-R4/N4 series - AT Commands Manual URC), it is recommended to wait a few seconds before entering AT+COPS=2 in order to let the pending registration procedure (automatically triggered by the module in most cases) successfully end. The user should not rely only on the set command "OK" final result code as a confirmation that the network selection has been performed. To determine the current network registration status, +CEREG should be also checked. 7.4.
PAGE 45
SARA-R4/N4 series - AT Commands Manual SARA-R410M-01B / SARA-R410M-02B • =8 is used for LTE Cat M1. 7.5 Radio Access Technology (RAT) selection +URAT +URAT Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No NVM No - Attributes Error reference +CME Error 7.5.1 Description Forces the selection of the Radio Access Technology (RAT) in the protocol stack.
PAGE 46
SARA-R4/N4 series - AT Commands Manual Parameter Type Number <2ndPreferredAct> Number Description • 8: LTE CAT-NB1 • 9: eGPRS Indicates the preferred access technology; it is ignored if dual mode or tri mode are not selected. • 0: GSM • 2: UTRAN • 3: LTE • 7: LTE CAT-M1 • 8: LTE CAT-NB1 • 9: eGPRS Indicates the second preferred access technology; it is ignored if tri mode is not selected. • 0: GSM • 2: UTRAN • 3: LTE • 7: LTE CAT-M1 • 8: LTE CAT-NB1 • 9: eGPRS 7.5.
PAGE 47
SARA-R4/N4 series - AT Commands Manual The parameters , , are provided only if available. The read command provides the same information issued by the URC together with the current value of the parameter. The location information elements , and , if available, are returned only when =2 and the MT is registered with the network.
PAGE 48
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 5: UTRAN with HSUPA availability • 6: UTRAN with HSDPA and HSUPA availability • 7: E-UTRAN • 255: the current value is invalid 7.6.4 Notes The following is an overview of the values assumed by the parameter: • 0: a technical problem could have occurred, the user is requested to intervene. It is still possible to make emergency calls if some network is available.
PAGE 49
SARA-R4/N4 series - AT Commands Manual 7.7 Network selection control +PACSP +PACSP Modules SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No - Attributes Error reference +CME Error 7.7.
PAGE 50
SARA-R4/N4 series - AT Commands Manual The information text response of the read command reports only the current RAT (if any) parameters, determined by the parameter value. Table 4 lists the supported parameter values: Channel SARA-N4 SARA-R4 =0 * * =2 =3 =5 * * Table 4: parameter applicability 7.8.
PAGE 51
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK = 2, = 5: Example +UCGED: 2 5,1 5, OK OK = 0: +UCGED: MODE_5_DISABLED +UCGED: MODE_5_DISABLED OK OK = 5: +RSRP: 162,5110,"-075.00", +RSRP: ,, "", +UCGED: 2 +RSRQ: 162,5110,"-14.20", OK +RSRQ: ,, "", Test AT+UCGED=? OK +UCGED: (list of supported s) +UCGED: (0,2) OK OK 7.8.
PAGE 52
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number Number Number Description One byte routing area of the GERAN cell in hexadecimal format; FF if not known or not detectable. GERAN cell Received Signal Strength Indicator (RSSI) index as defined in 3GPP TS 45.008 [28]: • 0: less than -110 dBm • 1..62: from -110 to -48 dBm with 1 dBm steps • 63: -48 dBm or greater • 255: not known or not detectable Reserved for future use.
PAGE 53
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Description • 1..48: from -24 dB to 0 dB with 0.5 dB steps • 49: 0 dB or greater • 255: not known or not detectable Reports the latest obtained value of the UMTS speech code. Allowed values: • 3: AMR NB (4.75 kb/s) • 4: AMR NB (5.15 kb/s) • 5: AMR NB (5.90 kb/s) • 6: AMR NB (6.70 kb/s) • 7: AMR NB (7.40 kb/s) • 8: AMR NB (7.95 kb/s) • 9: AMR NB (10.2 kb/s) • 10: AMR NB (12.2 kb/s) • 11: AMR WB (6.60 kb/s) • 12: AMR WB (8.
PAGE 54
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number Number Number Number Number Number Number Number String String Description • 1: IDLE • 2: ATTEMPT TO CONNECT • 3: CONNECTED • 4: LEAVING CONNECTED STATE • 5: ATTEMPT LEAVING E-UTRA • 6: ATTEMPT ENTERING E-UTRA • 255: not known or not detectable Rank Indicator value; 255 if not known or not detect
PAGE 55
SARA-R4/N4 series - AT Commands Manual 7.9.2 Syntax Type Set Syntax AT+VZWAPNE=,, ,,, , Response OK Example AT+VZWAPNE=1,1,"VZWIMS", "IPv6","LTE","Enabled",0 Read AT+VZWAPNE? [+VZWAPNE: ,, ,,, [..
PAGE 56
SARA-R4/N4 series - AT Commands Manual 7.10 Read RSRP values +VZWRSRP +VZWRSRP Modules Attributes SARA-R404M Syntax full PIN required No Settings saved Can be aborted No No Response time - Error reference +CME Error 7.10.1 Description Returns the RSRP (Reference Signal Received Power) values for all LTE cells which the module is measuring. 7.10.2 Syntax Type Read Syntax AT+VZWRSRP? Response +VZWRSRP: Example +VZWRSRP: [,,[, ,,[, ...
PAGE 57
SARA-R4/N4 series - AT Commands Manual 7.12 eDRX setting +CEDRXS +CEDRXS Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full No No No Attributes Response time - Error reference +CME Error 7.12.1 Description Configures the UEs extended discontinuous reception (eDRX) parameters. The command controls whether the UE wants to apply the eDRX or not, as well as the requested eDRX value for each specified type of radio access technology.
PAGE 58
SARA-R4/N4 series - AT Commands Manual Parameter Type String Description The paging time window refers to bit 8 to 5 of octet 3 of the extended DRX parameters information element, half a byte in a 4 bit format. For the coding and the value range, see the extended DRX parameters information element in Table 10 .5.5.32 of 3GPP TS 24.008 [12]. 7.
PAGE 59
SARA-R4/N4 series - AT Commands Manual 7.14 Set MNO profile +UMNOPROF +UMNOPROF Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes NVM No Response time - Error reference +CME Error 7.14.1 Description Automatically configures the module to be compliant to the requirements of various Mobile Network Operators.
PAGE 60
SARA-R4/N4 series - AT Commands Manual 7.15 Band selection bitmask +UBANDMASK +UBANDMASK Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Attributes full Yes NVM No Response time - Error reference +CME Error 7.15.1 Description Sets the supported 4G LTE bands for different Radio Access Technologies (RATs). The bands supported are set by a bitmask where each bit in an 8 byte integer corresponds to a 4G LTE band.
PAGE 61
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 7 Network service Page 61 of 307
PAGE 62
SARA-R4/N4 series - AT Commands Manual 8 Security 8.1 Enter PIN +CPIN +CPIN Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No < 10 s Attributes Error reference +CME Error 8.1.1 Description Enter PIN. If no PIN request is pending, the corresponding error code is returned.
PAGE 63
SARA-R4/N4 series - AT Commands Manual AT+COPS=0 ERROR • To change the PIN the user must use the AT+CPWD="SC",, command (see Chapter 8.3 for details). Example: AT+CPWD="SC","1234","4321" 8.2 Facility lock +CLCK +CLCK Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No Yes Up to 3 min Error reference +CME Error 8.2.
PAGE 64
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • "AI": BAIC (Bar All Incoming Calls) • "IR": BIC-Roam (Bar Incoming Calls when Roaming outside the home country) • "AB": All Barring services (applicable only for =0) • "AG": All outGoing barring services (applicable only for =0) • "AC": All inComing barring services (applicable only for =0) • "CS": CNTRL (lock CoNTRoL surface (e.g. phone keyboard)) (see the 3GPP TS 27.
PAGE 65
SARA-R4/N4 series - AT Commands Manual 8.3.3 Defined values Parameter Type String String String Number Description "P2" SIM PIN2; see the +CLCK command description for other values Old password New password Length of password (digits) 8.3.4 Notes • If the PIN is blocked, an error result code will be provided when attempting to change the PIN code if the PIN check is disabled through AT+CLCK command.
PAGE 66
SARA-R4/N4 series - AT Commands Manual 9 Short Messages Service 9.1 Introduction For a complete overview of SMS, see 3GPP TS 23.040 [8] and 3GPP TS 27.005 [16]. In case of errors all the SMS related AT commands return an error result code as defined in Appendix A.2. 9.1.1 Class 0 SMS The storing of a class 0 SMS depends on the module series: • SARA-R4 / SARA-N4 - not stored. 9.1.
PAGE 67
SARA-R4/N4 series - AT Commands Manual 9.2.2 Syntax Type Set Syntax AT+CSMS= Read AT+CSMS? Test Response +CSMS: ,, Example AT+CSMS=1 OK +CSMS: 1,1,1 +CSMS: ,,, OK +CSMS: (list of supported s) AT+CSMS=? OK +CSMS: 0,1,1,1 OK +CSMS: (0-1) OK OK 9.2.3 Defined values Parameter Type Number Number Number Number Description • 0: see 3GPP TS 23.040 [8] and 3GPP TS 23.
PAGE 68
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Read AT+CPMS? Test AT+CPMS=? Example OK +CPMS: ,,, +CPMS: "MT",4,350,"MT",4,350, ,,, "MT",4,350 ,, OK OK +CPMS: (list of supported +CPMS: ("MT","ME","SM","BM", s),(list of supported "SR"),("MT","ME","SM"),("MT","ME", s),(list of supported "SM") s) OK OK 9.3.
PAGE 69
SARA-R4/N4 series - AT Commands Manual Type Test Syntax AT+CMGF=? Response Example +CMGF: (list of supported s) +CMGF: (0-1) OK OK 9.4.3 Defined values Parameter Type Number Description Indicates the format of messages used with send, list, read and write commands and URCs resulting from receiving SMSes messages: • • 0 (default and factory-programmed value): PDU mode 1: text mode 9.
PAGE 70
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Test AT+CRES=? Example OK +CRES: (list of supported s) +CRES: (0) OK OK 9.6.3 Defined values Parameter Type Number Description Specific SMS profile index from where to read the message service settings 9.
PAGE 71
SARA-R4/N4 series - AT Commands Manual Type URC Syntax Response Text mode (+CMGF=1): Example +CBM: 271,1025,1,1,1 +CBM: ,,,, PDU mode (+CMGF=0): The quick brown fox jumps over the lazy dog 0123456789 +CBM: +CDSI: , Text mode (+CMGF=1): URC URC +CDS: ,,[],[], ,
, PDU mode (+CMGF=0): +CDSI: "MT",2 +CDS: 6,202,"+393492323583",145, "14/07/25,13:07:16+02","14/07/25, 16:35:44+02",0 +CDS: <
PAGE 72
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number Number String String String String
Number Number Number Number Number Number Number String Number String Number Number Number Number UBX-17003787 - R09 Description Same as defined in +CPMS Defined Values Storage position Two meanings: • in text mode: number of characters • in PDU mod
PAGE 73
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number Number Number Number Description • 3: secret Callback number Text encoding: • 2: ASCII7 • 3: IA5 • 4: UCS2 • 8: ISO 8859-1 • 9: GSM7 Total number of SMS Fragment part number 3GPP2 reference ID 9.7.4 Notes • • The incoming SMS/CBM URC indications will be displayed only on the AT interface where the last +CNMI command was set.
PAGE 74
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK SMS-COMMAND +CMGR: ,,[,, [],[],[], Example []] OK CBM storage +CMGR: ,,,, , PDU mode (+CMGF=0): AT+CMGR= OK +CMGR: ,[], AT+CMGR=1 +CMGR: 1,,40 OK 0791934329002000040 C9193230982661400008070 328045218018D4F29CFE0 6B5CBF379F87C4EBF41E4340 82E7FDBC3 OK Test AT+CMGR=? OK 9.8.
PAGE 75
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number Number Description each 8-bit octet into two IRA character long hexadecimal number (e.g. octet with integer value 42 is presented to TE as two characters 2A (IRA 50 and 65)) In the case of CBS: 3GPP TS 23.041 [9] CBM Content of Message in text mode responses; format: • if indicates that 3GPP TS 23.
PAGE 76
SARA-R4/N4 series - AT Commands Manual The MT shall automatically disable routing to the TE by setting both and values of +CNMI to zero. If the command is executed, but no acknowledgement is expected, or some other MT related error occurs, the final result code +CMS ERROR: is returned. In PDU mode, it is possible to send either positive (RP-ACK) or negative (RP-ERROR) acknowledgement to the network. The parameter defines which one will be sent.
PAGE 77
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK Command successful and SMS-SUBMITs: +CMGL: ,,, [],[, ] Example [+CMGL: ,, ,[],[, ][...]] OK Command successful and SMS-STATUS-REPORTs: +CMGL: ,,,, [],[],,
, [+CMGL: ,,,, [],[],,
, [...
PAGE 78
SARA-R4/N4 series - AT Commands Manual Parameter Type String String Number Number String
String Number Number Number String Number String Number Number Number Number Number Number String Number UBX-17003787 - R09 Description Alphanumeric representation of or corresponding to the entry found in the phonebook 3GPP TS 24.008 [12]. The parameter is not managed.
PAGE 79
SARA-R4/N4 series - AT Commands Manual 9.11 Send message +CMGS +CMGS Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time Error reference full Yes No No Up to 3 min (<1 +CMS Error s for prompt ">" when present) 9.11.1 Description Sends a message from a DTE to the network (SMS-SUBMIT). The message reference value is returned to the DTE for a successful message delivery.
PAGE 80
SARA-R4/N4 series - AT Commands Manual 9.12 Write message to memory +CMGW +CMGW Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No <10 s Error reference +CMS Error 9.12.1 Description Stores a message (SMS-DELIVER or SMS-SUBMIT) to memory storage and returns the memory location of the stored message.
PAGE 81
SARA-R4/N4 series - AT Commands Manual Parameter Type String Description number +1234, that generates the address 03912143 (4 octets). Thus in this case =13. Protocol Data Unit: each 8-bit octet of the PDU must be written as two IRA character long hexadecimal numbers, e.g. an octet with integer value 42 must be written as two characters 2A (IRA 50 and 65) 9.
PAGE 82
SARA-R4/N4 series - AT Commands Manual 9.14.2 Syntax Type Set Syntax AT+CSMP=,[,[, ]] Response OK Example AT+CSMP=17,167,0,0 Read AT+CSMP? +CSMP: ,,, OK +CSMP: 17,167,0,0 Test AT+CSMP=? OK OK OK 9.14.3 Defined values Parameter Type Number Number Description First octet of the SMS TPDU (see 3GPP TS 23.
PAGE 83
SARA-R4/N4 series - AT Commands Manual Type Test Syntax AT+CMGD=? Response Example +CMGD: (list of supported +CMGD: (1-350),(0-4) s),(list of supported s) OK OK 9.15.3 Defined values Parameter Type Number Number Description Storage position Deletion flag.
PAGE 84
SARA-R4/N4 series - AT Commands Manual 9.17 Read concatenated message +UCMGR +UCMGR Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes No No Response time <10 s Error reference +CMS Error 9.17.
PAGE 85
SARA-R4/N4 series - AT Commands Manual Type Test Syntax AT+UCMGR=? Response OK Example 9.17.
PAGE 86
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • Relative format: validity period starting from when the SMS is received by the SMSC, in range 0-255 (default value 167); for more details see 3GPP TS 23.040 [8] 0 to 143
Number String Number String String Number Number Number Number String Number Number Number Validity period value (TP-VP + 1) x 5 minutes (i.e.
PAGE 87
SARA-R4/N4 series - AT Commands Manual Type Syntax Response ][,,,, ][...]] OK Example +UCMGL: 305,"REC READ","+39340 1234999",,"08/08/06,10:01:40+08", 145,29,2,2,8,32767 ssion is strictly prohibited. OK SMS-SUBMITs: +UCMGL: ,,, [],[, ][, ,,,] [+UCMGL: ,,, [],[,][,, ,,][...
PAGE 88
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number String
String Number Number Number String Number String Number Number Number Number Number Number Number UBX-17003787 - R09 Description Information Element Identifier, the possible values are the following: • 0: concatenated short messages, 8-bit reference number • 8: concatenated short messages, 16-bit reference number Concatenat
PAGE 89
SARA-R4/N4 series - AT Commands Manual 9.19 Send concatenated message +UCMGS +UCMGS Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes No No Response time Error reference Up to 3 min (<1 +CMS Error s for prompt ">" when present) 9.19.1 Description Sends one segment of a concatenated message from a DTE to the network (SMS-SUBMIT). The message reference value is returned to the DTE for a successful message delivery.
PAGE 90
SARA-R4/N4 series - AT Commands Manual 9.20 Write concatenated message to memory +UCMGW +UCMGW Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes No No Response time < 10 s Error reference +CMS Error 9.20.1 Description Stores one segment of a concatenated message (SMS-DELIVER or SMS-SUBMIT) to memory storage and returns the memory location of the stored message.
PAGE 91
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Description Maximum number of short messages in the concatenated short message (1-255) Information Element Identifier, the possible values are the following: Number • 0: Concatenated short messages, 8-bit reference number • 8: Concatenated short messages, 16-bit reference number Concatenated short message reference number: String Number • 0-255: Concatenated short messages, 8-bit reference number ca
PAGE 92
SARA-R4/N4 series - AT Commands Manual It optionally indicates that the exchange of data will be completed with: • Current uplink data transfer • The next received downlink data 9.22.
PAGE 93
SARA-R4/N4 series - AT Commands Manual Type URC Syntax Response +CRTDCP: ,, Example +CRTDCP: 0,2,"ab" 9.23.3 Defined values Parameter Type Number Number Number String UBX-17003787 - R09 Description • 0 (default value): reporting disabled • 1: reporting enabled by means of the URC +CRTDCP See Size of the received data. The maximum length 512 bytes User data container content (see the 3GPP TS 24.301 [88] subclause 9.9.4.
PAGE 94
SARA-R4/N4 series - AT Commands Manual 10 V24 control and V25ter 10.1 Introduction These commands, unless specifically stated, do not implement set syntax using "=", read ("?"), or test ("=?"). If such commands are used, the "+CME ERROR: unknown" or "+CME ERROR: 100" error result code is provided (depending on the +CMEE AT command setting). 10.
PAGE 95
SARA-R4/N4 series - AT Commands Manual 10.3.3 Defined values Parameter Type Number Description • • • 0: the DCE ignores circuit 108/2 1 (default value and factory-programmed value): upon an ON-to-OFF transition of circuit 108/2, the DCE enters online command state and issues an OK result code 2: upon an ON-to-OFF transition of circuit 108/2, the DCE performs an orderly cleardown of the call. The automatic answer is disabled while circuit 108/2 remains OFF 10.3.
PAGE 96
SARA-R4/N4 series - AT Commands Manual 10.4 DSR override &S &S Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No Profile No - Error reference +CME Error 10.4.1 Description Selects how the module will control RS232 circuit 107 - Data Set Ready (DSR). 10.4.2 Syntax Type Action Syntax AT&S[] Response OK Example 10.4.
PAGE 97
SARA-R4/N4 series - AT Commands Manual • • • • Set the parameter of AT&K command to 0 (flow control disabled) or 4, 5 or 6 (software flow control) when the RTS and CTS lines are not physically connected. The software flow control (XON/XOFF) setting is not allowed on the USB interfaces, on the SPI interface and on a multiplexer channel. See the Multiple AT command interfaces for all the behavior differences in respect to the supported interfaces.
PAGE 98
SARA-R4/N4 series - AT Commands Manual Application to XON/XOFF flow control implementation in the module The flow control characters DC1 and DC3 appears at arbitrary locations in the data stream received by the module.
PAGE 99
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 2: 8 data 1 parity 1 stop • 3: 8 data 1 stop • 4: 7 data 2 stops • 5: 7 bit, 1 parity, 1 stop • 6: 7 bit, 1 stop Number • • 0: odd 1: even 10.6.4 Notes SARA-R4 • Automatic frame recognition is not supported ( cannot be set to 0). • The only supported values are = 3 and = 1. 10.
PAGE 100
SARA-R4/N4 series - AT Commands Manual 10.7.3 Defined values Parameter Type Number Description • • • 0: none 1: DC1/DC3 on circuit 103 (XON/XOFF) 2 (default and the factory-programmed value): circuit 105 (RTS) Number • • • 0: none 1: DC1/DC3 on circuit 104 (XON/XOFF) 2 (default and the factory-programmed value): circuit 106 (CTS) 10.7.4 Notes • and parameters must be provided with the same value in pairs (only (0, 0), (1,1) and (2,2) are allowed.
PAGE 101
SARA-R4/N4 series - AT Commands Manual 10.9 UART data rate configuration +IPR +IPR Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No Profile No - Error reference +CME Error 10.9.1 Description Specifies the data rate at which the DCE accepts commands on the UART interface. The full range of data rates depends on HW or other criteria.
PAGE 102
SARA-R4/N4 series - AT Commands Manual 10.10 Return to on-line data state O O Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No - Attributes Error reference +CME Error 10.10.1 Description Causes the DCE to return to online data state and issue a CONNECT or CONNECT (based on ATX command) intermediate result code on DTE.
PAGE 103
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK Example OK 10.11.3 Defined values Parameter Type Number Description Range 1 to 255. The answer to the read command is in "xxx" format. The default and the factory-programmed value is 43 (ASCII '+'). 10.11.4 Notes SARA-R4 / SARA-N4 • The following table shows how the ATS2 command works for different data call scenarios.
PAGE 104
SARA-R4/N4 series - AT Commands Manual 10.13 Response formatting character S4 S4 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No Profile No - Error reference +CME Error 10.13.1 Description Sets a value representing the decimal IRA5 value of the character generated by the DCE as part of the header, trailer and terminator for result codes and information text, along with the S3 setting.
PAGE 105
SARA-R4/N4 series - AT Commands Manual 10.15 Pause before blind dialling S6 S6 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference +CME Error 10.15.1 Description Specifies the time in seconds that the DCE waits between connecting to the line and dialling, when the dial tone is not implemented or enabled.
PAGE 106
SARA-R4/N4 series - AT Commands Manual 10.17 Command dial modifier time S8 S8 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference +CME Error 10.17.1 Description Specifies the amount of time, in seconds, that the DCE shall pause during dialling, when a ',' (comma) dial modifier is encountered in a dial string. The command has no effect. 10.17.
PAGE 107
SARA-R4/N4 series - AT Commands Manual 10.19 Escape prompt delay (EPD) S12 S12 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference +CME Error 10.19.
PAGE 108
SARA-R4/N4 series - AT Commands Manual 10.21 Result code suppression Q Q Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No Profile No - Error reference +CME Error 10.21.1 Description Determines if DCE transmits result codes to the DTE or not. When result codes are being suppressed, no portion of any intermediate, final or URC is transmitted.
PAGE 109
SARA-R4/N4 series - AT Commands Manual 10.23 Result code selection and call progress monitoring control X X Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No Profile No - Error reference +CME Error 10.23.1 Description In a CS data call, determines how the DCE transmits to the DTE the CONNECT result code. 10.23.2 Syntax Type Set Syntax ATX[] Response OK Example ATX1 OK 10.23.
PAGE 110
SARA-R4/N4 series - AT Commands Manual 10.25 Set to factory defined configuration &F &F Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 10.25.1 Description Resets the current profile to factory-defined defaults. Other NVM settings, not included in the profiles, are not affected.
PAGE 111
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example 00, +CRC:000, +IPR:0, +COPS:0,0, FFFFF, +ICF:3,1, +UPSV: 0, +CMGF:0 , +CNMI:1,0,0,0,0, +USTS: 0 STORED PROFILE 1: &C1, &D1, &S1, &K3, E1, Q0, V1, X4, S00:000, S0 2:043, S03:013, S04:010, S05:00 8, S07:060, +CBST:007, 000, 001, +CRLP:061, 061, 048, 006, +CR:0 00, +CRC:000, +IPR:0, +COPS:0,0, FFFFF, +ICF:3,1, +UPSV: 0, +CMGF:0 , +CNMI:1,0,0,0,0, +USTS: 0 OK 10.26.3 Notes SARA-R4 / SARA-N4 • Only the ACTIVE PROFILE is available.
PAGE 112
SARA-R4/N4 series - AT Commands Manual 11 SIM management 11.1 Generic SIM access +CSIM +CSIM Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes No No Attributes Response time - Error reference +CME Error 11.1.1 Description Allows direct control of the SIM by a distant application on the TE. This command transparently transmits the to the SIM via the MT. The is returned in the same manner to the TE.
PAGE 113
SARA-R4/N4 series - AT Commands Manual Type Syntax Test AT+CLAN=? Response OK OK Example OK 11.2.3 Defined values Parameter Type String Description It is a two-letter abbreviation of the language. The language codes, as defined in ISO 639, consists of two characters, e.g. "en", "it" etc 11.
PAGE 114
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 13: CSD call active, (U)SIM toolkit REFRESH proactive command delayed till call release 11.3.4 Notes • • =9 and 10 will not be reported when dedicated (+CFUN=6) or raw (+CFUN=9) mode is active.
PAGE 115
SARA-R4/N4 series - AT Commands Manual 12 SIM toolkit 12.1 Introduction SIM Application Toolkit (STK) is the 3GPP standard feature that allows the Subscriber Identity Module (SIM) to handle the DCE, also by giving commands such as displaying menus and/or asking for user input, and control its access to the network. Once the SIM toolkit interface has been enabled via AT+CFUN command, the DTE is notified SIM toolkit commands and events and can interact with the SIM through appropriate STK AT commands.
PAGE 116
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Description • 2: OPEN CHANNEL, CLOSE CHANNEL and CHANNEL STATUS EVENT status indications enabled Indicates the event download's tag or proactive command's tag.
PAGE 117
SARA-R4/N4 series - AT Commands Manual 12.4 Write the USAT profile +CUSATW +CUSATW Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes NVM No Attributes Response time - Error reference +CME Error 12.4.1 Description Writes a USAT terminal profile to the profile storage location. If the profile storage parameter is omitted in the set command, it resets the profiles for all the supported profile storage values to factory-programmed setting.
PAGE 118
SARA-R4/N4 series - AT Commands Manual Type Test Syntax AT+UCUSATA=? Response +UCUSATA: (list of supported s) Example +UCUSATA: (0-3) OK OK +CUSATP: +CUSATEND URC URC 12.5.3 Defined values Parameter Type Number String Description URC enabling/disabling.
PAGE 119
SARA-R4/N4 series - AT Commands Manual 13 Packet switched data services 13.1 PDP contexts and parameter definition 13.1.1 Primary and secondary PDP contexts A PDP context can be either primary or secondary. In LTE, PS data connections are referred to as EPS bearers: EPS bearers are conceptually equivalent to the legacy PDP contexts, which are often referred to for sake of simplicity. Similarly to a PDP context, the EPS bearer can be a default (primary) or dedicated (secondary) one.
PAGE 120
SARA-R4/N4 series - AT Commands Manual 13.1.3 Parameter definition 13.1.3.1 The Access Point Name (APN) is a string parameter, which is a logical name, valid in the current PLMN's domain, used to select the GGSN (Gateway GPRS Support Node) or the external packet data network to be connected to. The APN can be omitted: this is the so-called "blank APN" setting that may be suggested by network operators (e.g.
PAGE 121
SARA-R4/N4 series - AT Commands Manual 13.2 PPP LCP handshake behaviour When a data call is initiated by means of D* AT command, the module switches to PPP mode just after the CONNECT intermediate result code. The first step of the PPP procedure is the LCP handshake, in this phase the behaviour of 2G products differs from 3G products and 4G products.
PAGE 122
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK Example 13.3.
PAGE 123
SARA-R4/N4 series - AT Commands Manual Command AT+CGDCONT? Response +CGDCONT: 2,"IP","internet","0.0.0.0",0,0 Description Read command +CGDCONT: 1,"IP","STATREAL","0.0.0.0",0 ,0 +CGDCONT: 3,"IP","tim.ibox.it","0.0.0.0",0,0 OK SARA-R4 / SARA-N4 • When registering in LTE, the initial default EPS bearer is mapped to = 1. • If not specified by the set command, the following values are assumed: o : 1 o : "0.0.0.0" • =1, 2 are not supported.
PAGE 124
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK Example +UPSD: 0,4,"0.0.0.0" ... +UPSD: 0,19,0 OK 13.4.
PAGE 125
SARA-R4/N4 series - AT Commands Manual Parameter UBX-17003787 - R09 Type Description o 0 (factory-programmed value): subscribed o 1: class 1 o 2: class 2 o 3: class 3 o 4: best effort • 12: QoS reliability - the parameter selects the reliability class: o 0 (factory-programmed value): subscribed o 1: class 1 (Interpreted as class 2) o 2: class 2 (GTP Unack, LLC Ack and Protected, RLC Ack) o 3: class 3 (GTP Unack, LLC Unack and Protected, RLC Ack) o 4: class 4 (GTP Unack, LLC Unack and Protect
PAGE 126
SARA-R4/N4 series - AT Commands Manual Parameter UBX-17003787 - R09 Type Description • 24: 3G QoS guaranteed downlink bit rate - is the value for the guaranteed downlink bit rate in kb/s. The factory-programmed value is 0. • 25: 3G QoS guaranteed uplink bit rate - is the value for the guaranteed uplink bit rate in kb/s. The factory-programmed value is 0. • 26: 3G QoS maximum downlink bit rate - is the value for the maximum downlink bit rate in kb/s.
PAGE 127
SARA-R4/N4 series - AT Commands Manual Parameter UBX-17003787 - R09 Type Description o 2: disable • 37: 3G minimum QoS erroneous SDU delivery - selects the acceptable value for the erroneous SDU delivery: o 0 (factory-programmed value): subscribed o 1: no detection o 2: enable o 3: disable • 38: 3G minimum QoS extended guaranteed downlink bit rate - is the value for the extended guaranteed downlink bit rate in kb/s. The factoryprogrammed value is 0.
PAGE 128
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 50: 3G minimum QoS traffic priority - selects the acceptable value for the traffic priority: o 0 (factory-programmed value): subscribed o 1: priority 1 o 2: priority 2 o 3: priority 3 • 51: 3G Minimum QoS transfer delay - is the value for the transfer delay in milliseconds. The factory-programmed value is 0. • 100: map the +UPSD profile to the specified in the +CGDCONT table.
PAGE 129
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Read AT+CGATT? +CGATT: Test AT+CGATT=? OK +CGATT: (list of supported s) Example OK +CGATT: 1 OK +CGATT: (0-1) OK OK 13.5.3 Defined values Parameter Type Number Description Indicates the state of GPRS attachment: • 0: detached • 1 (default value): attached 13.
PAGE 130
SARA-R4/N4 series - AT Commands Manual 13.6.4 Notes SARA-R4 / SARA-N4 • If is not defined, the command activates or deactivates all the defined PDP contexts. 13.6.5 Examples Examples of usage of +CGDCONT, +CGACT, +CGPADDR command: Command sent by the DTE AT+CMEE=2 DCE response OK AT+COPS=0 AT+COPS? OK +COPS: 0,0,"vodafone IT" AT+CGDCONT=1,"IP","web.omnitel.it" AT+CGDCONT=3,"IP","internet" AT+CGDCONT=2,"IP", "mms.vodafone.
PAGE 131
SARA-R4/N4 series - AT Commands Manual Command sent by the DTE AT+CGPADDR=3 DCE response OK +CGPADDR: 3, "0.0.0.0" AT+CGDCONT? OK +CGDCONT: 1,"IP","web.omnitel.it","0.0.0.0",0,0 Description Show the address of PDP context 3 +CGDCONT: 3,"IP","internet","0.0.0.0",0,0 +CGDCONT: 2,"IP","mms.vodafone.it","0.0.0.0",0,0 OK OK +CGDCONT: 1,"IP","web.omnitel.it","0.0.0.0",0,0 AT+CGACT=1,2 AT+CGDCONT? Activate the PDP context 2 +CGDCONT: 3,"IP","internet","0.0.0.0",0,0 +CGDCONT: 2,"IP","mms.vodafone.it","10.
PAGE 132
SARA-R4/N4 series - AT Commands Manual • • via a DTR transition from ON to OFF. sending an LCP Terminate Request. If used with = 100, this command can enable the local dial-up, that establishes a PPP communication between the DTE and the module through a serial interface (UART, MUX, or CDC-ACM). In this case an active PDP context is not needed since the DTE is assigned a private IP address. 13.7.2 Local dial-up The local dial-up feature is enabled by performing a dial-up on = 100.
PAGE 133
SARA-R4/N4 series - AT Commands Manual 13.8 Show PDP address +CGPADDR +CGPADDR Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No - Error reference +CME Error 13.8.1 Description Returns a list of PDP addresses for the specified context identifiers. Only defined PDP contexts are displayed. If the parameter is omitted, the addresses for all defined contexts are returned. 13.8.
PAGE 134
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example +CGEV: ME DEACT , ,[] +CGEV: ME DEACT,,,0 +CGEV: ME DEACT ,, +CGEV: ME MODIFY , , +CGEV: ME DETACH +CGEV: ME CLASS +CGEV: NW PDN ACT [, ] +CGEV: NW ACT ,, +CGEV: NW PDN DEACT +CGEV: NW DEACT,,,0 +CGEV: NW DEACT ,, +CGEV: NW DEACT , ,[
PAGE 135
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number String Description Indicates what kind of change occurred: • 1: TFT only changed • 2: QoS only changed • 3: both TFT and QoS changed See See GPRS mobile class.
PAGE 136
SARA-R4/N4 series - AT Commands Manual The parameters , , , are provided only if available. The read command provides the same information issued by the URC together with the current value of the parameter. The location information elements , and , if available, are returned only when =2 and the MT is registered with the network.
PAGE 137
SARA-R4/N4 series - AT Commands Manual Parameter Type String Description • 3: GSM with EDGE availability • 4: UTRAN with HSDPA availability • 5: UTRAN with HSUPA availability • 6: UTRAN with HSDPA and HSUPA availability • 255: the current value is invalid One byte routing area in hexadecimal format 13.10.
PAGE 138
SARA-R4/N4 series - AT Commands Manual Type Read Syntax AT+CEMODE? Response +CEMODE: Example +CEMODE: 1 Test AT+CEMODE=? OK +CEMODE: (list of supported 's) OK +CEMODE: (0-3) OK OK 13.12.3 Defined values Parameter Type Number Description Mode configuration: • 0: PS mode 2 of operation. The UE registers only to EPS services, and the UE's usage setting is "data centric" • 1 (default and factory-programmed value for voice capable devices): CS/PS mode 1 of operation.
PAGE 139
SARA-R4/N4 series - AT Commands Manual • +CEREG: [,[],[],[][,[],[][,[],[]]]] when =5 and the value of changes The parameters , , , , , and are provided only if available. The read command returns the status of result code presentation and an integer which shows whether the network has currently indicated the registration of the MT.
PAGE 140
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number String String Description • 7: E-UTRAN (see 3GPP TS 44.060 [89] that specifies the System Information messages which give the information about whether the serving cell supports EGPRS) • 8: E-UTRAN EC-GSM-IoT (A/Gb mode) • 9: E-UTRAN Cat NB1 type: • 0: indicates that contains an EMM cause value, see 3GPP TS 24.
PAGE 141
SARA-R4/N4 series - AT Commands Manual Type Test Syntax AT+CGDEL=? Response OK Example OK 13.14.3 Defined values Parameter Type Number Description See 13.15 Configure the authentication parameters of a PDP/EPS bearer +UAUTHREQ +UAUTHREQ Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted partial Yes NVM No Response time - Error reference +CME Error 13.15.
PAGE 142
SARA-R4/N4 series - AT Commands Manual • The and parameters must be set to an empty string if the authentication type is not set (=0). SARA-R4 / SARA-N4 • =3 is not supported. 13.16 PDP IP configuration when roaming +UDCONF=75 +UDCONF=75 Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes NVM No Response time - Error reference +CME Error 13.16.
PAGE 143
SARA-R4/N4 series - AT Commands Manual The configuration will be effective at the next power on. Only one PDP profile can be set using this command. 13.17.2 Syntax Type Set Syntax Response AT+UDCONF=76,, OK Example AT+UDCONF=76,1,0 Read AT+UDCONF=76 +UDCONF: 76,, OK AT+UDCONF=76 OK +UDCONF: 76,1,0 OK 13.17.3 Defined values Parameter Type Number Number Description See .
PAGE 144
SARA-R4/N4 series - AT Commands Manual 14 System features 14.1 Firmware installation +UFWINSTALL +UFWINSTALL Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time Attributes full No No No - Error reference FW Install Error 14.1.1 Description Triggers the FW installation procedure, starting from the file (update binary file) stored in the module file system.
PAGE 145
SARA-R4/N4 series - AT Commands Manual 14.2 Firmware update Over AT (FOAT) +UFWUPD +UFWUPD Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference FOAT Error 14.2.1 Description Triggers the firmware update using the Xmodem or Xmodem-1k protocol. The command syntax differs depending on the module series: see the corresponding subsection for the correct command handling.
PAGE 146
SARA-R4/N4 series - AT Commands Manual 14.3 Antenna detection +UANTR +UANTR Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Attributes Error reference +CME Error 14.3.1 Description Measures the DC component of load of the cellular antenna (the GPS antenna is RFU). The antenna load is expressed in kOhm. 14.3.
PAGE 147
SARA-R4/N4 series - AT Commands Manual • If the power saving is disabled (+UPSV: 0), the UART interface is always enabled and the module does not enter the idle mode 14.4.2 Syntax Type Set Syntax AT+UPSV= Response OK Example AT+UPSV=4 Read AT+UPSV? +UPSV: OK +UPSV: 0 Test AT+UPSV=? OK OK +UPSV: (list of supported s) +UPSV: (0,4) OK OK 14.4.3 Defined values Parameter Type Number Description Power saving configuration.
PAGE 148
SARA-R4/N4 series - AT Commands Manual • • • 4G transmission of LTE SC-FDMA OFDM signal (5 MHz bandwidth) in the desired channel in TDD band and power level Receiving signal detection and RF level measurement on the desired 2G, 3G or 4G (LTE) channel Receiving signal detection at diversity or secondary antenna input and RF level measurement on the desired 2G, 3G or 4G (LTE) channel The command only accepts the parameter set supported by the specific module version.
PAGE 149
SARA-R4/N4 series - AT Commands Manual Parameter .. Type Number Description Parameters needed for RX and TX test mode as reported in the table below. 14.5.5 Notes • • Check the corresponding module data sheet for the list of supported bands and Radio Access Technologies (RAT).
PAGE 150
SARA-R4/N4 series - AT Commands Manual Parameter Description Range Default Notes range [139650-141589] LTE band TDD 41 EARFCN range [39650 - 41589] Table 10: parameter range Time Antenna diversity Minimum antenna -100 ÷ -20 RF level estimation • 1 ÷ 600000 0÷1 Average antenna -100 ÷ -20 RF level estimation Maximum antenna -100 ÷ -20 RF level estimation 1000 0 The "+CME ERROR: operation not supported" or "+CME ERROR: 4" error result code will be
PAGE 151
SARA-R4/N4 series - AT Commands Manual Parameter Description Range Default Notes range [118000-118599] [118600-119199] [119200-119949] [119950-120399] [120400-120649] [120650-120749] [120750-121449] [121450-121799] [121800-122149] [123010-123179] [123180-123279] [123730-123849] [124000-124149] [124150-124449] [126040 - 126689] [126690 - 127039] [127210-127659] [136200-136349] [137750-138249] [138250-138649] [138650-139649] [139650-141589] LTE band FDD 1 FDD 2 FDD 3 FDD 4 FDD 5 FDD 6 FDD 7 FDD 8
PAGE 152
SARA-R4/N4 series - AT Commands Manual Parameter Description Range Training sequence 0 ÷ 7 Default Notes 5 Training sequence to be used (to be changed only in case of link with network simulator, else use default) In 3G / 4G RAT the values is unused. Modulation mode 1÷2 1 Modulation mode: o 1: GMSK normal modulation including the training sequence o 2: 8-PSK normal modulation including the training sequence In 3G / 4G RAT the parameter is ignored.
PAGE 153
SARA-R4/N4 series - AT Commands Manual Command Response AT+UTEST=3,65,8,,2,5000 +UTEST: 65,8,5,2,5000 OK AT+UTEST=3,660,,,,0 +UTEST: 660,5,5,1,0 OK AT+UTEST=3,9612,22,,,200 +UTEST: 9612,22,5,1,2000 0 OK AT+UTEST=3,120399,15,,, +UTEST: 120399,15,5,1,3000 3000 OK AT+UTEST=3,123230,-10,,,0 +UTEST: 123230,-10,5,1,0 OK Description The module will transmit for 5 s interval 1 slot burst sequence at TX channel 65 GSM 900 at PCL 8 (gamma 6, 27 dBm) using training sequence 5 and normal 8-PSK modulation.
PAGE 154
SARA-R4/N4 series - AT Commands Manual Type Syntax Output pins definition Set AT+UTEST=10,4,[] Response Example OK AT+UTEST=10,4,"00000000100000 002000" OK Digital testing execution Set AT+UTEST=10,5 OK AT+UTEST=10,5 OK Digital value measurement Set AT+UTEST=10,6 ] AT+UTEST=10,6 OK 00000004100000003000 OK +UTEST: 1 Read AT+UTEST? +UTEST: Test AT+UTEST=? OK +UTEST: (list of supported s) OK +UTEST: (0-3) OK OK 14.5.
PAGE 155
SARA-R4/N4 series - AT Commands Manual • - SARA-R4 / SARA-N4 - 64 pins o When a non-testable pin is selected, the command does not return an error result code but the value is not considered and not applied.
PAGE 156
SARA-R4/N4 series - AT Commands Manual The command handling (sensors position and command syntax) depends on the module series: • SARA-R4 / SARA-N4 - The AT command returns the value measured by the temperature sensor close to the oscillator (XO). 14.6.2 Syntax Type Set Syntax AT+UTEMP= Test AT+UTEMP=? Response +UTEMP: Example AT+UTEMP=0 OK +UTEMP: 310 +UTEMP: (list of supported ) OK +UTEMP: (0-1) OK OK 14.6.
PAGE 157
SARA-R4/N4 series - AT Commands Manual 14.7.
PAGE 158
SARA-R4/N4 series - AT Commands Manual 14.8 Power Saving Mode Assigned Values +UCPSMS +UCPSMS Modules Attributes SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full Yes No No - Error reference +CME Error 14.8.1 Description Reads the UEs power saving mode (PSM) parameters assigned by the network.
PAGE 159
SARA-R4/N4 series - AT Commands Manual 14.9 Set LWM2M FOTA URCs +ULWM2MSTAT +ULWM2MSTAT Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time Attributes full Yes NVM No - Error reference - 14.9.1 Description Allows enabling or disabling of LWM2M FOTA status URCs. 14.9.
PAGE 160
SARA-R4/N4 series - AT Commands Manual 14.11 LWM2M configuration +UFOTACONF +UFOTACONF Modules Attributes SARA-R410M-52B SARA-N4 Syntax PIN required full No Settings saved Can be aborted NVM No Response time - Error reference +CME Error 14.11.1 Description Configures the uFOTA registration and timer for periodic connections to the uFOTA server. 14.11.
PAGE 161
SARA-R4/N4 series - AT Commands Manual 14.12 Last gasp configuration +ULGASP +ULGASP Modules SARA-R410M-52B SARA-N4 Syntax PIN required partial No Attributes Settings saved Can be aborted NVM No Response time < 10 s Error reference +CME Error 14.12.1 Description The command enables/disables and configures the last gasp feature. The application is automatically triggered by a properly configured GPIO (see GPIO Introduction).
PAGE 162
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number String Number Number Number Number Number Number Description Factory-programmed value: empty string. Format of the parameter. Allowed values: • 0 (factory-programmed value): text • 1: binary PSD profile identifier. Only the value 1 is allowed. IP protocol used for socket connection.
PAGE 163
SARA-R4/N4 series - AT Commands Manual 15 GPIO 15.1 Introduction The section describes the AT commands used to configure the GPIO pins provided by u-blox cellular modules. 15.1.
PAGE 164
SARA-R4/N4 series - AT Commands Manual See the corresponding module system integration manual for the complete overview of all allowed configurations. 15.1.
PAGE 165
SARA-R4/N4 series - AT Commands Manual 15.1.3.3 Registered home network 3G • Cyclic Output / High for 50 ms, Output / Low for 50 ms, Output / High for 50 ms, Output / Low for 2 s Voltage VH VL 2s Time 50 ms Figure 3: GPIO pin progress for registered home network 3G 15.1.3.4 Registered home network Cat NB1 • Cyclic Output / High for 100 ms, Output / Low for 30 s Voltage VH VL 30 s Time 100 ms Figure 4: GPIO pin progress for registered home network Cat NB1 15.1.3.
PAGE 166
SARA-R4/N4 series - AT Commands Manual Voltage VH VL Time 50 ms 50 ms Figure 6: GPIO pin progress for registered roaming 3G 15.1.3.7 Registered roaming Cat NB1 • Cyclic Output / High for 100 ms, Output / Low for 100 ms, Output / High for 100 ms, Output / Low for 30 s Voltage VH VL 30 s Time 100 ms Figure 7: GPIO pin progress for registered roaming Cat NB1 15.1.3.8 Data transmission • Continuous Output / High Voltage VH VL Time Figure 8: GPIO pin progress for data transmission 15.1.3.
PAGE 167
SARA-R4/N4 series - AT Commands Manual Voltage VH Time VL 800 ms 200 ms Figure 9: GPIO pin progress for data transmission roaming 15.2 GPIO select configuration command +UGPIOC +UGPIOC Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No NVM No < 10 s Error reference +CME Error 15.2.1 Description Configures the GPIOs pins as input, output or to handle a custom function.
PAGE 168
SARA-R4/N4 series - AT Commands Manual Type Syntax Response [, Example 21,3 [....]] 23,255 OK 24,255 51,7 Test AT+UGPIOC=? +UGPIOC: (list of supported ),(list of supported ),(list of supported \) OK +UGPIOC: (20,21,23,24,51),(0-5,7,9, 255),(0-2) OK [, ... ,] OK 15.2.
PAGE 169
SARA-R4/N4 series - AT Commands Manual 15.3 GPIO read command +UGPIOR +UGPIOR Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No < 10 s Error reference +CME Error 15.3.1 Description Reads the current value of the specified GPIO pin, no matter whether it is configured as input or output (see the +UGPIOC AT command to define the GPIO function).
PAGE 170
SARA-R4/N4 series - AT Commands Manual 15.4.3 Defined values Parameter Type Number Description GPIO pin identifier: pin number Number See the GPIO mapping for the available GPIO pins, their mapping and factoryprogrammed values on different u-blox cellular modules series and version. GPIO value. Allowed values are 0 and 1. 15.4.4 Notes • The command works only if the parameter of the +UGPIOC AT command is set to 0.
PAGE 171
SARA-R4/N4 series - AT Commands Manual 16 File System 16.1 File tags 16.1.1 Description File system commands have the optional parameter that allows you to specify a file type when an AT command is issued, to inform the system what to do with it. Application specific files must be saved with the correct type tag, otherwise they are treated as common user files.
PAGE 172
SARA-R4 / SARA-N4 "GNSS" "PROFILE" "AUDIO_EXT" * "FOTA_EXT" * "AUDIO" "FOAT" Module "USER" SARA-R4/N4 series - AT Commands Manual * Table 18: Tag applicabilities to module series SARA-R4 / SARA-N4 The files specified with the "FOAT" tag (used to specify the firmware update package file) can only be downloaded or deleted. The +URDFILE and +ULSTFILE AT commands are not allowed. 16.
PAGE 173
SARA-R4/N4 series - AT Commands Manual Parameter Type Number String String Description File size expressed in bytes. For file system file name and data size limits see File system limits. Optional parameter that specifies the application file type. FILE TAGS table lists the allowed strings. Stream of bytes. 16.2.4 Notes • • Issue the AT+ULSTFILE=1 command to retrieve the available user space in the file system. Two files with different types can have the same name, i.e.
PAGE 174
SARA-R4/N4 series - AT Commands Manual Parameter Type ,.., String String Number Number Number / String Number / String Description • 1: gets the free space for the specific file type • 2: gets the file size expressed in bytes, belonging to type (if specified) Specifies the application file type. FILE TAGS table lists the allowed strings. File name.
PAGE 175
SARA-R4/N4 series - AT Commands Manual 16.5 Partial read file +URDBLOCK +URDBLOCK Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted partial No No No Response time - Error reference +CME Error 16.5.1 Description Retrieves a file from the file system. Differently from +URDFILE command, this command allows the user to read only a portion of the file, indicating the offset and amount of bytes. 16.5.
PAGE 176
SARA-R4/N4 series - AT Commands Manual 16.6.2 Syntax Type Set Syntax Response AT+UDELFILE=[,] OK Example AT+UDELFILE="filename","USER" OK 16.6.3 Defined values Parameter Type String String Description File name. For file system file name and data size limits see File system limits. The optional parameter specifies a different application file type. FILE TAGS table lists the allowed strings. 16.
PAGE 177
SARA-R4/N4 series - AT Commands Manual 16.8 File system limits 16.8.1 Limits Here below are listed the maximum file name length, the maximum data size of the file system and the maximum number of files for the u-blox cellular modules.
PAGE 178
SARA-R4/N4 series - AT Commands Manual 17 DNS DNS service requires the user to define and activate a connection profile, either PSD or CSD. When these command report an error which is not a +CME ERROR, the error class and code is provided through +USOER AT command. 17.1 Resolve name / IP number through DNS +UDNSRN +UDNSRN Modules Attributes SARA-R410M-52B SARA-N4 Syntax PIN required full No Settings saved Can be aborted No No Response time < 70 s Error reference TCP/UDP/IP Error 17.1.
PAGE 179
SARA-R4/N4 series - AT Commands Manual Parameter Type String Description Once the result of DNS resolution becomes available, it is notified to the AT interface through the +UUDNSRN URC Resolved IP address corresponding to the specified domain name String Resolved domain name corresponding to the provided IP address Number Result code of DNS resolution: • 0: no error • -1: DNS resolution failed.
PAGE 180
SARA-R4/N4 series - AT Commands Manual 18 Internet protocol transport layer 18.1 Introduction SARA-R4 / SARA-N4 Before using TCP/IP services, a connection profile must be defined and activated. The sockets can be managed independently and simultaneously over the same bearer (either PSD or CSD). AT commands for both reading and writing data on sockets are provided and the URC notifies the external application of incoming data and transmission result, no need for polling.
PAGE 181
SARA-R4/N4 series - AT Commands Manual IPv4 address 0x10.0xE4.0x4C.0x22 Remarks Invalid address; dot-hexadecimal notation; decimals given as hexadecimal numbers Table 19: IPv4 address format examples 18.2.3 IPv6 Format: • • • • • • • 128 bits long represented in 8 groups of 16 bits each. The 16 bits of a group are represented as 2 concatenated hexadecimal numbers. The groups are separated by a colon character (:). The leading 0 in a group is supported.
PAGE 182
SARA-R4/N4 series - AT Commands Manual 18.3.2 Syntax Type Set Test Syntax AT+USOCR=[,] Response +USOCR: Example AT+USOCR=17 OK +USOCR: 2 AT+USOCR=? +USOCR: (list of supported s),(list of supported s) OK +USOCR: (6,17),(1-65535) OK OK 18.3.3 Defined values Parameter Type Number Number Number Description • 6: TCP • 17: UDP Local port to be used while sending data. The range goes from 1 to 65535.
PAGE 183
SARA-R4/N4 series - AT Commands Manual Type Syntax Response OK Example 18.4.3 Defined values Parameter Type Number Number Number Description Socket identifier defined by the AT+USOCR command. The range goes from 0 to 6. • • 0 (default value): disable the SSL/TLS on the socket. 1: enable the SSL/TLS on the socket; a USECMNG profile can be specified with the parameter.
PAGE 184
SARA-R4/N4 series - AT Commands Manual Parameter Type Description : signed 32 bit numeric parameter representing the milliseconds for "keepidle" option. The range is 0-2147483647. The default value is 7200000 (2 hours) • 65535: socket for socket level options may be: o 4: local address re-use. : numeric parameter, it configures the "local address re-use" option.
PAGE 185
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Test AT+USOGO=? +USOGO: (list of supported s),(list of supported s) Example OK +USOGO: (0-6),(0,6,65535) OK OK 18.6.3 Defined values Parameter Type Number Number Description Socket identifier. The range goes from 0 to 6. • • • 0: IP Protocol for IP protocol level may be: o 1: type of service : 8 bit mask that represents the flags of IP TOS. For more information see the RFC 791 [27].
PAGE 186
SARA-R4/N4 series - AT Commands Manual 18.7 Close Socket +USOCL +USOCL Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No < 120 s (except URC) Attributes Error reference +CME Error 18.7.1 Description Closes the specified socket, like the BSD close routine. In case of remote socket closure the user is notified via the URC.
PAGE 187
SARA-R4/N4 series - AT Commands Manual 18.8.2 Syntax Type Action Syntax AT+USOER Response +USOER: Example +USOER: 104 OK OK 18.8.3 Defined values Parameter Type Number Description Code of the last error occurred in a socket operation. The allowed values are listed in Appendix A.5 • 0: no error 18.
PAGE 188
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Description • 0 (default value): the operation result is returned only once the TCP connection is established, locking the AT interface until the connection activity is running • 1: the final result code is returned immediately unlocking the AT interface and making it available for the execution of other AT commands. Once the result of TCP connection becomes available, it is notified to the AT interface through the +UUSOCO URC.
PAGE 189
SARA-R4/N4 series - AT Commands Manual 18.10.
PAGE 190
SARA-R4/N4 series - AT Commands Manual 18.11 SendTo command (UDP only) +USOST +USOST Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No < 10 s Error reference TCP/UDP/IP Error +CME Error 18.11.1 Description Writes the specified amount of data to the remote address, like the BSD sendto routine, and returns the number of bytes of data actually written.
PAGE 191
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number Number String Description Remote host IP address or domain name of the remote host. For IP address format reference see the IP addressing. Remote host port, in range 1-65535 Number of data bytes to write • Base syntax normal mode: range 1-1024 • Base syntax HEX mode: range 1-512 • Binary syntax mode: range 1-1024 Data bytes to be written (not all of the ASCII charset can be used) 18.11.
PAGE 192
SARA-R4/N4 series - AT Commands Manual If the HEX mode is enabled (refer to AT+UDCONF=1 command) the received data will be displayed using an hexadecimal string. 18.12.
PAGE 193
SARA-R4/N4 series - AT Commands Manual reading, either when new data arrives or after a partial read by the user for the socket. This command can also return the total amount of unread data. This command can be applied to UDP sockets only, and it can be used to read data after both +UUSORD and +UUSORF unsolicited indication. If the HEX mode is enabled (see +UDCONF=1) the received data will be displayed using an hexadecimal string. 18.13.
PAGE 194
SARA-R4/N4 series - AT Commands Manual 18.14 Set Listening Socket +USOLI +USOLI Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No < 1 s (except URC) Attributes Error reference TCP/UDP/IP Error +CME Error 18.14.
PAGE 195
SARA-R4/N4 series - AT Commands Manual 18.14.4 Notes • In case of notification via the URC +UUSOLI is intended as the remote port. 18.15 HEX mode configuration +UDCONF=1 +UDCONF=1 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 18.15.1 Description Enables/disables the HEX mode for +USOWR, +USOST, +USORD and +USORF AT commands. 18.15.
PAGE 196
SARA-R4/N4 series - AT Commands Manual 18.16.2 Syntax Type Set Syntax AT+USODL= Response CONNECT Test AT+USODL=? +USODL: (list of supported s) Example AT+USODL=0 CONNECT +USODL: (0-6) OK OK 18.16.3 Defined values Parameter Type Number Description Socket identifier. The range goes from 0 to 6. 18.16.
PAGE 197
SARA-R4/N4 series - AT Commands Manual 18.16.4.5 About serial data chunks A data chunk is the amount of data that SIO recognizes as a single data transmission. If the baud rate is lower than 115200 b/s the time to receive 255 characters is always calculated with timings for 115200 b/s. 18.16.4.6 Data from the network The data received from the network is immediately forwarded to the serial interface. 18.16.4.
PAGE 198
SARA-R4/N4 series - AT Commands Manual 18.18.2 Syntax Type Set Syntax AT+UDCONF=3,, Read AT+UDCONF=3, Response OK Example AT+UDCONF=3,1,1000 OK +UDCONF: 3,, +UDCONF: 3,1,1000 OK OK 18.18.3 Defined values Parameter Type Number Description Socket identifier; used when changing the UDP Direct Link settings.
PAGE 199
SARA-R4/N4 series - AT Commands Manual 18.20 Data Length Trigger configuration for Direct Link +UDCONF=6 +UDCONF=6 Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 18.20.1 Description Sets the data length trigger of the interested socket identifier for the data transmission enhanced Direct Link. 18.20.
PAGE 200
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Description The allowed range is 0-6 Enhanced Direct Link character trigger, the value represents the ASCII code (in base 10) of the character to be used as character trigger. The allowed range is -1, 0-255, the factory-programmed value is -1; -1 means trigger disabled 18.
PAGE 201
SARA-R4/N4 series - AT Commands Manual 18.23.3 Defined values Parameter Type Number Number Number / String Description Socket identifier. The range goes from 0 to 6 Control request identifier.
PAGE 202
SARA-R4/N4 series - AT Commands Manual 18.24 Configure Dormant Close Socket Behavior +USOCLCFG +USOCLCFG Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full Yes NVM No Response time - Error reference +CME Error 18.24.1 Description Enables or disables the TCP socket Graceful Dormant Close feature.
PAGE 203
SARA-R4/N4 series - AT Commands Manual 19 SSL/TLS 19.1 Introduction SSL/TLS provides a secure connection between two entities using TCP socket for communication (i.e. HTTP/ FTP server and HTTP/FTP client).
PAGE 204
SARA-R4/N4 series - AT Commands Manual The certificates and private keys are kept in DER format and are not retrievable (i.e. cannot be downloaded from the module); for data validation purposes an MD5 hash string of the stored certificate or private key (stored in DER format) can be retrieved. Up to 16 certificates or private keys can be imported. Data for certificate or private key import can be provided with a stream of byte similar to +UDWNFILE or from a file stored on the FS.
PAGE 205
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Test AT+USECMNG=? Example OK +USECMNG: (list of supported s),(list of supported s) OK OK 19.2.
PAGE 206
SARA-R4/N4 series - AT Commands Manual 19.3 SSL/TLS security layer profile manager +USECPRF +USECPRF Modules Attributes SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference +CME Error 19.3.
PAGE 207
SARA-R4/N4 series - AT Commands Manual Expected server hostname * * * SNI Trusted root certificate internal name * Pre-shared key used for connection Cipher suite * Password for the client private key Minimum SSL/TLS version SARA-R4 SARA-N4 Certificate validation level Table 21 provides the list the applicability of SSL connection properties depending on the module series.
PAGE 208
SARA-R4/N4 series - AT Commands Manual Parameter Type Description o 0 (factory-programmed value): (0x0000) Automatic the cipher suite will be negotiated in the handshake process o 1: (0x002f) TLS_RSA_WITH_AES_128_CBC_SHA o 2: (0x003C) TLS_RSA_WITH_AES_128_CBC_SHA256 o 3: (0x0035) TLS_RSA_WITH_AES_256_CBC_SHA o 4: (0x003D) TLS_RSA_WITH_AES_256_CBC_SHA256 o 5: (0x000a) TLS_RSA_WITH_3DES_EDE_CBC_SHA o 6: (0x008c) TLS_PSK_WITH_AES_128_CBC_SHA o 7: (0x008d) TLS_PSK_WITH_AES_256_CBC_SHA o 8: (0x008b) TLS_PSK_W
PAGE 209
SARA-R4/N4 series - AT Commands Manual 19.3.
PAGE 210
SARA-R4/N4 series - AT Commands Manual In the above example the following PEM encoded trusted certificate is used: -----BEGIN CERTIFICATE----MIIEIDCCAwigAwIBAgIQNE7VVyDV7exJ9C/ON9srbTANBgkqhkiG9w0BAQUFADCB qTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYGA1UECxMf Q2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMvKGMpIDIw MDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxHzAdBgNV BAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwHhcNMDYxMTE3MDAwMDAwWhcNMzYw NzE2MjM1OTU5WjCBqTELMAkGA1UEBhMCVVMxFTATBgNVB
PAGE 211
SARA-R4/N4 series - AT Commands Manual 20 FTP Proprietary u-blox AT commands. FTP AT commands set can be used for sending and receiving files over the available bearer, transparently retrieving and storing them in the file system. Standard file and directory management operations on the remote FTP server are as well possible. PSD or CSD connection must be activated before using FTP client services.
PAGE 212
SARA-R4/N4 series - AT Commands Manual Type Set Syntax AT+UFTP=5[,] Response OK Example AT+UFTP=5,21 OK FTP mode Set AT+UFTP=6[,] OK AT+UFTP=6,1 OK FTP server port Set AT+UFTP=7[,] OK AT+UFTP=7,30 OK FTP Secure option in explicit mode Set AT+UFTP=8[,[, ]] OK Read +UFTP: 0, +UFTP: 0,"216.239.59.
PAGE 213
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number Number / String Number / String Description Remote FTP server listening port; it must be a valid TCP port value. The range goes from 1 to 65535; the default value is 21. Enables / disables the Secure option (explicit mode) of FTP client service.
PAGE 214
SARA-R4/N4 series - AT Commands Manual Type Set Syntax AT+UFTPC=0 Response OK Example AT+UFTPC=0 OK FTP login Set AT+UFTPC=1 OK AT+UFTPC=1 OK Delete the file from the FTP server Set AT+UFTPC=2, OK AT+UFTPC=2,"mytest" OK Rename a file of FTP server Set AT+UFTPC=3,, OK AT+UFTPC=3,"old_name","final_ name" OK Retrieve the file from the FTP server Set AT+UFTPC=4,, OK [,] Store the file on the FTP server Set A
PAGE 215
SARA-R4/N4 series - AT Commands Manual 20.2.3 Defined values Parameter Type Number Description FTP command request. Allowed values: • • String String String String Number Number String String Number UBX-17003787 - R09 0: FTP logout; terminates the FTP session by performing a logout.
PAGE 216
SARA-R4/N4 series - AT Commands Manual Parameter Type String Description Data available from the FTP server in the ASCII [0x00,0xFF] range. The starting quotation mark shall not be taken into account like data, the first byte of data starts after the first quotation mark. The total number of bytes is . At the end of the byte stream, another quotation mark is provided for user convenience and visualization purposes.
PAGE 217
SARA-R4/N4 series - AT Commands Manual 21 HTTP The section describes the u-blox proprietary AT commands that can be used for sending requests to a remote HTTP server, receiving the server response and transparently storing it in the file system. The supported methods are: HEAD, GET, DELETE, PUT, POST file and POST data. A PSD or CSD connection must be activated before using HTTP AT commands. When these commands report an HTTP error, the error code can be queried using the +UHTTPER AT command.
PAGE 218
SARA-R4/N4 series - AT Commands Manual Type Syntax Username Set AT+UHTTP=,2, Read AT+UHTTP=,2 Response Example OK OK AT+UHTTP=2,2,"my_user" OK +UHTTP: ,2, AT+UHTTP=2,2 OK +UHTTP: 2,2,"my_user" OK Password Set AT+UHTTP=,3, Read AT+UHTTP=,3 OK AT+UHTTP=2,3,"pwd" OK +UHTTP: ,3, AT+UHTTP=2,3 OK +UHTTP: 2,3,"pwd" OK Authentication type Set AT+UHTTP=,4,
PAGE 219
SARA-R4/N4 series - AT Commands Manual Parameter Type String String Number Number Number String String Number String Number / String Number / String Description • 4: authentication type • 5: HTTP server port • 6: HTTP Secure option (SSL encryption) • 7: reserved for internal use only • 8: reserved for inte
PAGE 220
SARA-R4/N4 series - AT Commands Manual 21.2 HTTP advanced control+UHTTPAC +UHTTPAC Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time full No No No - Error reference Appendix A.6 21.2.1 Description Configures, reads or resets (to the factory-programmed values) the HTTP application profile advanced parameters. The configured HTTP profile advanced parameters are not saved in the non volatile memory.
PAGE 221
SARA-R4/N4 series - AT Commands Manual Command Example 3 AT+UHTTPAC=0,0,0,"COMPLEX_COOKIE; COMPLEX_ COOKIE" Response Description OK Overwrite HTTP request cookie at index 0 with a complex cookie 21.3 HTTP command +UHTTPC +UHTTPC Modules Attributes SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted Response time partial No No No - Error reference Appendix A.6 21.3.
PAGE 222
SARA-R4/N4 series - AT Commands Manual Parameter Type Description - 2: application/octet-stream - 3: multipart/form-data - 4: application/json - 5: application/xml - 6: user defined with o : used only when =6 (user defined Content-Type). The maximum length is 64 characters • 4: POST a file command; issue a POST request for sending a file to the HTTP server.
PAGE 223
SARA-R4/N4 series - AT Commands Manual Parameter Type Number String Description HTTP status code reported in the server response header after a GET FOTA update file request. This parameter is issued only for AT+UHTTPC=,100, AT command. MD5 checksum of the FOTA update file. This parameter is issued only for AT +UHTTPC=,100, AT command. 21.3.4 Notes • • • The +UHTTPC command has a default timeout setting set to 180 s.
PAGE 224
SARA-R4/N4 series - AT Commands Manual 22 GNSS 22.1 NMEA u-blox cellular modules support reading NMEA strings from the GNSS receiver through AT commands. Before being able to read a specific NMEA string, it is necessary to activate the storage of the last value of that particular NMEA string. If storing a particular NMEA string was not activated, the response to the query will be "0,NULL".
PAGE 225
SARA-R4/N4 series - AT Commands Manual ephemeris was intended for. This makes downloading new ephemeris or aiding data for the first fix unnecessary for subsequent start-ups of the receiver. The AssistNow Autonomous feature may be not fully supported on all Multi-GNSS receivers. For more details on AssistNow Autonomous feature see the corresponding u-blox-GNSS receiver description. For a more detailed description on aiding modes and possible suggestions, see the GNSS Implementation Application Note [52].
PAGE 226
SARA-R4/N4 series - AT Commands Manual 22.2.4 Notes • • • • To know the allowed combinations of GNSS type for see the corresponding GNSS receiver documentation. If type is not supported by the GNSS receiver, the set command turns on the GNSS receiver with built-in supported type. The current can be queried by means of the read command or the +UUGIND URC.
PAGE 227
SARA-R4/N4 series - AT Commands Manual 22.3.
PAGE 228
SARA-R4/N4 series - AT Commands Manual • Into a file on the cellular module: A file with GNSS data can be accessed via +ULSTFILE command. The file name is automatically chosen by the cellular module as a unique ID based on date and time or a further incremental number (e.g. "GPS_200910061500" or "GPS_20091006_001" according to the used cellular module). When the files size reaches 500 kB the file is closed and no more data is saved.
PAGE 229
SARA-R4/N4 series - AT Commands Manual 22.5 Aiding server configuration +UGSRV +UGSRV Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full No NVM No Attributes Response time - Error reference +CME Error 22.5.1 Description Configures the network connection to a Multi GNSS Assistance (MGA) server. The configuration is saved in NVM and applied at the next GNSS power cycle. The MGA server is accessed with the HTTP.
PAGE 230
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Number Number Number Number Description The number of days into the future the Offline data for u-blox 7 and previous version should be valid for. The allowed values are: 1, 2, 3, 5, 7, 10 and 14. The default and factory-programmed value is 14. The number of weeks into the future the Offline data for u-blox M8 should be valid for.
PAGE 231
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 1: Download of local aiding data from the cellular module to the GNSS receiver • 2: AssistNow Offline file download request (file loaded into cellular module) • 4: AssistNow Online data download request (data loaded into the GNSS receiver). This is only needed if AssistNow Online is not used with automatic operation • 8: AssistNow autonomous • Other values are reserved for future use 22.
PAGE 232
SARA-R4/N4 series - AT Commands Manual 22.8 GNSS indications timer +UGTMR +UGTMR Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full No No No Attributes Response time < 10 s Error reference +CME Error 22.8.1 Description Sets the date and time format. With the parameter is possible to set the time zone value; the time and the date will be updated as the local time. With the action command is possible to synchronize the UTC timing. 22.8.
PAGE 233
SARA-R4/N4 series - AT Commands Manual 22.9.2 Syntax Type Set Syntax AT+UGZDA= Response OK Example AT+UGZDA=1 Read AT+UGZDA? +UGZDA: ,<$ZDA msg> OK +UGZDA: 1,$GPZDA,142351.00,12,12, 2013,00,00*66 OK OK +UGZDA: 0,NULL Test AT+UGZDA=? +UGZDA: (list of supported s) OK +UGZDA: (0-1) OK OK 22.9.
PAGE 234
SARA-R4/N4 series - AT Commands Manual Parameter <$GGA msg> Type String Description NMEA $GGA messages or "Not available" if the NMEA string is enabled, but this information has not been still sent to the user. 22.11 Get geographic position +UGGLL +UGGLL Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full No NVM No Attributes Response time < 10 s Error reference +CME Error 22.11.
PAGE 235
SARA-R4/N4 series - AT Commands Manual 22.12.
PAGE 236
SARA-R4/N4 series - AT Commands Manual Type Syntax Response Test AT+UGRMC=? +UGRMC: (list of supported s) Example OK +UGRMC: (0-1) OK OK 22.13.3 Defined values Parameter Type Number <$RMC msg> String Description • 0 (factory-programmed value): to disable the NMEA $RMC messages • 1: to enable the NMEA $RMC messages NMEA $RMC messages or "Not available" if the NMEA string is enabled, but this information has not been still sent to the user. 22.
PAGE 237
SARA-R4/N4 series - AT Commands Manual 22.15 Get satellite information +UGGSA +UGGSA Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Syntax PIN required Settings saved Can be aborted full No NVM No Attributes Response time < 10 s Error reference +CME Error 22.15.1 Description Enables/disables the storing of the last value of NMEA $GSA messages, and gets the current messaging state.
PAGE 238
SARA-R4/N4 series - AT Commands Manual If the +ULOC command is sent while a previous +ULOC activity is still in progress the previous activity is aborted, the available position is immediately output and the next +ULOC request is served. The data connection cannot be immediately dropped at the +ULOC timeout expiration. This could lead to a delay in the expected response time. Depending on the aiding chosen, a data connection could be required; see the AT+UGPS command description.
PAGE 239
SARA-R4/N4 series - AT Commands Manual Type Syntax Response ,,,,,,[,, ,,, ,] If =2, = 0: +UULOC: ,,,,,,, , Example +UULOC: 1,1,0,08/04/2015,09:0 3:45.000,45.7140290,13.7410695,0, 32 22.16.
PAGE 240
SARA-R4/N4 series - AT Commands Manual Parameter Type Number Number Description Antenna status (0 - 4)(3). For more details see the u-blox GNSS receiver protocol specification Jamming status3. For more details see the u-blox GNSS receiver protocol specification 22.16.
PAGE 241
SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 1: wrong URL • 2: HTTP error • 3: create socket error • 4: close socket error • 5: write to socket error • 6: read from socket error • 7: connection/DNS error • 8: authentication token missing or wrong (required for aiding for u-blox M8 and future versions) • 9: generic error • 10: user terminated • 11: no data from server 22.
PAGE 242
SARA-R4/N4 series - AT Commands Manual 22.18.
PAGE 243
SARA-R4/N4 series - AT Commands Manual 2 23 I C 23.1 Introduction The I2C AT commands support communication with more than one connected device via one of the controllers, but require opening and closing a logical channel for each connected device. Only one logical channel at a time can be opened. The availability and hardware description of the I2C interfaces are out of the scope of this document and are described in a separate document. Refer to the corresponding module System Integration Manual.
PAGE 244
SARA-R4/N4 series - AT Commands Manual Type Syntax Response supported s),(list of supported ),( range),(list of supported s) Example OK OK 23.2.
PAGE 245
SARA-R4/N4 series - AT Commands Manual 2 23.4 I C read from peripheral +UI2CR +UI2CR Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full No No No Attributes Response time - Error reference +CME Error 23.4.1 Description Reads of data from the I2C slave device of the current logical channel and prints them in HEX format in separate rows. 23.4.
PAGE 246
SARA-R4/N4 series - AT Commands Manual 23.5.3 Defined values Parameter Type Number Number ,..., ,..., Number Description Device address in HEX format Number of bytes to read from the slave I2C register. The range goes from 1 to 100. Index of the byte being printed. n-th byte of the data, in hex mode (unquoted, prefixed by 0x). 2 23.
PAGE 247
SARA-R4/N4 series - AT Commands Manual 24 MQTT The MQ Telemetry Transport (MQTT) protocol specifies a simple and lightweight messaging protocol, designed for constrained devices and low-bandwidth, high-latency, or unreliable networks. An MQTT client uses publish and subscribe methods to interact over a TCP connection with an MQTT message broker (henceforth referred to as an MQTT server). The u-blox modules can be configured to operate as an MQTT client.
PAGE 248
SARA-R4/N4 series - AT Commands Manual Type Set Syntax AT+UMQTT=1, Response +UMQTT: 1, Example AT+UMQTT=1,1883 OK +UMQTT: 1,1 OK MQTT server name Set AT+UMQTT=2,[, ] +UMQTT: 2, OK AT+UMQTT=2, "www.commercialmqttbroker.com" +UMQTT: 2,1 OK MQTT server IP address Set AT+UMQTT=3,[, AT+UMQTT=3,"192.168.1.
PAGE 249
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number String String String String Number Number Number Number Number Number / String Number / String Number Description Uniquely identifies this client connection to a given MQTT message broker.
PAGE 250
SARA-R4/N4 series - AT Commands Manual • • • • • • indicates that more information from this MQTT parameter remains to be displayed. If the continuation symbol appears on both sides of the double-quotes, then this message is the continuation of a previous display (and requires future displays to complete), e.g., Topic: +"is in the middle of a long messa"+. The profile parameters 6, 7, 8, 9 and 14 are provided in the read response for informational purposes.
PAGE 251
SARA-R4/N4 series - AT Commands Manual Parameter Type String Number Description • 0 (default value): the Will Message will not be retained at the MQTT server across disconnects from MQTT client • 1: the Will Message will be retained by the MQTT server across disconnects from MQTT client (until superseded by another message). Standard MQTT Topic Name. It could include various Topic Separators "/" to form various Topic levels. Operation result: • 0: failure • 1: success 24.2.
PAGE 252
SARA-R4/N4 series - AT Commands Manual 24.4 Save/Restore MQTT profile from NVM +UMQTTNV +UMQTTNV Modules Attributes SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Syntax PIN required Settings saved Can be aborted full No No No Response time - Error reference +CME Error 24.4.1 Description Either saves all of the MQTT client profile parameters to NVM (non-volatile memory) or sets all of the MQTT client profile parameters to either default or non-volatile stored values. 24.4.
PAGE 253
SARA-R4/N4 series - AT Commands Manual Type Syntax MQTT logout Set AT+UMQTTC=0 Response Example +UMQTTC: 0, AT+UMQTTC=0 OK +UMQTTC: 0,1 OK MQTT login Set AT+UMQTTC=1 URC MQTT publish to a topic Set AT+UMQTTC=2,,, [],, +UMQTTC: 1, AT+UMQTTC=1 OK +UMQTTC: 1,1 +UUMQTTC: 1, OK +UUMQTTC: 1,0 +UMQTTC: 2, OK AT+UMQTTC=2,0,0,"/sensor/heat/ SD/bldg5/DelMarConfRm","23 degrees Celsius" +UMQTTC: 2,1 OK MQTT pub
PAGE 254
SARA-R4/N4 series - AT Commands Manual Type Syntax MQTT Message URC Response Example +UUMQTTCM: , [Topic Len: ] [Topic: ] [Len: Qos: ] Message: +UUMQTTCM: 6,1 Topic: "/sensor/ heat/SD/bldg5/DelMarConfRm" Len: 16 QoS: 0 Message: "16 bytes of data" 24.5.
PAGE 255
SARA-R4/N4 series - AT Commands Manual 24.5.4 Notes • • • • The topic name should not include any wildcards for the Publish commands. The topic filter could include the '+' wildcard to substitute for a single topic folder or the '#' wildcard to substitute for any number of topic folders. The '#' wildcard must be the last character in a topic filter.
PAGE 256
SARA-R4/N4 series - AT Commands Manual A Appendix: Error result codes A.
PAGE 257
SARA-R4/N4 series - AT Commands Manual Numeric error code 126 132 133 134 135 140 141 142 143 144 145 146 148 149 150 156 159 172 173 174 175 176 254 255 300 301 302 303 304 305 310 311 312 313 314 315 316 317 318 320 321 322 330 331 332 340 500 701 702 1001 1003 1006 1008 1016 1017 UBX-17003787 - R09 Description Insufficient resources Service option not supported Requested service option not subscribed Service option temporarily out of order NS-api already used Feature not supported Semantic error in th
PAGE 258
SARA-R4/N4 series - AT Commands Manual Numeric error code 1018 1019 1021 1022 1026 1027 1028 1029 1030 1031 1034 1038 1041 1042 1043 1044 1047 1049 1050 1055 1057 1058 1063 1065 1068 1069 1070 1079 1081 1087 1088 1091 1095 1096 1097 1098 1099 1100 1101 1102 1111 1127 1279 1283 1500 1501 1502 1503 1504 1505 1520 1521 1530 1531 1540 UBX-17003787 - R09 Description No user responding User alerting, no answer Call rejected Number changed Non selected user clearing Destination out of order Invalid number forma
PAGE 259
SARA-R4/N4 series - AT Commands Manual Numeric error code 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1600 1560 1561 1612 1613 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1660 UBX-17003787 - R09 Description LLC or SNDCP failure Regular deactivation Reactivation requested Single address bearers only allowed Invalid transaction identifier value APN res
PAGE 260
SARA-R4/N4 series - AT Commands Manual Numeric error code 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1801 1802 1803 1804 1805 1806 1900 1901 1902 1903 1904 1910 1911 1912 1913 1914 1950 1951 1952 2000 3000 4000 4001 Description GPS GPIO not configured GPS GPIO ownership error Invalid operation with GPS ON Invalid operation with GPS OFF Invalid GPS aiding mode Reserved GPS aiding mode GPS aiding mode already set Invalid GPS trace mode Parameter valid only in case of GPS OTA GPS t
PAGE 261
SARA-R4/N4 series - AT Commands Manual Numeric error code 47 50 69 81 95 96 97 98 99 111 127 128 129 130 143 144 145 159 160 161 175 176 192 193 194 195 196 197 198 199 208 209 210 211 212 213 287 290 296 297 300 301 302 303 305 310 311 312 313 314 315 320 321 322 330 UBX-17003787 - R09 Description Resources unavailable, unspecified Requested facility not subscribed Requested facility not implemented Invalid short message reference value Invalid message, unspecified invalid mandatory information Message
PAGE 262
SARA-R4/N4 series - AT Commands Manual Numeric error code 331 332 340 500 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 548 549 555 556 557 558 560 561 562 563 564 565 566 567 UBX-17003787 - R09 Description no network service network timeout no +CNMA acknowledgement expected unknown error Relay Protocol Acknowledgement SMS timer expired SMS forwarding availability failed SMS forwarding availability abort
PAGE 263
SARA-R4/N4 series - AT Commands Manual Numeric error code 568 569 571 572 576 577 579 580 581 583 584 585 586 587 590 591 595 601 604 605 606 608 609 610 612 614 615 616 618 619 620 621 622 623 624 625 626 627 628 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 UBX-17003787 - R09 Description Incompatible By Destination Invalid Transit Network Selection Message Not Compatible With Protocol State Recovery On Timer Expiry Data Call Active Speech Call Active MOC Setup Rejected Due to Missing ACM
PAGE 264
SARA-R4/N4 series - AT Commands Manual Numeric error code 647 649 650 653 654 656 657 658 659 660 661 662 663 664 665 669 670 671 672 674 675 676 677 680 Description Lower Layer Failure From NW Conditional IE Error No Cell Allocation Available Re Establishment Reject Directed Sigconn Re Establishment Release of RRC connection Witout Network Activity(3G) Lower Layer Failure Downlink Lower Layer Failure Uplink Cell Barred Due To Authentication Failure Signalling Connection Release CS Connection Release Trig
PAGE 265
SARA-R4/N4 series - AT Commands Manual Numeric error code 2 Description Resulting from the following commands ENOENT - No such resource (internal error) 4 EINTR - Interrupted system call (internal error) 5 EIO - I/O error (internal error) 9 EBADF - Bad file descriptor (internal error) 10 ECHILD - No child processes (internal error) 11 EWOULDBLOCK / EAGAIN - Current operation would block, try again ENOMEM - Out of memory (internal error) +USOCR, +USOSO, +USOGO, +USOCO, +USOWR, +USOST, +USORD,
PAGE 266
SARA-R4/N4 series - AT Commands Manual Numeric error code 104 Description Resulting from the following commands ECONNRESET - Connection reset by peer 105 ENOBUFS - No buffer space available 106 107 EISCONN - Transport endpoint is already connected ENOTCONN - Transport endpoint is not connected 108 ESHUTDOWN - Cannot send after transport endpoint shutdown 110 111 112 ETIMEDOUT - Connection timed out ECONNREFUSED - Connection refused EHOSTDOWN - Host is down 113 EHOSTUNREACH - No route to host
PAGE 267
SARA-R4/N4 series - AT Commands Manual Description 6 7 8 10 11 12 Resulting from the following commands Socket error class BSD error codes standard All Dynamic Memory error 0 All Wrong FTP API usage (e.g. missing/null parameters) See the Appendix A.6.1 +UFTPC, +UFTP, +UFTPER Wrong HTTP API usage (e.g. missing/null See the Appendix A.6.
PAGE 268
SARA-R4/N4 series - AT Commands Manual Numeric error code 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 226 250 350 421 Description Cannot open FTP data channel Socket invalid parameter Invalid socket No socket available Cannot create socket Cannot bind socket to network interface Cannot resolve hostname Cannot connect socket Cannot get socket name Cannot bind socket to port Socket cannot listen Socket cannot accept Socket would block Soc
PAGE 269
SARA-R4/N4 series - AT Commands Manual Numeric error code 501 502 503 504 530 532 550 552 553 Description Syntax error in parameters or arguments Command not implemented Bad sequence of commands Command not implemented for that parameter User not logged in Need account for storing files Requested action not taken. File unavailable, not found, not accessible Requested file action aborted. Exceeded storage allocation Requested action not taken.
PAGE 270
SARA-R4/N4 series - AT Commands Manual Numeric error code 37 38 39 40 41 42 43 44 45 46 - 72 73 Description Invalid HTTP parameter server path Invalid HTTP parameter server path length Invalid HTTP parameter content filename length Invalid custom content type string Output file open error Output file close error Output file write error Connection lost Operation not allowed in current state Internal error Secure socket connect error A.6.
PAGE 271
SARA-R4/N4 series - AT Commands Manual Numeric error code 5 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 40 41 50 51 60 61 70 71 80 100 110 111 112 113 114 115 116 117 118 120 130 150 151 160 165 166 167 200 201 202 240 241 242 UBX-17003787 - R09 Description Error setting initial Default MQTT values Error creating new MQTT context in response to UMQTT Error in memory allocation for UMQTT command's response Error in UMQTT command number of arguments Error in UMQTT command syntax UMQTT co
PAGE 272
SARA-R4/N4 series - AT Commands Manual Numeric error code 250 251 252 350 360 361 370 371 380 381 390 400 410 411 412 500 501 502 600 601 602 603 604 700 701 702 703 704 1000 Description Error in the MQTT Connect callback's parameters Error in the MQTT Subscribe callback's parameters Error in the MQTT Message callback's parameters Error returned when attempting an MQTT Connection Publish parameter invalid Error Error returned when attempting an MQTT Publish Subscribe parameter invalid Error Error returned
PAGE 273
SARA-R4/N4 series - AT Commands Manual Numeric error code -20007 -20008 -20009 -20010 -20011 -20012 -20021 -20022 -20023 -20024 -20025 -20026 -20027 -20028 -20029 -20030 -20031 -20032 -20033 -20034 -20035 -20036 -20037 -20038 -20039 -20040 -20041 -20042 -20043 -20044 -20045 -20046 -20047 -20048 -20049 -20050 -150001 -150002 -150003 -150004 -150005 -150006 -150007 -150008 -150009 -150010 -150011 -150012 -150013 -150014 -150015 -150016 -150017 UBX-17003787 - R09 Description Handshake successful (QAPI MQTT)
PAGE 274
SARA-R4/N4 series - AT Commands Manual Numeric error code -150018 -150019 -150020 UBX-17003787 - R09 Description End of file (QAPI FS) Invalid ID was passed by the kernel framework (QAPI FS) Unknown error (QAPI FS) A Appendix: Error result codes Page 274 of 307
PAGE 275
SARA-R4/N4 series - AT Commands Manual B Appendix: AT Commands List Call control UBX-17003787 - R09 D S0 SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B A AT command • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 275 of 307
PAGE 276
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 • • • • • • +URDFILE • • • • • • • • • • +URDBLOCK • • • • • • +ULSTFILE SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UDWNFILE +UDELFILE AT command +UDWNBLOCK File System • • • • • • • • • • B Appendix: AT Commands List Page 276 of 307
PAGE 277
SARA-R4/N4 series - AT Commands Manual General commands UBX-17003787 - R09 +CGMI +CGMM +CGMR +CGSN +CIMI +CSCS +GMI +GMM +GMR +GSN A/ I SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CCID AT command • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 277 of 307
PAGE 278
SARA-R4/N4 series - AT Commands Manual GPIO interface UBX-17003787 - R09 +UGPIOR +UGPIOW SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UGPIOC AT command • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 278 of 307
PAGE 279
SARA-R4/N4 series - AT Commands Manual I2C interface UBX-17003787 - R09 +UI2CO +UI2CR +UI2CREGR +UI2CW SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UI2CC AT command • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 279 of 307
PAGE 280
SARA-R4/N4 series - AT Commands Manual Internet suite UBX-17003787 - R09 +UFTP +UFTPC +UFTPER +UHTTP +UHTTPAC +UHTTPC +UHTTPER +USECMNG +USECPRF SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UDNSRN AT command • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 280 of 307
PAGE 281
SARA-R4/N4 series - AT Commands Manual Localization features UBX-17003787 - R09 +UGGGA +UGGLL +UGGSA +UGGSV +UGIND +UGPRF +UGPS +UGRMC +UGSRV +UGTMR +UGUBX +UGVTG +UGZDA +ULOC +ULOCGNSS +ULOCIND SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UGAOS AT command • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 281 of 307
PAGE 282
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 +CMEE +CMER +CPWROFF • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • +UCIND +CIND • • • • • • +CTZU +CFUN SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CCLK AT command +CSGT Mobile equipment control and status • • • • • • • • • • • B Appendix: AT Commands List Page 282 of 307
PAGE 283
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 • • • • +VZWRSRP +VZWRSRQ • • • • • • • • • • +VZWAPNE +URAT • • • • +UMNOPROF • • • • • +UCGED • • • • • • • • • • +UBANDMASK • • • • • • +PACSP • • • • • • +CSQ • • • • • • • • +CREG • • +COPS • +CNUM • +CESQ SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CEDRXS AT command +CEDRXRDP Network service • • • B Appendix: AT Commands List Page 283 of 307
PAGE 284
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 • • • • • • • • H • • • • D* • • • • • • • • • • +UPSD • • • • • • +UDCONF=76 +CGDEL • • • • • • +UDCONF=75 +CGDCONT • • • • • • +UAUTHREQ +CGATT • • • • • • +CGREG +CGACT • • • • • • • • • • +CGPADDR +CEREG SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CEMODE AT command +CGEREP Packet switched data services • • • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 284 of 307
PAGE 285
SARA-R4/N4 series - AT Commands Manual Security UBX-17003787 - R09 +CPIN +CPWD SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CLCK AT command • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 285 of 307
PAGE 286
SARA-R4/N4 series - AT Commands Manual Serial interface UBX-17003787 - R09 &D &F &K &S &V +CMUX +ICF +IFC +IPR E O Q S10 S12 S2 S3 S4 S5 S6 S7 S8 V SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B &C AT command • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •
PAGE 287
SARA-R4/N4 series - AT Commands Manual Serial interface UBX-17003787 - R09 Z \Q SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B X AT command • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 287 of 307
PAGE 288
SARA-R4/N4 series - AT Commands Manual Short Messages Service UBX-17003787 - R09 +CRES • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • +UCMGW +CPMS • • • • • • +UCMGS +CNMI • • • • • • +UCMGR +CNMA • • • • • • +UCMGL +CMSS • • • • • • +CSODCP +CMMS • • • • • • +CSMS +CMGW • • • • • • +CSMP +CMGS • • • • • • +CSCA +CMGR • • • • • • +CSAS +CMGL • • • • • • +CRTDCP +CMGF SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02
PAGE 289
SARA-R4/N4 series - AT Commands Manual SIM functionalities UBX-17003787 - R09 +CSIM +CUSATR +CUSATW +UBIP +UCUSATA +USIMSTAT SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CLAN AT command • • • • • • • • • • • • • • • • • • • • • • • • • • • • B Appendix: AT Commands List Page 289 of 307
PAGE 290
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 • • +UTEST • • • • • • +UTEMP • • • • • • • • +UPSV • • • • • • +ULWM2MSTAT • • • • • • • • +ULWM2M=0 • • • • • +ULGASP • • • • • • +UFWUPD +UCPSMS • • • • • • +UFWINSTALL +UANTR SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +CPSMS AT command +UFOTACONF System features • • • • • • • • B Appendix: AT Commands List Page 290 of 307
PAGE 291
SARA-R4/N4 series - AT Commands Manual UBX-17003787 - R09 +USORD +USORF +USOSEC +USOSO +USOST +USOWR • • • • • • +USOLI • • • • • • +USOGO • • • • • • +USOER +USOCL • • • • • • +USODL +UDCONF=8 • • • • • • +USOCTL +UDCONF=7 • • • • • • +USOCR +UDCONF=6 • • • • • • +USOCO +UDCONF=5 • • • • • • +USOCLCFG +UDCONF=3 SARA R404M-00B R410M-01B R410M-02B R412M-02B R410M-52B N410-02B +UDCONF=2 AT command +UDCONF=1 Internet protocol transport layer • • • • • • • • • • • • • • • •
PAGE 292
SARA-R4/N4 series - AT Commands Manual B.1 Parameters stored in profiles The parameter settings of some commands can be stored in the profiles available in the memory module. SARA-R4 / SARA-N4 To partially display these profiles, see the AT&V command description. Not all the parameter setting are displayed through AT&V command.
PAGE 293
SARA-R4/N4 series - AT Commands Manual AT command Description V DCE response format Result code selection No and call progress monitoring control X AT interface configuration sharing No Factory-programmed value / Remarks 1 (Verbose response text) 4 (CONNECT result code is given upon entering online data state; dial tone and busy detection are both enabled) B.
PAGE 294
SARA-R4/N4 series - AT Commands Manual AT command Description Factory-programmed value / Comment o : 60 (NVM update frequency in seconds) o : 1 (number of times to transmit the Last Gasp message) +ULOCGNSS Configure GNSS sensor • +UPSD +URAT Packet switched data Selection of Radio Access Technology +USIMSTAT (U)SIM initialization status reporting Configure Dormant Close Socket Behavior Edit Verizon wireless APN table +USOCLCFG +VZWAPNE 15 (Local aiding, AssistNow online, A
PAGE 295
SARA-R4/N4 series - AT Commands Manual Category Estimated response maximum time to get Commands Internet suite (socket connect with SSL) Internet suite (socket write) Internet suite (UDP socket write) Internet suite (socket closure) Internet suite • SARA-R4 / SARA-N4 - < 1 s +USOSEC • SARA-R4 / SARA-N4 - < 120 s +USOWR • SARA-R4 / SARA-N4 - < 10 s +USOST • SARA-R4 / SARA-N4 - < 120 s +USOCL • SARA-R4 / SARA-N4 - < 1 s Resolve name/IP number < 70 s (except URC) through DNS GNSS commands <
PAGE 296
SARA-R4/N4 series - AT Commands Manual AT command UART / AUX UART (where available) +ICF Effective +IFC Effective +IPR Effective +UPSV Effective Multiplexer Returns OK, but it is not effective (only change the value in the AT command profile) When it returns OK (the configuration is allowed), it is effective Returns OK, but it is not effective (only change the value in the AT command profile) Returns OK, but it changes UART setting USB (where available) SPI (where available) change the value
PAGE 297
SARA-R4/N4 series - AT Commands Manual C Appendix: UDP Direct Link workflow C.1 Data from the IP network to the external port When a UDP data packet is received from the network, its payload is forwarded through the external port as soon as possible (according to the HW flow control, if any). Data from IP netw ork Forw ard it to external port (according with HW flow control, if any) Figure 10: Workflow of data from the IP network to the external port C.
PAGE 298
SARA-R4/N4 series - AT Commands Manual Event: new data from external port Reset sending timer New data + data into intermediate buffer is < than max_packet_size ? YES Put data into intermediate buffer and w ait sending timer expires or new data Finish, event handled NO Send max_packet_size of data to IP netw ork YES YES Remaining data is >= max packet size? Event: sending timer expires NO Is there any data? Is there any data into the intermediate buffer? NO YES Send data to IP netw ork NO Fi
PAGE 299
SARA-R4/N4 series - AT Commands Manual D Appendix: Glossary 2G 3G 3GPP ADC AIeC ADN AMR AP APN ASCII AT BL BSD CB CBM CLI CLIP CLIR COLP COLR CM CPHS CR CS CSD CSG CTS CUG DA DARP DCD DCE DCM DHCP DNS DSR DTE, TE DTMF DTR DUT EARFCN eCall EEP EF EFCGST EFHNBN EFPLMNwAcT eIM EONS EPD ETSI E-UTRAN FDN UBX-17003787 - R09 2nd Generation 3rd Generation 3rd Generation Partnership Project Analog to Digital Converter Automatically Initiated eCall Abbreviated Dialing Numbers Adaptive Multi Rate Access Point Acces
PAGE 300
SARA-R4/N4 series - AT Commands Manual FOAT FOTA FS FTP FW FWINSTALL GAS GPIO GPRS GPS GSM HDLC HNB HPLMN HTTP I I2C I2S ICCID ICMP ICP IMEI IMSI InBM IP IRA IRC ISDN ISP IVS L3 LCP LF LNS M2M MCC ME MIeC MMI MN MNC MNO MO MS MSD MSIN MSISDN MSPR MT MWI NITZ NVM ODIS OLCM PAD P-CID UBX-17003787 - R09 Firmware Over AT Firmware Over The Air File System File Transfer Protocol Firmware Firmware Install Grouping information Alpha String General Purpose Input Output General Packet Radio Service Global Position
PAGE 301
SARA-R4/N4 series - AT Commands Manual PCN PDP PDU PIN PLMN PPP PSAP PSD PUK QoS RAM RDI RFU RNDIS RI RTC RTP RTS Rx SAP SC SI SIP SIM SMS SMSC SMTP SoR SDIO STA SSID TA TCP TE TFT TP Tx TZ UCS2 UDI UDP UI UICC UIH URC USIM UTRAN UUS1 WLAN UBX-17003787 - R09 Personal Communication Network Packet Data Protocol Protocol Data Unit Personal Identification Number Public Land Mobile Network Point-to-Point Protocol Public Safety Answering Point (eCall related) Packet-Switched Data Personal Unblocking Key Qualit
PAGE 302
SARA-R4/N4 series - AT Commands Manual Related documents 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. Stevens. TCP/IP Illustrated Volume1 & 2 Addison-Wesley, 1994. 3GPP TS 27.007 - Technical Specification Group Core Network and Terminals; AT command set for User Equipment (UE) 3GPP TS 22.004 - General on supplementary services GSM 02.
PAGE 303
SARA-R4/N4 series - AT Commands Manual 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. 71. 72. 73. 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. GSM 04.60 - Digital cellular telecommunications system (Phase 2+); General Packet Radio Service (GPRS); Mobile Station (MS) - Base Station System (BSS) interface; Radio Link Control / Medium Access Control (RLC/MAC) protocol 3GPP TS 05.
PAGE 304
SARA-R4/N4 series - AT Commands Manual 84. 85. 86. 87. 88. 89. 90. 91. 92. 93. 94. 95. 96. 97. 98. 99. 100. 101. 102. 103. 104. 105. 106. 107. 108. 109. 110. 111. 112. 113. 114. 115. 116. 117. 118. 119. 120. 121. 122. 3GPP TS 51.010-2 Mobile Station (MS) conformance specification; Part 2: Protocol Implementation Conformance Statement (PICS) proforma specification 3GPP TS 34.
PAGE 305
SARA-R4/N4 series - AT Commands Manual 123. 124. 125. 126. 127. 128. 129. 130. 131. 132. 133. 134. 135. 136. 137. 138. 139. 140. 141. 142. 143. 144. 145. 146. 147. 148. 149. 150. 151. 152. 153. 154. 155. 156. 157. 158. RFC 3966 - The tel URI for Telephone Numbers RFC 2141 - URN Syntax RFC 3406 - Uniform Resource Names (URN) Namespace Definition Mechanisms RFC 5031 - A Uniform Resource Name (URN) for Emergency and Other Well-Known Services 3GPP TS 22.
PAGE 306
SARA-R4/N4 series - AT Commands Manual Revision history Revision R01 R02 R03 R04 R05 R06 Date 27-Jan-2017 03-Apr-2017 04-May-2017 24-May-2017 19-Jul-2017 30-Oct-2017 Name jole jole jole jole jole Comments Initial release Removed +UPSV. Added +CPSMS. General document clean-up Added SARA-R410M Moved to Advance Information for SARA-R404M Extended document applicability to SARA-R410M-02B. jole Added +ULWM2M, +ULWM2MSTAT and +CNUM. Changed +CPSMS back to it's original 3GPP definition.
PAGE 307
SARA-R4/N4 series - AT Commands Manual Contact For complete contact information, visit us at www.u-blox.com. u-blox Offices North, Central and South America Headquarters Asia, Australia, Pacific Europe, Middle East, Africa u-blox America, Inc. Phone: +1 703 483 3180 E-mail: info_us@u-blox.com u-blox AG Phone: +41 44 722 74 44 E-mail: info@u-blox.com Support: support@u-blox.com u-blox Singapore Pte. Ltd. Phone: +65 6734 3811 E-mail: info_ap@u-blox.com Support: support_ap@u-blox.