Integración domótica Danfoss Ally, gratuita y de código abierto
Cabezales Danfoss Ally y termostatos Icon: consigna, modos, ventana, pila, escenas.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.3.0
- ★ 0
Descripción
Esta integración lleva su calefacción Danfoss Ally a Gladys: cabezales termostáticos Danfoss Ally (eTRV), sensores de ambiente Danfoss Ally y termostatos de ambiente Danfoss Icon / Icon2 para suelo radiante. Usa la API oficial de Danfoss Ally con la Consumer Key y el Consumer Secret de su propia aplicación del portal de desarrolladores de Danfoss.
- Un dispositivo de Gladys por estancia: consigna, modo de calefacción, temperatura ambiente y del suelo, humedad, pila, ventana abierta, estado de calefacción, bloqueo infantil.
- Disparadores de escena (ventana abierta, pila baja, dispositivo sin conexión, fallo, modo cambiado en la app Ally…) y acciones de escena (modo En casa / Ausente para toda la casa, consigna de un modo, temperatura de estancia para un radiador cubierto, lectura inmediata).
- Dos widgets del panel: las estancias, con los botones «Modo en casa» y «Modo ausente», y la conexión.
Transporte: nube. Gladys nunca habla directamente con sus termostatos: lee y escribe en la nube de Danfoss, que transmite los cambios a la pasarela Ally. Un cambio hecho en Gladys llega al radiador, y un cambio hecho en la app Ally o en el dispositivo llega a Gladys, en pocos minutos — no al instante. Los datos de sus dispositivos salen de su casa (ya lo hacen con la app Ally).
Sin relación con Danfoss. Aún no probada con una cuenta Danfoss real: indique lo que funciona y lo que no.
Requisitos previos
- Gladys Assistant 5.3.0 o posterior.
- Una instalación Danfoss Ally configurada en la app Danfoss Ally (pasarela y dispositivos), con una cuenta abierta con una dirección de correo.
- Una cuenta en el portal de desarrolladores de Danfoss, developer.danfoss.com, creada con exactamente el mismo correo que la app Ally (mayúsculas incluidas). Si no, la API responde, pero no lista ningún dispositivo.
- En el portal: Apps → crear una aplicación, activar en ella el producto Danfoss Ally API y abrir sus claves: necesita la Consumer Key y el Consumer Secret. La API es gratuita para uso privado; Danfoss no ofrece soporte para ella.
Configuración
En Gladys, abra Integraciones → Danfoss Ally:
| Campo | Descripción |
|---|---|
| Consumer Key | La clave de su aplicación en el portal de desarrolladores. |
| Consumer Secret | Su secreto: solo se envía a Danfoss, nunca se vuelve a mostrar ni se escribe en los registros. |
| Intervalo de lectura | Cada 1, 2, 5 o 10 minutos (2 por defecto). Una sola petición lee toda la casa. |
| Umbral de pila baja (%) | Por debajo de este nivel se activa «Una pila está baja» (20 % por defecto). |
| Idioma de los textos de los dispositivos | Nombres de las funciones y mensajes del botón; automático por defecto. |
Pulse Probar la conexión: la integración lee sus dispositivos y los lista con su modelo y su número de funciones. Después abra la pestaña Descubrir y añada las estancias que quiera: no se crea nada sin usted.
Uso
Dispositivos
Cada dispositivo ofrece las funciones que su estado permite:
| Función | Tipo de Gladys | Notas |
|---|---|---|
| Consigna | Consigna de termostato, de 5 a 35 °C cada 0,5 °C | La consigna del modo actual: en modo «En casa», cambiarla cambia la temperatura de casa del programa. Un termostato con una sola consigna (primer Icon) la escribe directamente. |
| Modo de calefacción | Modo del termostato: apagado, calefacción, auto | Apagado = Pausa (antihielo), calefacción = Manual, auto = el programa (En casa / Ausente / Vacaciones). |
| Preajuste | Preset del termostato: antihielo, ausente, confort | Antihielo = Pausa, ausente = Ausente (también durante unas vacaciones), confort = En casa. Sin cambios en modo Manual. |
| Calentando | Estado de funcionamiento: inactivo o calentando | Según la apertura de válvula de un cabezal, o la salida de un termostato Icon. |
| Temperatura ambiente, temperatura del suelo | Sensor de temperatura | La temperatura del suelo solo con sonda de suelo (Icon). |
| Humedad | Sensor de humedad | Icon2 y sensores de ambiente. |
| Pila | Nivel de batería | Todos los dispositivos con pilas. |
| Ventana abierta | Sensor de apertura (solo lectura) | Detectada por el propio termostato (caída de temperatura). |
| Bloqueo infantil | Bloqueo infantil | Activado o desactivado. |
El widget Termostato del panel de Gladys funciona con la consigna. La apertura exacta de la válvula (en %) no tiene categoría en Gladys: aparece en el detalle del widget de estancias.
Tras una orden, la integración vuelve a leer ese dispositivo varias veces durante 5 minutos y mantiene mientras tanto el valor pedido, para que el panel no vuelva al valor antiguo que la nube aún devuelve un rato.
Widgets del panel
- Estancias: cada estancia con su temperatura, su consigna y su modo, y una insignia para lo que requiere atención (sin conexión, fallo, ventana abierta, pila baja, calentando con la apertura de válvula). Toque una estancia para ver su detalle (consignas de cada modo, humedad, temperatura del suelo, sensor externo…). Los botones Modo en casa y Modo ausente cambian todos los termostatos a la vez (tras una confirmación); Actualizar lee al momento. Elija las estancias en los ajustes del widget (8 como máximo).
- Danfoss Ally: el estado de la conexión a la API, los dispositivos en línea, las peticiones de la última hora, un botón Actualizar.
Escenas
Disparadores (cada uno puede limitarse a un dispositivo):
- Se abre una ventana / Se cierra una ventana.
- Una pila está baja: una vez, hasta que se cambie la pila.
- Un dispositivo se desconecta / Un dispositivo vuelve a conectarse.
- Un dispositivo indica un fallo: un fallo o un código de error, una vez por código nuevo.
- El modo cambia: en la app Ally, en el dispositivo o por su programa — nunca por la propia Gladys. Filtro por nuevo modo.
Acciones:
- Cambiar el modo de calefacción: En casa, Ausente, Pausa, Manual o Vacaciones, en un termostato o en todos (salidas: cambiados, con error).
- Ajustar la consigna de un modo: la temperatura del modo En casa, Ausente, Pausa, Manual o Vacaciones (o del actual), sin cambiar de modo.
- Enviar una temperatura de estancia: para un radiador oculto tras un cubrerradiador o una cortina, el cabezal regula con la temperatura de otro sensor. Escriba un número o una variable de escena (el valor de un sensor); «off» lo detiene. Danfoss espera un valor cada 5 a 30 minutos: un valor enviado menos de 5 minutos después del anterior se omite (salida
sent= false). - Leer los termostatos ahora.
Ejemplos:
- Cuando se abre una ventana → enviar una notificación «Ventana abierta en {{triggerEvent.data.device_name}}».
- A las 8:00 entre semana, cuando la casa está vacía → poner todos los termostatos en Ausente; al volver → En casa.
- Cada 10 minutos → leer el sensor del salón y enviar su valor como temperatura de estancia al cabezal del radiador detrás del sofá.
Transporte
El catálogo muestra la insignia nube: cada petición va a api.danfoss.com, con sus credenciales. No hay modo local: Danfoss no ofrece API local para la pasarela Ally.
Solución de problemas
- «Danfoss rechaza las credenciales»: copie de nuevo la Consumer Key y el Secret desde el portal (Apps → su aplicación) y compruebe que la API Danfoss Ally está activada para ella.
- Conectada, pero sin dispositivos: la cuenta del portal debe usar exactamente el mismo correo que la app Ally, mayúsculas incluidas. Cree si hace falta otra cuenta en el portal con la dirección correcta.
- Un cambio tarda minutos en verse: así funciona la nube de Danfoss; la integración vuelve a leer el dispositivo durante 5 minutos tras una orden. Un intervalo más corto no hace más rápidos los dispositivos.
- «Danfoss pide reducir el ritmo»: la API respondió «demasiadas peticiones» (429). La integración espacia sus lecturas y vuelve sola al ritmo normal. Prefiera un intervalo de 2 minutos o más.
- La pasarela no se ofrece: no informa nada que mostrar; «Probar la conexión» la lista como «no ofrecido».
- Informe de un problema en GitHub con su versión de Gladys, la versión de la integración y el resultado de «Probar la conexión».
Parámetros de configuración
Estos son los parámetros que Danfoss Ally te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Danfoss Ally | section | No | Cómo conectarse: 1. Configure sus termostatos en la app Danfoss Ally, con una cuenta de correo. 2. En developer.danfoss.com, cree una cuenta con exactamente el mismo correo electrónico (mayúsculas incluidas). 3. En «Apps», cree una aplicación, active en ella la «Danfoss Ally API» y copie abajo su Consumer Key y su Consumer Secret. 4. En la pestaña Descubrir, añada sus estancias. La integración pasa por la nube de Danfoss: un cambio llega a los dispositivos, y un cambio hecho en ellos llega a Gladys, en pocos minutos. |
| Consumer Key | string | Sí | La clave de su aplicación en developer.danfoss.com (Apps → su aplicación → Keys). |
| Consumer Secret | secret | Sí | El secreto de la misma aplicación. Solo se envía a Danfoss y nunca se vuelve a mostrar. |
| Intervalo de lectura | select | No | Una sola petición lee toda la casa. Danfoss no publica cuota pero frena a los clientes demasiado insistentes: 2 minutos es un buen equilibrio. |
| Umbral de pila baja (%) | number | No | El disparador de escena «Pila baja» se activa cuando una pila baja de este nivel (5 a 50). |
| Idioma de los textos de los dispositivos | select | No | Nombres de las funciones y mensajes del botón de abajo. Automático: el idioma del panel en cuanto se muestra un widget. |
Cómo instalar Danfoss Ally en Gladys
- En Gladys, abre Integraciones: Danfoss Ally 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/william-de71/gladys-danfoss-ally:0.1.0), 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/William-De71/gladys-danfoss-ally.
Danfoss Ally requiere Gladys >=5.3.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
Danfoss Ally 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 William-De71, 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