Mittels MQTT-Client lässt sich eine Verbindung zu einem externen oder einem in Anlagenetz vorhandenem MQTT Server (Broker) aufbauen.
Falls in Bezug auf die HOOC Lösung Anlageübergreifend Datenpunktwerte ausgetauscht werden sollen, kann ein MQTT-Client einer Anlage A mittels Secure Proxy Permalink eine Verbindung zum Dienst Remote Control einer Anlage B aufbauen und somit über die bereitgestellte API Datenpunktwerte austauschen.
| Eigenschaft | Beschreibung |
|---|---|
| Protokolltyp | Auswahl Protokolltyp MQTT Client |
| Name | Bezeichnung des Endgeräts |
| Beschreibung | Beschreibung des Endgeräts |
| IP-Adresse / Host | IP-Adresse / Host des MQTT-Brokers |
| Port | Standard Port 1883 |
| TLS Verbindung | Die Verbindung zum MQTT-Brokers ist verschlüsselt |
| Zertifikat nicht prüfen | Das Zertifikat des MQTT-Brokers wird nicht geprüft. Bei Verwenddung dieser Option kann der MQTT-Broker ein selbstsigniertes Zertifikat verwenden. |
| MQTT Client ID | Client ID |
| Benutzername | Authentifizierunginfomrmationen (optional) |
| Passwort | Authentifizierunginfomrmationen (optional) |
| Topic Präfix ‘lesen’ | Präfix des Topics zum Lesen der Daten (optional) |
| Topic Präfix ‘schreiben’ | Präfix des Topics zum Lesen der Daten (optional) |
| Verbindungsüberwachung | Falls aktiviert, werden bei einem Verbindungsunterbruch alle Datenpunkte nicht als ungültig markiert (Letzter bekannter Wert). |
| Gültigkeitsdauer | Falls keine Wertaktualisierung im definierten Intervall empfangen wird, wird der entsprechende Datenpunkt als ungültig markiert (Letzter bekannter Wert) |
Nachdem ein MQTT-Endgerät angelegt wurde, können verschiedene Aktionen ausgeführt werden.
| Aktion | Beschreibung |
|---|---|
| Einstellungen Schnittstelle editieren | |
| Export Datenpunkte (Falls Datenpunkte erfasst sind) | |
| Import Datenpunkte (Falls keine Datenpunkte erfasst sind) | |
| Schnittstelle entfernen (Falls keine Datenpunkte erfasst sind) |
Die Live-Werte erfasster Datenpunkte werden direkt angezeigt. Mittels Klick auf das Symbol kann der Datenmonitor gestoppt werden.
Durch einen Klick auf das Symbol kann ein neuer Datenpunkt für die entsprechende Schnittstelle erfasst werden.
| Eigenschaft | Beschreibung |
|---|---|
| Topic ‘lesen’ (optional) | Topic zum Lesen der Daten (Verwendetes Topic setzt sich aus dem Präfix des MQTT-Geräts und dem hier angegeben Topic zusammen) |
| Decoder | Auswahl und Einstellungen Daten-Decoder |
| Topic ‘schreiben’ (optional) | Topic zum Schreiben der Daten (Verwendetes Topic setzt sich aus dem Präfix des MQTT-Geräts und dem hier angegeben Topic zusammen) |
| Encoder | Auswahl und Einstellungen Daten-Encoder |
| Datenpunkt | Eindeutiger Name des Datenpunktes |
| Beschreibung | Beschreibung des Datenpunktes |
| Datentyp | Auswahl des Datentyps |
| Umwandlung | Bei Bedarf können Werte linearisiert werden, bspw. Temperaturangabe in 10tel zu °C Angabe mit einer Kommastelle |
| Einheit | Einheiten im LaTeX-Format: z.B. ^\circ C für °C |
Bei der Auswahl eines Custom-Decoders oder -Encoders können die Daten beliebig decodiert bzw. encodiert werden. Die entsprechenden Vorlagen der Funktionen (Javascript) werden im Editor dargestellt. Weitere Informationen zu den Parametern und Rückgabewerten können untenstehender Tabelle entnommen werden:
| Eigenschaft | Decoder | Encoder | Beschreibung |
|---|---|---|---|
Parameter raw |
x | Byte-Array der Rohdaten | |
Parameter value |
x | Datenpunktwert im entsprechenden Format (Number, Bool, String) | |
Parameter dataType |
x | x | Verwendeter Datentyp des Datenpunkts als STRING (“Int8”, “Int16”, “Int32”, “UInt8”, “UInt16”, “UInt32”, “Float32”, “Float64”, “Bool”, “String”) |
| Rückgabewert Decoder | x | Rückgabewert anhand verwendetem Datentyp (Number, Bool, String) | |
| Rückgabewert Encoder | x | Byte-Array |
Zur Analyse von Daten und Implementierung von Custom-Encodern und Custom-Decodern empfiehlt sich der MQTT-Debug-Mode. (Siehe bei Schnittstellen/Endgeräte).
Nachdem ein Datenpunkt erfolgreich angelegt wurde, können verschiedene Aktionen auf diesen Datenpunkt durchgeführt werden.
| Aktion | Beschreibung |
|---|---|
| Einstellungen Datenpunkt editieren | |
| Einstellungen Smart-UI editieren | |
| Trend des Datenpunktes anzeigen | |
| Wert des Datenpunktes schreiben (falls schreibbar) | |
| Datenpunkt duplizieren | |
| Datenpunkt entfernen |