Intégration domotique Viessmann ViCare, gratuite et open source
Chaudières et pompes à chaleur Viessmann via ViCare : chauffage, eau chaude, capteurs.
Publiée par bertrandda
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration connecte à Gladys les chaudières (gaz, fioul) et pompes à chaleur Viessmann reliées à l'application ViCare, via le cloud Viessmann : chauffage, eau chaude sanitaire, températures et consommations.
Prérequis
- Un appareil Viessmann visible dans l'application ViCare (passerelle Vitoconnect ou passerelle intégrée).
- Votre compte ViCare (adresse e-mail et mot de passe).
- Gladys 5.1 ou plus récent, avec un accès à Internet.
1. Créer un client sur le portail développeur Viessmann
L'API ViCare demande un « client » personnel, gratuit, que vous créez une seule fois :
- Ouvrez le portail développeur Viessmann et connectez-vous avec vos identifiants ViCare.
- Créez un nouveau client (menu Clients).
- Donnez-lui un nom (par exemple « Gladys ») et indiquez comme URI de
redirection l'adresse affichée dans l'écran de configuration de
l'intégration, sous le bouton Connecter :
https://my.gladysassistant.com/redirect/oauth. L'adresse doit être identique au caractère près. Laissez les autres options par défaut. - Enregistrez, puis copiez l'identifiant client (Client ID). Aucun secret n'est nécessaire.
L'offre gratuite (« Basic ») suffit : elle autorise 1450 appels à l'API par jour.
2. Configurer l'intégration dans Gladys
- Dans l'onglet Configuration de l'intégration, collez l'identifiant client puis enregistrez la configuration.
- Seulement ensuite, dans le bloc Compte ViCare, cliquez sur Connecter, connectez-vous avec votre compte ViCare et acceptez l'accès. Connecter utilise l'identifiant enregistré, pas celui en cours de saisie : cliquer avant d'enregistrer échoue.
- Le statut passe à « Connecté ». Le bouton Tester la connexion indique les installations, passerelles et appareils trouvés.
- Dans l'onglet Découverte, ajoutez les appareils et placez chaque circuit de chauffage dans sa pièce.
Appareils créés
Pour chaque chaudière ou pompe à chaleur, l'intégration propose jusqu'à trois types d'appareils. Seules les fonctionnalités que votre modèle expose réellement sont créées.
Un thermostat par circuit de chauffage
| Fonctionnalité | Description |
|---|---|
| Consigne | Température du programme en cours (normal, réduit, confort…). La modifier change la température de ce programme, comme dans l'application ViCare. |
| Mode | Arrêt, chauffage, refroidissement ou automatique (voir le tableau ci-dessous). |
| État de fonctionnement | Au repos, en chauffe ou en refroidissement, d'après le brûleur ou le compresseur. |
| Température ambiante | Si une sonde d'ambiance est raccordée au circuit. |
| Température de départ | Température de l'eau envoyée dans le circuit. |
L'eau chaude sanitaire (chauffe-eau)
| Fonctionnalité | Description |
|---|---|
| Consigne eau chaude | Température demandée pour l'eau chaude. |
| Mode eau chaude | Sur les appareils récents (E3) et les pompes à chaleur (voir le tableau ci-dessous). |
| Charge ponctuelle | Chauffe le ballon une fois, tout de suite. |
| Chauffe en cours | Le ballon est en cours de chauffe. |
| Température du ballon | Température mesurée dans le ballon. |
Le générateur (chaudière ou pompe à chaleur)
Des capteurs en lecture seule : températures extérieure, de chaudière, de départ et de retour (circuits primaire et secondaire sur les pompes à chaleur), brûleur et compresseur (en marche, nombre de démarrages, heures de fonctionnement), consommations du jour en gaz (m³ ou kWh selon le modèle) et en électricité (kWh).
Correspondance des modes
Mode d'un circuit de chauffage :
| Mode ViCare | Mode Gladys |
|---|---|
standby, dhw (eau chaude seule) | Arrêt |
heating, dhwAndHeating, forcedNormal, forcedReduced | Chauffage |
cooling | Refroidissement |
heatingCooling, dhwAndHeatingCooling | Automatique |
Mettre un circuit à l'arrêt depuis Gladys choisit dhw quand l'appareil
le permet : le chauffage s'arrête mais l'eau chaude continue d'être produite.
L'eau chaude se pilote séparément, avec l'appareil chauffe-eau.
Mode de l'eau chaude :
| Mode ViCare | Mode Gladys |
|---|---|
off | Arrêt |
eco, efficient, efficientWithMinComfort | Éco |
balanced | Automatique |
comfort | Manuel |
Éco regroupe les modes économiques de ViCare (eco, efficient,
efficientWithMinComfort, nommés « Eco » ou « Efficace » dans l'application
selon le modèle). Gladys n'a pas de mode « Confort » pour les chauffe-eau : le
comfort de ViCare s'affiche Manuel.
Un mode que votre appareil ne propose pas est refusé, avec un message qui indique les modes acceptés.
Widget « Programme de chauffe »
Sur un tableau de bord, ajoutez le widget Programme de chauffe de l'intégration et choisissez un circuit de chauffage. Il affiche :
- le programme en cours du circuit et sa consigne, en direct ;
- le planning ViCare de la semaine, une ligne par jour, et le programme appliqué hors des plages (en général réduit) ;
- la courbe de chauffe : pente et parallèle.
Le widget ne coûte aucun appel à l'API : il utilise les valeurs du rafraîchissement habituel.
Le planning est en lecture seule : il se modifie dans l'application ViCare. Le bouton Courbe de chauffe ouvre un formulaire pour modifier la pente et la parallèle (Gladys 5.2 ou plus récent ; en Gladys 5.1, le bouton l'indique). La courbe règle la température de départ selon la température extérieure :
- trop froid quand il gèle dehors, correct en mi-saison : augmentez la pente ;
- trop froid (ou trop chaud) quel que soit le temps : augmentez (ou baissez) la parallèle.
Procédez par petits pas (0,1 pour la pente, 1 pour la parallèle) et attendez quelques jours entre deux réglages : un bâtiment réagit lentement. Les températures ambiante et extérieure conservées dans l'historique de Gladys aident à juger du résultat.
Thermostat de Gladys 5.2 (planning et widget)
Gladys 5.2 peut programmer un circuit de chauffage avec son propre planning hebdomadaire et l'afficher dans son widget thermostat :
- Dans Intégrations → Thermostat, créez un thermostat externe.
- Consigne : la Target temperature (consigne) du circuit. Mode : son Mode. État : son Operating state (état de fonctionnement). Température : sa Room temperature (température ambiante) si le circuit a une sonde d'ambiance, sinon n'importe quel capteur de la pièce.
- Associez un planning si Gladys doit programmer le circuit.
Bon à savoir :
- La consigne écrite par Gladys modifie la température du programme que le circuit applique dans ViCare (normal, réduit, confort). Si le planning ViCare alterne entre normal et réduit, les consignes de Gladys atterrissent dans les deux programmes. Pour que le planning de Gladys fasse foi, réglez dans l'application ViCare le planning du circuit sur une seule plage « normal » couvrant toute la journée. Pour garder le planning ViCare, n'associez pas de planning Gladys.
- Arrêter le thermostat passe le circuit en eau chaude seule : l'eau chaude continue d'être produite. Gladys écrit alors aussi sa consigne hors-gel, et réécrit la bonne consigne quand le thermostat redémarre.
- Chaque valeur écrite par Gladys coûte un appel à l'API (une valeur inchangée n'est pas renvoyée).
Rafraîchissement et quota
- L'intégration lit toutes les données d'une passerelle en un seul appel. L'intervalle par défaut (120 s) consomme environ 720 appels par jour sur les 1450 autorisés. Avec plusieurs passerelles, l'intervalle est multiplié par leur nombre, pour rester dans le quota.
- Après une commande, la nouvelle valeur s'affiche tout de suite, puis l'appareil est relu une quinzaine de secondes plus tard pour confirmer.
- Si le quota est épuisé, l'intégration se met en pause jusqu'à son renouvellement. L'écran de configuration affiche l'heure de reprise (UTC). Augmentez alors l'intervalle de rafraîchissement.
Limites connues
- Les préréglages de thermostat (confort, éco, absence) ne sont pas proposés : Gladys ne les a que depuis la 5.2, et l'intégration reste compatible avec Gladys 5.1.
- Quand le circuit est sur un programme sans température réglable (veille, hors-gel), la consigne n'est pas affichée et ne peut pas être modifiée.
- Ne sont pas encore pris en charge : la modulation du brûleur (Gladys n'a pas de catégorie adaptée), le solaire thermique, le photovoltaïque et les batteries, la ventilation, les thermostats et sondes Zigbee, les températures de chaque programme, et la modification des plannings (affichés en lecture seule dans le widget).
- L'heure de la chaudière ne se règle pas depuis Gladys : l'API ViCare n'a pas de commande pour cela. Réglez-la depuis le menu de la chaudière.
- Le pilotage passe uniquement par le cloud Viessmann : il faut une connexion à Internet.
Dépannage
- « Saisissez l'identifiant client… », ou Connecter échoue : collez le Client ID du portail développeur et enregistrez la configuration avant de cliquer sur Connecter.
- Erreur de redirection lors de la connexion : l'URI de redirection du client sur le portail doit être exactement celle affichée sous le bouton Connecter.
- « L'autorisation ViCare a expiré ou a été révoquée » : cliquez à nouveau sur Connecter. Changer d'identifiant client oblige aussi à se reconnecter.
- « Quota journalier de l'API ViCare atteint » : patientez jusqu'à l'heure indiquée et augmentez l'intervalle de rafraîchissement.
- Une passerelle hors ligne : ses appareils gardent leurs dernières valeurs, les autres continuent d'être mis à jour.
- Les logs de l'intégration détaillent chaque erreur. Ils ne contiennent jamais vos tokens.
Paramètres de configuration
Voici les paramètres demandés par Viessmann ViCare dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | 1. Connectez-vous au portail développeur Viessmann avec votre compte ViCare et créez un client dont l'URI de redirection est l'adresse affichée sous le bouton Connecter ci-dessous. 2. Collez son identifiant client dans le champ ci-dessous. 3. Enregistrez la configuration. 4. Seulement ensuite, cliquez sur Connecter et identifiez-vous avec votre compte ViCare. Le lien Documentation détaille chaque étape. |
| Identifiant client (client ID) | string | Oui | Identifiant client de l'application créée sur le portail développeur Viessmann. |
| Compte ViCare | oauth2 | Non | Enregistrez la configuration avec l'identifiant client avant de cliquer sur Connecter : Connecter utilise l'identifiant enregistré, pas celui en cours de saisie. |
| Intervalle de rafraîchissement (s) | number | Non | Secondes entre deux lectures d'une passerelle. L'offre ViCare gratuite autorise 1450 appels par jour : 120 s en consomment environ la moitié, et l'intervalle est multiplié par le nombre de passerelles. |
Comment installer Viessmann ViCare dans Gladys
- Dans Gladys, ouvrez Intégrations : Viessmann ViCare 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/bertrandda/gladys-viessmann:1.1.0), 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/bertrandda/gladys-viessmann.
Viessmann ViCare 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
Viessmann ViCare 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 bertrandda, 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