Aller au contenu principal

Intégration GARDENA smart system pour Gladys Assistant

Intégration GARDENA smart system pour Gladys Assistant

Pilotez vos tondeuses, vannes, prises et capteurs GARDENA depuis Gladys.

Voir sur GitHubToutes les intégrations externes

Pilotez votre jardin GARDENA depuis Gladys : tondeuses robots, vannes d'arrosage, prises d'extérieur et capteurs de sol. L'intégration utilise l'API publique officielle GARDENA smart system, celle qu'utilise l'application GARDENA elle-même : tout reste synchronisé dans les deux sens.

Ce dont vous avez besoin​

  • une passerelle GARDENA smart gateway déjà installée, avec vos appareils appairés et fonctionnels dans l'application GARDENA ;
  • un compte gratuit sur le portail développeur Husqvarna (GARDENA appartient au groupe Husqvarna) — l'API est gratuite pour un usage personnel.

L'intégration ne parle jamais directement à vos appareils : les appareils GARDENA utilisent une radio propriétaire vers la passerelle, et la passerelle ne parle qu'au cloud GARDENA. Une connexion Internet est donc nécessaire.

Étape 1 — Créer votre application d'API​

  1. Rendez-vous sur https://developer.husqvarnagroup.cloud/ et cliquez sur Sign in.
  2. Connectez-vous avec votre compte GARDENA habituel (celui de l'application GARDENA). Aucun compte séparé n'est à créer.
  3. Ouvrez My applications puis cliquez sur New application. Donnez-lui le nom que vous voulez, par exemple Gladys. L'URL de redirection n'est pas utilisée par cette intégration : laissez-la vide ou mettez http://localhost.
  4. Sur la page de l'application, cliquez sur Connect new API et connectez l'API GARDENA smart system. Cette étape est facile à oublier, et sans elle l'API répond 403 Forbidden à toutes les requêtes.
  5. Copiez la Application key (clé) et l'Application secret (secret) affichés sur cette page.

Laissez également l'API d'authentification connectée — elle est ajoutée automatiquement dans la plupart des cas, et c'est elle qui délivre le jeton.

Étape 2 — Configurer l'intégration dans Gladys​

  1. Collez la clé d'application et le secret d'application dans l'écran de configuration, puis enregistrez.
  2. Cliquez sur Tester la connexion : l'intégration s'authentifie et liste les emplacements (jardins) de votre compte.
  3. Allez dans l'onglet Découvrir : tous les appareils GARDENA de votre compte apparaissent. Créez ceux que vous souhaitez utiliser dans Gladys.

Réglages optionnels :

RéglageRôle
Identifiant d'emplacementLimiter l'intégration à un seul jardin. Laissez vide pour tous les utiliser.
Relecture de l'API GARDENADélai minimum entre deux relectures complètes de l'API GARDENA, le filet de sécurité derrière le flux temps réel. C'est ce réglage qui consomme votre quota hebdomadaire de requêtes — voir le tableau plus bas. Par défaut : une heure.
Durée par défautDurée d'arrosage d'une vanne, ou d'allumage d'une prise, quand vous l'activez depuis Gladys.
Allumage des prisesÉteindre automatiquement après la durée par défaut, ou rester allumée jusqu'à extinction.
Démarrage de la tondeuseDémarrer la tondeuse peut suivre son propre calendrier, ou le forcer pendant une durée fixe.
Arrêt de la tondeuseArrêter la tondeuse peut la garer jusqu'à sa prochaine tâche planifiée, ou annuler le calendrier jusqu'à nouvel ordre.

Ce que vous obtenez dans Gladys​

Appareil GARDENAFonctionnalités créées
smart Mower (SILENO...)Tonte (marche/arrêt), activité, état, dernière erreur, heures de fonctionnement, batterie, signal
smart Water ControlArrosage (marche/arrêt), activité, temps d'arrosage restant, batterie, signal
smart Irrigation ControlUn interrupteur d'arrosage, une activité et un temps restant par voie, nommés comme dans l'app
smart Power (prise d'extérieur)Marche/Arrêt, activité, temps restant, signal
smart Sensor / smart Soil SensorHumidité du sol, température du sol, température ambiante, luminosité, batterie, signal

Activer une vanne lance un arrosage manuel de la durée configurée : l'API GARDENA ne propose pas de commande « ouvrir indéfiniment » sur une vanne, ce qui est exactement ce que l'on veut d'un système domotique branché sur un robinet.

L'état marche/arrêt d'une tondeuse, d'une vanne ou d'une prise reflète toujours ce que GARDENA rapporte, et non ce que Gladys a demandé : une tondeuse rentrée à cause de la pluie, ou une vanne ouverte depuis l'application GARDENA, s'affiche correctement dans Gladys.

Temps réel​

L'intégration maintient un websocket ouvert vers GARDENA pour chaque emplacement, la méthode supportée pour suivre un jardin : un changement fait sur l'appareil, dans l'application GARDENA ou par une programmation arrive dans Gladys en une à deux secondes. Le rafraîchissement périodique n'est qu'un filet de sécurité en cas de message manqué.

GARDENA ferme ce websocket toutes les deux heures environ, volontairement : l'intégration se reconnecte seule et se resynchronise à chaque fois.

Gladys interroge ses appareils toutes les minutes (son intervalle le plus court disponible), mais cette interrogation n'appelle pas GARDENA : l'intégration répond depuis l'image qu'elle a déjà en mémoire, et ne relit l'API GARDENA que lorsque cette image dépasse l'âge du réglage Relecture de l'API GARDENA. Quel que soit le nombre d'appareils du jardin, une relecture coûte un appel.

Rester dans le quota de requêtes GARDENA​

GARDENA accorde un nombre limité de requêtes API par semaine à une application personnelle gratuite. L'intégration est construite autour de cette contrainte : le websocket temps réel ne coûte rien par événement, si bien que les requêtes consommées sont presque uniquement celles de la relecture périodique de sécurité.

Ce que coûte une semaine, quel que soit le nombre d'appareils du jardin (une relecture lit tout l'emplacement en un seul appel) :

Relecture de l'API GARDENARelecturesURL websocketJetonsTotal / semaine
15 minutes672847763
30 minutes336847427
1 heure (par défaut)168847259
2 heures84847175
6 heures28847119

Les deux coûts fixes sont incompressibles : GARDENA ferme le flux temps réel toutes les deux heures environ et il faut redemander une URL (~84 par semaine), et le jeton d'accès est renouvelé chaque jour (7 par semaine, sur l'API d'authentification, distincte).

Les commandes ajoutent une requête chacune — ouvrir une vanne, allumer une prise, démarrer la tondeuse. Cent commandes par semaine, cent requêtes : avec la relecture par défaut, la marge reste large.

Deux réflexes suffisent :

  • ne descendez pas la relecture sous une heure sans savoir que votre quota le permet. Le flux temps réel apporte déjà tous les changements en quelques secondes ; la relecture ne rattrape que ce qu'un websocket coupé aurait pu manquer ;
  • évitez de redémarrer l'intégration en boucle : chaque démarrage coûte un listing des emplacements plus une relecture complète.

Si GARDENA répond malgré tout « trop de requêtes », l'intégration suspend d'elle-même ses relectures REST pendant une heure et continue de fonctionner sur le flux temps réel, au lieu d'insister et d'aggraver la situation.

Actions​

  • Tester la connexion — s'authentifie et liste les emplacements du compte. À utiliser en premier lorsque quelque chose ne va pas.
  • Rafraîchir les appareils — relit le compte, par exemple après avoir ajouté un appareil dans l'application GARDENA.
  • Arrêter tout l'arrosage — ferme toutes les vannes de l'appareil choisi jusqu'à sa prochaine tâche planifiée. Pratique dans une scène, ou avant d'aller marcher dans le jardin.

En cas de problème​

« GARDENA a refusé les identifiants » — la clé ou le secret est incorrect, ou bien l'API GARDENA smart system n'est pas connectée à votre application sur le portail développeur (étape 1.4). C'est de loin la cause la plus fréquente.

Un appareil affiche un badge orange « injoignable » — la passerelle GARDENA ne le voit plus (liaison radio hors ligne) : l'appareil est hors de portée, éteint, ou ses piles sont vides. Gladys conserve les dernières valeurs connues au lieu de faire croire qu'elles sont à jour.

« GARDENA limite le débit de l'intégration » — l'API applique sa limitation. L'intégration espace ses appels et réessaie, mais si vous avez beaucoup augmenté la fréquence de rafraîchissement, remettez une valeur plus élevée : le flux temps réel vous donne déjà les changements.

Aucun appareil dans l'onglet Découvrir — vérifiez que vos appareils apparaissent bien dans l'application GARDENA, et que le filtre d'emplacement (si vous en avez mis un) correspond au bon jardin.

GARDENA est une marque déposée du groupe Husqvarna. Cette intégration communautaire est indépendante : elle n'est ni affiliée à GARDENA ou au groupe Husqvarna, ni approuvée ou supportée par eux.

Paramètres de configuration​

Voici les paramètres demandés par GARDENA smart system dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Connectez votre compte GARDENAsectionNonCette intégration utilise l'API publique officielle GARDENA smart system. Créez un compte gratuit sur le portail développeur Husqvarna, connectez-vous avec votre compte GARDENA (Husqvarna), créez une application, connectez-lui l'API « GARDENA smart system API », puis copiez sa clé et son secret d'application ci-dessous.
Clé d'applicationstringOuiLa clé d'application de votre application sur le portail développeur Husqvarna.
Secret d'applicationsecretOuiLe secret d'application de cette même application. Il est stocké chiffré et n'est jamais renvoyé au navigateur.
Identifiant d'emplacement (optionnel)stringNonLimiter l'intégration à un seul emplacement GARDENA (jardin). Laissez vide pour utiliser tous les emplacements du compte.
Relecture de l'API GARDENA (s)numberNonDélai minimum entre deux relectures complètes de l'API GARDENA, le filet de sécurité derrière le flux temps réel. GARDENA compte un quota hebdomadaire de requêtes et c'est ce réglage qui le consomme : une heure coûte environ 170 appels par semaine, quinze minutes en coûteraient environ 670. Les changements arrivent déjà en temps réel, gardez une valeur élevée.
Durée par défaut (min)numberNonDurée d'arrosage d'une vanne, ou d'allumage d'une prise, lorsque vous l'activez depuis Gladys.
Allumage des prisesselectNonCe qui se passe lorsqu'une prise GARDENA est allumée depuis Gladys.
Démarrage de la tondeuseselectNonCe que signifie démarrer la tondeuse depuis Gladys : la laisser suivre son calendrier, ou le forcer pendant une durée fixe.
Durée de tonte (min)numberNonUtilisée lorsque le mode de démarrage force le calendrier.
Arrêt de la tondeuseselectNonCe que signifie arrêter la tondeuse depuis Gladys : la garer jusqu'à la prochaine tâche planifiée, ou annuler le calendrier.

Comment installer GARDENA smart system dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : GARDENA smart system apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/nagromdark/gladys-gardena:1.0.1), 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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/Nagromdark/gladys-gardena.

GARDENA smart system nécessite Gladys >=4.85.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​

GARDENA smart system 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 Nagromdark, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le