Démarrage rapide

Cette page présente les étapes à suivre pour avoir un VTherm basique mais opérationnel rapidement. Elle est présentée par type d'équipements.

Nodon SIN-4-FP-21 ou assimilé (fil pilote)

Ce module permet de commander un radiateur avec un fil pilote. Il est visible sous HA sous la forme d'une entité select qui permet de choisir le preset de chauffage à appliquer.

VTherm va réguler la température en changeant de preset via les commandes personnalisées régulièrement jusqu'à ce que la consigne soit atteinte.

Attention à la potentielle confusion, les différents modes de VTherm (hors-gel, eco, confort, etc.) ne correspondent pas directement aux modes de même nom du radiateur contrôlé par fil pilote. VTherm ne va en fait (avec une configuration classique) utiliser que 2 des modes disponibles par fil pilote, un pour « chauffer plus » (en général le mode confort), et un pour « chauffer moins » (en général le mode hors gel), avec les commandes indiquées à l'étape 4 ci-après. L'alternance de ces commandes va permettre à VTherm de stabiliser la température effective à celle définie dans ses paramètres, selon le mode choisi.

Pour que cela fonctionne, il faut que le preset utilisé pour la commande de chauffage soit supérieur à la température maximale que vous aurez besoin (24° est une bonne valeur).

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_switch. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité select qui contrôle le Nodon. Cf. sous-jacent,
  4. Lui donner des commandes d'allumage et extinction personnalisées (obligatoire pour le Nodon). Cf. sous-jacent. Les commandes personnalisées sont du type select_option/option:<preset> comme indiqué dans le lien.

A l'issue de ces 4 étapes vous avez un VTherm opérationnel ultra simple qui contrôle votre Nodon ou assimilé.

Heatzy ou eCosy ou assimilé (entité climate)

Ce module permet de commander un radiateur qui est visible sous HA sous la forme d'une entité climate qui permet de choisir le preset de chauffage à appliquer ou le mode (Chauffe / Froid / éteint).

VTherm va réguler la température en allumant / éteignant via les commandes personnalisées régulièrement l'équipement jusqu'à ce que la consigne soit atteinte.

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_switch. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité climate qui contrôle le Heatzy ou le eCosy. Cf. sous-jacent,
  4. Lui donner des commandes d'allumage et extinction personnalisées (obligatoire). Cf. sous-jacent. Les commandes personnalisées sont du type set_hvac_mode/hvac_mode:<mode> ou set_preset_mode/preset_mode:<preset> comme indiqué dans le lien.

A l'issue de ces 4 étapes vous avez un VTherm opérationnel ultra simple qui commande votre équipement Heatzy ou eCosy ou assimilé.

Simple switch comme Aqara T1, Nous B2Z, Sonoff ZBMini, Sonoff POW, ...

Ce module permet de commander un radiateur contrôlé par un simple switch. Il est visible sous HA sous la forme d'une entité switch qui permet d'allumer ou éteindre directement le radiateur.

VTherm va réguler la température en allumant / éteignant régulièrement le switch jusqu'à ce que la consigne soit atteinte.

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_switch. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité switch qui contrôle le switch. Cf. sous-jacent

A l'issue de ces 3 étapes vous avez un VTherm opérationnel ultra simple qui contrôle votre switch ou assimilé.

Sonoff TRVZB ou assimilé (TRV avec contrôle de la vanne)

Cet équipement de type TRV contrôle l'ouverture d'une vanne qui laisse plus ou moins passer de l'eau chaude produit par une chaudière ou une PAC. Il est visible sous HA sous la forme d'une entité de type climate et d'entités de type number qui vont permettre le contrôle de la vanne. Ces entités number peuvent être cachées et doivent être explicitement ajoutées dans certains cas.

Le VTherm va moduler le taux d'ouverture de la vanne jusqu'à obtention de la température de consigne.

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_climate. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité climate qui contrôle le TRV. Cf. sous-jacent,
  4. Spécifier la régulation de type Par contrôle direct de la vanne uniquement. Laissez décochée l'option Compenser la température interne du sous-jacent. Cf. sous-jacent,
  5. Lui donner les entités de type number nommées opening_degree, closing_degree et calibration offset. Cf. sous-jacent,

Pour que cela fonctionne, il faut que le closing degree soit réglé au maximum (100%). Ne cocher pas tout de suite l'entité Follow underlying temperature change avant d'avoir bien vérifier que cette configuration de base fonctionne.

A l'issue de ces 5 étapes vous avez un VTherm opérationnel ultra simple qui commande votre équipement Sonoff TRVZB ou assimilé.

Simple TRV comme Avatto TRV06, Moes, Tuya... (TRV sans contrôle de la vanne)

Ce type d'équipement TRV (typiquement des équipements Zigbee intégrés via Zigbee2MQTT ou ZHA) est visible sous HA uniquement sous la forme d'une entité de type climate. L'ouverture de la vanne n'est pas contrôlable : le TRV se régule seul à partir de son thermomètre interne et de la consigne qu'il reçoit.

Le VTherm va ajuster la consigne envoyée au TRV pour que la température de la pièce mesurée par votre propre capteur atteigne la température souhaitée.

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_climate. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité climate du TRV. Cf. sous-jacent,
  4. Activer l'auto-régulation : commencez par Légère ou Moyenne et gardez les valeurs par défaut du seuil de régulation et de la période minimale de régulation. Cf. auto-régulation. Laissez décochée l'option Compenser la température interne du sous-jacent, sauf si le thermomètre interne de votre TRV est très faussé (c'est un dernier recours, cf. compenser la température interne),
  5. Si votre TRV expose une entité number comme local_temperature_calibration, activer la synchronisation de la température interne de l'équipement avec calibrage (mode 1). S'il expose une entité external_temperature_input, vous pouvez utiliser le mode 2. Cf. synchronisation de la température interne.

Certaines fonctions intégrées au TRV entrent en conflit avec VTherm. Ce sont des réglages de l'équipement que VTherm ne gère pas, vérifiez-les directement sur l'équipement (ou dans Zigbee2MQTT / ZHA) :

  • Désactivez le programme hebdomadaire interne et n'utilisez pas le mode système auto. Gardez le TRV en mode heat : VTherm gère les programmations à travers les presets,
  • Désactivez la détection d'ouverture de fenêtre du TRV. Utilisez plutôt la détection d'ouverture de VTherm,
  • N'utilisez pas les presets internes du TRV (eco, comfort, boost, holiday...). VTherm envoie directement la consigne,
  • Optionnellement, activez le verrouillage enfant pour éviter les changements manuels sur l'équipement.

Astuce Notes

  • La fonction auto-start/stop est conçue pour les équipements qui consomment de l'énergie même à l'arrêt, comme les PAC. Elle est généralement peu utile avec un TRV sur piles.
  • Ne cochez pas tout de suite l'entité Follow underlying temperature change avant d'avoir bien vérifié que cette configuration de base fonctionne. Cf. suivre les changements de température du sous-jacent.

A l'issue de ces 5 étapes et de la vérification des réglages du TRV, vous avez un VTherm opérationnel qui commande votre TRV simple.

PAC reversibles ou climatisation ou équipements commandables à travers une entité climate

Les PAC ou assimilés sont visibles sous HA sous la forme d'une entité climate qui permet de choisir le preset de chauffage à appliquer ou le mode (Chauffe / Froid / éteint).

VTherm va réguler la température en commandant la consigne de l'équipement et son mode à l'aide de commandes envoyée à l'entité climate sous-jacente.

Pour l'intégrer dans VTherm vous devez :

  1. Créer un VTherm de type over_climate. Cf. création d'un VTherm,
  2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. principaux attributs,
  3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité climate qui contrôle la PAC ou la clim... . Cf. sous-jacent,

A l'issue de ces 3 étapes vous avez un VTherm opérationnel ultra simple qui commande votre PAC, climatisation ou assimilé. Pour aller plus loin, une auto-régulation peut êrte nécessaire en fonction du bon fonctionnement de votre équipement. L'auto-régulation consiste à envoyer des consignes légèrement modifiées par VTherm pour forcer l'équipement à chauffer plus ou moins jusqu'à ce que la consigne soit atteinte. L'auto-régulation est détaillée ici : auto-régulation.

La suite

Une fois créé, vous devez paramétrer les températures des presets. Cf. presets pour avoir une configuration minimale. Vous pouvez aussi (facultatif mais conseillé) installer la carte dédiée pour vos dashboard. (Cf. VTHerm UI Card)

Une fois cette configuration minimale opérationnelle - et seulement lorsque cette configuration minimale fonctionne -, vous pourrez ajouter des fonctions supplémentaires comme la détection de présence pour éviter de chauffer lorsqu'il n'y a personne. Ajoutez les une par une, vérifiez à chaque nouvelle fonction que VTherm réagit correctement avant de passer à la suivante.

Ensuite vous pourrez ajouter une configuration centrale pour mettre en commum des réglages entre tous les VTherm, paraméter le mode central permettant de contrôler tous les VTherm d'un coup (la configuration centralisée), ajouter un éventuel contrôle d'une chaudière centrale (la chaudière centrale). Cette liste est non exhaustive, merci de consulter le sommaire pour avoir la liste de toutes les fonctions de VTherm.

Appel à contribution

Cette page ne demande qu'à se compléter. N'hésitez pas à proposer vos équipements et la configuration minimale.