Documentation de Versatile Thermostat

Versatile Thermostat (VTherm) est une intégration Home Assistant qui transforme vos radiateurs électriques, pilotés par un simple interrupteur ou un module fil pilote, en thermostats intelligents : presets, détection d'ouverture, présence, délestage et régulation précise avec l'algorithme SmartPI ou TPI.

VTherm pilote aussi les pompes à chaleur, les climatisations et les vannes thermostatiques. Toutes les fonctions se configurent depuis l'interface de Home Assistant, sans script ni automatisation compliquée : la pièce est vide, une fenêtre est ouverte, la puissance disponible est dépassée ? Le thermostat le gère nativement.

Documentation de Versatile Thermostat

Exemple d'installation

Pour des radiateurs électriques :

Créez un VTherm de type over_switch pour chaque radiateur, ou pour chaque groupe de radiateurs d'une même pièce.
Pilotez le radiateur avec un interrupteur, ou avec un module fil pilote et la personnalisation des commandes. Le démarrage rapide fil pilote du site détaille la configuration pas à pas.
Choisissez l'algorithme de régulation : SmartPI (recommandé), qui apprend le comportement thermique de la pièce, ou le TPI intégré.
Ajoutez les fonctions utiles : délestage, gestion de la présence, détection d'ouverture et presets pilotés par un planificateur.

Équipements pris en charge

VTherm pilote les équipements de chauffage et de climatisation visibles dans Home Assistant :

Radiateurs électriques, commandés par un interrupteur ou par un module fil pilote : guide fil pilote,
Pompes à chaleur, climatisations et systèmes HVAC exposés par une entité climate : guide pompe à chaleur,
Radiateurs à eau équipés de vannes thermostatiques (TRV), avec ou sans pilotage direct de la vanne : guide TRV,
Vannes pilotables par une entité number, sans thermostat associé,
Poêles à granulés, avec le plugin VTherm Pellet stove : guide poêle à granulés,
Chaudière centrale : VTherm l'allume dès qu'une pièce demande de la chaleur (voir Chaudière centrale).

Le type de VTherm à créer pour chaque équipement est expliqué dans Choix du VTherm.

Prérequis

Home Assistant et l'intégration Versatile Thermostat installée depuis HACS (voir Installation),
l'équipement à piloter, visible dans Home Assistant,
un capteur de température de la pièce : n'importe quel capteur disponible dans Home Assistant convient, ou un input_number,
un capteur de température extérieure : l'intégration météo de Home Assistant suffit, et le plugin Météo-France Observation fournit une mesure précise issue des stations Météo-France.

Matériels

Les équipements de chauffage électrique testés avec VTherm (interrupteurs, modules fil pilote) sont listés dans le catalogue des matériels du site, avec leur niveau de support et des conseils de configuration. Le catalogue recense aussi les thermomètres, les vannes thermostatiques et les équipements climate.

Ce catalogue n'est pas exhaustif : un matériel qui n'y figure pas n'est pas forcément incompatible. Les matériels incompatibles et les matériels partiellement supportés y sont décrits avec leurs limitations connues.

Sommaire de la documentation

Démarrer

Installation : installer l'intégration avec HACS.
Démarrage rapide : un VTherm opérationnel en quelques étapes, selon l'équipement.
Choix du VTherm : configuration centralisée ou non, choix du type de VTherm.
Choix des attributs de base : nom, capteurs de température et fonctions à activer.

Types de VTherm

Thermostat de type over_switch : radiateurs électriques commandés par un interrupteur ou un fil pilote.
Thermostat de type over_climate : pompes à chaleur, climatisations et vannes thermostatiques exposées par une entité climate.
Thermostat de type over_valve : vannes pilotables par une entité number.

Fonctions

Confort et économies
- Les presets : températures pré-réglées (Confort, Eco, Hors-gel...).
- Preset temporisé : appliquer un preset pendant une durée donnée.
- Gestion de la présence : baisser la consigne quand personne n'est là.
- Détection de mouvement : changer de preset selon l'activité dans la pièce.
- Détection d'ouverture : réagir à l'ouverture d'une porte ou d'une fenêtre.
- Capteur d'humidité : afficher l'humidité mesurée par un capteur externe.
Pilotage de l'installation
- Gestion de la puissance (délestage) : ne pas dépasser la puissance disponible.
- Démarrage / arrêt automatique : arrêter un over_climate quand il n'est pas utile.
- Contrôle centralisé : piloter tous les VTherm en une seule fois.
- Chaudière centrale : allumer la chaudière quand un VTherm a besoin de chauffer.
- Verrouillage : empêcher les modifications depuis l'interface ou les automatisations.
Sécurité
- Configuration avancée et mode sécurité : capteur qui ne répond plus, état incohérent des équipements.
- Détection d'anomalie de chauffe : la température ne suit pas la commande.

Régulation

Les algorithmes : TPI, SmartPI et autres algorithmes disponibles en plugin.
Auto TPI : apprentissage automatique des coefficients du TPI.
- Auto TPI : guide technique
L'auto-régulation : corriger la consigne envoyée à un over_climate, ou piloter directement la vanne.
Synchronisation de la température interne : recaler le thermomètre interne de l'équipement.
Recalibrage des vannes : le service recalibrate_valves.
Exemples de réglage : des réglages commentés selon le type d'installation.

Aide et référence

Dépannages : les problèmes fréquents et leurs solutions.
Télécharger les logs : collecter des logs ciblés, puis les ouvrir dans l'analyseur de logs du site.
Documentation de référence : paramètres, capteurs, actions, événements et attributs.
Notes de versions

Aller plus loin

Quelques compléments indispensables : carte UI, planificateur, courbes, notifications.
Catalogue des plugins : algorithmes, cartes et aides pour les équipements.
Catalogue des matériels : les matériels testés et leur niveau de support.

Étape suivante

Installation : installer Versatile Thermostat dans Home Assistant.

Pour un équipement courant, le démarrage rapide résume toute la configuration sur une seule page.