Ublox SARA-R4 Series Command Manual
Ublox SARA-R4 Series Command Manual

Ublox SARA-R4 Series Command Manual

Size-optimized lte cat m1 / nb1 / gprs modules. at commands
Hide thumbs Also See for SARA-R4 Series:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SARA-R4 Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Ublox SARA-R4 Series

  • 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.com UBX-17003787 - R09...
  • 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 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 Type number Modem version Application version PCN reference SARA-R404M SARA-R404M-00B-00 K0.0.00.00.07.06 N.A. UBX-17047084 SARA-R410M SARA-R410M-01B-00 L0.0.00.00.02.03 N.A. UBX-17051617 SARA-R410M-02B-00 L0.0.00.00.05.06 A02.00 UBX-18010263 SARA-R410M-52B-00 L0.0.00.00.06.04 A02.05 UBX-18020937 SARA-R412M SARA-R412M-02B-00...
  • 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.
  • Page 6: Table Of Contents

    SARA-R4/N4 series - AT Commands Manual Contents 1    AT command settings......................11 1.1        Definitions................................11 1.2    Storing of AT commands setting........................ 14 1.3    S-parameters..............................14 2    General operation......................16 2.1    Start up and initialization..........................16 2.2    AT commands types............................16 3    IPC - Inter Processor Communication................19 3.1    Multiplexing mode +CMUX..........................19 4 ...
  • 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........................59 7.15    Band selection bitmask +UBANDMASK....................60 8        Security..........................62 8.1    Enter PIN +CPIN.............................. 62 8.2    Facility lock +CLCK............................63 8.3    Change password +CPWD...........................
  • Page 8 SARA-R4/N4 series - AT Commands Manual 10.25    Set to factory defined configuration &F....................110 10.26    Display current configuration &V......................110 11    SIM management......................112 11.1    Generic SIM access +CSIM......................... 112 11.2    Read the SIM language +CLAN......................... 112 11.3    SIM states reporting +USIMSTAT......................113 12    SIM toolkit........................115 12.1    Introduction..............................115 12.2    Bearer Independent Protocol status indication +UBIP.................115 12.3    Read the USAT profile +CUSATR......................116 12.4    Write the USAT profile +CUSATW......................117 12.5    Enable USAT terminal URCs +UCUSATA....................
  • Page 9 SARA-R4/N4 series - AT Commands Manual 16.8    File system limits............................177 17        DNS........................... 178 17.1    Resolve name / IP number through DNS +UDNSRN................178 18    Internet protocol transport layer................180 18.1    Introduction..............................180 18.2    IPv4/IPv6 addressing..........................180 18.3    Create Socket +USOCR..........................181 18.4    SSL/TLS mode configuration on TCP socket +USOSEC..............182 18.5    Set socket option +USOSO........................
  • Page 10 SARA-R4/N4 series - AT Commands Manual 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....................237 22.17    Localization information request status unsolicited indication +ULOCIND........ 240 22.18    GNSS sensor configuration +ULOCGNSS................... 241 23 ...
  • Page 11: 1    At Command Settings

    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.
  • 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 "+"...
  • Page 14: Storing Of At Commands Setting

    SARA-R4/N4 series - AT Commands Manual Verbose Numeric 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. Command aborted 3000 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...
  • Page 15 SARA-R4/N4 series - AT Commands Manual AT command S Number 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 <parameter_number>...
  • Page 16: 2    General Operation

    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.
  • 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.
  • 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.
  • Page 19: 3    Ipc - Inter Processor Communication

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +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 Description This parameter is ignored and the value 0 is always displayed in case of read command. <N1> Number Maximum frame size: • Allowed range is 1-1509. • The default value is 31. <T1> Number Acknowledgement timer in units of ten milliseconds.
  • Page 21: 4    General

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 4.1.1    Description Text string identifying the manufacturer. 4.1.2    Syntax Type Syntax Response Example...
  • Page 22: Model Identification +Cgmm

    SARA-R4/N4 series - AT Commands Manual 4.3    Model identification +CGMM +CGMM Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 4.3.1    Description Text string identifying the model identification. 4.3.2    Syntax Type Syntax Response Example...
  • Page 23: Firmware Version Identification +Gmr

    SARA-R4/N4 series - AT Commands Manual 4.5.2    Syntax Type Syntax Response Example Action AT+CGMR <version> 11.40 Test AT+CGMR=? 4.5.3    Defined values Parameter Type Description <version> String Firmware version 4.6    Firmware version identification +GMR +GMR Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference...
  • Page 24: Imei Identification +Gsn

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <snt> Number It indicates the requested serial number type. Depending on <snt> value, the <sn> parameter in the information text response provides different information: • 0 (default value): International Mobile station Equipment Identity (IMEI) •...
  • Page 25: Te Character Set Configuration +Cscs

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Modem and application version <modem_version>,<applications_ ATI9 request version> 29.90,A01.00 ATI9 4.9.3    Defined values Parameter Type Description <type_number> String Product type number <modem_version> String Module modem version <applications_ String Module application version. Where not applicable the module provides "Undefined" version>...
  • Page 26: International Mobile Subscriber Identification +Cimi

    SARA-R4/N4 series - AT Commands Manual 4.11    International mobile subscriber identification +CIMI +CIMI Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 4.11.1    Description Request the IMSI (International Mobile Subscriber Identity). 4.11.2    Syntax Type Syntax...
  • Page 27: Repeat Last Command A

    SARA-R4/N4 series - AT Commands Manual 4.13    Repeat last command A/ Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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.
  • Page 28: 5    Mobile Equipment Control And Status

    SARA-R4/N4 series - AT Commands Manual 5    Mobile equipment control and status 5.1    Module switch off +CPWROFF +CPWROFF Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 40 s +CME Error 5.1.1    Description Switches off the MT.
  • Page 29 SARA-R4/N4 series - AT Commands Manual 5.2.3    Defined values Parameter Type Description <fun> Number 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 •...
  • Page 30: Indicator Control +Cind

    SARA-R4/N4 series - AT Commands Manual 5.3    Indicator control +CIND +CIND Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +CME Error 5.3.1    Description Provides indication states related to network status, battery information and so on. The set command does not allow setting the values for those indications which are set according to module state (see <descr>...
  • Page 31: Configuration Of Indicator Control +Ucind

    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 0: SMS storage not full 1: SMS storage full • "gprs": PS indication status: 0: no PS available in the network 1: PS available in the network but not registered 2: registered to PS 65535: indication not available...
  • Page 32: Mobile Termination Event Reporting +Cmer

    SARA-R4/N4 series - AT Commands Manual 5.4.3    Defined values Parameter Type Description <conf> Number 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 <descr> parameter of +CMER). The least significant bit is used for the first indicator.
  • Page 33 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <bfr> Number • 0: MT buffer of URCs defined within this command is cleared when <mode> 1...3 is entered • 1: MT buffer of URCs defined within this command is flushed to the DTE when <mode>...
  • Page 34: Clock +Cclk

    SARA-R4/N4 series - AT Commands Manual 5.6    Clock +CCLK +CCLK Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +CME Error 5.6.1    Description Sets and reads the real-time clock of the MT. 5.6.2    Syntax Type Syntax...
  • Page 35: Automatic Time Zone Update +Ctzu

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CSGT=? +CSGT: (list of supported <mode>s), +CSGT: (0-1),49 <ltext> 5.7.3    Defined values Parameter Type Description <text> String Greeting text. The factory-programmed value is the empty string. <mode> Number • 0: turn off the greeting text •...
  • Page 36: Report Mobile Termination Error +Cmee

    SARA-R4/N4 series - AT Commands Manual 5.9    Report mobile termination error +CMEE +CMEE Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 5.9.1    Description Configures the formatting of the result code +CME ERROR: <err> as an indication of an error relating to the functionality of the MT.
  • Page 37: 6    Call Control

    SARA-R4/N4 series - AT Commands Manual 6    Call control 6.1    Dial command D Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full Up to 3 min +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.030 [5] and initiates the indicated kind of call.
  • Page 38: Call Answer A

    SARA-R4/N4 series - AT Commands Manual 6.2    Call answer A Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 20 s +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.
  • 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 <value> parameter of &D command is not set to 2, the DTR state has no impact on autoanswering. 6.4.2    Syntax Type Syntax Response Example...
  • Page 40: 7    Network Service

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +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.
  • Page 41 SARA-R4/N4 series - AT Commands Manual 7.2.2    Syntax Type Syntax Response Example Action AT+CSQ +CSQ: <rssi>,<qual> +CSQ: 2,5 Test AT+CSQ=? +CSQ: (list of supported <rssi>s), +CSQ: (0-31,99),(0-7,99) (list of supported <qual>s) 7.2.3    Defined values Parameter Type Description <rssi> Number The allowed range is 0-31 and 99. Remapped indication of the following parameters: •...
  • Page 42: Extended Signal Quality +Cesq

    SARA-R4/N4 series - AT Commands Manual 7.3    Extended signal quality +CESQ +CESQ Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 7.3.1    Description Returns the received signal quality and level: •...
  • Page 43: Operator Selection +Cops

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 255: not known or not detectable <rsrp> Number 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 •...
  • 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.
  • Page 45: Radio Access Technology (Rat) Selection +Urat

    SARA-R4/N4 series - AT Commands Manual SARA-R410M-01B / SARA-R410M-02B • <AcT>=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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +CME Error...
  • Page 46: Network Registration Status +Creg

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 8: LTE CAT-NB1 • 9: eGPRS <PreferredAct> Number Indicates the preferred access technology; it is ignored if dual mode or tri mode are not selected. • 0: GSM • 2: UTRAN • 3: LTE •...
  • Page 47 SARA-R4/N4 series - AT Commands Manual The parameters <AcTStatus>, <lac>, <ci> are provided only if available. The read command provides the same information issued by the URC together with the current value of the <n> parameter. The location information elements <lac>, <ci> and <AcTStatus>, if available, are returned only when <n>=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 <AcTStatus> value is invalid 7.6.4    Notes The following is an overview of the values assumed by the <stat> parameter: •...
  • Page 49: Network Selection Control +Pacsp

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 7.7.1    Description If the EF (Customer Service Profile) is available the +PACSP URC is provided in the following cases: •...
  • 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 <rat> parameter value. Table 4 lists the supported <mode> parameter values: Channel <mode>=0 <mode>=2 <mode>=3 <mode>=5 SARA-N4 SARA-R4 Table 4: <mode>...
  • Page 51 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example <mode>= 2, <rat>= 5: +UCGED: 2 +UCGED: 2 5,<svc> <mode>= 0: +UCGED: MODE_5_DISABLED +UCGED: MODE_5_DISABLED <mode>= 5: +RSRP: 162,5110,"-075.00", +RSRP: <P-CID>,<earfcn>, +RSRQ: 162,5110,"-14.20", "<RSRP>", +RSRQ: <P-CID>,<earfcn>, "<RSRQ>", Test AT+UCGED=? +UCGED: (list of supported +UCGED: (0,2) <mode>s) 7.8.3    Defined values...
  • Page 52 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <Grac> Number One byte routing area of the GERAN cell in hexadecimal format; FF if not known or not detectable. <rxlev> Number GERAN cell Received Signal Strength Indicator (RSSI) index as defined in 3GPP TS 45.008 [28]: •...
  • Page 53 SARA-R4/N4 series - AT Commands Manual Parameter Type 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 <Wspeech_mode> Number Reports the latest obtained value of the UMTS speech code. Allowed values: •...
  • Page 54: Edit Verizon Wireless Apn Table +Vzwapne

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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 <RI>...
  • Page 55 SARA-R4/N4 series - AT Commands Manual 7.9.2    Syntax Type Syntax Response Example AT+VZWAPNE=<wapn>,<apncl>, AT+VZWAPNE=1,1,"VZWIMS", <apnni>,<apntype>,<apnb>, "IPv6","LTE","Enabled",0 <apned>,<apntime> Read AT+VZWAPNE? [+VZWAPNE: <apncl>,<apnni>, +VZWAPNE: 1,"VZWIMS","IPv4v6", <apntype>,<apnb>,<apned>, "LTE","Enabled",0 <apntime> [..]] +VZWAPNE: 2,"VZWADMIN", "IPv4v6","LTE","Enabled",0 Test AT+VZWAPNE=? +VZWAPNE: (list of supported +VZWAPNE: (0-4),(1-4),,("IPv6", <wapn>s),(list of supported "IPv4v6"),("LTE"),("Enabled", <apncl>s),,(range of supported "Disabled"),(0-1023) <apntype>s),range of supported <apnb>s),(list of supported...
  • Page 56: Read Rsrp Values +Vzwrsrp

    SARA-R4/N4 series - AT Commands Manual 7.10    Read RSRP values +VZWRSRP +VZWRSRP Modules SARA-R404M Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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 Syntax...
  • Page 57: Edrx Setting +Cedrxs

    SARA-R4/N4 series - AT Commands Manual 7.12    eDRX setting +CEDRXS +CEDRXS Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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: Edrx Read Dynamic Parameters +Cedrxrdp

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <Paging_time_ String The paging time window refers to bit 8 to 5 of octet 3 of the extended DRX window> 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].
  • Page 59: Set Mno Profile +Umnoprof

    SARA-R4/N4 series - AT Commands Manual 7.14    Set MNO profile +UMNOPROF +UMNOPROF Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 7.14.1    Description Automatically configures the module to be compliant to the requirements of various Mobile Network Operators.
  • Page 60: Band Selection Bitmask +Ubandmask

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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: 8    Security

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +CME Error 8.1.1    Description Enter PIN. If no PIN request is pending, the corresponding error code is returned. If a wrong PIN is given three times, the PUK must be inserted in place of the PIN, followed by the <newpin>...
  • Page 63: Facility Lock +Clck

    SARA-R4/N4 series - AT Commands Manual AT+COPS=0 ERROR • To change the PIN the user must use the AT+CPWD="SC",<old_pin>,<new_pin> command (see Chapter for details). Example: AT+CPWD="SC","1234","4321" 8.2    Facility lock +CLCK +CLCK Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full...
  • Page 64: Change Password +Cpwd

    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 <mode>=0) • "AG": All outGoing barring services (applicable only for <mode>=0) •...
  • Page 65 SARA-R4/N4 series - AT Commands Manual 8.3.3    Defined values Parameter Type Description <fac> String "P2" SIM PIN2; see the +CLCK command description for other values <oldpwd> String Old password <newpwd> String New password <pwdlength> Number 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: 9    Short Messages Service

    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.
  • Page 67: Preferred Message Storage +Cpms

    SARA-R4/N4 series - AT Commands Manual 9.2.2    Syntax Type Syntax Response Example AT+CSMS=<service> +CSMS: <mt>,<mo>,<bm> AT+CSMS=1 +CSMS: 1,1,1 Read AT+CSMS? +CSMS: <service>,<mt>,<mo>, +CSMS: 0,1,1,1 <bm> Test AT+CSMS=? +CSMS: (list of supported +CSMS: (0-1) <service>s) 9.2.3    Defined values Parameter Type Description <service> Number • 0: see 3GPP TS 23.040 [8] and 3GPP TS 23.041 [9]; syntax of AT commands is compatible with 3GPP TS 27.005 [16] phase 2;...
  • Page 68: Preferred Message Format +Cmgf

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Read AT+CPMS? +CPMS: <mem1>,<used1>,<total1>, +CPMS: "MT",4,350,"MT",4,350, <mem2>,<used2>,<total2>, "MT",4,350 <mem3>,<used3>,<total3> Test AT+CPMS=? +CPMS: (list of supported +CPMS: ("MT","ME","SM","BM", <mem1>s),(list of supported "SR"),("MT","ME","SM"),("MT","ME", <mem2>s),(list of supported "SM") <mem3>s) 9.3.3    Defined values Parameter Type Description <mem1> String Memory used to read and delete messages.
  • Page 69: Save Settings +Csas

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CMGF=? +CMGF: (list of supported <mode>s) +CMGF: (0-1) 9.4.3    Defined values Parameter Type Description <mode> Number Indicates the format of messages used with send, list, read and write commands and URCs resulting from receiving SMSes messages: •...
  • Page 70: New Message Indication +Cnmi

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CRES=? +CRES: (list of supported <profile>s) +CRES: (0) 9.6.3    Defined values Parameter Type Description <profile> Number Specific SMS profile index from where to read the message service settings 9.7    New message indication +CNMI +CNMI Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M...
  • Page 71 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Text mode (+CMGF=1): +CBM: 271,1025,1,1,1 +CBM: <sn>,<mid>,<dcs>,<page>, The quick brown fox jumps over the <pages><CR><LF><data> lazy dog 0123456789 PDU mode (+CMGF=0): +CBM: <length><CR><LF><pdu> +CDSI: <mem>,<index> +CDSI: "MT",2 Text mode (+CMGF=1): +CDS: 6,202,"+393492323583",145, "14/07/25,13:07:16+02","14/07/25, +CDS: <fo>,<mr>,[<ra>],[<tora>], 16:35:44+02",0...
  • Page 72 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <mem> String Same as defined in +CPMS Defined Values <index> Number Storage position <length> Number Two meanings: • in text mode: number of characters • in PDU mode: PDU's length in octets without the Service Center's address. In example: 039121430100038166F6000004E374F80D: this is a PDU with Service Center's number +1234, that generates the address 03912143 (4 octets).
  • Page 73: Read Message +Cmgr

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 3: secret <callback_number> String Callback number <encoding> Number Text encoding: • 2: ASCII7 • 3: IA5 • 4: UCS2 • 8: ISO 8859-1 • 9: GSM7 <num_sms> Number Total number of SMS <part>...
  • Page 74 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example SMS-COMMAND +CMGR: <stat>,<fo>,<ct>[,<pid>, [<mn>],[<da>],[<toda>],<length> [<cdata>]] CBM storage +CMGR: <stat>,<sn>,<mid>,<dcs>, <page>,<pages> <data> PDU mode (+CMGF=0): +CMGR: <stat>,[<alpha>],<length> AT+CMGR=1 AT+CMGR=<index> <pdu> +CMGR: 1,,40 0791934329002000040 C9193230982661400008070 328045218018D4F29CFE0 6B5CBF379F87C4EBF41E4340 82E7FDBC3 Test AT+CMGR=? 9.8.3    Defined values Parameter Type Description <index>...
  • Page 75: New Message Acknowledgement To Mt +Cnma

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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;...
  • Page 76: List Message +Cmgl

    SARA-R4/N4 series - AT Commands Manual The MT shall automatically disable routing to the TE by setting both <mt> and <ds> 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: <err>...
  • Page 77 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Command successful and SMS-SUBMITs: +CMGL: <index>,<stat>,<da>, [<alpha>],[<toda>, <length>] <data> [+CMGL: <index>,<stat>, <da>,[<alpha>],[<toda>, <length>]<data>[...]] Command successful and SMS-STATUS-REPORTs: +CMGL: <index>,<stat>,<fo>,<mr>, [<ra>],[<tora>],<scts>,<dt>,<st> [+CMGL: <index>,<stat>,<fo>,<mr>, [<ra>],[<tora>],<scts>,<dt>,<st> [...]] Command successful and SMS-COMMANDs: +CMGL: <index>,<stat>,<fo>,<ct> [+CMGL: <index>,<stat>,<fo>, <ct>[...]] Command successful and CBM storage:...
  • Page 78 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <alpha> String Alphanumeric representation of <da> or <oa> corresponding to the entry found in the phonebook 3GPP TS 24.008 [12]. The parameter is not managed. <scts> String Service center time stamp in time-string format; see the <dt> parameter <tooa>...
  • Page 79: Send Message +Cmgs

    SARA-R4/N4 series - AT Commands Manual 9.11    Send message +CMGS +CMGS Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full 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).
  • Page 80: Write Message To Memory +Cmgw

    SARA-R4/N4 series - AT Commands Manual 9.12    Write message to memory +CMGW +CMGW Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full <10 s +CMS Error 9.12.1    Description Stores a message (SMS-DELIVER or SMS-SUBMIT) to memory storage <mem2> and returns the memory location <index>...
  • Page 81: Send Message From Storage +Cmss

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description number +1234, that generates the address 03912143 (4 octets). Thus in this case <length>=13. <PDU> String 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.13    Send message from storage +CMSS +CMSS...
  • Page 82: Delete Message +Cmgd

    SARA-R4/N4 series - AT Commands Manual 9.14.2    Syntax Type Syntax Response Example AT+CSMP=<fo>,<vp>[,<pid>[, AT+CSMP=17,167,0,0 <dcs>]] Read AT+CSMP? +CSMP: <fo>,<vp>,<pid>,<dcs> +CSMP: 17,167,0,0 Test AT+CSMP=? 9.14.3    Defined values Parameter Type Description <fo> Number First octet of the SMS TPDU (see 3GPP TS 23.040 [8]) <vp> Number Format depending on the values of the bit3/bit4 of the <fo>...
  • Page 83: Service Center Address +Csca

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CMGD=? +CMGD: (list of supported +CMGD: (1-350),(0-4) <index>s),(list of supported <flag>s) 9.15.3    Defined values Parameter Type Description <index> Number Storage position <flag> Number Deletion flag. If present, and different from 0, the <index> parameter is ignored: •...
  • Page 84: Read Concatenated Message +Ucmgr

    SARA-R4/N4 series - AT Commands Manual 9.17    Read concatenated message +UCMGR +UCMGR Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full <10 s +CMS Error 9.17.1    Description Returns the message with location value <index> from message storage <mem1> to the DTE and shows additional information when the message is a segment of a concatenated one: •...
  • Page 85 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+UCMGR=? 9.17.3    Defined values Parameter Type Description <index> Number Storage position <stat> String Indicates the status of message in memory: • "REC UNREAD": received unread SMS • "REC READ": received read SMS •...
  • Page 86: List Concatenated Message +Ucmgl

    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] <vp> Validity period value 0 to 143 (TP-VP + 1) x 5 minutes (i.e.
  • Page 87 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example <length>][,<seq>,<max>,<iei>, +UCMGL: 305,"REC READ","+39340 <ref>]<data>[...]] 1234999",,"08/08/06,10:01:40+08", 145,29,2,2,8,32767 ssion is strictly prohibited. SMS-SUBMITs: +UCMGL: <index>,<stat>,<da>, [<alpha>],[<toda>, <length>][, <seq>,<max>,<iei>,<ref>] <data> [+UCMGL: <index>,<stat>,<da>, [<alpha>],[<toda>,<length>][,<seq>, <max>,<iei>,<ref>]<data>[...]] SMS-STATUS-REPORTs: +UCMGL: <index>,<stat>,<fo>, <mr>,[<ra>],[<tora>],<scts>,<dt>, <st> [+UCMGL: <index>,<stat>,<fo>, <mr>,[<ra>],[<tora>],<scts>,<dt>, <st> [...]] SMS-COMMANDs: +UCMGL: <index>,<stat>,<fo>,<ct>...
  • Page 88 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <iei> Number 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 <ref> Number Concatenated short message reference number: •...
  • Page 89: Send Concatenated Message +Ucmgs

    SARA-R4/N4 series - AT Commands Manual 9.19    Send concatenated message +UCMGS +UCMGS Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full 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).
  • Page 90: Write Concatenated Message To Memory +Ucmgw

    SARA-R4/N4 series - AT Commands Manual 9.20    Write concatenated message to memory +UCMGW +UCMGW Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +CMS Error 9.20.1    Description Stores one segment of a concatenated message (SMS-DELIVER or SMS-SUBMIT) to memory storage <mem2>...
  • Page 91: More Messages To Send +Cmms

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <max> Number Maximum number of short messages in the concatenated short message (1-255) <iei> Number 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 <ref>...
  • Page 92: Terminating Data Reporting Via Control Plane +Crtdcp

    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.2    Syntax Type Syntax Response Example AT+CSODCP=<cid>,<cpdata_ AT+CSODCP=1,3,"AA11BB" length>,<cpdata>[,<RAI>[,<type_of_ user_data>]] Test AT+CSODCP=? +CSODCP: (range of supported +CSODCP: (0-10),(512),(0,1,2),(0,1) <cid>s),(maximum number of bytes of the <cpdata_length>),(list of...
  • Page 93 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example +CRTDCP: <cid>,<cpdata_length>, +CRTDCP: 0,2,"ab" <cpdata> 9.23.3    Defined values Parameter Type Description <reporting> Number • 0 (default value): reporting disabled • 1: reporting enabled by means of the URC +CRTDCP <cid> Number <cid> <cpdata_length> Number Size of the received data.
  • Page 94: 10    V24 Control And V25Ter

    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).
  • Page 95 SARA-R4/N4 series - AT Commands Manual 10.3.3    Defined values Parameter Type Description <value> Number • 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 •...
  • Page 96: Dsr Override &S

    SARA-R4/N4 series - AT Commands Manual 10.4    DSR override &S &S Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full Profile +CME Error 10.4.1    Description Selects how the module will control RS232 circuit 107 - Data Set Ready (DSR). 10.4.2    Syntax Type Syntax...
  • Page 97 SARA-R4/N4 series - AT Commands Manual • Set the <value> 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.
  • Page 98: Dte-Dce Character Framing +Icf

    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. The module with software flow control active during a PPP session, discards these characters after modifying the flow control state (stopping or starting its own transmit process) and does not include them in any part of the received data or CRC calculation;...
  • Page 99: Dte-Dce Local Flow Control

    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 <parity>...
  • Page 100: Set Flow Control \Q

    SARA-R4/N4 series - AT Commands Manual 10.7.3    Defined values Parameter Type Description <DCE_by_DTE> Number • 0: none • 1: DC1/DC3 on circuit 103 (XON/XOFF) • 2 (default and the factory-programmed value): circuit 105 (RTS) <DTE_by_DCE> Number • 0: none • 1: DC1/DC3 on circuit 104 (XON/XOFF) •...
  • Page 101: Uart Data Rate Configuration +Ipr

    SARA-R4/N4 series - AT Commands Manual 10.9    UART data rate configuration +IPR +IPR Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial Profile +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: Return To On-Line Data State O

    SARA-R4/N4 series - AT Commands Manual 10.10    Return to on-line data state O Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 10.10.1    Description Causes the DCE to return to online data state and issue a CONNECT or CONNECT <text> (based on command) intermediate result code on DTE.
  • Page 103: Command Line Termination Character S3

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example 10.11.3    Defined values Parameter Type Description <value> Number 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 •...
  • Page 104: Response Formatting Character S4

    SARA-R4/N4 series - AT Commands Manual 10.13    Response formatting character S4 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial Profile +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: Pause Before Blind Dialling S6

    SARA-R4/N4 series - AT Commands Manual 10.15    Pause before blind dialling S6 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +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: Command Dial Modifier Time S8

    SARA-R4/N4 series - AT Commands Manual 10.17    Command dial modifier time S8 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +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.
  • Page 107: Escape Prompt Delay (Epd) S12

    SARA-R4/N4 series - AT Commands Manual 10.19    Escape prompt delay (EPD) S12 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +CME Error 10.19.1    Description Defines the maximum period, in fiftieths of a second, allowed between the reception of the last character of the sequence of three escape characters from the DTE and the sending of the OK result code to the DTE.
  • Page 108: Result Code Suppression Q

    SARA-R4/N4 series - AT Commands Manual 10.21    Result code suppression Q Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full Profile +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: Result Code Selection And Call Progress Monitoring Control X

    SARA-R4/N4 series - AT Commands Manual 10.23    Result code selection and call progress monitoring control X Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full Profile +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 Syntax...
  • Page 110: Set To Factory Defined Configuration &F

    SARA-R4/N4 series - AT Commands Manual 10.25    Set to factory defined configuration &F &F Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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...
  • Page 112: 11    Sim Management

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 11.1.1    Description Allows direct control of the SIM by a distant application on the TE. This command transparently transmits the <command>...
  • Page 113: Sim States Reporting +Usimstat

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CLAN=? 11.2.3    Defined values Parameter Type Description <code> String 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.3    SIM states reporting +USIMSTAT +USIMSTAT Modules...
  • 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 • <state>=9 and 10 will not be reported when dedicated (+CFUN=6) or raw (+CFUN=9) mode is active. • Table 9 provides the meaning of each bit with the corresponding state: States reported...
  • Page 115: 12    Sim Toolkit

    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.
  • Page 116: Read The Usat Profile +Cusatr

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 2: OPEN CHANNEL, CLOSE CHANNEL and CHANNEL STATUS EVENT status indications enabled <ev_cmd> Number Indicates the event download's tag or proactive command's tag. Allowed values: • 10: Channel status event • 64: Open channel proactive command •...
  • Page 117: Write The Usat Profile +Cusatw

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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 Syntax Response Example Test AT+UCUSATA=? +UCUSATA: (list of supported +UCUSATA: (0-3) <active_URC>s) +CUSATP: <proactive_command> +CUSATEND 12.5.3    Defined values Parameter Type Description <active_URC> Number URC enabling/disabling. Allowed values: • 0 (default value): disables all USAT URCs • 1: enables the +CUSATEND URC •...
  • Page 119: 13    Packet Switched Data Services

    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.
  • Page 120 SARA-R4/N4 series - AT Commands Manual 13.1.3    Parameter definition 13.1.3.1    <APN> 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.
  • Page 121: Ppp Lcp Handshake Behaviour

    SARA-R4/N4 series - AT Commands Manual 13.2    PPP LCP handshake behaviour When a data call is initiated by means of 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 Example 13.3.3    Defined values Parameter Type Description <cid> Number <cid> <PDP_type> String <PDP_type> <APN> String <APN> <PDP_addr> Number <PDP_addr> <d_comp> Number PDP data compression; it can have the values: • 0 (default value): off •...
  • Page 123: Packet Switched Data Configuration +Upsd

    SARA-R4/N4 series - AT Commands Manual Command Response Description AT+CGDCONT? +CGDCONT: 2,"IP","internet","0.0.0.0",0,0 Read command +CGDCONT: 1,"IP","STATREAL","0.0.0.0",0 +CGDCONT: 3,"IP","tim.ibox.it","0.0.0.0",0,0 SARA-R4 / SARA-N4 • When registering in LTE, the initial default EPS bearer is mapped to <cid>= 1. • If not specified by the set command, the following values are assumed: o <cid>: 1 o <PDP_addr>: "0.0.0.0"...
  • Page 124 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example +UPSD: 0,4,"0.0.0.0" +UPSD: 0,19,0 13.4.3    Defined values Parameter Type Description <profile_id> Number PSD profile identifier, in range 0-6 <param_tag> Number • 0: Protocol type; the allowed values of <param_val> parameter are 0 (factory-programmed value): IPv4 1: IPv6 2: IPv4v6 with IPv4 preferred for internal sockets 3: IPv4v6 with IPv6 preferred for internal sockets...
  • Page 125 SARA-R4/N4 series - AT Commands Manual Parameter Type Description 0 (factory-programmed value): subscribed 1: class 1 2: class 2 3: class 3 4: best effort • 12: QoS reliability - the <param_val> parameter selects the reliability class: 0 (factory-programmed value): subscribed 1: class 1 (Interpreted as class 2) 2: class 2 (GTP Unack, LLC Ack and Protected, RLC Ack) 3: class 3 (GTP Unack, LLC Unack and Protected, RLC Ack) 4: class 4 (GTP Unack, LLC Unack and Protected, RLC Unack)
  • Page 126 SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 24: 3G QoS guaranteed downlink bit rate - <param_val> 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 - <param_val> is the value for the guaranteed uplink bit rate in kb/s.
  • Page 127 SARA-R4/N4 series - AT Commands Manual Parameter Type Description 2: disable • 37: 3G minimum QoS erroneous SDU delivery - <param_val> selects the acceptable value for the erroneous SDU delivery: 0 (factory-programmed value): subscribed 1: no detection 2: enable 3: disable • 38: 3G minimum QoS extended guaranteed downlink bit rate - <param_val>...
  • Page 128: Gprs Attach Or Detach +Cgatt

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 50: 3G minimum QoS traffic priority - <param_val> selects the acceptable value for the traffic priority: 0 (factory-programmed value): subscribed 1: priority 1 2: priority 2 3: priority 3 • 51: 3G Minimum QoS transfer delay - <param_val> is the value for the transfer delay in milliseconds.
  • Page 129: Pdp Context Activate Or Deactivate +Cgact

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Read AT+CGATT? +CGATT: <state> +CGATT: 1 Test AT+CGATT=? +CGATT: (list of supported +CGATT: (0-1) <state>s) 13.5.3    Defined values Parameter Type Description <state> Number Indicates the state of GPRS attachment: • 0: detached • 1 (default value): attached 13.6    PDP context activate or deactivate +CGACT +CGACT...
  • Page 130 SARA-R4/N4 series - AT Commands Manual 13.6.4    Notes SARA-R4 / SARA-N4 • If <cid> 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 DCE response Description AT+CMEE=2 Set the verbose error result...
  • Page 131: Enter Ppp State/Gprs Dial-Up D

    SARA-R4/N4 series - AT Commands Manual Command sent by the DTE DCE response Description AT+CGPADDR=3 +CGPADDR: 3, "0.0.0.0" Show the address of PDP context 3 AT+CGDCONT? +CGDCONT: 1,"IP","web.omnitel.it","0.0.0.0",0,0 +CGDCONT: 3,"IP","internet","0.0.0.0",0,0 +CGDCONT: 2,"IP","mms.vodafone.it","0.0.0.0",0,0 AT+CGACT=1,2 Activate the PDP context 2 AT+CGDCONT? +CGDCONT: 1,"IP","web.omnitel.it","0.0.0.0",0,0 +CGDCONT: 3,"IP","internet","0.0.0.0",0,0 +CGDCONT: 2,"IP","mms.vodafone.it","10.153.123.229", AT+CGACT=1,3 Activate PDP context 3...
  • 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 <cid>= 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.
  • Page 133: Show Pdp Address +Cgpaddr

    SARA-R4/N4 series - AT Commands Manual 13.8    Show PDP address +CGPADDR +CGPADDR Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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 <cid>...
  • Page 134 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example +CGEV: ME DEACT <PDP_type>, <PDP_addr>,[<cid>] +CGEV: ME DEACT,<p_cid>,<cid>,0 +CGEV: ME DEACT <p_cid>,<cid>, <event_type> +CGEV: ME MODIFY <cid>, <change_reason>,<event_type> +CGEV: ME DETACH +CGEV: ME CLASS <class> +CGEV: NW PDN ACT <cid>[, <reason>] +CGEV: NW ACT <p_cid>,<cid>, <event_type>...
  • Page 135: Gprs Network Registration Status +Cgreg

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <change_reason> Number Indicates what kind of change occurred: • 1: TFT only changed • 2: QoS only changed • 3: both TFT and QoS changed <PDP_type> Number <PDP_type> <PDP_addr> Number <PDP_addr> <class> String GPRS mobile class.
  • Page 136 SARA-R4/N4 series - AT Commands Manual The parameters <lac>, <ci>, <AcT>, <rac> are provided only if available. The read command provides the same information issued by the URC together with the current value of the <n> parameter. The location information elements <lac>, <ci> and <AcT>, if available, are returned only when <n>=2 and the MT is registered with the network.
  • Page 137: Manual Deactivation Of A Pdp Context H

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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 <AcT> value is invalid <rac>...
  • Page 138: Eps Network Registration Status +Cereg

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Read AT+CEMODE? +CEMODE: <mode> +CEMODE: 1 Test AT+CEMODE=? +CEMODE: (list of supported +CEMODE: (0-3) <mode>'s) 13.12.3    Defined values Parameter Type Description <mode> Number Mode configuration: • 0: PS mode 2 of operation. The UE registers only to EPS services, and the UE's usage setting is "data centric"...
  • Page 139 SARA-R4/N4 series - AT Commands Manual • +CEREG: <stat>[,[<tac>],[<ci>],[<AcT>][,[<cause_type>],[<reject_cause>][,[<Active_Time>],[<Periodic_ TAU>]]]] when <n>=5 and the value of <stat> changes The parameters <AcT>, <tac>, <ci>, <cause_type>, <reject_cause>, <Active-Time> and <Periodic-TAU> are provided only if available. The read command returns the status of result code presentation and an integer <stat> which shows whether the network has currently indicated the registration of the MT.
  • Page 140: Delete Non-Active Pdp Contexts +Cgdel

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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 <cause_type>...
  • Page 141: Configure The Authentication Parameters Of A Pdp/Eps Bearer +Uauthreq

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+CGDEL=? 13.14.3    Defined values Parameter Type Description <cid> Number <cid> 13.15    Configure the authentication parameters of a PDP/EPS bearer +UAUTHREQ +UAUTHREQ Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial...
  • Page 142: Pdp Ip Configuration When Roaming +Udconf=75

    SARA-R4/N4 series - AT Commands Manual • The <username> and <password> parameters must be set to an empty string if the authentication type is not set (<auth_type>=0). SARA-R4 / SARA-N4 • <auth_type>=3 is not supported. 13.16    PDP IP configuration when roaming +UDCONF=75 +UDCONF=75 Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4...
  • 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 Syntax Response Example AT+UDCONF=76,<cid>,<Data_Flag> OK AT+UDCONF=76,1,0 Read AT+UDCONF=76 +UDCONF: 76,<cid>,<Data_Flag> AT+UDCONF=76 +UDCONF: 76,1,0 13.17.3    Defined values Parameter Type Description...
  • Page 144: 14    System Features

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full 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: Firmware Update Over At (Foat) +Ufwupd

    SARA-R4/N4 series - AT Commands Manual 14.2    Firmware update Over AT (FOAT) +UFWUPD +UFWUPD Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial 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: Antenna Detection +Uantr

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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.
  • Page 147: End User Test +Utest

    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 Syntax Response Example AT+UPSV=<mode> AT+UPSV=4 Read AT+UPSV? +UPSV: <mode> +UPSV: 0 Test AT+UPSV=? +UPSV: (list of supported <mode>s)
  • 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 •...
  • Page 149 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <par1>..<par5> Number 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 <par1> range LTE band EARFCN range [139650-141589] TDD 41 [39650 - 41589] Table 10: <par1> parameter range The "+CME ERROR: operation not supported" or "+CME ERROR: 4" error result code will be provided in these cases (depending on the +CMEE AT command...
  • Page 151 SARA-R4/N4 series - AT Commands Manual Parameter Description Range Default Notes <par1> range LTE band EARFCN range [118000-118599] FDD 1 [18000 - 18599] [118600-119199] FDD 2 [18600 - 19199] [119200-119949] FDD 3 [19200 - 19949] [119950-120399] FDD 4 [19950 - 20399] [120400-120649] FDD 5 [20400 - 20649] [120650-120749]...
  • Page 152 SARA-R4/N4 series - AT Commands Manual Parameter Description Range Default Notes <par3> Training sequence 0 ÷ 7 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. <par4>...
  • Page 153 SARA-R4/N4 series - AT Commands Manual Command Response Description AT+UTEST=3,65,8,,2,5000 +UTEST: 65,8,5,2,5000 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 Response Example Output pins definition AT+UTEST=10,4,[<bit_ AT+UTEST=10,4,"00000000100000 padding>]<pin_seq> 002000" Digital testing execution AT+UTEST=10,5 AT+UTEST=10,5 Digital value measurement AT+UTEST=10,6 <bit_padding>]<pin_seq> AT+UTEST=10,6 00000004100000003000 Read AT+UTEST? +UTEST: <mode> +UTEST: 1 Test AT+UTEST=? +UTEST: (list of supported +UTEST: (0-3) <mode>s) 14.5.9    Defined values Parameter...
  • Page 155: Internal Temperature Monitor +Utemp

    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. o The status of the n-th pin will be represented by the corresponding n-th bit; see the <op_code> description for the notation of each mode setting o Convert each group of four binary digits into its hexadecimal representation SARA-R4 / SARA-N4...
  • Page 156: Power Saving Mode Setting +Cpsms

    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 Syntax Response Example...
  • Page 157 SARA-R4/N4 series - AT Commands Manual 14.7.2    Syntax Type Syntax Response Example AT+CPSMS=[<mode>[, AT+CPSMS=1,,,"01000011","010000 <Requested_Periodic_RAU>[, 11" <Requested_GPRS_READY_timer>[, <Requested_Periodic_TAU>[, <Requested_Active_Time>]]]]] Read AT+CPSMS? +CPSMS: <mode>,[<Requested_ +CPSMS: 1,,,"01000011","01000011" Periodic_RAU>],[<Requested_ GPRS_READY_timer>], [<Requested_Periodic_TAU>], [<Requested_Active_Time>] Test AT+CPSMS=? +CPSMS: (list of supported +CPSMS: (0,1,2),,,("00000000"- <mode>s),(list of supported "11111111"),("00000000"-"11111111") <Requested_Periodic_RAU>s),(list of supported <Requested_GPRS_ READY_timer>s),(list of supported <Requested_Periodic_TAU>s),(list of supported <Requested_Active_...
  • Page 158: Power Saving Mode Assigned Values +Ucpsms

    SARA-R4/N4 series - AT Commands Manual 14.8    Power Saving Mode Assigned Values +UCPSMS +UCPSMS Modules SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 14.8.1    Description Reads the UEs power saving mode (PSM) parameters assigned by the network. The command returns the state of PSM on the UE, as well as: •...
  • Page 159: Set Lwm2M Fota Urcs +Ulwm2Mstat

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full 14.9.1    Description Allows enabling or disabling of LWM2M FOTA status URCs. 14.9.2    Syntax Type Syntax...
  • Page 160: Lwm2M Configuration +Ufotaconf

    SARA-R4/N4 series - AT Commands Manual 14.11    LWM2M configuration +UFOTACONF +UFOTACONF Modules SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 14.11.1    Description Configures the uFOTA registration and timer for periodic connections to the uFOTA server. 14.11.2    Syntax Type Syntax...
  • Page 161: Last Gasp Configuration +Ulgasp

    SARA-R4/N4 series - AT Commands Manual 14.12    Last gasp configuration +ULGASP +ULGASP Modules SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial < 10 s +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 Description Factory-programmed value: empty string. <msg_format> Number Format of the <text> parameter. Allowed values: • 0 (factory-programmed value): text • 1: binary <profile_id> Number PSD profile identifier. Only the value 1 is allowed. <IP_protocol> Number IP protocol used for socket connection.
  • Page 163: 15    Gpio

    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.1    GPIO functions On u-blox cellular modules, GPIO pins can be opportunely configured as general purpose input or output. Moreover GPIO pins of u-blox cellular modules can be configured to provide custom functions via +UGPIOC AT command.
  • 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.3    Network status indication When a GPIO pin is configured to provide network status indication, its progress depends on the CS network registration state (see +CREG) and on the module transmission state: •...
  • 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 Time Figure 3: GPIO pin progress for registered home network 3G 15.1.3.4    Registered home network Cat NB1 •...
  • Page 166 SARA-R4/N4 series - AT Commands Manual Voltage Time 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 Time 30 s...
  • Page 167: Gpio Select Configuration Command +Ugpioc

    SARA-R4/N4 series - AT Commands Manual Voltage Time 800 ms 200 ms Figure 9: GPIO pin progress for data transmission roaming 15.2    GPIO select configuration command +UGPIOC +UGPIOC Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial...
  • Page 168 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example [<gpio_id>,<gpio_mode> 21,3 [..]] 23,255 24,255 51,7 Test AT+UGPIOC=? +UGPIOC: (list of supported <gpio_ +UGPIOC: (20,21,23,24,51),(0-5,7,9, id>),(list of supported <gpio_ 255),(0-2) mode>),(list of supported <gpio_ out_val>\<gpio_in_pull>) [<gpio_id1>,<gpio_mode> <gpio_idN>,<gpio_mode>] 15.2.3    Defined values Parameter Type Description <gpio_id>...
  • Page 169: Gpio Read Command +Ugpior

    SARA-R4/N4 series - AT Commands Manual 15.3    GPIO read command +UGPIOR +UGPIOR Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +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 +UGPIOC AT command to define the GPIO function).
  • Page 170 SARA-R4/N4 series - AT Commands Manual 15.4.3    Defined values Parameter Type Description <gpio_id> Number GPIO pin identifier: pin number See the GPIO mapping for the available GPIO pins, their mapping and factory- programmed values on different u-blox cellular modules series and version. <gpio_out_val> Number GPIO value.
  • Page 171: 16    File System

    SARA-R4/N4 series - AT Commands Manual 16    File System 16.1    File tags 16.1.1    Description File system commands have the optional <tag> 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: Download File +Udwnfile

    SARA-R4/N4 series - AT Commands Manual Module SARA-R4 / SARA-N4 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 +ULSTFILE AT commands are not allowed.
  • Page 173: List Files Information +Ulstfile

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <size> Number File size expressed in bytes. For file system file name and data size limits see File system limits. <tag> String Optional parameter that specifies the application file type. FILE TAGS table lists the allowed <tag>...
  • Page 174: Read File +Urdfile

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 1: gets the free space for the specific <tag> file type • 2: gets the file size expressed in bytes, belonging to <tag> type (if specified) <tag> String Specifies the application file type. FILE TAGS table lists the allowed <tag>...
  • Page 175: Partial Read File +Urdblock

    SARA-R4/N4 series - AT Commands Manual 16.5    Partial read file +URDBLOCK +URDBLOCK Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial +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.
  • Page 176: Partial Download File +Udwnblock

    SARA-R4/N4 series - AT Commands Manual 16.6.2    Syntax Type Syntax Response Example AT+UDELFILE=<filename>[,<tag>] OK AT+UDELFILE="filename","USER" 16.6.3    Defined values Parameter Type Description <filename> String File name. For file system file name and data size limits see File system limits. <tag> String The optional parameter <tag> specifies a different application file type. FILE TAGS table lists the allowed <tag>...
  • Page 177: File System Limits

    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. Maximum file name length: •...
  • Page 178: 17    Dns

    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.
  • Page 179 SARA-R4/N4 series - AT Commands Manual Parameter Type Description Once the result of DNS resolution becomes available, it is notified to the AT interface through the +UUDNSRN URC <resolved_ip_ String Resolved IP address corresponding to the specified domain name address> <resolved_domain_ String Resolved domain name corresponding to the provided IP address name>...
  • Page 180: 18    Internet Protocol Transport Layer

    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: Create Socket +Usocr

    SARA-R4/N4 series - AT Commands Manual IPv4 address Remarks 0x10.0xE4.0x4C.0x22 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. •...
  • Page 182: Ssl/Tls Mode Configuration On Tcp Socket +Usosec

    SARA-R4/N4 series - AT Commands Manual 18.3.2    Syntax Type Syntax Response Example AT+USOCR=<protocol>[,<local_ +USOCR: <socket> AT+USOCR=17 port>] +USOCR: 2 Test AT+USOCR=? +USOCR: (list of supported +USOCR: (6,17),(1-65535) <protocol>s),(list of supported <local_port>s) 18.3.3    Defined values Parameter Type Description <protocol> Number • 6: TCP • 17: UDP <local_port>...
  • Page 183: Set Socket Option +Usoso

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example 18.4.3    Defined values Parameter Type Description <socket> Number Socket identifier defined by the AT+USOCR command. The range goes from 0 to 6. <ssl_tls_status> Number • 0 (default value): disable the SSL/TLS on the socket. •...
  • Page 184: Get Socket Option +Usogo

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <opt_val>: 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 <opt_name> for socket level options may be: 4: local address re-use.
  • Page 185 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+USOGO=? +USOGO: (list of supported +USOGO: (0-6),(0,6,65535) <socket>s),(list of supported <level>s) 18.6.3    Defined values Parameter Type Description <socket> Number Socket identifier. The range goes from 0 to 6. <level> Number • 0: IP Protocol <opt_name>...
  • Page 186: Close Socket +Usocl

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial < 120 s (except +CME Error URC) 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: Connect Socket +Usoco

    SARA-R4/N4 series - AT Commands Manual 18.8.2    Syntax Type Syntax Response Example Action AT+USOER +USOER: <socket_error> +USOER: 104 18.8.3    Defined values Parameter Type Description <socket_error> Number Code of the last error occurred in a socket operation. The allowed values are listed in Appendix A.5 •...
  • Page 188: Write Socket Data +Usowr

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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.
  • Page 189 SARA-R4/N4 series - AT Commands Manual 18.10.2    Syntax Type Syntax Response Example Base syntax AT+USOWR=<socket>,<length>, +USOWR: <socket>,<length> AT+USOWR=3,12,"Hello world!" <data> +USOWR: 3,12 Binary syntax AT+USOWR=<socket>,<length> @<data> AT+USOWR=3,16 +USOWR: <socket>,<length> @16 bytes of data +USOWR: 3,16 Test AT+USOWR=? +USOWR: (list of supported +USOWR: (0-6),(0-512),"HEX data" <socket>s),(list of supported +USOWR: (0-6),(0-1024),"data"...
  • Page 190: Sendto Command (Udp Only) +Usost

    SARA-R4/N4 series - AT Commands Manual 18.11    SendTo command (UDP only) +USOST +USOST Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s 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: Read Socket Data +Usord

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <remote_addr> String Remote host IP address or domain name of the remote host. For IP address format reference see the addressing. <remote_port> Number Remote host port, in range 1-65535 <length> Number Number of data bytes to write •...
  • Page 192: Receive From Command (Udp Only) +Usorf

    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.2    Syntax Type Syntax Response Example AT+USORD=<socket>,<length> +USORD: <socket>,<length>,<data AT+USORD=3,16 in the ASCII [0x00,0xFF] range> +USORD: 3,16,"16 bytes of data" +UUSORD: <socket>,<length>...
  • 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.
  • Page 194: Set Listening Socket +Usoli

    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 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 1 s (except TCP/UDP/IP URC) Error +CME Error 18.14.1    Description Sets the specified socket in listening mode on the specified port of service, waiting for incoming connections (TCP) or data (UDP): For TCP sockets, incoming connections will be automatically accepted and notified via the...
  • Page 195: Hex Mode Configuration +Udconf=1

    SARA-R4/N4 series - AT Commands Manual 18.14.4    Notes • In case of notification via the URC +UUSOLI <port> is intended as the remote port. 18.15    HEX mode configuration +UDCONF=1 +UDCONF=1 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full...
  • Page 196 SARA-R4/N4 series - AT Commands Manual 18.16.2    Syntax Type Syntax Response Example AT+USODL=<socket> CONNECT AT+USODL=0 CONNECT Test AT+USODL=? +USODL: (list of supported +USODL: (0-6) <socket>s) 18.16.3    Defined values Parameter Type Description <socket> Number Socket identifier. The range goes from 0 to 6. 18.16.4    Enhanced Direct Link The enhanced DL functionality allows the user set up to three kinds of trigger for data transmission: •...
  • Page 197: Udp Direct Link Packet Size Configuration +Udconf=2

    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.
  • Page 198: Timer Trigger Configuration For Direct Link +Udconf=5

    SARA-R4/N4 series - AT Commands Manual 18.18.2    Syntax Type Syntax Response Example AT+UDCONF=3,<socket_id>, AT+UDCONF=3,1,1000 <sending_timer_timeout> Read AT+UDCONF=3,<socket_id> +UDCONF: 3,<socket_id>,<sending_ AT+UDCONF=3,1 timer_timeout> +UDCONF: 3,1,1000 18.18.3    Defined values Parameter Type Description <socket_id> Number Socket identifier; used when changing the UDP Direct Link settings. Allowed range is 0-6 <sending_timer_ Number Sending timer (in milliseconds) for UDP direct link;...
  • Page 199: Data Length Trigger Configuration For Direct Link +Udconf=6

    SARA-R4/N4 series - AT Commands Manual 18.20    Data Length Trigger configuration for Direct Link +UDCONF=6 +UDCONF=6 Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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.2    Syntax Type Syntax...
  • Page 200: Congestion Timer Configuration For Direct Link +Udconf=8

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description The allowed range is 0-6 <character_trigger> Number 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;...
  • Page 201 SARA-R4/N4 series - AT Commands Manual 18.23.3    Defined values Parameter Type Description <socket> Number Socket identifier. The range goes from 0 to 6 <param_id> Number Control request identifier. Possible values are: • 0: query for socket type • 1: query for last socket error •...
  • Page 202: Configure Dormant Close Socket Behavior +Usoclcfg

    SARA-R4/N4 series - AT Commands Manual 18.24    Configure Dormant Close Socket Behavior +USOCLCFG +USOCLCFG Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 18.24.1    Description Enables or disables the TCP socket Graceful Dormant Close feature. When enabled, if the RRC connection is released and a TCP socket is closed with the +USOCL, the module will re-establish the RRC connection to close the socket both locally and remotely.
  • Page 203: 19    Ssl/Tls

    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). The SSL/TLS with digital certificates support provides different connection security aspects: • Server authentication: use of the server certificate verification against a specific trusted certificate or a trusted certificates list;...
  • 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.
  • Page 205 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+USECMNG=? +USECMNG: (list of supported <op_ +USECMNG: (0-4),(0-2) code>s),(list of supported <type>s) 19.2.3    Defined values Parameter Type Description <op_code> Number Type of operation: • 0: import a certificate or a private key (data provided by the stream of byte) •...
  • Page 206: Ssl/Tls Security Layer Profile Manager +Usecprf

    SARA-R4/N4 series - AT Commands Manual 19.3    SSL/TLS security layer profile manager +USECPRF +USECPRF Modules SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 19.3.1    Description Manages security profiles for the configuration of the following SSL/TLS connections properties: •...
  • Page 207 SARA-R4/N4 series - AT Commands Manual Table 21 provides the list the applicability of SSL connection properties depending on the module series. SARA-R4 SARA-N4 Table 21: SSL/TLS connections properties applicability To set all the parameters in security profile, a set command for each <op_code> needs to be issued (e.g. certificate validation level, minimum SSL/TLS version, ...).
  • Page 208 SARA-R4/N4 series - AT Commands Manual Parameter Type Description 0 (factory-programmed value): (0x0000) Automatic the cipher suite will be negotiated in the handshake process 1: (0x002f) TLS_RSA_WITH_AES_128_CBC_SHA 2: (0x003C) TLS_RSA_WITH_AES_128_CBC_SHA256 3: (0x0035) TLS_RSA_WITH_AES_256_CBC_SHA 4: (0x003D) TLS_RSA_WITH_AES_256_CBC_SHA256 5: (0x000a) TLS_RSA_WITH_3DES_EDE_CBC_SHA 6: (0x008c) TLS_PSK_WITH_AES_128_CBC_SHA 7: (0x008d) TLS_PSK_WITH_AES_256_CBC_SHA 8: (0x008b) TLS_PSK_WITH_3DES_EDE_CBC_SHA 9: (0x0094) TLS_RSA_PSK_WITH_AES_128_CBC_SHA...
  • Page 209: At+Usecmng Command Example

    SARA-R4/N4 series - AT Commands Manual 19.3.4    Notes • SARA-R4 SARA-N4 SARA-R410M-01B Table 22: Cipher suite applicability SARA-R4 / SARA-N4 • <op_code>=7, 8, 9 and 10 are not supported. SARA-R410M-01B • The unique certificate validation level (<op_code>=0) supported is the level 0 (no validation, <param_ val>=0).
  • Page 210: Notes

    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 NzE2MjM1OTU5WjCBqTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5j LjEoMCYGA1UECxMfQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYG A1UECxMvKGMpIDIwMDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNl IG9ubHkxHzAdBgNVBAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwggEiMA0GCSqG SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCsoPD7gFnUnMekz52hWXMJEEUMDSxuaPFs W0hoSVk3/AszGcJ3f8wQLZU0HObrTQmnHNK4yZc2AreJ1CRfBsDMRJSUjQJib+ta 3RGNKJpchJAQeg29dGYvajig4tVUROsdB58Hum/u6f1OCyn1PoSgAfGcq/gcfomk 6KHYcWUNo1F77rzSImANuVud37r8UVsLr5iy6S7pBOhih94ryNdOwUxkHt3Ph1i6 Sk/KaAcdHJ1KxtUvkcx8cXIcxcBn6zL9yZJclNqFwJu/U30rCfSMnZEfl2pSy94J NqR32HuHUETVPm4pafs5SSYeCaWAe0At6+gnhcn+Yf1+5nyXHdWdAgMBAAGjQjBA MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBR7W0XP r87Lev0xkhpqtvNG61dIUDANBgkqhkiG9w0BAQUFAAOCAQEAeRHAS7ORtvzw6WfU DW5FvlXok9LOAz/t2iWwHVfLHjp2oEzsUHboZHIMpKnxuIvW1oeEuzLlQRHAd9mz YJ3rG9XRbkREqaYB7FViHXe4XI5ISXycO1cRrK1zN44veFyQaEfZYGDm/Ac9IiAX xPcW6cTYcvnIc3zfFi8VqT79aie2oetaupgf1eNNZAqdE8hhuvU5HIe6uL17In/2 /qxAeeWsEG89jxt5dovEN7MhGITlNgDrYyCZuen+MwS7QcjBAvlEYyCegc5C09Y/ LHbTY5xZ3Y+m4Q6gLkH3LpVHz7z9M/P2C2F+fpErgUfCJzDupxBdN49cOSvkBPB7 jVaMaA== -----END CERTIFICATE----- 19.5    Notes...
  • Page 211: 20    Ftp

    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 Syntax Response Example AT+UFTP=5[,<timeout>] AT+UFTP=5,21 FTP mode AT+UFTP=6[,<FTP_mode>] AT+UFTP=6,1 FTP server port AT+UFTP=7[,<FTP_server_port>] AT+UFTP=7,30 FTP Secure option in explicit mode AT+UFTP=8[,<FTP_secure>[, AT+UFTP=8,1,2 <USECMNG_profile>]] Read AT+UFTP? +UFTP: 0,<IP_address> +UFTP: 0,"216.239.59.147" +UFTP: 1,<server_name> +UFTP: 1,"" +UFTP: 2,<username> +UFTP: 2,"username"...
  • Page 213: Ftp Command +Uftpc

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <FTP_server_port> Number 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. <FTP_secure> Number Enables / disables the Secure option (explicit mode) of FTP client service. FTP Secure option in explicit mode (SSL encryption of FTP control channel;...
  • Page 214 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example AT+UFTPC=0 AT+UFTPC=0 FTP login AT+UFTPC=1 AT+UFTPC=1 Delete the file from the FTP server AT+UFTPC=2,<file_name> AT+UFTPC=2,"mytest" Rename a file of FTP server AT+UFTPC=3,<file_name>,<new_ AT+UFTPC=3,"old_name","final_ file_name> name" Retrieve the file from the FTP server AT+UFTPC=4,<remote_file_name>, AT+UFTPC=4,"data.zip","data.zip"...
  • Page 215 SARA-R4/N4 series - AT Commands Manual 20.2.3    Defined values Parameter Type Description <op_code> Number FTP command request. Allowed values: • 0: FTP logout; terminates the FTP session by performing a logout. • 1: FTP login; connects to the FTP server using the parameters of the current FTP profile (set via AT+UFTP command).
  • Page 216: Ftp Error +Uftper

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <ftp_data> String 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 <ftp_data_len>. At the end of the byte stream, another quotation mark is provided for user convenience and visualization purposes.
  • Page 217: 21    Http

    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.
  • Page 218 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Username AT+UHTTP=<profile_id>,2, AT+UHTTP=2,2,"my_user" <username> Read AT+UHTTP=<profile_id>,2 +UHTTP: <profile_id>,2,<username> AT+UHTTP=2,2 +UHTTP: 2,2,"my_user" Password AT+UHTTP=<profile_id>,3, AT+UHTTP=2,3,"pwd" <password> Read AT+UHTTP=<profile_id>,3 +UHTTP: <profile_id>,3,<password> AT+UHTTP=2,3 +UHTTP: 2,3,"pwd" Authentication type AT+UHTTP=<profile_id>,4,<HTTP_ AT+UHTTP=2,4,1 authentication> Read AT+UHTTP=<profile_id>,4 +UHTTP: <profile_id>,4,<HTTP_ AT+UHTTP=2,4 authentication>...
  • Page 219 SARA-R4/N4 series - AT Commands Manual Parameter Type Description • 4: authentication type • 5: HTTP server port • 6: HTTP Secure option (SSL encryption) • 7: reserved for internal use only • 8: reserved for internal use only • 9: HTTP add custom request headers <HTTP_server_IP_ String HTTP server IP address;...
  • Page 220: Http Advanced Control+Uhttpac

    SARA-R4/N4 series - AT Commands Manual 21.2    HTTP advanced control+UHTTPAC +UHTTPAC Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full Appendix A.6 21.2.1    Description Configures, reads or resets (to the factory-programmed values) the HTTP application profile advanced parameters.
  • Page 221: Http Command +Uhttpc

    SARA-R4/N4 series - AT Commands Manual Command Response Description Example 3 AT+UHTTPAC=0,0,0,"COMPLEX_COOKIE; COMPLEX_ Overwrite HTTP request cookie at index 0 COOKIE" with a complex cookie 21.3    HTTP command +UHTTPC +UHTTPC Modules SARA-R404M SARA-R410M-01B SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference partial...
  • 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 <param3> <param3>: used only when <param2>=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: Http Protocol Error +Uhttper

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <http_status_code> Number HTTP status code reported in the server response header after a GET FOTA update file request. This parameter is issued only for AT+UHTTPC=<profile_id>,100,<path> AT command. <md5_sum> String MD5 checksum of the FOTA update file. This parameter is issued only for AT +UHTTPC=<profile_id>,100,<path>...
  • Page 224: 22    Gnss

    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.
  • 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.
  • Page 226: Assisted Gnss Unsolicited Indication +Ugind

    SARA-R4/N4 series - AT Commands Manual 22.2.4    Notes • To know the allowed combinations of GNSS type for <GNSS_systems> see the corresponding GNSS receiver documentation. • If <GNSS_systems> type is not supported by the GNSS receiver, the set command turns on the GNSS receiver with built-in supported type.
  • Page 227: Gnss Profile Configuration +Ugprf

    SARA-R4/N4 series - AT Commands Manual 22.3.3    Defined values Parameter Type Description <mode> Number URC configuration: • 0 (default value): disabled • 1: enabled <aid_mode> Number Provides the supported aiding mode: • 0: GNSS system(s) • 1: automatic local aiding • 2: AssistNow Offline •...
  • 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.
  • Page 229: Aiding Server Configuration +Ugsrv

    SARA-R4/N4 series - AT Commands Manual 22.5    Aiding server configuration +UGSRV +UGSRV Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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.
  • Page 230: Gnss Aiding Request Command +Ugaos

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <days> Number 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.
  • Page 231: Send Of Ubx String +Ugubx

    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 •...
  • Page 232: Gnss Indications Timer +Ugtmr

    SARA-R4/N4 series - AT Commands Manual 22.8    GNSS indications timer +UGTMR +UGTMR Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +CME Error 22.8.1    Description Sets the date and time format. With the <time_zone> parameter is possible to set the time zone value; the time and the date will be updated as the local time.
  • Page 233: Get Gnss Fix Data +Uggga

    SARA-R4/N4 series - AT Commands Manual 22.9.2    Syntax Type Syntax Response Example AT+UGZDA=<state> AT+UGZDA=1 Read AT+UGZDA? +UGZDA: <state>,<$ZDA msg> +UGZDA: 1,$GPZDA,142351.00,12,12, 2013,00,00*66 +UGZDA: 0,NULL Test AT+UGZDA=? +UGZDA: (list of supported +UGZDA: (0-1) <state>s) 22.9.3    Defined values Parameter Type Description <state> Number • 0 (factory-programmed value): disable the NMEA $ZDA messages •...
  • Page 234: Get Geographic Position +Uggll

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <$GGA msg> String 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 Attributes Syntax...
  • Page 235: Get Recommended Minimum Gnss Data +Ugrmc

    SARA-R4/N4 series - AT Commands Manual 22.12.2    Syntax Type Syntax Response Example AT+UGGSV=<state> AT+UGGSV=1 Read AT+UGGSV? +UGGSV: <state>,<$GSV msg> +UGGSV: 1,$GPGSV,3,1,11,03,67,298, 22,06,88,149,29,07,06,302,,08,05, 332,25*73 $GPGSV,3,2,11,09,02,334,25,14,02, 141,,15,10,041,43,16,46,209,16*7D $GPGSV,3,3,11,18,48,066,35,21,26,0 70,35,27,80,314,25*40 $GLGSV,1,1,03,73,13,248,,74,23,298, 20,75,09,348,19*51 +UGGSV: 0,NULL Test AT+UGGSV=? +UGGSV: (list of supported +UGGSV: (0-1) <state>s) 22.12.3    Defined values Parameter Type Description <state>...
  • Page 236: Get Course Over Ground And Ground Speed +Ugvtg

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example Test AT+UGRMC=? +UGRMC: (list of supported +UGRMC: (0-1) <state>s) 22.13.3    Defined values Parameter Type Description <state> Number • 0 (factory-programmed value): to disable the NMEA $RMC messages • 1: to enable the NMEA $RMC messages <$RMC msg>...
  • Page 237: Get Satellite Information +Uggsa

    SARA-R4/N4 series - AT Commands Manual 22.15    Get satellite information +UGGSA +UGGSA Modules SARA-R410M-02B SARA-R410M-52B SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full < 10 s +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.
  • Page 239 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example <alt>,<lat50>,<long50>,<major50 >,<minor50>,<orientation50 >,<confidence50>[,<lat95>, <long95>,<major95>,<minor95>, <orientation95>,<confidence95>] If <response_type>=2, <sensor_ +UULOC: 1,1,0,08/04/2015,09:0 used>= 0: 3:45.000,45.7140290,13.7410695,0, +UULOC: <sol>,<num>,<sensor_ used>,<date>,<time>,<lat>,<long>, <alt>,<uncertainty> 22.16.3    Defined values Parameter Type Description <mode> Number • 0: reserved • 1: reserved • 2: single shot position <sensor>...
  • Page 240: Localization Information Request Status Unsolicited Indication +Ulocind

    SARA-R4/N4 series - AT Commands Manual Parameter Type Description <antenna_status> Number Antenna status (0 - 4) . For more details see the u-blox GNSS receiver protocol specification <jamming_status> Number Jamming status . For more details see the u-blox GNSS receiver protocol specification 22.16.4    Notes •...
  • Page 241: Gnss Sensor Configuration +Ulocgnss

    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 •...
  • Page 242 SARA-R4/N4 series - AT Commands Manual 22.18.3    Defined values Parameter Type Description <aiding> Number GNSS aiding mode configuration; it is possible the combination of different aiding modes: to enable more aiding modes it is needed to sum the <mode> value of the interested aiding modes: •...
  • Page 243: 23    I

    SARA-R4/N4 series - AT Commands Manual 23    I 23.1    Introduction The I C 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.
  • Page 244: Write To Peripheral +Ui2Cw

    SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example supported <bus_mode>s),(list of supported <bit_rate>),(<device_ address> range),(list of supported <address_width>s) 23.2.3    Defined values Parameter Type Description <I2C_controller_ Number C HW controller to use: number> • 1: controller 1 <bus_mode> Number C bus mode type: •...
  • Page 245: Read From Peripheral +Ui2Cr

    SARA-R4/N4 series - AT Commands Manual 23.4    I C read from peripheral +UI2CR +UI2CR Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +CME Error 23.4.1    Description Reads <nof_bytes_to_read> of data from the I C slave device of the current logical channel and prints them in HEX format in separate rows.
  • Page 246: Close Logical Channel +Ui2Cc

    SARA-R4/N4 series - AT Commands Manual 23.5.3    Defined values Parameter Type Description <register_address> Number Device address in HEX format <nof_bytes_to_read> Number Number of bytes to read from the slave I C register. The range goes from 1 to 100. <index1>,...,<index_ Number Index of the byte being printed. n>...
  • Page 247: 24    Mqtt

    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).
  • Page 248 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example AT+UMQTT=1,<local_port> +UMQTT: 1,<result> AT+UMQTT=1,1883 +UMQTT: 1,1 MQTT server name AT+UMQTT=2,<server_name>[, +UMQTT: 2,<result> AT+UMQTT=2, <server_port>] "www.commercialmqttbroker.com" +UMQTT: 2,1 MQTT server IP address AT+UMQTT=3,<IP_address>[, +UMQTT: 3,<result> AT+UMQTT=3,"192.168.1.0",1883 <server_port] +UMQTT: 3,1 User name and password AT+UMQTT=4,<username>, +UMQTT: 4,<result>...
  • Page 249 SARA-R4/N4 series - AT Commands Manual Parameter Type Description <client_id> String Uniquely identifies this client connection to a given MQTT message broker. If a new connection request is received with the same unique client ID as a current connection, the MQTT message broker disconnects the previous connection and responds to (and uses the parameters from) the new connection request.
  • Page 250: Mqtt Will Topic Configuration +Umqttwtopic

    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"+. •...
  • Page 251: Mqtt Will Message Configuration +Umqttwmsg

    SARA-R4/N4 series - AT Commands Manual Parameter Type 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).
  • Page 252: Save/Restore Mqtt Profile From Nvm +Umqttnv

    SARA-R4/N4 series - AT Commands Manual 24.4    Save/Restore MQTT profile from NVM +UMQTTNV +UMQTTNV Modules SARA-R410M-02B SARA-R410M-52B SARA-R412M SARA-N4 Attributes Syntax PIN required Settings saved Can be aborted Response time Error reference full +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.
  • Page 253 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example MQTT logout AT+UMQTTC=0 +UMQTTC: 0,<MQTT_result> AT+UMQTTC=0 +UMQTTC: 0,1 MQTT login AT+UMQTTC=1 +UMQTTC: 1,<MQTT_result> AT+UMQTTC=1 +UMQTTC: 1,1 +UUMQTTC: 1,<login_result> +UUMQTTC: 1,0 MQTT publish to a topic AT+UMQTTC=2,<QoS>,<retain>, +UMQTTC: 2,<MQTT_result> AT+UMQTTC=2,0,0,"/sensor/heat/ [<hex_mode>],<topic>,<message> SD/bldg5/DelMarConfRm","23 degrees Celsius" +UMQTTC: 2,1 MQTT publish a file to a topic AT+UMQTTC=3,<QoS>,<retain>,...
  • Page 254 SARA-R4/N4 series - AT Commands Manual Type Syntax Response Example MQTT Message +UUMQTTCM: <op_code>,<num_ +UUMQTTCM: 6,1 Topic: "/sensor/ unread_msgs> [Topic Len: <topic_ heat/SD/bldg5/DelMarConfRm" length>] [Topic: <topic_name>] Len: 16 QoS: 0 Message: "16 bytes of [Len: <msg_length> Qos: <Qos>] data" Message: <message_contents> 24.5.3    Defined values Parameter Type Description...
  • Page 255: Mqtt Error +Umqtter

    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: A    Appendix: Error Result Codes

    SARA-R4/N4 series - AT Commands Manual A    Appendix: Error result codes A.1    Mobile termination error result codes +CME ERROR Numeric error code Description Phone failure No connection to phone Phone-adaptor link reserved Operation not allowed Operation not supported PH-SIM PIN required SIM not inserted SIM PIN required SIM PUK required SIM failure...
  • Page 257 SARA-R4/N4 series - AT Commands Manual Numeric error code 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 the TFT operation Syntactical error in the TFT operation Unknown PDP context Semantic errors in packet filter(s) Syntactical errors in packet filter(s)
  • Page 258 SARA-R4/N4 series - AT Commands Manual Numeric error code Description 1018 No user responding 1019 User alerting, no answer 1021 Call rejected 1022 Number changed 1026 Non selected user clearing 1027 Destination out of order 1028 Invalid number format (incomplete number) 1029 Facility rejected 1030 Response to STATUS ENQUIRY...
  • Page 259 SARA-R4/N4 series - AT Commands Manual Numeric error code Description 1542 LLC or SNDCP failure 1543 Regular deactivation 1544 Reactivation requested 1545 Single address bearers only allowed 1546 Invalid transaction identifier value 1547 APN restriction val incompatible with PDP context 1548 PDP activation rejected 1549 unknown PDP address or PDP type 1550...
  • Page 260: A.2    Message Service Error Result Codes +Cms Error

    SARA-R4/N4 series - AT Commands Manual Numeric error code Description 1700 GPS GPIO not configured 1701 GPS GPIO ownership error 1702 Invalid operation with GPS ON 1703 Invalid operation with GPS OFF 1704 Invalid GPS aiding mode 1705 Reserved GPS aiding mode 1706 GPS aiding mode already set 1707...
  • Page 261 SARA-R4/N4 series - AT Commands Manual Numeric error code Description Resources unavailable, unspecified Requested facility not subscribed Requested facility not implemented Invalid short message reference value Invalid message, unspecified invalid mandatory information Message type non-existent or not implemented Message not compatible with short message protocol state Information element non-existent or not implemented Protocol error, unspecified Interworking, unspecified...
  • Page 262 SARA-R4/N4 series - AT Commands Manual Numeric error code 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 aborted MS invalid TP-Message-Type-Indicator MS no TP-Status-Report in Phase 1 MS no TP-Reject-Duplicate in phase 1 MS no TP-Replay-Path in Phase 1 MS no TP-User-Data-Header in Phase 1...
  • Page 263 SARA-R4/N4 series - AT Commands Manual Numeric error code 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 Info Temporary Forbidden Call Attempt Called Party is Blacklisted Temporary Forbidden Call Attempt No Service Temporary Forbidden Call Attempt Limited Service...
  • Page 264: A.3    Firmware Install Final Result Codes

    SARA-R4/N4 series - AT Commands Manual Numeric error code 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 Triggered By MM...
  • Page 265 SARA-R4/N4 series - AT Commands Manual Numeric Description Resulting from the following commands error code ENOENT - No such resource (internal error) +USOCR, +USOSO, +USOGO, +USOCO, +USOWR, +USOST, +USORD, +USORF, +USOLI EINTR - Interrupted system call (internal error) +USOCR, +USOSO, +USOGO, +USOCO, +USOWR, +USOST, +USORD, +USORF, +USOLI EIO - I/O error (internal error)
  • Page 266: A.6    Internet Suite Error Classes

    SARA-R4/N4 series - AT Commands Manual Numeric Description Resulting from the following commands error code ECONNRESET - Connection reset by peer +USOCR, +USOSO, +USOGO, +USOCO, +USOWR, +USOST, +USORD, +USORF, +USOLI ENOBUFS - No buffer space available +USOCR, +USOSO, +USOGO, +USOCO, +USOWR, +USOST, +USORD, +USORF, +USOLI EISCONN - Transport endpoint is already connected +USOCO...
  • Page 267 SARA-R4/N4 series - AT Commands Manual <error_class> Description <error_codes> Resulting from following commands Socket error class BSD error codes standard All Dynamic Memory error 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.2 +UHTTP, +UHTTPC,...
  • Page 268 SARA-R4/N4 series - AT Commands Manual Numeric error code 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...
  • Page 269 SARA-R4/N4 series - AT Commands Manual Numeric error code 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.
  • Page 270: A.7    Mqtt Error Codes

    SARA-R4/N4 series - AT Commands Manual Numeric error code 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 46 - 72...
  • Page 271 SARA-R4/N4 series - AT Commands Manual Numeric error code 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 command parameter Invalid Error Length (or termination) Error in UMQTT parameter Range Error in UMQTT command parameter...
  • Page 272 SARA-R4/N4 series - AT Commands Manual Numeric error code 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 when attempting an MQTT Subscribe...
  • Page 273 SARA-R4/N4 series - AT Commands Manual Numeric error code Description -20007 Handshake successful (QAPI MQTT) -20008 The SSL certificate of the peer is trusted, CN matches the host name, time is expired (QAPI MQTT) -20009 The SSL certificate of the peer is trusted, CN does not match the host name, time is valid (QAPI MQTT) -20010 The SSL certificate of the peer is not trusted (QAPI MQTT)
  • Page 274 SARA-R4/N4 series - AT Commands Manual Numeric error code Description -150018 End of file (QAPI FS) -150019 Invalid ID was passed by the kernel framework (QAPI FS) -150020 Unknown error (QAPI FS) UBX-17003787 - R09 A    Appendix: Error result codes   Page 274 of 307...
  • Page 275: B    Appendix: At Commands List

    SARA-R4/N4 series - AT Commands Manual B    Appendix: AT Commands List Call control AT command SARA R404M-00B • • • R410M-01B • • • R410M-02B • • • R412M-02B • • • R410M-52B • • • N410-02B UBX-17003787 - R09 B    Appendix: AT Commands List  ...
  • Page 276 SARA-R4/N4 series - AT Commands Manual File System AT command SARA R404M-00B • • • • R410M-01B • • • • R410M-02B • • • • • • R412M-02B • • • • • • R410M-52B • • • • • • N410-02B •...
  • Page 277 SARA-R4/N4 series - AT Commands Manual General commands AT command SARA R404M-00B • • • • • • • • • • • • • R410M-01B • • • • • • • • • • • • • R410M-02B • • •...
  • Page 278 SARA-R4/N4 series - AT Commands Manual GPIO interface AT command SARA R404M-00B • • • R410M-01B • • • R410M-02B • • • R412M-02B • • • R410M-52B • • • N410-02B • • • UBX-17003787 - R09 B    Appendix: AT Commands List  ...
  • Page 279 SARA-R4/N4 series - AT Commands Manual I2C interface AT command SARA R404M-00B R410M-01B R410M-02B • • • • • R412M-02B • • • • • R410M-52B • • • • • N410-02B • • • • • UBX-17003787 - R09 B    Appendix: AT Commands List  ...
  • Page 280 SARA-R4/N4 series - AT Commands Manual Internet suite AT command SARA R404M-00B • • • • • • • R410M-01B • • • • • • • • • R410M-02B • • • • • • • • • R412M-02B • • •...
  • Page 281 SARA-R4/N4 series - AT Commands Manual Localization features AT command SARA R404M-00B R410M-01B R410M-02B • • • • • • • • • • • • • • • • • R412M-02B R410M-52B • • • • • • • • • •...
  • Page 282 SARA-R4/N4 series - AT Commands Manual Mobile equipment control and status AT command SARA R404M-00B • • • • • • • • R410M-01B • • • • • • • • R410M-02B • • • • • • • • R412M-02B •...
  • Page 283 SARA-R4/N4 series - AT Commands Manual Network service AT command SARA R404M-00B • • • • • • • • R410M-01B • • • • • • R410M-02B • • • • • • • • • • • • R412M-02B • •...
  • Page 284 SARA-R4/N4 series - AT Commands Manual Packet switched data services AT command SARA R404M-00B • • • • • • • • • R410M-01B • • • • • • • • • R410M-02B • • • • • • • • •...
  • Page 285 SARA-R4/N4 series - AT Commands Manual Security AT command SARA R404M-00B • • • R410M-01B • • • R410M-02B • • • R412M-02B • • • R410M-52B • • • N410-02B • • • UBX-17003787 - R09 B    Appendix: AT Commands List   Page 285 of 307...
  • Page 286 SARA-R4/N4 series - AT Commands Manual Serial interface AT command SARA R404M-00B • • • • • • • • • • • • • • • • • • • • • • • R410M-01B • • • • • • •...
  • Page 287 SARA-R4/N4 series - AT Commands Manual Serial interface AT command SARA R404M-00B • • • R410M-01B • • • R410M-02B • • • R412M-02B • • • R410M-52B • • • N410-02B • • • UBX-17003787 - R09 B    Appendix: AT Commands List  ...
  • Page 288 SARA-R4/N4 series - AT Commands Manual Short Messages Service AT command SARA R404M-00B • • • • • • • • • • • • • • • • R410M-01B • • • • • • • • • • • • •...
  • Page 289 SARA-R4/N4 series - AT Commands Manual SIM functionalities AT command SARA R404M-00B R410M-01B R410M-02B • • • • • • • R412M-02B • • • • • • • R410M-52B • • • • • • • N410-02B • • • • •...
  • Page 290 SARA-R4/N4 series - AT Commands Manual System features AT command SARA R404M-00B • • • • • • • R410M-01B • • • • • • • • R410M-02B • • • • • • • • R412M-02B • • • • •...
  • Page 291 SARA-R4/N4 series - AT Commands Manual Internet protocol transport layer AT command SARA R404M-00B • • • • • • • • • • • • • • • • • • • • R410M-01B • • • • • • • •...
  • Page 292: B.1    Parameters Stored In Profiles

    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: B.2    Parameters Stored In Non Volatile Memory

    SARA-R4/N4 series - AT Commands Manual AT command Description AT interface Factory-programmed value / Remarks configuration sharing DCE response 1 (Verbose response text) format Result code selection 4 (CONNECT <text> result code is given upon entering online and call progress data state; dial tone and busy detection are both enabled) monitoring control B.2    Parameters stored in non volatile memory The following table lists the AT commands which setting can be stored in the non volatile memory with their...
  • Page 294: B.3    Saving At Commands Configuration

    SARA-R4/N4 series - AT Commands Manual AT command Description Factory-programmed value / Comment <nv_upd_freq>: 60 (NVM update frequency in seconds) <tx_count>: 1 (number of times to transmit the Last Gasp message) +ULOCGNSS Configure GNSS sensor • 15 (Local aiding, AssistNow online, AssistNow offline, AssistNow autonomous enabled), 0 (power saving disabled), 3 (Minimum number of satellites for navigation), 7 (Minimum satellite signal level for navigation), 0 (Disabled initial Fix must be 3D flag), 0 (Static...
  • Page 295: B.5    Multiple At Command Interfaces

    SARA-R4/N4 series - AT Commands Manual Category Estimated maximum time to get Commands response Internet suite (socket +USOSEC • SARA-R4 / SARA-N4 - < 1 s connect with SSL) Internet suite (socket +USOWR • SARA-R4 / SARA-N4 - < 120 s write) Internet suite (UDP +USOST •...
  • Page 296 SARA-R4/N4 series - AT Commands Manual AT command UART / AUX UART Multiplexer USB (where available) SPI (where available) (where available) change the value in the change the value in the AT command profile) AT command profile) +ICF Effective Returns OK, but it is not Returns OK, but it is not Returns OK, but it is not effective (only change the...
  • Page 297: C    Appendix: Udp Direct Link Workflow

    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)
  • Page 298 SARA-R4/N4 series - AT Commands Manual Event: new data from external port Reset sending timer Put data into New data + data intermediate into intermediate Finish, buffer and buffer event is < than w ait sending handled max_packet_size timer expires or new data Send max_packet_size of data to IP netw ork Remaining...
  • Page 299: D    Appendix: Glossary

    SARA-R4/N4 series - AT Commands Manual D    Appendix: Glossary 2nd Generation 3rd Generation 3GPP 3rd Generation Partnership Project Analog to Digital Converter AIeC Automatically Initiated eCall Abbreviated Dialing Numbers Adaptive Multi Rate Access Point Access Point Name ASCII American Standard Code for Information Interchange AT Command Interpreter Software Subsystem, or attention Black List Berkley Standard Distribution...
  • Page 300 SARA-R4/N4 series - AT Commands Manual FOAT Firmware Over AT FOTA Firmware Over The Air File System File Transfer Protocol Firmware FWINSTALL Firmware Install Grouping information Alpha String GPIO General Purpose Input Output GPRS General Packet Radio Service Global Positioning System Global System for Mobile Communications HDLC High Level Data Link Control Home Node B...
  • Page 301 SARA-R4/N4 series - AT Commands Manual Personal Communication Network Packet Data Protocol Protocol Data Unit Personal Identification Number PLMN Public Land Mobile Network Point-to-Point Protocol PSAP Public Safety Answering Point (eCall related) Packet-Switched Data Personal Unblocking Key Quality of Service Random Access Memory Restricted Digital Information Reserved for Future Use RNDIS...
  • Page 302: Related Documents

    SARA-R4/N4 series - AT Commands Manual Related documents 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.04 - Digital cellular telecommunication system (Phase 2+);...
  • Page 303 SARA-R4/N4 series - AT Commands Manual 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.02 - Multiplexing and Multiple Access on the Radio Path EVK-G25H Evaluation Kit User Guide, Docu No GSM.G1-EK-09022 3GPP TS 51.014 - Specification of the SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface...
  • Page 304 SARA-R4/N4 series - AT Commands Manual 3GPP TS 51.010-2 Mobile Station (MS) conformance specification; Part 2: Protocol Implementation Conformance Statement (PICS) proforma specification 3GPP TS 34.121-2 User Equipment (UE) conformance specification; Radio transmission and reception (FDD); Part 2: Implementation Conformance Statement (ICS) u-blox Firmware Update Application Note, Docu No UBX-13001845 PCCA standard - Command set extensions for CDPD modems, Revision 2.0, March, 1998 3GPP TS 24.301 Non-Access-Stratum (NAS) protocol for Evolved Packet System (EPS);...
  • Page 305 SARA-R4/N4 series - AT Commands Manual 123. RFC 3966 - The tel URI for Telephone Numbers 124. RFC 2141 - URN Syntax 125. RFC 3406 - Uniform Resource Names (URN) Namespace Definition Mechanisms 126. RFC 5031 - A Uniform Resource Name (URN) for Emergency and Other Well-Known Services 127.
  • Page 306: Revision History

    SARA-R4/N4 series - AT Commands Manual Revision history Revision Date Name Comments 27-Jan-2017 jole Initial release 03-Apr-2017 jole Removed +UPSV. Added +CPSMS. General document clean-up 04-May-2017 jole Added SARA-R410M 24-May-2017 jole Moved to Advance Information for SARA-R404M 19-Jul-2017 jole Extended document applicability to SARA-R410M-02B. Added +ULWM2M, +ULWM2MSTAT and +CNUM.
  • Page 307: Contact

    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. u-blox AG u-blox Singapore Pte. Ltd. Phone: +1 703 483 3180 Phone: +41 44 722 74 44 Phone: +65 6734 3811 E-mail:...

Table of Contents

Save PDF