* ConfigFlow (translation to change) * +1 * With implemn in thermostat_switch (not finished) * GUI fixe * +1 * Select Working * Test input in config_flow ok * documentation * Add github copilot Add first test ok for UnderlyingSwitch * All tests ok * Fix warnings * Fix All tests ok * Translations * safety * Add quick-start documentation --------- Co-authored-by: Jean-Marc Collin <jean-marc.collin-extern@renault.com>
7.6 KiB
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.
Pour que cela fonctionne, il faut le preset utiliser 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 :
- Créer un VTherm de type
over_switch. Cf. création d'un VTherm, - 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,
- Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité
selectqui contrôle le Nodon. Cf. sous-jacent, - 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 :
- Créer un VTherm de type
over_switch. Cf. création d'un VTherm, - 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,
- Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité
climatequi contrôle le Heatzy ou le eCosy. Cf. sous-jacent, - 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>ouset_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 :
- Créer un VTherm de type
over_switch. Cf. création d'un VTherm, - 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,
- Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité
switchqui 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 :
- Créer un VTherm de type
over_climate. Cf. création d'un VTherm, - 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,
- Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité
climatequi contrôle le TRV. Cf. sous-jacent, - Spécifiez la régulation de type
Par contrôle direct de la vanneuniquement. Laissez décochée l'optionCompenser la température interne du sous-jacent. Cf. sous-jacent, - Lui donner les entités de type
numbernomméesopening_degreeetcalibration offset. Ne pas renseigner l'entitéclosing degreeCf. 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é.
La suite
Uen 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 VTherms 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.