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 4 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: 2026-03-07T20:31:53.000Z (15 days ago)
- Last Synced: 2026-03-08T01:44:34.286Z (15 days ago)
- Topics: hacs-custom, hacs-integration, home-assistant, python, thermostat
- Language: Python
- Homepage:
- Size: 15.8 MB
- Stars: 985
- Watchers: 14
- Forks: 118
- Open Issues: 22
- Releases: 302
-
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 9.1
- Nové logo. Inspirováno prací @Krzysztonek (viz zde), VTherm využívá novou funkci představenou v HA 206.03 pro změnu svého loga. Celý tým doufá, že se vám bude líbit. Užijte si to!
- Webová stránka vytvořená @bontiv řeší jeden z hlavních problémů VTherm: dokumentaci. Tato stránka navíc umožňuje analyzovat vaše logy! Poskytněte své logy (v debug režimu) a budete je moci analyzovat, přiblížit konkrétní termostat, zaměřit se na určité období, filtrovat to, co vás zajímá, atd. Objevte tuto první verzi zde: Versatile Thermostat Web site. Velké poděkování patří @bontiv za tuto skvělou práci.
- Oficiální vydání funkce auto-TPI. Tato funkce vypočítává optimální hodnoty koeficientů pro algoritmus TPI. Je třeba ocenit neuvěřitelnou práci @KipK a @gael1980 na tomto tématu. Pokud ji chcete používat, určitě si přečtěte dokumentaci.
- VTherm se nyní opírá o stav hlášený podřízenými zařízeními v HA. Dokud všechna podřízená zařízení nemají v HA známý stav, VTherm zůstává deaktivovaný.
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.- přidána funkce překalibrace ventilů pro VTherm
over_climate_valve, která umožňuje vynutit maximální otevření a poté maximální zavření za účelem pokusu o překalibraci TRV. Více informací zde.
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.
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
- Učení Auto TPI
- Technická dokumentace Auto TPI
- 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: 19 days ago
Total Commits: 714
Total Committers: 55
Avg Commits per committer: 12.982
Development Distribution Score (DDS): 0.563
Commits in past year: 292
Committers in past year: 27
Avg Commits per committer in past year: 10.815
Development Distribution Score (DDS) in past year: 0.627
| Name | Commits | |
|---|---|---|
| Jean-Marc Collin | j****n@r****m | 312 |
| Jean-Marc Collin | j****8@g****m | 226 |
| Guillaume S | K****K | 53 |
| Frank Mainz | f****k@c****e | 19 |
| Krzysztonek | 8****k | 14 |
| Paulo Ferreira de Castro | p****o@g****m | 10 |
| adi90x | a****0@g****m | 7 |
| Gamso | G****o | 6 |
| Remi BONNET | b****v | 6 |
| Etienne F. | e****e | 4 |
| Gernot Messow | g****r@g****m | 3 |
| misa1515 | 6****5 | 3 |
| jebabin | g****m@j****e | 3 |
| Andrea Nicotra | n****a@g****m | 3 |
| Malte Gerken | m****n@g****m | 2 |
| Vassilis Papanikolaou | v****k@g****m | 2 |
| hilburn | c****9@g****m | 2 |
| silviopen | 4****n | 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 |
| Joeri Colman | c****i@m****m | 1 |
| zepala | 4****a | 1 |
| sergeybelozorov | 9****v | 1 |
| ms5 | m****5 | 1 |
| and 25 more... | ||
Committer domains:
- barbot.org: 1
- orange.fr: 1
- microsoft.com: 1
- hoizey.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: 16 days ago
Total issues: 457
Total pull requests: 259
Average time to close issues: 26 days
Average time to close pull requests: 3 days
Total issue authors: 209
Total pull request authors: 40
Average comments per issue: 4.85
Average comments per pull request: 0.83
Merged pull request: 213
Bot issues: 0
Bot pull requests: 0
Past year issues: 79
Past year pull requests: 59
Past year average time to close issues: 23 days
Past year average time to close pull requests: 1 day
Past year issue authors: 56
Past year pull request authors: 10
Past year average comments per issue: 4.04
Past year average comments per pull request: 0.12
Past year merged pull request: 42
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- jmcollin78 (137)
- maia (13)
- adi90x (10)
- tomtom13 (6)
- kadaan (6)
- jezzaaa (4)
- TTLucian (4)
- MaxWaldorf (4)
- vador31 (4)
- asdkjasdfla (4)
- jiquem (4)
- Bergoglio (4)
- Ra72xx (3)
- KipK (3)
- mleiber (3)
Top Pull Request Authors
- jmcollin78 (158)
- FMainz (12)
- pdcastro (10)
- adi90x (9)
- gpayer (6)
- hilburn (6)
- malteger (3)
- lboue (2)
- pounard (2)
- felixfischer (2)
- jebabin (2)
- EPicLURcher (2)
- ericsche (2)
- oOthkOo (2)
- tmad (2)
Top Issue Labels
- developed (133)
- enhancement (113)
- P1 (107)
- bug (103)
- question (46)
- wontfix (42)
- Not VTherm issue (23)
- invalid (21)
- documentation (20)
- Template not respected (18)
- help wanted (16)
- Waiting response (16)
- duplicate (14)
- need PR (12)
- not reproduced (9)
- Vote needed (7)
- P0 (3)
- Experimental (1)
- P2 (1)
Top Pull Request Labels
Package metadata
- Total packages: 1
- Total downloads: unknown
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 3
- Total maintainers: 1
nixpkgs-unstable: home-assistant-custom-components.versatile_thermostat
Full-featured thermostat
- Homepage: https://github.com/jmcollin78/versatile_thermostat
- Documentation: https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/servers/home-assistant/custom-components/versatile_thermostat/package.nix#L31
- Licenses: MIT
- Latest release: 9.0.2 (published 16 days ago)
- Last Synced: 2026-03-07T05:27:12.831Z (16 days ago)
- Versions: 3
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
- Maintainers (1)
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.922064077951035
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ů. ;-).





