Cómo integrar dispositivos SONOFF OpenEdge con Home Assistant mediante MQTT

• Dispositivo SONOFF compatible con OpenEdge — se conecta al bróker como cliente MQTT, publica 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 común.
• 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 de MQTT. Esta guía utiliza el SONOFF MINI-1GSP como ejemplo, pero el mismo flujo de trabajo básico puede utilizarse con otros dispositivos OpenEdge compatibles con MQTT. 

Lo que necesitarás

Instalar y configurar un bróker MQTT

Añadir la integración MQTT en Home Assistant

Paso 1: Encender el dispositivo

En el MINI-1GSP, el dispositivo entra automáticamente en el modo de emparejamiento al encenderse por primera vez. Cuando el LED muestre dos destellos cortos seguidos de uno largo, su punto de acceso AP estará 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 ordenador, 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 acceda, cree una contraseña de inicio de sesión de al menos 8 caracteres.
  Inicie sesión para acceder a la consola web de OpenEdge.

Desde la consola web, puedes gestionar funciones locales, como el control de ENCENDIDO/APAGADO, los datos históricos de energía, los temporizadores, el emparejamiento de Matter, la configuración de red, la configuración del punto de acceso y de Wi-Fi, las actualizaciones OTA y Acerca de OpenEdge.

En Configuración de conectividad, puedes configurar la conectividad con la nube , MQTT para Home Assistant, las opciones TLS y las conexiones salientes mediante WebSocket 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.  
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, normalmente el router le asigna una dirección IP local mediante DHCP. Esta dirección se muestra en la configuración de Wi-Fi y puede utilizarse posteriormente para acceder a la consola web a través de la LAN, como se describe en el Método 2 anterior.

Nota: Tiempo de espera del punto de acceso

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 utilizado para la configuración inicial deja de estar disponible.

Si el punto de acceso desaparece antes de que termines la configuración:

1. 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.
2. Si necesitas volver a usar el punto de acceso, mantén pulsado el botón del dispositivo durante 5 segundos para volver a entrar en el modo de emparejamiento.
3. 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: Activa MQTT y configura los parámetros

• Ve a Configuración de conectividad → MQTT.
• Activar MQTT.
• Configura los parámetros de MQTT como se muestra a continuación
• Cuando hayas completado la configuración, haz clic en Guardar.

• El campo Servidor debe apuntar a tu bróker MQTT. Si el bróker Mosquitto 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 pueda acceder a Home Assistant y al bróker MQTT.
• Abre Home Assistant y ve a Configuración → 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 MQTT Discovery de Home Assistant, lo que permite que Home Assistant añada automáticamente el dispositivo y cree las entidades compatibles sin necesidad de configurar manualmente temas MQTT ni YAML.

• Abre la página del dispositivo para ver los controles y las entidades disponibles. En el caso del MINI-1GSP, se incluyen funciones como:
  • Control del relé
  • Corriente
  • Voltaje
  • Potencia
  • Frecuencia
  • Datos energéticos

Después, puedes añadir estas entidades al panel de Home Assistant o utilizarlas en automatizaciones y escenas.

Dispositivos compatibles con OpenEdge

El MINI-1GSP es el primer producto SONOFF compatible con OpenEdge.
Próximamente habrá más dispositivos compatibles con OpenEdge, incluidos:

• MINI-1GP
• MINI-1GS
• MINI-1GS10

OpenEdge también se ampliará gradualmente a más categorías de productos SONOFF, entre ellas:

• Interruptores inteligentes — control local e integración más flexibles 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 después de la integración con Home Assistant, consulta la [Lista de compatibilidad de funciones de Home Assistant para dispositivos SONOFF OpenEdge].  

Conclusión

SONOFF OpenEdge hace que la integración con Home Assistant sea más sencilla, local y flexible. Mediante la Consola web integrada y la API local estandarizada de OpenEdge sobre MQTT, los dispositivos SONOFF compatibles pueden configurarse directamente desde un navegador e integrarse localmente con Home Assistant, lo que ofrece una configuración sencilla, un control local ágil y una automatización más flexible sin depender de la nube para la integración.