Skip to main content

Conectar a Home Assistant a través del XIAO ESP32-C5 Zigbee


La integración de dispositivos Zigbee en ecosistemas de hogar inteligente se ha vuelto cada vez más popular debido al bajo consumo de energía, confiabilidad y facilidad de uso de Zigbee. En esta wiki, te guiaremos a través de la conexión del XIAO ESP32-C5 a Home Assistant a través de su funcionalidad Zigbee. Al final de esta guía, tendrás una demostración funcional donde el XIAO ESP32-C5 actúa como un dispositivo Zigbee que puede ser controlado directamente desde el panel de control de Home Assistant.

Este tutorial destaca el uso del SDK de Zigbee de Espressif (Arduino) y demuestra cómo desarrollar e integrar tus propios dispositivos Zigbee en Home Assistant.

Preparación del Hardware​

Para seguir esta guía, necesitarás lo siguiente:

  1. Home Assistant Green: Un dispositivo de hardware dedicado de Home Assistant para gestionar tu hogar inteligente.
  2. Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E: Un coordinador Zigbee para habilitar la creación de redes Zigbee y la comunicación.
  3. XIAO ESP32-C5: Una placa de desarrollo con funcionalidad Zigbee habilitada a través del SDK de Espressif.
Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-EXIAO ESP32-C5Home Assistant Green
Obtener Uno Ahora 🖱️
Obtener Uno Ahora 🖱️
Obtener Uno Ahora 🖱️
tip

Si no tienes un Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E a mano, también puedes elegir el Home Assistant Connect ZBT-2.

Integrando Zigbee con Home Assistant​

Te mostraremos cómo usar el XIAO ESP32-C5 como un dispositivo Zigbee para conectar a Home Assistant.

Conectar ZBDongle-E​

Inserta el Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E en un cable de extensión USB. Conecta el cable de extensión al Home Assistant Green.

caution

Los puertos USB 3.0 y las unidades USB 3.0 pueden causar interferencia con protocolos de 2.4 GHz, incluyendo los proporcionados por Home Assistant Connect ZBDongle-E. Es importante usar el cable de extensión USB y posicionar el Home Assistant Connect ZBDongle-E lejos de posibles fuentes de interferencia.

Paso 1. Descubriendo Dispositivos Zigbee

  • Setting -> Devices & services

-Bajo Integrations, encontrarás el dispositivo SONOFF Zigbee 3.0 USB Dongle Plus V2, que es el Sonoff Zigbee 3.0 USB Dongle Plus–ZBDongle-E.


Paso 2. Agregando Dispositivos Zigbee


Paso 3. Creando una Red Zigbee

  • Después de hacer clic en Submit, se te pedirá que selecciones el modo del dispositivo Zigbee. Elige crear una red Zigbee en Home Assistant.

  • Una vez exitoso, encontrarás que el dispositivo Zigbee ha sido agregado bajo Configured.

  • El ZBDongle-E está configurado como el coordinador, que puede controlar dispositivos finales Zigbee.

Flashear el Ejemplo Zigbee​

Usaremos el ejemplo Zigbee HA_On_Off_Light del Arduino IDE para esta demostración.
Si no has usado el Arduino IDE antes, por favor consulta Introducción al Seeed Studio XIAO ESP32-C5 para comenzar.

Paso 1. selecciona el ejemplo del Arduino IDE a través de la ruta: File -> Examples -> Zigbee -> Zigbee_On_Off_Light.


Paso 2. Configurar el Dispositivo Final y el Esquema de Partición

  • Haz clic en Tools -> Zigbee Mode y selecciona el modo como Zigbee ED (End Device).
  • Selecciona Partition Scheme, ve a Tools -> Partition Scheme -> Zigbee 8MB with spiffs

La memoria FLASH del XIAO ESP32-C5 es de 8MB. Al seleccionar un esquema de partición, se recomienda elegir Zigbee 8MB with spiffs.


Paso 3. Modificar el Pin LED y el Nombre

  • Localiza el código relacionado con la configuración de pines en el ejemplo.
uint8_t led = RGB_BUILTIN;
  • En el XIAO ESP32-C5, el LED USER integrado corresponde al pin GPIO27, que necesita ser modificado.
uint8_t led = 27;

  • En el XIAO ESP32-C5, el LED USER integrado corresponde al pin GPIO27, que necesita ser modificado.
zbLight.setManufacturerAndModel("Espressif", "ZBLightBulb");
  • Modificado
zbLight.setManufacturerAndModel("XIAO-ESP32-C5", "ZBLightBulb");

Paso 4. Cargar

Carga el código de ejemplo con los pines modificados al XIAO ESP32-C5.

Conectar a la Red Zigbee​

Conecta el XIAO ESP32-C5 (configurado como un Dispositivo Final Zigbee) a la red Zigbee creada en Home Assistant.

Paso 1. Descubrir Dispositivos Finales

  • Después de flashear el código de ejemplo al XIAO ESP32-C5, se unirá automáticamente a la red Zigbee. Abre la página de Integrations, y verás aparecer dos dispositivos Zigbee.

  • Uno es el dispositivo Coordinador (el ZBDongle-E conectado al Home Assistant Green), y el otro es el Dispositivo Final (XIAO-ESP32-C5 ZBLightBulb).

tip

Para unirse a la red Zigbee más rápido y de manera más estable, puedes conectar la antena flexible FPC del paquete al XIAO ESP32-C5.

Paso 2. Agregar al Panel de Control

  • Haz clic en el dispositivo XIAO-ESP32-C5 ZBLightBulb y agrégalo al panel de control.

  • Puedes encontrar el dispositivo XIAO-ESP32-C5 ZBLightBulb en el panel de control, donde puedes enviar comandos de control a él.

Presentación del Efecto​

  • Cuando el dispositivo final XIAO ESP32-C5 se une exitosamente a la red Zigbee, se mostrará en el Serial Monitor.

  • Efecto Real

Conclusión​

Espressif ofrece una amplia gama de tipos de dispositivos Zigbee y un extenso SDK de Zigbee, permitiendo a los desarrolladores crear fácilmente sus propios dispositivos Zigbee. Siguiendo este tutorial, has aprendido cómo integrar el XIAO ESP32-C5 en Home Assistant usando Zigbee, agregando dispositivos personalizados a tu ecosistema de hogar inteligente.

Con la flexibilidad del SDK Zigbee de Espressif, puedes comenzar a construir tus propios dispositivos Zigbee para diversas aplicaciones y características, y agregarlos sin problemas a Home Assistant para un control centralizado. ¡Feliz construcción!

Soporte Técnico y Discusión de Productos​

¡Gracias por elegir nuestros productos! Estamos aquí para brindarte diferentes tipos de soporte para asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para satisfacer diferentes preferencias y necesidades.

Loading Comments...