MQTT-Datenpunkte repräsentieren die einzelnen MQTT-Topics einer MQTT-Verbindung. Innerhalb von Logikgruppen werden sie über die Logikelemente MQTT Werteingang und MQTT Wertausgang verwendet.
Ein neuer MQTT-Datenpunkt wird durch Klicken auf die graue Fläche mit dem Pluszeichen (+) angelegt.
Beim Anlegen eines neuen Datenpunkts öffnet sich die Konfiguration mit den entsprechenden Parametern.
Das MQTT-Topic wird nicht automatisch vergeben. Es muss entsprechend der Topic-Struktur des verwendeten MQTT-Systems manuell eingetragen werden.
Zusätzlich können MQTT-Datenpunkte kopiert, einzeln gelöscht oder über die Mehrfachauswahl markiert und gemeinsam gelöscht werden.
Hinweis
Wird ein MQTT-Datenpunkt in einer aktiven Logikgruppe verwendet, können bestimmte strukturelle Eigenschaften nicht verändert werden.
Betroffene Felder werden in der Benutzeroberfläche deaktiviert und mit einem entsprechenden Hinweis gekennzeichnet.
Dazu gehören insbesondere:
-
Name
-
Topic
-
Quality of Service (QoS)
-
Transformator-Typ
-
konfigurierte Werte
Ein MQTT-Datenpunkt kann erst gelöscht werden, wenn er in keiner aktiven Online-Logikgruppe mehr verwendet wird.
Wird der Datenpunkt ausschließlich in einer Arbeitskopie verwendet, kann er gelöscht werden. Vor dem Löschen wird auf die betroffenen Logikgruppen hingewiesen.
Allgemein
-
Name
Geben Sie einen eindeutigen und beschreibenden Namen für den MQTT-Datenpunkt ein.Der Name wird in der Datenpunktliste sowie bei der Auswahl des Datenpunkts innerhalb von Logikgruppen verwendet.
-
Beschreibung
In diesem Textfeld können eine ausführlichere Beschreibung oder zusätzliche Informationen zum MQTT-Datenpunkt hinterlegt werden.
Topic-Einstellungen
In diesem Bereich werden die MQTT-spezifischen Parameter des Datenpunkts konfiguriert.
-
Topic
Geben Sie das MQTT-Topic ein, über das der Datenpunkt Nachrichten empfängt bzw. sendet.Das Topic ist erforderlich und muss der Topic-Struktur des verwendeten MQTT-Systems entsprechen.
-
Quality of Service (QoS)
Legt die Zustellgarantie für MQTT-Nachrichten fest.-
QoS 0 – Höchstens einmal
Die Nachricht wird einmal gesendet. Es erfolgt keine Empfangsbestätigung durch den Broker.Diese Stufe verursacht den geringsten Kommunikationsaufwand, garantiert jedoch nicht, dass die Nachricht zugestellt wird.
-
QoS 1 – Mindestens einmal
Die Nachricht wird so lange erneut übertragen, bis der Empfang bestätigt wurde.Dadurch wird die Zustellung sichergestellt. Eine Nachricht kann jedoch mehrfach empfangen werden.
-
QoS 2 – Genau einmal
Die Nachricht wird mit einem erweiterten Bestätigungsverfahren übertragen.Dadurch wird sichergestellt, dass die Nachricht genau einmal zugestellt wird. Diese Stufe bietet die höchste Zustellsicherheit, verursacht jedoch auch den größten Kommunikationsaufwand.
-
-
Transformator-Typ
Der Transformator-Typ bestimmt, wie die MQTT-Nutzdaten interpretiert bzw. erzeugt werden.Folgende Optionen stehen zur Verfügung:
-
Plaintext
Die MQTT-Nutzdaten werden als einfacher Text verarbeitet.Der Nachrichteninhalt wird direkt als Wert des Datenpunkts verwendet.
-
JSON
Die MQTT-Nutzdaten werden als JSON-Struktur verarbeitet.Dadurch können einzelne Werte innerhalb eines JSON-Objekts gezielt gelesen bzw. geschrieben werden.
-
-
Komma als Dezimaltrennzeichen
Aktiviert die Verwendung eines Kommas anstelle eines Punkts als Dezimaltrennzeichen bei der Verarbeitung numerischer Werte.
Werte
Ein MQTT-Datenpunkt enthält mindestens einen und maximal 20 Werte.
Ein neuer Wert wird über die graue Fläche mit dem Pluszeichen (+) hinzugefügt.
Die Namen der Werte müssen innerhalb eines MQTT-Datenpunkts eindeutig sein und dürfen nicht leer bleiben.
Die konfigurierten Werte bestimmen später die Ein- bzw. Ausgänge des entsprechenden Logikelements. Enthält ein MQTT-Datenpunkt mehrere Werte, werden innerhalb der Logikgruppe entsprechend mehrere Anschlüsse bereitgestellt.
Für jeden Wert stehen folgende Einstellungen zur Verfügung:
-
Name
Geben Sie einen eindeutigen Namen für den Wert ein.Der Name dient zur Identifikation des Werts innerhalb des MQTT-Datenpunkts und wird am entsprechenden Ein- bzw. Ausgang des Logikelements verwendet.
-
Datentyp
Der Datentyp legt fest, wie der Wert interpretiert und innerhalb des LOGIKEDITOR verarbeitet wird.Folgende Datentypen stehen zur Verfügung:
-
Boolean
Verarbeitet den Wert als Wahrheitswert (trueoderfalse).Geeignet für Schaltzustände oder andere binäre Informationen.
-
Float
Verarbeitet den Wert als Gleitkommazahl.Geeignet für Messwerte wie Temperaturen, Spannungen oder andere kontinuierliche Werte.
-
Integer
Verarbeitet den Wert als Ganzzahl ohne Dezimalstellen.Geeignet für Zählerstände, Statuscodes oder andere ganzzahlige Werte.
-
String
Verarbeitet den Wert als Zeichenkette.Geeignet für Texte, Bezeichnungen oder andere alphanumerische Inhalte.
-
///