MQTT Gateway configuration
REQUIREMENTS TO CONNECT YOUR BOX TO YOUR MQTT BROKER :
- Broker Address
- MQTT Port (1883,8883,etc..)
- Client ID
- Authentication information (if required)
- Certificate (if required)
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.
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.
ADVANCED TAB :
A new feature (available since firmware APPS 6.1.3) allows customization of the Uplink Topic format (per equipment or per property) in order to publish the data to monitoring / controlling software.
MQTT uplink topics structure can be defined according to your needs, using variables and strings. This structure will generate MQTT topics for each redirected property.
The following variables can be combined in the uplink topic structure :
1. equipment name
2. equipment ID
3. property name
4. property ID
5. gateway ID
This feature has been added in order to avoid using slugs to group data. When you used slugs, you had to have a script in your MQTT broker to parse the message and access the slug, and then aggregate the data.
So, you can build the topic structure at your convenience by mixing simple texts / Equipements ID / Properties ID …
Since the APPS 6.1.3 firmware version, you can add a wildcard (#) in the downlink topic settings. This multi-level wildcard (#) covers multiple topic levels and must be placed at the end of the topic format.
When a downlink topic finishes with /#, it receives all messages starting with the text before the wildcard character. If the subject is only "#", the client receives all the messages.
Example : If the downlink topic format is
Room1 / Sensor1 / #
Messages sent to the MQTT broker :
|Room1 / Sensor1 / Temperature
|Room1 / Sensor1 / Pressure
|Room1 / Sensor2 / Temperature
Uplink Topic (A) :
Downlink Topic (B) :
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
|Be sure that the Access Type stay as LOCAL in this configuration.