menú

🔎 Cómo agregar dispositivos Zigbee con Home Assistant usando la integración ZHA

Introducción

Los SONOFF ZBDongle-P y ZBDongle-E son puertas de enlace USB Zigbee diseñadas para integrar dispositivos Zigbee en su ecosistema de hogar inteligente. Ya sea que use Home Assistant, iHost o Homebridge, estos adaptadores permiten una integración perfecta de SONOFF con dispositivos Zigbee de terceros.

En esta guía, aprenderá cómo configurar su ZBDongle con Home Assistant usando la integración ZHA , agregar dispositivos Zigbee y administrar su red de malla Zigbee de manera eficiente.

¿Que necesitarás?

  • 1x SONOFF ZBDongle-P o ZBDongle-E

  • Home Assistant instalado ( iHost , Home Assistant Green, Raspberry Pi, etc.)

  • Puerto USB disponible para el dongle

  • Dispositivos Zigbee (por ejemplo, enchufe inteligente SONOFF, sensor de puerta )

1. Inserte el ZBDongle en un puerto USB

Empieza conectando tu SONOFF ZBDongle al puerto USB de tu dispositivo Home Assistant. En esta guía, usamos un iHost, pero los pasos son los mismos para otras configuraciones, como Home Assistant Green o una Raspberry Pi.

2. Detectar el Dongle

Una vez que el dongle esté conectado y el sistema esté encendido:

  • Vaya a Configuración > Dispositivos y servicios

  • Debería aparecer automáticamente una nueva integración llamada ZHA .

📝 Nota: Si no aparece, haga clic en “Agregar integración” y busque manualmente ZHA .

3. Iniciar la configuración

Haga clic en la integración ZHA y luego:

  • Seleccione “Crear red”


  • Espere unos segundos a que Home Assistant finalice la instalación.

  • Ya está listo para comenzar a agregar dispositivos Zigbee a su red

Con el ZBDongle instalado y ZHA en funcionamiento, es hora de agregar algunos dispositivos Zigbee.

En este ejemplo, agregaremos:

  • 1x enchufe inteligente SONOFF Zigbee (actúa como repetidor)

  • 1x Sensor de puerta SONOFF SNZB-04P (dispositivo final)

1. Ingrese al modo de emparejamiento

Ve a Ajustes > Dispositivos y servicios > Integración con ZHA > Añadir dispositivo . Home Assistant ahora detecta dispositivos en modo de emparejamiento.



2. Empareje cada dispositivo

  • Enchufe inteligente : Mantenga pulsado el botón durante unos 5 segundos hasta que entre en modo de emparejamiento. Debería aparecer en Home Assistant en unos segundos.

  • Sensor de puerta : repita el mismo proceso (generalmente manteniendo presionado el botón de reinicio/emparejamiento).

Puede cambiar el nombre de los dispositivos, asignarlos a una habitación y comenzar a usarlos de inmediato.

📘 Para obtener más información sobre las funciones y el comportamiento de los dispositivos Zigbee, consulte el módulo Protocolos de hogares inteligentes en SONOFF Academy.

Controlar y comprobar el estado del dispositivo

Una vez agregados, hay dos formas de monitorear y controlar los dispositivos Zigbee :

1. Desde la pestaña Dispositivos

  • Vaya a Configuración > Dispositivos y servicios > Dispositivos

  • Utilice el filtro para ver solo los dispositivos ZHA


2. Desde la página de integración de ZHA

  • Abra Configuración > Dispositivos y servicios > ZHA

  • Ver todos los dispositivos emparejados a través del ZBDongle

  • Haga clic en cualquier dispositivo para comprobar su estado , cambiarle el nombre o controlarlo (por ejemplo, encender o apagar un enchufe inteligente)

Gestión de redes Zigbee

El ZBDongle se convierte en el coordinador de su red Zigbee, administrando las conexiones y la comunicación entre todos los dispositivos en una estructura de malla.

Funciones disponibles en la integración de ZHA

  • Cambiar el canal Zigbee
    Algunos canales Zigbee pueden interferir con el Wi-Fi. Para un rendimiento óptimo, elija un canal que no se solape. Puede cambiarlo en la configuración del coordinador .



    Seleccione la pestaña "Red" para ver y cambiar el canal zigbee si lo desea.



  • Ver el mapa de la red Zigbee
    Haga clic en el menú de tres puntos (⋮) en la página ZHA y seleccione "Ver red" .
    Verá una representación visual de su red , que muestra:

    • El coordinador

    • Enrutadores (por ejemplo, enchufes inteligentes que repiten la señal)

    • Dispositivos finales (por ejemplo, sensores de puerta)

    • LQI (indicador de calidad de enlace) para cada conexión: cuanto mayor sea el LQI, más fuerte será la señal.




      Aquí podemos ver la red Zigbee y las conexiones entre los diferentes dispositivos.

📚 Para obtener más información sobre la arquitectura Zigbee y el comportamiento de la malla, consulte el módulo Protocolos de hogares inteligentes en SONOFF Academy.

Conclusión

Los SONOFF ZBDongle-P y ZBDongle-E son potentes herramientas para crear una red Zigbee flexible, escalable y estable en Home Assistant. Con la integración con ZHA, podrá fácilmente:

  • Agregar y controlar dispositivos Zigbee

  • Monitorizar la intensidad de la señal y optimizar la ubicación

  • Ver y administrar la estructura de su red

  • Evite interferencias con la selección de canales personalizados

Ya sea que recién esté comenzando o ampliando una configuración existente, este dispositivo facilita la incorporación de dispositivos SONOFF y Zigbee de terceros a su ecosistema de hogar inteligente.

Anterior
🔎 ¿Cómo integrar SONOFF R5/S-Mate en Home Assistant?
Próximo
🔎 Cómo actualizar el firmware Zigbee en ZHA y Z2M
Recientemente modificado: 2025-08-19