Intégration domotique Home Connect, gratuite et open source
Pilotez et suivez vos appareils Bosch, Siemens, Neff et Gaggenau via Home Connect.
Publiée par prohand
- Appareils
- Version 2.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à Home Connect, la plateforme cloud des appareils électroménagers Bosch, Siemens, Neff, Gaggenau, Balay, Constructa, Profilo et Thermador.
Tout appareil visible dans l'application Home Connect apparaît dans Gladys : lave-vaisselle, lave-linge, sèche-linge, lavante-séchante, fours, micro-ondes, tiroirs chauffants, tables de cuisson, hottes, réfrigérateurs, congélateurs, caves à vin, machines à café, robots aspirateurs et robots culinaires.
Il n'y a pas de mode local. Les appareils Home Connect dialoguent avec le cloud BSH, et uniquement avec lui. Sans connexion Internet, cette intégration ne fonctionne pas. C'est une propriété des appareils, pas de l'intégration.
1. Créer une application développeur Home Connect
L'API Home Connect est gratuite, mais chaque instance Gladys a besoin de ses propres identifiants : BSH les délivre par développeur, pas par produit.
- Créez un compte gratuit sur le portail développeur Home Connect et connectez-vous. Utilisez la même adresse e-mail que votre compte de l'application Home Connect : le portail relie les deux, et c'est à cette condition que vous verrez vos propres appareils.
- Allez dans Applications → Register Application et renseignez :
- Application ID : ce que vous voulez, par exemple
gladys. - OAuth Flow : Authorization Code Grant Flow.
- Home Connect User Account for Testing : l'adresse e-mail de votre compte Home Connect.
- Redirect URI : voir l'étape 2 ci-dessous, Gladys doit d'abord vous la donner.
- Success Redirect URI : laissez vide.
- Application ID : ce que vous voulez, par exemple
- Une fois l'application enregistrée, le portail affiche vos Client ID et Client Secret.
2. Configurer l'intégration dans Gladys
- Installez l'intégration, puis ouvrez son onglet Configuration.
- Collez le Client ID et le Client Secret.
- Cliquez sur Enregistrer, puis sur Connecter au niveau du champ Compte Home Connect. Gladys ouvre la page de connexion Home Connect.
Si Home Connect répond « redirect_uri mismatch », c'est que l'URL utilisée par Gladys n'est pas celle déclarée dans le portail. Cliquez une fois sur le bouton Tester la connexion : il affiche l'URL de redirection exacte utilisée par Gladys. Collez-la dans le champ Redirect URI de votre application développeur, enregistrez sur le portail, puis cliquez de nouveau sur Connecter.
- Connectez-vous avec votre compte Home Connect et autorisez les permissions demandées.
- De retour dans Gladys, ouvrez l'onglet Découverte : vos appareils sont listés, prêts à être ajoutés.
3. Ce que vous obtenez par appareil
Les fonctionnalités sont construites à partir de ce que chaque appareil déclare réellement : deux appareils n'obtiennent donc jamais la même liste. En général :
| Fonctionnalité | Type | Appareils |
|---|---|---|
| Alimentation | on/off | la plupart |
| Programme en cours | on/off | appareils à programmes |
| Programme actif / sélectionné | texte | appareils à programmes |
État de fonctionnement (Run, Ready, Finished…) | texte | tous |
| Temps restant, temps écoulé, progression | capteur | appareils à programmes |
| Porte | ouverture | la plupart |
| Démarrage à distance, commande à distance, usage local | capteur | la plupart |
| Consignes réfrigérateur / congélateur | thermostat | froid |
| Super mode, mode éco, mode vacances | on/off | froid |
| Température du four | température | fours |
| Éclairage, éclairage d'ambiance, luminosité | lumière | hottes, fours, réfrigérateurs |
| Sécurité enfant | verrou | appareils compatibles |
| Compteurs de boissons | compteur | machines à café |
| Alertes (sel, réservoir d'eau, filtre…) | binaire | selon la famille d'appareil |
| Connecté | binaire | tous |
Porte suit la convention Gladys des détecteurs d'ouverture : la fonctionnalité affiche Fermé quand la porte est fermée et Ouvert sinon (une porte verrouillée compte comme fermée). Les alertes affichent Off tant que Home Connect ne les a pas déclenchées : un lave-vaisselle qui n'a jamais manqué de sel montre une alerte au repos, et non une valeur vide.
Démarrer un programme
Programme en cours démarre le programme actuellement sélectionné sur l'appareil (ou dans l'application Home Connect) : il n'en choisit pas un à votre place. C'est exactement ce que les appareils autorisent — un démarrage à distance est un déclencheur, pas un sélecteur de programme.
Pour que cela fonctionne, le démarrage à distance doit être armé sur l'appareil : sur la plupart des modèles, un appui long sur la touche Démarrage à distance jusqu'à confirmation à l'écran. Sans cela, Home Connect refuse la commande et Gladys affiche le message de refus.
Repasser Programme en cours sur « éteint » interrompt le programme.
4. Tableau de bord, scènes et déclencheurs
Depuis Gladys 5.1, une intégration peut poser ses propres cartes sur le tableau de bord et enrichir l'éditeur de scènes. Home Connect utilise les trois.
Les cartes du tableau de bord
Tableau de bord → Modifier → Ajouter une boîte, catégorie des intégrations :
- Home Connect — tous vos appareils dans une carte, une ligne par appareil, avec ce qu'il fait (« En marche · Auto2 · 30 min »). Ce qui tourne est en haut. Laissez le réglage Appareils vide pour tout afficher, ou cochez ceux qui vous intéressent.
- Appareil — un seul appareil : état, programme, porte, temps restant, progression, et les boutons Démarrer / Pause / Arrêter. Les boutons s'adaptent : un appareil à l'arrêt propose Démarrer, un appareil en marche propose Pause et Arrêter. Décochez Afficher les boutons pour une carte en lecture seule.
Le temps restant et la progression sont branchés directement sur les fonctionnalités de l'appareil : ils bougent en temps réel, sans rechargement.
Les déclencheurs de scènes
Dans une scène, Ajouter un déclencheur → Intégrations :
| Déclencheur | Se déclenche quand |
|---|---|
| Un programme a démarré | un appareil lance un cycle (ou programme un départ différé) |
| Un programme est terminé | un cycle se termine normalement |
| Un programme a été interrompu | un cycle est arrêté avant la fin |
| Un appareil a signalé quelque chose | sel bas, réservoir vide, filtre saturé, alarme de porte… |
Laissez le champ Appareil vide pour réagir à n'importe quel appareil. Dans les
actions de la scène, le déclencheur fournit {{triggerEvent.data.appliance_name}},
{{triggerEvent.data.program}} et, pour les notifications,
{{triggerEvent.data.notification_name}} — de quoi écrire « Le lave-vaisselle a
terminé le programme Auto2 » dans une notification.
Une alerte qui s'éteint ne déclenche rien : seul le moment où elle se lève est un événement.
Les actions de scènes
Dans une scène, Ajouter une action → Intégrations :
| Action | Effet |
|---|---|
| Démarrer le programme sélectionné | lance le programme déjà choisi sur l'appareil |
| Arrêter le programme en cours | interrompt le cycle |
| Mettre le programme en pause | appareils qui acceptent la commande pause |
| Reprendre le programme | relance un cycle en pause |
| Lire l'état de l'appareil | ne pilote rien : renvoie l'état, le programme, le temps restant |
Lire l'état de l'appareil est faite pour les actions suivantes de la scène :
elle renvoie state, program, running, remaining_seconds,
remaining_label, progress, door, connected et summary (une phrase
prête à envoyer). Elle lit ce que l'intégration a déjà en mémoire : aucune
requête Home Connect, donc aucun quota consommé.
Les mêmes limites que pour la fonctionnalité Programme en cours s'appliquent : démarrer lance le programme sélectionné sur l'appareil, et le démarrage à distance doit y être armé.
5. Comment les états restent à jour
L'intégration maintient ouvert un flux d'événements permanent vers Home Connect : une porte qui s'ouvre ou un programme qui se termine arrive dans Gladys en une seconde environ — y compris les actions faites directement sur l'appareil.
Le polling (par défaut toutes les 15 minutes) tourne derrière, en filet de sécurité, car Home Connect coupe le flux environ une fois par jour. Home Connect applique un quota de requêtes : gardez un intervalle élevé sauf raison particulière.
Une valeur qui ne change pas est tout de même renvoyée à Gladys au moins une fois par heure. Gladys considère en effet qu'un état devient « périmé » au bout d'un certain délai (48 heures par défaut, réglable dans Paramètres → Système) et affiche alors « Pas de valeur récente » sur le tableau de bord. Un lave-vaisselle qui reste plusieurs jours dans le même état — connecté, réservoir de sel plein, aucun programme en cours — doit donc redire régulièrement que rien n'a changé. Ces renvois ne consomment aucune requête Home Connect.
6. Tester sans appareil
Activez Utiliser le simulateur Home Connect dans la configuration.
L'intégration s'adresse alors à simulator.home-connect.com, qui sert la même
API sur les appareils virtuels de votre compte développeur. Pensez à le
désactiver ensuite.
7. Dépannage
« Renseignez vos Client ID et Client Secret Home Connect » — les identifiants sont absents ou vides.
« Cliquez sur Connecter pour lier votre compte Home Connect » — les identifiants sont là, mais le flux OAuth n'a jamais été mené à son terme.
« L'intégration a refusé la connexion. Réessayez. » dans la fenêtre de retour d'autorisation — l'échange du code d'autorisation a échoué. Ouvrez les logs de l'intégration : le message y donne la raison exacte donnée par Home Connect (Client Secret manquant, URL de redirection non déclarée dans le portail développeur, code déjà utilisé…). Si vous avez redémarré l'intégration ou la machine pendant que vous vous connectiez chez Home Connect, relancez simplement Connecter : une autorisation reste valable quinze minutes.
Après un Connecter réussi, la fenêtre se ferme immédiatement et l'état de la connexion affiche « Compte connecté, lecture de vos appareils… » : la lecture du compte Home Connect se poursuit en arrière-plan et peut prendre quelques secondes par appareil.
« Autorisation Home Connect expirée » — le refresh token a été refusé. Il expire après environ deux mois sans utilisation, et il est également révoqué si vous retirez Gladys des applications autorisées de votre compte Home Connect. Cliquez de nouveau sur Connecter.
« Quota Home Connect atteint » — trop de requêtes. L'intégration lève le pied d'elle-même ; augmentez l'intervalle de rafraîchissement si cela se répète.
Une carte du tableau de bord affiche « Lecture de vos appareils Home Connect… » — l'intégration n'a pas encore lu le compte (redémarrage récent, quota atteint ou Home Connect injoignable au démarrage). La carte relance la lecture toute seule et se remplit en quelques secondes ; si le message persiste, regardez l'état de la connexion dans la configuration de l'intégration.
Une carte affiche « Cet appareil n'existe plus dans Gladys » — l'appareil choisi dans les réglages de la carte a été supprimé de Gladys ou retiré du compte Home Connect. Rouvrez les réglages de la carte et choisissez-en un autre.
Un appareil affiche un badge orange « injoignable » — c'est Home Connect lui-même qui ne le joint pas. Vérifiez dans l'application Home Connect qu'il est allumé et connecté à votre Wi-Fi.
Une commande est refusée — Gladys affiche la raison donnée par Home Connect. Les plus fréquentes : démarrage à distance non activé, porte ouverte et appareil éteint.
L'intégration journalise tout ce qu'elle fait : passez LOG_LEVEL=debug et
consultez les logs de l'intégration depuis l'interface Gladys pour le détail
complet.
Paramètres de configuration
Voici les paramètres demandés par Home Connect dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Home Connect n'a pas d'API locale : tout passe par le cloud BSH. Créez un compte développeur gratuit, enregistrez une application de type « Home Connect Application » avec le flux Authorization Code Grant, puis collez ses Client ID et Client Secret ci-dessous. L'URL de redirection à déclarer est affichée par l'action « Tester la connexion » une fois la connexion lancée. |
| Client ID | string | Oui | Client ID de votre application Home Connect. |
| Client Secret | secret | Non | Client Secret de votre application Home Connect. Laissez vide uniquement si vous avez enregistré un client public sans secret. |
| Compte Home Connect | oauth2 | Oui | Connectez-vous avec le compte Home Connect auquel vos appareils sont associés, puis autorisez Gladys. |
| Langue | select | Non | Langue des noms de fonctionnalités et des noms de programmes renvoyés par Home Connect. |
| Intervalle de rafraîchissement (s) | number | Non | Filet de sécurité derrière le flux d'événements temps réel. Home Connect impose un quota de requêtes quotidien : gardez une valeur élevée sauf raison particulière. |
| Scopes OAuth | string | Non | Scopes Home Connect demandés lors de l'autorisation, séparés par des espaces. Réduisez-les si votre application développeur a été enregistrée avec moins de permissions. |
| Utiliser le simulateur Home Connect | boolean | Non | Utiliser simulator.home-connect.com au lieu de l'API de production, pour tester sans appareil réel. |
Comment installer Home Connect dans Gladys
- Dans Gladys, ouvrez Intégrations : Home Connect 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/prohand/gladys-homeconnect:2.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). - 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/prohand/gladys-homeconnect.
Home Connect 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
Home Connect 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 prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation