Thermostat de type over_climate
- Thermostat de type
over_climate
Pré-requis
Les équipements pilotables par un VTherm over_climate (climatisations, PAC, TRV...) sont listés dans le catalogue des matériels, et les vannes thermostatiques dans le catalogue des TRV.
L'installation doit ressembler à ça :

- L'utilisateur ou une automatisation ou le Scheduler programme une consigne (setpoint) par le biais d'un pre-réglage ou directement d'une température,
- régulièrement le thermomètre intérieur (2) ou extérieur (2b) ou interne à l'équipement (2c) envoie la température mesurée. Le thermomètre intérieur doit être placé à une place pertinente pour le ressenti de l'utilisateur : idéalement au milieu du lieu de vie. Evitez de le mettre trop près d'une fenêtre ou trop proche de l'équipement,
- avec les valeurs de consigne, des différents thermomètres et les paramètres de l'auto-régulation (cf. auto-regulation), VTherm va calculer une consigne qui sera envoyée à l'entité
climatesous-jacente, - l'entité
climatesous-jacente contrôle l'équipement avec son propre protocole, - selon les options de régulation choisies le VTherm pourra potentiellement contrôler directement l'ouverture d'une vanne thermostatique ou calibrer l'équipement pour que sa température interne soit le reflet de la température de la pièce.
Configuration
Configurez d'abord les paramètres principaux et communs à tous les VTherm (cf. paramètres principaux). Cliquez ensuite sur l'option de menu "Sous-jacents" et vous allez avoir cette page de configuration :

Les sous-jacents
Dans la "liste des équipements à contrôler" vous mettez les entités climate qui vont être controllées par le VTherm. Seules les entités de type climate sont acceptées.
Le mode AC
Il est possible de choisir un thermostat over_climate qui commande une climatisation (réversible ou non) en cochant la case "AC Mode". Si l'équipement le permet, les 2 modes 'Chauffage' et 'Refroidissement' seront alors disponibles.
La synchronisation de la température interne des sous-jacents
Cette fonction permet une bien meilleure régulation puisqu'elle synchronise le thermomètre interne des climate sous-jacents avec la température de la pièce mesurée par VTherm. Elle est décrite ici.
L'auto-régulation
En mode over_climate, le device utilise son propre algorithme de régulation : il s'allume / s'éteint et se met en pause tout seul en fonction de la consigne transmise par le VTherm à travers son entité climate. Il utilise pour ça son thermomètre interne et la consigne reçue.
Selon l'équipement cette régulation interne peut être plus ou moins bonne. Ca dépend beaucoup de la qualité de l'équipement, du fonctionnement de son thermomètre interne et de son algorithme interne. Pour améliorer les équipements qui régule mal, VTherm propose de tricher un peu sur la consigne qui lui est envoyée en augmentant ou diminuant celle-ci en fonction cette fois de la température de la pièce mesurée par VTherm et non plus de la température interne.
Les choix d'auto-régulation sont décrits dans le détail ici.
Afin d'éviter de trop solliciter l'équipement sous-jacent (certain font un bip désagréable, d'autres sont sur batterie, ...), deux seuils permettant de limiter le nombre de sollicitation sont proposés :
- le seuil de régulation
regulation_threshold: un seuil en ° (ou en %) en dessous duquel la nouvelle consigne ne sera pas envoyée. Si la dernière consigne était de 22°, alors la prochaine envoyée, sera de 22° +/- seuil de régulation. Si la régulation contrôle directement la vanne (over_valveouover_climateavec contrôle direct de la vanne) alors la valeur doit être spécifiée en pourcentage et ne doit pas être inférieure à 3% pour les Sonoff TRVZB (sinon le calibrage peut être perdu), - la période minimale de régulation en minute : un interval de temps minimal en minute en dessous duquel la nouvelle consigne ne sera pas envoyée. Si la dernière consigne a été envoyée à 11h00, alors la prochaine ne pourra pas être envoyée avant 11h00 + periode minimal de régulation.
S'ils sont mal réglés, ces seuils peuvent empêcher une auto-régulation correcte puisque les nouvelles consignes ne seront pas envoyées.
Démarrage de la régulation par vanne avec des degrés sans retour
Avec auto_regulation_valve, certaines entités number utilisées pour les degrés d’ouverture et de fermeture sont des consignes d’écriture sans retour d’état. Après un redémarrage de Home Assistant ou un rechargement de l’intégration, elles peuvent rester unknown alors que l’entité climate sous-jacente reste utilisable.
Après l’installation de ses listeners normaux, VTherm inspecte une fois la paire ouverture/fermeture configurée. Seulement si chaque cible est numérique ou exactement unknown, si toutes les limites de régulation et toutes les bornes min/max des entités number sont valides, il calcule la paire de fermeture nominale avec une demande 0. Il écrit au plus une fois, via le helper normal des nombres, et uniquement sur les cibles exactement unknown ; les cibles numériques ne sont jamais réécrites.
Si une cible est unavailable, absente, None, non numérique ou possède des bornes invalides, VTherm n’écrit rien sur les deux cibles. Un appel de service, même sans erreur, n’est pas un retour d’état : le sous-jacent reste non initialisé jusqu’aux événements numériques normaux reçus pour toutes les cibles requises par UnderlyingStateManager. Il n’y a ni timeout, ni retry, ni fallback, ni override de readiness.
Les diagnostics sous vtherm_over_climate_valve.underlying_valves exposent seed_targets et seed_attempted_targets ; ils décrivent seulement les tentatives et jamais une disponibilité. Vérifiez les entités configurées, leurs bornes min/max et le retour numérique. Après correction d’une configuration ou d’un appareil, rechargez l’intégration ou redémarrez Home Assistant afin de créer un nouveau budget one-shot.
L'auto-ventilation (auto-fan)
Ce mode introduit en 4.3 permet de forcer l'usage de la ventilation si l'écart de température est important. En effet, en activant la ventilation, la répartition se fait plus rapidement ce qui permet de gagner du temps dans l'atteinte de la température cible. Vous pouvez choisir quelle ventilation vous voulez activer entre les paramètres suivants : Faible, Moyenne, Forte, Turbo.
Il faut évidemment que votre équipement sous-jacent soit équipé d'une ventilation et qu'il soit pilotable pour que cela fonctionne.
Si votre équipement ne comprend pas le mode Turbo, le mode Forte sera utilisé en remplacement.
Une fois l'écart de température redevenu faible, la ventilation se mettra dans un mode "normal" qui dépend de votre équipement à savoir (dans l'ordre) : Silence (mute ou quiet), Auto (auto), Faible (low). La première valeur qui est possible pour votre équipement sera choisie.
Plugin externe Une version enrichie de l'auto-fan est disponible sous forme de plugin externe. Ce plugin offre des possibilités de configuration supplémentaires et une gestion plus fine de la ventilation automatique. Consultez la page plugins pour découvrir ce plugin.
Compenser la température interne du sous-jacent
Attention : cette option ne doit pas être utilisée avec une régulation par contrôle direct de la vanne.
Quelque fois, il arrive que le thermomètre interne du sous-jacent (TRV, climatisation, ...) soit tellement faux que l'auto-régulation ne suffise pas à réguler. Cela arrive lorsque le thermomètre interne est trop près de la source de chaleur. La température interne monte alors beaucoup plus vite que la température de la pièce, ce qui génère des défauts dans la régulation. Exemple :
- la température de la pièce est 18°, la consigne est à 20°,
- la température interne de l'équipement est de 22°,
- si VTherm envoie 21° comme consigne (= 20° + 1° d'auto-regulation), alors l'équipement ne chauffera pas car sa température interne (22°) est au-dessus de la consigne (21°)
Pour palier à ça, une nouvelle option facultative a été ajoutée en version 5.4 : 
Lorsqu'elle est activée, cette fonction ajoutera l'écart entre la température interne et la température de la pièce à la consigne pour forcer le chauffage. Dans l'exemple ci-dessus, l'écart est de +4° (22° - 18°), donc VTherm enverra 25° (21°+4°) à l'équipement le forçant ainsi à chauffer.
Cet écart est calculé pour chaque sous-jacent car chacun à sa propre température interne. Pensez à un VTherm qui serait relié à 3 TRV chacun avec sa température interne par exemple.
On obtient alors une auto-régulation bien plus efficace qui évite l'eccueil des gros écarts de température interne défaillante.
Attention toutefois, certaines températures internes varient tellement vite et sont tellement fausses qu'elles faussent totalement le calcul. Dans ce cas, là, il vaut mieux désactiver cette option.
Vous trouverez des conseils pour régler au mieux ces paramètres dans la page auto-regulation.
Notes Il est très rare d'avoir besoin de cocher cette case. La plupart du temps, une auto-regulation permet de résoudre les cas. Les résultats sont très dépendant de l'équipement et du comportement de la température interne de l'équipement. Vous ne devriez l'utiliser que si toutes les autres méthodes ont échouées.
Fonctions spécifiques
Les fonctions spécifiques sont paramétrables avec une option dédiée du menu.
Les fonctions spécifiques qui nécessite un paramétrage à ce type de VTherm sont :
- l'auto-start/stop : arrêt et démarrage automatique du _VTherm selon la prévision d'usage. Elle est décrite ici fonction auto-start/sop,
- si la régulation par vanne est choisie, le paramétrage de l'algo TPI est accessible depuis le menu. cf (algorithmes)
- si la régulation par vanne est choisie, vous pouvez mettre le VTherm en mode dormant (sleep). Le mode dormant est un mode réservé à ce type de thermostat qui permet de couper le VTherm tout en maintenant la vanne totalement 100% ouverte. Pour appliquer le mode dormant vous avez 2 moyens :
- soit avec la VTherm UI Card en appuyant sur le bouton du mode 'Zzz',
- soit en appelant une action nommée
service_set_hvac_mode_sleep. Cf. Actions
Suivre les changements de température du sous-jacent
Certains utilisateurs veulent continuer à utiliser leur équipement comme avant (sans VTherm). Par exemple vous pouvez vouloir utiliser la télécommande de votre PAC ou tourner le bouton de votre TRV.
Si vous êtes dans ce cas, une entité a été ajoutée dans l'appareil VTherm nommée Follow underlying temp changes :

Lorsque cette entité est 'On', les changements de mode HVAC continuent d'être suivis selon le comportement existant. Le suivi des consignes est actif dès le démarrage, même si VTherm n'a encore rien envoyé au TRV. Une nouvelle consigne observée est retenue comme candidate puis appliquée si elle reste stable pendant 5 secondes ; chaque nouvelle valeur distincte relance ce délai. Les doublons ne le prolongent pas. Si VTherm a déjà envoyé une consigne, les valeurs égales ou trop proches de cette dernière sont considérées comme ambiguës et ne sont pas adoptées automatiquement. Sans consigne envoyée de référence, un ancien écho distinct peut être pris pour un geste manuel.
Attention, si vous utilisez cette fonction, votre équipement est contrôlé par deux moyens : VTherm et vous-même directement. Les ordres peuvent être contradictoires. Une consigne TRV admissible est traitée comme un changement manuel de la température cible : VTherm passe en consigne manuelle (NONE) et, si une durée de dérogation manuelle est configurée, démarre une dérogation manuelle qui revient au preset précédent à son expiration. Sans durée de dérogation manuelle, il annule le preset temporisé en cours sans restaurer l'ancienne demande. Cela ne modifie pas les priorités des fenêtres ou protections. Sous OFF, la consigne demandée est mémorisée sans rallumer le thermostat ni lever un OFF forcé.
Le suivi suspend les nouvelles commandes de température induites après trois tentatives physiques au total pour ce VTherm ; la troisième est envoyée et la quatrième est bloquée. Les commandes directes depuis VTherm restent possibles. Une nouvelle commande reçue par VTherm depuis l'interface ou un service Home Assistant réarme le compteur, même si une automatisation réagit au TRV. Une automatisation qui renvoie une commande à chaque changement peut donc le réarmer à chaque tour : la limite de trois s'applique entre commandes reçues, pas à toute cette boucle. Après un redémarrage de Home Assistant ou un rechargement de l'intégration, le compteur repart à zéro et le suivi est réarmé. Une valeur TRV restaurée sans nouveau changement observé n'est pas adoptée ; dès qu'une nouvelle consigne est rapportée, elle peut être suivie sans attendre un ordre de VTherm. Sans référence d'envoi, un ancien écho distinct peut être pris à tort pour un geste.
Un retour ancien, différent de la dernière commande, peut encore être pris à tort pour un geste manuel ; un retour ambigu peut au contraire être écarté. Le délai de 5 secondes n'établit pas l'origine d'un changement et ne garantit ni la capture de tous les gestes ni l'absence de toute boucle entretenue par une automatisation externe.
Certaines vannes (par exemple la Sonoff TRVZB) changent leur propre consigne quand VTherm les éteint. Une consigne remontée moins de 15 secondes après que VTherm a envoyé OFF à l'équipement est donc ignorée.
Certains équipements (Daikin par exemple), changent d'état tout seul. Si la case est cochée, cela peut éteindre le VTherm alors que ce n'est pas ce que vous souhaitiez. C'est pour ça qu'il est préférable de ne pas l'utiliser. Cela génère beaucoup d'incompréhensions et de nombreuses demandes de support.
Télécommande physique Si vous souhaitez utiliser un thermostat physique distinct (un thermostat mural par exemple) comme télécommande d'un VTherm, consultez le plugin VTherm climate replication.
Étape suivante
- Avec l'auto-régulation par contrôle direct de la vanne : configurez la régulation par vanne, puis les coefficients du TPI.
- Sans contrôle direct de la vanne : réglez si besoin l'auto-régulation, puis passez aux presets (menu « Pre-réglages »).
Plugin externe
Une version enrichie de l'auto-fan est disponible sous forme de plugin externe. Ce plugin offre des possibilités de configuration supplémentaires et une gestion plus fine de la ventilation automatique. Consultez la page