Zigbee2MQTT vs ZHA: quale scegliere per Home Assistant

Prerequisiti & Hardware Necessario

• Hardware: un coordinatore Zigbee USB compatibile, prolunga USB schermata e host Home Assistant. Un Raspberry Pi 5 con alimentatore ufficiale è un esempio di host: Raspberry Pi 5 4GB con alimentatore ufficiale.
• Software: ZHA è un’integrazione nativa di Home Assistant che gestisce direttamente il coordinatore; Zigbee2MQTT è un gateway separato che usa MQTT per esporre i dispositivi a Home Assistant.
• Regola hardware: un singolo coordinatore non deve essere aperto contemporaneamente da ZHA e Zigbee2MQTT. Per due reti indipendenti servono due coordinatori e canali radio pianificati.
• Backup: prima di scegliere o migrare esporta il backup Home Assistant e il backup della rete Zigbee2MQTT, se disponibile. Il pairing non è automaticamente trasferibile tra i due stack.

Procedura passo-passo

1. Inventaria il sistema. Annota host, modello coordinatore, firmware, percorso /dev/serial/by-id, numero di dispositivi e integrazioni che richiedono caratteristiche specifiche. Non scegliere dal solo nome commerciale del dongle.
2. Scegli ZHA se vuoi un’integrazione nativa. ZHA si configura in Home Assistant, non richiede un broker MQTT per il percorso base e offre backup e migrazione del coordinatore dall’interfaccia Home Assistant. È adatto se vuoi meno componenti separati.
3. Scegli Zigbee2MQTT se vuoi un gateway separato. Zigbee2MQTT richiede un broker MQTT, un database/configurazione propri e una compatibilità documentata dei dispositivi. È adatto se vuoi separare radio e Home Assistant o usare lo stesso gateway con più client MQTT.
4. Non installare entrambi sullo stesso coordinatore. Se ZHA è configurato, disabilitalo prima di avviare Zigbee2MQTT; se usi Zigbee2MQTT, non aggiungere lo stesso device seriale a ZHA. Controlla i log per errori “port in use”.
5. Configura ZHA. In Home Assistant vai in Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Zigbee Home Automation, seleziona il coordinatore e il percorso seriale stabile, poi crea la rete. Usa una prolunga USB e tieni il coordinatore lontano da USB 3.
6. Oppure configura Zigbee2MQTT. Imposta nel suo configuration.yaml il broker MQTT, il percorso seriale, il tipo adapter e homeassistant.enabled: true. Poi configura l’integrazione MQTT in Home Assistant. Non configurare manualmente la stessa radio anche in ZHA.
7. Confronta il risultato con criteri concreti.

   Criterio	ZHA	Zigbee2MQTT
   Architettura	Integrazione Home Assistant	Gateway separato + MQTT
   Broker MQTT	Non necessario per il percorso base	Obbligatorio
   Gestione radio	Dentro Home Assistant	Nel processo Zigbee2MQTT
   Backup	Backup rete da Home Assistant	Backup e database nella directory dati
   Hardware	Coordinatore compatibile ZHA	Adapter/firmware supportati da Zigbee2MQTT

8. Abbina un dispositivo di prova. Includi un sensore vicino al coordinatore, verifica stato e batteria, poi spostalo nella posizione prevista. Valuta anche i router Zigbee alimentati, non solo la portata dichiarata del dongle.
9. Configura il backup corretto. Per ZHA crea un backup dalla configurazione Zigbee; per Zigbee2MQTT conserva la directory dati, database e coordinator_backup.json quando prodotto dall’adapter. Un backup Home Assistant non equivale automaticamente al backup della rete Zigbee2MQTT.
10. Pianifica una migrazione solo dopo una prova. Spegni il vecchio stack, collega il nuovo coordinatore e segui la procedura prevista. La migrazione tra ZHA e Zigbee2MQTT può richiedere re-pairing e non va eseguita cancellando il vecchio database prima del backup.

Verifica del funzionamento

La scelta è corretta quando un solo stack controlla il coordinatore, tutti i dispositivi principali rispondono, i log non mostrano conflitti seriali e il backup è stato esportato fuori dall’host. Per ZHA controlla il pannello Zigbee di Home Assistant; per Zigbee2MQTT controlla frontend, broker MQTT e discovery in Home Assistant.

Problemi comuni

FAQ essenziali

Quale dei due è più affidabile?

Nessuno è universalmente migliore: stabilità dipende da coordinatore, firmware, canale, alimentazione, interferenze e dispositivi. Scegli l’architettura che puoi aggiornare e fare il backup correttamente.

Posso cambiare da ZHA a Zigbee2MQTT senza rifare il pairing?

Non è garantito. I due stack hanno backup e procedure diverse; conserva i backup e considera il re-pairing come possibile requisito, soprattutto cambiando coordinatore o formato di rete.