Introducción
SONOFF presenta OpenEdge, una arquitectura que prioriza el funcionamiento local para dispositivos inteligentes de nueva generación, diseñada para ofrecerte un mayor control local, una interoperabilidad más amplia y formas más flexibles de conectar tus dispositivos entre distintas plataformas y ecosistemas.
Con OpenEdge, los dispositivos SONOFF compatibles pueden comunicarse localmente mediante interfaces abiertas, como HTTP, MQTT y WebSocket.
Para los usuarios de Home Assistant, esto significa contar con más opciones para integrar sus dispositivos: pueden conectarlos localmente mediante MQTT cuando prefieran el control local y una integración flexible con el ecosistema, mientras que la conectividad en la nube sigue estando disponible cuando se adapta mejor a sus necesidades.
Cómo funciona la integración de MQTT con Home Assistant
Antes de empezar a configurar MQTT, es útil comprender cómo funciona la conexión.
La arquitectura básica es la siguiente:
Dispositivo SONOFF con OpenEdge → Bróker de MQTT → Home Assistant
- Dispositivo SONOFF con OpenEdge: se conecta al bróker como cliente MQTT, publica los estados y datos del dispositivo y recibe comandos de control.
- Bróker de MQTT: recibe y distribuye mensajes MQTT entre los clientes conectados. En las configuraciones de Home Assistant, Mosquitto es una opción habitual.
- Home Assistant: se conecta al mismo bróker mediante la integración de MQTT, recibe actualizaciones del dispositivo, envía comandos y administra el dispositivo en Home Assistant.
Configura dispositivos OpenEdge con Home Assistant mediante MQTT
Ahora configuremos la integración MQTT. Esta guía utiliza el SONOFF MINI-1GSP como ejemplo, mientras que el mismo flujo de trabajo básico puede utilizarse con otros dispositivos OpenEdge compatibles con MQTT.
Qué necesitará
- Un dispositivo SONOFF compatible con OpenEdge y con compatibilidad con MQTT.
- Home Assistant está instalado y en ejecución.
- Hay un bróker MQTT instalado y en ejecución.
- La integración MQTT se añadió y se conectó al bróker en Home Assistant.
Instalar y configurar un bróker MQTT
- Abra Home Assistant.
- Vaya a Configuración → Aplicaciones (antes denominadas complementos) → Instalar aplicación.
- Busque bróker Mosquitto y haga clic en INSTALAR.
- Una vez instalada, inicie la aplicación de bróker Mosquitto.
- Se recomienda activar Iniciar al arrancar y Watchdog, para que el bróker se inicie automáticamente con Home Assistant y pueda reiniciarse si se detiene inesperadamente.
- Si es necesario, cree un usuario dedicado de Home Assistant para dispositivos MQTT en Configuración → Personas → Usuarios.
Para obtener más información sobre cómo elegir y configurar un bróker MQTT, consulte la guía oficial de configuración de un bróker de Home Assistant.
Añadir la integración MQTT en Home Assistant
- En Home Assistant, vaya a Configuración → Dispositivos y servicios → Añadir integración.
- Busque MQTT y complete la configuración.
- Vaya a Configuración → Dispositivos y servicios → MQTT para confirmar que la integración está conectada a su bróker.
Paso 1: Encender el dispositivo
En el MINI-1GSP, el dispositivo entra automáticamente en modo de emparejamiento al encenderse por primera vez. Cuando el LED muestra dos destellos cortos seguidos de un destello largo, su punto de acceso AP está listo para la configuración.
Paso 2: Acceder a la consola web de OpenEdge
Hay dos formas de acceder a la consola web.
Método 1: Acceso mediante el punto de acceso AP — Recomendado para la primera configuración
- Abra la configuración de Wi‑Fi en su computadora de escritorio, tableta o dispositivo móvil.
- Conéctese al punto de acceso del dispositivo: SONOFF_1GSP_xxxx.
- Abra un navegador web y vaya a: http://192.168.33.1
- Se abrirá la página de inicio de sesión de la consola web. La primera vez que accedas, crea una contraseña de inicio de sesión de al menos 8 caracteres.
Inicia sesión para acceder a la consola web de OpenEdge.
Desde la consola web, puedes gestionar funciones locales, incluido el control de encendido/apagado, los datos históricos de consumo energético, los temporizadores, el emparejamiento con Matter, la configuración de red, la configuración de AP/Wi-Fi, las actualizaciones OTA y la sección «Acerca de OpenEdge».
En Configuración de conectividad, puedes configurar la conectividad con la nube , MQTT para Home Assistant, las opciones de TLS y las conexiones WebSocket salientes para plataformas de terceros.
Método 2: Acceso mediante LAN
Si el dispositivo ya está conectado a tu red local, puedes acceder directamente a la consola web sin conectarte a su punto de acceso AP.
Para el MINI-1GSP, abre un navegador en un dispositivo que pueda acceder a la misma LAN e introduce una de las siguientes opciones en el navegador:
- MINI-1GSP.local
- La dirección IP local del dispositivo.
Paso 3: Conecta el dispositivo a tu red Wi-Fi
Conecta el dispositivo a una red Wi-Fi que pueda comunicarse tanto con Home Assistant como con tu bróker MQTT, para que puedan comunicarse a través de la red local.
- Ve a Configuración de red → Configuración de Wi-Fi.
- Selecciona la red Wi-Fi a la que puedas acceder desde Home Assistant y el bróker MQTT.
- Introduce la contraseña de Wi-Fi.
- Haz clic en Guardar.
- Espera a que el dispositivo se conecte.
Una vez que el dispositivo se conecta a tu red local, el router normalmente le asigna una dirección IP local mediante DHCP. Esta dirección aparece en la configuración de Wi-Fi y puede utilizarse posteriormente para acceder por LAN a la consola web, como se describe en el Método 2 anterior.
Nota: Tiempo de espera del punto de acceso AP
El MINI-1GSP sale automáticamente del modo de emparejamiento después de aproximadamente 10 minutos. Cuando finaliza el modo de emparejamiento, el punto de acceso AP utilizado para la configuración inicial deja de estar disponible.
Si el punto de acceso AP desaparece antes de que termines la configuración:
- Si el dispositivo ya está conectado a tu red local, continúa con la configuración mediante el método de acceso LAN descrito anteriormente.
- Si necesitas volver a usar el punto de acceso AP, mantén pulsado el botón del dispositivo durante 5 segundos para volver a entrar en el modo de emparejamiento.
- Vuelve a conectarte a SONOFF_1GSP_xxxx, abre http://192.168.33.1 y continúa con la configuración.
Consejo: Mantener pulsado el botón del dispositivo durante 10 segundos realiza un restablecimiento de fábrica.
Paso 4: Activar MQTT y configurar los parámetros
- Ve a Ajustes de conectividad → MQTT.
- Activar MQTT.
- Configura los parámetros MQTT como se muestra a continuación
- Cuando hayas completado la configuración, haz clic en Guardar.
Ejemplo de configuración MQTT de la consola web del dispositivo:
|
Ajuste |
Qué introducir |
|
Servidor |
Dirección y puerto del bróker MQTT, p. ej. |
|
Nombre de usuario |
Nombre de usuario del bróker MQTT |
|
Contraseña |
Contraseña del bróker MQTT |
|
Tipo de conexión |
Selecciona la opción TLS que corresponda a tu bróker |
|
Notificaciones de estado de RPC mediante MQTT |
Actívalo o desactívalo según sea necesario |
- El campo Servidor debe apuntar a tu bróker MQTT. Si Mosquitto Broker se ejecuta en el mismo host que Home Assistant, normalmente será la dirección IP del host de Home Assistant con el puerto MQTT 1883; por ejemplo: 192.168.1.242:1883.
- Si utilizas el bróker Mosquitto oficial de Home Assistant y no has creado credenciales MQTT independientes (nombre de usuario y contraseña), puedes usar un nombre de usuario y contraseña de Home Assistant existentes.
- Si Mosquitto ya está configurado con un nombre de usuario y una contraseña, introduce el mismo nombre de usuario y contraseña en la configuración de MQTT de la consola web del dispositivo.
Paso 5: Verificar y controlar el dispositivo en Home Assistant
- Después de guardar la configuración de MQTT, vuelve a conectar tu ordenador, tableta o dispositivo móvil a la red local que puede acceder a Home Assistant y al bróker MQTT.
- Abre Home Assistant y ve a Ajustes → Dispositivos y servicios → MQTT
El dispositivo ya debería aparecer en la lista de dispositivos MQTT. Los dispositivos SONOFF compatibles con OpenEdge y MQTT publican de forma nativa la información de descubrimiento MQTT de Home Assistant, lo que permite que Home Assistant añada automáticamente el dispositivo y cree sus entidades compatibles sin necesidad de configurar manualmente los temas MQTT ni YAML.
-
Abre la página del dispositivo para consultar los controles y las entidades disponibles. En el caso del MINI-1GSP, se incluyen funciones como:
- Control del relé
- Corriente
- Voltaje
- Potencia
- Frecuencia
- Datos de energía
A continuación, puedes añadir estas entidades a tu panel de Home Assistant o utilizarlas en automatizaciones y escenas.
Dispositivos compatibles con OpenEdge
Los siguientes productos SONOFF son compatibles actualmente con OpenEdge:
Próximamente habrá más dispositivos compatibles con OpenEdge, entre ellos:
- MINI-1GS
- MINI-1GS10
- ……
OpenEdge también se expandirá gradualmente a más categorías de productos SONOFF, entre ellas:
- Interruptores inteligentes: permiten un control local más flexible y una integración mediante interfaces abiertas.
- Productos de gestión energética: procesamiento local de datos y una supervisión energética más transparente.
- Otros dispositivos inteligentes: conexión con más plataformas y ecosistemas mediante las capacidades de integración abierta de OpenEdge.
👉 Para consultar los dispositivos compatibles más recientes y las funciones disponibles tras la integración con Home Assistant, consulta la Lista de compatibilidad de funciones de Home Assistant para dispositivos SONOFF OpenEdge.
Conclusión
SONOFF OpenEdge simplifica la integración con Home Assistant y la hace más local y flexible. Mediante la Consola web integrada y la API local estandarizada de OpenEdge a través de MQTT, los dispositivos SONOFF compatibles pueden configurarse directamente desde un navegador e integrarse localmente con Home Assistant, lo que permite una configuración sencilla, un control local ágil y una automatización más flexible sin depender de la nube para la integración.
Preguntas frecuentes
P: ¿OpenEdge requiere la nube?
No necesariamente. OpenEdge está diseñado en torno a una arquitectura local, lo que permite configurar, controlar e integrar los dispositivos compatibles a través de la Consola web local y la API local estandarizada mediante la red local.
La conectividad con la nube no es necesaria para estas funciones locales, pero sigue estando disponible como mejora opcional para las funciones y los servicios que se benefician del acceso a la nube.
P: ¿Pueden los dispositivos SONOFF OpenEdge funcionar con Home Assistant cuando no hay conexión a Internet?
Sí. Para la configuración de Home Assistant con MQTT descrita en esta guía, el dispositivo SONOFF, el bróker MQTT y Home Assistant deben seguir siendo accesibles a través de la red local.
Siempre que la LAN y el bróker MQTT sigan disponibles, el dispositivo puede continuar comunicándose localmente con Home Assistant sin una conexión activa a Internet.
P: ¿Necesito la aplicación eWeLink o una cuenta de eWeLink para configurar MQTT con Home Assistant?
No. Para la integración local con MQTT descrita en esta guía, puedes acceder directamente a la Consola web de OpenEdge desde un navegador sin utilizar la aplicación eWeLink ni una cuenta de eWeLink.
Para la configuración inicial, puedes acceder a la Consola web a través del punto de acceso Wi-Fi del dispositivo. Una vez que el dispositivo se haya conectado a tu red local, también podrás acceder a él mediante la LAN usando su nombre de host local o su dirección IP.
Desde la Consola web, puedes configurar directamente la red del dispositivo y la conexión MQTT. La conectividad con la nube de eWeLink sigue estando disponible por separado si decides utilizarla.
Dejar un comentario
Todos los comentarios se revisan antes de su publicación.
Este sitio está protegido por hCaptcha y se aplican la Política de privacidad de hCaptcha y los Términos del servicio.