Ublox SARA-R4 Series User Manual

SARA-R4/N4 series-AT Commands Manual
UBX-17003787 - R09

24MQTT
Page 248 of 307
Type Syntax Response Example
Set AT+UMQTT=1,<local_port> +UMQTT: 1,<result>
OK
AT+UMQTT=1,1883
+UMQTT: 1,1
OK
MQTT server name
Set AT+UMQTT=2,<server_name>[,
<server_port>]
+UMQTT: 2,<result>
OK
AT+UMQTT=2,
"www.commercialmqttbroker.com"
+UMQTT: 2,1
OK
MQTT server IP address
Set AT+UMQTT=3,<IP_address>[,
<server_port]
+UMQTT: 3,<result>
OK
AT+UMQTT=3,"192.168.1.0",1883
+UMQTT: 3,1
OK
User name and password
Set AT+UMQTT=4,<username>,
<password>
+UMQTT: 4,<result>
OK
AT+UMQTT=4,"test","abc123"
+UMQTT: 4,1
OK
Inactivity timeout
Set AT+UMQTT=10,<timeout> +UMQTT: 10,<result>
OK
AT+UMQTT=10,3600
+UMQTT: 10,1
OK
MQTT secure option
Set AT+UMQTT=11,<MQTT_secure>[,
<USECMNG_profile>]]
+UMQTT: 11,<result>
OK
AT+UMQTT=11,1,2
+UMQTT: 11,1
OK
MQTT clean session
Set AT+UMQTT=12,<clean_session> +UMQTT: 12,<result>
OK
AT+UMQTT=12,1
+UMQTT: 12,1
OK
Read AT+UMQTT? +UMQTT: <(more)>
OK
+UMQTT: (more)
OK
Test AT+UMQTT=? +UMQTT: (list of supported <op_
code>s)
OK
+UMQTT: (0-4,10-12)
OK
URC +UUMQTT<op_code>: <param1>[,
<param2>]
+UUMQTT0: "352753090041680"
24.1.3Defined values
Parameter Type Description
<op_code> Number MQTT parameter:
• 0: MQTT unique client id
• 1: MQTT local port number
• 2: MQTT server name
• 3: MQTT IP address
• 4: MQTT username and password
• 6: MQTT Will QoS value; the set command is not supported
• 7: MQTT Will Retain value; the set command is not supported
• 8: MQTT Will Topic; the set command is not supported
• 9: MQTT Will Message; the set command is not supported
• 10: MQTT inactivity timeout period
• 11: MQTT secure
• 12: MQTT clean session
• 14: MQTT Terse/Verbose mode; the set command is not supported

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