MQTT Datenpunkte anlegen

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.

image-20260620-075927.png

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 (true oder false).

      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.


///