Cómo integrar dispositivos Sonoff con Home Assistant de forma local

La integración de dispositivos inteligentes con Home Assistant es una de las principales ventajas de contar con un sistema domótico centralizado. Los dispositivos Sonoff, ampliamente utilizados por su relación calidad-precio, pueden controlarse de forma local sin necesidad de depender de servicios en la nube, mejorando significativamente la velocidad de respuesta y la privacidad.

En este artículo técnico explicaremos el proceso completo para integrar dispositivos WiFi de la marca Sonoff con Home Assistant utilizando la integración Sonoff LAN, que permite el control local a través de la red doméstica.

Requisitos previos

Antes de comenzar con la integración, es fundamental cumplir con los siguientes requisitos:

• Tener Home Assistant instalado y funcionando correctamente
• Contar con el complemento HACS (Home Assistant Community Store) instalado
• Dispositivos Sonoff previamente configurados en la aplicación eWeLink
• Credenciales de acceso a la cuenta de eWeLink (usuario y contraseña)
• Todos los dispositivos conectados a la misma red local que Home Assistant

Instalación de HACS

HACS es un complemento esencial que permite instalar integraciones desarrolladas por la comunidad que no están disponibles en el repositorio oficial de Home Assistant. Si aún no tienes HACS instalado, deberás hacerlo antes de continuar con este proceso.

La instalación de HACS es un procedimiento específico que requiere acceso al sistema de archivos de Home Assistant y la ejecución de ciertos comandos. Una vez instalado, HACS se convierte en una herramienta fundamental para expandir las capacidades de tu instalación domótica.

Instalación de la integración Sonoff LAN

Una vez que HACS está correctamente instalado, el siguiente paso es agregar la integración Sonoff LAN. El proceso varía ligeramente dependiendo de la versión de HACS que tengas instalada.

Instalación en la versión actual de HACS

Si acabas de instalar HACS o tienes la versión más reciente, la interfaz mostrará un diseño actualizado. El procedimiento es el siguiente:

• Accede a HACS desde el menú lateral de Home Assistant
• En el cuadro de búsqueda, escribe “Sonoff”
• Localiza la integración llamada “Sonoff LAN”
• Selecciona la integración y haz clic en el botón “Descargar”
• Confirma la descarga e instalación

Instalación en versiones anteriores de HACS

Si instalaste HACS hace algún tiempo y no has actualizado la interfaz, verás un diseño diferente. En este caso:

• Accede a HACS desde el menú lateral
• Dirígete a la sección “Integraciones”
• Haz clic en el botón “Explorar y descargar repositorios”
• Busca “Sonoff” en el cuadro de búsqueda
• Selecciona “Sonoff LAN” de los resultados
• En la pantalla siguiente, haz clic en “Descargar”
• Confirma la instalación

Reinicio de Home Assistant

Después de instalar cualquier integración a través de HACS, es fundamental reiniciar Home Assistant para asegurar que todos los componentes se carguen correctamente en el sistema.

Para reiniciar Home Assistant:

• Navega a “Ajustes” en el menú lateral
• Haz clic en el botón con tres puntos verticales
• Selecciona “Reiniciar Home Assistant”
• Confirma el reinicio del servidor

El proceso de reinicio puede tomar entre 30 segundos y algunos minutos, dependiendo de la configuración y el hardware donde esté instalado Home Assistant.

Configuración de la integración Sonoff LAN

Una vez que Home Assistant ha reiniciado completamente, es momento de configurar la integración con nuestros dispositivos Sonoff.

Añadir la integración

El proceso de configuración es el siguiente:

• Accede a “Ajustes” en el menú lateral
• Selecciona “Dispositivos y servicios”
• Haz clic en “Añadir integración”
• En el cuadro de búsqueda, escribe “Sonoff”
• Selecciona la integración “Sonoff LAN” que ahora aparecerá en los resultados

Autenticación con eWeLink

Al seleccionar la integración Sonoff LAN, el sistema solicitará credenciales de acceso. Es importante entender qué son estas credenciales y por qué son necesarias.

Cuando configuraste inicialmente tus dispositivos Sonoff, fue necesario utilizar la aplicación móvil eWeLink para vincularlos con tu red WiFi. Durante ese proceso, creaste una cuenta con un usuario y contraseña. Estas son exactamente las credenciales que debes introducir en este paso.

Introduce:

• Usuario de eWeLink (generalmente un correo electrónico)
• Contraseña de tu cuenta eWeLink

Una vez introducidas las credenciales correctas, la integración se autenticará y comenzará a descubrir automáticamente todos los dispositivos Sonoff asociados a tu cuenta que estén en la misma red local.

Verificación de dispositivos integrados

Después de completar la autenticación, los dispositivos Sonoff deberían aparecer automáticamente en tu instalación de Home Assistant.

Para verificar que los dispositivos se han integrado correctamente:

• Navega a “Ajustes” > “Dispositivos y servicios”
• Busca la integración Sonoff LAN en la lista
• Haz clic en ella para ver todos los dispositivos detectados

Los dispositivos aparecerán listados, posiblemente con nombres genéricos o técnicos si no los personalizaste previamente en la aplicación eWeLink.

Personalización de dispositivos

Una vez que los dispositivos están integrados, es recomendable asignarles nombres descriptivos que faciliten su identificación y uso en automatizaciones.

Para renombrar un dispositivo:

• Accede a la lista de dispositivos integrados
• Selecciona el dispositivo que deseas renombrar
• Haz clic en el nombre actual
• Introduce un nombre descriptivo (por ejemplo: “Luz Salón”, “Interruptor Dormitorio”, etc.)
• Guarda los cambios

Esta personalización no solo mejora la usabilidad, sino que también facilita la creación de automatizaciones y la integración con asistentes de voz.

Control de dispositivos

Una vez completada la integración, puedes controlar tus dispositivos Sonoff directamente desde Home Assistant. El control está disponible desde múltiples interfaces:

• Panel principal de Home Assistant
• Vista de dispositivos y servicios
• Tarjetas personalizadas en el dashboard
• Automatizaciones y scripts
• Asistentes de voz integrados

El control es instantáneo y se realiza completamente a través de la red local, sin necesidad de acceder a servidores externos.

Ventajas del control local

La integración local de dispositivos Sonoff con Home Assistant ofrece múltiples ventajas significativas frente al control mediante la nube de eWeLink:

Velocidad de respuesta

Al eliminar la necesidad de comunicarse con servidores remotos, los comandos se ejecutan prácticamente de forma instantánea. La comunicación directa entre Home Assistant y los dispositivos a través de la red local reduce la latencia de varios segundos a milisegundos.

Independencia de Internet

El control local funciona incluso si la conexión a Internet está caída. Mientras la red local esté operativa, podrás controlar todos tus dispositivos sin interrupciones, lo que aumenta significativamente la fiabilidad del sistema domótico.

Privacidad mejorada

Al no depender de servicios en la nube, los datos sobre el uso de tus dispositivos no se transmiten a servidores de terceros. Toda la información permanece dentro de tu red doméstica, mejorando la privacidad y seguridad.

Mayor estabilidad

El sistema no se ve afectado por caídas de los servidores de eWeLink, mantenimientos programados o problemas de conectividad con servicios externos. La estabilidad depende únicamente de tu infraestructura local.

Integración avanzada

Home Assistant permite crear automatizaciones complejas, integraciones con otros dispositivos de diferentes marcas y personalización completa del comportamiento de los dispositivos, algo que las aplicaciones móviles estándar no suelen ofrecer.

Consideraciones técnicas

Compatibilidad de dispositivos

La integración Sonoff LAN es compatible con la mayoría de dispositivos Sonoff que funcionan con WiFi. Sin embargo, algunos modelos más antiguos o específicos podrían tener limitaciones. Es recomendable verificar la compatibilidad en la documentación de la integración si tienes dispositivos poco comunes.

Requisitos de red

Para que la integración funcione correctamente, es fundamental que:

• Home Assistant y los dispositivos Sonoff estén en la misma red local
• El router permita la comunicación entre dispositivos (algunas configuraciones de aislamiento de cliente pueden impedirlo)
• Los dispositivos mantengan direcciones IP estables (se recomienda asignar IPs estáticas o reservas DHCP)

Mantenimiento de credenciales

Aunque el control es local, la integración utiliza las credenciales de eWeLink para el descubrimiento inicial de dispositivos. Si cambias la contraseña de tu cuenta eWeLink, deberás actualizar las credenciales en la configuración de la integración en Home Assistant.

Solución de problemas comunes

Dispositivos no detectados

Si después de configurar la integración no aparecen todos los dispositivos:

• Verifica que los dispositivos estén encendidos y conectados a la red WiFi
• Confirma que las credenciales de eWeLink sean correctas
• Reinicia los dispositivos Sonoff desconectándolos de la alimentación
• Reinicia Home Assistant nuevamente

Error de autenticación

Si recibes un error al introducir las credenciales:

• Verifica que el usuario y contraseña sean correctos
• Asegúrate de usar las credenciales de eWeLink, no de otra plataforma
• Comprueba que tu cuenta de eWeLink esté activa

Control intermitente

Si los dispositivos responden de forma irregular:

• Verifica la estabilidad de tu red WiFi
• Considera asignar IPs estáticas a los dispositivos Sonoff
• Revisa que no haya interferencias o problemas de cobertura WiFi

Próximos pasos

Una vez que tus dispositivos Sonoff están integrados con Home Assistant, las posibilidades son prácticamente ilimitadas. Puedes:

• Crear automatizaciones basadas en horarios, sensores o eventos
• Integrar los dispositivos con asistentes de voz como Google Assistant o Alexa
• Diseñar dashboards personalizados para controlar toda tu casa
• Combinar dispositivos Sonoff con otros de diferentes marcas en automatizaciones complejas
• Implementar escenas que activen múltiples dispositivos simultáneamente

La integración local de dispositivos Sonoff con Home Assistant representa un paso importante hacia un sistema domótico robusto, rápido y privado, aprovechando al máximo las capacidades de ambas plataformas.