Skip to main content
MQTTBox
Updated over 2 years ago

From release 1.6.0.0 the MqttBox feature is available.

It provides a Mqtt client who publishes the data collected on a Mqtt broker.

Setting the MqttBox functionality

Client configuration access

Go to the General Configuration page of the upstream box and select the MqttBot or Indabox & MqttBox operating mode to display the configuration options.

Client Configuration

Mqtt broker settings

Client Id

Client identification mqtt

Url

Web address of the broker mqtt

Port

Broker port mqtt, example: 8883

Publication methods

2 publication modes are available:

  • Publishing by tag: each configured tag will have its own topic. Example for a tag named “temperature” associated with the site “site1” on the equipment “device1”: its value will be published by default in the topic “site1/device1/temperature”

  • Publication by file: as part of a large number of tags to be published (10,000 and more) it may be more relevant to choose a publication by file that will be more efficient, in this case several tags are published in a single topic that can be configured in a json file.

Authentification mode

Connection Mode

2 connection modes are available:

  • Login/Password: authentication by username and password

  • PEM Certificates: authentication by certificates in PEM format

These files are provided by the broker.

Configuration of the data to be published

From the interface

  • Publication by file

The publication topic is configured from the general configuration when the “File Publishing” option is enabled.

  • Tag post

The selected publishing mode must be “Tag Publishing” to access this option.

The topic setting is done at the level of each tag of each equipment: go to the “Data source” page, then display the list of variables of an equipment and edit a variable.

The “Generate” button suggests a topic for the variable consisting of [site name]/[equipment name]/[tag name].

From export/import

In the context of publishing by tag, when exporting data from the data source view, a column is made available in the variables tab of the Excel file to fill in the topic of a variable.

If the topic is empty the variable will not be published.

Notes

  • If a change in publication mode is made, the data from the previous mode is ignored, for example: if a publication by tag is enabled and topics are configured, in case of switching to file publishing mode these topics will be ignored and the topic of the general configuration will be taken into account.

  • Documentation on converting various certificate formats to PEM Certificate conversions

Did this answer your question?