MQTT

Hinweis: Diese Seite beschreibt QuickHMI als MQTT-Client, der Daten von einem fremden Broker konsumiert. Soll QuickHMI umgekehrt seine eigenen Variablen als eingebetteter MQTT-Broker bereitstellen, lesen Sie Datenbereitstellung über MQTT.

Die Datenquellen-Eingabe-Maske öffnen sich, in der Sie als ersten Schritt die MQTT Datenquelle als „Typ“ auswählen können.

Vergeben Sie für die Datenquelle jedoch erst einen Namen und enthält dieser das Wort „mqtt“, so wird „MQTT“ schon als Datenquellen-Typ vorgewählt. (Dies funktioniert mit allen Datenquellen-Typen)

Nachdem dies geschehen ist, passen sich die Datenquellen-spezifischen Einstellungen der MQTT Datenquelle automatisch an.

MQTT Spezifisch

  • TLS

Hier haben Sie die Möglichkeit, MQTT-Verbindungen mit TLS zu sichern. Durch TLS ist die Verbindung verschlüsselt.

  • Host

Geben Sie hier den zu verwendenden Host (Broker) mit dem entsprechenden Port an.

  • Authentifizierung

Der Authentifizierungsmodus bestimmt, welche Felder relevant sind:

  • Deaktiviert – keine Anmeldung.
  • Login – Anmeldung mit Benutzername und Passwort.
  • Zertifikat – gegenseitige TLS-Authentifizierung (mTLS) mit Client-Zertifikat. Erfordert aktiviertes TLS (wird bei Auswahl automatisch eingeschaltet).

TLS und Zertifikate (pro Datenquelle)

Bei aktiviertem TLS hinterlegen Sie die Zertifikate direkt an der Datenquelle:

  • CA-Zertifikat – zur Prüfung des Broker-Server-Zertifikats (z. B. eine private CA). Ohne hinterlegtes CA-Zertifikat werden die Standard-Vertrauensanker der Java-Laufzeit verwendet.
  • Client-Zertifikat + Client-Schlüssel (+ optionales Schlüssel-Passwort) – nur bei Modus Zertifikat, als mTLS-Identität.

Unterstützte Schlüsselformate: PKCS#1 und PKCS#8 (auch die von OpenSSL 3 standardmäßig erzeugten PKCS#8-Schlüssel).

  • Persistente Session

Hier können Sie über die Checkbox, die Persistente Session aktivieren. Bei Verwendung einer „Persistent Session“, wird zwischen dem QuickHMI Server und dem MQTT – Broker eine Kennung ausgetauscht.

Anhand dieser Kennung wird der QuickHMI Server vom MQTT – Broker wiedererkannt, falls Sie den QuickHMI Server kurzzeitig herunterfahren, oder ein Verbindungsabbruch zustande kommt. Bei einer Wiederverbindung mit dem Broker, werden alle zwischenzeitlich verpassten Variablen-Änderungen übertragen.

Nach Eingabe der für die Verbindung relevanten Informationen klicken Sie auf „Hinzufügen“ bzw. auf „Speichern“ nach der Bearbeitung einer bereits angelegten Datenquelle.

Die MQTT Datenquelle wird angelegt und nachfolgend in der Datenquellen – Übersicht angezeigt.

Angelegte Datenquellen, können bearbeitet oder auch wieder gelöscht werden. Dies tun Sie über die entsprechenden Buttons.

Zudem haben Sie die Möglichkeit, sich allen internen Datenquellen anzeigen zu lassen. Dies funktioniert über die Aktivierung der Checkbox „Zeige interne Datenquellen“.


Wie Sie für die MQTT Datenquelle Variablen hinzufügen, erfahren Sie im Kapitel „MQTT Variablen hinzufügen“.