Intégration domotique Hubspace, gratuite et open source
Hubspace (Home Depot) : lumières, prises, interrupteurs, ventilateurs ; serrures, arrosage.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Affiche et commande dans Gladys les appareils de votre compte Hubspace (Home Depot, cloud Afero) : lumières, prises et interrupteurs, ventilateurs de plafond, capteurs des extracteurs de salle de bain, et l'état des serrures et des programmateurs d'arrosage.
API non officielle, jamais testée avec un vrai compte. L'intégration parle à l'API de l'application Hubspace, que Hubspace ne documente pas et peut changer à tout moment. Elle a été écrite à partir de la bibliothèque aioafero (celle de l'intégration Home Assistant) et testée seulement avec des réponses inventées. Sans lien avec Hubspace, Home Depot ni Afero.
Ce que vous obtenez
Un appareil Gladys par appareil Hubspace pris en charge :
| Appareil Hubspace | Fonctionnalités Gladys |
|---|---|
| Lumière, variateur | Marche/Arrêt, Luminosité, Température de couleur, Couleur (selon l'ampoule) ; une série par zone (ex. main et trim) |
| Prise, interrupteur, transformateur | Marche/Arrêt (une par sortie ou zone), Puissance (W) quand l'appareil la donne |
| Ventilateur de plafond | Marche/Arrêt, Vitesse (%), Sens de rotation |
| Extracteur | Mouvement, Humidité au-dessus du seuil (lecture seule) |
| Serrure | État de la serrure (lecture seule), boutons Verrouiller et Déverrouiller, Batterie |
| Programmateur d'arrosage | Arrosage par robinet (1 = ouvert, lecture seule), boutons Ouvrir la vanne et Fermer la vanne, Batterie |
La lumière d'un ventilateur de plafond est un appareil à part (comme dans l'application). Les autres appareils Hubspace (thermostats, climatiseurs, déshumidificateurs, alarme) ne sont pas encore affichés. Les portes de garage ne sont pas gérées par aioafero : elles ne le sont pas non plus ici.
Serrures et vannes : désactivées par défaut
- Serrures : l'état est en lecture seule, les commandes sont des boutons (jamais un interrupteur : un « tout éteindre » de Gladys, d'un assistant vocal ou d'une scène ne peut pas les toucher). Verrouiller est toujours permis ; Déverrouiller est refusé tant que l'option Autoriser le déverrouillage des serrures depuis Gladys est désactivée (par défaut).
- Programmateurs d'arrosage : Ouvrir la vanne et Fermer la vanne sont refusés tant que l'option Autoriser les vannes d'arrosage depuis Gladys est désactivée (par défaut) ; l'état reste affiché.
- Avant chaque commande de serrure ou de vanne, l'intégration relit l'état auprès de Hubspace : rien n'est envoyé si l'appareil est hors ligne, si l'état est inconnu ou si la serrure est en mouvement, et rien n'est renvoyé si l'appareil est déjà dans l'état voulu. La décision se fait sur cette seule relecture : un état qu'elle ne contient pas est inconnu.
Prises et interrupteurs : ils sont des interrupteurs pour Gladys, donc pour un « tout éteindre » d'une scène ou d'un assistant vocal (Google Home, Alexa, HomeKit). N'exposez pas à un assistant vocal, et ne mettez pas dans une scène « tout éteindre », une prise qui alimente une pompe, un congélateur, un aquarium ou un appareil médical.
Mise en place
- Dans Gladys, installez l'intégration Hubspace depuis le store.
- Saisissez l'e-mail et le mot de passe de votre compte Hubspace (ceux de l'application), puis enregistrez : l'intégration se connecte une fois. Si l'état indique « Non connecté », cliquez sur Tester la connexion.
- Si l'état indique qu'un code a été envoyé par e-mail, voir ci-dessous.
- Ouvrez l'onglet Découverte et ajoutez les appareils.
Le champ du mot de passe est un champ secret : Gladys le garde dans sa
base (en clair, comme toute valeur de configuration, et dans ses
sauvegardes), ne le réaffiche jamais, et l'intégration ne l'envoie qu'à la
page de connexion Hubspace (accounts.hubspaceconnect.com).
Le mot de passe n'est envoyé que sur une action de votre part : un e-mail ou un mot de passe nouvellement enregistré, un clic sur Tester la connexion ou sur Envoyer le code de vérification. Jamais au démarrage, à une reconnexion à Gladys, ni pendant les lectures : Hubspace pouvant envoyer un code par e-mail à chaque connexion, vous ne recevez jamais de code sans l'avoir demandé. Le reste du temps, l'intégration renouvelle sa session avec son jeton de renouvellement ; si Hubspace le refuse, elle s'arrête (« session expirée », même après un redémarrage) et attend votre clic sur Tester la connexion.
Code de vérification (par e-mail)
Hubspace peut demander un code envoyé par e-mail lors d'une connexion. Dans ce cas, Hubspace envoie le code au moment de la connexion, l'intégration s'arrête et l'état l'indique :
- Sous Vérifier le code, saisissez le code du dernier e-mail de Hubspace et cliquez sur le bouton. « Code accepté » veut dire connecté.
- Pas d'e-mail, ou code trop vieux (plus de 10 minutes) ? Cliquez sur Envoyer le code de vérification : l'intégration se reconnecte et Hubspace envoie un nouveau code (au plus une fois par minute).
La session est ensuite gardée (dans le /data de l'intégration) : pas de
code aux redémarrages. L'intégration ne se connecte jamais d'elle-même : un
code n'est envoyé qu'après votre enregistrement ou votre clic, et l'attente
du code est gardée après un redémarrage.
Rafraîchissement
Tous les appareils sont lus toutes les 60 secondes par défaut (30 à 60, Intervalle de rafraîchissement), en une seule requête. Une commande part tout de suite ; la valeur confirmée par Hubspace s'affiche aussitôt et n'est pas défaite par une lecture un peu en retard (15 secondes).
Les commandes d'un même appareil passent l'une après l'autre. Gladys attend 5 secondes la réponse d'une commande : si Hubspace est trop lent, l'intégration refuse la commande avant de l'envoyer plutôt que de l'envoyer après l'échec affiché. Une commande envoyée restée sans réponse est signalée « envoyée sans confirmation : vérifiez l'état », et l'état est relu quelques secondes après (de même après une commande de serrure ou de vanne).
En cas de problème
- E-mail ou mot de passe refusé : l'intégration s'arrête et attend, même après un redémarrage. Corrigez-les puis enregistrez (ou cliquez sur Tester la connexion). Elle ne se reconnecte jamais d'elle-même après un refus.
- Session refusée : la session est renouvelée une fois ; refusée à nouveau, l'intégration se met en pause et réessaie après 1 heure, 6 heures, puis toutes les 24 heures (gardé après un redémarrage), sans jamais renvoyer le mot de passe. Tester la connexion réessaie tout de suite.
- Session expirée (jeton de renouvellement refusé) ou non connecté : arrêt jusqu'à un clic sur Tester la connexion. Une connexion restée sans réponse n'est jamais relancée d'elle-même.
- Page de connexion inconnue : Hubspace demande une étape que l'intégration ne connaît pas (accepter des conditions, changer le mot de passe…) : connectez-vous une fois dans l'application, puis cliquez sur Tester la connexion.
- Trop de requêtes (429) : une pause de 1 minute à 6 heures (le
Retry-Afterde Hubspace, 10 minutes sans lui), pour les lectures, les commandes et les boutons, gardée après un redémarrage ou une reconnexion à Gladys. HTTP 403 de la page de connexion : une heure. - Hubspace indisponible (5xx, réseau) : nouveaux essais après 1, 2, 5, 10, puis toutes les 15 minutes, jamais plus vite que l'intervalle.
- Un appareil hors ligne pour Hubspace est marqué « injoignable » sur sa carte.
Limites
- API non officielle : Hubspace peut la changer, la bloquer ou demander plus de vérifications.
- Pas de mises à jour en direct (le canal « Conclave » de l'application) : une lecture toutes les 30 à 60 secondes.
- Un seul compte Hubspace par Gladys.
- Pas d'effets lumineux, de minuteries ni de réglages (LED, sensibilité, haut-parleur…) dans cette version.
- Jamais testée avec un vrai compte : merci de signaler ce que vous voyez sur le dépôt GitHub (sans votre e-mail, mot de passe ni codes).
Vie privée
L'intégration garde dans /data/hubspace-state.json (lisible par son seul
conteneur) : le seul jeton de renouvellement (le jeton d'accès, de courte
durée, reste en mémoire) et l'identifiant de compte Afero, le compte auquel
ils appartiennent sous forme d'empreinte de l'e-mail, une connexion en
attente de code (ses cookies et paramètres), l'heure de la dernière demande
de code, la fin d'une pause 429 et d'une pause 403, et un arrêt
(identifiants refusés, page de connexion inconnue, session expirée, code
attendu, session refusée et son prochain essai) lié à une empreinte salée de
l'e-mail et du mot de passe. Ni l'e-mail ni le mot de passe. Rien n'est envoyé ailleurs
qu'à Hubspace et Afero.
Paramètres de configuration
Voici les paramètres demandés par Hubspace dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Hubspace | section | Non | Affiche les appareils de votre compte Hubspace (Home Depot, cloud Afero) dans Gladys : lumières (marche/arrêt, luminosité, température de couleur, couleur), prises et interrupteurs, ventilateurs de plafond (marche, vitesse, sens), capteurs des extracteurs, et l'état des serrures et des programmateurs d'arrosage (commandes désactivées par défaut). Saisissez l'e-mail et le mot de passe de l'application Hubspace, enregistrez, puis ajoutez les appareils depuis l'onglet Découverte. Si Hubspace vous envoie un code par e-mail, saisissez-le avec les boutons ci-dessous. Lecture toutes les 60 secondes. API non officielle, jamais testée avec un vrai compte. Sans lien avec Hubspace, Home Depot ni Afero. |
| E-mail Hubspace | string | Oui | |
| Mot de passe Hubspace | secret | Oui | Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à la page de connexion Hubspace (accounts.hubspaceconnect.com). |
| Intervalle de rafraîchissement (s) | number | Non | Secondes entre deux lectures de tous les appareils (30 à 60) : une requête à chaque fois. |
| Autoriser le déverrouillage des serrures depuis Gladys | boolean | Non | Désactivé par défaut : le bouton « Déverrouiller » d'une serrure est refusé. Le verrouillage est toujours permis. |
| Autoriser les vannes d'arrosage depuis Gladys | boolean | Non | Désactivé par défaut : les boutons « Ouvrir la vanne » et « Fermer la vanne » d'un programmateur sont refusés ; son état reste affiché. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des appareils ajoutés désormais. |
Comment installer Hubspace dans Gladys
- Dans Gladys, ouvrez Intégrations : Hubspace 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-hubspace: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-hubspace.
Hubspace 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
Hubspace 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