Versatile Thermostat
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management.
https://github.com/jmcollin78/versatile_thermostat
Category: Consumption
Sub Category: Buildings and Heating
Keywords
hacs-custom hacs-integration home-assistant python thermostat
Keywords from Contributors
hacs sensor integration solar varta varta-storage
Last synced: about 14 hours ago
JSON representation
Repository metadata
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management
- Host: GitHub
- URL: https://github.com/jmcollin78/versatile_thermostat
- Owner: jmcollin78
- License: mit
- Created: 2022-12-27T09:48:13.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-10-26T18:24:56.000Z (3 months ago)
- Last Synced: 2025-10-26T19:28:10.681Z (3 months ago)
- Topics: hacs-custom, hacs-integration, home-assistant, python, thermostat
- Language: Python
- Homepage:
- Size: 12.6 MB
- Stars: 629
- Watchers: 11
- Forks: 73
- Open Issues: 19
- Releases: 257
-
Metadata Files:
- Readme: README-cs.md
- Contributing: CONTRIBUTING-cs.md
- License: LICENSE
README-cs.md
Versatile Thermostat
Tento README soubor je k dispozici v následujících
jazycích: Angličtina | Francouzština | Němčina | Čeština
Tato termostatická integrace má za cíl výrazně zjednodušit vaše automatizace kolem správy vytápění. Protože všechny typické události kolem vytápění (nikdo doma?, detekována aktivita v místnosti?, otevřené okno?, omezení spotřeby energie?) jsou nativně spravovány termostatem, nemusíte se zabývat komplikovanými skripty a automatizacemi pro správu vašich termostatů. ;-).
Tato vlastní komponenta pro Home Assistant je vylepšením a kompletním přepsáním komponenty "Awesome thermostat" (viz Github) s přidanými funkcemi.
Snímky obrazovky
Versatile Thermostat UI Card (K dispozici na Github) :

Co je nového?
![]()
Release 8.6
- přidán parametr
max_opening_degreespro VTherms typuover_climate_valveumožňující omezit maximální procento otevření každého ventilu pro řízení průtoku horké vody a optimalizaci spotřeby energie.
Release 8.5
- přidána detekce poruchy vytápění pro VTherms používající algoritmus TPI. Tato funkce detekuje dva typy anomálií:
- porucha vytápění: radiátor silně topí (vysoké on_percent), ale teplota nestoupá,
- porucha chlazení: radiátor netopí (on_percent na 0), ale teplota stále stoupá.
Tyto anomálie mohou naznačovat otevřené okno, vadný radiátor nebo externí zdroj tepla. Funkce odesílá události, které lze použít ke spuštění automatizací (oznámení, výstrahy atd.). Více informací zde.
Release 8.4
- added auto TPI (experimental). This new feature allows automatically calculating the best coefficients for the TPI algorithm. More information here
- added a temperature synchronization function for a device controlled in
over_climatemode. Depending on your device's capabilities, VTherm can control an offset calibration entity or directly an external temperature entity. More information here,- added a feature named "timed preset" which aims to select a preset for a certain duration and come back to the previous preset after the expiration of the delay. The new feature is totally described here.
Release 8.3
- Addition of a configurable delay before activating the central boiler.
- Addition of a trigger for the central boiler when the total activated power exceeds a threshold. To make this feature work you must:
- Configure the power threshold that will trigger the boiler. This is a new entity available in the
central configurationdevice. - Configure the power values of the VTherms. This can be found on the first configuration page of each VTherm.
- Check the
Used by central boilerbox.
- Configure the power threshold that will trigger the boiler. This is a new entity available in the
Each time a VTherm is activated, its configured power is added to the total and, if the threshold is exceeded, the central boiler will be activated after the delay configured in item 1.
The previous counter for the number of activated devices and its threshold still exist. To disable one of the thresholds (the power threshold or the activated-devices count threshold), set it to zero. As soon as either of the two non-zero thresholds is exceeded, the boiler is activated. Therefore a logical "or" is applied between the two thresholds.
More informations here.
🍻 Děkuji za piva 🍻
Velké díky všem mým donátorům za jejich příspěvky a povzbuzování. Je to pro mě velmi potěšující a motivuje mě to pokračovat! Pokud vám tato integrace pomohla ušetřit, kupte mi malé pivo na oplátku, budu vám velmi vděčný!
Slovník
VTherm : Versatile Thermostat v následujícím textu tohoto dokumentu
TRV : termostatická hlavice vybavená ventilem. Ventil se otevírá nebo zavírá, čímž umožňuje průchod teplé vody
AC : klimatizace. Zařízení je AC, pokud chladí. Teploty jsou pak obrácené: Eco je teplejší než Komfort, který je teplejší než Boost. Algoritmy tuto informaci berou v úvahu.
EMA : Exponential Moving Average. Používá se k vyhlazení měření teplot senzorů. Odpovídá klouzavému průměru teploty místnosti. Používá se k výpočtu sklonu křivky teploty (slope), který by byl na surové křivce příliš nestabilní.
slope : sklon křivky teploty. Měří se v °(C nebo K)/h. Je pozitivní, pokud teplota stoupá, a negativní, pokud klesá. Tento sklon se počítá na EMA
PAC : tepelné čerpadlo
HA : Home Assistant
underlying: zařízení ovládané VTherm
Dokumentace
Dokumentace je nyní rozdělena do několika stránek pro snadnější čtení a vyhledávání:
- Úvod
- Instalace
- Rychlý start
- Výběr typu VTherm
- Základní atributy
- Konfigurace VTherm na
spínači - Konfigurace VTherm na
klimatizaci - Konfigurace VTherm na ventilu
- Předvolby
- Správa oken
- Správa přítomnosti
- Správa pohybu
- Správa energie
- Auto start a stop
- Centralizované řízení všech VTherm
- Řízení ústředního vytápění
- Pokročilé aspekty, bezpečnostní režim
- Samoregulace
- Lock / Unlock
- Temperature synchronisation
- Timed preset
- Příklady ladění
- Algoritmy
- Zámek / Odemknutí
- Referenční dokumentace
- Řešení problémů
- Poznámky k verzím
- Detekce poruchy vytápění
Některé výsledky
Stabilita teploty kolem cíle nakonfigurovaného předvolbou:

Cykly zapnutí/vypnutí vypočítané integrací over_climate:

Regulace s over_switch:

Silná regulace v over_climate:

Regulace s přímým řízením ventilu v over_climate:

Some comments on the integration
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Užijte si to!
⭐ Star history
Příspěvky jsou vítány!
Pokud si přejete přispět, přečtěte si prosím pokyny pro přispívání.
Owner metadata
- Name: Jean-Marc Collin
- Login: jmcollin78
- Email:
- Kind: user
- Description:
- Website: http://clouderial.com
- Location: France
- Twitter:
- Company: Clouderial
- Icon url: https://avatars.githubusercontent.com/u/1712374?u=28dcf780c3c2043f176ba88bea0b0135c6f6670b&v=4
- Repositories: 13
- Last ynced at: 2023-09-20T14:50:26.970Z
- Profile URL: https://github.com/jmcollin78
GitHub Events
Total
- Fork event: 45
- Discussion event: 4
- Create event: 128
- Commit comment event: 3
- Release event: 77
- Issues event: 425
- Watch event: 281
- Delete event: 69
- Issue comment event: 1408
- Push event: 335
- Pull request review event: 68
- Pull request review comment event: 24
- Pull request event: 169
Last Year
- Fork event: 43
- Discussion event: 4
- Create event: 125
- Commit comment event: 3
- Release event: 76
- Issues event: 400
- Watch event: 275
- Delete event: 69
- Issue comment event: 1341
- Push event: 325
- Pull request review comment event: 21
- Pull request review event: 62
- Pull request event: 164
Committers metadata
Last synced: 2 months ago
Total Commits: 555
Total Committers: 49
Avg Commits per committer: 11.327
Development Distribution Score (DDS): 0.488
Commits in past year: 209
Committers in past year: 29
Avg Commits per committer in past year: 7.207
Development Distribution Score (DDS) in past year: 0.541
| Name | Commits | |
|---|---|---|
| Jean-Marc Collin | j****n@r****m | 284 |
| Jean-Marc Collin | j****8@g****m | 174 |
| Krzysztonek | 8****k | 12 |
| Frank Mainz | f****k@c****e | 12 |
| Paulo Ferreira de Castro | p****o@g****m | 10 |
| adi90x | a****0@g****m | 7 |
| Andrea Nicotra | n****a@g****m | 3 |
| Guillaume S | K****K | 3 |
| jebabin | g****m@j****e | 3 |
| misa1515 | 6****5 | 3 |
| Gernot Messow | g****r@g****m | 3 |
| hilburn | c****9@g****m | 2 |
| Vassilis Papanikolaou | v****k@g****m | 2 |
| Malte Gerken | m****n@g****m | 2 |
| 53l3cu5 | 3****5 | 1 |
| Bergoglio | 6****o | 1 |
| Clément Notin | c****n@g****m | 1 |
| EPicLURcher | 7****r | 1 |
| Edwin ten Haaf | e****n@f****l | 1 |
| Eric Scherlinger | 3****e | 1 |
| Fabio Coatti | f****i@g****m | 1 |
| Frederic Seiler | f****c@s****o | 1 |
| Gamso | G****o | 1 |
| Joeri Colman | c****i@m****m | 1 |
| zepala | 4****a | 1 |
| silviopen | 4****n | 1 |
| sergeybelozorov | 9****v | 1 |
| ms5 | m****5 | 1 |
| jkreiss-coexya | 9****p | 1 |
| felix schwenzel | d****x@g****m | 1 |
| and 19 more... | ||
Committer domains:
- barbot.org: 1
- orange.fr: 1
- microsoft.com: 1
- 23doors.com: 1
- snoe.me: 1
- oothkoo.com: 1
- wanadoo.fr: 1
- msn.com: 1
- seiler.io: 1
- familietenhaaf.nl: 1
- jeb.be: 1
- cybermainzel.de: 1
- renault.com: 1
Issue and Pull Request metadata
Last synced: 3 months ago
Total issues: 444
Total pull requests: 258
Average time to close issues: 26 days
Average time to close pull requests: 3 days
Total issue authors: 200
Total pull request authors: 39
Average comments per issue: 4.68
Average comments per pull request: 0.84
Merged pull request: 212
Bot issues: 0
Bot pull requests: 0
Past year issues: 212
Past year pull requests: 172
Past year average time to close issues: 22 days
Past year average time to close pull requests: 2 days
Past year issue authors: 119
Past year pull request authors: 25
Past year average comments per issue: 5.1
Past year average comments per pull request: 0.58
Past year merged pull request: 141
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- jmcollin78 (136)
- maia (13)
- adi90x (10)
- kadaan (6)
- tomtom13 (6)
- TTLucian (4)
- vador31 (4)
- Bergoglio (4)
- MaxWaldorf (4)
- jezzaaa (4)
- jiquem (4)
- prodoff (3)
- Ra72xx (3)
- KipK (3)
- williamka (3)
Top Pull Request Authors
- jmcollin78 (158)
- FMainz (12)
- pdcastro (10)
- adi90x (9)
- hilburn (6)
- gpayer (6)
- malteger (3)
- ericsche (2)
- s256 (2)
- tmad (2)
- oOthkOo (2)
- EPicLURcher (2)
- zepala (2)
- jebabin (2)
- pounard (2)
Top Issue Labels
- developed (132)
- enhancement (111)
- P1 (107)
- bug (99)
- question (44)
- wontfix (40)
- Not VTherm issue (22)
- invalid (20)
- Template not respected (18)
- documentation (18)
- help wanted (16)
- Waiting response (16)
- duplicate (14)
- need PR (12)
- not reproduced (9)
- Vote needed (6)
Top Pull Request Labels
Dependencies
- actions/checkout v2 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- hacs/action main composite
- ffmpeg * development
- homeassistant ==2023.10.3 development
- aiodiscover * test
- pytest-asyncio * test
- pytest-homeassistant-custom-component * test
- ulid_transform * test
Score: 10.365710994462901
Tato termostatická integrace má za cíl výrazně zjednodušit vaše automatizace kolem správy vytápění. Protože všechny typické události kolem vytápění (nikdo doma?, detekována aktivita v místnosti?, otevřené okno?, omezení spotřeby energie?) jsou nativně spravovány termostatem, nemusíte se zabývat komplikovanými skripty a automatizacemi pro správu vašich termostatů. ;-).





