La sezione MQTT pubblica le stesse letture su qualsiasi broker. È pensata soprattutto per chi usa altre piattaforme oltre a Home Assistant, come openHAB, Node-RED, Domoticz o ThingsBoard, o per chi preferisce alimentare il proprio Home Assistant tramite un broker.
Come per l'integrazione nativa, i dati vanno direttamente dal telefono al tuo broker.
Inserisci il broker
Compila Indirizzo del broker e Porta. Se il broker richiede autenticazione, compila anche Utente e Password.
Attiva Usa TLS (SSL) quando il broker è esposto fuori dalla tua rete. Usa WebSocket e Percorso di base servono a broker dietro un proxy.
L'indirizzo, la porta, le opzioni di connessione e le credenziali restano salvati solo su questo telefono. Su un altro telefono con lo stesso account, compilali di nuovo.
Scegli la versione del protocollo
I pulsanti MQTT 3.1.1 e MQTT 5.0 selezionano la versione. Nel dubbio, scegli 3.1.1, che è la più ampiamente compatibile.
Scegli il formato
Formato MQTT stabilisce la forma dei topic e il formato di ogni messaggio. Ci sono cinque opzioni:
- Home Assistant Discovery: con scoperta automatica, le entità si creano da sole, con nome, unità e icona.
- Homie 4.0: segue la convenzione Homie.
- Topic semplici: un valore per topic, senza struttura aggiuntiva. Il più facile da consumare da uno script.
- JSON unificato: tutto in un unico messaggio, sul topic che imposti.
- ThingsBoard: il formato di telemetria di ThingsBoard.
Alcuni formati hanno impostazioni proprie, come Payload JSON (valore + timestamp) nei topic semplici e Includi timestamp in ThingsBoard.
Imposta il prefisso dei topic
Prefisso dell'argomento è la radice di tutto ciò che l'app pubblica. Imposta il valore all'inizio ed evita di cambiarlo dopo, perché il cambio lascia i vecchi topic orfani sul broker.
Prova prima di uscire
Tocca Prova connessione. La prova conferma l'indirizzo, la porta, TLS e le credenziali prima che tu attivi la trasmissione.
Attiva la trasmissione e salva
Attiva Abilita trasmissione, imposta l'Intervallo di trasmissione e salva con il pulsante flottante.
- Indirizzo del broker e Porta
- Dove l'app pubblica. Va bene qualsiasi broker: Mosquitto, EMQX, l'add-on dentro Home Assistant o un servizio gestito.
- Usa TLS (SSL)
- Cifra la connessione al broker. Consigliato ogni volta che è esposto fuori dalla tua rete.
- Usa WebSocket e Percorso di base
- Pensati per broker dietro un reverse proxy.
- Formato MQTT
- Home Assistant Discovery, Homie 4.0, Topic semplici, JSON unificato o ThingsBoard.
- Prefisso dell'argomento
- La radice dei topic pubblicati. Cambiarlo dopo lascia i vecchi topic orfani sul broker.
- Utente e Password
- Le credenziali del broker, quando richiede autenticazione.
- Prova connessione
- Conferma l'indirizzo, la porta, TLS e le credenziali prima che la trasmissione venga attivata.
- Intervallo di trasmissione
- Ogni quanto viene inviata l'istantanea dei sensori in tempo reale.
- Pulsante di salvataggio
- Memorizza le impostazioni della scheda attiva e la modalità di sincronizzazione.