Esta guía documenta la configuración del coordinador Sonoff Zigbee (Zigbee Bridge). Este bridge usa la integración SonoffLAN para conectar los dispositivos Zigbee a Home Assistant.
Esta guía está elaborada usando un bridge Sonoff Zigbee. Si se utiliza un bridge de otra marca (IKEA, ConBee, Sonoff Zigbee 3.0 USB Dongle, etc.) el proceso general es el mismo, pero algunos pasos concretos como el emparejamiento del bridge o los ajustes del coordinador pueden variar ligeramente.
Desde la tienda de la comunidad (HACS) hay que instalar la integración Sonoff LAN. Es posible que sea necesario reiniciar Home Assistant tras la instalación.
Una vez instalada, hay que ir a Ajustes → Dispositivos y servicios → + Añadir integración, buscar SonoffLAN y seguir los pasos del asistente de configuración.
Para emparejar un nuevo dispositivo Zigbee con Home Assistant hay que ponerlo en modo emparejamiento. En dispositivos Sonoff esto se hace manteniendo pulsado el botón físico del dispositivo hasta que el LED parpadee rápidamente.
Una vez en modo emparejamiento:
El método para activar el modo emparejamiento puede variar según el dispositivo. Consulta el manual del dispositivo si el LED no parpadea al mantener pulsado el botón.
Si Home Assistant no detecta el dispositivo automáticamente, ve a Ajustes → Dispositivos y servicios → + Añadir integración, busca Sonoff y vuelve a introducir las credenciales de eWeLink. Esto fuerza a la integración a sincronizarse de nuevo y suele resolver el problema.
No se recomienda ejecutar acciones sobre los relés (como encender o apagar) directamente desde Home Assistant. Hacerlo puede provocar que la acción no se ejecute correctamente o que el bridge Zigbee se desconecte temporalmente de la red. Las acciones deben configurarse desde la app de vinculación.
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.
Algunos dispositivos crean más entidades de las esperadas. Home Assistant puede generar entidades de diagnóstico adicionales que no hacen nada útil. Si esto ocurre, simplemente no asignes la etiqueta matterbridge a esas entidades extra: solo ponla en las entidades que quieras controlar. Así no aparecerán en Alexa ni molestarán.