Integración domótica Nanoleaf, gratuita y de código abierto
Paneles Nanoleaf en la red local: colores, blancos, efectos, gestos táctiles.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Controle sus paneles de luz Nanoleaf desde Gladys Assistant, en la red local, mediante la OpenAPI de Nanoleaf: encendido/apagado, brillo, color, temperatura de blanco, efectos y los gestos táctiles de los paneles como disparadores de escena. Sin nube, sin cuenta.
Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración se ha construido y probado con las respuestas documentadas por Nanoleaf, no con paneles reales. Indique lo que funciona y lo que no en las issues (Developed without the hardware: feedback welcome).
Esta integración no está afiliada a Nanoleaf.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Paneles con un controlador Wi-Fi que hable la OpenAPI de Nanoleaf: Light Panels (Aurora), Canvas, Shapes (hexágonos, triángulos, mini triángulos), Elements y Lines, en la misma red que Gladys.
- Los paneles configurados primero en la aplicación Nanoleaf (red Wi-Fi).
- Las bombillas y tiras Nanoleaf Essentials (Matter / Thread) no hablan la OpenAPI: añádalas a Gladys mediante Matter.
Instalación y emparejamiento
- En Gladys, abra Integraciones → Instalar desde GitHub e introduzca
https://github.com/guim31/gladys-nanoleaf(o instale Nanoleaf desde el catálogo cuando aparezca). - Abra la pestaña Configuración de la integración. Los paneles de la misma red que Gladys se encuentran automáticamente (mDNS, y SSDP para los antiguos Light Panels). Si no se encuentran los suyos, introduzca su dirección IP en Direcciones IP de los controladores Nanoleaf (varias direcciones: sepárelas con comas).
- En los paneles, mantenga pulsado el botón de encendido de 5 a 7 segundos hasta que las luces parpadeen y haga clic en Emparejar en la pestaña Configuración en los 30 segundos siguientes. El mensaje bajo el botón nombra los paneles emparejados. Para emparejar una sola dirección, escríbala en el campo Dirección IP (opcional) del botón.
- Abra la pestaña Descubrir y añada el dispositivo.
Idioma de los nombres de los dispositivos: el idioma de los nombres de las funciones de los nuevos dispositivos (francés por defecto). Gladys conserva los nombres dados al añadir el dispositivo.
El token de emparejamiento se guarda en el volumen /data de la integración,
nunca en la configuración ni en los registros.
El dispositivo
Un dispositivo por controlador (un conjunto de paneles), con estas funciones:
| Función | Lo que hace |
|---|---|
| Luz | Encendido / apagado. |
| Brillo | De 0 a 100 %. 0 apaga los paneles. |
| Color | Cualquier color (tono y saturación). No en Elements, que solo muestran blanco. |
| Temperatura de color | El blanco, en kelvin, dentro del rango del controlador (1200-6500 K en la mayoría). |
| Efecto | Los efectos de este controlador, como en la aplicación Nanoleaf. Ninguno: vuelta al color o al blanco. |
| Conectado | Solo lectura: el controlador responde. Sin corriente, los paneles también se muestran apagados. |
Un brillo, un color o un blanco también enciende los paneles, como las demás luces de Gladys. Un cambio hecho en la aplicación Nanoleaf, con los botones o por una programación de Nanoleaf aparece en Gladys en menos de un segundo. Un nuevo efecto creado en la aplicación se une a la lista Efecto en menos de un minuto.
Widget
Añada el widget Nanoleaf a un panel de control y elija los paneles en su configuración. Muestra:
- el brillo, en directo;
- Luz (encendida o apagada), Efecto (el efecto en curso, el color o el blanco) y, en los paneles táctiles, Último gesto con el número del panel;
- hasta cuatro efectos favoritos como botones (el que está en curso lleva una marca). Escriba sus nombres en Efectos favoritos, separados por comas; vacío, se muestran los tres primeros efectos de la lista;
- con tres favoritos o menos, un botón Encender / Apagar.
Disparador de escena
Gesto en un Nanoleaf: un toque o un deslizamiento en los paneles táctiles (Canvas, Shapes, Elements). Filtros, todos opcionales:
- Nanoleaf: los paneles; vacío para cualquiera;
- Gesto: Toque simple, Doble toque, Deslizar hacia arriba, Deslizar hacia abajo, Deslizar a la izquierda, Deslizar a la derecha; vacío para todos los gestos;
- Número del panel: solo para los toques (un deslizamiento cubre todo el conjunto). Toque el panel y lea su número en la línea Último gesto del widget. Los números los asigna el controlador: cambian si se reorganizan los paneles.
La escena puede usar el gesto (single_tap, double_tap, swipe_up…) y el
número del panel como variables.
Acciones de escena
- Iniciar un efecto Nanoleaf: un efecto por su nombre, tal como está escrito en la aplicación Nanoleaf (mayúsculas y minúsculas indiferentes), con un brillo opcional. El nombre del efecto iniciado está disponible para las acciones siguientes. Un nombre desconocido hace fallar la acción y lista los efectos.
- Mostrar un color en un Nanoleaf: un color de la lista, u Otro color
con el formato
#RRGGBB, durante un número de segundos (de 1 a 3600), con un brillo opcional; después los paneles vuelven a lo que mostraban antes (efecto, color o blanco, brillo, encendidos o apagados). Una orden a los paneles mientras tanto cancela la vuelta. No en Elements.
Encender, apagar, el brillo, el color, el blanco y la lista de efectos también están disponibles como las acciones de dispositivo habituales de Gladys.
Botones de configuración
- Emparejar: vea Instalación y emparejamiento.
- Buscar controladores Nanoleaf: busca de nuevo y lista los controladores emparejados (respondan o no) y los que faltan por emparejar.
Ejemplos de escenas
- Doble toque para apagar el salón: disparador Gesto en un Nanoleaf, gesto Doble toque; acción: apagar las luces del salón.
- Un panel como luz del timbre: cuando suena el timbre, Mostrar un color en un Nanoleaf, azul, 20 segundos, brillo 100 %.
- Deslizar para el ambiente de la noche: Gesto en un Nanoleaf, gesto Deslizar hacia abajo; acciones: Iniciar un efecto Nanoleaf «Northern Lights» al 30 %, y bajar las demás luces.
- Puesta de sol: a la puesta de sol, Iniciar un efecto Nanoleaf «Sundown».
Actualización y uso de la red
- Cada controlador mantiene una conexión abierta con el flujo de eventos
de la integración (
/eventsde la OpenAPI de Nanoleaf): los cambios y los gestos llegan al instante. - Cada controlador también se lee una vez por minuto (unos pocos kilobytes), para seguir la lista de efectos y detectar un controlador desaparecido.
- La red se busca cada 15 minutos (a través de Gladys), para seguir una dirección que ha cambiado.
- Todo se queda en la red local: puerto 16021 de los controladores, sin nube. La OpenAPI no publica ninguna cuota; la integración se queda muy por debajo de lo que hace la aplicación Nanoleaf.
Solución de problemas
- «Ningún Nanoleaf en modo de emparejamiento»: mantenga pulsado el botón de encendido más tiempo (de 5 a 7 segundos, hasta que las luces parpadeen) y haga clic en Emparejar enseguida: la ventana de emparejamiento dura 30 segundos.
- «No se ha encontrado ningún Nanoleaf»: compruebe que los paneles están en la misma red que Gladys (no una red de invitados) e introduzca su dirección IP (indicada en la aplicación Nanoleaf o en su router).
- «Un Nanoleaf rechaza su token de acceso»: el controlador se ha restablecido o se han borrado sus tokens. Vuelva a emparejarlo: el dispositivo conserva sus funciones y su historial.
- El dispositivo sigue en «no responde»: el controlador está sin corriente, o su dirección ha cambiado y la búsqueda no lo ha encontrado. Haga clic en Buscar controladores Nanoleaf o introduzca la nueva dirección.
- Un gesto no hace nada: solo Canvas, Shapes y Elements son táctiles; compruebe que la función táctil no está desactivada en la aplicación Nanoleaf y que el dispositivo está elegido en el disparador (o vacío).
- Más detalles en los registros de la integración con
LOG_LEVEL=debug.
Límites
- Desarrollada sin el hardware: las respuestas de los controladores proceden de la documentación de Nanoleaf.
- Los Nanoleaf Essentials (Matter / Thread), el kit 4D / Screen Mirror y el Skylight no están cubiertos.
- El modo musical Rhythm, las escenas y programaciones de la aplicación Nanoleaf, la disposición y los colores panel por panel no están disponibles.
- El toque de cada panel (flujo en tiempo real) necesita un puerto UDP que el contenedor de Gladys no puede abrir: solo están disponibles los gestos.
- Los efectos cuyo nombre empieza o termina con un espacio se excluyen de la lista.
- La vuelta después de Mostrar un color en un Nanoleaf no sobrevive a un reinicio de la integración durante la espera.
Parámetros de configuración
Estos son los parámetros que Nanoleaf te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Emparejar su Nanoleaf | section | No | Los paneles Nanoleaf de la misma red que Gladys se encuentran automáticamente. Para emparejar uno: mantenga pulsado su botón de encendido de 5 a 7 segundos hasta que las luces parpadeen y haga clic en «Emparejar» abajo en los 30 segundos siguientes. Después, añádalo desde la pestaña Descubrir. |
| Direcciones IP de los controladores Nanoleaf | string | No | Opcional, separadas por comas. Solo para los controladores que el descubrimiento automático no encuentra. |
| Idioma de los nombres de los dispositivos | select | No | Nombres dados a las funciones de los nuevos dispositivos (Luz, Brillo, Efecto…). |
Cómo instalar Nanoleaf en Gladys
- En Gladys, abre Integraciones: Nanoleaf 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/guim31/gladys-nanoleaf:1.0.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/guim31/gladys-nanoleaf.
Nanoleaf 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
Nanoleaf 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 guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación