[![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) ![Tip](images/icon.png) > ![Tip](images/tips.png) 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? ![New](images/new-icon.png) # What's New? ![New](images/new-icon.png) > * **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://img.icons8.com/color/18/help.png)](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:** ![image](documentation/en/images/results-1.png) On/off cycles calculated by the integration (`over_climate`): ![image](documentation/en/images/results-2.png) **Regulation with an `over_switch`** ![image](documentation/en/images/results-4.png) See the component's code [[below](#even-better-with-apex-chart-to-tune-your-thermostat)] **Strong regulation in `over_climate`** ![image](documentation/en/images/results-over-climate-1.png) **Regulation with direct valve control in `over_climate`** ![image](documentation/en/images/results-over-climate-2.png) 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