Esta guía documenta la configuración del coordinador SMLight SLZB-06, un coordinator Zigbee 3.0 USB + PoE que ofrece mayor rendimiento y estabilidad comparado con el bridge Sonoff.
El SLZB-06 puede conectarse de tres formas diferentes:
En esta guía configuraremos la conexión por Ethernet.
Zigbee2MQTT necesita un broker MQTT para funcionar. En HAOS se puede instalar desde la tienda de complementos.
La configuración de Mosquitto Broker y Zigbee2MQTT se ha basado en el siguiente vídeo: SMLight SLZB-06 con Zigbee2MQTT - Configuración completa.
Por defecto Mosquitto no requiere configuración compleja. En la pestaña Configuración del addon se puede ajustar:
Crea un usuario MQTT antes de configurar Zigbee2MQTT. En la pestaña Configuración del addon, añade un login en logins con usuario y contraseña (ej: zigbee2mqtt / contraseña_segura). Este usuario será usado por Zigbee2MQTT para autenticarse contra el broker. Sin autenticación, cualquiera que pueda alcanzar el puerto 1883 podría conectarse a tu broker MQTT.
Para esta instalación usaremos Zigbee2MQTT ya que ofrece más flexibilidad y mejor soporte para dispositivos.
Antes de instalar Zigbee2MQTT, asegúrate de haber creado un usuario MQTT en Mosquitto (en logins) con usuario y contraseña. Zigbee2MQTT usará esas credenciales para autenticarse. Sin autenticación, cualquiera que alcance el puerto 1883 podría conectarse a tu broker.
serial:
port: tcp://192.168.1.100:6638
adapter: ezsp
El SLZB-06 usa el chipset Silicon Labs EFR32MG21, por lo que el adaptador debe configurarse como ezsp. La IP 192.168.1.100 es un ejemplo; sustitúyela por la IP real de tu coordinador. El puerto 6638 es el puerto por defecto para la conexión TCP.
Si decides usar conexión por USB en lugar de Ethernet, cambia la configuración a port: /dev/serial/by-id/... y usa el adaptador ezsp.
Una vez configurado Zigbee2MQTT, en Ajustes → Dispositivos y servicios aparecerán dos dispositivos: el propio coordinador y el broker MQTT (Mosquitto).
ZHA es la integración nativa de Home Assistant. Para conexión por Ethernet:
192.168.1.100) y puerto 6638Para migrar los dispositivos existentes desde el bridge Sonoff al SLZB-06:
Los dispositivos Zigbee no se pueden transferir directamente entre coordinadores. Es necesario reemparejar cada dispositivo con el nuevo coordinador. Los dispositivos vinculados a Home Assistant se detectarán como nuevos.
Una de las ventajas del SLZB-06 es que es muy fácil de emparejar cualquier dispositivo Zigbee, sea de la marca que sea. El proceso es el mismo para todos los dispositivos:
Lo único en lo que hay que fijarse es en la compatibilidad del dispositivo con Zigbee2MQTT. Puedes verificarlo en la página oficial de dispositivos soportados.
Dispositivos Router: Todos o la gran mayoría de dispositivos Zigbee que están conectados a la electricidad (enchufes, luces, relés, etc.) actúan como routers. Esto significa que no solo hacen la función del dispositivo, sino que también expanden y fortalecen la red Zigbee, mejorando la cobertura y estabilidad de la red.
Esta configuración es crítica para entornos de producción (HAaaS o instalaciones locales). Permite que Zigbee2MQTT se reinicie automáticamente cuando pierde conexión con el coordinador, evitando intervención manual.
Casos de uso: Cortes de red VPN, desconexiones temporales del coordinador, cortes eléctricos, reinicios de router. Sin esta automation, Zigbee2MQTT queda en estado de error y requiere restart manual.
zigbee2mqtt en el filtrobinary_sensor.zigbee2mqtt_bridge_connection_statesensor.zigbee2mqtt_bridge_stateha addons | grep -i zigbee45df7312_zigbee2mqtt/config/automations.yaml- id: '1776900000000'
alias: Auto-restart Zigbee2MQTT
description: Reinicia Zigbee2MQTT automáticamente si pierde conexión con coordinador
triggers:
- trigger: state
entity_id: binary_sensor.zigbee2mqtt_bridge_connection_state # Usar entity del paso 1
to: 'off'
for:
seconds: 60
conditions: []
actions:
- action: system_log.write
data:
message: "Zigbee2MQTT offline detectado, reiniciando addon..."
level: warning
- action: hassio.addon_restart
data:
addon: 45df7312_zigbee2mqtt # Usar slug del paso 2
- action: persistent_notification.create
data:
title: "Zigbee2MQTT reiniciado"
message: "Conexión con coordinador perdida, addon reiniciado automáticamente"
mode: singleentity_id y addon con los valores de los pasos 1 y 2No reemplaces todo el archivo automations.yaml — solo agrega la nueva automation al final. Cada instalación tiene automations diferentes y reemplazar el archivo borraría las existentes.
Para verificar que la automation funciona correctamente:
binary_sensor.zigbee2mqtt_bridge_connection_state cambiará a offEsta automation es esencial para HAaaS ya que reduce drásticamente la necesidad de soporte manual en caso de desconexiones temporales de red, especialmente en entornos con conexión VPN remota.
Para que los dispositivos Zigbee sean visibles en Alexa hay que asignarles la etiqueta matterbridge, la misma que se configuró en Matterbridge para filtrar las entidades a sincronizar.