EasyManua.ls Logo

Ublox SARA-R4 Series User Manual

Ublox SARA-R4 Series
307 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Page #247 background imageLoading...
Page #247 background image
SARA-R4/N4 series-AT Commands Manual
UBX-17003787 - R09
24MQTT
Page 247 of 307
24MQTT
The MQ Telemetry Transport (MQTT) protocol specifies a simple and lightweight messaging protocol,
designed for constrained devices and low-bandwidth, high-latency, or unreliable networks. An MQTT client
uses publish and subscribe methods to interact over a TCP connection with an MQTT message broker
(henceforth referred to as an MQTT server). The u-blox modules can be configured to operate as an MQTT
client.
To publish or subscribe, the MQTT client must first establish a TCP connection to an MQTT server.
The MQTT protocol specifies case-sensitive Topics, with Topic Names containing Topic Level separators "/" to
which messages will be published. For example, a message of "78 Fahrenheit or 25 Celsius" could be published
to the Topic Name of "/heat/sensor/SD/bldg5/DelMarConfRm". MQTT clients subscribe to Topic Filters to
determine if the client receives messages published to a given Topic name.
The Topic Filters may exactly specify a Topic Name or may contain either of the following wildcards:
'+' - (Single level wildcard) applies to a single Topic Level
'#' - (Multi-level wildcard) applies to potentially many Topic Levels (and must be the last character specified
in a Topic Filter);
'#' can be specified on its own or following a topic level separator ('/'). For example, the Topic Filter, "/heat/
sensor/SD/#", would receive any messages published to the "/heat/sensor/SD/bldg5/DelMarConfRm" Topic
Name.
MQTT specification states that Topic Filters starting with either wildcard will not match any Topic Name
that starts with "$".
The MQTT protocol also specifies a Quality of Service (QoS) level to be applied to message transactions:
0 - At most once delivery [default]
1 - At least once delivery
2 - Exactly once delivery
The MQTT protocol also allows an MQTT client to create a Will message, which the MQTT remote server
will store and only publish (to the Topic name specified as the Will Topic name) when the MQTT client gets
disconnected from the MQTT server, but not if the MQTT client explicitly sends a disconnect command.
24.1MQTT profile configuration +UMQTT
+UMQTT
SARA-R410M-02B SARA-R410M-52B SARA-R412MModules
SARA-N4
Syntax PIN required Settings saved Can be aborted Response time Error referenceAttributes
full No No No - MQTT Error
24.1.1Description
Configures or reads the parameter value of an MQTT client profile. Issue a set command for each <op_code>
parameter to set all of the parameters in an MQTT client profile.
24.1.2Syntax
Type Syntax Response Example
Generic syntax
Set AT+UMQTT=<op_code>[,
<param1>[,<param2>]]
+UMQTT: <op_code>,<result>
OK
AT+UMQTT=12,1
+UMQTT: 12,1
OK
MQTT unique client ID
Set AT+UMQTT=0,<client_id> +UMQTT: 0,<result>
OK
AT+UMQTT=0,"352753090041680"
+UMQTT: 0,1
OK
MQTT local TCP port number

Table of Contents

Other manuals for Ublox SARA-R4 Series

Question and Answer IconNeed help?

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

Ublox SARA-R4 Series Specifications

General IconGeneral
Operating Temperature-40°C to +85°C
CategoryCellular Module
TechnologyLTE Cat M1, LTE Cat NB1
Frequency BandsB1, B2, B3, B4, B5, B8, B12, B13, B18, B19, B20, B25, B26, B28, B39
InterfacesUART, USB, I2C, GPIO
ProtocolsTCP/IP, UDP, HTTP, HTTPS, MQTT, LWM2M
SecurityTLS/SSL, DTLS, Secure Boot
CertificationsGCF, 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.

Security

8.1 Enter PIN +CPIN

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

Short Messages Service

9.11 Send message +CMGS

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

V24 control and V25ter

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.

System features

14.1 Firmware installation +UFWINSTALL

Triggers the firmware installation procedure, causing a system reset.

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.

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

HTTP

GNSS

22.2 GNSS power management +UGPS

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

MQTT

24.1 MQTT profile configuration +UMQTT

Configures or reads the parameters of an MQTT client profile.

Appendix: Error result codes

A.1 Mobile termination error result codes +CME ERROR

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

Related product manuals