The data source input screen opens, in which you can select the MQTT data source as “Type” as the first step.
However, if you first assign a name to the data source and it contains the word “mqtt“, “MQTT” is already preselected as the data source type. (This works with all data source types)
Once this has been done, the data source-specific settings of the MQTT data source are automatically adjusted.
MQTT specific
- TLS
Here you have the option of securing MQTT connections with TLS. The connection is encrypted using TLS.
- Host
Enter the host (broker) to be used with the corresponding port here.
- Authentication
If TLS is deactivated, you have the option here to decide whether you want to authenticate yourself with a user name and password.
To do this, select “Access data“. If not, leave authentication deactivated.
If TLS is activated, you can choose here between authentication via access data and certificate.
The certificates and keys can be imported via the project settings. However, the settings only apply to the connection to the broker from the Editor.
Certificates and keys for the runtime must be imported in the Runtime Manager.
- Persistent session
Here you can activate the persistent session via the checkbox. When using a “Persistent Session“, an identifier is exchanged between the QuickHMI server and the MQTT broker.
This identifier is used by the MQTT broker to recognize the QuickHMI server if you shut down the QuickHMI server for a short time or if the connection is lost. When reconnecting to the broker, all variable changes that have been missed in the meantime are transferred.
After entering the relevant information for the connection, click on “Add” or on “Save” after editing an already created data source.
The MQTT data source is created and subsequently displayed in the data source overview.
Created data sources can be edited or deleted again. You can do this using the corresponding buttons.
You also have the option of displaying all internal data sources. This works by activating the “Show internal data sources” checkbox.
You can find out how to add variables for the MQTT data source in the chapter “Adding MQTT variables“.
