Saltar al contenido principal

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

Integración Ariston NET para Gladys Assistant

Calderas, bombas de calor y termos Ariston, Chaffoteaux y Elco a través de la nube Ariston NET.

Ver en GitHubTodas las integraciones

Controle desde Gladys las calderas, bombas de calor y termos del grupo Ariston (Ariston, Chaffoteaux, Elco) ya conectados a la aplicación Ariston NET o Chaffoteaux: temperaturas, consignas, modos, agua caliente, averías y, cuando el aparato lo mide, consumo de gas y electricidad.

La integración pasa por la nube Ariston NET (remotethermo), como las aplicaciones oficiales: necesita una cuenta y una conexión a internet. No tiene ninguna afiliación con Ariston Group.

Desarrollada sin el hardware: sus comentarios son bienvenidos (foro de Gladys o issue de GitHub).

Requisitos​

  • Gladys 5.1.0 o posterior.
  • Un aparato ya instalado y visible en la aplicación Ariston NET (o Chaffoteaux), con la cuenta (correo y contraseña) de esa aplicación.
  • Aparatos previstos:
    • calderas y bombas de calor con termostato conectado (sistema «Galevo»): Genus One, Alteas One, Nimbus, Chaffoteaux INOA, Thision S…;
    • termos Velis Evo, Velis Lux / Lux 2, Lydos (Wi-Fi), Lydos Hybrid, Nuos Split, Andris 2.

Configuración​

En Integraciones → Ariston NET → Configuración:

CampoFunción
Correo, ContraseñaLa cuenta de la aplicación Ariston NET. La contraseña es secreta: Gladys nunca la muestra.
Idioma de los nombresIdioma de los nombres de aparatos y funciones (francés por defecto), fijado al añadirlos.
Intervalo de actualización3, 5 (por defecto), 10, 15 o 30 minutos.
Leer las averíasCódigos de avería, leídos cada 30 minutos (activado por defecto).
Leer el consumoGas y electricidad del mes pasado, leídos cada 6 horas (desactivado por defecto).

El botón Probar la conexión vuelve a iniciar sesión, lista los aparatos de la cuenta (y los no compatibles) y actualiza la pestaña Descubrimiento. Después, añada desde esa pestaña los aparatos que desee.

Aparatos​

Caldera o bomba de calor​

Un aparato por instalación, con lo que la instalación indica:

  • Modo de la instalación (selección, controlable): verano (solo agua caliente), invierno, solo calefacción, refrigeración, apagado, vacaciones… solo los modos que ofrece la instalación;
  • Consigna de agua caliente (controlable, dentro de los límites del aparato) y Temperatura del agua caliente si hay una sonda de acumulador;
  • Quemador encendido, Bomba de calor en marcha, Presión del circuito (bar), Temperatura exterior, Temperatura de impulsión;
  • Averías: «Sin averías» o la lista de códigos con su descripción;
  • consumo del mes pasado (kWh): gas y electricidad, calefacción y agua caliente, si la opción está activada y el aparato lo mide.

Zonas de calefacción​

Un aparato por zona («Caldera – Zona 1», o el nombre dado en la aplicación):

  • Temperatura medida en la habitación;
  • Consigna (controlable): la consigna de confort, redondeada al paso del aparato (a menudo 0,5 °C) y rechazada fuera de sus límites;
  • Modo (controlable): Apagado, Calefacción (manual), Refrigeración en una bomba de calor reversible, Auto (= el programa horario de la aplicación Ariston);
  • Demanda de calor: calentando, refrigerando o en espera.

Termos​

  • Encendido (controlable);
  • Temperatura del agua;
  • Consigna (controlable, de 40 °C al máximo ajustado en el aparato) — salvo en el Velis Evo, que se ajusta en número de duchas en la aplicación;
  • Modo (controlable), traducido a los modos de Gladys: iMemory = Auto, Green = Eco, Programa, Boost, Manual; en el Velis Evo, el modo Noche (horas valle) aparece como Eco; en el Nuos Split, Comfort = Manual y Fast = Boost;
  • Calentando y Duchas disponibles cuando el modelo los proporciona;
  • en los Velis Lux, Evo y modelos de la misma generación: Eco (un interruptor, la función de aprendizaje de la aplicación, junto al modo), Tiempo de calentamiento restante (minutos) y Ciclo antilegionela (activo mientras dura el ciclo);
  • Averías.

Widget​

El widget Ariston del panel muestra un aparato elegido en sus ajustes:

  • una zona: temperatura, consigna, modo, demanda de calor, modo de la instalación, averías; botones Bajar / Subir (un paso) y Programa / Manual (el modo actual lleva una marca);
  • la caldera: agua caliente, consigna, presión, quemador, averías; botones de consigna de agua caliente;
  • un termo: temperatura, consigna, duchas, modo, calentamiento, averías; botones de consigna, Boost (si el modelo lo tiene; una segunda pulsación termina el boost y vuelve al modo anterior) y encendido/apagado.

Escenas​

Disparador​

Avería Ariston detectada: un aparato indica un código de avería que no indicaba en la lectura anterior. Filtre por aparato y por código; las acciones de la escena disponen del aparato, el código, la descripción y la indicación «avería bloqueante». Una avería ya presente al iniciarse la integración no dispara nada (sin alerta en cada reinicio).

Las consignas y los modos se controlan con la acción estándar Controlar un dispositivo de Gladys.

Ideas de escenas​

  • Alerta de avería: «Avería Ariston detectada» → enviar un mensaje «Avería de la caldera {{code}}: {{description}}».
  • Salida de vacaciones: cuando la última persona sale de casa → modo de la instalación en Vacaciones y termo en Eco.
  • Horas valle: a las 22:30 → termo en Boost; a las 6:00 → vuelta a Auto.
  • Ventana abierta: sensor de apertura abierto más de 5 minutos → zona apagada; cerrada de nuevo → Auto.

Actualización y límites del servicio​

Ariston NET no tiene una API pública documentada: la integración usa la de las aplicaciones, como la integración de Home Assistant. Desde 2024, la nube responde «Requests are blocked for N seconds» (HTTP 429) a las cuentas que consultan con demasiada frecuencia, y el soporte de Ariston indica que no admite el uso de su API por programas de terceros. Por eso la integración es sobria:

  • una sola solicitud por aparato y por actualización (zonas y agua caliente incluidas), cada 5 minutos por defecto, nunca más a menudo que cada 3 minutos;
  • averías cada 30 minutos, ajustes de los termos y consumo cada 6 horas;
  • una solicitud cada vez, con al menos un segundo de separación;
  • en caso de bloqueo, ninguna solicitud hasta el final del plazo anunciado por Ariston;
  • solo se leen los aparatos añadidos a Gladys;
  • el token de sesión se guarda en /data para no volver a iniciar sesión en cada reinicio.

No use a la vez otro sistema domótico con la misma cuenta: las solicitudes se suman.

Solución de problemas​

  • «Ariston NET rechaza el correo o la contraseña»: compruébelos en la aplicación Ariston NET; una contraseña cambiada en la aplicación debe cambiarse también en Gladys.
  • «Ariston NET limita las solicitudes»: la integración espera y se reanuda sola. Si ocurre a menudo, aumente el intervalo de actualización o detenga las demás herramientas conectadas a la misma cuenta.
  • Un aparato no aparece: haga clic en Probar la conexión; el mensaje también lista los aparatos no compatibles.
  • Un valor sigue vacío: el aparato no lo envía a la nube, o aún no se ha leído (espere una actualización).
  • Una orden vuelve atrás: la nube a veces confirma antes que el aparato; la lectura siguiente muestra el valor real.
  • Registros detallados: variable de entorno LOG_LEVEL=debug en el contenedor.

Límites​

  • Desarrollada y probada sin el hardware ni una cuenta real: comportamiento verificado con respuestas reconstruidas a partir de la biblioteca de referencia.
  • Las bombas de calor Elco / Remocon del sistema «BSB» aún no son compatibles (se indican como tales).
  • Sin edición de programas desde Gladys: el programa sigue siendo el de la aplicación; el modo Auto lo sigue.
  • Sin ajuste del número de duchas del Velis Evo ni de los ajustes avanzados (antilegionela, modo noche del Lydos Hybrid, curva de calefacción).
  • El consumo es el del mes pasado tal como lo publica la nube, no un contador en tiempo real.
  • Depende de la nube Ariston NET: sin internet o durante una caída del servicio, no hay lectura ni control.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Su cuenta Ariston NETsectionNoLa cuenta de la aplicación Ariston NET (o Chaffoteaux), donde su aparato ya funciona. Ariston limita las solicitudes de una cuenta: deje unos minutos entre actualizaciones. Sin afiliación con Ariston Group.
Correo electrónicostringSí
ContraseñasecretSí
Idioma de los nombresselectNoIdioma de los nombres de aparatos y funciones, fijado al añadir un aparato a Gladys.
Intervalo de actualizaciónselectNoFrecuencia de lectura de los aparatos: una solicitud por aparato. Ariston bloquea las cuentas demasiado insistentes.
Leer las averíasbooleanNoCódigos de avería de los aparatos, leídos cada 30 minutos, con un disparador de escena.
Leer el consumobooleanNoGas y electricidad del mes pasado (calderas y bombas de calor que lo miden), leídos cada 6 horas.

Cómo instalar Ariston NET en Gladys​

  1. En Gladys, abre Integraciones: Ariston NET 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-ariston:1.1.0), 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-ariston.

Ariston NET 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​

Ariston NET 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