Documentation 3

README-fr.md

@@ -118,32 +118,6 @@ La documentation est maintenant découpée en plusieurs pages pour faciliter la
 6. Redémarrez l'assistant domestique
 7. Configurer la nouvelle intégration du Versatile Thermostat
 
-
-
-
-
-
-
-
-
-#### Le démarrage / arrêt automatique
-Cette fonction a été introduite en 6.5.0. Elle permet d'autoriser VTherm a stopper un équipement qui n'a pas besoin d'être allumé et de le redémarrer lorsque les conditions le réclame. Cette fonction est munie de 3 réglages qui permettent d'arrêter / relancer plus ou moins rapidement l'équipement.
-
-Pour l'utiliser, vous devez :
-1. Ajouter la fonction `Avec démmarrage et extinction automatique` dans le menu 'Fonctions',
-2. Paramétrer le niveau de détection dans l'option 'Allumage/extinction automatique' qui s'affiche lorsque la fonction a été activée. Vous choisissez le niveau de détection entre 'Lent', 'Moyen' et 'Rapide'. Les arrêts/relances seront plus nombreux avec le niveau 'Rapide'.
-
-Une fois paramétré, vous aurez maintenant une nouvelle entité de type `switch` qui vous permet d'autoriser ou non l'arrêt/relance automatique sans toucher à la configuration. Cette entité est disponible sur l'appareil VTherm et se nomme `switch.<name>_enable_auto_start_stop`. Cochez la pour autoriser le démarrage et extinction automatique.
-
-L'algorithme de détection est décrit [ici](https://github.com/jmcollin78/versatile_thermostat/issues/585).
-
-### Pour un thermostat de type ```thermostat_over_valve```:
-![image](images/config-linked-entity3.png)
-Vous pouvez choisir jusqu'à entité du domaine ```number``` ou ```ìnput_number``` qui vont commander les vannes.
-L'algorithme à utiliser est aujourd'hui limité à TPI est disponible. Voir [algorithme](#algorithme).
-
-Il est possible de choisir un thermostat over valve qui commande une climatisation en cochant la case "AC Mode". Dans ce cas, seul le mode refroidissement sera visible.
-
 ## Configurez les coefficients de l'algorithme TPI
 
 Si vous avez choisi un thermostat de type ```over_switch``` ou  ```over_valve``` et que vous sélectionnez l'option "TPI" vous menu, vous arriverez sur cette page :

documentation/fr/feature-auto-start-stop.md

@@ -0,0 +1,10 @@
+#### Le démarrage / arrêt automatique
+Cette fonction a été introduite en 6.5.0. Elle permet d'autoriser VTherm a stopper un équipement qui n'a pas besoin d'être allumé et de le redémarrer lorsque les conditions le réclame. Cette fonction est munie de 3 réglages qui permettent d'arrêter / relancer plus ou moins rapidement l'équipement.
+
+Pour l'utiliser, vous devez :
+1. Ajouter la fonction `Avec démmarrage et extinction automatique` dans le menu 'Fonctions',
+2. Paramétrer le niveau de détection dans l'option 'Allumage/extinction automatique' qui s'affiche lorsque la fonction a été activée. Vous choisissez le niveau de détection entre 'Lent', 'Moyen' et 'Rapide'. Les arrêts/relances seront plus nombreux avec le niveau 'Rapide'.
+
+Une fois paramétré, vous aurez maintenant une nouvelle entité de type `switch` qui vous permet d'autoriser ou non l'arrêt/relance automatique sans toucher à la configuration. Cette entité est disponible sur l'appareil VTherm et se nomme `switch.<name>_enable_auto_start_stop`. Cochez la pour autoriser le démarrage et extinction automatique.
+
+L'algorithme de détection est décrit [ici](https://github.com/jmcollin78/versatile_thermostat/issues/585).

documentation/fr/over-climate.md

@@ -1,4 +1,4 @@
-# Thermostat de type ```thermostat_over_climate```
+# Thermostat de type `thermostat_over_climate`
 
 ## Pré-requis
 
@@ -68,3 +68,11 @@ On obtient alors une auto-régulation bien plus efficace qui évite l'eccueil de
 Attention toutefois, certaine température interne varient tellement vite et sont tellement fausse 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 (TODO optimiser)
+
+## 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 :
+1. 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](feature-auto-start-stop.md),
+2. si la régulation par vanne est choisie, le paramétrage de l'algo TPI est accessible depuis le menu. cf (TODO TPI)

documentation/fr/over-switch.md

@@ -7,11 +7,12 @@ L'installation doit ressembler à ça :
 
 1. L'utilisateur ou une automatisation ou le Sheduler programme une consigne (setpoint) par le biais d'un pre-réglage ou directement d'une température,
 2. régulièrement le thermomètre intérieur (2) ou extérieur (2b) envoie la température mesurée. Le thermomètre interieur 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 du radiateur,
-3. avec les valeurs de consigne, des différents et des paramètres de l'algorithme TPI (cf. TODO), VTherm va calculer un pourcentage de temps d'allumage,
+3. avec les valeurs de consigne, les différentes températures et des paramètres de l'algorithme TPI (cf. TODO), VTherm va calculer un pourcentage de temps d'allumage,
 4. et va régulièrement commander l'allumage et l'extinction du ou des entités `switch` sous-jacentes,
 5. ces entités switchs sous-jacentes vont alors commander le switch physique
 6. la commande du switch physique allumera ou éteindra le radiateur.
 
+Le pourcentage d'allumage est recalculé à chaque cycle et c'est ce qui permet de réguler la température de la pièce.
 
 ## Configuration
 

documentation/fr/over-valve.md

@@ -0,0 +1,36 @@
+# Thermostat de type `thermostat_over_valve`
+
+> ![Attention](images/tips.png) _*Notes*_
+> 1. Le type `over_valve` est souvent confondu avec le type `over_climate` équipé d'une auto-régulation avec pilotage direct de la vanne,
+> 2. vous ne devriez choisir ce type que lorsque vous n'avez pas d'entité `climate` associé à votre _TRV_ dans Home Assistant et si vous avez juste une entité de type `number` qui permet le contrôle du pourcentage d'ouverture de la vanne. Le `over_climate` avec auto-régulation sur la vanne est bien plus puissant que le type `over_valve`.
+
+
+## Pré-requis
+
+L'installation doit ressembler à celle pour le VTherm `over_switch` sauf que l'équipement contrôlé est directement la vanne d'un _TRV_  :
+![installation `over_valve`](images/over-valve-schema.png)
+
+1. L'utilisateur ou une automatisation ou le Sheduler programme une consigne (setpoint) par le biais d'un pre-réglage ou directement d'une température,
+2. 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,
+3. avec les valeurs de consigne, les différentes températures et des paramètres de l'algorithme TPI (cf. TODO), VTherm va calculer un pourcentage d'ouverture de la vanne,
+4. et va modifier la valeur des entités `number` sous-jacentes,
+5. ces entités `number` sous-jacentes vont alors commander le taux d'ouverture de la vanne sur le _TRV_
+6. ce qui va faire chauffer plus ou moins le radiateur
+
+Le taux d'ouverture est recalculé à chaque cycle et c'est ce qui permet de réguler la température de la pièce.
+
+
+## Configuration
+
+Cliquer sur l'option de menu "Sous-jacents" et vous allez avoir cette page de configuration :
+![image](images/config-linked-entity2.png)
+
+### les sous-jacents
+Dans la "liste des équipements à contrôler" vous mettez les entités `climate` qui vont être controllés par le VTherm. Seuls les entités de type `climate` sont acceptées.
+
+![image](images/config-linked-entity3.png)
+Vous pouvez choisir jusqu'à entité du domaine ```number``` ou ```ìnput_number``` qui vont commander les vannes.
+L'algorithme à utiliser est aujourd'hui limité à TPI est disponible. Voir [algorithme](#algorithme).
+
+Il est possible de choisir un thermostat over valve qui commande une climatisation en cochant la case "AC Mode". Dans ce cas, seul le mode refroidissement sera visible.
+