MQTT Client

Verbindung zu externem MQTT-Broker einrichten

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
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)

Aktionen

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)

Datenpunkte einrichten

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

Custom-Encoder und Custom-Decoder

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).

Aktionen

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