
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.
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, i zaimportuj go jako nowy moduł.
Szablon uzupełnia oficjalny szablon TapHome 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) 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
- Zaktualizuj adapter do najnowszego firmware (adapter.ebusd.eu).
- Uzyskaj token micro-ebusd na token.ebusd.eu (jedna 30-dniowa licencja próbna na adapter, potem płatnie) i wprowadź go w interfejsie webowym adaptera.
- Po aktywacji HTTP JSON API odpowiada pod adresem
http://<adapter-ip>/api/v1/ebus.
Ustalenie nazw obwodów
micro-ebusd adresuje każdą wartość obwodem i nazwą komunikatu. Otwórz w przeglądarce http://<adapter-ip>/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 trybdayjest 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.
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://<adapter-ip>/api/v1/ebus/list otwiera się w przeglądarce.
Urządzenia regulatora nie pokazują wartości
Nazwa obwodu się nie zgadza. Otwórz http://<adapter-ip>/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.