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 varta varta-storage integration solar

Last synced: about 17 hours ago
JSON representation

Repository metadata

A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management

README-cs.md

GitHub Release
GitHub Activity
License
hacs
BuyMeCoffee

Versatile Thermostat

Tento README soubor je k dispozici v následujících
jazycích: Angličtina | Francouzština | Němčina | Čeština

Tip 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.

Snímky obrazovky

Versatile Thermostat UI Card (K dispozici na Github) :

Card1 Card2

Co je nového?

Nové

Verze 10.1

Výběr režimu zastavení pro automatické spuštění/zastavení. Nová entita select umožňuje zvolit režim použitý, když funkce automatického spuštění/zastavení zjistí podmínku zastavení: Vypnuto (výchozí), Pouze ventilátor nebo Vysoušení. Režimy Pouze ventilátor a Vysoušení jsou nabízeny pouze tehdy, pokud je podřízené zařízení podporuje. Více informací zde.

Samo-regulace je nyní vypnuta, když VTherm typu over_climate není v režimu Topení nebo Chlazení: podkladovému zařízení je odeslán původní (neregulovaný) setpoint. Více informací zde.

Verze 10.0

Zavedení mechanismu pluginů. Umožňuje používat externí integrace jako pluginy pro VTherm. Seznam dostupných pluginů je na webu Versatile Thermostat.

Verze 9.3 (stabilní)

  1. Detekce zaseknutého ventilu: významné vylepšení detekce poruch vytápění. Při anomálii u VTherm typu over_climate_valve termostat diagnostikuje, zda je příčinou zaseknutý TRV ventil (zaseknutý otevřený/zavřený), a pošle root_cause v události. Více informací zde,
  2. Automatické opětovné zamčení po odemčení: přidán parametr auto_relock_sec ve funkci zámku. Při nastavení se termostat po odemčení automaticky znovu zamkne po zadaném počtu sekund. Více informací zde,
  3. Opětovné odeslání příkazu: nová funkce, která detekuje a opravuje nesoulad mezi požadovaným stavem termostatu a skutečným stavem podřízených zařízení. Pokud se příkaz neprovede správně, odešle se znovu. Více informací zde,
  4. Obnovení časovaného presetu po restartu: časovaný preset se po restartu termostatu nebo Home Assistant obnoví a pokračuje normálně. Více informací zde,
  5. Přesnější řízení výkonu: práh aktivace kotle (power_activation_threshold) nově přijímá desetinné hodnoty (0.1, 0.5, ...), což umožňuje jemnější řízení spotřeby. Více informací zde,
  6. Zlepšení dostupnosti senzorů: lepší určování dostupnosti teplotních senzorů přes metadata last_updated v Home Assistant.

Verze 9.2

  1. 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í,
  2. 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,
  3. 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.

Verze 9.1

  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!
  2. 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.
  3. 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.
  4. 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ý.

🍻 Děkuji za piva 🍻

"Buy Me A Coffee"

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í:

  1. Úvod
  2. Instalace
  3. Rychlý start
  4. Výběr typu VTherm
  5. Základní atributy
  6. Konfigurace VTherm na spínači
  7. Konfigurace VTherm na klimatizaci
  8. Konfigurace VTherm na ventilu
  9. Předvolby
  10. Správa oken
  11. Správa přítomnosti
  12. Správa pohybu
  13. Správa energie
  14. Auto start a stop
  15. Centralizované řízení všech VTherm
  16. Řízení ústředního vytápění
  17. Pokročilé aspekty, bezpečnostní režim
  18. Detekce poruchy vytápění
  19. Samoregulace
  20. Auto TPI učení
  21. Algoritmy
  22. Zamknutí / odemknutí
  23. Synchronizace teploty
  24. Časovaný preset
  25. Referenční dokumentace
  26. Příklady ladění
  27. Řešení problémů
  28. Poznámky k verzím

Některé výsledky

Stabilita teploty kolem cíle nakonfigurovaného předvolbou:

image

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

image

Regulace s over_switch:

image

Silná regulace v over_climate:

image

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

image

Některé komentáře k integraci

testimonial 1 testimonial 2 testimonial 3
testimonial 4 testimonial 5 testimonial 6

Užijte si to!

⭐ Historie hvězdiček

Star History Chart

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


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 836
Total Committers: 67
Avg Commits per committer: 12.478
Development Distribution Score (DDS): 0.585

Commits in past year: 370
Committers in past year: 36
Avg Commits per committer in past year: 10.278
Development Distribution Score (DDS) in past year: 0.646

Name Email Commits
Jean-Marc Collin j****n@r****m 347
Jean-Marc Collin j****8@g****m 271
Guillaume S K****K 69
Frank Mainz f****k@c****e 21
Krzysztonek 8****k 15
Paulo Ferreira de Castro p****o@g****m 10
Remi BONNET b****v 9
adi90x a****0@g****m 7
Gamso G****o 6
silviopen 4****n 5
Etienne F. e****e 4
Gernot Messow g****r@g****m 3
misa1515 6****5 3
jebabin g****m@j****e 3
Clément Notin c****n@g****m 3
Andrea Nicotra n****a@g****m 3
Václav Pokluda v****a@g****m 2
KipK k****k@n****m 2
Malte Gerken m****n@g****m 2
Marco Migozzi t****z@g****m 2
Vassilis Papanikolaou v****k@g****m 2
hilburn c****9@g****m 2
53l3cu5 3****5 1
Joeri Colman c****i@m****m 1
Ian i****e 1
Frederic Seiler f****c@s****o 1
Fabio Coatti f****i@g****m 1
Eric Scherlinger 3****e 1
Edwin ten Haaf e****n@f****l 1
EPicLURcher 7****r 1
and 37 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 509
Total pull requests: 302
Average time to close issues: 25 days
Average time to close pull requests: 4 days
Total issue authors: 244
Total pull request authors: 61
Average comments per issue: 4.72
Average comments per pull request: 1.02
Merged pull request: 238
Bot issues: 0
Bot pull requests: 0

Past year issues: 86
Past year pull requests: 60
Past year average time to close issues: 13 days
Past year average time to close pull requests: 10 days
Past year issue authors: 69
Past year pull request authors: 28
Past year average comments per issue: 4.8
Past year average comments per pull request: 1.57
Past year merged pull request: 34
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/jmcollin78/versatile_thermostat

Top Issue Authors

  • jmcollin78 (143)
  • maia (13)
  • adi90x (10)
  • tomtom13 (7)
  • kadaan (6)
  • jezzaaa (4)
  • TTLucian (4)
  • Ra72xx (4)
  • Bergoglio (4)
  • MaxWaldorf (4)
  • jiquem (4)
  • asdkjasdfla (4)
  • vador31 (4)
  • mleiber (3)
  • Merangle (3)

Top Pull Request Authors

  • jmcollin78 (166)
  • FMainz (14)
  • pdcastro (10)
  • adi90x (9)
  • KipK (8)
  • hilburn (6)
  • gpayer (6)
  • dark-light-cz (3)
  • malteger (3)
  • bontiv (3)
  • cova-fe (2)
  • carlolars (2)
  • lboue (2)
  • tmad (2)
  • felixfischer (2)

Top Issue Labels

  • developed (139)
  • enhancement (123)
  • P1 (111)
  • bug (105)
  • question (50)
  • wontfix (45)
  • Not VTherm issue (25)
  • invalid (21)
  • documentation (20)
  • Template not respected (20)
  • duplicate (19)
  • help wanted (16)
  • Waiting response (16)
  • Vote needed (13)
  • need PR (12)
  • not reproduced (10)
  • P0 (7)
  • P2 (4)
  • Experimental (1)

Top Pull Request Labels

  • question (2)
  • wontfix (1)

Package metadata

proxy.golang.org: github.com/jmcollin78/versatile_thermostat

nixpkgs-unstable: home-assistant-custom-components.versatile_thermostat

Full-featured thermostat


Dependencies

.github/workflows/cron.yaml actions
  • actions/checkout v2 composite
  • hacs/action main composite
  • home-assistant/actions/hassfest master composite
.github/workflows/pull.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
  • hacs/action main composite
  • home-assistant/actions/hassfest master composite
.github/workflows/push.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
  • hacs/action main composite
  • home-assistant/actions/hassfest master composite
.github/workflows/hacs.yml actions
  • hacs/action main composite
requirements_dev.txt pypi
  • ffmpeg * development
  • homeassistant ==2023.10.3 development
requirements_test.txt pypi
  • aiodiscover * test
  • pytest-asyncio * test
  • pytest-homeassistant-custom-component * test
  • ulid_transform * test
.github/workflows/release.yaml actions
  • actions/checkout v4 composite
  • softprops/action-gh-release v2.2.1 composite
.devcontainer/Dockerfile docker
  • python 3.14-bookworm build
.github/workflows/testus.yaml actions
  • actions/cache v3 composite
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
pyproject.toml pypi

Score: 11.285560516081748