
A Vaillant aroTHERM plus sablon a TapHome-ot egy Vaillant aroTHERM plus levegő-víz hőszivattyúhoz és annak sensoCOMFORT VRC 720 rendszerszabályozójához kapcsolja egy ebusd.eu gyártmányú eBUS Adapter Shield vagy Stick C6 adapteren keresztül. Az adapter a szabályozó eBUS buszán ül, és micro-ebusd fut rajta, amely dekódolja a Vaillant üzeneteket, és helyi HTTP JSON API-n kínálja őket. A TapHome csak az adapterrel kommunikál a helyi hálózaton; felhőt nem használ.
A sablon kiolvassa a külső, a szoba-, az előremenő és a melegvíz-hőmérsékletet, a víznyomást, a hőszivattyú teljesítményét és fogyasztását, valamint a szabályozó hibáit. Beállítja az 1. zóna szobahőmérséklet-alapjelét, a melegvíz-alapjelet, az 1. zóna és a melegvíz üzemmódját, és elindítja az egyszeri melegvíz-töltést.
Közösségi sablon — a TapHome-mal valódi adapteren még nincs tesztelve. A sablon a TapHome portálon készült a micro-ebusd dokumentációjából és a VRC 720-hoz és az aroTHERM plushoz tartozó ebusd üzenetdefiníciókból. Csak egy szimulált adapterrel tesztelték egy helyi TapHome Core 2025.2-n, valódi adapterrel, szabályozóval és hőszivattyúval nem, a gyakorlati tapasztalatokat szívesen fogadjuk. Töltsd le az XML-t ezen az oldalon vagy a TapHome portálról: Vaillant aroTHERM plus + VRC 720 — közösségi sablon, és importáld új modulként.
A sablon kiegészíti a hivatalos eBUS Adapter Shield C6 Stick TapHome sablont, amely MQTT-n magának az adapternek az állapotát mutatja (buszjel, szolgáltatás, hőmérséklet); a kettő futhat egymás mellett. Nincs köze a Vaillant aroVAIR fan-coilhoz készült közösségi sablonhoz, amely Modbus RTU-t használ.
Amire szükséged van
- Vaillant aroTHERM plus sensoCOMFORT VRC 720 szabályozóval az eBUS buszon.
- eBUS Adapter Shield C6 vagy Stick C6 (adapter.ebusd.eu) a legújabb firmware-rel és aktivált micro-ebusd-vel. A micro-ebusd az adapter fizetős funkciója, amelyet token old fel; minden adapter egy 30 napos próbalicencet kap.
- Az adapter és a TapHome Core ugyanazon a helyi hálózaton.
Hardveres csatlakozás
Az adapter a VRC 720 szabályozó két eBUS kapcsára csatlakozik; az eBUS polaritásfüggetlen. Az aroTHERM plus ugyanazon a buszon kommunikál a szabályozóval, így a kültéri egységhez nem kell vezeték. A szabályozó kapcsain végzett munka előtt kapcsold le a hálózati tápellátást.
Csatlakoztasd az adaptert a helyi hálózatra az adapter dokumentációja szerint, és foglald le az IP-címét a routerben, hogy a TapHome mindig elérje.
Konfiguráció
A micro-ebusd aktiválása
- Frissítsd az adaptert a legújabb firmware-re (adapter.ebusd.eu).
- Szerezz be egy micro-ebusd tokent a token.ebusd.eu oldalon (adapterenként egy 30 napos próbalicenc, utána fizetős), és add meg az adapter webes felületén.
- Az aktiválás után a HTTP JSON API a
http://<adapter-ip>/api/v1/ebuscímen válaszol.
A körnevek megkeresése
A micro-ebusd minden értéket kör és üzenetnév alapján címez. Nyisd meg böngészőben a http://<adapter-ip>/api/v1/ebus/list címet: felsorolja a köröket és üzeneteket, amelyeket az adapter a buszon talált. A sensoCOMFORT VRC 720 szabályozó a verziójától függően ctlv2, ctlv3 vagy 720 néven jelenik meg, az aroTHERM plus kültéri egysége hmu néven. Az importálási párbeszédablak a VRC 700-hoz a 700 nevet is említi; a sablon a VRC 720 üzenetdefiníciói alapján készült.
Importálási paraméterek
| Paraméter | Alapértelmezett érték | Leírás |
|---|---|---|
ADAPTER_IP | (üres) | Az eBUS adapter IP-címe |
CONTROLLER_CIRCUIT | ctlv2 | A szabályozó körneve a /api/v1/ebus/list listából |
HEAT_SOURCE_CIRCUIT | hmu | Az aroTHERM plus kültéri egységének körneve |
Az importálás két modult hoz létre ugyanazon az adapteren: sensoCOMFORT VRC 720 (ctlv2) nyolc eszközzel és aroTHERM plus (hmu) a hőszivattyú villanyórájával.
Az eszközök képességei
Hőmérsékletek és nyomás
- Külső hőmérséklet — a külső hőmérséklet, ahogy a VRC 720 mutatja.
- Előremenő hőmérséklet — a rendszer előremenő hőmérséklete (fűtési előremenő).
- Víznyomás — a fűtési rendszer víznyomása barban (csak olvasható).
1. zóna
- 1. zóna termosztátja — a szobahőmérséklet és az alapjel, amelyet a szabályozó ténylegesen használ. A TapHome-ban beállított alapjel (5–30 °C) quick veto formában megy: ideiglenes változtatás, a szabályozó időprogramja változatlan marad. Írás után a sablon újra kiolvassa az értéket a buszról.
- 1. zóna üzemmódja — Ki, Auto (időprogram), Kézi / Nappal és Éjszaka. A sablon az ebusd definíció neveit küldi (
off,auto,day,night). A VRC 720-on adaymód a kézi mód, éjszakai módja pedig a VRC 720-nak nincs.
Melegvíz
- Használati melegvíz termosztát — a melegvíztároló hőmérséklete és a melegvíz-alapjel, 35 és 75 °C között állítható.
- Használati melegvíz üzemmód — Ki, Auto, Nappal vagy Éjszaka.
- Egyszeri melegvíz-töltés — a bekapcsolás elindítja a töltést; a tároló felfűtése után a szabályozó magától visszatér auto módba, a kapcsoló pedig ismét kikapcsolt állapotot mutat.
A hőszivattyú villamos energiája
Az aroTHERM plus (hmu) modulnak egy eszköze van, a Hőszivattyú villanyóra, a kültéri egység villanyórája:
- Teljesítményigény — a hőszivattyú aktuális elektromos teljesítménye kW-ban.
- Teljes fogyasztás — a hőszivattyú teljes villamosenergia-fogyasztása kWh-ban. A számláló 16 bites szám (legfeljebb 65535 kWh), így egy sok éve működő egységen már újraindulhatott nulláról.
Három szervizattribútumot is mutat:
| Szervizattribútum | Leírás |
|---|---|
| COP (fűtés) | A hőszivattyú teljesítménytényezője fűtésben |
| Teljes hőhozam [kWh] | A hőszivattyú teljes hőhozama — hőenergia, nem villamos energia |
| Üzemállapot | A kültéri egység által jelentett állapot: ready, heating, cooling, heating_water vagy error |
A szabályozó hibái
A sensoCOMFORT VRC 720 (ctlv2) modul minden ciklusban kiolvassa a szabályozó aktuális hibáit. Az öt hibamező közül mindegyikre, amely nem nulla, a modul hibát jelez a hibaszámmal, például Controller error code: 1025.
Hogyan kommunikál a sablon az adapterrel
Minden érték az ebusd definíció egy üzenete. A sablon a GET /api/v1/ebus/{circuit}/{message}/get?from=1 kéréssel olvassa, amely az adapter gyorsítótárából válaszol, vagy megkérdezi a buszt, és a válaszból a data.fields.value mezőt veszi. Az írás PUT /api/v1/ebus/{circuit}/{message}/set a {"fields":{"value":…}} törzzsel, utána egy from=2 olvasás, amely mindig a buszt kérdezi. A modulok és minden eszköz 60 másodpercenként olvas.
Egyik eszköz sem ír semmit a TapHome Core indulásakor: az állapotot az adaptertől veszik át, nem a TapHome utolsó értékéből.
A VRC 720 egyes firmware-verziói nyugtázzák az írást, de nem hajtják végre. Mivel a sablon minden írás után újra kiolvassa az értéket a buszról, a TapHome ezután azt az értéket mutatja, amelyet a szabályozó ténylegesen használ, nem azt, amelyet beállítottál.
Amit a sablon nem csinál
- A szerelői paraméterek (fűtési görbe, maximális előremenő hőmérséklet) szándékosan maradtak ki — a sablon nem módosítja a szabályozó szerelői beállításait.
- Az 1. zóna hűtése, a 2. és 3. zóna, valamint a heti időprogram nem része a sablonnak.
- A kültéri egység további értékei (beszívott levegő hőmérséklete, kompresszorkihasználtság, aktuális hőteljesítmény) elérhetők a buszon, de a sablon nem olvassa őket.
Hibaelhárítás
Egyáltalán nincs érték
Ellenőrizd, hogy a micro-ebusd aktiválva van-e, és a token nem járt-e le: micro-ebusd nélkül az adapter nem válaszol a /api/v1/ebus címen. Ellenőrizd, hogy a http://<adapter-ip>/api/v1/ebus/list megnyílik-e a böngészőben.
A szabályozó eszközei nem mutatnak értéket
A körnév nem egyezik. Nyisd meg a http://<adapter-ip>/api/v1/ebus/list címet, keresd meg a szabályozó (ctlv2, ctlv3 vagy 720) és a kültéri egység (hmu) nevét, és importáld újra a sablont ezekkel a nevekkel.
Az alapjel vagy az üzemmód visszaugrik a régi értékre
A szabályozó nem hajtotta végre az írást; a TapHome a buszról visszaolvasott értéket mutatja. Ellenőrizd a zóna üzemmódját és a szabályozó firmware-ét.
Controller error code: … modulhiba
A szabályozó ezzel a számmal jelez hibát. Keresd meg a szabályozó vagy a hőszivattyú dokumentációjában; a modulhiba eltűnik, amikor a szabályozó törli.