How to create an MQTT Gateway? – Wattsense Support Portal

browse

The MQTT gateway will allow you to get data coming from a Box/Hub direclty in your MQTT broker.

MQTT Gateway configuration

REQUIREMENTS TO CONNECT YOUR BOX TO YOUR MQTT BROKER :

You'll need your MQTT broker connection information

Broker Address
MQTT Port (1883,8883,etc..)
Client ID
Authentication information (if required)
Certificate (if required)

These informations should be available in your Broker configuration, if not please contact your Broker provider.

First of all, you'll need to create a new MQTT gateway:

Fill the required Fields with your MQTT broker parameters.

TOPIC DEFINITION:

Uplink topic and Downlink topic are simple strings conformed to one or more topic levels. For instance, topics are case-sensitive.

Each topic is structured with forward slash as delimiters. The forward slash alone is a valid topic.

The broker uses the topics to filter the messages for each client subscribed to the topic

AUTHENTICATION:

If your MQTT broker require an authentication with Username and Password click on the Authentication button and fill the fields.

TLS CERTIFICATE

IMPORTANT INFORMATION ABOUT SECURITY IN MQTT SSL/TLS:

The default port for MQTT TLS connection is : 8883

This implies a connection using certificates. Certificates are security files that allows you to authenticate to your broker. If you are using a TLS secured authentication please be sure that you have loaded your CA certificate.

TIPS

It can happen that your broker is not using custom CA certificate but Public one.

In that case, you will still have to load them in the Box. Because we do not stored them by default.

Knowing that, you can now click on the TLS box if you need to specify any kind of certificates.

ADVANCED TAB:

In this advanced tab, the most important field is the Slug name

A Slug is the field that will be identify a property when you will receive it in your broker.

Here is the data format you will received:

Uplink Topic (A):

Here is the format your broker MQTT will received:

Uplink Topic Format:

[{"propertyId":"Slug Name","timestamp":1608652394220.0,"value":12},{"propertyId":"Slug Name","timestamp":1608652394222.0,"value":123456}]

Downlink Topic (B):

Here is format that your broker MQTT has to respect to send a command:

Downlink Topic Format:

{"propertyId":"Slug Name","requestType":"write","value":XX}

It will define what will be the value of the PropertyId field of each of your futur gateway properties.

By default it will be Protocol and Property Slug

Example:

If we have a Lorawan sensor with a temperature property, the Slug would be:

"PropertyID" : "Lorawan-MyUniqueSlug1234"

NOTE

Property Slug is the uniqueID of a variable, you'll find it in the property configuration itself

Please note that your modifications will be aplied for ALL properties in the Gateway.

MQTT Gateway property configuration

To add properties to your gateway, select the properties button:

Then add Property:

On the next view you'll have the choice between all the properties available, select the one you want to redirect to your MQTT broker and click on Save

Once the properties select, you'll have that kind of view:

Click on "Save changes" to apply the modifications.