Conectarse a Home Assistant con XIAO ESP32C6 y Zigbee

La integración de dispositivos Zigbee en ecosistemas de casas inteligentes ha ganado popularidad debido al bajo consumo de energía, la fiabilidad y la facilidad de uso de Zigbee. En este wiki, te guiaremos a través de la conexión del XIAO ESP32C6 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 ESP32C6 actuará como un dispositivo Zigbee que puede ser controlado directamente desde el panel de control de Home Assistant.
Este tutorial destaca el uso del Zigbee SDK de Espressif (Arduino) y demuestra cómo desarrollar e integrar tus propios dispositivos Zigbee en Home Assistant.
Materiales Necesarios
Para seguir este tutorial, necesitarás los siguientes materiales:
- Home Assistant Green: Un dispositivo de hardware dedicado a Home Assistant para gestionar tu casa inteligente.
- Home Assistant Connect ZBT-1: Un coordinador Zigbee para habilitar la creación y comunicación de redes Zigbee.
- XIAO ESP32C6: Una placa de desarrollo con funcionalidad Zigbee habilitada a través del SDK de Espressif.
Home Assistant Connect ZBT-1 | XIAO ESP32C6 | Home Assistant Green |
---|---|---|
![]() | ![]() | ![]() |
Guía Paso a Paso
Los dos primeros pasos hacen referencia al tutorial oficial para el Home Assistant Connect ZBT-1, y también puedes leer su contenido tutorial a través del siguiente enlace:
Paso 1. Instalar el Connect ZBT-1 en Home Assistant Green
Conecta el Home Assistant Connect ZBT-1 al cable de extensión USB. Luego, conecta el cable de extensión a tu dispositivo Home Assistant Green.
Los puertos USB 3.0 y los discos USB 3.0 pueden causar interferencias con los protocolos de 2.4 GHz, incluidos los proporcionados por el Home Assistant Connect ZBT-1. Es importante utilizar el cable de extensión USB y colocar el Home Assistant Connect ZBT-1 lejos de posibles fuentes de interferencia.
- Navega a Configuración en la interfaz de Home Assistant.
- Ve a Dispositivos y Servicios y localiza la integración Zigbee.
- El Connect ZBT-1 ahora debería haber sido descubierto.

- Selecciona AÑADIR.
- En el cuadro de diálogo, selecciona Zigbee.

- Selecciona Enviar para completar la configuración de la integración del Connect ZBT-1.

- Tu Connect ZBT-1 ahora es un coordinador Zigbee.
Paso 2. Crear una Nueva Red Zigbee Usando Connect ZBT-1
- Navega a Configuración en la interfaz de Home Assistant.
- Ve a Dispositivos y Servicios y localiza la integración Zigbee.
- El Connect ZBT-1 aparecerá en tu integración Zigbee Home Automation. Selecciona AÑADIR.

- Para confirmar, selecciona Enviar.

- Selecciona Crear red.

- Sigue las instrucciones para inicializar el coordinador Zigbee y prepararlo para el emparejamiento con dispositivos Zigbee.

Paso 3. Flashear el XIAO ESP32C6 con el Programa de Ejemplo Zigbee
- Configurar el Arduino IDE:
- Instala la última versión de Arduino IDE y agrega soporte para el XIAO ESP32C6 incluyendo el paquete de placas de Espressif.
:::nota Si estás usando el XIAO ESP32C6 por primera vez, por favor lee el siguiente enlace del wiki para agregar correctamente la placa de desarrollo.
Introducción al XIAO ESP32C6 :::
- Cargar el Ejemplo Zigbee_On_Off_Light:
- Selecciona el modelo correcto de la placa de desarrollo: XIAO_ESP32C6.
- Abre el ejemplo
Zigbee_On_Off_Light
desde el Arduino IDE.
Recomendamos que utilices el paquete de placas más reciente para esp32-arduino para obtener los programas de ejemplo Zigbee más actualizados y estables.

En este ejemplo, utilizaremos los LED monocromáticos integrados en el XIAO ESP32C6, por lo que necesitamos hacer cambios en los pines del LED en el programa. Modifica el código para reemplazar RGB_BUILTIN
con LED_BUILTIN
para utilizar el indicador LED integrado.

- Configurar la configuración de Zigbee:
- Establece el modo Zigbee a ZIGBEE_MODE_ED (Dispositivo final).
- Ajusta el esquema de partición para Zigbee:
Navega aHerramientas -> Esquema de partición
y selecciona Zigbee 4MB con spiffs.

- Subir el programa:
- Conecta el XIAO ESP32C6 a tu computadora mediante un cable USB-C.
- Compila y sube el programa de ejemplo modificado al XIAO ESP32C6.
- Si el XIAO funciona correctamente, deberías ver el mensaje serial mostrado a continuación. Si ves que el XIAO se reinicia constantemente, verifica si la configuración de Zigbee es correcta o actualiza la versión del paquete del desarrollo de la placa.

Paso 4. Descubrir el XIAO ESP32C6 en Home Assistant
- En la interfaz de Home Assistant, navega a Configuración -> Dispositivos y Servicios.
- Selecciona la integración Zigbee (nombre: ZHA).

- Haz clic en Nabu Casa HA Connect ZBT-1.

- Dentro de la página de detalles del dispositivo Connect ZBT-1, verás la opción AGREGAR DISPOSITIVO A TRAVÉS DE ESTE DISPOSITIVO, haz clic en ella para ir a la página de búsqueda y emparejamiento de dispositivos Zigbee.

- Espera un momento, y el XIAO ESP32C6 aparecerá en la lista de dispositivos Zigbee descubiertos.

Puedes asignarle un nombre y una ubicación en esta página.
- Luego podrás encontrar este dispositivo en la página de dispositivos de ZHA y agregar su entidad al panel de control.

Paso 5. Agregar el XIAO ESP32C6 al Panel de Control
- Una vez que el XIAO ESP32C6 sea descubierto, agrégalo al panel de control de Home Assistant.
- Ahora podrás controlar el XIAO ESP32C6 (por ejemplo, encender o apagar el LED incorporado) directamente desde Home Assistant.

Conclusión
Espressif ofrece una amplia variedad de tipos de dispositivos Zigbee y un extenso SDK de Zigbee, lo que permite a los desarrolladores crear sus propios dispositivos Zigbee con facilidad. Siguiendo este tutorial, has aprendido a integrar el XIAO ESP32C6 en Home Assistant utilizando Zigbee, añadiendo un dispositivo personalizado a tu ecosistema de hogar inteligente.
Con la flexibilidad del SDK de Zigbee de Espressif, puedes empezar a crear 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 ofrecerte diferentes tipos de soporte y asegurarnos de que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.