--- title: "Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd)" description: "Steruj Vaillant aroTHERM plus z regulatorem VRC 720 z TapHome przez eBUS — temperatura pomieszczenia i ciepłej wody, tryby, moc i energia, bez chmury." url: "https://taphome.com/pl/compatibility/vaillant-ebus-micro-ebusd-http/" language: pl lastmod: 2026-11-04 generator: hugo ai: topics: ["http","heat-pump","ebus","rest-api","gateway","wifi","dhw"] questions: ["Czy istnieje szablon TapHome dla pomp ciepła Vaillant?","Jak najprościej sterować pompą ciepła Vaillant z TapHome?","Jak podłączyć Vaillant aroTHERM plus z regulatorem sensoCOMFORT VRC 720 do TapHome przez eBUS?","Do czego służy token micro-ebusd adaptera eBUS C6?","Jakich nazw obwodów potrzebuje szablon Vaillant?","Dlaczego wartość zadana zapisana z TapHome na VRC 720 wraca do starej wartości?"] --- # Vaillant aroTHERM plus + sensoCOMFORT VRC 720 (eBUS, micro-ebusd) Komunikacja: Packet Parser → HTTP - [Oficjalna strona Vaillant](https://www.vaillant.com) - [Strona produktu Vaillant aroTHERM plus](https://www.vaillant.com/en/products/arothermplus/) - [eBUS Adapter Shield C6 i Stick C6](https://adapter.ebusd.eu/v5-c6/) Szablon Vaillant aroTHERM plus łączy TapHome z pompą ciepła powietrze-woda Vaillant aroTHERM plus i jej regulatorem systemowym sensoCOMFORT VRC 720 przez adapter eBUS Adapter Shield lub Stick C6 firmy ebusd.eu. Adapter jest podłączony do magistrali eBUS regulatora i działa na nim micro-ebusd, który dekoduje komunikaty Vaillant i udostępnia je przez lokalne HTTP JSON API. TapHome komunikuje się tylko z adapterem w sieci lokalnej; chmura nie jest używana. Szablon odczytuje temperaturę zewnętrzną, pomieszczenia, zasilania i ciepłej wody, ciśnienie wody, moc i zużycie energii pompy ciepła oraz błędy regulatora. Ustawia zadaną temperaturę pomieszczenia strefy 1, zadaną temperaturę ciepłej wody, tryby pracy strefy 1 i ciepłej wody oraz uruchamia jednorazowe podgrzanie ciepłej wody. > [!WARNING] > **Szablon społeczności — jeszcze nie przetestowany z TapHome na prawdziwym adapterze.** Szablon powstał w portalu TapHome na podstawie dokumentacji micro-ebusd i definicji komunikatów ebusd dla VRC 720 i aroTHERM plus. Przetestowano go tylko z symulatorem adaptera na lokalnym TapHome Core 2025.2, nie z prawdziwym adapterem, regulatorem ani pompą ciepła, a doświadczenia z praktyki są mile widziane. Pobierz XML z tej strony lub z portalu TapHome: [Vaillant aroTHERM plus + VRC 720 — szablon społeczności](https://portal.taphome.com/portal/community/vaillant-ebus-micro-ebusd-http), i zaimportuj go jako nowy moduł. **[Vaillant heat pump and VRC 720 controller through the eBUS Adapter C6 with micro-ebusd (HTTP)](https://portal.taphome.com/pl/portal/community/vaillant-ebus-micro-ebusd-http)** — Vaillant, HTTP. Vaillant aroTHERM plus with the sensoCOMFORT VRC 720 through the eBUS Adapter C6 running micro-ebusd: outdoor, room, flow and hot water temperatures, room setpoint as a temporary override, zone and hot water modes, hot water boost, water pressure, heat pump power and energy, controller errors. Szablon uzupełnia oficjalny szablon TapHome [eBUS Adapter Shield C6 Stick](https://taphome.com/pl/compatibility/ebus-adapter-shield-c6-stick/), który przez MQTT pokazuje stan samego adaptera (sygnał magistrali, usługę, temperaturę); oba mogą działać obok siebie. Nie jest powiązany z szablonem społeczności dla klimakonwektora Vaillant aroVAIR, który używa Modbus RTU. ## Czego potrzebujesz - **Vaillant aroTHERM plus** z regulatorem **sensoCOMFORT VRC 720** na magistrali eBUS. - **eBUS Adapter Shield C6 lub Stick C6** ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)) z najnowszym firmware i aktywowanym **micro-ebusd**. micro-ebusd to płatna funkcja adaptera odblokowywana tokenem; każdy adapter otrzymuje jedną 30-dniową licencję próbną. - Adapter i TapHome Core w tej samej sieci lokalnej. ## Połączenie sprzętowe Adapter podłącza się do dwóch zacisków eBUS regulatora VRC 720; polaryzacja magistrali eBUS nie ma znaczenia. aroTHERM plus komunikuje się z regulatorem po tej samej magistrali, więc do jednostki zewnętrznej nie trzeba prowadzić żadnego przewodu. Przed pracą na zaciskach regulatora odłącz zasilanie sieciowe. Podłącz adapter do sieci lokalnej zgodnie z jego dokumentacją i zarezerwuj jego adres IP w routerze, aby TapHome zawsze go znalazł. ## Konfiguracja ### Aktywacja micro-ebusd 1. Zaktualizuj adapter do najnowszego firmware ([adapter.ebusd.eu](https://adapter.ebusd.eu/v5-c6/)). 2. Uzyskaj token micro-ebusd na [token.ebusd.eu](https://token.ebusd.eu/) (jedna 30-dniowa licencja próbna na adapter, potem płatnie) i wprowadź go w interfejsie webowym adaptera. 3. Po aktywacji HTTP JSON API odpowiada pod adresem `http:///api/v1/ebus`. ### Ustalenie nazw obwodów micro-ebusd adresuje każdą wartość obwodem i nazwą komunikatu. Otwórz w przeglądarce `http:///api/v1/ebus/list`: wyświetla obwody i komunikaty, które adapter znalazł na magistrali. Regulator sensoCOMFORT VRC 720 zgłasza się, zależnie od wersji, jako `ctlv2`, `ctlv3` lub `720`, jednostka zewnętrzna aroTHERM plus jako `hmu`. Okno importu podaje też `700` dla VRC 700; szablon napisano według definicji komunikatów regulatora VRC 720. ### Parametry importu | Parametr | Wartość domyślna | Opis | |---|---|---| | `ADAPTER_IP` | (puste) | Adres IP adaptera eBUS | | `CONTROLLER_CIRCUIT` | `ctlv2` | Nazwa obwodu regulatora z `/api/v1/ebus/list` | | `HEAT_SOURCE_CIRCUIT` | `hmu` | Nazwa obwodu jednostki zewnętrznej aroTHERM plus | Import tworzy dwa moduły na tym samym adapterze: **sensoCOMFORT VRC 720 (ctlv2)** z ośmioma urządzeniami oraz **aroTHERM plus (hmu)** z licznikiem energii elektrycznej pompy ciepła. ## Możliwości urządzeń ### Temperatury i ciśnienie - **Temperatura zewnętrzna** — temperatura zewnętrzna wskazywana przez VRC 720. - **Temperatura zasilania** — temperatura zasilania instalacji (zasilanie ogrzewania). - **Ciśnienie wody** — ciśnienie wody w instalacji grzewczej w barach (tylko do odczytu). ### Strefa 1 - **Termostat strefy 1** — temperatura pomieszczenia i wartość zadana, której regulator faktycznie używa. Wartość zadana ustawiona w TapHome (5–30 °C) jest wysyłana jako **quick veto**: tymczasowa zmiana, program czasowy regulatora pozostaje bez zmian. Po zapisie szablon ponownie odczytuje wartość z magistrali. - **Tryb pracy strefy 1** — Wyłączony, Auto (program czasowy), Ręczny / Dzień i Noc. Szablon wysyła nazwy z definicji ebusd (`off`, `auto`, `day`, `night`). Na VRC 720 tryb `day` jest jego trybem ręcznym, a trybu nocnego VRC 720 nie ma. ### Ciepła woda - **Termostat ciepłej wody użytkowej** — temperatura zasobnika ciepłej wody i zadana temperatura ciepłej wody, regulowana od 35 do 75 °C. - **Tryb pracy ciepłej wody użytkowej** — Wyłączony, Auto, Dzień lub Noc. - **Jednorazowe podgrzanie ciepłej wody** — włączenie uruchamia podgrzewanie; po nagrzaniu zasobnika regulator sam wraca do trybu auto, a przełącznik znów pokazuje wyłączony. ### Energia elektryczna pompy ciepła Moduł **aroTHERM plus (hmu)** ma jedno urządzenie, **Licznik energii elektrycznej pompy ciepła**, licznik jednostki zewnętrznej: - **Pobór mocy** — aktualna moc elektryczna pompy ciepła w kW. - **Całkowite zużycie** — całkowite zużycie energii elektrycznej pompy ciepła w kWh. Licznik jest liczbą 16-bitową (najwyżej 65535 kWh), więc w jednostce pracującej od wielu lat mógł już zacząć liczyć od zera. Pokazuje też trzy atrybuty serwisowe: | Atrybut serwisowy | Opis | |---|---| | COP (ogrzewanie) | Współczynnik efektywności pompy ciepła podczas ogrzewania | | Całkowity uzysk ciepła [kWh] | Całkowity uzysk ciepła pompy ciepła — energia cieplna, a nie elektryczna | | Stan pracy | Stan zgłaszany przez jednostkę zewnętrzną: `ready`, `heating`, `cooling`, `heating_water` lub `error` | ### Błędy regulatora Moduł **sensoCOMFORT VRC 720 (ctlv2)** w każdym cyklu odczytuje bieżące błędy regulatora. Dla każdego z jego pięciu pól błędów, które nie jest zerem, moduł pokazuje błąd z numerem błędu, na przykład `Controller error code: 1025`. ### Jak szablon komunikuje się z adapterem Każda wartość to jeden komunikat z definicji ebusd. Szablon odczytuje go przez `GET /api/v1/ebus/{circuit}/{message}/get?from=1`, które odpowiada z pamięci podręcznej adaptera lub pyta magistralę, i bierze z odpowiedzi `data.fields.value`. Zapis to `PUT /api/v1/ebus/{circuit}/{message}/set` z treścią `{"fields":{"value":…}}`, a po nim odczyt z `from=2`, który zawsze pyta magistralę. Moduły i wszystkie urządzenia odczytują co 60 s. Żadne z urządzeń nic nie zapisuje przy starcie TapHome Core: stan przejmują z adaptera, a nie z ostatniej wartości w TapHome. > [!NOTE] > **Niektóre wersje firmware VRC 720 potwierdzają zapis, ale go nie wykonują.** Ponieważ szablon po każdym zapisie ponownie odczytuje wartość z magistrali, TapHome pokazuje potem wartość, której regulator faktycznie używa, a nie tę, którą ustawiłeś. ### Czego szablon nie robi - **Parametry instalatora** (krzywa grzewcza, maksymalna temperatura zasilania) są celowo pominięte — szablon nie zmienia ustawień instalatora w regulatorze. - Chłodzenie strefy 1, strefy 2 i 3 oraz tygodniowy program czasowy nie są częścią szablonu. - Dalsze wartości jednostki zewnętrznej (temperatura powietrza zasysanego, wykorzystanie sprężarki, aktualna moc cieplna) są dostępne na magistrali, ale nie są odczytywane. ## Rozwiązywanie problemów ### Brak jakichkolwiek wartości Sprawdź, czy micro-ebusd jest aktywowany i czy token nie wygasł: bez micro-ebusd adapter nie odpowiada pod `/api/v1/ebus`. Sprawdź, czy `http:///api/v1/ebus/list` otwiera się w przeglądarce. ### Urządzenia regulatora nie pokazują wartości Nazwa obwodu się nie zgadza. Otwórz `http:///api/v1/ebus/list`, znajdź nazwę regulatora (`ctlv2`, `ctlv3` lub `720`) i jednostki zewnętrznej (`hmu`) i zaimportuj szablon ponownie z tymi nazwami. ### Wartość zadana lub tryb wraca do starej wartości Regulator nie wykonał zapisu; TapHome pokazuje wartość odczytaną z powrotem z magistrali. Sprawdź tryb pracy strefy i firmware regulatora. ### Błąd modułu `Controller error code: …` Regulator zgłasza błąd o tym numerze. Wyszukaj go w dokumentacji regulatora lub pompy ciepła; błąd modułu znika, gdy regulator go skasuje. ## Dostępne urządzenia sensoCOMFORT VRC 720 (ctlv2) Moduł Temperatura zewnętrzna Czujnik temperatury Tylko do odczytu Temperatura zewnętrzna wskazywana przez regulator VRC 720 numeric Jednostka: °C Termostat strefy 1 Termostat Temperatura pomieszczenia i aktywna wartość zadana strefy 1; nowa wartość zadana jest wysyłana jako quick veto — tymczasowa zmiana, program czasowy pozostaje bez zmian numeric Jednostka: °C Tryb pracy strefy 1 Przełącznik wielowartościowy Tryb pracy strefy 1 — Wyłączony, Auto (program czasowy), Ręczny / Dzień lub Noc; na VRC 720 tryb day jest trybem ręcznym, a trybu nocnego nie ma enum numeric Wartości / Stany: Wyłączony · Auto · Ręczny / Dzień · Noc Termostat ciepłej wody użytkowej Termostat Temperatura zasobnika ciepłej wody i zadana temperatura ciepłej wody, regulowana od 35 do 75 °C numeric Jednostka: °C Tryb pracy ciepłej wody użytkowej Przełącznik wielowartościowy Tryb pracy obwodu ciepłej wody — Wyłączony, Auto, Dzień lub Noc enum numeric Wartości / Stany: Wyłączony · Auto · Dzień · Noc Jednorazowe podgrzanie ciepłej wody Przełącznik Jednorazowe podgrzanie ciepłej wody — włączenie uruchamia podgrzewanie, po nagrzaniu zasobnika regulator sam wraca do trybu auto boolean Wartości / Stany: Active · OFF Temperatura zasilania Czujnik temperatury Tylko do odczytu Temperatura zasilania instalacji (zasilanie ogrzewania) zgłaszana przez regulator VRC 720 numeric Jednostka: °C Ciśnienie wody Zmienna Tylko do odczytu Ciśnienie wody w instalacji grzewczej w barach numeric Jednostka: bar **Połączenie:** Packet Parser → HTTP Możliwe ulepszenia (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. ## Źródła - micro-ebusd HTTP JSON API (get, set, list, from=0/1/2, token) [token.ebusd.eu](https://token.ebusd.eu/api) 2026-11-04 - ebusd message definitions — Vaillant sensoCOMFORT VRC 720 (15.ctlv2.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/15.ctlv2.csv) 2026-11-04 - ebusd message definitions — Vaillant aroTHERM plus outdoor unit (08.hmu.csv) [ebus.github.io](https://ebus.github.io/en/vaillant/08.hmu.csv) 2026-11-04 - ebusd configuration — Vaillant index [ebus.github.io](https://ebus.github.io/en/vaillant/) 2026-11-04 - micro-ebusd MQTT documentation [token.ebusd.eu](https://token.ebusd.eu/mqtt) 2026-11-04 ## Powiązana dokumentacja - [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)