
Šablóna Vaillant aroTHERM plus pripojí TapHome k tepelnému čerpadlu vzduch-voda Vaillant aroTHERM plus a k jeho systémovému regulátoru sensoCOMFORT VRC 720 cez adaptér eBUS Adapter Shield alebo Stick C6 od ebusd.eu. Adaptér je na zbernici eBUS regulátora a beží na ňom micro-ebusd, ktorý dekóduje správy Vaillant a ponúka ich cez lokálne HTTP JSON API. TapHome komunikuje len s adaptérom v lokálnej sieti; cloud sa nepoužíva.
Šablóna číta vonkajšiu, izbovú, prívodnú teplotu a teplotu teplej vody, tlak vody, príkon a spotrebu tepelného čerpadla a poruchy regulátora. Nastavuje požadovanú izbovú teplotu zóny 1, požadovanú teplotu teplej vody, prevádzkové režimy zóny 1 a teplej vody a spúšťa jednorazový ohrev teplej vody.
Komunitná šablóna — zatiaľ neotestovaná s TapHome na skutočnom adaptéri. Šablóna vznikla v portáli TapHome z dokumentácie micro-ebusd a z definícií správ ebusd pre VRC 720 a aroTHERM plus. Otestovaná bola len so simulátorom adaptéra na lokálnom TapHome Core 2025.2, nie so skutočným adaptérom, regulátorom ani tepelným čerpadlom, a skúsenosti z praxe sú vítané. XML si stiahnite na tejto stránke alebo z portálu TapHome: Vaillant aroTHERM plus + VRC 720 — komunitná šablóna, a importujte ho ako nový modul.
Šablóna dopĺňa oficiálnu šablónu TapHome eBUS Adapter Shield C6 Stick, ktorá cez MQTT ukazuje stav samotného adaptéra (signál zbernice, démon, teplotu); obe môžu bežať vedľa seba. S komunitnou šablónou pre fan-coil Vaillant aroVAIR, ktorá používa Modbus RTU, nesúvisí.
Čo potrebujete
- Vaillant aroTHERM plus s regulátorom sensoCOMFORT VRC 720 na zbernici eBUS.
- eBUS Adapter Shield C6 alebo Stick C6 (adapter.ebusd.eu) s najnovším firmvérom a aktivovaným micro-ebusd. micro-ebusd je platená funkcia adaptéra, ktorú odomkne token; každý adaptér dostane jednu 30-dňovú skúšobnú licenciu.
- Adaptér a TapHome Core v tej istej lokálnej sieti.
Hardvérové pripojenie
Adaptér sa pripája k dvom svorkám eBUS na regulátore VRC 720; na polarite zbernice eBUS nezáleží. aroTHERM plus komunikuje s regulátorom po tej istej zbernici, takže k vonkajšej jednotke netreba žiadny vodič. Pred prácou na svorkách regulátora odpojte sieťové napájanie.
Adaptér pripojte do lokálnej siete podľa dokumentácie adaptéra a jeho IP adresu si rezervujte v routeri, aby ho TapHome vždy našiel.
Konfigurácia
Aktivácia micro-ebusd
- Aktualizujte adaptér na najnovší firmvér (adapter.ebusd.eu).
- Získajte token micro-ebusd na token.ebusd.eu (jedna 30-dňová skúšobná licencia na adaptér, potom platený) a zadajte ho vo webovom rozhraní adaptéra.
- Po aktivácii odpovedá HTTP JSON API na
http://<adapter-ip>/api/v1/ebus.
Zistenie mien okruhov
micro-ebusd adresuje každú hodnotu okruhom a menom správy. Otvorte v prehliadači http://<adapter-ip>/api/v1/ebus/list: zobrazí okruhy a správy, ktoré adaptér našiel na zbernici. Regulátor sensoCOMFORT VRC 720 sa podľa verzie hlási ako ctlv2, ctlv3 alebo 720, vonkajšia jednotka aroTHERM plus ako hmu. Dialóg importu uvádza aj 700 pre VRC 700; šablóna bola napísaná podľa definícií správ regulátora VRC 720.
Parametre importu
| Parameter | Predvolená hodnota | Popis |
|---|---|---|
ADAPTER_IP | (prázdne) | IP adresa adaptéra eBUS |
CONTROLLER_CIRCUIT | ctlv2 | Meno okruhu regulátora z /api/v1/ebus/list |
HEAT_SOURCE_CIRCUIT | hmu | Meno okruhu vonkajšej jednotky aroTHERM plus |
Import vytvorí dva moduly na tom istom adaptéri: sensoCOMFORT VRC 720 (ctlv2) s ôsmimi zariadeniami a aroTHERM plus (hmu) s elektromerom tepelného čerpadla.
Možnosti zariadení
Teploty a tlak
- Vonkajšia teplota — vonkajšia teplota, ako ju ukazuje VRC 720.
- Teplota prívodu — teplota prívodu systému (vykurovacia voda).
- Tlak vody — tlak vody vo vykurovacej sústave v baroch (len na čítanie).
Zóna 1
- Termostat zóny 1 — izbová teplota a požadovaná teplota, ktorú regulátor naozaj používa. Požadovaná teplota nastavená v TapHome (5–30 °C) sa posiela ako quick veto: dočasná zmena, časový program regulátora ostáva, ako je. Po zápise šablóna hodnotu znova prečíta zo zbernice.
- Prevádzkový režim zóny 1 — Vypnuté, Auto (časový program), Ručne / Deň a Noc. Šablóna posiela mená z definície ebusd (
off,auto,day,night). Na VRC 720 je režimdayjeho ručný režim a nočný režim VRC 720 nemá.
Teplá voda
- Termostat teplej úžitkovej vody — teplota zásobníka teplej vody a požadovaná teplota teplej vody, nastaviteľná od 35 do 75 °C.
- Prevádzkový režim teplej úžitkovej vody — Vypnuté, Auto, Deň alebo Noc.
- Jednorazový ohrev teplej vody — zapnutie spustí ohrev; po nahriatí zásobníka sa regulátor sám vráti do režimu auto a prepínač potom znova ukáže vypnuté.
Elektrina tepelného čerpadla
Modul aroTHERM plus (hmu) má jedno zariadenie, Elektromer tepelného čerpadla, elektromer vonkajšej jednotky:
- Odber — aktuálny elektrický príkon tepelného čerpadla v kW.
- Celková spotreba — celková spotreba elektriny tepelného čerpadla v kWh. Počítadlo je 16-bitové číslo (najviac 65535 kWh), takže na jednotke, ktorá beží mnoho rokov, už mohlo začať znova od nuly.
Ukazuje aj tri servisné atribúty:
| Servisný atribút | Popis |
|---|---|
| COP (vykurovanie) | Vykurovací faktor tepelného čerpadla pri vykurovaní |
| Celkový tepelný zisk [kWh] | Celkový tepelný zisk tepelného čerpadla — tepelná energia, nie elektrina |
| Prevádzkový stav | Stav, ktorý hlási vonkajšia jednotka: ready, heating, cooling, heating_water alebo error |
Poruchy regulátora
Modul sensoCOMFORT VRC 720 (ctlv2) v každom cykle číta aktuálne poruchy regulátora. Pre každé z jeho piatich polí porúch, ktoré nie je nula, ukáže modul chybu s číslom poruchy, napríklad Controller error code: 1025.
Ako šablóna komunikuje s adaptérom
Každá hodnota je jedna správa z definície ebusd. Šablóna ju číta cez GET /api/v1/ebus/{circuit}/{message}/get?from=1, ktoré odpovie z vyrovnávacej pamäte adaptéra alebo sa spýta zbernice, a z odpovede berie data.fields.value. Zápis je PUT /api/v1/ebus/{circuit}/{message}/set s telom {"fields":{"value":…}} a po ňom čítanie s from=2, ktoré sa vždy pýta zbernice. Moduly aj všetky zariadenia čítajú každých 60 s.
Žiadne zo zariadení nič nezapíše pri štarte TapHome Core: stav berú z adaptéra, nie z poslednej hodnoty v TapHome.
Niektoré verzie firmvéru VRC 720 zápis potvrdia a nevykonajú. Šablóna po každom zápise hodnotu znova prečíta zo zbernice, takže TapHome potom ukáže hodnotu, ktorú regulátor naozaj používa, nie tú, ktorú ste nastavili.
Čo šablóna nerobí
- Inštalatérske parametre (vykurovacia krivka, maximálna teplota prívodu) sú vynechané zámerne — šablóna nemení inštalatérske nastavenia regulátora.
- Chladenie zóny 1, zóny 2 a 3 a týždenný časový program nie sú súčasťou šablóny.
- Ďalšie hodnoty vonkajšej jednotky (teplota nasávaného vzduchu, využitie kompresora, aktuálny tepelný výkon) sú na zbernici dostupné, ale šablóna ich nečíta.
Riešenie problémov
Žiadne hodnoty
Skontrolujte, či je micro-ebusd aktivovaný a token neexpiroval: bez micro-ebusd adaptér na /api/v1/ebus neodpovedá. Skontrolujte, či sa http://<adapter-ip>/api/v1/ebus/list otvorí v prehliadači.
Zariadenia regulátora neukazujú hodnotu
Meno okruhu nesedí. Otvorte http://<adapter-ip>/api/v1/ebus/list, nájdite meno regulátora (ctlv2, ctlv3 alebo 720) a vonkajšej jednotky (hmu) a šablónu importujte znova s týmito menami.
Požadovaná teplota alebo režim sa vráti na starú hodnotu
Regulátor zápis nevykonal; TapHome ukazuje hodnotu prečítanú späť zo zbernice. Skontrolujte prevádzkový režim zóny a firmvér regulátora.
Chyba modulu Controller error code: …
Regulátor hlási poruchu s týmto číslom. Vyhľadajte ju v dokumentácii regulátora alebo tepelného čerpadla; chyba modulu zmizne, keď ju regulátor zruší.