FB_MqttClient - Descrizione funzionale

Panoramica

Tipo:	Blocco funzione
Disponibile a partire da:	V1.0.0.0

Descrizione funzionale

Il blocco funzione FB_MqttClient permette di stabilire una connessione con il Server MQTT specificato. La connessione viene avviata su un fronte di salita dell'ingresso i_xEnable. L'uscita q_xActive indica che il blocco funzione è in corso di esecuzione e deve essere richiamato ciclicamente. Lo stato della connessione è indicato dall'uscita q_xReady. Se quest'uscita è TRUE, il client è connesso.

Se l'ingresso i_xEnable viene impostato a FALSE durante il tentativo di stabilire una connessione, il processo viene interrotto.

Se l'ingresso i_xEnable è impostato a FALSE ed esiste una connessione, la connessione viene chiusa come sessione con il flag CleanSession impostato a True. Questo significa che le sottoscrizioni attive appartenenti a questo ID client vengono azzerate sul Server MQTT.

Una volta stabilita la connessione, il blocco funzione gestisce i messaggi ricevuti dal server in background. Pertanto, anche il blocco funzione deve essere richiamato ciclicamente dopo che è stata stabilita la connessione.

Interfaccia

Ingresso	Tipo di dati	Descrizione
i_xEnable	BOOL	Il blocco funzione stabilisce una connessione con Server MQTT su un fronte di salita di questo ingresso. Se l'ingresso è impostato a FALSE, il blocco funzione viene reimpostato e una connessione esistente viene chiusa oppure il tentativo di stabilire una connessione viene interrotto. Vedere la sezione Comportamento dei blocchi funzione con l'ingresso i_xEnable.
i_stConnectionSettings	ST_ConnectionSettings	Struttura per il trasferimento del parametro di connessione.
i_timTimeout	TIME	Intervallo di tempo entro il quale è prevista una connessione corretta. Se il valore è T#0 s, viene applicato il valore predefinito T#10 s.

Ingresso

Tipo di dati

Descrizione

i_xEnable

BOOL

Il blocco funzione stabilisce una connessione con Server MQTT su un fronte di salita di questo ingresso.

Se l'ingresso è impostato a FALSE, il blocco funzione viene reimpostato e una connessione esistente viene chiusa oppure il tentativo di stabilire una connessione viene interrotto.

Vedere la sezione Comportamento dei blocchi funzione con l'ingresso i_xEnable.

i_stConnectionSettings

ST_ConnectionSettings

Struttura per il trasferimento del parametro di connessione.

i_timTimeout

TIME

Intervallo di tempo entro il quale è prevista una connessione corretta. Se il valore è T#0 s, viene applicato il valore predefinito T#10 s.

Uscita	Tipo di dati	Descrizione
q_xActive	BOOL	Indica che è attiva l'esecuzione del blocco funzione. Finché questa uscita è TRUE, il blocco funzione deve essere eseguito ciclicamente.
q_xReady	BOOL	Indica che è stata stabilita la connessione. Il Client MQTT è pronto per lo scambio dei messaggi dell'applicazione con il Server MQTT.
q_xError	BOOL	Se questa uscita è impostata su TRUE, è stato rilevato un errore. Per informazioni, consultare q_etResult e q_etResultMsg.
q_xTlsUsed	BOOL	Indica se la connessione a Server MQTT è protetta tramite TLS (Transport Layer Security).
q_etResult	ET_Result	Fornisce informazioni su stato e diagnostica come valore numerico.
q_sResultMsg	STRING [80]	Fornisce ulteriori informazioni su stato e diagnostica come messaggio di testo.