Cursos Home Assistant / febrero 14, 2025

Añadir un dispositivo nuevo en Zigbee2MQTT a través de Home Assistant

Zigbee2MQTT es una de las mejores soluciones para integrar dispositivos Zigbee en Home Assistant sin depender de hubs propietarios.

Don T3rr0rZ0n3

2 minutos

Zigbee2MQTT es una de las mejores soluciones para integrar dispositivos Zigbee en Home Assistant sin depender de hubs propietarios. Permite conectar una amplia variedad de dispositivos de diferentes fabricantes y controlarlos de manera unificada.

En este tutorial, aprenderás a añadir un nuevo dispositivo Zigbee a tu red mediante Zigbee2MQTT.

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

  • Tener Home Assistant instalado y funcionando.
  • Disponer de Zigbee2MQTT instalado y configurado.
  • Contar con un coordinador Zigbee (como un dongle CC2652 o Sonoff Zigbee 3.0 USB Dongle Plus).
  • Tener un dispositivo Zigbee compatible que desees agregar.

Habilitar el emparejamiento en Zigbee2MQTT

Para añadir un dispositivo nuevo, es necesario habilitar el emparejamiento en Zigbee2MQTT. Existen dos formas de hacerlo:

Desde la interfaz web de Zigbee2MQTT

Accede a la interfaz de Zigbee2MQTT desde Home Assistant > Configuración > Complementos > Zigbee2MQTT > Abrir interfaz web.

En la página principal, dirígete a la sección Permitir unirse desde (Todos).

En el momento que hagas clic en el botón, nuestro hub empezará a buscar dispositivos. Por defecto se activa durante 4 minutos y luego se desactiva sólo.

Desde MQTT Explorer o la terminal

Si prefieres usar MQTT, puedes enviar el siguiente comando para habilitar el emparejamiento por 60 segundos:

{
  "permit_join": true
}

Este comando se publica en el tema:

zigbee2mqtt/bridge/request/permit_join

Poner el dispositivo en modo emparejamiento

Cada dispositivo Zigbee tiene su propio método para entrar en modo emparejamiento. En la mayoría de los casos, esto implica mantener presionado un botón de reinicio durante varios segundos hasta que un LED parpadee.

Algunos ejemplos de cómo activar el emparejamiento en dispositivos comunes:

  • Bombillas Zigbee: Enciende y apaga 5 veces rápidamente.
  • Sensores Aqara: Mantén presionado el botón lateral hasta que el LED parpadee.
  • Interruptores Tuya: Mantén pulsado el botón principal hasta que el LED parpadee rápidamente.

En el momento en que pongas el dispositivo en modo emparejamiento, en la interfaz web de Zigbee2MQTT, verás abajo a la derecha que se ha detectado un dispositivo nuevo:

Normalmente el nuevo dispositivo estará al final del listado que aparece en la pestaña Dispositivos.

Si hacemos clic sobre el nombre del dispositivo y vamos a la pestaña Expone podremos observar todos los sensores que este dispositivo tiene disponible.

Conclusión

Añadir un dispositivo en Zigbee2MQTT es un proceso sencillo si sigues los pasos adecuados. Esta integración permite una gran flexibilidad y control sobre los dispositivos Zigbee en Home Assistant, sin depender de ecosistemas cerrados.

Si tienes dudas o problemas, revisa los logs de Zigbee2MQTT o consulta la documentación oficial en https://www.zigbee2mqtt.io/.

Más sobre ./voidNull

Haz que cada palabra cuente: tu donación nos inspira a seguir creando contenido. Accede al apartado de Donación para hacer tu aportación