MQTT

Pubblicare le letture su un broker tuo e scegliere tra i cinque formati di messaggio.

La scheda MQTT pubblica le stesse letture su qualsiasi broker. Serve a chi alimenta un sistema diverso da Home Assistant, o a chi preferisce alimentare Home Assistant tramite il proprio broker.

Come per l'integrazione nativa, la connessione va dal tuo telefono direttamente alla tua macchina, senza passare dai nostri server.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Prova prima di uscire

    Tocca Prova connessione. La prova conferma l'indirizzo, la porta, TLS e le credenziali prima che tu attivi la trasmissione.

  6. Attiva la trasmissione e salva

    Attiva Abilita trasmissione, imposta l'Intervallo di trasmissione e salva con il pulsante flottante.

Se qualcosa va storto

Controlla in quest'ordine: l'indirizzo e la porta, se il telefono è su una rete che raggiunge il broker, se Usa TLS (SSL) corrisponde a quanto il broker si aspetta, e se utente e password sono giusti.

La porta 1883 di solito funziona senza TLS, e la 8883 con TLS. Attivare TLS contro una porta che non lo usa produce un errore senza messaggi utili.

Scegli il formato Home Assistant Discovery, l'unico con scoperta automatica. Negli altri formati, le entità vanno dichiarate a mano.

Per Home Assistant, considera l'integrazione nativa: è bidirezionale, pubblica eventi sul bus e non richiede broker.

L'app chiede se vuoi ripulire i topic del formato precedente. Se la risposta è stata di tenerli, restano sul broker finché non vengono rimossi lì.

Per Home Assistant, l'integrazione nativa offre di più: è bidirezionale, pubblica eventi sul bus e non richiede broker.

MQTT è la scelta giusta quando hai già un broker, quando alimenti un sistema che non è Home Assistant, o quando ti servono i dati in più posti contemporaneamente.

← Tutte le guideNelle FAQ: Home Assistant e MQTT →