Cos’è MQTT?
MQTT (Message Queuing Telemetry Transport) è un protocollo di comunicazione leggero di tipo publish/subscribe, progettato specificamente per l’Internet delle Cose (IoT) e la comunicazione Machine-to-Machine (M2M).
Concetti di base di MQTT
Modello Publish/Subscribe:
- A differenza della tradizionale comunicazione client-server, MQTT utilizza un modello in cui i dispositivi non hanno bisogno di conoscere gli indirizzi gli uni degli altri
- I dispositivi comunicano tramite un punto centrale: il Broker MQTT
- Un dispositivo pubblica messaggi su un argomento specifico
- Altri dispositivi si sottoscrivono a questi argomenti e ricevono automaticamente i messaggi
Argomenti:
- Una struttura organizzativa per i messaggi, simile alle cartelle in un file system
- Esempio:
home/living_room/temperature,home/kitchen/light/status - I dispositivi possono sottoscriversi a argomenti specifici o utilizzare caratteri jolly (
home/#= tutto in home)
Vantaggi di MQTT:
- Consumo di dati ed energia estremamente basso
- Funziona su reti lente o instabili
- Semplice da implementare
- Scalabile da sistemi piccoli a molto grandi
Broker MQTT in TapHome
Il Broker MQTT è un servizio che gestisce la comunicazione MQTT tra i dispositivi. Il Broker può essere eseguito su una macchina esterna o direttamente sul controller TapHome.
Le funzioni del Broker MQTT di TapHome sono:
- Mediatore centrale per tutti i messaggi MQTT nel sistema
- Ponte tra TapHome e dispositivi di terze parti (Shelly, Zigbee2MQTT, Tasmota e altri)
- Servizio locale – tutte le comunicazioni rimangono nella tua rete, nessun dato viene inviato al cloud
Come attivare il Broker MQTT in TapHome
- Vai a Impostazioni → Hardware e seleziona MQTT Broker
- Inserisci i dettagli di configurazione, tra cui numero di porta, prefisso ID client, nome utente e password
- Salva le impostazioni per attivare il servizio

Dettagli di configurazione
Dopo l’attivazione, la configurazione della comunicazione MQTT è definita in Hardware → Packet parser.

Esempio pratico di utilizzo
Scenario: hai un dispositivo Shelly (smart plug) e vuoi integrarlo in TapHome.
- Attiva il Broker MQTT in TapHome (seguendo i passaggi sopra indicati)
- Configura il dispositivo Shelly – nell’interfaccia web, inserisci l’indirizzo IP del controller TapHome e la porta del Broker MQTT
- Crea un modulo Packet Parser in TapHome con il protocollo MQTT
- Imposta gli argomenti MQTT – ad esempio,
shellies/shellyplug-s-12345/relay/0per il controllo del relè - Dispositivo connesso – ora puoi controllare Shelly tramite l’app TapHome e creare regole intelligenti
Risultato: Shelly pubblica il suo stato su un topic MQTT, TapHome riceve notifiche sui cambiamenti. Quando vuoi accendere/spegnere Shelly, TapHome pubblica un comando sul topic corrispondente.