DomotiCasa

La tua guida alla casa intelligente

Come installare Zigbee2MQTT su Home Assistant

Come installare Zigbee2MQTT su Home Assistant: controllo totale dei dispositivi Zigbee

Giovanni Provenzano07 mins

Zigbee2MQTT (Z2M) è l’integrazione avanzata che consente di collegare oltre 3.000 dispositivi Zigbee di qualsiasi marca (Philips, Lidl, Tuya, Aqara, IKEA, Sonoff ecc.) al tuo sistema Home Assistant senza dover dipendere da hub e cloud proprietari. Il risultato: controllo locale, massimo risparmio, aggiornamenti rapidi e automazioni senza limiti.

Questa guida ti spiega come installare Zigbee2MQTT su Home Assistant, passo dopo passo, con dritte su hardware, firmware, setup MQTT e trucchi per una rete Zigbee robusta.

Perché scegliere Zigbee2MQTT rispetto a ZHA?

  • Compatibilità più ampia: ben oltre 3.000 dispositivi supportati, nuovi device aggiunti ogni settimana.

  • Aggiornamenti rapidi: la community Z2M integra velocemente i prodotti appena usciti.

  • Più controllo: puoi personalizzare ogni aspetto dei dispositivi Zigbee, dalle automazioni avanzate alle impostazioni di risparmio energetico.

  • MQTT: protocollo universale e integrabile anche su sistemi esterni.

ZHA è ottimo per chi cerca un’integrazione semplice e plug&play, ma se vuoi massima compatibilità e controllo, Zigbee2MQTT è la scelta giusta.

Cosa serve per iniziare

  • Un coordinatore Zigbee compatibile (es: Sonoff ZBDongle-P/E, CC2652P/U, TubesZB, Zigstar ecc.).

  • Home Assistant (OS, Supervised, Container o Core)

  • Broker MQTT (es: Mosquitto, installabile come add-on su Home Assistant)

  • PC Windows/Mac/Linux per aggiornare firmware della chiavetta (solo la prima volta)

  • Dispositivi Zigbee (lampadine, sensori, prese…)

Step 1: Preparazione coordinatore (chiavetta Zigbee)

Scegliere e aggiornare la chiavetta

Sono molto diffusi Sonoff ZBDongle-E (chip EFR32) e -P (CC2652P): verifica il modello e scarica il firmware corretto da sito ufficiale Z2M. Il flashing si fa una sola volta e basta seguire le istruzioni con tool come cc2538-bsl o Python Programmer.

#1
SONOFF ZigBee 3.0 USB Dongle Plus, TI CC2652P Coordinator, universale USB ZigBee Hub, Gateway ZigBee per Home Assistant
SONOFF ZigBee 3.0 USB Dongle Plus, TI CC2652P Coordinator, universale USB ZigBee Hub, Gateway ZigBee per Home Assistant
by SONOFF

Pre-flash con firmware coordinatore Z-Stack 3.x.0 Può usare ZHA in Home Assistant o utilizzare Zigbee2MQTT Base su TI CC2652P + CP2102N +20dBm guadag...

List Price: € 35,58 You Save: € 5,09 (-14%)  Price: € 30,49 Compra ora

Collega la chiavetta alla porta USB del server Home Assistant

Step 2: Installa il broker MQTT

  • Su Home Assistant OS/Supervised: Impostazioni → Add-on → Mosquitto broker → Installa

  • Abilita “Avvia all’avvio” e “Watchdog”.

Step 3: Installa l’add-on Zigbee2MQTT

Step 4: Configura Zigbee2MQTT

Dopo l’installazione, apri la scheda “Configurazione” dell’add-on.

Modifica le seguenti impostazioni base:

homeassistant: true

mqtt:
  base_topic: zigbee2mqtt
  server: 'mqtt://core-mosquitto'
  user: <tuo_user>
  password: <tua_password>

serial:
  port: /dev/ttyUSB0   # Cambia in base a dove si trova la chiavetta (vedi impostazioni hardware HA)

frontend:
  port: 8080

Salva e avvia l’add-on.

Accedi all’interfaccia Zigbee2MQTT:
Basta andare su http://homeassistant.local:8080 (o IP_host:8080).

Step 5: Pair dei dispositivi Zigbee

  • Metti in pairing un nuovo dispositivo Zigbee (seguendo le istruzioni del produttore)

  • Clicca “Permetti associazione” nell’interfaccia Zigbee2MQTT

  • I nuovi device compariranno nell’elenco, già pronti per essere configurati e controllati

Step 6: Automazioni, dashboard e funzioni avanzate

  • Tutti i device Z2M saranno visibili su Home Assistant come entità MQTT.

  • Puoi rinominare, attribuire icone, impostare automazioni e script di ogni tipo.

  • Zigbee2MQTT supporta OTA update, binding avanzati, link diretto fra dispositivi (es: pulsante–>lampadina anche offline), logging dettagliato e diagnostiche.

Consigli e trucchi

  • Quando possibile, collega coordinatore Zigbee su cavo USB con prolunga per evitare interferenze RF dal Raspberry/miniPC.

  • Non inserire la chiavetta su hub USB 3.0 economici (possono causare problemi radio).

  • Usa dispositivi Zigbee a batteria come router di mesh zigbee aggiuntivo (es. prese sempre alimentate): la rete sarà più stabile e performante.

  • Aggiorna regolarmente firmware Z2M e chiavetta!

Guida alla risoluzione problemi

  • Se il device non si aggiunge: ripeti la procedura di pairing e resetta il dispositivo Zigbee (consulta manuale).

  • Interfaccia Zigbee2MQTT non si apre: verifica che la porta 8080 sia libera e non usata da altri servizi.

  • Errori MQTT: controlla user/password o hostname, assicurati che Mosquitto sia attivo.

Con Zigbee2MQTT avrai il miglior controllo possibile sulla tua rete Zigbee, senza limiti o vincoli cloud. Puoi combinare dispositivi di qualsiasi marca e modello con automazioni avanzate. Se hai già molte periferiche Zigbee o vuoi la flessibilità massima, questa è l’integrazione definitiva per Home Assistant!

Titoli Correlati