Parameterliste

Parameter, welche die MQTT Message Queue (FB_IotMqttMessageQueue, FB_IotMqtt5MessageQueue) sowie den für die MQTT Nachrichten verwendeten dynamischen Speicher (TwinCAT Router Speicher) beeinflussen:

Name	Typ	Default-Wert	Beschreibung
cMaxSizeOfMqttMessage	UDINT	102400	Maximale Größe in Bytes von einer MQTT-Nachricht, welche in der Message Queue eingesammelt werden kann. Empfängt der `FB_IotMqttClient` eine zu große MQTT-Nachricht, so wird diese beim Ablageversuch in die `FB_IotMqttMessageQueue` vollständig verworfen. Empfängt der `FB_IotMqtt5Client` eine solche MQTT-Nachricht, so wird diese beim Ablageversuch in die `FB_IotMqtt5MessageQueue` zuerst um alle User Properties reduziert. Sollte dies nicht ausreichen, wird die MQTT-Nachricht vollständig verworfen.
cMaxSizeOfMqttMessageQueue	UDINT	1024000	Maximale Größe in Bytes einer gesamten Message Queue inklusive aller eingesammelten MQTT-Nachrichten. Empfängt der `FB_IotMqttClient` eine neue MQTT-Nachricht womit die Maximalgröße der Message Queue überschritten würde, so wird diese beim Ablageversuch in die `FB_IotMqttMessageQueue` vollständig verworfen. Empfängt der `FB_IotMqtt5Client` eine solche MQTT-Nachricht, so wird mit dem Empfang dieser neuen Nachricht gewartet, bis die Warteschlange Platz bietet.
cMaxEntriesInMqttMessageQueue	UDINT	1000	Maximale Anzahl von Nachrichten in einer Message Queue.

Name

Typ

Default-Wert

Beschreibung

cMaxSizeOfMqttMessage

UDINT

102400

Maximale Größe in Bytes von einer MQTT-Nachricht, welche in der Message Queue eingesammelt werden kann.

Empfängt der FB_IotMqttClient eine zu große MQTT-Nachricht, so wird diese beim Ablageversuch in die FB_IotMqttMessageQueue vollständig verworfen.

Empfängt der FB_IotMqtt5Client eine solche MQTT-Nachricht, so wird diese beim Ablageversuch in die FB_IotMqtt5MessageQueue zuerst um alle User Properties reduziert. Sollte dies nicht ausreichen, wird die MQTT-Nachricht vollständig verworfen.

cMaxSizeOfMqttMessageQueue

UDINT

1024000

Maximale Größe in Bytes einer gesamten Message Queue inklusive aller eingesammelten MQTT-Nachrichten.

Empfängt der FB_IotMqttClient eine neue MQTT-Nachricht womit die Maximalgröße der Message Queue überschritten würde, so wird diese beim Ablageversuch in die FB_IotMqttMessageQueue vollständig verworfen.

Empfängt der FB_IotMqtt5Client eine solche MQTT-Nachricht, so wird mit dem Empfang dieser neuen Nachricht gewartet, bis die Warteschlange Platz bietet.

cMaxEntriesInMqttMessageQueue

UDINT

1000

Maximale Anzahl von Nachrichten in einer Message Queue.

Parameter, welche die Eingänge eines MQTT Clients (FB_IotMqttClient, FB_IotMqtt5Client) beeinflussen:

Name	Typ	Default-Wert	Beschreibung
cSizeOfMqttClientClientId	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge der ClientId vorgegeben ist.
cSizeOfMqttClientHostName	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des Host-Namens vorgegeben ist.
cSizeOfMqttClientTopicPrefix	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des Topic-Prefix vorgegeben ist.
cSizeOfMqttClientUserName	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des User-Namens vorgegeben ist.
cSizeOfMqttClientUserPwd	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des User-Passwortes vorgegeben ist.
cSizeOfMqttWillTopic	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des Will-Topics vorgegeben ist.

Parameter, welche die MQTT 5 Properties beeinflussen:

Name	Typ	Default-Wert	Beschreibung
cSizeOfMqtt5ContentType	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des Content-Typen vorgegeben ist.
cSizeOfMqtt5AuthMethod	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge der Authentifizierungsmethode vorgegeben ist.
cSizeOfMqtt5AuthData	UDINT	4096	Maximale Größe in Bytes der Authentifizierungsdaten.
cSizeOfMqtt5ServerReference	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge der Serverreferenz vorgegeben ist.
cSizeOfMqtt5ReasonString	UDINT	256	Definition der STRING-Größe in Bytes, wodurch die maximale Länge des Reason-Strings vorgegeben ist.
cMaxMqtt5UserProps	UINT	20	Maximale Anzahl der UserProperties, welche mit einer MQTT 5 Nachricht empfangen bzw. mit Hilfe von `FB_IotMqtt5UserProperties` versendet werden können. Die Verarbeitung von UserProperties im SPS Echtzeit-Task-Zyklus bedarf je nach Menge einer gewissen Zeitdauer, weshalb diese besser gering zu halten ist.