Zigbee2MQTT o ZHA: cuál elegir para Home Assistant

Has conectado un dongle Zigbee al Raspberry Pi o al Home Assistant Green y Home Assistant ofrece ZHA o Zigbee2MQTT. Ambos hablan con tus sensores, enchufes y bombillas Zigbee, pero de forma distinta. Guía basada en documentación oficial de ZHA y Zigbee2MQTT (octubre 2026). Sin cifras de alcance inventadas.

Respuesta corta

¿Empiezas y quieres rapidez? ZHA. Integración incluida: sin MQTT extra, todo en la interfaz habitual.
¿Bricolaje, dispositivos raros o datos fuera de HA? Zigbee2MQTT. Corre aparte, publica en MQTT, interfaz web detallada.
Solo uno a la vez por dongle. Un coordinador, un software.

Esquema

ZHA:          sensor → dongle → Home Assistant (ZHA)
Zigbee2MQTT:  sensor → dongle → Z2M → Mosquitto → Home Assistant

Tabla comparativa

	ZHA	Zigbee2MQTT
Dónde corre	Integrado en HA	App/complemento aparte
MQTT	No hace falta	Obligatorio (Mosquitto)
Instalación	Pocos clics	Mosquitto + repo + app Z2M
Interfaz	Ajustes de HA	Web propia
Claves (familia chip)	Silicon Labs, TI, deCONZ, ZiGate	TI y Silicon Labs recomendados
Dispositivos raros	«Quirks»	«Converters»
OTA	Lista limitada	Depósito comunitario
Fuera de HA	No	Cualquier cliente MQTT
Hardware mínimo	El de HA	Pi 4 recomendado (Pi 3 inestable)

ZHA: ventajas y límites

Ventajas: nada más que instalar; detección automática de muchos dongles; copias de red y migración entre claves (Silicon Labs, TI, ConBee) sin reemparejar; mapa en Ajustes → Conectividad → Zigbee.

Límites: dispositivos no estándar pueden quedar a medias hasta tener quirk; sensores solo visibles en HA.

Zigbee2MQTT: ventajas y límites

Ventajas: web completa; lista de dispositivos para comprobar antes de comprar; MQTT usable desde Node-RED o scripts Python (tutoriales Pi).

Límites: Mosquitto + Z2M que mantener; más exigente en CPU.

Dongles

SONOFF ZBDongle-E (EFR32MG21) funciona en ambos. Home Assistant Connect ZBT-2 (MG24) es oficial; Zigbee o Thread. Detalle: mejor dongle Zigbee.

En Amazon.es: SONOFF ZBDongle-E.

Consejo Z2M: extensión USB ~1 m para alejar el dongle del Pi y del USB 3.

Instalar ZHA

Dongle en el Pi/Green (mejor con extensión USB).
Si aparece descubierto: Ajustes → Dispositivos y servicios → Configurar.
Si no: Añadir integración → Zigbee Home Automation y el puerto serie.
Conectividad → Zigbee → Añadir dispositivo y reset del sensor según manual.

Instalar Zigbee2MQTT (HA OS)

Si ZHA usa el dongle, elimina ZHA antes.

App Mosquitto broker e iniciar.
Repositorio https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.
App Zigbee2MQTT (estable, no Edge) e iniciar.
Asistente web: elige dongle, canal Wi-Fi cercano.
Emparejar desde la web Z2M; entidades llegan por MQTT.

SONOFF ZBDongle-E, ejemplo config:

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

Cambiar de uno a otro

Migración sin reemparejar solo entre claves dentro de ZHA. Cambiar ZHA ↔ Z2M implica reemparejar. Copia de seguridad completa antes.

Errores frecuentes

Dongle «ocupado»: solo ZHA o Z2M (o deCONZ), no ambos.
Caídas de red: fija canal Wi-Fi del router; añade repetidores (enchufes Zigbee).
Cambiar canal Zigbee en ZHA: puede tardar hasta ~1 h en reajustarse.
En Linux contenedor: desinstalar modemmanager si roba el USB (doc ZHA).

Perfil

Familia, 5–20 dispositivos comunes: ZHA.
Maker + MQTT/Python: Zigbee2MQTT.
Modelo concreto: búscalo en listas de soporte de ambos antes de elegir.

FAQ

¿Dos dongles, ZHA y Z2M a la vez? Sí con dos redes separadas; poco útil en casa.

¿Z2M más «pro»? Más detalle, no necesariamente mejor para ti.

¿MQTT para ZHA? No.

¿ConBee II? ZHA (deCONZ) y Z2M (deconz); prioridad TI/Silicon Labs en Z2M.

¿Pi 3? Z2M pide Pi 4+. Hardware HA: Green vs Pi 5.

Más lectura

Enlaces Amazon.es tag roboteducat07-21. Comparativa documental, sin prueba física.

Todas las guías