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.
