Saltar al contenido

ZHA en Home Assistant (2026): Guía Definitiva, Hardware Compatible y Solución de Errores

28/11/2021
Zigbee en Home Assistant

Actualizado: Diciembre de 2025

Configurar correctamente Zigbee Home Assistant es la base de cualquier casa inteligente moderna en 2025. El protocolo Zigbee se ha convertido en el estándar de facto para la domótica DIY porque es rápido, no satura tu WiFi y el consumo de batería de sus sensores es ridículo. Pero, ¿cómo lo integramos en nuestro sistema de forma nativa?

Hasta hace unos años, la decisión era compleja. Hoy, en 2025, la integración nativa ZHA (Zigbee Home Automation) ha madurado tanto que se ha convertido en la opción preferida para la gran mayoría de usuarios.

En esta guía actualizada, vamos a ver qué hardware necesitas, cómo configurar ZHA paso a paso y, lo más importante, cómo solucionar esos molestos problemas de cobertura e interferencias.

Black Friday · Hasta un 40 % de descuento

Ofertas oficiales en domótica inteligente

Interruptores WiFi, relés, sensores, tiras LED y más, con descuentos en la tienda oficial Sonoff. Promoción activa hasta el 15 de diciembre.

Ver ofertas oficiales Enlace de afiliado · Tienda Sonoff

¿Qué es ZHA y por qué elegirlo en 2025?

ZHA es la integración oficial de Home Assistant para Zigbee. A diferencia de otras opciones externas, ZHA vive dentro del núcleo de tu sistema.

Ventajas principales:

  • Integración Nativa: No necesitas instalar Add-ons externos ni configurar servidores MQTT.
  • Velocidad: Al estar integrado en el Core, la latencia es mínima.
  • Actualizaciones OTA: ZHA ahora detecta y actualiza automáticamente el firmware de tus bombillas IKEA o sensores Ledvance sin que tengas que hacer nada.

Hardware Necesario: El Coordinador

Para empezar, necesitas un «Coordinador» (el cerebro de tu red Zigbee). Olvida los hubs propietarios de Xiaomi o Philips Hue; aquí buscamos control total.

1. La opción oficial: Connect ZBT-1 (antes SkyConnect)

Es el dispositivo oficial de Nabu Casa. También es multiprotocolo, lo que significa que está preparado para Matter y Thread. Es pequeño y se integra perfectamente.

2. El Rey Calidad/Precio: Sonoff Zigbee 3.0 USB Dongle Plus (Modelo P)

Sigue siendo el favorito de la comunidad por su chip CC2652P, que ofrece una estabilidad de roca y gran alcance. Si tienes uno y te da problemas, probablemente sea por el firmware.

Lectura recomendada: Cómo Actualizar el ZBDongle-P de Sonoff a la última versión

3. Para Usuarios Avanzados: SMLIGHT SLZB-06 (Ethernet)

Si tu servidor Home Assistant está en un rincón de la casa o en un armario rack metálico, usar un USB es mala idea. Este coordinador se conecta por cable de red (PoE), permitiéndote colocar la antena en el centro exacto de tu vivienda para una cobertura perfecta.

Análisis a fondo: Review del SMLIGHT SLZB-06: ¿El mejor coordinador del mercado?


⚠️ AVISO IMPORTANTE: El error nº1 (USB 3.0)

Antes de conectar nada, debes saber esto: Nunca conectes el dongle Zigbee directamente al puerto USB de tu Raspberry Pi o Mini PC.

Los puertos USB 3.0 generan una interferencia eléctrica que anula la señal Zigbee.

  • Solución: Usa siempre un cable alargador USB de al menos 50cm o 1 metro para alejar la antena del ordenador.

Instalación de ZHA paso a paso

Gracias a las actualizaciones recientes de Home Assistant, el proceso es casi mágico:

  1. Conecta tu Coordinador USB (usando el cable alargador).
  2. Ve a Ajustes > Dispositivos y Servicios.
  3. Es muy probable que Home Assistant te muestre una tarjeta de «Nuevo dispositivo descubierto».
  4. Pulsa en Configurar.
  5. Si te pregunta por el tipo de radio, selecciona el recomendado (generalmente ZNP para chips Texas Instruments o EZSP para Silicon Labs).
  6. Elige la opción «Crear una nueva red» (o restaurar una copia de seguridad si vienes de otra instalación).

¡Listo! Ya tienes tu red Zigbee montada.

ZHA vs Zigbee2MQTT: La Gran Duda

Muchos usuarios dudan entre la facilidad de ZHA y la potencia de Zigbee2MQTT. Aquí tienes la comparativa rápida para 2025:

CaracterísticaZHA (Nativo)Zigbee2MQTT (Add-on)
DificultadMuy Baja (Plug & Play)Media (Requiere Broker MQTT)
CompatibilidadMuy Alta (Dispositivos estándar)Extrema (Soporta casi cualquier cosa de AliExpress)
InterfazIntegrada en HAPanel de control independiente
IndependenciaSe reinicia con Home AssistantSigue funcionando si reinicias HA

Si estás empezando, quédate con ZHA. Si necesitas opciones muy avanzadas o tienes dispositivos muy raros, quizás debas mirar la alternativa.


Solución de Problemas: Mejorando tu Red (Mesh)

Si tus sensores se desconectan o van lentos, revisa estos tres puntos clave.

1. Routers vs End Devices

La red Zigbee es una malla (mesh).

  • Coordinador: El jefe (el USB).
  • Routers: Dispositivos conectados a la corriente (Bombillas, Enchufes, Relés como el Sonoff ZBMINI-R2. Estos repiten la señal.
  • End Devices: Sensores de batería (puerta, movimiento). Estos no repiten señal.

Consejo: Si tienes problemas de cobertura, no compres más sensores; compra enchufes inteligentes para que actúen de repetidores.

2. El canal Zigbee y el Wi-Fi

Zigbee y Wi-Fi comparten la frecuencia de 2.4GHz. Si tu Wi-Fi está en el canal 1, 6 u 11, pueden «pisar» a tu Zigbee.

  • Lo ideal es configurar tu Zigbee en el Canal 15, 20 o 25.
  • Ahora puedes cambiarlo desde ZHA > Configurar > Migrar Radio.

3. Visualización y LQI

Dentro de la integración ZHA, pulsa en «Visualización». Verás un mapa de tu red. Fíjate en el número de las líneas (LQI – Link Quality Indicator).

  • Más de 100: Conexión excelente.
  • Menos de 50: Conexión inestable. Necesitas poner un enchufe repetidor a medio camino.

Preguntas Frecuentes (FAQ)

¿Puedo migrar de Zigbee2MQTT a ZHA fácilmente?

No hay un botón de «migrar». Tendrás que desvincular tus dispositivos y volver a emparejarlos en la nueva integración, aunque los nombres de las entidades se pueden conservar si lo haces con cuidado.

¿Cuántos dispositivos soporta ZHA?

Depende de tu coordinador. Un Sonoff Dongle P con firmware actualizado puede gestionar más de 100 dispositivos directos, y muchos más si usas routers (enchufes/bombillas) que amplíen la red.

¿ZHA funciona sin internet?

Sí, absolutamente. Todo el control es local. Tu casa seguirá funcionando aunque se caiga tu conexión a internet, lo cual es la gran ventaja frente a hubs como los de Tuya o SmartLife.


¿Te ha quedado alguna duda sobre tu instalación Zigbee? ¡Déjala en los comentarios y te ayudamos a configurar tu malla perfecta!

FIRMWARE INTERMITENTE

El Zigbee 3.0 USB Dongle Plus viene pre-flasheado con el firmware del coordinador Z-Stack 3.x.0, pero si desea actualizar, cambie al firmware del enrutador y agregue al Dongle o genere el firmware que admita el control de flujo de hardware, por favor lea el siguiente documento.

Zigbee-3.0-USB-dongle-plus-firmware-flashing-Download

Sígueme a Youtube

Zigbee Home Assistant - Sígueme en Youtube