TapHome

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

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 11. 2026

Vyžaduje externú bránu

eBUS Adapter (ebusd.eu) eBUS Adapter Shield or Stick C6 with micro-ebusd (HTTP JSON API, port 80) — stránka produktu

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

Š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

  1. Aktualizujte adaptér na najnovší firmvér (adapter.ebusd.eu).
  2. 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.
  3. 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

ParameterPredvolená hodnotaPopis
ADAPTER_IP(prázdne)IP adresa adaptéra eBUS
CONTROLLER_CIRCUITctlv2Meno okruhu regulátora z /api/v1/ebus/list
HEAT_SOURCE_CIRCUIThmuMeno 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žim day jeho 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útPopis
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ý stavStav, 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ší.

Dostupné zariadenia

sensoCOMFORT VRC 720 (ctlv2) Modul

sensoCOMFORT VRC 720 (ctlv2)

Čítanie (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
Vonkajšia teplota Teplotný senzor Len na čítanie

Vonkajšia teplota, ako ju ukazuje regulátor VRC 720

numeric Jednotka: °C

Vonkajšia teplota

Čítanie teploty
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);
Termostat zóny 1 Termostat

Izbová teplota a platná požadovaná teplota zóny 1; nová požadovaná teplota sa posiela ako quick veto — dočasná zmena, časový program ostáva, ako je

numeric Jednotka: °C

Termostat zóny 1

Čítanie teploty
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);
Čítanie požadovanej teploty
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);
Zápis požadovanej teploty
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");
Prevádzkový režim zóny 1 Viacstavový prepínač

Prevádzkový režim zóny 1 — Vypnuté, Auto (časový program), Ručne / Deň alebo Noc; na VRC 720 je režim day ručný režim a nočný režim tam nie je

enum numeric
Hodnoty / Stavy: Vypnuté · Auto · Ručne / Deň · Noc

Prevádzkový režim zóny 1

Čítanie stavu prepínača
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);
Zápis stavu prepínača
# 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
Termostat teplej úžitkovej vody Termostat

Teplota zásobníka teplej vody a požadovaná teplota teplej vody, nastaviteľná od 35 do 75 °C

numeric Jednotka: °C

Termostat teplej úžitkovej vody

Čítanie teploty
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);
Čítanie požadovanej teploty
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);
Zápis požadovanej teploty
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");
Prevádzkový režim teplej úžitkovej vody Viacstavový prepínač

Prevádzkový režim okruhu teplej vody — Vypnuté, Auto, Deň alebo Noc

enum numeric
Hodnoty / Stavy: Vypnuté · Auto · Deň · Noc

Prevádzkový režim teplej úžitkovej vody

Čítanie stavu prepínača
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);
Zápis stavu prepínača
# 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
Jednorazový ohrev teplej vody Prepínač

Jednorazový ohrev teplej vody — zapnutie spustí ohrev, po nahriatí zásobníka sa regulátor sám vráti do režimu auto

boolean
Hodnoty / Stavy: Active · OFF

Jednorazový ohrev teplej vody

Čítanie stavu prepínača
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);
Zápis stavu prepínača
# 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");
Teplota prívodu Teplotný senzor Len na čítanie

Teplota prívodu systému (vykurovacia voda), ako ju hlási regulátor VRC 720

numeric Jednotka: °C

Teplota prívodu

Čítanie teploty
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);
Tlak vody Premenná Len na čítanie

Tlak vody vo vykurovacej sústave v baroch

numeric Jednotka: bar

Tlak vody

Čítanie
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);
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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.

Zdroje

  • 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

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Komunita — nepreverené

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli