Integración domótica Yeelight, gratuita y de código abierto
Controle sus luces Wi-Fi Yeelight en local: encendido, brillo, color.
Publicado por William-De71
- Dispositivos
- Versión 1.4.1
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración le permite controlar sus luces Yeelight (bombillas, tiras LED, lámparas de mesita, plafones) desde Gladys Assistant, directamente en su red local. Sin cuenta en la nube, sin pasarela, sin servidor intermedio: Gladys habla directamente con sus luces.
Funciones
La integración se adapta a lo que sabe hacer cada luz — una luz anuncia ella misma sus capacidades, y solo se crean las funciones realmente disponibles:
| Función | Luces afectadas |
|---|---|
| Encender / apagar | Todas |
| Brillo (1 a 100 %) | Todas las luces regulables |
| Color (RGB) | Modelos de color (color, tiras, lámparas de mesita) |
| Temperatura de color | Modelos de blanco regulable y de color |
| Luz ambiental | Plafones y barras de luz con retroiluminación |
| Luz nocturna (modo luna) | Plafones |
También aporta escenas: iniciar una escena cuando una luz se desconecta o vuelve, y reproducir un efecto de luz (amanecer, atardecer, alerta, notificación, vela) desde una escena. Consulte la sección Escenas más abajo.
Los estados llegan en tiempo real
Sus luces envían ellas mismas sus cambios de estado: la integración mantiene una conexión abierta con cada luz, y Gladys recibe el nuevo valor en el momento en que cambia — también cuando usa la aplicación Yeelight, el mando o el interruptor de pared. No hay ningún intervalo de consulta que ajustar. Solo los valores que han cambiado de verdad se envían a Gladys.
Una luz apagada en el interruptor de pared
Una luz apagada en el interruptor de pared no puede avisar: simplemente se queda en silencio. Por eso, cada minuto, la integración pregunta a cada luz silenciosa si sigue ahí. Una luz que no responde aparece como Inaccesible en Gladys en uno o dos minutos. Cuando vuelve a tener corriente, la integración se reconecta a ella sola y la luz vuelve a Local — no tiene que hacer nada.
Requisitos
Versión de Gladys
La integración requiere Gladys 5.1.0 o posterior, por sus escenas. En un Gladys más antiguo, la integración ya no recibe actualizaciones y se queda en la versión 1.3.0: actualice Gladys para obtener las nuevas versiones.
Activar «Control LAN» — imprescindible
Es el paso que no hay que olvidar: por defecto, una luz Yeelight rechaza cualquier comando local. Sin esta opción, la luz no se encontrará ni se podrá controlar.
Para cada luz, en la aplicación Yeelight:
- Abra la luz.
- Vaya a Ajustes (icono arriba a la derecha).
- Active Control LAN («LAN Control», también llamado «Modo desarrollador»).
Hay que repetirlo para cada luz, una por una. Es un ajuste guardado en la propia luz.
Red
- Gladys y sus luces deben estar en la misma subred para que funcione la búsqueda automática.
- La búsqueda difunde una petición en broadcast por el puerto UDP 1982. Un broadcast nunca atraviesa un router: si sus luces están en otra VLAN u otra subred que Gladys, la búsqueda no las encontrará — es un límite de la red, no un ajuste. Alargar la duración de la búsqueda no cambia nada.
- En ese caso, añada sus luces a mano (ver más abajo): el control, en cambio, va por TCP directo y funciona perfectamente entre subredes siempre que estén enrutadas.
Configuración
1. Descubrir sus luces
Una vez activado «Control LAN», vaya a la pantalla Descubrir de la integración e inicie una búsqueda. Sus luces aparecen con su nombre (el que les dio en la aplicación Yeelight), listas para añadirse. Sin ninguna dirección IP que escribir.
2. Duración de la transición
Ajusta el fundido aplicado a cada cambio (encendido, regulación, color). El valor por defecto de 500 ms da una transición suave y natural. Ponga 0 para un cambio instantáneo.
3. Luces no encontradas por la búsqueda
Dos casos llevan hasta aquí, y el segundo es el más habitual:
- «Control LAN» no está activado en la luz (ver Requisitos);
- sus luces están en otra subred / VLAN que Gladys — la búsqueda no puede alcanzarlas por definición, pero el control funciona.
Añada entonces su dirección en Luces añadidas a mano, separadas por comas (el puerto es opcional, 55443 por defecto):
192.168.1.42, 192.168.1.43:55443
Una dirección IPv6 se escribe entre corchetes: [fe80::1] o [fe80::1]:55443. Una luz declarada aquí y encontrada también por la búsqueda aparece una sola vez, con la identidad que le da la búsqueda.
Importante: asigne a estas luces una dirección IP fija en su router. A diferencia de una luz encontrada por la búsqueda — identificada por su número de serie, que nunca cambia —, una luz añadida a mano se identifica por su dirección. Si cambia su concesión DHCP, Gladys la verá como una luz diferente.
4. Duración de la búsqueda
Tiempo durante el que la búsqueda escucha las respuestas. 5 segundos bastan en la gran mayoría de los casos; aumente este valor si su red está muy cargada y faltan algunas luces.
Acciones disponibles
- Probar la conexión: lanza una búsqueda e indica cuántas luces han respondido.
- Reconectar las luces: cierra todas las conexiones y las vuelve a abrir. Útil tras un corte de corriente o un cambio en la red.
Escenas
Activadores
- Luz Yeelight desconectada: una luz ha dejado de responder durante 30 segundos — apagada en el interruptor, un corte de luz o un problema de Wi-Fi. Se detecta en unos dos minutos. Una luz apagada y vuelta a encender en menos de 30 segundos no activa nada, como tampoco una luz que ya estaba apagada al arrancar la integración. Filtro: la luz; déjelo vacío para vigilar todas las luces. Variables: Identificador de la luz, Nombre de la luz, Dirección.
- Luz Yeelight de nuevo conectada: una luz señalada como desconectada vuelve a responder. Solo sigue a un Luz Yeelight desconectada que se haya activado. Filtro: la luz. Variables: Identificador de la luz, Nombre de la luz, Dirección, Minutos desconectada.
Solo las luces que ha añadido a Gladys pueden iniciar estas escenas.
Acciones
Yeelight: reproducir un efecto de luz — campos: la luz, el efecto y la Duración (minutos) (de 1 a 60, 15 por defecto; solo amanecer y atardecer).
| Efecto | Lo que hace la luz |
|---|---|
| Amanecer (se queda encendida) | Pasa de un naranja intenso al 1 % a un blanco neutro al 100 % durante ese tiempo; sigue encendida |
| Atardecer (termina apagada) | Pasa de un blanco cálido a un naranja intenso al 1 % durante ese tiempo, y luego se apaga |
| Alerta: destellos rojos | 10 destellos rojos (unos 5 segundos), luego vuelve a como estaba — apagada si lo estaba |
| Notificación: pulsos azules | 4 pulsos azules suaves (unos 5 segundos), luego vuelve a como estaba — apagada si lo estaba |
| Vela (hasta detenerla) | Un parpadeo ámbar que dura hasta que lo detenga o envíe otro comando a la luz |
El efecto se ejecuta en la propia luz: un amanecer de 30 minutos continúa aunque Gladys se reinicie mientras tanto. Una luz solo blanca (plafón, lámpara de escritorio) reproduce el mismo efecto en blanco: un destello blanco frío para la alerta, un parpadeo cálido para la vela. La salida Nombre de la luz está disponible para las acciones siguientes de la escena.
Yeelight: detener el efecto de luz — campo: la luz. Detiene el efecto en curso; la luz conserva su color y brillo actuales.
Un efecto nunca inicia los activadores desconectada o de nuevo conectada: cambia el color de una luz, no su conexión.
Ejemplos
Despertar con un amanecer. Activador Activador programado, a las 6:45 los días laborables. Acción Yeelight: reproducir un efecto de luz: luz «Dormitorio», efecto Amanecer (se queda encendida), duración 20. La luz empieza con un tenue brillo anaranjado y llega al blanco a plena potencia a las 7:05.
Recibir un aviso cuando una luz se apaga en la pared. Activador Luz Yeelight desconectada, luz vacía. Acción Enviar mensaje: «Nombre de la luz se ha apagado en el interruptor», insertando la variable Nombre de la luz en el mensaje. Útil para una luz que debe seguir con corriente, como la del pasillo que usan sus escenas de detección de movimiento.
Una notificación discreta. Activador Cambio de estado del dispositivo: el enchufe de la lavadora baja de 5 W. Acción Yeelight: reproducir un efecto de luz: luz «Salón», efecto Notificación: pulsos azules. Si la luz estaba apagada, se vuelve a apagar después de los pulsos.
Una vela por la noche. Una escena al atardecer reproduce Vela (hasta detenerla); otra, a la hora de dormir, ejecuta Yeelight: detener el efecto de luz y después apaga la luz.
Conviene saber
Ajustar un color en una luz apagada
Una luz Yeelight rechaza los comandos de color, temperatura y brillo mientras está apagada. La integración la enciende automáticamente antes de aplicar su ajuste: hacer clic en un color enciende la luz en ese color, que es lo que se espera.
El estado de encendido se conoce por lo que la luz ya ha comunicado: una luz ya encendida no se vuelve a encender — eso relanzaría su fundido, de forma visible.
El brillo empieza en 1 %, no en 0 %
Una luz Yeelight no tiene estado «0 %»: el cero es el apagado. Poner el brillo a 0 en Gladys apaga por tanto la luz.
El color mostrado en modo blanco
Cuando una luz está en modo blanco (temperatura de color), sigue recordando el último color usado. Gladys no lo muestra a propósito como color activo, para no enseñar un color que la luz no está mostrando.
Los plafones tienen dos luces independientes
Un plafón con retroiluminación (ceiling10, barras de luz…) expone dos luces separadas, y Gladys las nombra explícitamente:
- Main light, Main brightness, Main colour, Main colour temperature (luz principal);
- Ambient light, Ambient brightness, Ambient colour, Ambient colour temperature (luz ambiental).
Cada una se enciende y se apaga independientemente de la otra. Para controlar ambas de un solo gesto, cree una escena de Gladys que actúe sobre los dos interruptores: es la forma prevista por Gladys de agrupar varios comandos.
La temperatura de color ambiental solo aparece en los modelos cuya retroiluminación puede regular su blanco — el control cálido/frío que la aplicación Yeelight muestra junto a la rueda de color del anillo.
En una luz sin retroiluminación solo hay una luz, y las etiquetas siguen siendo sencillas (On/Off, Brightness, Colour, Colour temperature). La luz nocturna de un plafón se llama Night light. Estos nombres los fija la integración en inglés, sea cual sea el idioma de Gladys; puede renombrar cada función en Gladys.
Si su plafón enciende o apaga su anillo a la vez que la luz principal, no es cosa de Gladys: es la opción «Encendido/apagado automático con la luz principal» de la aplicación Yeelight. Desactívela para controlar cada luz por separado.
La temperatura de color
El control de temperatura sigue el degradado de Gladys: a la izquierda, una luz fría y azulada; a la derecha, una luz cálida y anaranjada. La integración convierte automáticamente este valor a los Kelvin que entiende la luz, respetando el rango real de su modelo (2700–6500 K en un plafón, 1700–6500 K en una bombilla de color).
Límites de las luces
Cada luz acepta 4 conexiones simultáneas y 60 comandos por minuto. La integración solo abre una conexión por luz y suaviza automáticamente las ráfagas de comandos, pero tenga en cuenta estos límites si también controla sus luces desde otras aplicaciones al mismo tiempo. La comprobación de una luz silenciosa cuesta un comando por minuto.
Solución de problemas
| Síntoma | Causa más probable |
|---|---|
| No se encuentra ninguna luz | «Control LAN» no está activado en la aplicación Yeelight |
| Solo se encuentra una luz de varias | La opción solo está activada en esa luz — se ajusta luz por luz |
| Una luz desaparece y luego vuelve | Corte de Wi-Fi o interruptor de pared: la integración se reconecta sola, espaciando los intentos |
| Una luz aparece como «Inaccesible» | Está apagada en el interruptor o fuera del alcance del Wi-Fi; vuelve en cuanto recupera la corriente |
| Una luz añadida a mano pasa a ser desconocida | Su dirección IP ha cambiado — asígnele una dirección fija en su router |
| Los comandos dejan de funcionar al cabo de un rato | Otro programa ocupa las 4 conexiones de la luz |
| Una luz añadida a mano se ignora | Su dirección ha cambiado, o faltan los corchetes alrededor de una dirección IPv6 |
| La escena «desconectada» no se inicia | La luz volvió en menos de 30 segundos, ya estaba apagada al arrancar la integración, o no está añadida a Gladys |
| La acción de efecto falla | La luz está inaccesible en ese momento, o su modelo no admite efectos |
Parámetros de configuración
Estos son los parámetros que Yeelight te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Esta integración se comunica con sus luces Yeelight en su red local, sin ninguna cuenta en la nube. Antes de nada: en la aplicación Yeelight, abra cada luz y active «Control LAN» (Ajustes → Control LAN). Una luz sin esta opción rechaza cualquier comando local y no se encontrará. Luego vaya a la pantalla Descubrir e inicie una búsqueda: sus luces aparecen allí, listas para añadirse. Sin ninguna dirección IP que escribir. |
| Duración de la transición (ms) | number | No | Tiempo que tarda una luz en pasar a su nuevo estado con un fundido. Ponga 0 para un cambio instantáneo. |
| Luces no encontradas por la búsqueda | section | No | Rellene el campo de abajo si la búsqueda en la red no encuentra una luz. La causa más habitual: sus luces están en otra subred o VLAN distinta de la de Gladys — el broadcast de la búsqueda no atraviesa un router, así que no puede alcanzarlas, mientras que el control sí funciona. Aumentar la duración de la búsqueda no cambia nada en ese caso. |
| Luces añadidas a mano | string | No | Una dirección por luz (192.168.1.42 o 192.168.1.42:55443), separadas por comas. Asigne a estas luces una dirección fija en su router: a diferencia de una luz encontrada por la búsqueda, una añadida a mano se identifica por su dirección, y una nueva concesión DHCP haría que Gladys la viera como una luz diferente. |
| Duración de la búsqueda (s) | number | No | Tiempo durante el que la búsqueda escucha las luces que responden en la red. Solo útil en una red muy cargada: no sirve de nada si sus luces están en otra subred. |
Cómo instalar Yeelight en Gladys
- En Gladys, abre Integraciones: Yeelight aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/william-de71/gladys-yeelight:1.4.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/William-De71/gladys-yeelight.
Yeelight requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Yeelight es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene William-De71, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación