Integración domótica Winix, gratuita y de código abierto
Purificadores de aire Winix: encendido, modo, velocidad, Plasmawave, calidad del aire y filtro.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Controle sus purificadores de aire Winix conectados (C545, C610, AM90, T810, 5500-2 Wi-Fi, Tower…) desde Gladys: encendido, modo, velocidad del ventilador, Plasmawave, y siga la calidad del aire, las partículas PM2.5 cuando el modelo las mide, la luz ambiental y el desgaste del filtro.
La integración pasa por la nube de Winix, la de la aplicación Winix Smart: necesita una conexión a Internet y una cuenta Winix.
Desarrollada sin el hardware: los intercambios con la nube de Winix siguen los proyectos libres que los describieron y sus respuestas reales, pero la integración aún no se ha probado con un purificador real. Sus comentarios son bienvenidos, en el foro de Gladys o en las issues del repositorio de GitHub.
Esta integración no está afiliada a Winix: es un proyecto comunitario, ni aprobado ni respaldado por Winix.
Requisitos
- Gladys 5.1.0 o posterior.
- Un purificador Winix Wi-Fi ya instalado en la aplicación Winix Smart (la aplicación lo conecta al Wi-Fi; la integración no).
- La dirección de correo y la contraseña con las que inicia sesión en la aplicación Winix Smart.
- Los deshumidificadores y aires acondicionados Winix no son compatibles: se ignoran.
Configuración
- Instale la integración: Integraciones → Instalar desde GitHub, o desde el catálogo.
- En la pestaña Configuración, introduzca la dirección de correo y la contraseña de la cuenta Winix.
- Elija el intervalo de actualización (2 minutos por defecto, de 1 a 5) y el idioma de los nombres de funciones (francés por defecto).
- Guarde: el estado de la conexión aparece arriba de la página. Sus purificadores aparecen en la pestaña Descubrir; añádalos.
Importante: la aplicación del móvil. Winix solo acepta una sesión móvil por cuenta. El primer inicio de sesión de Gladys puede cerrar la sesión de la aplicación Winix de su móvil: simplemente vuelva a entrar en la aplicación. La integración solo abre una sesión para listar sus purificadores (primer arranque, nueva búsqueda en Descubrir); la lectura y los comandos no la necesitan, así que sigue funcionando cuando el móvil recupera la sesión.
Los dispositivos
Un dispositivo por purificador, con el nombre de la aplicación Winix:
| Función | Tipo | Qué hace |
|---|---|---|
| Encendido | interruptor, controlable | enciende o apaga el purificador |
| Modo | lista, controlable | Auto, Manual o Sueño |
| Velocidad del ventilador | nivel 0 a 4, controlable | 0 sueño, 1 baja, 2 media, 3 alta, 4 turbo (5 Super Clean: Tower Prime) |
| Plasmawave | interruptor, controlable | activa o desactiva Plasmawave |
| Contaminación del aire | nivel de riesgo 0 a 3 | el anillo de color de Winix: 0 buena, 1 regular, 2 mala, 3 muy mala |
| PM2.5 | µg/m³ | solo en los modelos con ese sensor |
| Luz ambiental | valor bruto | la lectura del sensor de luz (sin unidad, Winix no la da) |
| Vida útil del filtro | % | lo que queda del filtro, 0 % cuando toca cambiarlo |
| Horas de filtro restantes | horas | horas de uso restantes antes del cambio |
| En línea | sí / no | la nube de Winix tiene noticias del purificador |
- Elegir una velocidad pasa el purificador a modo manual, como en la aplicación. En modo Auto, la velocidad mostrada es la que eligió el aparato.
- Elegir un modo o una velocidad enciende el purificador si estaba apagado.
- La vida útil del filtro viene del contador de horas del purificador y de la duración prevista para el modelo (6480 h, es decir 9 meses, para la mayoría). Debería volver al 100 % cuando el contador del filtro se pone a cero en el aparato tras un cambio (por confirmar con hardware real).
- Los sensores (PM2.5, luz) se detectan en la primera lectura. Si un sensor aparece más tarde, la pestaña Descubrir propone Actualizar.
Widget
El widget Purificador Winix del panel muestra un purificador elegido en sus ajustes: PM2.5 y filtro en directo, modo, calidad del aire y horas de filtro, y cuatro botones Auto, Manual, Sueño y Apagar (un botón Encender cuando está apagado). El modo actual lleva una marca.
Desencadenantes y acciones de escena
La integración no añade desencadenantes ni acciones de escena: todo pasa por las funciones del dispositivo, que las escenas de Gladys ya saben leer y controlar. Un «filtro por cambiar» es el umbral Vida útil del filtro ≤ 5 % de una escena, que se activa una sola vez al cruzarlo; un desencadenante aparte lo repetiría.
Ejemplos de escenas
- Noche tranquila: a las 22:30, poner el Modo del purificador del dormitorio en Sueño; a las 7:00, volver a Auto.
- Aire contaminado: cuando la Contaminación del aire del salón llegue a 2 o más (o las PM2.5 pasen de 25 µg/m³), poner la Velocidad del ventilador en 4 y enviar un mensaje; volver a Auto cuando baje a 0.
- Filtro: cuando la Vida útil del filtro baje del 5 %, enviar «Pedir un filtro para el purificador».
- Casa vacía: cuando todos se hayan ido, apagar los purificadores; volver a encenderlos en Auto cuando llegue el primero.
Actualización y condiciones de la nube de Winix
- Cada purificador añadido a Gladys se lee cada 2 minutos por defecto (de 1 a 5 según la configuración), uno tras otro. Solo se envían a Gladys los valores que cambian, con un recordatorio cada 6 h para los que no se mueven.
- Winix no publica ni API ni cuota. La nube rechaza una ráfaga de peticiones durante un minuto aproximadamente: la integración espera entonces un minuto antes de seguir. Evite el intervalo de un minuto si tiene muchos purificadores.
- Tras un comando, el purificador se vuelve a leer 5 segundos después para mostrar lo que hizo realmente.
- La cuenta solo se usa en el primer arranque y en cada búsqueda en
Descubrir; la sesión (token de actualización, identidad) y la lista de
purificadores se guardan en
/data.
Datos y privacidad
- La contraseña se queda en la configuración de Gladys; solo se envía al servicio de inicio de sesión de Winix (AWS Cognito), y nunca en claro: el inicio de sesión usa el protocolo SRP.
/data/winix-session.jsonguarda el token de actualización, la identidad de la cuenta y la lista de purificadores, legibles solo por el contenedor.- Ningún token, contraseña ni identidad aparece en los registros.
Solución de problemas
- «Winix rechazó la dirección de correo o la contraseña»: compruébelas iniciando sesión en la aplicación Winix y vuelva a guardarlas. La integración no reintenta sola con las mismas credenciales, para no bloquear la cuenta.
- La aplicación del móvil me cierra la sesión: es la sesión única de Winix (vea Configuración). Vuelva a entrar en la aplicación; Gladys sigue leyendo y controlando los purificadores.
- «La nube de Winix no responde»: un corte de Internet o de Winix. La integración reintenta en cada ciclo y lo indica una sola vez en los registros.
- Un purificador está «desconectado»: está desenchufado o perdió el Wi-Fi. Compruébelo en la aplicación Winix.
- Un purificador nuevo no aparece: inicie una búsqueda en la pestaña Descubrir.
- Más detalles: ponga
LOG_LEVEL=debugen los registros de la integración.
Limitaciones
- Depende de la nube de Winix y de Internet: no hay control local.
- Aún no probada con hardware real; los códigos y respuestas vienen de los proyectos libres citados en el README.
- Una sola sesión móvil por cuenta Winix (vea Configuración).
- Solo purificadores de aire: ni deshumidificadores ni aires acondicionados Winix.
- Sin bloqueo infantil, brillo de la pantalla ni temporizador: los comandos son encendido, modo, velocidad y Plasmawave.
- La calidad del aire es el indicador de Winix de 3 o 4 niveles, no un índice ICA; la luz ambiental es un valor bruto.
- Los nombres de las funciones se fijan al añadir el dispositivo: cambiar el idioma después no los renombra.
Parámetros de configuración
Estos son los parámetros que Winix te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Winix | section | No | La cuenta de la aplicación Winix Smart, donde sus purificadores ya están instalados. Iniciar sesión aquí puede cerrar una vez la sesión de la aplicación del móvil: vuelva a entrar, la integración sigue funcionando. |
| Correo electrónico | string | Sí | La dirección de correo con la que inicia sesión en la aplicación Winix Smart. |
| Contraseña | secret | Sí | La contraseña de la cuenta Winix. Se queda en Gladys y solo se envía al servicio de inicio de sesión de Winix. |
| Intervalo de actualización (minutos) | number | No | Frecuencia de lectura de cada purificador en la nube de Winix, de 1 a 5 minutos. |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones cuando se añade un purificador a Gladys, y textos de la integración. |
Cómo instalar Winix en Gladys
- En Gladys, abre Integraciones: Winix 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-winix: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-winix.
Winix 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
Winix 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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación