Creating MQTT data sources
The data source input mask opens, in which you can select the MQTT data source as "Type" as a first step. However, if you first assign a name to the data
source and if this contains the word "mqtt", then "MQTT" is already preselected as the data source type. (This works with all data source types)
After this, the data source-specific settings adapt automatically to the MQTT data source.
MQTT Specific:
- TLS
Here you have the option to secure MQTT connections with TLS. TLS encrypts the connection.
- Host
Enter here the host (broker) to be used with the corresponding port.
- Authentication
If TLS is disabled, you have the option here to decide whether you want to authenticate with a username and password.
To do this, select "Login credentials". If not, leave authentication disabled.
If TLS is enabled, you can choose between authentication via login credentials and certificate here. Any certificates and keys required for the connection
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. >>Project settings
- Persistent Session
Here you can activate the persistent session with the checkbox. You can also activate the "Persistent Session".
When using a persistent session, an identifier is exchanged between the QuickHMI Server and the MQTT broker.
This identifier is used to recognize the QuickHMI Server from the MQTT broker if you temporarily shut down the QuickHMI Server or if a connection is lost.
When reconnecting to the broker, any variable changes that have been missed in the meantime are transferred.
After entering the information relevant for the connection, click on "Add".
And after editing an already created data source, click on "Save".
The MQTT data source is created and subsequently displayed in the data source overview.
Created data sources can be edited or deleted. You do this via the corresponding buttons. You also have the option of viewing all internal data sources.
This works by activating the checkbox "Show internal data sources".
Below you can create variables for the MQTT data source.
You can find out how to add variables for the MQTT data source in the “Adding MQTT variables” chapter: