a0cdaa8a7f
* 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>
117 lines
6.3 KiB
Markdown
117 lines
6.3 KiB
Markdown
[![GitHub Release][releases-shield]][releases]
|
||
[![GitHub Activity][commits-shield]][commits]
|
||
[![License][license-shield]](LICENSE)
|
||
[![hacs][hacs_badge]][hacs]
|
||
[![BuyMeCoffee][buymecoffeebadge]][buymecoffee]
|
||
|
||
[En](README.md)|[Fr](README-fr.md)
|
||
|
||
|
||
>  This thermostat integration aims to greatly simplify your heating management automations. Since all typical heating events (nobody home?, activity detected in a room?, window open?, power load shedding?), are natively managed by the thermostat, you don’t need to deal with complicated scripts and automations to manage your thermostats. ;-).
|
||
|
||
This custom component for Home Assistant is an upgrade and a complete rewrite of the "Awesome thermostat" component (see [Github](https://github.com/dadge/awesome_thermostat)) with added features.
|
||
|
||
# What's new?
|
||
|
||
# What's New?
|
||
|
||
> * **Release 7.2**:
|
||
>
|
||
> - Native support for devices controlled via a `select` (or `input_select`) or `climate` entity for _VTherm_ of type `over_switch`. This update makes the creation of virtual switches obsolete for integrating Nodon, Heaty, eCosy, etc. More information [here](documentation/en/over-switch.md#command-customization).
|
||
>
|
||
> - Documentation links: Version 7.2 introduces experimental links to the documentation from the configuration pages. The link is accessible via the icon [](https://github.com/jmcollin78/versatile_thermostat/blob/main/documentation/en/over-switch.md#configuration). This feature is currently tested on some configuration pages.
|
||
|
||
# 🍻 Thanks for the beers [buymecoffee](https://www.buymeacoffee.com/jmcollin78) 🍻
|
||
A big thank you to all my beer sponsors for their donations and encouragements. It means a lot to me and motivates me to keep going! If this integration has saved you money, buy me a beer in return; I would greatly appreciate it!
|
||
|
||
# Glossary
|
||
|
||
_VTherm_: Versatile Thermostat as referred to in this document
|
||
|
||
_TRV_: Thermostatic Radiator Valve equipped with a valve. The valve opens or closes to allow hot water to pass.
|
||
|
||
_AC_: Air Conditioning. An AC device cools instead of heats. Temperatures are reversed: Eco is warmer than Comfort, which is warmer than Boost. The algorithms take this information into account.
|
||
|
||
_EMA_: Exponential Moving Average. Used to smooth sensor temperature measurements. It represents a moving average of the room's temperature and is used to calculate the slope of the temperature curve, which would be too unstable on the raw data.
|
||
|
||
_slope_: The slope of the temperature curve, measured in ° (C or K)/h. It is positive when the temperature increases and negative when it decreases. This slope is calculated based on the _EMA_.
|
||
|
||
_PAC_: Heat pump
|
||
|
||
_HA_: Home Assistant
|
||
|
||
_underlying_: the device controlled by _VTherm_
|
||
|
||
# Documentation
|
||
|
||
The documentation is now divided into several pages for easier reading and searching:
|
||
1. [Introduction](documentation/en/presentation.md),
|
||
2. [Installation](documentation/en/installation.md),
|
||
3. [Démarrage rapide](documentation/en/quick-start.md)
|
||
4. [Choosing a VTherm type](documentation/en/creation.md),
|
||
5. [Basic attributes](documentation/en/base-attributes.md)
|
||
6. [Configuring a VTherm on a `switch`](documentation/en/over-switch.md)
|
||
7. [Configuring a VTherm on a `climate`](documentation/en/over-climate.md)
|
||
8. [Configuring a VTherm on a valve](documentation/en/over-valve.md)
|
||
9. [Presets](documentation/en/feature-presets.md)
|
||
10. [Window management](documentation/en/feature-window.md)
|
||
11. [Presence management](documentation/en/feature-presence.md)
|
||
12. [Motion management](documentation/en/feature-motion.md)
|
||
13. [Power management](documentation/en/feature-power.md)
|
||
14. [Auto start and stop](documentation/en/feature-auto-start-stop.md)
|
||
15. [Centralized control of all VTherms](documentation/en/feature-central-mode.md)
|
||
16. [Central heating control](documentation/en/feature-central-boiler.md)
|
||
17. [Advanced aspects, security mode](documentation/en/feature-advanced.md)
|
||
18. [Self-regulation](documentation/en/self-regulation.md)
|
||
19. [Tuning examples](documentation/en/tuning-examples.md)
|
||
20. [Algorithms](documentation/en/algorithms.md)
|
||
21. [Reference documentation](documentation/en/reference.md)
|
||
22. [Tuning examples](documentation/en/tuning-examples.md)
|
||
23. [Troubleshooting](documentation/en/troubleshooting.md)
|
||
24. [Release notes](documentation/en/releases.md)
|
||
|
||
# Some results
|
||
|
||
**Temperature stability around the target configured by preset:**
|
||
|
||
|
||
|
||
On/off cycles calculated by the integration (`over_climate`):
|
||
|
||
|
||
**Regulation with an `over_switch`**
|
||
|
||
|
||
|
||
See the component's code [[below](#even-better-with-apex-chart-to-tune-your-thermostat)]
|
||
|
||
**Strong regulation in `over_climate`**
|
||
|
||
|
||
|
||
**Regulation with direct valve control in `over_climate`**
|
||
|
||
|
||
|
||
Enjoy!
|
||
|
||
# Contributions are welcome!
|
||
|
||
If you wish to contribute, please read the [contribution guidelines](CONTRIBUTING.md).
|
||
|
||
***
|
||
|
||
[versatile_thermostat]: https://github.com/jmcollin78/versatile_thermostat
|
||
[buymecoffee]: https://www.buymeacoffee.com/jmcollin78
|
||
[buymecoffeebadge]: https://img.shields.io/badge/Buy%20me%20a%20beer-%245-orange?style=for-the-badge&logo=buy-me-a-beer
|
||
[commits-shield]: https://img.shields.io/github/commit-activity/y/jmcollin78/versatile_thermostat.svg?style=for-the-badge
|
||
[commits]: https://github.com/jmcollin78/versatile_thermostat/commits/master
|
||
[hacs]: https://github.com/custom-components/hacs
|
||
[hacs_badge]: https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=for-the-badge
|
||
[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge
|
||
[forum]: https://community.home-assistant.io/
|
||
[license-shield]: https://img.shields.io/github/license/jmcollin78/versatile_thermostat.svg?style=for-the-badge
|
||
[maintenance-shield]: https://img.shields.io/badge/maintainer-Joakim%20Sørensen%20%40ludeeus-blue.svg?style=for-the-badge
|
||
[releases-shield]: https://img.shields.io/github/release/jmcollin78/versatile_thermostat.svg?style=for-the-badge
|
||
[releases]: https://github.com/jmcollin78/versatile_thermostat/releases
|