Mit der integrierten Testfunktion können konfigurierte MQTT-Verbindungen und deren Datenpunkte überprüft werden.
Damit lässt sich feststellen, ob der MQTT-Broker erreichbar ist und ob die konfigurierten MQTT-Datenpunkte die erwarteten Werte liefern.
Auf diese Weise können insbesondere folgende Einstellungen geprüft werden:
-
Topic
-
Quality of Service (QoS)
-
Transformator-Typ
-
Datentyp
So lassen sich Konfigurationsfehler frühzeitig erkennen und Einstellungen prüfen, bevor sie dauerhaft übernommen werden.
Funktion
Für die Testfunktion stehen zwei Schaltflächen zur Verfügung:
-
Status aktualisieren
-
Änderungen testen
Abhängig vom aktuellen Zustand der Konfiguration ist jeweils nur eine der beiden Schaltflächen aktiv.
Status aktualisieren
Mit Status aktualisieren wird die aktuell gespeicherte Konfiguration geprüft.
Dabei können:
-
der Status der MQTT-Verbindung aktualisiert,
-
die Erreichbarkeit des MQTT-Brokers geprüft,
-
die zuletzt bekannten Werte vorhandener MQTT-Datenpunkte angezeigt werden.
Hinweis
Der Status eines MQTT-Datenpunkts kann nur abgefragt werden, wenn die zugehörige MQTT-Verbindung gespeichert, verbunden und erreichbar ist.
Zusätzlich muss mindestens eine aktive Logikgruppe den betreffenden MQTT-Datenpunkt verwenden.
Änderungen testen
Mit Änderungen testen können noch nicht gespeicherte Änderungen an der Konfiguration überprüft werden.
Dadurch lassen sich geänderte Parameter direkt testen, ohne die Konfiguration zuvor speichern oder eine Logikgruppe aktivieren zu müssen.
Dies ist beispielsweise hilfreich bei Änderungen an:
-
Broker-Adresse oder Hostname
-
Port
-
Protokoll
-
Zugangsdaten
-
Zertifikaten
-
Topic
-
QoS
-
Transformator-Typ
-
Datentyp
Hinweis
Änderungen testen eignet sich insbesondere zur Inbetriebnahme und zur Prüfung neuer oder geänderter Einstellungen, bevor diese mit Speichern in die Arbeitskopie übernommen werden.
MQTT-Verbindung testen
Mit dieser Funktion können die Verbindung und die Erreichbarkeit des konfigurierten MQTT-Brokers überprüft werden.
Dabei werden unter anderem folgende Informationen angezeigt:
-
ob der MQTT-Broker über das Netzwerk erreichbar ist,
-
ob die MQTT-Verbindung aktuell verbunden ist,
-
wie viele MQTT-Datenpunkte für die Verbindung konfiguriert sind.
Eine MQTT-Verbindung gilt als verbunden, wenn sie von einer aktiven Logikgruppe verwendet wird.
Der Status kann jederzeit über Status aktualisieren erneut abgefragt werden.
Ist der Test nicht erfolgreich, können Verbindungseinstellungen geändert und anschließend über Änderungen testenerneut geprüft werden, ohne die geänderte MQTT-Konfiguration zuvor speichern zu müssen.
MQTT-Datenpunkte testen
Mit dieser Funktion können die Werte der für eine MQTT-Verbindung konfigurierten Datenpunkte geprüft werden.
Dabei kann kontrolliert werden, ob über das konfigurierte Topic MQTT-Nachrichten entsprechend der Datenpunktkonfiguration verarbeitet werden.
Ein Test ist nur möglich, wenn die erforderlichen Einstellungen gültig sind.
Ungültige Verbindungseinstellungen, fehlende erforderliche Zertifikate oder fehlerhafte Datenpunkteinstellungen verhindern die Ausführung des Tests.
Das Testergebnis enthält mindestens:
-
die Rückmeldung des Tests,
-
den gelesenen Wert bzw. mehrere gelesene Werte,
-
die Dauer des Tests.
Bei längeren Plaintext-Werten kann der vollständige Inhalt ein- und ausgeblendet werden.
Plaintext- und JSON-Werte können, sofern verfügbar, direkt über das Kopiersymbol übernommen werden.
Gespeicherten Status abfragen
Mit Status aktualisieren wird der aktuelle Status des gespeicherten MQTT-Datenpunkts geladen.
Hierbei werden die zuletzt bekannten Werte angezeigt.
Ist für einen Datenpunkt noch kein Wert verfügbar, wird dies entsprechend angezeigt.
Hinweis
Die Statusabfrage ist nur möglich, wenn die zugehörige MQTT-Verbindung gespeichert, verbunden und erreichbar ist.
Damit Werte empfangen und als aktueller Status angezeigt werden können, muss mindestens eine aktive Logikgruppe den entsprechenden MQTT-Datenpunkt verwenden.
Geänderte Einstellungen testen
Entspricht der empfangene Wert nicht den Erwartungen oder schlägt der Test fehl, können die entsprechenden Parameter geändert und anschließend über Änderungen testen erneut geprüft werden.
Dies betrifft beispielsweise:
-
Topic
-
QoS
-
Transformator-Typ
-
Datentyp
Dadurch können unterschiedliche Einstellungen getestet werden, ohne die MQTT-Konfiguration nach jeder Änderung speichern zu müssen.
///