HectorziN - Domótica y Home Assistant
Blog de HectorziN
Curso Home Assistant

Cómo Instalar Zigbee2MQTT en Home Assistant: Guía (con Sonoff Dongle P)

Aprende a instalar Zigbee2MQTT en Home Assistant paso a paso utilizando el Sonoff Dongle P, configurando Mosquitto Broker, emparejando dispositivos y obteniendo máxima compatibilidad Zigbee.

IntermedioInstalación10 minVídeo incluidoCódigoYAML·ZigbeeMQTT

Si ya tienes tu coordinador Zigbee y has empezado a jugar con ZHA, es muy probable que hayas oído hablar de Zigbee2MQTT. ¿Por qué tantos usuarios avanzados prefieren esta opción? La respuesta es sencilla: compatibilidad total y control absoluto.

Zigbee2MQTT soporta miles de dispositivos y te permite ver detalles técnicos que otras integraciones ocultan. En este artículo, aprenderás a instalarlo paso a paso, ya sea que uses Home Assistant en una máquina virtual (como VirtualBox) o de forma nativa.

1. Requisitos Previos: El Hardware

Para que esta instalación sea un éxito, necesitas un buen "puente" entre tus dispositivos y tu servidor.

  • Coordinador Recomendado: El Sonoff Dongle P es el estándar de la industria por su estabilidad.
  • Servidor MQTT: Recuerda que, como vimos en el este capítulo, necesitas tener instalado y configurado Mosquitto Broker antes de empezar con Zigbee2MQTT.

2. Instalación en Home Assistant

El proceso se realiza a través de los Add-ons (Complementos):

  1. Ve a Ajustes > Complementos > Tienda de complementos.
  2. Añade el repositorio oficial de Zigbee2MQTT: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.
  3. Instala el complemento llamado Zigbee2MQTT.

Configuración del puerto (¡Paso Crítico!)

Si usas VirtualBox, asegúrate de haber mapeado el puerto USB del Sonoff Dongle a la máquina virtual. En la pestaña de Configuración del complemento, deberás indicar la ruta de tu dispositivo (normalmente algo como /dev/ttyUSB0).

3. Emparejando tus primeros dispositivos

Una vez que el servicio esté iniciado, entra en la "Web UI" de Zigbee2MQTT:

  1. Haz clic en "Permitir unirse" (Permit join).
  2. Pon tu sensor o relé en modo emparejamiento (normalmente dejando pulsado el botón de reset unos segundos).
  3. ¡Magia! Verás aparecer el dispositivo con su nombre técnico, imagen y todos sus atributos disponibles.

Dispositivos ideales para empezar:

4. Integración con Home Assistant

Lo mejor de Zigbee2MQTT es que, gracias al protocolo MQTT que configuramos previamente, los dispositivos aparecerán automáticamente en tu panel de Home Assistant. No tienes que hacer nada más; estarán listos para ser usados en tus automatizaciones más complejas.

Conclusión: Libertad Domótica

Instalar Zigbee2MQTT puede parecer un paso un poco más técnico, pero la recompensa es una red robusta, rápida y compatible con casi cualquier sensor que compres en el futuro. Es la diferencia entre tener gadgets conectados y tener una verdadera Casa Inteligente.

Recursos de ayuda:

¿Has tenido problemas detectando el puerto USB en Windows o VirtualBox?  ¡No olvides suscribirte al canal de HectorziN para no perderte el próximo tutorial sobre automatizaciones avanzadas!

Continúa aprendiendo