Integración domótica Gree, gratuita y de código abierto
Aires acondicionados Gree y marcas asociadas en la red local: modo, temperatura, ventilador.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Controle sus aires acondicionados Gree desde Gladys, en su red local: encendido y apagado, modo, temperatura objetivo, velocidad del ventilador, oscilación y las funciones adicionales del equipo. La integración también funciona con los equipos Gree vendidos con otras marcas y configurados en la aplicación Gree+, por ejemplo Cooper & Hunter, Trane, Innova, Proklima, Tadiran, Heiwa, Ekokai o Lessar. Incluye un widget para el panel, un disparador de escena y dos acciones de escena. Sin cuenta y sin nube: Gladys habla directamente con cada equipo, como la aplicación Gree+ en su wifi.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se escribió a partir de las descripciones publicadas del protocolo Gree y se probó con equipos simulados, no con un aire acondicionado real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues. Esta integración no está afiliada a Gree.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Aires acondicionados con un módulo wifi Gree, ya conectados a su wifi con la aplicación Gree+ (Gladys no puede hacer esta primera configuración), en la misma red que Gladys.
- Nada más: ni cuenta Gree, ni clave, ni acceso a internet. La integración se vincula sola con cada equipo, en local, y guarda la clave que cada uno le da.
Configuración
- Instale la integración desde el catálogo de Gladys.
- Abra su Configuración. Nada es obligatorio; las opciones son:
- Direcciones IP de los aires acondicionados: solo para los equipos
que el descubrimiento automático no encuentra, separadas por comas (por
ejemplo
192.168.1.60, 192.168.1.61). Su router muestra la dirección de cada equipo. Darle una dirección fija en el router es buena idea. - Intervalo de actualización: frecuencia de lectura de cada equipo, 10, 15, 30 o 60 segundos (30 por defecto). Es el tiempo que tarda Gladys en ver un cambio hecho con el mando o la aplicación Gree+.
- Pitido con las órdenes de Gladys: los equipos pitan con cada orden, como con el mando. «Silencioso» les pide que no lo hagan, cómodo en un dormitorio; algunos firmwares lo ignoran.
- Idioma de los nombres de dispositivos: inglés, francés, alemán o español (francés por defecto). Los nombres de las funciones de un dispositivo se asignan al añadirlo.
- Direcciones IP de los aires acondicionados: solo para los equipos
que el descubrimiento automático no encuentra, separadas por comas (por
ejemplo
- Abra la pestaña Descubrimiento: cada equipo encontrado aparece, con el nombre «Gree» seguido del nombre dado en la aplicación Gree+ (o del final de su dirección MAC). Añada los que desee. El botón Buscar aires acondicionados de la configuración vuelve a buscar e indica lo encontrado.
El descubrimiento pasa por el propio Gladys (la integración funciona en un contenedor aislado que no puede llegar a su red por difusión): Gladys envía la búsqueda al puerto UDP 7000, el del protocolo Gree, y transmite las respuestas. Después, la integración habla directamente con cada equipo. Cada 15 minutos se hace una nueva búsqueda, para encontrar equipos nuevos y seguir a un equipo cuya dirección ha cambiado.
Los dispositivos en Gladys
Un dispositivo por aire acondicionado, con estas funciones:
| Función | Lo que hace |
|---|---|
| Aire acondicionado | Encendido y apagado. |
| Modo | Auto, frío, calor, deshumidificación, ventilación. |
| Temperatura objetivo | De 16 a 30 °C, en grados enteros. |
| Temperatura interior | La temperatura que mide el equipo, si tiene sonda (solo lectura). |
| Velocidad del ventilador | Auto, baja, media-baja, media, media-alta, alta, más «Silencioso» y «Turbo», que tienen prioridad. |
| Oscilación vertical | Predeterminado, oscilación o una de cinco posiciones fijas. |
| Oscilación horizontal | Igual, en los equipos con lamas laterales motorizadas. |
| Luz de la pantalla | La pantalla y los pilotos de la unidad interior. |
| Ahorro de energía | El modo de ahorro de energía del equipo. |
| Antiheladas 8 °C | Mantiene la habitación a 8 °C, en modo calor (el «8 °C» del mando). |
| Modo noche | La curva nocturna del equipo: la temperatura objetivo cambia despacio durante la noche. |
| X-Fan (secado) | Deja el ventilador en marcha un rato tras apagar, para secar el intercambiador (modos frío y deshumidificación). |
| Health (ionizador) | El ionizador («Health» o «plasma frío»), en los equipos que lo tienen. |
Una función solo aparece si el equipo informa de ella: un equipo sin sonda no tiene temperatura interior, un equipo sin lamas laterales motorizadas no tiene oscilación horizontal. Si una función aparece más tarde (una sonda que responde con retraso), la pestaña Descubrimiento propone actualizar el dispositivo. Una función que el equipo anuncia sin tenerla realmente (ocurre) simplemente no tiene efecto.
Los cambios hechos con el mando o la aplicación Gree+ llegan a Gladys dentro del intervalo de actualización. Un equipo que deja de responder (corte de luz, wifi perdido) conserva sus últimos valores en Gladys, con una indicación «inalcanzable», hasta que vuelve a responder.
Widget del panel
El widget Aires acondicionados muestra en una sola tarjeta todos los equipos Gree añadidos a Gladys: para cada uno, su modo, su temperatura objetivo y la temperatura de la habitación, o «Apagado», o «No responde». Su botón Apagar todos apaga de una vez todos los equipos encendidos: al salir de casa, al acostarse. El widget no tiene ajustes.
Escenas
Disparador
Aire acondicionado cambiado fuera de Gladys: alguien ha encendido o
apagado un equipo, o cambiado su modo o su temperatura, con el mando o la
aplicación Gree+. Lo que hace el propio Gladys nunca lo activa: una escena
puede reaccionar al mando sin reaccionar a sus propias órdenes. Filtros
(todos opcionales): el aire acondicionado y el cambio: Encendido,
Apagado, Modo o temperatura cambiados. Variables disponibles para
las acciones: el cambio (turned_on, turned_off, settings), el
encendido (on, off), el modo (auto, cool, heat, dry, fan), la
temperatura objetivo y la temperatura interior en °C.
Acciones
- Encender con ajustes: enciende un aire acondicionado con un modo y, si lo desea, una temperatura objetivo (16 a 30 °C) y una velocidad del ventilador, en una sola orden, es decir, un solo pitido. Devuelve la temperatura interior, para una notificación. Las acciones habituales de Gladys sobre las funciones del dispositivo también funcionan, una orden cada una.
- Apagar todos los aires acondicionados: apaga todos los equipos Gree añadidos a Gladys que estén encendidos y respondan, incluidos los añadidos después de crear la escena. Devuelve cuántos se han apagado.
Ideas de escenas
- Salir de casa: cuando sale la última persona, «Apagar todos los aires acondicionados» y luego enviar un mensaje con el número de equipos apagados.
- Refrescar el dormitorio antes de dormir: a las 22:00 en verano, si el dormitorio supera los 26 °C, «Encender con ajustes» en el equipo del dormitorio: frío, 25 °C, ventilador silencioso.
- Alguien ha cogido el mando: con «Aire acondicionado cambiado fuera de Gladys», cambio «Encendido», mientras un sensor indica la ventana abierta: enviar el mensaje «El aire acondicionado está encendido con la ventana abierta».
Solución de problemas
- No se encuentra ningún equipo: compruebe que el equipo está conectado con la aplicación Gree+ y en la misma red que Gladys (no en una wifi de invitados) y pulse Buscar aires acondicionados. Si sigue faltando, introduzca su dirección IP en la configuración. El informe bajo el botón indica si el descubrimiento automático no está disponible.
- «rechaza la vinculación»: el equipo responde pero no da su clave. Reinícielo (desconéctelo en el diferencial un minuto) y vuelva a buscar.
- No responde: el equipo está desconectado en el diferencial, fuera del alcance de la wifi o tiene una dirección nueva. Una búsqueda lo encuentra en su nueva dirección; una dirección fija en el router evita el problema.
- Vinculado de nuevo con la aplicación Gree+: un equipo restablecido o añadido de nuevo en la aplicación recibe una clave nueva. La integración lo detecta y se vincula de nuevo sola.
- El equipo pita con cada orden: elija «Silencioso» en Pitido con las órdenes de Gladys. Algunos firmwares lo ignoran.
- Los registros: la integración solo escribe su vida (inicio, equipos
encontrados, perdidos y recuperados, errores) y una línea por orden. Más
detalle con
LOG_LEVEL=debug. Las claves de los equipos nunca aparecen en los registros.
Límites
- Desarrollada sin el hardware: el protocolo es el que usa la aplicación Gree+ en la red local, tal como lo describen proyectos de código abierto, pero la integración aún no se ha probado con un equipo real.
- La primera configuración wifi de un equipo necesita la aplicación Gree+.
- Los equipos detrás de una pasarela multi-split o VRF (un módulo wifi para varias unidades interiores) no son compatibles, ni los deshumidificadores Gree.
- Solo grados enteros, en Celsius; un equipo que muestra Fahrenheit conserva su unidad de visualización.
- La temperatura interior es la de la sonda del equipo: cerca del techo, a menudo algo más cálida que la habitación.
- Los equipos no avisan de sus cambios: Gladys los lee en cada intervalo de actualización, así que un cambio hecho con el mando aparece en ese plazo.
- Peticiones: un breve intercambio UDP por equipo en cada actualización, nada en internet; no hay cuota.
- Las claves de los equipos se guardan en el volumen de datos de la
integración (
/data/gree-state.json), legible solo por ella.
Parámetros de configuración
Estos son los parámetros que Gree te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Encontrar sus aires acondicionados | section | No | Los aires acondicionados Gree (y Cooper & Hunter, Trane, Ekokai… configurados en la aplicación Gree+) de la misma red que Gladys se encuentran automáticamente: abra la pestaña Descubrimiento. Si falta alguno, introduzca su dirección IP a continuación. |
| Direcciones IP de los aires acondicionados | string | No | Opcional, separadas por comas. Solo para los equipos que el descubrimiento automático no encuentra. |
| Intervalo de actualización | select | No | Frecuencia de lectura de cada aire acondicionado, para seguir los cambios hechos con su mando o la aplicación Gree+. |
| Pitido con las órdenes de Gladys | select | No | Los equipos pitan con cada orden. «Silencioso» les pide que no lo hagan, para los dormitorios; algunos firmwares lo ignoran. |
| Idioma de los nombres de dispositivos | select | No | Nombres de las funciones de los nuevos dispositivos (Modo, Velocidad del ventilador, Luz de la pantalla…). |
Cómo instalar Gree en Gladys
- En Gladys, abre Integraciones: Gree 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-gree: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-gree.
Gree 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
Gree 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