Come integrare un dispositivo Tasmota in Home Assistant tramite MQTT

Tasmota è un firmware per dispositivi IoT compatibili; MQTT è il protocollo di trasporto; Home Assistant usa l’integrazione Tasmota per discovery e controllo. Non sono la stessa cosa e non tutti i dispositivi commerciali possono essere flashati in sicurezza. La procedura seguente parte da un dispositivo che esegue già Tasmota 9.2 o successivo e da un broker MQTT funzionante.

Prerequisiti & Hardware Necessario

• Dispositivo hardware compatibile con firmware Tasmota, già flashato e configurabile dalla sua interfaccia web.
• Tasmota versione 9.2 o successiva; tasmota-lite.bin non supporta questa integrazione.
• Broker MQTT raggiungibile, per esempio Mosquitto, e integrazione MQTT configurata in Home Assistant.
• Indirizzo IP riservato del dispositivo e rete locale che permetta MQTT. La porta MQTT tipica è 1883/TCP senza TLS o 8883/TCP con TLS, in base al broker.
• Nessun link d’acquisto: il dispositivo deve essere già compatibile e il flash firmware può invalidare garanzia o danneggiare l’hardware.

Procedura passo-passo

1. Verifica firmware e modello. Nel Web UI Tasmota apri la pagina principale e controlla versione, modello e modulo. Non flashare un’immagine scelta solo dal nome commerciale: usa il firmware e la procedura compatibili con il chip e la memoria del dispositivo.
2. Configura la rete. Imposta Wi-Fi, hostname e prenotazione DHCP nel router. Un IP stabile semplifica MQTT e diagnostica; non confondere l’IP del dispositivo con quello del broker.
3. Prepara MQTT. In Home Assistant verifica Impostazioni → Dispositivi e servizi → MQTT. Se usi Mosquitto come app ufficiale, crea un utente Home Assistant dedicato al broker e annota username/password; non usare credenziali amministrative del sistema senza necessità.
4. Configura MQTT su Tasmota. Nel Web UI apri Configuration → Configure MQTT e inserisci host/IP del broker, porta, username e password. Mantieni Topic univoco per ogni dispositivo. Lascia FullTopic al valore predefinito, salvo una topologia MQTT progettata e verificata.
5. Salva e controlla la connessione. Dopo il riavvio apri la console Tasmota e verifica che il dispositivo pubblichi messaggi MQTT senza errori di autenticazione. Se il broker usa TLS, configura certificati e porta secondo la documentazione del broker; non usare 1883 come se fosse cifrato.
6. Abilita la discovery nativa. Nella console Tasmota esegui:

   SetOption19 0

   Premi Invio e verifica la risposta. Questo abilita la discovery nativa richiesta dall’integrazione Tasmota di Home Assistant.
7. Aggiungi l’integrazione Tasmota. In Home Assistant apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione, cerca Tasmota e completa il flusso. Il dispositivo dovrebbe essere scoperto tramite MQTT; se non compare, controlla broker, discovery e topic.
8. Configura il tipo di entità. I relay Tasmota diventano normalmente switch quando SetOption30 0. Con SetOption30 1 possono essere esposti come light. Scegli il comportamento prima di creare automazioni e verifica il risultato nella UI.
9. Configura pulsanti e switch. I pulsanti Tasmota possono diventare trigger di automazione quando SetOption73 è abilitato; non aspettarti automaticamente una binary_sensor. Gli switch fisici possono dipendere da SetOption114 e dalla modalità switch configurata.
10. Verifica la discovery. Controlla che relè, luci, sensori, cover, fan o camera esposti dal modello compaiano sotto il dispositivo Tasmota. Le funzionalità disponibili dipendono dal firmware, dal modulo configurato e dal modello hardware.
11. Testa il controllo senza cloud. Blocca temporaneamente solo l’accesso Internet del dispositivo, lasciando raggiungibili broker e Home Assistant nella LAN. Se MQTT e Tasmota continuano a funzionare, il controllo è locale.
12. Proteggi MQTT. Usa credenziali uniche, ACL per limitare i topic e una VLAN IoT quando disponibile. Non esporre MQTT su Internet e non pubblicare il broker con port forwarding.

Verifica del funzionamento

1. In Tasmota controlla che MQTT sia connesso e che il topic sia univoco.
2. In Home Assistant verifica che il dispositivo Tasmota sia disponibile e che le entità attese siano presenti.
3. Aziona il relay o modifica il sensore e controlla lo stato in entrambe le direzioni.
4. Riavvia il broker, Tasmota e Home Assistant separatamente e verifica il recupero automatico.
5. Controlla i log MQTT per assicurarti che non ci siano connessioni anonime o topic duplicati.

Problemi comuni

FAQ essenziali

Posso integrare Tasmota senza MQTT?

La procedura ufficiale dell’integrazione Tasmota di Home Assistant richiede un broker MQTT e la discovery nativa. Senza MQTT devi usare un percorso diverso e non questa integrazione.

Devo usare Tasmota su ogni dispositivo Wi-Fi?

No. Il firmware è supportato solo da hardware compatibile e il flash può essere rischioso. Verifica sempre chip, memoria, alimentazione e metodo di recupero prima di sostituire il firmware.