Ublox SARA-R4 Series User Manual

SARA-R4/N4 series-AT Commands Manual
UBX-17003787 - R09

22GNSS
Page 237 of 307
22.15Get satellite information +UGGSA
+UGGSA
SARA-R410M-02B SARA-R410M-52BModules
SARA-N4
Syntax PIN required Settings saved Can be aborted Response time Error referenceAttributes
full No NVM No < 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. If <state> parameter is enabled, the last value of NMEA $GSA messages can be retrieved with the read
command even when the GNSS is switched off.
The NMEA $GSA messages are volatile.
22.15.2Syntax
Type Syntax Response Example
Set AT+UGGSA=<state> OK AT+UGGSA=1
OK
Read AT+UGGSA? +UGGSA: <state>,<$GSA msg>
OK
+UGGSA: 1,$GPGSA,A,1,,,,,,,,,,,,,99.99,
99.99,99.99*30
OK
+UGGSA: 0,NULL
OK
Test AT+UGGSA=? +UGGSA: (list of supported
<state>s)
OK
+UGGSA: (0-1)
OK
22.15.3Defined values
Parameter Type Description
<state> Number
• 0 (factory-programmed value): to disable the NMEA $GSA messages
• 1: to enable the NMEA $GSA messages
<$GSA msg> String NMEA $GSA messages or "Not available" if the NMEA string is enabled, but this
information has not been still sent to the user.
22.16Ask for localization information +ULOC
+ULOC
SARA-R410M-02B SARA-R410M-52BModules
SARA-N4
Syntax PIN required Settings saved Can be aborted Response time Error referenceAttributes
full No No No < 10 s +CME Error
22.16.1Description
Requests cellular module to provide the location data; the location can be determined using:
• GNSS receiver
• CellLocate
®
(location based on network cells data)
• Combination of both technologies (hybrid)
The final result code indicates if sending the command request to the localization information process was
successful or not. The URC is issued to provide the requested information via +ULOC set command.
The GNSS interface and CellLocate
®
can be used at the same time: if the GNSS sensor is reserved to another
interface an error result code is provided ("+CME ERROR: GPS busy" if +CMEE=2).
It is possible to configure the Hybrid Positioning through +ULOCGNSS and +ULOCCELL AT commands even if
it is running: the parameters are stored in NVM and will be applied at the next +ULOC command.

Ublox SARA-R4 Series Specifications

General

Operating Temperature	-40°C to +85°C
Category	Cellular Module
Technology	LTE Cat M1, LTE Cat NB1
Frequency Bands	B1, B2, B3, B4, B5, B8, B12, B13, B18, B19, B20, B25, B26, B28, B39
Interfaces	UART, USB, I2C, GPIO
Protocols	TCP/IP, UDP, HTTP, HTTPS, MQTT, LWM2M
Security	TLS/SSL, DTLS, Secure Boot
Certifications	GCF, PTCRB, CE, FCC, IC

Summary

AT command settings

General operation

2.1 Start up and initialization

Describes the cellular device boot process, SIM card initialization, and potential operational restrictions.

General

Mobile equipment control and status

5.2 Set module functionality +CFUN

Selects the level of functionality for the module, including reset options.

Call control

6.1 Dial command D

Initiates calls (voice, data, fax) and controls supplementary services using dialling strings.

Network service

7.2 Signal quality +CSQ

Returns the Received Signal Strength Indication (RSSI) and signal quality.

7.4 Operator selection +COPS

Forces an attempt to select and register with a network operator, supporting manual or automatic selection.

7.6 Network registration status +CREG

Security

8.1 Enter PIN +CPIN

Enters the PIN code to unlock the SIM card and manage password states.

Short Messages Service

9.2 Select message service +CSMS

9.11 Send message +CMGS

Sends a message from DTE to the network (SMS-SUBMIT) and returns a message reference.

V24 control and V25ter

10.9 UART data rate configuration +IPR

SIM management

11.1 Generic SIM access +CSIM

Allows direct control of the SIM by transmitting commands via MT.

Packet switched data services

13.1 PDP contexts and parameter definition

Defines primary and secondary PDP contexts and their activation procedures.

13.3 PDP context definition +CGDCONT

Defines connection parameters for a PDP context, identified by a local context ID.

13.6 PDP context activate or deactivate +CGACT

System features

14.1 Firmware installation +UFWINSTALL

Triggers the firmware installation procedure, causing a system reset.

14.4 Power saving control (Power SaVing) +UPSV

14.7 Power Saving Mode Setting +CPSMS

Enables and configures the Power Saving Mode (PSM) parameters on the UE.

GPIO

15.2 GPIO select configuration command +UGPIOC

Configures GPIO pins as input, output, or for custom functions.

Internet protocol transport layer

18.3 Create Socket +USOCR

Creates a socket and associates it with a specified protocol (TCP or UDP).

18.4 SSL/TLS mode configuration on TCP socket +USOSEC

Enables or disables SSL/TLS connection on a TCP socket using USECMNG profiles.

18.9 Connect Socket +USOCO

SSL/TLS

19.2 SSL/TLS certificates and private keys manager +USECMNG

Manages X.509 certificates and private keys: import, list, retrieve, and remove.

19.3 SSL/TLS security layer profile manager +USECPRF

Manages security profiles for SSL/TLS connection configuration properties.

FTP

20.1 FTP service configuration +UFTP

20.2 FTP command +UFTPC

HTTP

21.1 HTTP control +UHTTP

21.3 HTTP command +UHTTPC

GNSS

22.2 GNSS power management +UGPS

Switches the GNSS receiver on/off and configures aiding types for faster TTFF.

22.5 Aiding server configuration +UGSRV

22.16 Ask for localization information +ULOC

MQTT

24.1 MQTT profile configuration +UMQTT

Configures or reads the parameters of an MQTT client profile.

24.5 MQTT command +UMQTTC

Appendix: Error result codes

A.1 Mobile termination error result codes +CME ERROR

Lists numeric error codes and their descriptions for mobile termination errors.

A.2 Message service error result codes +CMS ERROR

A.5 Internal TCP/UDP/IP stack class error codes