Intégration domotique Husqvarna Automower, gratuite et open source
Connecteur non officiel : tondeuses robots Automower, état, batterie, départ, retour et erreurs.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Connecteur non officiel, sans lien avec Husqvarna. Il amène les tondeuses robots Husqvarna Automower® dans Gladys via l'API officielle Automower Connect, avec une application que vous créez vous-même sur le portail développeur Husqvarna. Automower est une marque de Husqvarna AB.
Ce que vous obtenez
| Surface | Contenu |
|---|---|
| Un appareil par tondeuse | état de fonctionnement, batterie, activité, mode, code et texte d'erreur, connexion au cloud Husqvarna, prochain départ, un choix tondre / pause et un bouton retour à la base |
| Déclencheurs de scène | erreur, activité changée, tonte terminée, déconnectée |
| Actions de scène | démarrer la tonte (pendant une durée), garer (jusqu'au prochain créneau, jusqu'à nouvel ordre ou pendant une durée), pause, reprendre le planning |
| Widget | Tondeuse robot : batterie, prochain départ, activité, état, mode, erreur, connexion, et les boutons Démarrer / Garer / Pause / Reprendre |
| Écran de configuration | un bouton Tester Husqvarna qui liste vos tondeuses |
Installation
- Ouvrez le portail développeur Husqvarna et connectez-vous avec votre compte Automower Connect (celui de l'application mobile, où vos tondeuses sont associées).
- Créez une application : nom libre, et
http://localhost:8080comme URL de redirection (elle ne sert pas). - Dans l'application, connectez-la à Authentication API et à Automower Connect API. Sans la seconde, Husqvarna refuse toutes les requêtes.
- Copiez la clé d'application et le secret d'application dans la configuration de l'intégration dans Gladys, et enregistrez.
- Ouvrez Découverte et ajoutez vos tondeuses.
- Placez le widget Tondeuse robot sur un tableau de bord.
La clé et le secret sont stockés chiffrés par Gladys et envoyés uniquement à Husqvarna. Si Husqvarna les refuse, l'intégration cesse d'essayer jusqu'à ce que vous enregistriez à nouveau la configuration : des connexions échouées répétées bloquent le compte Husqvarna pendant 30 minutes.
L'appareil
Gladys n'a pas encore de catégorie tondeuse robot : l'état et les deux commandes utilisent la catégorie aspirateur robot, la seule qui décrit un robot qui travaille, rentre à sa base et se recharge. La carte de l'appareil affiche donc :
- State (état) : En cours (tonte ou départ de la station), Retour à la base, En charge, Sur la base, En pause, Erreur, Arrêté ;
- Mowing (idle: pause) : un choix dont « Nettoyer » lance la tonte pour la durée configurée (3 heures par défaut) et « Repos » met la tondeuse en pause ;
- Park until the next schedule : le bouton « Retour à la base », qui gare la tondeuse jusqu'au prochain créneau de son planning.
Les autres fonctionnalités sont la batterie (%), l'activité et le mode (textes dans la langue choisie dans la configuration), le code d'erreur (0 : aucune) et son texte, la connexion au cloud Husqvarna et le prochain départ, à l'heure de la tondeuse.
Une commande de démarrage ne fait pas sortir la tondeuse de sa station tout de suite : selon Husqvarna, elle part une fois complètement chargée.
Scènes
- Erreur Automower : une fois par erreur (coincée, soulevée, hors de la zone de travail...). Variables : le code, le texte en anglais et en français, l'heure, l'état de la tondeuse.
- Activité Automower changée : éventuellement pour une activité précise (tonte, retour à la station, charge, départ, garée, arrêtée dans le jardin...). Variables : la nouvelle et l'ancienne activité, l'état, la batterie.
- Tonte Automower terminée : la tondeuse a fini une session (garée à sa station, arrêtée dans le jardin ou en attente d'un démarrage manuel). Un retour à la station pour se recharger en cours de session ne compte pas. Variables : où elle s'est arrêtée, la durée de la session en minutes (vide si elle a commencé avant que Gladys ne la voie), la batterie, le code d'erreur.
- Automower déconnectée : la tondeuse a perdu sa connexion au cloud Husqvarna. Husqvarna ne l'indique que lors d'une relecture complète : jusqu'à 30 minutes de retard par défaut.
Les actions démarrer la tonte, garer, pause et reprendre le
planning agissent sur la tondeuse choisie, ou sur toutes quand le champ
est vide. Elles donnent mower_name et count aux actions suivantes de
la scène, qui les trouvent dans leur liste de variables (écrites
{{<étape>.<action>.<clé>}}, par exemple {{0.0.count}} quand cette
action est la première de la scène).
À quel rythme Husqvarna est appelé
Husqvarna autorise 21 000 requêtes par semaine et par application. L'intégration lit toutes les tondeuses au démarrage, puis les suit grâce aux événements en direct du websocket Automower Connect. Elle relit tout toutes les 30 minutes (option Intervalle de relecture complète), et toutes les 10 minutes tant que le lien en direct est coupé. Une commande est relue une fois, 30 secondes après. Une semaine type utilise environ 2 % du quota.
Dépannage
- « Husqvarna a refusé la clé ou le secret de l'application » : recopiez-les depuis le portail (My applications), puis enregistrez la configuration.
- « L'application n'est pas connectée à l'API Automower Connect » : connectez-la sur le portail (étape 3), puis enregistrez à nouveau la configuration.
- Pas d'événements en direct alors que le reste fonctionne : Husqvarna conseille de renouveler le secret de l'application sur le portail.
- Le prochain départ est décalé d'une heure : la tondeuse envoie son heure locale ; l'intégration la lit dans le fuseau horaire de Gladys.
- Journaux : le niveau de log de l'intégration se règle avec la variable
LOG_LEVEL.
Vie privée
L'intégration n'utilise que l'état de vos tondeuses : les positions GPS qu'envoie Husqvarna avec les données sont aussitôt écartées, jamais gardées ni affichées. La clé et le secret d'application ne partent que chez Husqvarna, et n'apparaissent jamais dans un journal, un statut ou une scène.
Paramètres de configuration
Voici les paramètres demandés par Husqvarna Automower dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Les tondeuses Husqvarna Automower dans Gladys | section | Non | Connecteur non officiel, sans lien avec Husqvarna. Il lit vos tondeuses robots via l'API officielle Automower Connect avec votre propre application du portail développeur : un appareil par tondeuse (état, batterie, activité, mode, erreur, connexion, prochain départ, un choix tondre / pause et un bouton de retour à la base), des événements en direct par websocket, des déclencheurs de scène sur les erreurs, les changements d'activité, la fin de la tonte et la perte de connexion, des actions de scène pour démarrer, garer, mettre en pause et reprendre le planning, et un widget. Automower est une marque de Husqvarna AB. |
| Votre application Husqvarna | section | Non | Sur le portail développeur, connectez-vous avec votre compte Automower Connect, créez une application (nom libre, URL de redirection http://localhost:8080), puis connectez-la à « Authentication API » et à « Automower Connect API ». Copiez ci-dessous sa clé et son secret d'application. Vos tondeuses doivent être associées dans l'application Automower Connect. |
| Clé d'application | secret | Oui | Stockée chiffrée par Gladys et envoyée uniquement à Husqvarna. |
| Secret d'application | secret | Oui | Stocké chiffré par Gladys et envoyé uniquement au service d'authentification Husqvarna. |
| Durée de tonte d'un démarrage (minutes) | number | Non | Utilisée par le choix tondre / pause de l'appareil, le bouton Démarrer du widget et l'action de scène démarrer sans durée. La tondeuse ignore son planning pendant cette durée, puis y revient. |
| Intervalle de relecture complète (minutes) | number | Non | Les événements en direct apportent les changements ; tout le compte est relu à ce rythme (la connexion à Husqvarna n'est visible que de cette façon). Husqvarna limite les appels d'API par semaine et par application : 30 minutes en utilisent quelques pour cent. |
| Langue des textes (activité, mode, erreur) | select | Non |
Comment installer Husqvarna Automower dans Gladys
- Dans Gladys, ouvrez Intégrations : Husqvarna Automower 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/lm1lc3n7/gladys-automower:0.1.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). - 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/LM1LC3N7/gladys-automower.
Husqvarna Automower nécessite Gladys >=5.1.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
Husqvarna Automower 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 LM1LC3N7, 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