ST_IotMqttWill
Mittels folgender Angaben kann eine Nachricht spezifiziert werden, die bei einem irregulärem Verbindungsabbau zwischen Client und Broker als letzte Nachricht vom Broker zu den Subscribern versendet wird, die das entsprechende Topic abonniert haben.
Syntax
Definition:
TYPE ST_IotMqttWill :
STRUCT
{attribute 'TcEncoding':='UTF-8'}
sTopic : STRING(255); // topic string (UTF-8) (attend that MQTT topics are case sensitive)
pPayload : PVOID;
nPayloadSize : UDINT;
eQoS : TcIotMqttQos := TcIotMqttQos.ExactlyOnceDelivery; // quality of service between the publishing client and the broker
bRetain : BOOL; // if TRUE the broker stores the message in order to send it to new subscribers
END_STRUCT
END_TYPE
Parameter
Name | Typ | Beschreibung |
---|---|---|
sTopic | STRING(255) | Topic der Nachricht |
pPayload | PVOID | Adresse zum Payload der Nachricht |
nPayloadSize | UDINT | Größe in Bytes vom Payload |
eQoS | TcIotMqttQos | Die „Quality of Service“ bietet folgende Einstellmöglichkeiten: QoS-Level 0, QoS-Level 1, QoS-Level 2 (Siehe QoS) |
bRetain | BOOL | Wenn bRetain TRUE ist, speichert der Broker die Nachricht, um sie später hinzukommenden Subscribern nachträglich zukommen zu lassen. |
Message-Payload-Formatierung Beachten Sie, dass der Datentyp und die Formatierung des Inhalts der Sender- und Empfängerseite bekannt sein müssen, insbesondere beim Versand von Binärinformationen (Alignment) oder Strings (mit/ohne Nullterminierung). |