Guía Completa: Instalación de ZHA y Zigbee2MQTT en Home Assistant con SMLIGHT SLZB-07

1. Preparación: Drivers y Firmware

Antes de conectar el dispositivo a Home Assistant, es recomendable asegurarse de que tenemos los controladores necesarios y el firmware actualizado.

Instalación de Drivers (Windows)

Si utilizas Home Assistant en una máquina virtual sobre Windows, necesitarás los drivers del chip Silicon Labs CP210x.

1. Descarga los drivers desde la web oficial de Silicon Labs.
2. Descomprime el archivo y haz clic derecho sobre el archivo .inf para seleccionar Instalar.

Actualización del Firmware

SMLIGHT facilita mucho este proceso con una herramienta web:

1. Ve a SMLIGHT Flasher.
2. Conecta tu dongle y selecciona el modelo exacto en el menú izquierdo.
3. Haz clic en Update y sigue los pasos para instalar la última versión (ej. v7.4.4).

2. Configuración en Máquinas Virtuales (VirtualBox)

Si usas VirtualBox, debes "pasar" el dispositivo USB de la máquina real a la virtual:

1. Ve a Configuración > USB.
2. Haz clic en el icono de "Añadir filtro" y selecciona el dongle (aparecerá como Silicon Labs).
3. Acepta y reinicia la máquina virtual si es necesario.

3. Instalación de ZHA (Zigbee Home Automation)

ZHA es la integración nativa de Home Assistant. Es la opción más sencilla para empezar.

1. Detección automática: Al conectar el dongle, Home Assistant debería mostrar una notificación de "Nuevo dispositivo descubierto". Haz clic en Configurar.
2. Configuración manual: Si no aparece, ve a Ajustes > Dispositivos y Servicios > Añadir Integración y busca Zigbee Home Automation.
3. Selecciona el puerto serie correspondiente (normalmente /dev/ttyUSB0 o similar).
4. Elige "Mantener la configuración de red actual" para finalizar.

4. Instalación de Zigbee2MQTT (Z2M)

Para usuarios que buscan mayor compatibilidad con dispositivos específicos o una gestión externa a la base de datos de Home Assistant, Zigbee2MQTT es la opción ideal.

Importante: No puedes tener ZHA y Zigbee2MQTT activos al mismo tiempo usando el mismo dongle. Si configuraste ZHA, debes eliminarlo antes.

Requisito previo: Mosquitto Broker

Debes tener instalado el complemento Mosquitto Broker y un usuario configurado en Home Assistant.

Paso a paso para Z2M:

1. Ve a Ajustes > Complementos > Tienda de complementos.
2. Haz clic en los tres puntos (arriba a la derecha) > Repositorios.
3. Añade la URL: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
4. Busca e instala el complemento Zigbee2MQTT.

Configuración YAML de Zigbee2MQTT

Entra en la pestaña Configuración del complemento y adapta el siguiente código (cambiando tus credenciales):

mqtt:
  server: mqtt://localhost:1883
  user: tu_usuario_mqtt
  password: tu_password_mqtt
serial:
  port: /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_... # Sustituye por tu ID real
  adapter: ezsp

Nota técnica: Para el modelo SLZB-07MG24 (chip Silicon Labs), es vital añadir la línea adapter: ezsp (o ember en versiones más recientes de Z2M) para que la comunicación sea correcta.

Para encontrar tu ruta de puerto exacta, ve a Ajustes > Sistema > Hardware > Todo el hardware y busca "serial".

5. El Consejo de Oro para la Estabilidad

Aunque este modelo SLZB-07 tiene un gran aislamiento, siempre recomiendo vigilar las interferencias con el Wi-Fi de 2.4GHz. Si notas retardos, intenta cambiar el canal de tu red Zigbee (el canal 25 suele estar más libre) o, a pesar de lo dicho, usa un pequeño alargador USB si tu servidor tiene muchos componentes electrónicos cerca.

¡Y listo! Ya tienes tu red Zigbee funcionando con uno de los mejores coordinadores calidad-precio del mercado.

¿Quieres ver el proceso en vídeo? Puedes ver el tutorial paso a paso aquí: Cómo Instalar ZHA y Zigbee2MQTT en HOME ASSISTANT de mi canal HectorziN | Domótica y Home Assistant.

Espero que este borrador te sirva para el blog de HectorziN | Domótica y Home Assistant. ¡Mucho éxito con el artículo!

¿Dónde comprarlo?

Si te interesa el SMLIGHT SLZB-07MG24, aquí tienes las opciones de compra disponibles:

💡Recuerda que para tus compras en AliExpress puedes utilizar los cupones de descuento actualizados.

• SMLIGHT SLZB-07MG24 — Analizado en el vídeo: Amazon · Aliexpress