Zigbee2MQTT o ZHA: quale scegliere per Home Assistant?

Avete collegato una chiavetta Zigbee al Raspberry Pi o Home Assistant Green e Home Assistant propone ZHA o Zigbee2MQTT. Entrambi parlano con sensori, prese e lampadine Zigbee, ma in modo diverso. Guida basata sulle documentazioni ufficiali ZHA e Zigbee2MQTT (ottobre 2026). Nessun dato inventato su velocità o portata.

Risposta breve

Principianti, setup rapido? ZHA. Integrato in Home Assistant: niente MQTT, tutto nelle impostazioni usuali.
Maker, dispositivi esotici o dati fuori da HA? Zigbee2MQTT. Add-on separato, MQTT, interfaccia web dettagliata.
Un solo software per chiavetta. Un coordinatore = un solo stack (ZHA oppure Zigbee2MQTT).

Schema

ZHA:          sensore → chiavetta USB → Home Assistant (ZHA)
Zigbee2MQTT:  sensore → chiavetta → Zigbee2MQTT → Mosquitto → Home Assistant

Tabella comparativa

	ZHA	Zigbee2MQTT
Dove gira	Integrazione HA	Programma separato (add-on HA OS o altro host)
MQTT	Non serve	Obbligatorio (Mosquitto)
Installazione	Pochi clic	Mosquitto, repo, add-on, wizard
Interfaccia	Impostazioni HA	Web UI dedicata
Chiavette (famiglie chip)	Silicon Labs (EZSP), TI (ZNP), deCONZ, ZiGate	TI (zStack) e Silicon Labs (EmberZNet) consigliati
Dispositivi non standard	« quirks »	« converters »
OTA firmware	Limitato	Repository firmware
Backup rete	Automatici; migrazione chiavetta in ZHA	Backup coordinatore zStack/Ember
Dati fuori HA	No	Sì (qualsiasi client MQTT)
Hardware minimo	Quello di HA	Consigliato almeno Raspberry Pi 4 per l’add-on

ZHA: pro e contro

Pro: niente componenti extra, auto-rilevamento chiavette, backup rete, mappa in Impostazioni → Connettività → Zigbee.

Contro: dispositivi non conformi possono mostrare funzioni parziali; sensori visibili solo in HA.

Zigbee2MQTT: pro e contro

Pro: UI completa, elenco dispositivi online, indipendente da HA (Node-RED, script Python).

Contro: Mosquitto + Z2M da mantenere; Pi 3 può essere instabile (minimo Pi 4 consigliato).

Quale chiavetta?

Silicon Labs e Texas Instruments vanno con entrambi. SONOFF ZBDongle-E (EFR32MG21): lista ZHA + driver ember in Z2M. Home Assistant Connect ZBT-2 (MG24): ufficiale, Zigbee o Thread. Dettaglio: miglior chiavetta Zigbee.

Consiglio Z2M: prolunga USB, non chiavetta attaccata direttamente al Pi (interferenze 2,4 GHz).

Installare ZHA

Chiavetta via prolunga USB.
Se rilevata: Impostazioni → Dispositivi e servizi → Configura.
Altrimenti: aggiungi integrazione Zigbee Home Automation, porta seriale.
Connettività → Zigbee → Aggiungi dispositivo, reset sensore secondo manuale.

Installare Zigbee2MQTT (Home Assistant OS)

Se ZHA usa già la chiavetta, rimuovete ZHA prima.

Add-on Mosquitto broker, avviarlo.
Repo add-on: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.
Installare Zigbee2MQTT (stable), Avvia.
Wizard web: scegliere chiavetta, canale Wi-Fi vicino per canale Zigbee.
502 Bad Gateway iniziale: normale, attendere; oltre 2 min controllare log.
Appairing dall’interfaccia Z2M.

Esempio manuale ZBDongle-E:

adapter: ember
port: /dev/serial/by-id/usb-…-if00-port0

TI: zstack invece di ember.

Passare da uno all’altro

Migrare senza ri-appairing è documentato soprattutto dentro ZHA (cambio chiavetta). Cambiare software = in pratica ri-appairing. Backup HA completo prima.

Errori frequenti

Chiavetta già in uso: un solo stack.
Dispositivi che cadono: Wi-Fi e Zigbee su 2,4 GHz — fissare canale Wi-Fi, aggiungere router a rete (prese/lampadine). Lampadina sempre spenta all’interruttore = mesh debole.
Cambio canale Zigbee in ZHA: fino a ~1 h per riallineamento dispositivi.
Linux container: servizio modemmanager può rubare la USB — disinstallarlo (doc ZHA).

Consiglio per profilo

Famiglia, 5–20 dispositivi comuni: ZHA.
Script MQTT su Pi (sensori Raspberry): Zigbee2MQTT.
Modello specifico: cercatelo in Z2M e compatibilità ZHA prima di comprare.

FAQ

ZHA e Z2M insieme? Solo con due chiavette e due reti — raro e scomodo.
Z2M più « pro »? Più dettagliato, non necessariamente migliore per casa.
MQTT per ZHA? No.
ConBee II? ZHA (deCONZ) e Z2M (deconz); Z2M preferisce TI/Silicon Labs.
Pi 3? Z2M: minimo Pi 4. Hardware HA: Green vs Pi 5.

Affiliazione Amazon.it tag roboteducat0f-21 dove applicabile.

Tutte le guide