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.

ST_IotMqttWill 1:

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).