TapHome

Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 11. 2026

Külső átjáró szükséges

eBUS Adapter (ebusd.eu) eBUS Adapter Shield or Stick C6 with micro-ebusd (HTTP JSON API, port 80) — termékoldal

Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)

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

  1. Frissítsd az adaptert a legújabb firmware-re (adapter.ebusd.eu).
  2. 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.
  3. Az aktiválás után a HTTP JSON API a http://<adapter-ip>/api/v1/ebus cí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éterAlapértelmezett értékLeírás
ADAPTER_IP(üres)Az eBUS adapter IP-címe
CONTROLLER_CIRCUITctlv2A szabályozó körneve a /api/v1/ebus/list listából
HEAT_SOURCE_CIRCUIThmuAz 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 a day mó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útumLeí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állapotA 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.

Elérhető eszközök

sensoCOMFORT VRC 720 (ctlv2) Modul

sensoCOMFORT VRC 720 (ctlv2)

Olvasás (modul)
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Currenterror/get?from=1");
IF response.IsSuccess
  VAR e0 := PARSEJSON(response.Content, "data.fields.error", true);
  VAR e1 := PARSEJSON(response.Content, "data.fields.error_1", true);
  VAR e2 := PARSEJSON(response.Content, "data.fields.error_2", true);
  VAR e3 := PARSEJSON(response.Content, "data.fields.error_3", true);
  VAR e4 := PARSEJSON(response.Content, "data.fields.error_4", true);
  IF !ISNULL(e0)
    IF e0 != 0
      ADDERROR(0, "Controller error code: " + e0);
    END
  END
  IF !ISNULL(e1)
    IF e1 != 0
      ADDERROR(1, "Controller error_1 code: " + e1);
    END
  END
  IF !ISNULL(e2)
    IF e2 != 0
      ADDERROR(2, "Controller error_2 code: " + e2);
    END
  END
  IF !ISNULL(e3)
    IF e3 != 0
      ADDERROR(3, "Controller error_3 code: " + e3);
    END
  END
  IF !ISNULL(e4)
    IF e4 != 0
      ADDERROR(4, "Controller error_4 code: " + e4);
    END
  END
END
Külső hőmérséklet Hőmérséklet-érzékelő Csak olvasható

A külső hőmérséklet, ahogy a VRC 720 szabályozó mutatja

numeric Egység: °C

Külső hőmérséklet

Hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/DisplayedOutsideTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
1. zóna termosztátja Termosztát

Az 1. zóna szobahőmérséklete és érvényes alapjele; az új alapjel quick veto formában megy — ideiglenes változtatás, az időprogram változatlan marad

numeric Egység: °C

1. zóna termosztátja

Hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1RoomTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Kívánt hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1ActualRoomTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Kívánt hőmérséklet írása
VAR body := "{\"fields\":{\"value\":" + Se + "}}";
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1QuickVetoTemp/set", "PUT", body, "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1QuickVetoTemp/get?from=2");
1. zóna üzemmódja Többértékű kapcsoló

Az 1. zóna üzemmódja — Ki, Auto (időprogram), Kézi / Nappal vagy Éjszaka; a VRC 720-on a day mód a kézi mód, éjszakai mód nincs

enum numeric
Értékek / Állapotok: Ki · Auto · Kézi / Nappal · Éjszaka

1. zóna üzemmódja

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/get?from=1");
IF response.IsSuccess
  # micro-ebusd returns the name of the value from the ebusd definition (off, auto, day, night); a number is accepted too
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "off" OR v = "0"
    RETURN(0);
  END
  IF v = "auto" OR v = "1"
    RETURN(1);
  END
  IF v = "day" OR v = "manual" OR v = "2"
    RETURN(2);
  END
  IF v = "night" OR v = "3"
    RETURN(3);
  END
END
RETURN(NaN);
Kapcsoló állapot írása
# Names from the ebusd definition; on the VRC 720 "day" is the manual mode
VAR name := SWITCH(Mu, 0, "off", 1, "auto", 2, "day", 3, "night", "");
IF name != ""
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
  # Read back from the bus: a write the controller ignored shows the real mode at the next read
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/Z1OpMode/get?from=2");
END
Használati melegvíz termosztát Termosztát

A melegvíztároló hőmérséklete és a melegvíz alapjele, 35 és 75 °C között állítható

numeric Egység: °C

Használati melegvíz termosztát

Hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcStorageTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Kívánt hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Kívánt hőmérséklet írása
VAR body := "{\"fields\":{\"value\":" + Se + "}}";
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/set", "PUT", body, "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcTempDesired/get?from=2");
Használati melegvíz üzemmód Többértékű kapcsoló

A melegvízkör üzemmódja — Ki, Auto, Nappal vagy Éjszaka

enum numeric
Értékek / Állapotok: Ki · Auto · Nappal · Éjszaka

Használati melegvíz üzemmód

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/get?from=1");
IF response.IsSuccess
  # micro-ebusd returns the name of the value from the ebusd definition (off, auto, day, night); a number is accepted too
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "off" OR v = "0"
    RETURN(0);
  END
  IF v = "auto" OR v = "1"
    RETURN(1);
  END
  IF v = "day" OR v = "manual" OR v = "2"
    RETURN(2);
  END
  IF v = "night" OR v = "3"
    RETURN(3);
  END
END
RETURN(NaN);
Kapcsoló állapot írása
# Names from the ebusd definition; on the VRC 720 "day" is the manual mode
VAR name := SWITCH(Mu, 0, "off", 1, "auto", 2, "day", 3, "night", "");
IF name != ""
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
  # Read back from the bus: a write the controller ignored shows the real mode at the next read
  SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcOpMode/get?from=2");
END
Egyszeri melegvíz-töltés Kapcsoló

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

boolean
Értékek / Állapotok: Active · OFF

Egyszeri melegvíz-töltés

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/get?from=1");
IF response.IsSuccess
  VAR v := TOSTRING(PARSEJSON(response.Content, "data.fields.value", true));
  IF v = "load" OR v = "6"
    RETURN(1);
  END
  RETURN(0);
END
RETURN(NaN);
Kapcsoló állapot írása
# load = one-time hot water charge; the controller returns to auto by itself when the tank is charged
VAR name := IF(St, "load", "auto");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/set", "PUT", "{\"fields\":{\"value\":\"" + name + "\"}}", "Content-Type: application/json");
SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/HwcSFMode/get?from=2");
Előremenő hőmérséklet Hőmérséklet-érzékelő Csak olvasható

A rendszer előremenő hőmérséklete (fűtési előremenő), ahogy a VRC 720 szabályozó jelenti

numeric Egység: °C

Előremenő hőmérséklet

Hőmérséklet olvasása
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/SystemFlowTemp/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Víznyomás Változó Csak olvasható

A fűtési rendszer víznyomása barban

numeric Egység: bar

Víznyomás

Olvasás
VAR response := SENDHTTPREQUEST("/api/v1/ebus/" + "$[CONTROLLER_CIRCUIT]" + "/WaterPressure/get?from=1");
IF response.IsSuccess
  RETURN(PARSEJSON(response.Content, "data.fields.value", true));
END
RETURN(NaN);
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (5)
  • Cooling of zone 1 — The controller definition has cooling setpoints for the zone and the heating circuit; the template covers heating only.
  • Installer parameters (heat curve, maximum flow temperature) — Left out on purpose — installer settings of the controller are not changed from TapHome.
  • Weekly time programme — Reading and editing the weekly schedule of the zone and the hot water is not part of the template.
  • Further heat pump values — Air intake temperature, compressor utilisation and current heat output of the outdoor unit.
  • Further zones — The template covers zone 1 only.

Források

  • micro-ebusd HTTP JSON API (get, set, list, from=0/1/2, token)
    token.ebusd.eu 2026-11-04
  • ebusd message definitions — Vaillant sensoCOMFORT VRC 720 (15.ctlv2.csv)
    ebus.github.io 2026-11-04
  • ebusd message definitions — Vaillant aroTHERM plus outdoor unit (08.hmu.csv)
    ebus.github.io 2026-11-04
  • ebusd configuration — Vaillant index
    ebus.github.io 2026-11-04
  • micro-ebusd MQTT documentation
    token.ebusd.eu 2026-11-04

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

Közösség — felülvizsgálatlan

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon