Abonnieren vom MQTT Client (MQTT subscribe topic)

Dieser Baustein erlaubt die Konfiguration von bis zu 10 Items pro Topic bzw. deren Parameter. Die Topics werden durch den Topic-Typ gruppiert. Der Datentyp des jeweiligen Topics bzw. dessen Parameter wird im Parameterdialog definiert. Ändert sich der Datentyp an einem Pin (durch Konfiguration) wird bei Inkompatibilität ein bereits angeschlossener Wert abgeworfen.

Definierte Topic-Typen werden registriert. Wird ein Topic vom entsprechenden Typ empfangen, werden die Inhalte an den Ausgängen des Funktionsbausteins bereitgestellt. Dazu wird die Parameterbezeichnung mit den empfangenen Bezeichnungen verglichen. Bei Übereinstimmung werden die Werte konvertiert und den Ausgängen bereitgestellt.

Zwischen zwei Aufrufen eines Bausteins können durchaus mehrere Topics des gleichen Typs empfangen werden. Diese werden in einer Queue gesichert. Bei jedem Aufruf des Bausteins wird geprüft, ob ein passendes Ereignis in der Queue existiert. Falls dies so ist, wird dieses Ereignis ausgewertet. Die Queue wird im Statusbaustein überwacht. Wird die dort angezeigte Anzahl negativ, ist die Queue übergelaufen. Alle ab diesem Zeitpunkt einlaufenden Nachrichten werden verworfen, solange kein Platz in der Queue ist. Am Ausgang „New Topic“ wird für einen Zyklus ein Wert > 0 angezeigt, wenn in der Queue eine Nachricht vorhanden ist.

Parameter

Über den Parameterdialog (Aufruf beim Einfügen des Bausteins bzw. über Kontextmenü) können die Kommandos konfiguriert werden.

Bei der Eingabe des Kommandotyps sind folgende Zeichen erlaubt:

  • A-Z (ohne Umlaute)
  • a-z (ohne Umlaute)
  • 0-9
  • -_.

Bei der Eingabe der Itembezeichnung sind auch Leerzeichen erlaubt.

Bei beiden Eingaben dürfen maximal 36 Zeichen eingegeben werden.

 

External: Die Festlegung des Datentyps erfolgt nicht im Parameterdialog sondern durch Konfiguration extern am Pin. Das Feld „Command” kann leer bleiben.

QoS: siehe Quality of Service (QoS)

Parameter MQTT client subscribe topic
Type not valid

Signale

Name I/O Typ(en) Funktion
NewSubs O Word >0 – neue Nachricht in der Queue enthalten
Data1 bis Data 10 O unterschiedliche Datentypen Items
Status O Word Status senden