Intégration domotique Huawei Health, gratuite et open source
Montres, bracelets et balances Huawei : pas, cœur, SpO2, sommeil et poids dans Gladys.
Publiée par gboulvin
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.3.0
- ★ 0
Votre compte Huawei Santé (Huawei Health) dans Gladys : les valeurs santé de vos montres, bracelets et balances Huawei (pas, fréquence cardiaque, SpO2, stress, sommeil, poids, température corporelle), des déclencheurs et des actions de scène, et trois widgets de tableau de bord.
L'intégration lit le cloud Huawei Santé via l'API officielle de Huawei, Health Service Kit. Elle n'écrit jamais dans votre compte. Votre montre continue de se synchroniser comme d'habitude via l'application Huawei Santé de votre téléphone ; Gladys lit ensuite le cloud.
Avant de commencer. Huawei n'ouvre Health Service Kit qu'aux applications qu'il a examinées. Il vous faut votre propre compte développeur Huawei (gratuit) et une application validée : comptez environ 10 jours ouvrés d'examen par Huawei. Les étapes sont ci-dessous.
1. Créer votre application Huawei
- Créez un compte développeur sur HUAWEI Developers et terminez la vérification d'identité (particulier ou entreprise).
- Dans la Console, ouvrez HUAWEI ID → Apply for HUAWEI ID.
Choisissez le type de produit Server app (ou Web app), créez le
produit et, dans Callback URL, saisissez l'adresse de redirection
affichée par Gladys sous le bouton Connecter de l'intégration (par
défaut
https://my.gladysassistant.com/redirect/oauth). - Notez l'App ID (Client ID) et l'App secret (Client secret).
- Dans la Console, ouvrez Health Service Kit → Apply for Health
Service Kit, choisissez le même produit et cochez les permissions de
lecture des données voulues, au minimum :
- Activité : Steps, Calories, Distance ;
- Santé : Heart rate, SpO2, Stress, Body temperature, Body fat (poids), Sleep. Remplissez le formulaire de demande fourni par Huawei (décrivez un usage domotique personnel) et envoyez.
- Attendez l'e-mail de Huawei (environ 10 jours ouvrés). Les permissions sont utilisables environ 24 heures après la validation.
À savoir :
- La validation « test » autorise jusqu'à 100 utilisateurs : largement assez pour un foyer.
- Huawei indique que les développeurs particuliers n'ont accès qu'au niveau d'ouverture « basique » et peuvent devoir publier une application mobile ; si votre demande est refusée pour cette raison, un compte développeur entreprise est la solution documentée.
- Huawei ne partage que les données produites après la liaison de votre compte (pas d'historique antérieur à l'autorisation).
2. Configurer l'intégration
- Ouvrez l'onglet Configuration de l'intégration.
- Saisissez le Client ID et le Client secret.
- Dans Données à lire, ne gardez que ce que votre application a obtenu : Huawei refuse la connexion si une permission n'a pas été accordée.
- Réglages facultatifs : intervalle de rafraîchissement (15 minutes par défaut, 5 minutes minimum), fuseau horaire (pour savoir quel jour est « aujourd'hui »), objectif de pas quotidien et seuils d'alerte (fréquence cardiaque haute/basse, SpO2 basse).
- Enregistrez, puis cliquez sur Connecter et connectez-vous avec le HUAWEI ID utilisé par votre application Huawei Santé.
- Sur votre téléphone, dans l'application Huawei Santé, ouvrez Moi → Gestion de la confidentialité et autorisez le partage des données avec Health Kit (l'action Tester la connexion vous le signale s'il manque).
3. Appareils
Ouvrez l'onglet Découverte et ajoutez Huawei Health - <votre nom>. Il porte une fonctionnalité en lecture seule par valeur :
| Valeur | Groupe |
|---|---|
| Pas, calories actives, distance (du jour) | Activité |
| Fréquence cardiaque, FC au repos, VFC | Fréquence cardiaque |
| Oxygène sanguin (SpO2) | Oxygène sanguin |
| Score de stress | Stress |
| Température corporelle et cutanée | Température |
| Poids, indice de masse corporelle, masse grasse | Poids |
| Score de sommeil, total, profond, léger, paradoxal | Sommeil |
Huawei fusionne tous les appareils du compte (montre, bracelet, balance, téléphone) : l'historique survit à un changement de montre. Une valeur que vos appareils ne mesurent pas reste vide. L'action Tester la connexion et le widget de synthèse listent les appareils connus de Huawei.
Actions
- Tester la connexion : vérifie l'autorisation Huawei et le partage dans l'appli Santé, et liste vos appareils.
- Synchroniser maintenant : lit immédiatement le cloud Huawei.
- Se déconnecter : supprime les jetons Huawei de Gladys. Pour révoquer complètement l'accès, retirez aussi l'application de votre HUAWEI ID (paramètres du compte → confidentialité).
Déclencheurs de scène
| Déclencheur | Quand | Variables |
|---|---|---|
| Nuit de sommeil enregistrée | une nouvelle nuit arrive dans le cloud | score, durée, sommeil profond, heure de réveil |
| Objectif de pas quotidien atteint | les pas du jour dépassent l'objectif (une fois par jour) | pas, objectif |
| Fréquence cardiaque anormale | une nouvelle mesure franchit un seuil (filtre : haute/basse) | fréquence cardiaque, sens |
| Oxygène sanguin bas | une nouvelle mesure de SpO2 passe sous le seuil | SpO2 |
| Nouvelle pesée | un nouveau poids arrive dans Huawei Santé | poids, IMC, masse grasse |
La première lecture après un redémarrage sert de référence : elle ne déclenche jamais rien.
Actions de scène
- Synchroniser Huawei Santé : sortie
synced. - Obtenir le résumé santé (option : synchroniser d'abord) : pas, calories actives, distance, fréquence cardiaque, FC au repos, SpO2, stress, poids, score et durée de sommeil, heure de la dernière synchro. Exemple de message : « Tu as dormi {{sleep_minutes}} minutes, score {{sleep_score}} ».
Widgets de tableau de bord
- Huawei Santé : pas, fréquence cardiaque, SpO2, stress, score de sommeil et poids, avec le compte, la dernière synchro et vos appareils, et un bouton Rafraîchir.
- Activité Huawei : jauge de l'objectif de pas, calories actives, distance et graphique des 7 derniers jours.
- Sommeil Huawei : score et phases de la dernière nuit, heures d'endormissement et de réveil, et courbe de fréquence cardiaque des dernières 24 h (l'appareil doit être créé dans Gladys).
Dépannage
- « Cliquez sur Connecter » : le compte n'est pas lié, ou le Client ID a changé.
- Certaines données n'ont pas pu être lues : la permission n'est pas accordée à votre application, ou n'était pas cochée lors du clic sur Connecter. Corrigez dans la console Huawei, puis cliquez à nouveau sur Connecter.
- Aucune donnée mais « connecté » : autorisez le partage dans l'appli Huawei Santé (Moi → Gestion de la confidentialité) et attendez que la montre se synchronise avec le téléphone.
- « Autorisation expirée » : le jeton Huawei dure environ six mois et expire si vous changez le mot de passe de votre HUAWEI ID : cliquez à nouveau sur Connecter.
- Les comptes enregistrés hors d'Europe sont servis par un autre site Huawei : l'intégration le trouve toute seule.
Paramètres de configuration
Voici les paramètres demandés par Huawei Health dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre application développeur Huawei | section | Non | Huawei ne partage les données Huawei Santé qu'avec des applications validées pour Health Service Kit. Créez une application sur HUAWEI Developers, demandez Health Service Kit avec les permissions de lecture des données ci-dessous (examen : environ 10 jours ouvrés), déclarez l'adresse de redirection affichée sous le bouton Connecter, puis saisissez ici le Client ID et le Client secret. La documentation détaille chaque étape. |
| Client ID (App ID) | string | Oui | Client ID OAuth 2.0 de votre application, dans la console HUAWEI Developers. |
| Client secret | secret | Oui | Client secret OAuth 2.0 de la même application. |
| Données à lire | multi_select | Non | Ne cochez que ce que votre application Huawei a obtenu : Huawei refuse la connexion si une permission n'a pas été accordée. Cliquez à nouveau sur Connecter après un changement. |
| Compte Huawei | oauth2 | Non | Enregistrez d'abord le Client ID et le secret, puis connectez-vous avec le HUAWEI ID utilisé par l'application Huawei Santé. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture du cloud Huawei Santé (5 minutes minimum). Votre montre se synchronise via l'application Huawei Santé de votre téléphone. |
| Fuseau horaire | string | Non | Fuseau horaire IANA utilisé pour découper les journées (pas du jour) et afficher les heures. |
| Objectif de pas quotidien | number | Non | Déclenche « Objectif de pas atteint » et remplit la jauge du widget d'activité. |
| Alerte fréquence cardiaque haute (bpm) | number | Non | |
| Alerte fréquence cardiaque basse (bpm) | number | Non | |
| Alerte oxygène sanguin bas (%) | number | Non |
Comment installer Huawei Health dans Gladys
- Dans Gladys, ouvrez Intégrations : Huawei Health 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/gboulvin/gladys-huawei-health: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). - 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/gboulvin/Gladys-Huawei-Health.
Huawei Health 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
Huawei Health 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 gboulvin, 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