Definition der Peripherieadresse

Dieses Kapitel beschreibt die Definition von Peripherieadressen für den MQTT-Treiber.

Klicken Sie auf das _address-Config eines Datenpunktelements, selektieren Sie den Treiber-Typ MQTT aus der Combobox und klicken Sie auf Parametrieren... um das folgende Panel zu öffnen.

Abbildung 1. Definition einer Peripherieadresse

Topic

Hier muss das MQTT-Topic für die Adresskonfiguration angegebene werden.

Anmerkung:

Wildcards (+ and #) werden nicht unterstützt.

Z.B.:

home/sensors/17/temp

plant/valves/v24/isOpen

QoS

Der Quality of Service Level definiert die Übertragungsgarantie bei Nachrichten die vom Publisher gesendet bzw. vom Subscriber erhalten werden sollen. Für mehr Information über Quality of Service, siehe Quality of Service.

.

  • 0: Maximal einmal

  • 1: Mindestens einmal

  • 2: Genau einmal

Modus Publish

Der WinCC OA Client ist der Publisher und definiert den QoS Level für Nachrichten die an den Broker übermittelt werden.

Modus Subscribe

Der WinCC OA Client ist der Subscriber und definiert den maximalen QoS level der vom Broker evaluiert wird, wenn er die Nachricht an den Subscriber übermittelt.

Retain

Dieses Flag definiert ob der Broker die letzte Nachricht dieses Topics speichern soll. Meldet sich ein neuer Subscriber auf das Topic an, erhält dieser sofort die gespeicherte Nachricht. Für mehr Information über Retain, siehe Retain.

Treibernummer

Nummer mit welcher der MQTT-Treiber gestartet wurde.

Transformationsprotokoll

Das Transformationsprotokoll definiert wie Werte interpretiert und übertragen werden sollen. Es muss sichergestellt werden, das Sender und Empfänger die Daten korrekt interpretieren. Daten können entweder als einfache Strings oder JSON Array übertragen werden. Welche der Attribute "Value", "Timestamp" und "Status" gelesen/geschrieben werden können, ist abhängig vom gewählten JSON Profil.

Der tatsächliche WinCC OA Datentyp in den der MQTT-Wert konvertiert wird, ist abhängig vom Typ des entsprechenden Datenpunktelements. Bei dyn-Datenpunktelementen muss der MQTT-Wert ein JSON Array sein.

Anmerkung: Bei JSON-Transformationen ist auch bei Datenpunktelementen vom Typ long oder ulong der Wertebereich auf 32bit limitiert.
Transformationsprotokoll Beschreibung
plain string Wert als einfacher String
JSON Profile Value JSON Profil das nur den Wert beinhaltet
JSON Profile Value/Timestamp JSON Profil das Wert und Zeitstempel beinhaltet
JSON Profile Value/Timestamp/Status JSON Profil das Wert, Zeitstempel und Status beinhaltet

Old/new comparison

Kann nur verwendet werden, wenn der Modus auf Subscribe oder Both gesetzt wurde. Wenn diese Option selektiert ist, sendet der Treiber nur dann Daten, wenn eine Wertänderung vorliegt. Der Vergleich basiert auf Rohdaten ohne Konvertierung. In einem Low-Level-Vergleich werden die einzelnen Bits von Byte Blöcken mit alten Werten verglichen und wenn sich ein Bit ändert, wird der Wert in WinCC OA aktualisiert.

Connection

Selektieren Sie die gewünschte Verbindung aus der Combobox.

Modus

Hier wird festgelegt ob Werte

  • gesendet (Publish)

  • erhalten (Subscribe)

  • gesendet/erhalten (Both)

werden sollen.

On Use

Wenn gesetzt, werden Werte nur empfangen wenn sie auch tatsächlich verwendet werden, z.B. vom UI oder einem CTRL-Manager. Die Option kann nur in Verbindung mit dem Modus Subscribe oder Both gesetzt werden.