Il plugin MQTT consente la comunicazione con un broker MQTT (server) sulla rete. Il Miniserver agisce sempre come client MQTT e supporta l'invio ("pubblicazione") di dati e la ricezione ("sottoscrizione") di dati dal broker.
MQTT (Message Queuing Telemetry Transport) è un protocollo semplice e leggero che può essere utilizzato per la comunicazione tra dispositivi. È ampiamente utilizzato per applicazioni "Internet of Things (IoT)", ad esempio, per raccogliere dati da sensori o controllare dispositivi intelligenti.
È richiesto un broker MQTT al quale il Miniserver può iscriversi e pubblicare. Il Miniserver può gestire 16 iscrizioni (ingressi) così come 16 pubblicazioni (uscite).
|
Si prega di notare che il Miniserver Gen. 1 non è supportato. |
Contenuto
Creazione e configurazione di un oggetto↑
Il plugin MQTT è integrato come Periferica di Rete:
Un plugin MQTT può connettersi solo a un broker alla volta. Configura le impostazioni come segue:
Invio/Ricezione Dati↑
Per ricevere dati dal broker (sottoscrizione) o inviare dati al broker (pubblicazione), crea l'oggetto appropriato:
L'invio e la ricezione di messaggi si basano sempre su argomenti, che fungono da percorso o indirizzo per identificare i dati. Le sottoscrizioni possono ascoltare più argomenti contemporaneamente utilizzando i caratteri jolly (wildcards). Le pubblicazioni non supportano i caratteri jolly.
Esempio di un argomento:
Se i dati devono essere inviati a un sensore di temperatura nel soggiorno, l'argomento corrispondente potrebbe essere così:
casa/soggiorno/temperatura
Abbonamento:
Iscriviti (ricevi):
Riceve valori sull'argomento specificato dal broker.
Un altro dispositivo o applicazione può iscriversi a questo argomento per ricevere i messaggi trasmessi. Ad esempio, un termostato potrebbe iscriversi all'argomento home/soggiorno/temperatura per ottenere i dati della temperatura.
Se si ricevono dati formattati in JSON o simili, si raccomanda di utilizzare il blocco "Riconoscimento Comandi" per estrarre il valore analogico dai dati.
|
|
Le modifiche al valore di sottoscrizione vengono valutate al massimo una volta ogni 2 secondi. Se una modifica del valore si verifica entro 2 secondi dalla precedente, la nuova modifica verrà memorizzata nella cache. Dopo l'intervallo di 2 secondi, verrà elaborata la modifica più recente. Questo approccio aiuta a ridurre il carico sul Miniserver, in particolare quando vengono inviate molteplici modifiche a un argomento in un breve periodo. |
I caratteri jolly nelle sottoscrizioni: Per evitare di dover sottoscrivere ogni argomento individualmente, MQTT supporta i caratteri jolly, che consentono una sottoscrizione a più argomenti contemporaneamente:
Wildcard a singolo livello (+): Sostituisce esattamente un livello dell'argomento nel percorso dell'argomento.
Esempio:
casa/+/temperatura
Questa sottoscrizione riceve messaggi da tutte le stanze della casa che inviano dati sulla temperatura, come:
home/soggiorno/temperatura
home/cucina/temperatura
Wildcard multilivello (#): Copre tutti i livelli successivi del percorso dell'argomento e deve essere utilizzato alla fine del percorso.
Esempio:
casa/#
Questo abbonamento riceve tutti i messaggi che iniziano con home/, indipendentemente dal numero di livelli successivi, come:
home/soggiorno/temperatura
home/cucina/umidità
home/garage/auto/batteria
|
|
Solo le sottoscrizioni supportano i caratteri jolly, le pubblicazioni no. Un dispositivo può inviare messaggi solo a un argomento specifico, non a più argomenti contemporaneamente. |
Pubblica:
Pubblica (ivia):
Un dispositivo (client) invia un messaggio a un argomento specifico. Nell'esempio sopra, il sensore di temperatura invierebbe la temperatura attuale a home/soggiorno/temperatura.
Sensori↑
| Descrizione breve | Unità |
|---|---|
| Subscription | Testo |
Attuatori↑
| Descrizione breve | Unità |
|---|---|
| Publish | Testo |
Ingressi di diagnosi↑
| Descrizione breve | Descrizione | Unità | Campo di valore |
|---|---|---|---|
| Onlinestatus | Indica se il dispositivo è raggiungibile dal Miniserver. Diagnostica per dispositivi Air Diagnostica per dispositivi Tree Diagnostica per Estensioni |
Digitale | 0/1 |
Proprietà↑
| Descrizione breve | Descrizione | Campo di valore | Valore predefinito |
|---|---|---|---|
| Indirizzo del broker | Indirizzo di rete del broker MQTT | - | - |
| Broker port | Porta di rete del broker MQTT (Predefinita: 1883) | 0...65535 | - |
| Versione del protocollo | Versione del protocollo MQTT supportata dal broker MQTT (predefinito: MQTTv5) | - | - |
| ID cliente | L'ID di questo client MQTT. L'ID deve essere unico quando ci si connette al broker MQTT! Quando si utilizza il protocollo MQTTv3, l'ID viene troncato a 23 caratteri. | - | - |
| Nome utente | Nome utente per l'autenticazione sul broker MQTT. Lasciare vuoto per l'accesso anonimo (se consentito dal broker MQTT). | - | - |
| Password | Password per l'autenticazione sul broker MQTT. Lasciare vuoto per l'accesso anonimo (se consentito dal broker MQTT). | - | - |
| Usa SSL/TLS | Utilizza una connessione SSL/TLS al broker MQTT. | - | - |
| Monitorare il servizio | Se selezionato, sarai avvisato tramite lo stato del sistema o tramite il cloud mailer se questo servizio non è più disponibile o offline. | - | - |
