Skip to content

Commit 35ee414

Browse files
author
Jean-Marc Collin
committed
Update README
1 parent 7f63503 commit 35ee414

File tree

5 files changed

+157
-95
lines changed

5 files changed

+157
-95
lines changed

.devcontainer/devcontainer.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,8 @@
2929
"donjayamanne.githistory",
3030
"waderyan.gitblame",
3131
"keesschollaart.vscode-home-assistant",
32-
"vscode.markdown-math"
32+
"vscode.markdown-math",
33+
"yzhang.markdown-all-in-one"
3334
],
3435
// "mounts": [
3536
// "source=${localWorkspaceFolder}/.devcontainer/configuration.yaml,target=${localWorkspaceFolder}/config/www/community/,type=bind,consistency=cached",

README-fr.md

Lines changed: 77 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
- [Pour un thermostat de type ```thermostat_over_climate```:](#pour-un-thermostat-de-type-thermostat_over_climate)
2424
- [L'auto-régulation](#lauto-régulation)
2525
- [L'auto-régulation en mode Expert](#lauto-régulation-en-mode-expert)
26+
- [Le mode auto-fan](#le-mode-auto-fan)
2627
- [Pour un thermostat de type ```thermostat_over_valve```:](#pour-un-thermostat-de-type-thermostat_over_valve)
2728
- [Configurez les coefficients de l'algorithme TPI](#configurez-les-coefficients-de-lalgorithme-tpi)
2829
- [Configurer la température préréglée](#configurer-la-température-préréglée)
@@ -55,7 +56,7 @@
5556
- [Bien mieux avec le Versatile Thermostat UI Card](#bien-mieux-avec-le-versatile-thermostat-ui-card)
5657
- [Encore mieux avec le composant Scheduler !](#encore-mieux-avec-le-composant-scheduler-)
5758
- [Encore bien mieux avec la custom:simple-thermostat front integration](#encore-bien-mieux-avec-la-customsimple-thermostat-front-integration)
58-
- [Toujours mieux avec Apex-chart pour régler votre thermostat](#toujours-mieux-avec-apex-chart-pour-régler-votre-thermostat)
59+
- [Toujours mieux avec Plotly pour régler votre thermostat](#toujours-mieux-avec-plotly-pour-régler-votre-thermostat)
5960
- [Et toujours de mieux en mieux avec l'AappDaemon NOTIFIER pour notifier les évènements](#et-toujours-de-mieux-en-mieux-avec-laappdaemon-notifier-pour-notifier-les-évènements)
6061
- [Les contributions sont les bienvenues !](#les-contributions-sont-les-bienvenues)
6162
- [Dépannages](#dépannages)
@@ -68,6 +69,7 @@ Ce composant personnalisé pour Home Assistant est une mise à niveau et est une
6869

6970

7071
> ![Nouveau](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/new-icon.png?raw=true) _*Nouveautés*_
72+
> * **Release 4.3** : Ajout d'un mode auto-fan pour le type `over_climate` permettant d'activer la ventilation si l'écart de température est important [#223](https://github.com/jmcollin78/versatile_thermostat/issues/223).
7173
> * **Release 4.2** : Le calcul de la pente de la courbe de température se fait maintenant en °/heure et non plus en °/min [#242](https://github.com/jmcollin78/versatile_thermostat/issues/242). Correction de la détection automatique des ouvertures par l'ajout d'un lissage de la courbe de température .
7274
> * **Release 4.1** : Ajout d'un mode de régulation **Expert** dans lequel l'utilisateur peut spécifier ses propres paramètres d'auto-régulation au lieu d'utiliser les pre-programmés [#194](https://github.com/jmcollin78/versatile_thermostat/issues/194).
7375
> * **Release 4.0** : Ajout de la prise en charge de la **Versatile Thermostat UI Card**. Voir [Versatile Thermostat UI Card](https://github.com/jmcollin78/versatile-thermostat-ui-card). Ajout d'un mode de régulation **Slow** pour les appareils de chauffage à latence lente [#168](https://github.com/jmcollin78/versatile_thermostat/issues/168). Changement de la façon dont **la puissance est calculée** dans le cas de VTherm avec des équipements multi-sous-jacents [#146](https://github.com/jmcollin78/versatile_thermostat/issues/146). Ajout de la prise en charge de AC et Heat pour VTherm via un interrupteur également [#144](https://github.com/jmcollin78/versatile_thermostat/pull/144)
@@ -315,6 +317,15 @@ et bien sur, configurer le mode auto-régulation du VTherm en mode Expert. Tous
315317

316318
Pour que les modifications soient prises en compte, il faut soit **relancer totalement Home Assistant** soit juste l'intégration Versatile Thermostat (Outils de dev / Yaml / rechargement de la configuration / Versatile Thermostat).
317319

320+
321+
#### Le mode auto-fan
322+
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.
323+
Vous pouvez choisir quelle ventilation vous voulez activer entre les paramètres suivants : Faible, Moyenne, Forte, Turbo.
324+
325+
Il faut évidemment que votre équipement sous-jacent soit équipée d'une ventilation et quelle soit pilotable pour que cela fonctionne.
326+
Si votre équipement ne comprend pas le mode Turbo, le mode Forte` sera utilisé en remplacement.
327+
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)`, `Auto (auto)`, `Faible (low)`. La première valeur qui est possible pour votre équipement sera choisie.
328+
318329
### Pour un thermostat de type ```thermostat_over_valve```:
319330
![image](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/config-linked-entity3.png?raw=true)
320331
Vous pouvez choisir jusqu'à entité du domaine ```number``` ou ```ìnput_number``` qui vont commander les vannes.
@@ -902,53 +913,73 @@ Vous pouvez personnaliser ce composant à l'aide du composant HACS card-mod pour
902913
```
903914
![image](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/custom-css-thermostat.png?raw=true)
904915

905-
## Toujours mieux avec Apex-chart pour régler votre thermostat
906-
Vous pouvez obtenir une courbe comme celle présentée dans [some results](#some-results) avec une sorte de configuration de graphique Apex uniquement en utilisant les attributs personnalisés du thermostat décrits [ici](#custom-attributes) :
916+
## Toujours mieux avec Plotly pour régler votre thermostat
917+
Vous pouvez obtenir une courbe comme celle présentée dans [some results](#some-results) avec une sorte de configuration de graphique Plotly uniquement en utilisant les attributs personnalisés du thermostat décrits [ici](#custom-attributes) :
907918

919+
Remplacez les valeurs entre [[ ]] par les votres.
908920
```
909-
type: custom:apexcharts-card
910-
header:
911-
show: true
912-
title: Tuning chauffage
913-
show_states: true
914-
colorize_states: true
915-
update_interval: 60sec
916-
graph_span: 4h
917-
yaxis:
918-
- id: left
919-
show: true
920-
decimals: 2
921-
- id: right
922-
decimals: 2
923-
show: true
924-
opposite: true
925-
series:
926-
- entity: climate.thermostat_mythermostat
927-
attribute: temperature
928-
type: line
929-
name: Target temp
930-
curve: smooth
931-
yaxis_id: left
932-
- entity: climate.thermostat_mythermostat
933-
attribute: current_temperature
934-
name: Current temp
935-
curve: smooth
936-
yaxis_id: left
937-
- entity: climate.thermostat_mythermostat <--- for over_switch
938-
attribute: on_percent
939-
name: Power percent
940-
curve: stepline
941-
yaxis_id: right
942-
- entity: climate.thermostat_mythermostat <--- for over_thermostast
943-
attribute: regulated_target_temperature
944-
name: Regulated temperature
945-
curve: stepline
946-
yaxis_id: left
947-
- entity: climate.thermostat_mythermostat <--- for over_valve
948-
attribute: valve_open_percent
949-
name: Valve open percent
950-
curve: stepline
951-
yaxis_id: right
921+
- type: custom:plotly-graph
922+
entities:
923+
- entity: '[[climate]]'
924+
attribute: temperature
925+
yaxis: y1
926+
name: Consigne
927+
- entity: '[[climate]]'
928+
attribute: current_temperature
929+
yaxis: y1
930+
name: T°
931+
- entity: '[[climate]]'
932+
attribute: ema_temp
933+
yaxis: y1
934+
name: Ema
935+
- entity: '[[climate]]'
936+
attribute: regulated_target_temperature
937+
yaxis: y1
938+
name: Regulated T°
939+
- entity: '[[slope]]'
940+
name: Slope
941+
fill: tozeroy
942+
yaxis: y9
943+
fillcolor: rgba(100, 100, 100, 0.3)
944+
line:
945+
color: rgba(100, 100, 100, 0.9)
946+
hours_to_show: 4
947+
refresh_interval: 10
948+
height: 800
949+
config:
950+
scrollZoom: true
951+
layout:
952+
margin:
953+
r: 50
954+
legend:
955+
x: 0
956+
'y': 1.2
957+
groupclick: togglegroup
958+
title:
959+
side: top right
960+
yaxis:
961+
visible: true
962+
position: 0
963+
yaxis9:
964+
visible: true
965+
fixedrange: false
966+
range:
967+
- -0.5
968+
- 0.5
969+
position: 1
970+
xaxis:
971+
rangeselector:
972+
'y': 1.1
973+
x: 0.7
974+
buttons:
975+
- count: 1
976+
step: hour
977+
- count: 12
978+
step: hour
979+
- count: 1
980+
step: day
981+
- count: 7
982+
step: day
952983
```
953984

954985
## Et toujours de mieux en mieux avec l'AappDaemon NOTIFIER pour notifier les évènements

README.md

Lines changed: 77 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
- [For a thermostat of type ```thermostat_over_climate```:](#for-a-thermostat-of-type-thermostat_over_climate)
2424
- [Self-regulation](#self-regulation)
2525
- [Self-regulation in Expert mode](#self-regulation-in-expert-mode)
26+
- [Auto-fan mode](#auto-fan-mode)
2627
- [For a thermostat of type ```thermostat_over_valve```:](#for-a-thermostat-of-type-thermostat_over_valve)
2728
- [Configure the TPI algorithm coefficients](#configure-the-tpi-algorithm-coefficients)
2829
- [Configure the preset temperature](#configure-the-preset-temperature)
@@ -54,7 +55,7 @@
5455
- [Much better with the Veersatile Thermostat UI Card](#much-better-with-the-veersatile-thermostat-ui-card)
5556
- [Even Better with Scheduler Component !](#even-better-with-scheduler-component-)
5657
- [Even-even better with custom:simple-thermostat front integration](#even-even-better-with-customsimple-thermostat-front-integration)
57-
- [Even better with Apex-chart to tune your Thermostat](#even-better-with-apex-chart-to-tune-your-thermostat)
58+
- [Even better with Plotly to tune your Thermostat](#even-better-with-plotly-to-tune-your-thermostat)
5859
- [And always better and better with the NOTIFIER daemon app to notify events](#and-always-better-and-better-with-the-notifier-daemon-app-to-notify-events)
5960
- [Contributions are welcome!](#contributions-are-welcome)
6061
- [Troubleshooting](#troubleshooting)
@@ -67,7 +68,8 @@
6768
This custom component for Home Assistant is an upgrade and is a complete rewrite of the component "Awesome thermostat" (see [Github](https://github.com/dadge/awesome_thermostat)) with addition of features.
6869

6970
>![New](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/new-icon.png?raw=true) _*News*_
70-
> * **Release 4.2**: The calculation of the slope of the temperature curve is now done in °/hour and no longer in °/min [#242](https://github.com/jmcollin78/versatile_thermostat/ issues/242). Correction of automatic detection of openings by adding smoothing of the temperature curve.
71+
> * **Release 4.3**: Added an auto-fan mode for the `over_climate` type allowing ventilation to be activated if the temperature difference is significant [#223](https://github.com/jmcollin78/versatile_thermostat/issues/223).
72+
> * **Release 4.2**: The calculation of the slope of the temperature curve is now done in °/hour and no longer in °/min [#242](https://github.com/jmcollin78/versatile_thermostat/issues/242). Correction of automatic detection of openings by adding smoothing of the temperature curve.
7173
> * **Release 4.1**: Added an **Expert** regulation mode in which the user can specify their own auto-regulation parameters instead of using the pre-programmed ones [#194]( https://github.com/jmcollin78/versatile_thermostat/issues/194).
7274
> * **Release 4.0**: Added the support of **Versatile Thermostat UI Card**. See [Versatile Thermostat UI Card](https://github.com/jmcollin78/versatile-thermostat-ui-card). Added a **Slow** regulation mode for slow latency heating devices [#168](https://github.com/jmcollin78/versatile_thermostat/issues/168). Change the way **the power is calculated** in case of VTherm with multi-underlying equipements [#146](https://github.com/jmcollin78/versatile_thermostat/issues/146). Added the support of AC and Heat for VTherm over switch alse [#144](https://github.com/jmcollin78/versatile_thermostat/pull/144)
7375
> * **Release 3.8**: Added a **self-regulation function** for `over climate` thermostats whose regulation is done by the underlying climate. See [Self-regulation](#self-regulation) and [#129](https://github.com/jmcollin78/versatile_thermostat/issues/129). Added the possibility of **inverting the command** for an `over switch` thermostat to address installations with pilot wire and diode [#124](https://github.com/jmcollin78/versatile_thermostat/issues/124).
@@ -311,6 +313,14 @@ and of course, configure the VTherm's self-regulation mode in **Expert** mode. A
311313

312314
For the changes to be taken into account, you must either **completely restart Home Assistant** or just the **Versatile Thermostat integration** (Dev tools / Yaml / reloading the configuration / Versatile Thermostat).
313315

316+
#### Auto-fan mode
317+
This mode introduced in 4.3 makes it possible to force the use of ventilation if the temperature difference is significant. In fact, by activating ventilation, distribution occurs more quickly, which saves time in reaching the target temperature.
318+
You can choose which ventilation you want to activate between the following settings: Low, Medium, High, Turbo.
319+
320+
Obviously your underlying equipment must be equipped with ventilation and be controllable for this to work.
321+
If your equipment does not include Turbo mode, Forte` mode will be used as a replacement.
322+
Once the temperature difference becomes low again, the ventilation will go into a "normal" mode which depends on your equipment, namely (in order): `Silence (mute)`, `Auto (auto)`, `Low (low)`. The first value that is possible for your equipment will be chosen.
323+
314324
### For a thermostat of type ```thermostat_over_valve```:
315325
![image](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/config-linked-entity3.png?raw=true)
316326
You can choose up to domain entity ```number``` or ```ìnput_number``` which will control the valves.
@@ -884,53 +894,73 @@ You can customize this component using the HACS card-mod component to adjust the
884894
```
885895
![image](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/custom-css-thermostat.png?raw=true)
886896

887-
## Even better with Apex-chart to tune your Thermostat
888-
You can get curve like presented in [some results](#some-results) with kind of Apex-chart configuration only using the custom attributes of the thermostat described [here](#custom-attributes):
897+
## Even better with Plotly to tune your Thermostat
898+
You can get curve like presented in [some results](#some-results) with kind of Plotly configuration only using the custom attributes of the thermostat described [here](#custom-attributes):
889899

900+
Replace values in [[ ]] by yours.
890901
```
891-
type: custom:apexcharts-card
892-
header:
893-
show: true
894-
title: Tuning chauffage
895-
show_states: true
896-
colorize_states: true
897-
update_interval: 60sec
898-
graph_span: 4h
899-
yaxis:
900-
- id: left
901-
show: true
902-
decimals: 2
903-
- id: right
904-
decimals: 2
905-
show: true
906-
opposite: true
907-
series:
908-
- entity: climate.thermostat_mythermostat
909-
attribute: temperature
910-
type: line
911-
name: Target temp
912-
curve: smooth
913-
yaxis_id: left
914-
- entity: climate.thermostat_mythermostat
915-
attribute: current_temperature
916-
name: Current temp
917-
curve: smooth
918-
yaxis_id: left
919-
- entity: climate.thermostat_mythermostat <--- for over_switch
920-
attribute: on_percent
921-
name: Power percent
922-
curve: stepline
923-
yaxis_id: right
924-
- entity: climate.thermostat_mythermostat <--- for over_thermostast
925-
attribute: regulated_target_temperature
926-
name: Regulated temperature
927-
curve: stepline
928-
yaxis_id: left
929-
- entity: climate.thermostat_mythermostat <--- for over_valve
930-
attribute: valve_open_percent
931-
name: Valve open percent
932-
curve: stepline
933-
yaxis_id: right
902+
- type: custom:plotly-graph
903+
entities:
904+
- entity: '[[climate]]'
905+
attribute: temperature
906+
yaxis: y1
907+
name: Consigne
908+
- entity: '[[climate]]'
909+
attribute: current_temperature
910+
yaxis: y1
911+
name: T°
912+
- entity: '[[climate]]'
913+
attribute: ema_temp
914+
yaxis: y1
915+
name: Ema
916+
- entity: '[[climate]]'
917+
attribute: regulated_target_temperature
918+
yaxis: y1
919+
name: Regulated T°
920+
- entity: '[[slope]]'
921+
name: Slope
922+
fill: tozeroy
923+
yaxis: y9
924+
fillcolor: rgba(100, 100, 100, 0.3)
925+
line:
926+
color: rgba(100, 100, 100, 0.9)
927+
hours_to_show: 4
928+
refresh_interval: 10
929+
height: 800
930+
config:
931+
scrollZoom: true
932+
layout:
933+
margin:
934+
r: 50
935+
legend:
936+
x: 0
937+
'y': 1.2
938+
groupclick: togglegroup
939+
title:
940+
side: top right
941+
yaxis:
942+
visible: true
943+
position: 0
944+
yaxis9:
945+
visible: true
946+
fixedrange: false
947+
range:
948+
- -0.5
949+
- 0.5
950+
position: 1
951+
xaxis:
952+
rangeselector:
953+
'y': 1.1
954+
x: 0.7
955+
buttons:
956+
- count: 1
957+
step: hour
958+
- count: 12
959+
step: hour
960+
- count: 1
961+
step: day
962+
- count: 7
963+
step: day
934964
```
935965

936966
## And always better and better with the NOTIFIER daemon app to notify events

custom_components/versatile_thermostat/const.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -263,7 +263,7 @@
263263
ATTR_MEAN_POWER_CYCLE = "mean_cycle_power"
264264

265265
AUTO_FAN_DTEMP_THRESHOLD = 2
266-
AUTO_FAN_DEACTIVATED_MODES = ["mute", "silent", "auto", "low"]
266+
AUTO_FAN_DEACTIVATED_MODES = ["mute", "auto", "low"]
267267

268268

269269
# A special regulation parameter suggested by @Maia here: https://github.com/jmcollin78/versatile_thermostat/discussions/154

images/config-linked-entity2.png

-6.25 KB
Loading

0 commit comments

Comments
 (0)