MQTT Datenpunkte anlegen

MQTT-Datenpunkte beschreiben die einzelnen MQTT-Topics einer MQTT-Verbindung. Sie werden innerhalb von Logikgruppen über MQTT-Werteeingänge und MQTT-Wertausgänge verwendet.

Ein neuer Datenpunkt wird durch Klicken auf die graue Fläche mit dem „Plus“-Zeichen angelegt.

Beim Anlegen eines neuen Datenpunkts öffnet sich ein Fenster, in dem die Parameter des MQTT-Datenpunkts definiert werden. Das Topic wird dabei nicht automatisch vergeben, sondern muss vom Anwender entsprechend der verwendeten MQTT-Topic-Struktur eingetragen werden.

Zusätzlich können Datenpunkte kopiert, einzeln oder über die Mehrfachauswahl zum Löschen mehrerer Datenpunkte markiert und gemeinsam gelöscht werden.

Allgemein

• Name:
  Hier wird ein beschreibender Name für den Datenpunkt frei vergeben. Der Name wird in der Datenpunktliste und bei der Auswahl in Logikgruppen verwendet.

• Beschreibung:
  Für den Datenpunkt kann in diesem Textfeld eine ausführlichere Beschreibung oder wichtige Informationen hinterlegt werden

Topic-Einstellungen

Unter diesem Abschnitt werden die MQTT-spezifischen Parameter festgelegt:

• Topic
  MQTT-Topic, über das der Datenpunkt Daten empfängt oder sendet. Das Topic ist für den Topic ist erforderlich.

• 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 Bestätigung durch den Broker. Diese Stufe bietet den geringsten Kommunikationsaufwand, garantiert jedoch keine Zustellung.

  • QoS 1 – Mindestens einmal
    Die Nachricht wird so lange erneut gesendet, bis der Empfang durch den Broker bestätigt wurde. Dadurch ist eine Zustellung sichergestellt, Nachrichten können jedoch mehrfach empfangen werden.

  • QoS 2 – Genau einmal
    Die Nachricht wird mit einem erweiterten Bestätigungsmechanismus übertragen. Dadurch wird sichergestellt, dass die Nachricht genau einmal zugestellt wird. Diese Stufe bietet die höchste Zuverlässigkeit, erzeugt jedoch den größten Kommunikationsaufwand.

• Transformator-Typ
  Der Transformator-Typ bestimmt, wie die empfangene oder zu sendende MQTT-Nachricht interpretiert wird. Zur Auswahl stehen:

  • Plaintext
    Die MQTT-Nutzdaten werden als einfacher Textwert verarbeitet. Der gesamte Nachrichteninhalt entspricht dem Wert des Datenpunkts.

  • JSON
    Die MQTT-Nutzdaten werden als JSON-Struktur verarbeitet. Dadurch können Werte innerhalb eines JSON-Objekts gezielt gelesen oder geschrieben werden.

• Komma als Dezimal Trennzeichen
  Aktiviert die Verwendung eines Kommas anstelle eines Punkts als Dezimaltrennzeichen bei der Verarbeitung numerischer Werte.

Werte

Ein MQTT-Datenpunkt enthält mindestens einen Wert und maximal 20 Werte. Ein Wert wird über die graue Fläche mit dem „Plus“-Zeichen hinzugefügt.

Die Werte-Namen müssen, innerhalb eines MQTT-Datenpunkts, eindeutig und nicht leer sein. Die Werte bestimmen später die Ein- oder Ausgänge des Logikelements. Ein MQTT-Datenpunkt mit mehreren Werten erzeugt entsprechend mehrere Ports in der Logikgruppe.

Für jeden Wert stehen zur Verfügung:

• Name
  Eindeutiger Bezeichner des MQTT-Datenpunkts. Der Name dient zur Identifikation und Verwendung des Datenpunkts innerhalb des Projekts und der Logik.

• Datentyp
  Der Datentyp legt fest, wie der Wert eines MQTT-Datenpunkts interpretiert und verarbeitet wird.

  Zur Auswahl stehen folgende Datentypen:

  • Boolean
    Verarbeitet den Wert als Wahrheitswert (true oder false). Geeignet für Schaltzustände oder binäre Informationen.

  • Float
    Verarbeitet den Wert als Gleitkommazahl mit Dezimalstellen. 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 numerische Werte.

  • String
    Verarbeitet den Wert als Zeichenkette. Geeignet für Texte, Bezeichnungen oder beliebige alphanumerische Inhalte.

///