Intégration domotique Danfoss Ally, gratuite et open source
Têtes Danfoss Ally et thermostats Icon : consigne, modes, fenêtre, pile, scènes.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration amène votre chauffage Danfoss Ally dans Gladys : têtes thermostatiques Danfoss Ally (eTRV), capteurs d’ambiance Danfoss Ally et thermostats d’ambiance Danfoss Icon / Icon2 pour le plancher chauffant. Elle utilise l’API officielle Danfoss Ally avec la Consumer Key et le Consumer Secret de votre propre application du portail développeur Danfoss.
- Un appareil Gladys par pièce : consigne, mode de chauffage, température ambiante et du sol, humidité, pile, fenêtre ouverte, chauffe en cours, sécurité enfant.
- Des déclencheurs de scène (fenêtre ouverte, pile faible, appareil hors ligne, défaut, mode changé dans l’application Ally…) et des actions de scène (mode Maison / Absent pour toute la maison, consigne d’un mode, température de pièce pour un radiateur couvert, relevé immédiat).
- Deux widgets de tableau de bord : les pièces chauffées, avec les boutons « Mode maison » et « Mode absent », et la connexion.
Transport : cloud. Gladys ne parle jamais directement à vos thermostats : elle lit et écrit dans le cloud Danfoss, qui relaie les changements à la passerelle Ally. Un changement fait dans Gladys atteint le radiateur, et un changement fait dans l’application Ally ou sur l’appareil atteint Gladys, en quelques minutes — pas instantanément. Les données de vos appareils sortent de chez vous (c’est déjà le cas avec l’application Ally).
Non affiliée à Danfoss. Pas encore testée avec un vrai compte Danfoss : merci de signaler ce qui fonctionne et ce qui ne fonctionne pas.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Une installation Danfoss Ally configurée dans l’application Danfoss Ally (passerelle et appareils), avec un compte ouvert avec une adresse e-mail.
- Un compte sur le portail développeur Danfoss, developer.danfoss.com, créé avec exactement la même adresse e-mail que l’application Ally (majuscules comprises). Sinon l’API répond, mais ne liste aucun appareil.
- Sur le portail : Apps → créer une application, y activer le produit Danfoss Ally API, puis ouvrir ses clés : il vous faut la Consumer Key et le Consumer Secret. L’API est gratuite pour un usage privé ; Danfoss n’offre pas de support dessus.
Configuration
Dans Gladys, ouvrez Intégrations → Danfoss Ally :
| Champ | Description |
|---|---|
| Consumer Key | La clé de votre application sur le portail développeur. |
| Consumer Secret | Son secret : envoyé à Danfoss uniquement, jamais réaffiché, jamais écrit dans les journaux. |
| Intervalle de relevé | Toutes les 1, 2, 5 ou 10 minutes (2 par défaut). Une seule requête relève toute la maison. |
| Seuil de pile faible (%) | Sous ce niveau, le déclencheur « Une pile est faible » se déclenche (20 % par défaut). |
| Langue des textes des appareils | Noms des fonctionnalités et messages du bouton ; automatique par défaut. |
Cliquez sur Tester la connexion : l’intégration relève vos appareils et les liste avec leur modèle et leur nombre de fonctionnalités. Ouvrez ensuite l’onglet Découverte et ajoutez les pièces voulues : rien n’est créé sans vous.
Utilisation
Appareils
Chaque appareil propose les fonctionnalités que son état permet :
| Fonctionnalité | Type Gladys | Remarques |
|---|---|---|
| Consigne | Consigne de thermostat, 5 à 35 °C par 0,5 °C | La consigne du mode en cours : en mode « Maison », la changer change la température maison du programme. Un thermostat à consigne unique (premier Icon) l’écrit directement. |
| Mode de chauffage | Mode du thermostat : arrêt, chauffage, auto | Arrêt = Pause (hors-gel), chauffage = Manuel, auto = le programme (Maison / Absent / Vacances). |
| Préréglage | Preset du thermostat : hors-gel, absence, confort | Hors-gel = Pause, absence = Absent (aussi affiché pendant des vacances), confort = Maison. Inchangé en mode Manuel. |
| Chauffe | État de fonctionnement : inactif ou chauffe | D’après l’ouverture de vanne d’une tête thermostatique, ou la sortie d’un thermostat Icon. |
| Température ambiante, température du sol | Capteur de température | La température du sol seulement avec une sonde de sol (Icon). |
| Humidité | Capteur d’humidité | Icon2 et capteurs d’ambiance. |
| Pile | Niveau de batterie | Tous les appareils à piles. |
| Fenêtre ouverte | Détecteur d’ouverture (lecture seule) | Détectée par le thermostat lui-même (chute de température). |
| Sécurité enfant | Sécurité enfant | Activée ou désactivée. |
Le widget Thermostat du tableau de bord de Gladys fonctionne avec la consigne. L’ouverture de vanne exacte (en %) n’a pas de catégorie Gladys : elle s’affiche dans le détail du widget des pièces.
Après une commande, l’intégration relève cet appareil plusieurs fois pendant 5 minutes et garde entre-temps la valeur demandée, pour que le tableau de bord ne revienne pas à l’ancienne valeur que le cloud renvoie encore quelques instants.
Widgets du tableau de bord
- Pièces chauffées : chaque pièce avec sa température, sa consigne et son mode, et un badge pour ce qui demande votre attention (hors ligne, défaut, fenêtre ouverte, pile faible, chauffe avec l’ouverture de vanne). Touchez une pièce pour son détail (consignes de chaque mode, humidité, température du sol, capteur externe…). Les boutons Mode maison et Mode absent basculent tous les thermostats d’un coup (après confirmation) ; Actualiser relève tout de suite. Choisissez les pièces dans les réglages du widget (8 au plus).
- Danfoss Ally : l’état de la connexion à l’API, les appareils en ligne, les requêtes de la dernière heure, un bouton Actualiser.
Scènes
Déclencheurs (chacun peut être limité à un appareil) :
- Une fenêtre est ouverte / Une fenêtre est fermée.
- Une pile est faible : une fois, jusqu’au remplacement de la pile.
- Un appareil passe hors ligne / Un appareil est de retour.
- Un appareil signale un défaut : un défaut ou un code d’erreur, une fois par nouveau code.
- Le mode change : dans l’application Ally, sur l’appareil ou par son programme — jamais à cause de Gladys elle-même. Filtre par nouveau mode.
Actions :
- Changer le mode de chauffage : Maison, Absent, Pause, Manuel ou Vacances, sur un thermostat ou sur tous (sorties : changés, en échec).
- Régler la consigne d’un mode : la température du mode Maison, Absent, Pause, Manuel ou Vacances (ou du mode actuel), sans changer de mode.
- Envoyer une température de pièce : pour un radiateur caché derrière un cache ou un rideau, la tête thermostatique régule sur la température d’un autre capteur. Saisissez un nombre ou une variable de scène (la valeur d’un capteur) ; « off » l’arrête. Danfoss attend une valeur toutes les 5 à 30 minutes : une valeur envoyée moins de 5 minutes après la précédente est ignorée (sortie
sent= false). - Relever les thermostats maintenant.
Exemples :
- Quand une fenêtre est ouverte → envoyer une notification « Fenêtre ouverte dans {{triggerEvent.data.device_name}} ».
- À 8 h en semaine, quand la maison est vide → passer tous les thermostats en mode Absent ; au retour → Maison.
- Toutes les 10 minutes → lire le capteur du salon, puis envoyer sa valeur comme température de pièce de la tête du radiateur derrière le canapé.
Transport
Le catalogue affiche le badge cloud : chaque requête part vers api.danfoss.com, avec vos identifiants. Il n’y a pas de mode local : Danfoss ne propose pas d’API locale pour la passerelle Ally.
Dépannage
- « Danfoss refuse les identifiants » : recopiez la Consumer Key et le Secret depuis le portail (Apps → votre application) et vérifiez que l’API Danfoss Ally est activée pour cette application.
- Connectée, mais aucun appareil : le compte du portail doit utiliser exactement la même adresse e-mail que l’application Ally, majuscules comprises. Créez au besoin un autre compte sur le portail avec la bonne adresse.
- Un changement met des minutes à apparaître : c’est le fonctionnement du cloud Danfoss ; l’intégration relève l’appareil pendant 5 minutes après une commande. Un intervalle plus court ne rend pas les appareils plus rapides.
- « Danfoss demande de ralentir » : l’API a répondu « trop de requêtes » (429). L’intégration espace ses relevés, puis revient d’elle-même au rythme normal. Préférez un intervalle de 2 minutes ou plus.
- La passerelle n’est pas proposée : elle ne remonte rien à afficher ; « Tester la connexion » la liste comme « non proposé ».
- Signalez un problème sur GitHub avec votre version de Gladys, la version de l’intégration et le résultat de « Tester la connexion ».
Paramètres de configuration
Voici les paramètres demandés par Danfoss Ally dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Danfoss Ally | section | Non | Pour se connecter : 1. Installez vos thermostats dans l’application Danfoss Ally, avec un compte e-mail. 2. Sur developer.danfoss.com, créez un compte avec exactement la même adresse e-mail (majuscules comprises). 3. Dans « Apps », créez une application, activez-y l’« API Danfoss Ally », et copiez ci-dessous sa Consumer Key et son Consumer Secret. 4. Dans l’onglet Découverte, ajoutez vos pièces. L’intégration passe par le cloud Danfoss : un changement atteint les appareils, et un changement fait sur eux atteint Gladys, en quelques minutes. |
| Consumer Key | string | Oui | La clé de votre application sur developer.danfoss.com (Apps → votre application → Keys). |
| Consumer Secret | secret | Oui | Le secret de la même application. Envoyé à Danfoss uniquement, jamais réaffiché. |
| Intervalle de relevé | select | Non | Une seule requête relève toute la maison. Danfoss ne publie pas de quota mais ralentit les clients trop bavards : 2 minutes est un bon compromis. |
| Seuil de pile faible (%) | number | Non | Le déclencheur de scène « Pile faible » se déclenche quand une pile passe sous ce niveau (5 à 50). |
| Langue des textes des appareils | select | Non | Noms des fonctionnalités et messages du bouton ci-dessous. Automatique : la langue du tableau de bord dès qu’un widget est affiché. |
Comment installer Danfoss Ally dans Gladys
- Dans Gladys, ouvrez Intégrations : Danfoss Ally apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/william-de71/gladys-danfoss-ally:0.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/William-De71/gladys-danfoss-ally.
Danfoss Ally nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Danfoss Ally est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par William-De71, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation