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 8 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 (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-03-07T20:31:53.000Z (about 1 month ago)
- Last Synced: 2026-03-08T01:44:34.286Z (about 1 month 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
Versatile Thermostat je vysoce konfigurovatelný virtuální termostat, který transformuje jakékoli vytápěcí zařízení (radiátory, klimatizace, tepelná čerpadla atd.) v inteligentní a adaptivní systém. Umožňuje vám konsolidovat a centrálně řídit více různých topných systémů, přičemž automaticky optimalizuje spotřebu energie. Díky pokročilým algoritmům (TPI, auto-TPI) a možnostem učení se termostat přizpůsobuje vašemu domu 🏠 a vašim zvykům, poskytuje optimální pohodlí a významné snížení vašich topných účtů 💰.
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.
Dokumentace
Celá dokumentace je k dispozici na Versatile Thermostat Web site.
Snímky obrazovky
Versatile Thermostat UI Card (K dispozici na Github) :

Co je nového?
![]()
Release 9.3
- Detekce zaseknutého ventilu: Zásadní vylepšení detekce poruchy vytápění. Když je na termostatech typu
over_climate_valvedetekována anomálie, termostat nyní diagnostikuje, zda je problém způsoben zaseknutým ventilem TRV (zaseknutý otevřený nebo zavřený) porovnáním požadovaného stavu se skutečným stavem. Tyto informace -root_cause- jsou odeslány vEvents anomálie, což vám umožňuje podniknout příslušná opatření (oznámení, obnovení ventilu atd.). Další informace zde,- Automatické znovuzamčení po odemčení: Přidán parametr
auto_relock_secdo funkce zámku. Pokud je nakonfigurován, termostat se automaticky znovuzamkne po zadaném počtu sekund po odemčení. Tuto funkci můžete zcela deaktivovat nastavením na 0. Ve výchozím nastavení je automatické znovuzamčení nastaveno na 30 sekund pro zvýšení bezpečnosti. Další informace zde,- Opětovné odeslání příkazu: Nová funkce pro automatickou detekci a opravu nesrovnalostí mezi požadovaným stavem termostatu a skutečným stavem podřízených zařízení. Pokud příkaz není správně aplikován na zařízení, je znovu odeslán. To zlepšuje spolehlivost systému v nestabilních prostředích nebo s nespolehlivým vybavením. Další informace zde,
- Obnovení časového přednastavení po restartování: Nakonfigurované časové přednastavení je nyní správně obnoveno po restartování termostatu nebo Home Assistant. Toto přednastavení continue normálně funguje po restartování. Další informace zde,
- Zvýšená přesnost řízení výkonu: Prah aktivace kotle (
power_activation_threshold) nyní přijímá desetinné hodnoty (0,1, 0,5 atd.) pro jemnější kontrolu aktivačního výkonu. To poskytuje větší flexibilitu pro optimalizaci spotřeby energie. Další informace zde,- Zlepšení dostupnosti senzorů: Lepší podpora pro určení dostupnosti senzoru teploty pomocí metadat
last_updatedHome Assistant, zlepšená detekce ztráty signálu senzoru,
Release 9.2 - stabilní verze
- Nový způsob řízení cyklů topení/zastavení pro VTherm
over_switch. Současný algoritmus má časový drift a první cykly nejsou optimální. To narušuje TPI a zejména auto-TPI. NovýCycle Schedulerřeší tyto potíže. Tato změna je pro vás zcela transparentní,- Kolektor záznamů. Vaše žádosti o podporu často selhávají kvůli vaší schopnosti poskytnout záznamy v správném období, zaměřené na termostat s chybou a na správné úrovni záznamů. Jedná se zejména o obtížně reprodukovatelné chyby. Kolektor záznamů má za cíl vyřešit tuto potíž. Sbírá pro vás záznamy na pozadí na nejjemnější úrovni a akce (dříve služba) umožňuje jejich extrakci do souboru. Poté je můžete stáhnout a připojit k vaší žádosti o podporu. Analyzátor záznamů spojený s webovými stránkami – spuštěný ve verzi 9.1 (viz níže) – se přizpůsobuje, aby mohl tyto záznamy zpracovat. Více informací o kolektoru záznamů zde,
- Stabilizace verze 9.x. Hlavní verze 9 přinesla mnoho změn, které způsobily některé anomálie. Tato verze přináší poslední opravy týkající se verze 9.
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ý.
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: about 1 month 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: about 1 month 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 about 1 month ago)
- Last Synced: 2026-03-07T05:27:12.831Z (about 1 month 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
Versatile Thermostat je vysoce konfigurovatelný virtuální termostat, který transformuje jakékoli vytápěcí zařízení (radiátory, klimatizace, tepelná čerpadla atd.) v inteligentní a adaptivní systém. Umožňuje vám konsolidovat a centrálně řídit více různých topných systémů, přičemž automaticky optimalizuje spotřebu energie. Díky pokročilým algoritmům (TPI, auto-TPI) a možnostem učení se termostat přizpůsobuje vašemu domu 🏠 a vašim zvykům, poskytuje optimální pohodlí a významné snížení vašich topných účtů 💰.





