Guía Completa para la Integración del Dispositivo SONOFF con Home Assistant

Introducción

Home Assistant es una plataforma de hogar inteligente de código abierto muy popular. Funciona en Raspberry Pi, ordenadores, dispositivos NAS, etc., unificando dispositivos de diferentes marcas y protocolos en una sola plataforma.
Dos razones principales para elegir Home Assistant:

• Operación local, soberanía de datos: Todos los datos permanecen en tu propio servidor, sin dependencia de la nube. Los dispositivos siguen funcionando incluso cuando internet está caído, y tus patrones de uso y datos de escenas permanecen privados.
  
• Ecosistema abierto, amplio soporte de protocolos: Home Assistant soporta Zigbee, Wi-Fi, Matter, MQTT, Z-Wave y prácticamente todos los principales protocolos de hogar inteligente, integrando dispositivos de diferentes marcas en una sola interfaz para crear automatizaciones conjuntas.

SONOFF ofrece una amplia gama de dispositivos: módulos de bricolaje para retrofit, interruptores de pared, termostatos, válvulas de agua, varios sensores y más. Para hacer que los dispositivos SONOFF sean accesibles para los usuarios de Home Assistant, SONOFF proporciona múltiples vías de integración para cada protocolo y tipo de dispositivo.

Este blog te guía a través de cada método de integración y te ayuda a elegir el adecuado para tus necesidades.

1. Dispositivos Zigbee

Zigbee es un protocolo de red en malla de bajo consumo. Los dispositivos Zigbee de SONOFF incluyen varios sensores (movimiento PIR, presencia humana, temperatura/humedad, etc.), interruptores/enchufes inteligentes, interruptores de pared, termostatos y válvulas de agua.

Hay tres formas de conectar dispositivos Zigbee a Home Assistant, cubriendo desde el "control local puro" hasta la "sincronización de doble plataforma".

1.1 Conexión directa del Dongle

Cómo funciona: La mayoría de los hosts de Home Assistant no tienen capacidad de radio Zigbee integrada; se necesita un Dongle Zigbee (adaptador) para enviar y recibir señales Zigbee. La serie Dongle SONOFF es un producto destacado en este ámbito.

Dispositivos compatibles: Casi todos los dispositivos SONOFF Zigbee pueden conectarse mediante un Dongle.
Método de integración:

Después de configurar el Dongle en Home Assistant mediante la integración ZHA (Zigbee Home Automation) o Zigbee2MQTT (Z2M), los dispositivos SONOFF Zigbee se detectan automáticamente y se añaden como entidades en Home Assistant, listos para automatizaciones y escenas.

• ZHA: Integrado en Home Assistant Core; configuración sencilla, adecuado para la mayoría de los usuarios
  
• Zigbee2MQTT: Funciones más completas, ecosistema comunitario más grande, soporta más tipos de dispositivos y opciones de personalización

*Si no estás seguro de qué Dongle elegir, consulta la Guía de Selección de Dongle SONOFF:

https://sonoff.tech/blogs/news/sonoff-zigbee-thread-dongle-choosing-guide

*Para pasos detallados de configuración o solución de problemas, visita el sitio web dedicado al Dongle:

https://dongle.sonoff.tech/

⚠️ Importante: Los dispositivos Zigbee añadidos vía Dongle solo aparecen en Home Assistant — no pueden controlarse desde la App eWeLink. Si necesitas gestionar dispositivos desde Home Assistant y eWeLink, consulta la opción Matter Bridge a continuación.

1.2 Sincronización Matter Bridge

Cómo funciona: Los dispositivos SONOFF ZBBridge-U (Zigbee Bridge Ultra) y NSPanel Pro tienen funcionalidad dual integrada: puerta de enlace Zigbee + Matter Bridge. Primero puedes añadir dispositivos Zigbee SONOFF a la App eWeLink, luego sincronizarlos con Home Assistant como "dispositivos Matter locales" mediante el protocolo Matter Bridge.

¿Por qué elegir Matter Bridge?

• Control en doble plataforma: Los dispositivos son gestionables tanto en la App eWeLink (control remoto, automatización de escenas) como en Home Assistant
• Comunicación local: Tras sincronizar con Home Assistant, los dispositivos funcionan como dispositivos Matter estándar — la comunicación es completamente basada en LAN, sin dependencia de la nube
• Amplio soporte de dispositivos: No solo subdispositivos Zigbee, también sincroniza dispositivos Wi-Fi en la LAN y controles remotos de escenas eWeLink-Remote
  

Ideal para:

• Usuarios que desean controlar dispositivos tanto desde Home Assistant como desde eWeLink
• Usuarios ya familiarizados con el ecosistema eWeLink que no quieren renunciar al control remoto basado en la App

1.3 Sincronización MQTT

Ideal para: Usuarios familiarizados con la integración MQTT de Home Assistant que necesitan preservar capacidades y configuraciones de dispositivos más allá de lo que define el estándar Matter.
El protocolo Matter define un conjunto estandarizado de capacidades de dispositivos (por ejemplo, encendido/apagado), pero algunos dispositivos SONOFF tienen funciones extendidas específicas del fabricante. Estas funciones pueden conservarse en el modo de conexión directa MQTT, mientras que pueden simplificarse en el modo de sincronización Matter Bridge.

Nota: La integración MQTT requiere algunos conocimientos de configuración y NSPanel Pro o ZBBridge-U.

*Para pasos detallados de configuración, consulta:

https://sonoff.tech/blogs/news/how-to-sync-zigbee-sub-devices-to-home-assistant-via-mqtt

2. Dispositivos Wi-Fi

Los dispositivos SONOFF Wi-Fi incluyen varios módulos de actualización, interruptores de pared, enchufes y más — distribuidos por toda la casa, controlando luces en diferentes habitaciones. Dependiendo de si un dispositivo soporta el protocolo Matter, existen diferentes formas de agregarlos a Home Assistant.

2.1 Dispositivos certificados Matter — Adición directa

Ideal para: Dispositivos con una insignia de certificación Matter (consulta la página del producto o el embalaje para ver la insignia Matter).

Matter es el protocolo de interoperabilidad para hogares inteligentes de próxima generación impulsado por la CSA (Connectivity Standards Alliance). Los dispositivos certificados Matter tienen una ventaja de "estandarización": las capacidades del dispositivo están definidas por el propio protocolo, por lo que agregarlos a cualquier plataforma compatible con Matter (Home Assistant, Apple Home, Google Home, etc.) no requiere controladores o complementos adicionales.

Pasos de configuración:

1. Asegúrate de que la integración Matter esté instalada en Home Assistant (agrega desde "Configuración → Dispositivos y servicios").

2. Abre la aplicación eWeLink con tu dispositivo vinculado y confirma que el dispositivo esté en línea.

3. En Home Assistant, busca y agrega un dispositivo Matter, luego escanea el código QR con la aplicación eWeLink cuando se te solicite para completar el emparejamiento.

Una vez agregado, el dispositivo aparece en Home Assistant como un dispositivo Matter estándar — todas las capacidades estándar (estado del interruptor, control de brillo, etc.) funcionan de inmediato.

*Documentación oficial de Matter para Home Assistant: 

https://www.home-assistant.io/integrations/matter

2.2 Dispositivos sin Matter — Sincronización con Matter Bridge o complemento eWeLink

Ideal para: Modelos antiguos sin soporte de firmware Matter, donde aún quieres ver y controlar dispositivos desde Home Assistant.

Estos dispositivos pueden sincronizarse con Home Assistant a través de Matter Bridge o el complemento eWeLink Smart Home. La funcionalidad de Matter Bridge se describe arriba. El complemento eWeLink Smart Home funciona descargando el complemento en Home Assistant e iniciando sesión en tu cuenta eWeLink; los dispositivos sincronizados aparecen como tarjetas de entidad en Home Assistant, soportando operaciones básicas como activar o desactivar interruptores.

Para detalles del complemento, consulta:

https://github.com/iHost-Open-Source-Project/hassio-ihost-addon

3. Dispositivos eWeLink-Remote

eWeLink-Remote es la solución de control remoto de escenas local de SONOFF diseñada para la app eWeLink. Los dispositivos típicos incluyen:

• R5: control remoto multi-escena, soporta enlazar múltiples dispositivos o escenas simultáneamente
• S-mate2: interruptor DIY, diseñado para funcionar con interruptores externos

Ahora, los dispositivos eWeLink-Remote admiten integración con Home Assistant a través de Matter Bridge: puedes usarlos como controles remotos de escenas locales dentro de Home Assistant.

Cómo funciona: usa la función Matter Bridge en ZBBridge-U o NSPanel Pro para sincronizar dispositivos eWeLink-Remote con Home Assistant, luego configura automatizaciones locales activadas por el control remoto.

 

No existe una única "respuesta correcta" para conectar dispositivos SONOFF a Home Assistant: depende de tus hábitos y prioridades de uso:

Si buscas un control local, estable y definitivo, la conexión directa con Dongle es la mejor opción;

Si quieres sinergia entre dos plataformas como Home Assistant y eWeLink, Matter Bridge proporciona una experiencia más equilibrada;

Para usuarios con algunas habilidades de bricolaje que desean conservar más funciones extendidas del dispositivo, MQTT ofrece mayor libertad;

Mientras tanto, a medida que el ecosistema Matter madura, cada vez más dispositivos Wi-Fi pueden lograr una experiencia de integración "lista para usar" gracias a la estandarización.

SONOFF seguirá apoyando el ecosistema de la comunidad de código abierto, ofreciéndote una vida inteligente más cómoda y conveniente.