TapHome

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

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 11. 2026

Potreban je vanjski pristupnik (gateway)

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

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

Predložak Vaillant aroTHERM plus povezuje TapHome s dizalicom topline zrak-voda Vaillant aroTHERM plus i njezinim sustavnim regulatorom sensoCOMFORT VRC 720 preko adaptera eBUS Adapter Shield ili Stick C6 tvrtke ebusd.eu. Adapter je na sabirnici eBUS regulatora i na njemu radi micro-ebusd, koji dekodira poruke Vaillant i nudi ih preko lokalnog HTTP JSON API-ja. TapHome komunicira samo s adapterom u lokalnoj mreži; oblak se ne koristi.

Predložak čita vanjsku, sobnu i temperaturu polaza te temperaturu tople vode, tlak vode, snagu i potrošnju dizalice topline i greške regulatora. Podešava zadanu sobnu temperaturu zone 1, zadanu temperaturu tople vode, načine rada zone 1 i tople vode te pokreće jednokratno zagrijavanje tople vode.

Predložak zajednice — još nije testiran s TapHome na stvarnom adapteru. Predložak je izrađen u portalu TapHome iz dokumentacije micro-ebusd i definicija poruka ebusd za VRC 720 i aroTHERM plus. Testiran je samo sa simulatorom adaptera na lokalnom TapHome Core 2025.2, ne sa stvarnim adapterom, regulatorom ni dizalicom topline, a iskustva s terena su dobrodošla. XML preuzmite na ovoj stranici ili iz portala TapHome: Vaillant aroTHERM plus + VRC 720 — predložak zajednice, i uvezite ga kao novi modul.

Predložak dopunjuje službeni TapHome predložak eBUS Adapter Shield C6 Stick, koji preko MQTT-a prikazuje stanje samog adaptera (signal sabirnice, servis, temperaturu); oba mogu raditi jedan uz drugi. Nije povezan s predloškom zajednice za ventilokonvektor Vaillant aroVAIR, koji koristi Modbus RTU.

Što vam treba

  • Vaillant aroTHERM plus s regulatorom sensoCOMFORT VRC 720 na sabirnici eBUS.
  • eBUS Adapter Shield C6 ili Stick C6 (adapter.ebusd.eu) s najnovijim firmverom i aktiviranim micro-ebusd. micro-ebusd je plaćena funkcija adaptera koju otključava token; svaki adapter dobiva jednu probnu licencu od 30 dana.
  • Adapter i TapHome Core u istoj lokalnoj mreži.

Hardversko spajanje

Adapter se spaja na dvije stezaljke eBUS regulatora VRC 720; polaritet sabirnice eBUS nije važan. aroTHERM plus komunicira s regulatorom po istoj sabirnici, pa do vanjske jedinice nije potreban vodič. Prije rada na stezaljkama regulatora isključite mrežno napajanje.

Adapter spojite u lokalnu mrežu kako je opisano u dokumentaciji adaptera i rezervirajte njegovu IP adresu u usmjerivaču, kako bi ga TapHome uvijek pronašao.

Konfiguracija

Aktivacija micro-ebusd

  1. Ažurirajte adapter na najnoviji firmver (adapter.ebusd.eu).
  2. Nabavite token micro-ebusd na token.ebusd.eu (jedna probna licenca od 30 dana po adapteru, zatim se plaća) i unesite ga u web sučelje adaptera.
  3. Nakon aktivacije HTTP JSON API odgovara na http://<adapter-ip>/api/v1/ebus.

Pronalaženje naziva krugova

micro-ebusd svaku vrijednost adresira krugom i nazivom poruke. U pregledniku otvorite http://<adapter-ip>/api/v1/ebus/list: prikazuje krugove i poruke koje je adapter pronašao na sabirnici. Regulator sensoCOMFORT VRC 720 javlja se ovisno o verziji kao ctlv2, ctlv3 ili 720, vanjska jedinica aroTHERM plus kao hmu. Dijalog uvoza navodi i 700 za VRC 700; predložak je napisan prema definicijama poruka regulatora VRC 720.

Parametri uvoza

ParametarZadana vrijednostOpis
ADAPTER_IP(prazno)IP adresa eBUS adaptera
CONTROLLER_CIRCUITctlv2Naziv kruga regulatora iz /api/v1/ebus/list
HEAT_SOURCE_CIRCUIThmuNaziv kruga vanjske jedinice aroTHERM plus

Uvoz stvara dva modula na istom adapteru: sensoCOMFORT VRC 720 (ctlv2) s osam uređaja i aroTHERM plus (hmu) s brojilom električne energije dizalice topline.

Mogućnosti uređaja

Temperature i tlak

  • Vanjska temperatura — vanjska temperatura kako je prikazuje VRC 720.
  • Temperatura polaza — temperatura polaza sustava (polaz grijanja).
  • Tlak vode — tlak vode u sustavu grijanja u barima (samo za čitanje).

Zona 1

  • Termostat zone 1 — sobna temperatura i zadana vrijednost koju regulator stvarno koristi. Zadana vrijednost postavljena u TapHome (5–30 °C) šalje se kao quick veto: privremena promjena, vremenski program regulatora ostaje kakav jest. Nakon upisa predložak ponovno čita vrijednost sa sabirnice.
  • Način rada zone 1 — Isključeno, Auto (vremenski program), Ručno / Dan i Noć. Predložak šalje nazive iz definicije ebusd (off, auto, day, night). Na VRC 720 način day je njegov ručni način, a noćni način VRC 720 nema.

Topla voda

  • Termostat potrošne tople vode — temperatura spremnika tople vode i zadana temperatura tople vode, podesiva od 35 do 75 °C.
  • Način rada potrošne tople vode — Isključeno, Auto, Dan ili Noć.
  • Jednokratno zagrijavanje tople vode — uključivanje pokreće zagrijavanje; kad se spremnik zagrije, regulator se sam vraća na auto, a prekidač tada ponovno pokazuje isključeno.

Električna energija dizalice topline

Modul aroTHERM plus (hmu) ima jedan uređaj, Brojilo električne energije dizalice topline, brojilo vanjske jedinice:

  • Snaga — trenutna električna snaga dizalice topline u kW.
  • Ukupna potrošnja — ukupna potrošnja električne energije dizalice topline u kWh. Brojač je 16-bitni broj (najviše 65535 kWh), pa je na jedinici koja radi mnogo godina možda već ponovno krenuo od nule.

Prikazuje i tri servisna atributa:

Servisni atributOpis
COP (grijanje)Faktor učinkovitosti dizalice topline pri grijanju
Ukupni toplinski prinos [kWh]Ukupni toplinski prinos dizalice topline — toplinska energija, a ne električna
Radno stanjeStanje koje javlja vanjska jedinica: ready, heating, cooling, heating_water ili error

Greške regulatora

Modul sensoCOMFORT VRC 720 (ctlv2) u svakom ciklusu čita trenutne greške regulatora. Za svako od njegovih pet polja grešaka koje nije nula modul prikazuje grešku s brojem greške, na primjer Controller error code: 1025.

Kako predložak komunicira s adapterom

Svaka vrijednost je jedna poruka iz definicije ebusd. Predložak je čita s GET /api/v1/ebus/{circuit}/{message}/get?from=1, koji odgovara iz međuspremnika adaptera ili pita sabirnicu, i iz odgovora uzima data.fields.value. Upis je PUT /api/v1/ebus/{circuit}/{message}/set s tijelom {"fields":{"value":…}}, a nakon njega slijedi čitanje s from=2, koje uvijek pita sabirnicu. Moduli i svi uređaji čitaju svakih 60 s.

Nijedan uređaj ništa ne upisuje pri pokretanju centralne jedinice TapHome Core: stanje preuzimaju od adaptera, a ne od posljednje vrijednosti u TapHome.

Neke verzije firmvera VRC 720 potvrde upis, ali ga ne izvrše. Budući da predložak nakon svakog upisa ponovno čita vrijednost sa sabirnice, TapHome tada prikazuje vrijednost koju regulator stvarno koristi, a ne onu koju ste postavili.

Što predložak ne radi

  • Instalaterski parametri (krivulja grijanja, najviša temperatura polaza) namjerno su izostavljeni — predložak ne mijenja instalaterske postavke regulatora.
  • Hlađenje zone 1, zone 2 i 3 te tjedni vremenski program nisu dio predloška.
  • Ostale vrijednosti vanjske jedinice (temperatura usisnog zraka, iskorištenost kompresora, trenutni toplinski učinak) dostupne su na sabirnici, ali se ne čitaju.

Rješavanje problema

Nema nikakvih vrijednosti

Provjerite je li micro-ebusd aktiviran i nije li token istekao: bez micro-ebusd adapter ne odgovara na /api/v1/ebus. Provjerite otvara li se http://<adapter-ip>/api/v1/ebus/list u pregledniku.

Uređaji regulatora ne prikazuju vrijednost

Naziv kruga ne odgovara. Otvorite http://<adapter-ip>/api/v1/ebus/list, pronađite naziv regulatora (ctlv2, ctlv3 ili 720) i vanjske jedinice (hmu) i ponovno uvezite predložak s tim nazivima.

Zadana vrijednost ili način rada vrati se na staru vrijednost

Regulator nije izvršio upis; TapHome prikazuje vrijednost ponovno pročitanu sa sabirnice. Provjerite način rada zone i firmver regulatora.

Greška modula Controller error code: …

Regulator javlja grešku s tim brojem. Potražite je u dokumentaciji regulatora ili dizalice topline; greška modula nestaje kad je regulator poništi.

Dostupni uređaji

sensoCOMFORT VRC 720 (ctlv2) Modul

sensoCOMFORT VRC 720 (ctlv2)

Čitanje (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
Vanjska temperatura Senzor temperature Samo za čitanje

Vanjska temperatura kako je prikazuje regulator VRC 720

numeric Jedinica: °C

Vanjska temperatura

Čitanje temperature
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 zone 1 Termostat

Sobna temperatura i aktivna zadana vrijednost zone 1; nova zadana vrijednost šalje se kao quick veto — privremena promjena, vremenski program ostaje kakav jest

numeric Jedinica: °C

Termostat zone 1

Čitanje temperature
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);
Čitanje željene temperature
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);
Zapis željene temperature
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");
Način rada zone 1 Prekidač s više vrijednosti

Način rada zone 1 — Isključeno, Auto (vremenski program), Ručno / Dan ili Noć; na VRC 720 način day je ručni način, a noćnog načina nema

enum numeric
Vrijednosti / stanja: Isključeno · Auto · Ručno / Dan · Noć

Način rada zone 1

Čitanje stanja sklopke
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);
Zapis stanja sklopke
# 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 potrošne tople vode Termostat

Temperatura spremnika tople vode i zadana temperatura tople vode, podesiva od 35 do 75 °C

numeric Jedinica: °C

Termostat potrošne tople vode

Čitanje temperature
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);
Čitanje željene temperature
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);
Zapis željene temperature
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");
Način rada potrošne tople vode Prekidač s više vrijednosti

Način rada kruga tople vode — Isključeno, Auto, Dan ili Noć

enum numeric
Vrijednosti / stanja: Isključeno · Auto · Dan · Noć

Način rada potrošne tople vode

Čitanje stanja sklopke
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);
Zapis stanja sklopke
# 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
Jednokratno zagrijavanje tople vode Sklopka

Jednokratno zagrijavanje tople vode — uključivanje pokreće zagrijavanje, a kad se spremnik zagrije, regulator se sam vraća na auto

boolean
Vrijednosti / stanja: Active · OFF

Jednokratno zagrijavanje tople vode

Čitanje stanja sklopke
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);
Zapis stanja sklopke
# 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");
Temperatura polaza Senzor temperature Samo za čitanje

Temperatura polaza sustava (polaz grijanja) kako je javlja regulator VRC 720

numeric Jedinica: °C

Temperatura polaza

Čitanje temperature
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 vode Varijabla Samo za čitanje

Tlak vode u sustavu grijanja u barima

numeric Jedinica: bar

Tlak vode

Čitanje
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);
Povezivanje: Packet Parser → HTTP
Moguća poboljšanja (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.

Izvori

  • 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

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Zajednica · nije provjereno

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu