• EUR€
  • £GBP
  • $USD

UART OBLOQ IoT Module Tutorial 7: Subscribing to MQTT topic

DFRobot Oct 18 2018 1448

In this tutorial we will explain how to subscribe to a MQTT topic using UART OBLOQ.

As a MQTT broker, we will use CloudMQTT. CloudMQTT is a cloud based broker for the Internet of Things. It offers a free plan which allows us to test without having to pay for a subscription. You can check here in more detail how to connect OBLOQ to CloudMQTT.

We are going to use a Serial to USB converter to connect OBLOQ to a computer and to send commands from a serial software. You can check the electronic schematic here. We are going to use the Arduino IDE serial monitor as a tool to send the serial commands.

As an additional tool, we will use MQTTLens, which allows to connect to a MQTT broker and publish and subscribe to topics. We will use it to publish the message that the OBLOQ will receive from the subscribed topic. Please check here how to connect MQTTLens to the CloudMQTT broker. This is described in the “MQTTLens” section.


The commands

The first part is similar to what we have been covering in the previous tutorials. Basically, we start by connecting the OBLOQ to a WiFi network with the following command:


After that connection is established, OBLOQ will return the IP assigned to the device on that network and, after that, we can establish the connection to the MQTT broker. To do it, we use the following command:


Remember from the previous post that we can obtain all of the parameters needed in the command from the details page of the CloudMQTT broker instance.

Now, to subscribe to a topic, we simply need to send the following command, changing topicName by the name of the topic to which we want to subscribe:


We will be subscribing to a topic named “test“, as illustrated in the command below at figure 1.

UART OBLOQ topic subscription command

Figure 1 – Command to subscribe to a topic names “test”.

On success, OBLOQ should answer with |4|1|2|1|, as shown below in figure 2.

OBLOQ subscribe to MQTT topic command response.png

Figure 2 – Answer to the command.

Now, to send the message, open MQTTLens. I’m assuming the connection to the CloudMQTT broker was already configured. As mentioned, you can check this previous post, which explains how to do it.

On the connection menu, on the publish section, write “test” as the name of the topic and write the message to send on the corresponding text area. When finished, click the “Publish” button. All the areas mentioned are highlighted in figure 3.

MQTTLens send message to OBLOQ subscribed topic.png

Figure 3 – Publish message from MQTTLens.

Upon sending the message, you can go back to the Arduino IDE serial monitor. OBLOQ should return the message in the following format:


You can check the expected result in figure 4.

UART OBLOQ message from subscribed topic

Figure 4 – Message received by OBLOQ from the subscribed topic.

UART OBLOQ module Tutorials: