Partiendo de que se ha instalado el sistema operativo directamente sobre el harware
HACS (Home Assistant Community Store) es la tienda de la comunidad y es necesaria tanto para instalar Matterbridge como para los dispositivos Zigbee. Antes de instalarlo hay que activar el modo avanzado en el panel de perfil poniendo el switch en ON, ya que se necesita acceso a una terminal SSH. Se puede seguir este vídeo de referencia: Instalacion del repositorio de la comunidad.
wget -O - https://get.hacs.xyz | bash -
Tras ejecutar el comando hay que reiniciar el dispositivo e ir a Ajustes → Integraciones para completar la instalación de HACS y seleccionar todas las opciones.
El vídeo de referencia puede mostrar una interfaz de HACS diferente a la actual. En versiones antiguas había que pulsar el botón "Explore & Download Repositories" dentro de la sección de integraciones de HACS. En HACS 2.x ese botón ya no existe: la interfaz está en hacs/dashboard y basta con buscar la integración directamente por nombre, hacer clic en el resultado y pulsar Download. Tras la descarga hay que reiniciar Home Assistant.
Es posible que tenga que reiniciar el dispositivo.
Para completar la instalación de HACS es necesario tener una cuenta de GitHub.
Matterbridge permite usar Home Assistant como cerebro central y controlar los dispositivos por voz desde Alexa, Google Home o Apple HomeKit. Todo funciona de forma local, sin pasar por la nube, sin abrir puertos y totalmente gratis (sin Nabu Casa). Se puede seguir este vídeo de referencia: HectorziN | Domótica y Home Assistant.
Es necesario un controlador compatible con el estándar Matter según la plataforma que se vaya a usar:
Hay que añadir el repositorio de Matterbridge a la tienda de complementos de Home Assistant y luego instalarlo.
Se recomienda activar también Mostrar en el panel lateral para acceder a Matterbridge directamente desde la barra lateral de Home Assistant.
Una vez instalado el addon, hay que abrir la interfaz de Matterbridge y añadir el plugin matterbridge-hass, que es el que permite la comunicación con Home Assistant.
Para vincular Matterbridge con Home Assistant es necesario generar un token de acceso de larga duración:
Para no exponer todos los dispositivos, se recomienda crear una etiqueta (label) llamada matterbridge y asignarla solo a las entidades que se quieran controlar por voz (luces, termostatos, persianas...).
En la configuración de Matterbridge se filtra para que solo se sincronicen las entidades que tengan esa etiqueta.
Se puede vincular directamente desde la app de Alexa sin necesidad de pasar por Google Home:
¿Por qué aparecen 2 dispositivos al emparejar? Matterbridge expone por defecto dos interruptores virtuales de control: Update Matterbridge (para actualizar Matterbridge) y Restart Matterbridge (para reiniciar Matterbridge). Si no los necesitas puedes desactivarlos desde la configuración del plugin matterbridge-hass en la interfaz de Matterbridge.
Este método es muy superior a alternativas antiguas como Emulated Hue: gracias a Matter, cada dispositivo mantiene su naturaleza real. Una persiana se reconoce como persiana (con su porcentaje), un ventilador muestra controles de velocidad, y un termostato conserva todas sus funciones.
Para la instalación de las aplicaciones necesarias se puede seguir el siguiente vídeo de referencia: Instalacion de aplicaciones necesarias.
Esta guía está elaborada usando un bridge Sonoff Zigbee y dispositivos de la misma marca. 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 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.
No todos los tipos de dispositivo son compatibles con Matter y Alexa. Los pulsadores (entidades de tipo button o event) no están soportados porque Matter solo reconoce dispositivos con un estado (encendido/apagado, porcentaje, etc.), y un pulsador únicamente dispara acciones sin tener estado propio. Los tipos compatibles son: light, switch, cover, climate, fan y algunos sensor.
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.
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.
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.
Una vez que Matterbridge ya está vinculado con Alexa, para que un nuevo dispositivo aparezca en Alexa basta con:
matterbridgeNo es necesario volver a emparejar Matterbridge ni escanear ningún código. Alexa detectará automáticamente los nuevos dispositivos expuestos por Matterbridge.