Versatile Thermostat

This README file is available in languages : English | French

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) with added features.

Screenshots

Versatile Thermostat UI Card (Available on Github) :

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 links: Version 7.2 introduces experimental links to the documentation from the configuration pages. The link is accessible via the icon . This feature is currently tested on some configuration pages.

🍻 Thanks for the beers 🍻

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
2. Installation
3. Quick start
4. Choosing a VTherm type
5. Basic attributes
6. Configuring a VTherm on a switch
7. Configuring a VTherm on a climate
8. Configuring a VTherm on a valve
9. Presets
10. Window management
11. Presence management
12. Motion management
13. Power management
14. Auto start and stop
15. Centralized control of all VTherms
16. Central heating control
17. Advanced aspects, security mode
18. Self-regulation
19. Tuning examples
20. Algorithms
21. Reference documentation
22. Tuning examples
23. Troubleshooting
24. Release notes

Some results

Temperature stability around the target configured by preset:

On/off cycles calculated by the integration over_climate:

Regulation with an over_switch:

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.

---