Zigbee2mqtt y ZHA Juntos: Guía con un solo coordinador

Actualizado el 01 de febrero de 2026

En el vertiginoso mundo de la domótica, la elección entre Zigbee2MQTT (Z2M) y Zigbee Home Automation (ZHA) ha sido un debate clásico. ¿Y si te dijera que no tienes que elegir? En 2026, la capacidad de usar Zigbee2mqtt y ZHA con un solo coordinador no solo es una realidad, sino una estrategia avanzada para exprimir al máximo tu ecosistema de Home Assistant. Esta guía definitiva te mostrará, paso a paso, cómo lograr una coexistencia perfecta, transformando tu hardware en un centro de control Zigbee dual y ultrapotente.

¿Por Qué Usar Zigbee2MQTT y ZHA Simultáneamente? La Estrategia Definitiva

Puede que te preguntes: ¿para qué complicarse? La respuesta es sencilla: flexibilidad y potencia. Cada sistema tiene sus puntos fuertes y, al combinarlos, obtenemos lo mejor de ambos mundos:

Zigbee2MQTT (Z2M): Es el rey de la compatibilidad. Su base de datos de dispositivos soportados es gigantesca y se actualiza constantemente. Ofrece un control granular, acceso a funciones específicas de los dispositivos (exposes) y una potente interfaz web para la gestión de la red. Es ideal para esos dispositivos nuevos o exóticos que ZHA aún no soporta de forma nativa.
ZHA (Zigbee Home Automation): Es la integración nativa de Home Assistant. Su principal ventaja es la simplicidad y la integración perfecta con el ecosistema de HA. La gestión de dispositivos, las actualizaciones de firmware OTA y la creación de grupos se realizan directamente desde la interfaz de Home Assistant, lo que la convierte en una opción robusta y muy cómoda para el día a día.

Al usar ambos, puedes, por ejemplo, gestionar la mayoría de tus dispositivos estándar con la simplicidad de ZHA, mientras reservas Z2M para ese sensor de presencia mmWave recién lanzado o para realizar diagnósticos avanzados de la red Mesh. Es la configuración perfecta para el entusiasta que no quiere renunciar a nada.

Diagrama de Arquitectura: ¿Cómo Funciona la Magia?

El secreto de esta configuración reside en un componente clave: un Coordinador Zigbee Ethernet (o LAN/WiFi). A diferencia de los coordinadores USB tradicionales que solo permiten una conexión a la vez, un coordinador de red actúa como un servidor. Expone la red Zigbee a través de un puerto TCP, permitiendo que múltiples clientes (en nuestro caso, ZHA y Z2M) se conecten simultáneamente.

      +-----------------------------+
      |       Home Assistant        |
      |                             |
      |  +----------+  +----------+ |
      |  |   ZHA    |  |  Z2M     | |
      |  +----------+  +----------+ |
      |       |              |      |
      +-------|--------------|------+
              |              | (TCP/IP a través de la red local)
              |              |
      +-------V--------------V------+
      | Coordinador Zigbee Ethernet |
      |     (192.168.1.100:6638)    |
      +--------------|--------------+
                     | (Red Zigbee)
           +---------+---------+
           |                   |
      +----------+      +-----------+
      | Bombilla |      |  Sensor   |
      +----------+      +-----------+

Prerrequisitos Esenciales: Tu Checklist para el Éxito

Antes de sumergirnos en la configuración, asegúrate de tener todo lo necesario. Esta no es una tarea para principiantes, pero con esta lista de verificación, estarás en el camino correcto.

✅ Un Coordinador Zigbee Ethernet/LAN/WiFi: Esto es no negociable. Los coordinadores USB como el popular Sonoff Dongle-P/E no funcionarán para este propósito. Necesitas un dispositivo que se conecte a tu red local.
✅ Instancia de Home Assistant: Se recomienda Home Assistant OS o Supervised para una gestión más sencilla de las Apps (anteriormente conocidos como Add-ons).
✅ Dirección IP Fija para el Coordinador: Es crucial que tu coordinador Zigbee tenga una IP estática o una reserva de DHCP en tu router para evitar que cambie y rompa la conexión.
✅ Conocimientos básicos de red: Debes sentirte cómodo encontrando la dirección IP de un dispositivo en tu red local.

Tabla Comparativa: Mejores Coordinadores Zigbee Ethernet para 2026

La elección del hardware es el pilar de esta integración. Aquí tienes una comparativa de los modelos más recomendados y probados por la comunidad en 2026.

Modelo	Chipset	Conectividad	Características Destacadas	Rango de Precio Estimado
SMLIGHT SLZB-06/06M	TI CC2652P7	Ethernet, WiFi, USB-C	Alimentación PoE, antena externa potente, muy estable. El modelo ‘M’ soporta Matter (Thread).	€60 – €85
ZigStar UZG-01	TI CC2652P	Ethernet, WiFi, USB-C	Uno de los pioneros, gran soporte de la comunidad, diseño compacto.	€70 – €90
Tube’s Zigbee Gateways	TI CC2652P	Ethernet (PoE)	Construcción robusta, altamente fiable, enfocado en la estabilidad de la conexión PoE.	€85 – €110

Tutorial Paso a Paso: Configuración de la Doble Instancia

Ahora vamos a la acción. Sigue estos pasos con atención para configurar tu sistema dual.

Paso 1: Configurar el Coordinador Zigbee Ethernet

Una vez conectado tu coordinador a la red, el primer paso es identificar su dirección IP. Puedes encontrarla en la interfaz de tu router, en la sección de clientes DHCP. Una vez localizada, accede a la interfaz web del coordinador (si la tiene) y configúralo para que funcione en modo «TCP Serial Server». Anota la IP y el puerto que te indique (normalmente es el 6638).

Paso 2: Instalar y Configurar Mosquitto Broker

Zigbee2MQTT necesita un intermediario para comunicarse con Home Assistant, y ese es Mosquitto.

Ve a Ajustes > Apps en tu Home Assistant.
En la tienda de Apps, busca e instala «Mosquitto broker».
En la pestaña «Configuración» del App de Mosquitto, crea un nuevo usuario y contraseña. Lo necesitarás en el siguiente paso. Puedes seguir esta guía completa sobre Mosquitto Broker si necesitas más detalles.
Inicia el App de Mosquitto.

Paso 3: Instalar y Configurar Zigbee2MQTT (Conexión TCP)

Con Mosquitto listo, es hora de instalar Z2M.

Ve a Ajustes > Apps > Tienda de Apps. Haz clic en los tres puntos de la esquina superior derecha y selecciona «Repositorios».
Añade la URL del repositorio oficial de Zigbee2MQTT: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt y haz clic en «Añadir».
Busca e instala la App «Zigbee2MQTT». No la inicies todavía.
Ve a la pestaña «Configuración». Aquí es donde ocurre la magia. Debes modificar la sección serial para que apunte a tu coordinador de red.

[IMAGEN: Captura de pantalla de la configuración de la App de Zigbee2MQTT en Home Assistant, destacando la sección ‘serial’.]

Pega el siguiente código, reemplazando la IP por la de tu coordinador:

serial:
  port: tcp://192.168.1.100:6638

Asegúrate también de que la configuración de MQTT apunta a tu broker Mosquitto local con el usuario y contraseña que creaste. Si necesitas una guía más profunda, consulta nuestro tutorial completo de Zigbee2MQTT en Home Assistant. Ahora sí, inicia la App de Z2M.

Paso 4: Integrar ZHA (Conexión Socket)

Finalmente, vamos a añadir ZHA.

Ve a Ajustes > Dispositivos y Servicios y haz clic en «Añadir Integración».
Busca «Zigbee Home Automation» (ZHA).
En el asistente de configuración, se te preguntará por el tipo de radio. Elige «Introducir manualmente la ruta del dispositivo serie».
Para el «Tipo de radio», selecciona «EZSP» o el que corresponda a tu coordinador (la mayoría de los basados en chips de Silicon Labs usan EZSP, y los de Texas Instruments usan ZNP).
En la ruta del dispositivo serie, introduce la dirección de tu coordinador usando el formato socket://.

[IMAGEN: Captura de pantalla del asistente de configuración de ZHA, mostrando la selección de radio manual y el campo para la ruta del dispositivo.]

El formato es el siguiente (¡nota el uso de «socket» en lugar de «tcp»!):

socket://192.168.1.100:6638

Finaliza la configuración. Si todo ha ido bien, ¡tendrás ZHA y Zigbee2MQTT funcionando sobre la misma red Zigbee y el mismo coordinador! Para más detalles, puedes visitar nuestra guía definitiva de ZHA en Home Assistant.

Solución de Problemas Comunes

Incluso con la mejor guía, a veces las cosas no salen como se planean. Aquí tienes soluciones a los problemas más frecuentes:

ZHA o Z2M no se conecta: Verifica que la IP y el puerto del coordinador son correctos en ambas configuraciones. Asegúrate de que no haya un firewall bloqueando el puerto. Prueba a reiniciar el coordinador y luego las Apps de Home Assistant.
Los dispositivos se emparejan en un sistema pero no aparecen en el otro: Esto es un malentendido común. Un dispositivo se empareja a la red Zigbee a través de una de las interfaces (Z2M o ZHA). Una vez en la red, sus entidades aparecerán en Home Assistant y serán accesibles. No necesitas emparejarlo en ambos sistemas.
Error «502 Bad Gateway» en la interfaz de Zigbee2MQTT: Generalmente, esto indica un problema con la conexión a Mosquitto. Revisa los logs de la App de Z2M para ver el error exacto y asegúrate de que el usuario y la contraseña de MQTT son correctos.
La red es inestable: Asegúrate de que el canal Zigbee configurado en ZHA y Z2M es el mismo. Si ambos intentan operar en canales diferentes sobre el mismo hardware, causará conflictos. Lo ideal es configurar el canal directamente en el firmware del coordinador.

Preguntas Frecuentes (FAQ) Actualizadas para 2026

¿Realmente puedo usar Z2M y ZHA a la vez con un solo stick?

Sí, pero con una condición clave: debe ser un coordinador Zigbee basado en red (Ethernet/WiFi), no un stick USB estándar. El coordinador de red permite múltiples conexiones simultáneas a su puerto serie virtual, algo que un puerto USB físico no puede hacer.

¿Tengo que emparejar mis dispositivos dos veces?

No. El dispositivo se une a la red Zigbee una sola vez. Puedes iniciar el proceso de emparejamiento desde la interfaz de Zigbee2MQTT o desde ZHA. Una vez unido, el dispositivo estará en la red y ambas integraciones lo verán, creando sus respectivas entidades en Home Assistant.

Si elimino un dispositivo en ZHA, ¿se elimina de Z2M?

Al eliminar un dispositivo de una de las integraciones en Home Assistant, lo estás eliminando de la red Zigbee. Por lo tanto, desaparecerá de ambas. Es importante ser cuidadoso, ya que la acción en una interfaz afectará a toda la red.

¿Esta configuración afecta al rendimiento de mi red Zigbee?

Si está bien configurada, no debería haber un impacto negativo. El coordinador gestiona la red Zigbee, y las dos integraciones simplemente actúan como clientes que leen y envían comandos. La carga de trabajo es mínima. Sin embargo, una mala configuración (como canales diferentes) sí puede causar problemas.

¿Qué integración debo usar para añadir nuevos dispositivos?

Mi recomendación personal es usar la interfaz de Zigbee2MQTT para añadir dispositivos. Su log es mucho más detallado y te dará más información si el proceso de emparejamiento falla. Una vez emparejado, el dispositivo aparecerá automáticamente en ZHA también.

Conclusión: La Cima de la Flexibilidad Zigbee

Integrar Zigbee2MQTT y ZHA con un solo coordinador es, sin duda, una configuración para usuarios avanzados que buscan el control total. Aunque requiere una inversión inicial en un coordinador Zigbee Ethernet y una configuración meticulosa, los beneficios son innegables. Obtienes la robustez y simplicidad nativa de ZHA junto con la compatibilidad y el poder de diagnóstico casi ilimitado de Z2M.

En 2026, donde la interoperabilidad y la personalización son claves, esta arquitectura dual se posiciona como la solución definitiva para construir un hogar inteligente verdaderamente a tu medida, sin compromisos y preparado para cualquier dispositivo que el futuro nos depare.