Saltar al contenido principal

Integración domótica WiZ, gratuita y de código abierto

Integración WiZ para Gladys Assistant

Bombillas, tiras LED y enchufes WiZ en la red local: colores, blancos, escenas WiZ.

Ver en GitHubTodas las integraciones externas

Controle sus luces y enchufes inteligentes WiZ desde Gladys, a través de su red local: bombillas, bombillas de filamento, tiras LED, lámparas y enchufes vendidos con las marcas WiZ y Philips Smart LED Wi-Fi. Encendido y apagado, brillo, color, tonos de blanco y las escenas WiZ (Océano, Romance, Puesta de sol, Fiesta, Chimenea…), con un widget para el panel, un disparador y una acción de escena. Sin cuenta ni nube: Gladys habla directamente con cada dispositivo, como lo hace la aplicación WiZ en su Wi-Fi.

Desarrollada sin el hardware: se agradecen los comentarios. Esta integración se construyó y probó con respuestas reales de dispositivos WiZ grabadas por el proyecto pywizlight, y con un dispositivo simulado, no con una bombilla real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.

Lo que necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • Luces o enchufes WiZ ya configurados en la aplicación WiZ, conectados a la misma red que Gladys.
  • En la aplicación WiZ, Ajustes → Seguridad: Permitir la comunicación local (Allow local communication) activado (sin ello, los dispositivos ignoran a Gladys).
  • Nada más: ni cuenta WiZ, ni clave, ni acceso a internet.

Configuración​

  1. Instale la integración desde el catálogo de Gladys.
  2. Abra su Configuración. Nada es obligatorio; las opciones son:
    • Direcciones IP de los dispositivos WiZ: solo para los dispositivos que el descubrimiento automático no encuentra, separadas por comas (por ejemplo 192.168.1.50, 192.168.1.51). Su router muestra la dirección de cada dispositivo; la aplicación WiZ también, en los ajustes del dispositivo.
    • Intervalo de actualización: frecuencia de lectura de cada dispositivo, de 5 a 60 segundos (15 por defecto). Es el tiempo que tarda Gladys en ver un cambio hecho desde la aplicación WiZ, un mando o un interruptor de pared.
    • Idioma de los nombres de los dispositivos: inglés, francés, alemán o español (francés por defecto). Los nombres de un dispositivo, de sus funciones y de sus escenas WiZ se asignan al añadirlo.
  3. Abra la pestaña Descubrir: un dispositivo por luz o enchufe WiZ. Haga clic en Añadir, elija una habitación y guarde.
  4. ¿Falta un dispositivo? Haga clic en Buscar dispositivos WiZ en la pantalla de configuración: el mensaje bajo el botón enumera los dispositivos encontrados y los que no responden.

Gladys encuentra los dispositivos preguntando a la red «¿quién es un dispositivo WiZ?» (una difusión en el puerto UDP 38899, enviada por la propia Gladys: es el permiso que pide la instalación) y luego habla directamente con cada uno. Un dispositivo que cambia de dirección se vuelve a encontrar en 15 minutos como máximo, sin un nuevo dispositivo en Gladys: se identifica por su dirección MAC.

Los dispositivos en Gladys​

Cada luz o enchufe se convierte en un dispositivo de Gladys con el nombre de su tipo y el final de su dirección MAC, por ejemplo WiZ color 06033D, WiZ blanco regulable 5A067C, WiZ regulable 2054E3 o WiZ enchufe 9906B7. Cámbielo como quiera. Solo se publica lo que el modelo sabe hacer:

FunciónQué esDispositivos
LuzEncendido / apagadoTodas las luces
EnchufeEncendido / apagadoEnchufes
Brillo10 a 100 %; 0 apaga la luzTodas las luces
ColorEl color de una luz de colorBombillas y tiras de color
Temperatura de colorEl blanco, en kelvin, dentro del rango del modelo (2200 a 6500 K)Luces de color y de blanco regulable
Escena WiZLa escena WiZ en curso, o Ninguna; elegir una la iniciaLuces con escenas
Velocidad de la escenaRitmo de las escenas animadas, 10 a 200 % (100 es la velocidad normal)Luces con escenas
ConsumoVatios consumidos por lo que está enchufadoEnchufes con medición de consumo
  • Una luz de color ofrece las 37 escenas WiZ; una de blanco regulable las 17 escenas de blanco (Acogedor, Despertar, Hora de dormir, Blanco cálido, Luz de día, Concentración, Relajación, Luz de velas…); una bombilla de filamento las 8 que puede reproducir (Luz nocturna, Despertar, Hora de dormir, Luz de velas…). La lista sigue el idioma de la configuración.
  • Elegir un brillo, un color, un blanco o una escena también enciende la luz. Elegir Ninguna en la lista de escenas no hace nada: para salir de una escena, elija un color o un blanco.
  • Cuando una luz deja de responder, Gladys la muestra apagada y su insignia indica que es inaccesible: casi siempre se ha apagado su interruptor de pared.

Widget del panel​

Añada el widget WiZ a un panel y elija un dispositivo en su configuración. Muestra el brillo (o el consumo de un enchufe con medición), si el dispositivo está encendido, lo que muestra la luz (una escena, un blanco con su temperatura o un color) y botones:

  • hasta tres botones de escenas, elegidos en la configuración del widget (por defecto Blanco cálido, Relajación y Luz nocturna). Solo se muestran las escenas que la luz puede reproducir; la que está en curso lleva una marca;
  • un botón Encender / Apagar, que cambia el dispositivo sea cual sea el estado que mostraba el widget.

Escenas​

Disparador​

Dispositivo WiZ encendido o apagado fuera de Gladys: una luz o un enchufe WiZ se encendió o apagó sin Gladys. Filtros:

  • Dispositivo WiZ: un dispositivo, o cualquiera;
  • Encendido o apagado: encendido, apagado o ambos;
  • Desde: Aplicación WiZ, mando o programación (la aplicación WiZ, un mando WiZ, una programación o un ritmo de la aplicación, un asistente de voz), o Interruptor de pared o corte de corriente (el dispositivo dejó de responder estando encendido, o vuelve a responder y se enciende, como hacen las luces WiZ al recibir corriente).

Las variables del disparador dan el nuevo estado (on u off) y su origen (wiz o power). Un comando enviado por Gladys nunca activa este disparador.

Acción​

Iniciar una escena WiZ: enciende la luz e inicia una de sus escenas WiZ, elegida en una lista, con brillo (10 a 100 %) y velocidad (10 a 200 %) opcionales. La acción falla si la luz no puede reproducir esa escena (una escena de fiesta en una bombilla blanca, por ejemplo). Transmite el número y el nombre de la escena a las acciones siguientes.

Ideas de escenas​

  • El interruptor de pared como botón: Dispositivo WiZ encendido o apagado fuera de Gladys en la bombilla del salón, encendido, desde Interruptor de pared o corte de corriente → encender las demás lámparas de la habitación, o Iniciar una escena WiZ «Acogedor» al 40 %.
  • Despertar suave: cada día laborable a las 6:45 → Iniciar una escena WiZ «Despertar» en la bombilla del dormitorio.
  • Alerta de corte: Dispositivo WiZ encendido o apagado fuera de Gladys en el enchufe del congelador, apagado, desde Interruptor de pared o corte de corriente → enviar un mensaje «El enchufe del congelador ya no responde».
  • Velada acogedora: al atardecer → Iniciar una escena WiZ «Chimenea», brillo 60, velocidad 80.

Solución de problemas​

  • Ningún dispositivo encontrado automáticamente: compruebe que los dispositivos y Gladys están en la misma red (mismo Wi-Fi o misma VLAN; una red de invitados o una VLAN separada para objetos conectados bloquea el descubrimiento). Introduzca las direcciones IP en la configuración: funciona de una red a otra siempre que Gladys pueda alcanzarlas. Dar una dirección fija a los dispositivos en su router también ayuda.
  • Un dispositivo encontrado que nunca responde: compruebe Permitir la comunicación local en la aplicación WiZ (Ajustes → Seguridad).
  • «no responde»: el dispositivo está apagado en la pared, desenchufado o ha perdido el Wi-Fi. Vuelve solo en cuanto responde de nuevo.
  • El color en Gladys difiere un poco del elegido en la aplicación WiZ: WiZ mezcla LED de color y LED blancos; Gladys muestra el color liso más cercano.
  • La integración registra lo que encuentra y lo que no responde: abra los registros de la integración desde la interfaz de Gladys.

Límites​

  • Los cambios hechos fuera de Gladys (aplicación WiZ, mando, interruptor de pared) se ven en la siguiente lectura, dentro del intervalo de actualización. Los dispositivos WiZ también pueden enviar sus cambios al instante, pero solo a una dirección de su red, que la integración no tiene (funciona en su propio contenedor aislado): por eso Gladys los lee, con una pequeña petición local por dispositivo y por intervalo (dos para un enchufe con medición). Sin cuota ni tráfico de internet.
  • Una luz apagada en la pared se detecta tras dos lecturas sin respuesta (30 segundos con el intervalo por defecto). Un corte del Wi-Fi tiene el mismo aspecto, al igual que un dispositivo desenchufado.
  • Ventiladores de techo con luz WiZ: solo se controla la luz, no el ventilador. Las lámparas de doble cabezal son una sola luz (el reparto entre los dos cabezales no se ofrece). El Ritmo y los modos personalizados de la aplicación WiZ no se ofrecen. Los sensores de movimiento y los mandos WiZ no son dispositivos de Gladys.
  • Desarrollada sin un dispositivo WiZ real: lo que no se pudo comprobar se enumera en el README.

Esta integración no está afiliada a WiZ, Signify ni Philips.

Parámetros de configuración​

Estos son los parámetros que WiZ te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Encontrar sus dispositivos WiZsectionNoLas luces y enchufes WiZ de la misma red que Gladys se encuentran automáticamente: abra la pestaña Descubrir. Manténgalos configurados en la aplicación WiZ, con «Permitir la comunicación local» activado. Si falta alguno, introduzca su dirección IP a continuación.
Direcciones IP de los dispositivos WiZstringNoOpcional, separadas por comas. Solo para los dispositivos que el descubrimiento automático no encuentra.
Intervalo de actualizaciónselectNoFrecuencia de lectura de cada dispositivo, para seguir los cambios hechos desde la aplicación WiZ, un mando o un interruptor de pared.
Idioma de los nombres de los dispositivosselectNoNombres dados a los nuevos dispositivos, a sus funciones y a la lista de escenas WiZ (Luz, Brillo, Océano…).

Cómo instalar WiZ en Gladys​

  1. En Gladys, abre Integraciones: WiZ aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-wiz: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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-wiz.

WiZ 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​

WiZ 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en