La configuration avancée

La configuration avancée

Pourquoi cette fonctionnalité ?

La configuration avancée de VTherm offre des outils essentiels pour garantir la sécurité et la fiabilité de votre système de chauffage. Ces paramètres permettent de gérer des situations où les capteurs de température ne communiquent plus correctement, ce qui pourrait conduire à des commandes dangereuses ou inefficaces.

Contexte de sécurité

L'absence d'un capteur de température ou son dysfonctionnement peut être très dangereux pour votre logement. Prenons un exemple concret :

Votre capteur de température se bloque sur une valeur de 10°
Votre VTherm de type over_climate ou over_valve détecte une température très basse
Il commande un chauffage maximal des équipements sous-jacents
Résultat : la pièce surchauffe considérablement

Les conséquences peuvent aller de simples dégâts matériels à des risques plus graves comme un début d'incendie ou une explosion (dans le cas d'un radiateur électrique défaillant).

Principe de fonctionnement du mode sécurité

Qu'est-ce que le mode sécurité ?

Le mode sécurité est un mécanisme de protection qui détecte quand les capteurs de température ne répondent plus régulièrement. Lorsqu'une absence de données est détectée, VTherm active un mode particulier qui :

Réduit le risque immédiat : le système ne commande plus une puissance maximale
Maintient une chauffe minimale : assure que le logement ne se refroidit pas complètement
Vous alerte : via un changement d'état du thermostat, visible dans Home Assistant

Cas d'application

Le mode sécurité se déclenche quand :

Température interne manquante : aucune mesure reçue depuis le délai maximal configuré
Température externe manquante : aucune mesure reçue depuis le délai maximal configuré (optionnel)
Capteur bloqué : le capteur n'envoie plus de changement de valeur (comportement typique des capteurs à pile)

Un défi particulier vient des capteurs à pile qui n'envoient leurs données que lorsqu'une valeur change. Il est donc possible de ne recevoir aucune mise à jour pendant plusieurs heures sans que le capteur soit réellement en défaut. C'est pourquoi les paramètres sont configurables pour adapter la détection à votre configuration.

Limitations

VTherm de type over_climate régulé en interne : le mode sécurité est automatiquement désactivé. En effet, il n'y a pas de risque de danger si l'équipement se régule lui-même (il maintient sa propre température). Le seul risque est une température inconfortable, pas un danger physique.

Configuration

Pour configurer les paramètres avancés de sécurité :

Ouvrez la configuration de votre VTherm
Accédez aux paramètres de configuration générale
Déroulez jusqu'à la section "Configuration avancée"

Le formulaire de configuration avancée est le suivant :

Conseil

Si votre thermomètre est muni d'un attribut last_seen ou similaire qui donne l'heure de son dernier contact, configurez cet attribut dans les sélections principales du VTherm. Cela améliore considérablement la détection et réduit les fausses alertes. Consultez la configuration des attributs de base et le dépannage pour plus de détails.

Paramètres de sécurité

Paramètre	Description	Valeur par défaut	Nom d'attribut
Délai maximal avant mise en sécurité	Délai maximum autorisé entre deux mesures de température avant que le VTherm passe en mode sécurité. Si aucune nouvelle mesure n'est reçue après ce délai, le mode sécurité s'active.	60 minutes	`safety_delay_min`
Seuil d'`on_percent` minimum pour la sécurité	Pourcentage minimum de `on_percent` en dessous duquel le mode sécurité ne s'activate pas. Cela évite d'activer le mode sécurité quand le radiateur fonctionne très peu (`on_percent` bas), car il n'y a pas de risque immédiat de surchauffe. `0.00` active toujours le mode, `1.00` le désactive complètement.	0.5 (50%)	`safety_min_on_percent`
Valeur d'`on_percent` par défaut en mode sécurité	La puissance de chauffage utilisée quand le thermostat est en mode sécurité. `0` arrête complètement le chauffage (risque de gel), `0.1` maintient un chauffage minimal pour éviter la congélation en cas de défaillance prolongée du thermomètre.	0.1 (10%)	`safety_default_on_percent`

Attributs exposés

Quand le mode sécurité est actif, les VTherm exposent les attributs suivants :

safety_mode: "on"                # "on" ou "off"
safety_delay_min: 60             # Délai configuré en minutes
safety_min_on_percent: 0.5       # Seuil d'on_percent (0.0 à 1.0)
safety_default_on_percent: 0.1   # Puissance en mode sécurité (0.0 à 1.0)
last_safety_event: "2024-03-20 14:30:00"  # Heure du dernier événement

Actions disponibles

Une action VTherm permet de reconfigurer dynamiquement les 3 paramètres de sécurité sans redémarrer Home Assistant :

Service : versatile_thermostat.set_safety_parameters
Paramètres :
- entity_id : le VTherm à reconfigurer
- safety_delay_min : nouveau délai (minutes)
- safety_min_on_percent : nouveau seuil (0.0 à 1.0)
- safety_default_on_percent : nouvelle puissance (0.0 à 1.0)

Cela permet d'adapter dynamiquement la sensibilité du mode sécurité selon votre usage (par exemple, réduire le délai quand les gens sont à la maison, l'augmenter quand le logement est inoccupé).

Configuration avancée globale

Il est possible de désactiver la vérification du capteur de température extérieur pour la mise en sécurité. En effet, le capteur extérieur impacte généralement peu la régulation (selon votre paramètrage) et peut être absent sans mettre en danger le logement.

Pour cela, ajoutez les lignes suivantes dans votre configuration.yaml :

versatile_thermostat:
  safety_mode:
    check_outdoor_sensor: false

Important

Cette modification est commune à tous les VTherm du système

Elle affecte la détection du thermomètre extérieur pour tous les thermostats

Home Assistant doit être redémarré pour que les changements prennent effet

Par défaut, le thermomètre extérieur peut bien déclencher une mise en sécurité s'il n'envoie plus de données

Conseils pratiques

Notes et bonnes pratiques

Restauration après correction : Lorsque le capteur de température reviendra à la vie et enverra à nouveau des données, le mode de préréglage sera restauré à sa valeur précédente.
Deux températures requises : Le système a besoin de la température interne ET de la température externe pour fonctionner correctement. Si l'une des deux manque, le thermostat passera en mode sécurité.
Relation entre les paramètres : Pour un fonctionnement naturel, la valeur safety_default_on_percent devrait être inférieure à safety_min_on_percent. Par exemple : safety_min_on_percent = 0.5 et safety_default_on_percent = 0.1.
Adaptation à votre capteur :
- Si vous avez des fausses alertes, augmentez le délai (safety_delay_min) ou réduisez safety_min_on_percent
- Si vous avez des capteurs à pile, augmentez le délai davantage (ex: 2-4 heures)
- Si vous utilisez l'attribut last_seen, le délai peut être réduit (le système est plus précis)
Visualisation dans l'UI : Si vous utilisez la carte Versatile Thermostat UI, un VTherm en mode sécurité est signalé visuellement par :
- Un voile grisâtre sur le thermostat
- L'affichage du capteur défaillant
- Le temps écoulé depuis la dernière mise à jour
.

Réparer l'état incorrect des équipements

Pourquoi cette fonctionnalité ?

Lors de l'utilisation d'un VTherm avec des équipements de chauffage (over_switch, over_valve, over_climate, over_climate_valve), il peut arriver que l'équipement ne suive pas correctement la commande envoyée par le thermostat. Par exemple :

Un relais bloqué qui ne bascule pas à l'état commandé
Une vanne thermostatique qui n'obéit pas aux commandes
Une perte de communication temporaire avec l'équipement
Un équipement qui met trop de temps à réagir

La fonctionnalité "Reparer l'état incorrect" détecte ces situations et re-envoie automatiquement la commande pour synchroniser l'état réel avec l'état désiré.

Cas d'usage

Cette fonctionnalité est particulièrement utile pour :

Relais instables : les relais qui collent ou ne basculent pas toujours correctement
Communication Zigbee/WiFi intermittente : les équipements qui perdent occasionnellement la connexion
Vannes lentes : les vannes thermostatiques qui prennent du temps à réagir aux commandes
Équipements défaillants : les radiateurs électriques ou vannes qui ne répondent plus aux commandes
PAC : pour s'assurer que la PAC exécute bien les commandes de chauffage/climatisation

Principe de fonctionnement

À chaque cycle de contrôle du thermostat, la fonctionnalité :

Compare les états : vérifie que l'état réel de chaque équipement correspond à ce qui a été commandé
Détecte les discordances : si l'équipement n'a pas suivi la commande, c'est une discordance
Re-envoie la commande : si une discordance est détectée, renvoi la commande pour synchroniser l'état
Compte les tentatives : le nombre de réparations consécutives est limité pour éviter les boucles infinies
Contrôle le délai d'activation : la fonctionnalité ne s'active qu'après un délai minimum pour laisser les équipements finir leur initialisation

Configuration

Cette fonctionnalité se configure dans l'interface de configuration du VTherm :

Ouvrez la configuration de votre VTherm
Accédez aux paramètres de configuration générale
Déroulez jusqu'à la section "Configuration avancée"
Activez l'option "Reparer l'état incorrect des équipements"

Paramètres

Paramètre	Description	Valeur par défaut
Reparer l'état incorrect	Active ou désactive la détection et réparation automatique des discordances d'état. Quand activée, chaque discordance détectée provoque un re-envoi de la commande.	Désactivé

Paramètres système internes

Certains paramètres sont configurés au niveau système et ne peuvent pas être modifiés :

Délai minimum avant activation : 30 secondes après le démarrage du thermostat (permet à tous les équipements de s'initialiser)

Nombre maximal de tentatives consécutives : 5 réparations consécutives avant d'arrêter temporairement

Délai de réinitialisation : le compteur de réparations se réinitialise une fois que les équipements reviennent à l'état correct

Attributs exposés

Quand la fonctionnalité de réparation est activée, les VTherm exposent l'attribut suivant :

repair_incorrect_state_manager:
  consecutive_repair_count: 2       # Nombre de réparations consécutives effectuées
  max_attempts: 5                  # Plafond avant arrêt temporaire
  min_delay_after_init_sec: 30     # Délai minimum avant activation
is_repair_incorrect_state_configured: true  # Statut de la fonctionnalité

Le compteur consecutive_repair_count vous permet de :

Diagnostiquer les problèmes matériels fréquents
Identifier les équipements défaillants
Surveiller la stabilité de votre installation

Limitations et sécurité

Important

Pas de modification du comportement : Cette fonctionnalité ne change pas la logique de chauffage. Elle se contente de s'assurer que vos commandes sont bien exécutées.
Plafond de sécurité : Le nombre maximal de tentatives consécutives (5) évite les boucles infinies. Si ce plafond est atteint, un message d'erreur est enregistré et les réparations s'arrêtent temporairement.
Délai de démarrage : La fonctionnalité n'est active qu'après 30 secondes pour laisser tous les équipements le temps de s'initialiser complètement.
Applicable à tous les types de VTherm : Cette fonctionnalité fonctionne pour tous les types over_switch, over_valve, over_climate et over_climate_valve (les over_climate avec régulation par contrôle direct de la vanne). Pour ces derniers, l'état du climate sous-jacent est vérifié mais aussi l'état d'ouverture de la vanne.
Symptômes de suractivité : Si vous voyez régulièrement des messages d'avertissement indiquant une réparation, cela signifie qu'il y a un problème matériel :
- Vérifiez la connexion de l'équipement
- Vérifiez la stabilité de votre réseau (Zigbee/WiFi)
- Testez l'équipement manuellement via Home Assistant
- Envisagez un remplacement si le problème persiste
Réinitialisation du compteur : Le compteur se réinitialise automatiquement dès que les équipements reprennent l'état correct, permettant de nouvelles tentatives en cas de problème récurrent.
Relance régulière : après 5 tentatives de réparation échouées, la réparation se met en pause pour éviter les boucles infinies. Elle reprend après 10 cycles sans réparation, permettant de nouvelles tentatives en cas de problème intermittent.