HA Topení Load Balancer

Pyscript aplikace pro Home Assistant, která per-fázově řídí podlahové topení (a volitelně bojler) tak, aby nedošlo k přetížení hlavního jističe (typicky 3×25A) při současném běhu více topných okruhů.

Proč

Instalace s více nezávislými topnými okruhy (podlahové topné kabely) na třífázovém přívodu může snadno překročit jistič, pokud se všechny okruhy sepnou najednou (typicky po přechodu na nízký tarif / NT). Tenhle projekt řeší load-shedding softwarově místo výměny jističe:

• Greedy scheduler — každé 2 minuty vyhodnotí per fázi, kolik proudu/výkonu je ještě volných (limit − bezpečnostní rezerva − ostatní neřízená zátěž), a zapne okruhy s největším teplotním deficitem (cíl − aktuální teplota), dokud se vejdou do limitu.
• Rychlá bezpečnostní smyčka — reaguje okamžitě (ne čeká na 2min cyklus), pokud reálné měření (Shelly) ukáže překročení bezpečnostního prahu, vypne okruh s nejmenším aktuálním deficitem.
• NT/VT tarifní gating — mimo nízký tarif se všechny řízené okruhy vypnou.
• Podporuje jak climate entity (termostaty), tak switch-řízené spotřebiče (např. bojler s vlastním topným tělesem) ve stejné frontě — bojler tak soutěží o kapacitu fáze rovnocenně s topnými okruhy.
• Tepelná akumulace bojleru — v NT dohřeje bojler na vyšší teplotu, aby přečkal VT bez nutnosti dohřevu za drahý tarif.
• Týdenní anti-legionella cyklus — naplánovaný spuštění nativního dezinfekčního cyklu bojleru mimo špičku.

Požadavky

• Home Assistant s nainstalovaným pyscript (allow_all_imports: true, hass_is_global: true v configuration.yaml)
• Měřič výkonu/proudu per fázi (v tomto projektu Shelly Pro 3EM, ale funguje s jakýmkoliv senzorem výkonu ve wattech)
• Climate entity s temperature/current_temperature atributy pro každý řízený okruh (funguje i pro water_heater entity se stejnými atributy)

Instalace

1. Zkopírovat pyscript/modules/topeni_common.py do <config>/pyscript/modules/topeni_common.py
2. Zkopírovat pyscript/topeni_faze_*.py do <config>/pyscript/
3. Upravit konstanty a CIRCUITS_* seznamy v topeni_faze_a.py/_b.py/_c.py podle vlastní instalace (entity_id, jmenovité výkony, Shelly senzory)
4. Restartovat Home Assistant (moduly v pyscript/modules/ se nenačtou znovu jen přes pyscript.reload — je potřeba plný restart)

Konfigurace

Klíčové konstanty v topeni_common.py:

Konstanta	Popis	Výchozí
FAZE_LIMIT_A	Jmenovitý limit jističe na fázi (A)	25
FAZE_SAFETY_MARGIN_A	Bezpečnostní rezerva (A)	2
NOMINAL_VOLTAGE_V	Nominální napětí pro přepočet A↔W	230
BOJLER_NT_BOOST_C	Cílová teplota bojleru v NT (tepelná akumulace)	65
HDO_NT_ENTITY	Binary sensor pro NT/VT tarif	—

Fázová/výkonová data zjišťujte empiricky

Doporučujeme fázové přiřazení a skutečný výkon okruhů měřit přímo (zapnout okruh jednotlivě, sledovat nárůst na měřiči), ne spoléhat na projektovou dokumentaci/elektrikářskou tabulku — v praxi se skutečné zapojení a výkony často liší od plánu.

Licence

MIT