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

Packet Parser → HTTP

Přidal

Poslední aktualizace: 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)

Šablona Vaillant aroTHERM plus připojí TapHome k tepelnému čerpadlu vzduch-voda Vaillant aroTHERM plus a k jeho systémovému regulátoru sensoCOMFORT VRC 720 přes adaptér eBUS Adapter Shield nebo Stick C6 od ebusd.eu. Adaptér je na sběrnici eBUS regulátoru a běží na něm micro-ebusd, který dekóduje zprávy Vaillant a nabízí je přes lokální HTTP JSON API. TapHome komunikuje jen s adaptérem v lokální síti; cloud se nepoužívá.

Šablona čte venkovní, pokojovou, přívodní teplotu a teplotu teplé vody, tlak vody, příkon a spotřebu tepelného čerpadla a poruchy regulátoru. Nastavuje požadovanou pokojovou teplotu zóny 1, požadovanou teplotu teplé vody, provozní režimy zóny 1 a teplé vody a spouští jednorázový ohřev teplé vody.

Komunitní šablona — zatím neotestovaná s TapHome na skutečném adaptéru. Šablona vznikla v portálu TapHome z dokumentace micro-ebusd a z definic zpráv ebusd pro VRC 720 a aroTHERM plus. Otestovaná byla jen se simulátorem adaptéru na lokálním TapHome Core 2025.2, ne se skutečným adaptérem, regulátorem ani tepelným čerpadlem, a zkušenosti z praxe jsou vítané. XML si stáhněte na této stránce nebo z portálu TapHome: Vaillant aroTHERM plus + VRC 720 — komunitní šablona, a importujte ho jako nový modul.

Šablona · portál TapHome Komunita Beta · neověřená

Vaillant heat pump and VRC 720 controller through the eBUS Adapter C6 with micro-ebusd (HTTP)

Autor: Martin Keller

HTTP Zobrazit v portálu TapHome

Šablona doplňuje oficiální šablonu TapHome eBUS Adapter Shield C6 Stick, která přes MQTT ukazuje stav samotného adaptéru (signál sběrnice, démon, teplotu); obě mohou běžet vedle sebe. S komunitní šablonou pro fan-coil Vaillant aroVAIR, která používá Modbus RTU, nesouvisí.

Co potřebujete

Vaillant aroTHERM plus s regulátorem sensoCOMFORT VRC 720 na sběrnici eBUS.
eBUS Adapter Shield C6 nebo Stick C6 (adapter.ebusd.eu) s nejnovějším firmwarem a aktivovaným micro-ebusd. micro-ebusd je placená funkce adaptéru, kterou odemkne token; každý adaptér dostane jednu 30denní zkušební licenci.
Adaptér a TapHome Core v téže lokální síti.

Hardwarové připojení

Adaptér se připojuje ke dvěma svorkám eBUS na regulátoru VRC 720; na polaritě sběrnice eBUS nezáleží. aroTHERM plus komunikuje s regulátorem po téže sběrnici, takže k venkovní jednotce není potřeba žádný vodič. Před prací na svorkách regulátoru odpojte síťové napájení.

Adaptér připojte do lokální sítě podle dokumentace adaptéru a jeho IP adresu si rezervujte v routeru, aby ho TapHome vždy našel.

Konfigurace

Aktivace micro-ebusd

Aktualizujte adaptér na nejnovější firmware (adapter.ebusd.eu).
Získejte token micro-ebusd na token.ebusd.eu (jedna 30denní zkušební licence na adaptér, poté placený) a zadejte ho ve webovém rozhraní adaptéru.
Po aktivaci odpovídá HTTP JSON API na http://<adapter-ip>/api/v1/ebus.

Zjištění názvů okruhů

micro-ebusd adresuje každou hodnotu okruhem a názvem zprávy. Otevřete v prohlížeči http://<adapter-ip>/api/v1/ebus/list: zobrazí okruhy a zprávy, které adaptér našel na sběrnici. Regulátor sensoCOMFORT VRC 720 se podle verze hlásí jako ctlv2, ctlv3 nebo 720, venkovní jednotka aroTHERM plus jako hmu. Dialog importu uvádí i 700 pro VRC 700; šablona byla napsána podle definic zpráv regulátoru VRC 720.

Parametry importu

Parametr	Výchozí hodnota	Popis
`ADAPTER_IP`	(prázdné)	IP adresa adaptéru eBUS
`CONTROLLER_CIRCUIT`	`ctlv2`	Název okruhu regulátoru z `/api/v1/ebus/list`
`HEAT_SOURCE_CIRCUIT`	`hmu`	Název okruhu venkovní jednotky aroTHERM plus

Import vytvoří dva moduly na témže adaptéru: sensoCOMFORT VRC 720 (ctlv2) s osmi zařízeními a aroTHERM plus (hmu) s elektroměrem tepelného čerpadla.

Možnosti zařízení

Teploty a tlak

Venkovní teplota — venkovní teplota, jak ji zobrazuje VRC 720.
Teplota přívodu — teplota přívodu systému (topná voda).
Tlak vody — tlak vody v otopné soustavě v barech (jen pro čtení).

Zóna 1

Termostat zóny 1 — pokojová teplota a požadovaná teplota, kterou regulátor skutečně používá. Požadovaná teplota nastavená v TapHome (5–30 °C) se posílá jako quick veto: dočasná změna, časový program regulátoru zůstává, jak je. Po zápisu šablona hodnotu znovu přečte ze sběrnice.
Provozní režim zóny 1 — Vypnuto, Auto (časový program), Ručně / Den a Noc. Šablona posílá názvy z definice 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 teplé užitkové vody — teplota zásobníku teplé vody a požadovaná teplota teplé vody, nastavitelná od 35 do 75 °C.
Provozní režim teplé užitkové vody — Vypnuto, Auto, Den nebo Noc.
Jednorázový ohřev teplé vody — zapnutí spustí ohřev; po nahřátí zásobníku se regulátor sám vrátí do režimu auto a přepínač pak znovu ukáže vypnuto.

Elektřina tepelného čerpadla

Modul aroTHERM plus (hmu) má jedno zařízení, Elektroměr tepelného čerpadla, elektroměr venkovní jednotky:

Odběr — aktuální elektrický příkon tepelného čerpadla v kW.
Celková spotřeba — celková spotřeba elektřiny tepelného čerpadla v kWh. Počítadlo je 16bitové číslo (nejvýše 65535 kWh), takže na jednotce, která běží mnoho let, už mohlo začít znovu od nuly.

Ukazuje také tři servisní atributy:

Servisní atribut	Popis
COP (vytápění)	Topný faktor tepelného čerpadla při vytápění
Celkový tepelný zisk [kWh]	Celkový tepelný zisk tepelného čerpadla — tepelná energie, ne elektřina
Provozní stav	Stav, který hlásí venkovní jednotka: `ready`, `heating`, `cooling`, `heating_water` nebo `error`

Poruchy regulátoru

Modul sensoCOMFORT VRC 720 (ctlv2) v každém cyklu čte aktuální poruchy regulátoru. Pro každé z jeho pěti polí poruch, které není nula, zobrazí modul chybu s číslem poruchy, například Controller error code: 1025.

Jak šablona komunikuje s adaptérem

Každá hodnota je jedna zpráva z definice ebusd. Šablona ji čte přes GET /api/v1/ebus/{circuit}/{message}/get?from=1, které odpoví z vyrovnávací paměti adaptéru nebo se zeptá sběrnice, a z odpovědi bere data.fields.value. Zápis je PUT /api/v1/ebus/{circuit}/{message}/set s tělem {"fields":{"value":…}} a po něm čtení s from=2, které se vždy ptá sběrnice. Moduly i všechna zařízení čtou každých 60 s.

Žádné ze zařízení nic nezapíše při startu TapHome Core: stav berou z adaptéru, ne z poslední hodnoty v TapHome.

Některé verze firmwaru VRC 720 zápis potvrdí a neprovedou. Šablona po každém zápisu hodnotu znovu přečte ze sběrnice, takže TapHome pak ukáže hodnotu, kterou regulátor skutečně používá, ne tu, kterou jste nastavili.

Co šablona nedělá

Instalatérské parametry (topná křivka, maximální teplota přívodu) jsou vynechány záměrně — šablona nemění instalatérská nastavení regulátoru.
Chlazení zóny 1, zóny 2 a 3 a týdenní časový program nejsou součástí šablony.
Další hodnoty venkovní jednotky (teplota nasávaného vzduchu, využití kompresoru, aktuální tepelný výkon) jsou na sběrnici dostupné, ale šablona je nečte.

Řešení problémů

Žádné hodnoty

Zkontrolujte, zda je micro-ebusd aktivovaný a token nevypršel: bez micro-ebusd adaptér na /api/v1/ebus neodpovídá. Zkontrolujte, zda se http://<adapter-ip>/api/v1/ebus/list otevře v prohlížeči.

Zařízení regulátoru neukazují hodnotu

Název okruhu nesedí. Otevřete http://<adapter-ip>/api/v1/ebus/list, najděte název regulátoru (ctlv2, ctlv3 nebo 720) a venkovní jednotky (hmu) a šablonu importujte znovu s těmito názvy.

Požadovaná teplota nebo režim se vrátí na starou hodnotu

Regulátor zápis neprovedl; TapHome ukazuje hodnotu přečtenou zpět ze sběrnice. Zkontrolujte provozní režim zóny a firmware regulátoru.

Chyba modulu `Controller error code: …`

Regulátor hlásí poruchu s tímto číslem. Vyhledejte ji v dokumentaci regulátoru nebo tepelného čerpadla; chyba modulu zmizí, když ji regulátor zruší.

Dostupná zařízení

sensoCOMFORT VRC 720 (ctlv2) Modul

sensoCOMFORT VRC 720 (ctlv2)

Čtení (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

Venkovní teplota Teplotní senzor Pouze ke čtení

Venkovní teplota, jak ji zobrazuje regulátor VRC 720

numeric Jednotka: °C

Venkovní teplota

Čtení 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

Pokojová teplota a platná požadovaná teplota zóny 1; nová požadovaná teplota se posílá jako quick veto — dočasná změna, časový program zůstává, jak je

numeric Jednotka: °C

Termostat zóny 1

Čtení 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);

Čtení požadované 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žadované 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");

Provozní režim zóny 1 Vícestavový přepínač

Provozní režim zóny 1 — Vypnuto, Auto (časový program), Ručně / Den nebo Noc; na VRC 720 je režim day ruční režim a noční režim tam není

enum numeric

Hodnoty / Stavy: Vypnuto · Auto · Ručně / Den · Noc

Provozní režim zóny 1

Čtení stavu přepínače

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 přepínače

# 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 teplé užitkové vody Termostat

Teplota zásobníku teplé vody a požadovaná teplota teplé vody, nastavitelná od 35 do 75 °C

numeric Jednotka: °C

Termostat teplé užitkové vody

Čtení 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);

Čtení požadované 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žadované 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");

Provozní režim teplé užitkové vody Vícestavový přepínač

Provozní režim okruhu teplé vody — Vypnuto, Auto, Den nebo Noc

enum numeric

Hodnoty / Stavy: Vypnuto · Auto · Den · Noc

Provozní režim teplé užitkové vody

Čtení stavu přepínače

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 přepínače

# 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

Jednorázový ohřev teplé vody Přepínač

Jednorázový ohřev teplé vody — zapnutí spustí ohřev, po nahřátí zásobníku se regulátor sám vrátí do režimu auto

boolean

Hodnoty / Stavy: Active · OFF

Jednorázový ohřev teplé vody

Čtení stavu přepínače

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 přepínače

# 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 přívodu Teplotní senzor Pouze ke čtení

Teplota přívodu systému (topná voda), jak ji hlásí regulátor VRC 720

numeric Jednotka: °C

Teplota přívodu

Čtení 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 Proměnná Pouze ke čtení

Tlak vody v otopné soustavě v barech

numeric Jednotka: bar

Tlak vody

Čtení

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);

Připojení: Packet Parser → HTTP

Možná vylepšení (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.

Stáhnout šablonu

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 jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Komunita — neověřeno

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu

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

Co potřebujete

Hardwarové připojení

Konfigurace

Aktivace micro-ebusd

Zjištění názvů okruhů

Parametry importu

Možnosti zařízení

Teploty a tlak

Zóna 1

Teplá voda

Elektřina tepelného čerpadla

Poruchy regulátoru

Jak šablona komunikuje s adaptérem

Co šablona nedělá

Řešení problémů

Žádné hodnoty

Zařízení regulátoru neukazují hodnotu

Požadovaná teplota nebo režim se vrátí na starou hodnotu

Chyba modulu `Controller error code: …`

Dostupná zařízení

Zdroje

Našli jste problém s touto šablonou zařízení?

Nahlásit problém s tímto zařízením

Chcete to použít ve svém TapHome jádře?

Nechte nám kontakt — pošleme vám odpověď

Pokračujte na WhatsApp

Zpráva dorazila

Kód vypršel

Požadavek je u podpory

Hledáme testery nové verze

Děkujeme, brzy se vám ozveme

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

Co potřebujete#

Hardwarové připojení#

Konfigurace#

Aktivace micro-ebusd

Zjištění názvů okruhů

Parametry importu

Možnosti zařízení#

Teploty a tlak

Zóna 1

Teplá voda

Elektřina tepelného čerpadla

Poruchy regulátoru

Jak šablona komunikuje s adaptérem

Co šablona nedělá

Řešení problémů#

Žádné hodnoty

Zařízení regulátoru neukazují hodnotu

Požadovaná teplota nebo režim se vrátí na starou hodnotu

Chyba modulu Controller error code: …

Dostupná zařízení

sensoCOMFORT VRC 720 (ctlv2)

Venkovní teplota

Termostat zóny 1

Provozní režim zóny 1

Termostat teplé užitkové vody

Provozní režim teplé užitkové vody

Jednorázový ohřev teplé vody

Teplota přívodu

Tlak vody

Zdroje

Našli jste problém s touto šablonou zařízení?

Nahlásit problém s tímto zařízením

Chcete to použít ve svém TapHome jádře?

Co potřebujete

Hardwarové připojení

Konfigurace

Možnosti zařízení

Řešení problémů

Chyba modulu `Controller error code: …`