Skip to content
Zigbee

Zigbee2MQTT en Home Assistant

Zigbee2MQTT es un software de código abierto que permite conectar dispositivos de Internet de las cosas (IoT) basados en Zigbee a un sistema de mensajería MQTT. Zigbee es un estándar de comunicación inalámbrico que se utiliza para conectar dispositivos IoT en una red local. MQTT es un protocolo de mensajería utilizado para la comunicación entre dispositivos en una red. Hoy veremos cómo instalar y configurar Zigbee2MQTT en Home Assistant.

Zigbee2MQTT permite conectar dispositivos Zigbee a un servidor MQTT en una red local, lo que facilita la integración de estos dispositivos con otros sistemas de automatización del hogar y servicios en la nube. Al usar Zigbee2MQTT, los usuarios pueden controlar y monitorear sus dispositivos Zigbee a través de una interfaz web o aplicación móvil, y también pueden crear automatizaciones y reglas basadas en la información recibida de los dispositivos.

Logotipo de Zigbee2MQTT

Antes de empezar con la instalación, vamos a conectar el que será nuestro coordinador al equipo. Se recomienda encarecidamente no conectar el coordinador directamente a la máquina. Utilice un cable alargador para separarlo y evitar interferencias entre el coordinador y su máquina.

También es sumamente importante realizar una copia de seguridad antes de empezar.

Yo cómo coordinador voy a utilizar el Sonoff Zigbee 3.0 USB Dongle Plus.

Índice de contenido

    Material utilizado en este tutorial

    Cómo instalar Zigbee2MQTT en Home Assistant

    • Justo después de instalar el Dongle, en nuestro Home Assistant tendremos notificación de un nuevo dispositivo descubierto. Vamos a ignorar esto ya que no nos interesa.
    • Si aún no tiene un corredor MQTT; en Home Assistant, vaya a Configuración → Complementos → Tienda de complementos e instale el complemento Mosquitto Broker. En la configuración, no tendremos que tocar nada.

    También le puede interesar: Repetidor ZigBee 3.0 de LoraTap

    En este otro artículo, le explico cómo instalar y configurar el Mosquitto Broker.

    • Ahora vamos a ir a Ajustes → Personas → Usuarios y crearemos un usuario específico para utilizar con Zigbee2mqtt.
    • Vuelve a la tienda de complementos, haz clic en ⋮ → Repositorios, completa
      https://github.com/zigbee2mqtt/hassio-zigbee2mqtt y haz clic en Agregar → Cerrar.
    • El repositorio incluye dos complementos:
      • Zigbee2MQTT es la versión estable que rastrea las versiones lanzadas de Zigbee2MQTT. (recomendado para la mayoría de los usuarios)
      • Zigbee2MQTT Edge realiza un seguimiento de la rama dev de Zigbee2MQTT de modo que puede instalar la versión de borde si hay funciones o correcciones en la rama de desarrollo de Zigbee2MQTT que aún no se han publicado.
    • Haga clic en el complemento y presione Instalar y espere hasta que se instale el complemento.

    Cómo configurar Zigbee2MQTT en Home Assistant

    • Arrancar el addon de Zigbee2mqtt para que nos cree la configuración por defecto. Lo normal ahora es que no arranque y que nos dé errores.
    • Detenemos el addon.
    • Y vamos a abrir nuestro editor de código. En mi caso el Visual Studio
    • Vemos que nos ha creado una carpeta llamada Zigbee2mqtt y dentro hay un archivo de configuracion. Lo abrimos.
    • En este archivo, vamos a dejar la primera línea y a continuación copiaremos el siguiente código
    # Minimal configuration.yml example
permit_join: true
mqtt:
  server: mqtt://localhost:1883
serial:
  port: /dev/ttyUSB0
# Will run frontend on port 8080
frontend: true
    • Sugerencia: es posible hacer referencia a variables en el archivo secrets.yaml de Home Assistant (¡no en el de Zigbee2MQTT!) usando, por ejemplo, password: ‘!secret mqtt_pass’ Si no sabes cómo utilizar el archivo secrets.yaml, en este otro artículo te lo explico Archivo secrets.yaml: Uso y configuración en Home Assistant.
    • Si no conoce el puerto y solo tiene un dispositivo USB conectado a su máquina, intente /dev/ttyUSB0. De lo contrario, o si este no lo funciona, siga estos pasos para encontrarlo.
    • Vaya a Ajustes -> Sistema -> Hardware. Aquí vaya a los tres puntitos de arriba a la derecha y haga clic en Todo el hardware
    • Aquí buscamos ttyUSB0 y dentro de atributos de este buscamos DEVNAME:
    • Lo que haya dentro de DEVNAME: será el port:
    • Dale a guardar en el archivo. Ya está listo para arrancar el complemento.
    • Inicie el complemento yendo a Información y haga clic en Iniciar
    • Espere hasta que se inicie Zigbee2MQTT y presione OPEN WEB UI para verificar que Zigbee2MQTT se inició correctamente.
      • Si aparece, 502: Bad Gateway espere un poco más y actualice la página.
      • Si esto lleva demasiado tiempo (por ejemplo, más de 2 minutos), consulte la pestaña Registro para ver qué salió mal.

    Para obtener más información, consulte la documentación.

    Sígueme a YouTube

    Sígueme en Youtube - Zigbee2MQTT en Home Assistant
    Ajustes