Szablon SVC to ogólna integracja Modbus TCP dla rewersyjnej pompy ciepła powietrze-woda, która udostępnia czujniki, wybór trybu oraz trzy termostaty (ogrzewanie, chłodzenie i ciepłą wodę użytkową) w sieci lokalnej. TapHome łączy się bezpośrednio z interfejsem Ethernet pompy ciepła — nie jest wymagane okablowanie RS-485 ani brama.

Tożsamość producenta nie jest potwierdzona. Ciąg SVC pochodzi z pola <Producer> oryginalnego szablonu XML TapHome i niemal na pewno jest ogólnym/whitelabel oznaczeniem, a nie marką konsumencką. Przed importem tego szablonu zweryfikuj, że twój sterownik używa dokładnie mapy rejestrów opisanej poniżej (holding register H:0–H:34, tryb w H:30 z wartościami 0–6, temperatura wody wyjściowej w H:8, nastawy termostatów ogrzewania/chłodzenia w H:31/H:32 ze skalowaniem ×1, nastawa termostatu zasobnika w H:33 ze skalowaniem ×10). Jeśli którykolwiek rejestr się nie zgadza, ten szablon błędnie odczyta lub skonfiguruje urządzenie.

Mapa rejestrów, lista trybów i skalowanie opisane na tej stronie są wyodrębnione bezpośrednio z kanonicznego pliku XML TapHome. Podręcznik producenta nie jest dostępny.

Połączenie sprzętowe#

Sterownik SVC korzysta z modelu CCU ModbusTcpCCU, co oznacza, że TapHome komunikuje się przez Modbus TCP bezpośrednio z interfejsem LAN pompy ciepła.

• Protokół: Modbus TCP
• Port: 502 (standardowy)
• Typ rejestru: wszystkie rejestry typu holding (H)
• Typ danych: wszystkie rejestry to Int16, big-endian
• Kolejność bajtów: standardowa Modbus (high byte first)
• Zakres rejestrów: H:0 – H:34 (rejestry 9–14, 17–19, 21–23 i 27–29 nie są wykorzystywane przez szablon i nie należy zakładać ich obecności w sterowniku)

Wymagania sieciowe

1. Podłącz port Ethernet/LAN pompy ciepła do tej samej sieci lokalnej, co TapHome Core.
2. Przypisz pompie ciepła stabilny adres IP — skonfiguruj statyczny IP na sterowniku lub dodaj rezerwację DHCP w routerze na podstawie adresu MAC. Domyślny adres szablonu 192.168.0.1 jest jedynie placeholderem.
3. Upewnij się, że żaden firewall pomiędzy TapHome Core a pompą ciepła nie blokuje portu TCP 502.

Szablon nie wykorzystuje wykrywania mDNS/Zeroconf — adres IP pompy ciepła należy wprowadzić ręcznie podczas importu.

Konfiguracja#

Włączenie komunikacji Modbus

Ponieważ producent tego sterownika jest nieznany, nie została tu udokumentowana żadna procedura specyficzna dla producenta. Ogólne podejście dla tej klasy sterowników pomp ciepła jest następujące:

1. Wejdź do menu serwisowego/instalatora na przewodowym panelu pompy ciepła lub na wbudowanym wyświetlaczu (zazwyczaj zabezpieczone kodem PIN).
2. Znajdź sekcję komunikacja lub ustawienia sieciowe.
3. Włącz Modbus TCP, jeśli nie jest aktywny domyślnie.
4. Ustaw adres IP (zalecany statyczny) oraz ewentualnie maskę podsieci i bramę.
5. Potwierdź lub ustaw Modbus slave (unit) ID — wartość domyślna szablonu to 1.
6. W razie potrzeby zapisz ustawienia i zrestartuj sterownik.

Dokładną ścieżkę w menu znajdziesz w instrukcji serwisowej dostarczonej z urządzeniem. Jeśli Modbus TCP nie jest dostępny w menu sterownika, tego szablonu nie można użyć.

Parametry importu

Przy importowaniu szablonu w TapHome podaj:

Przed importem zweryfikuj łączność z hosta TapHome Core, wykonując ping na adres IP pompy ciepła i — jeśli to możliwe — sondując port TCP 502 za pomocą narzędzia takiego jak nc lub klienta Modbus. Dzięki temu wychwycisz problemy sieciowe zanim pojawią się jako błędy na poziomie szablonu.

Mapa rejestrów#

Szablon udostępnia następujące rejestry typu holding. Wszystkie rejestry to Int16. Skalowanie temperatury /10 oznacza, że surowa wartość całkowita jest dzielona przez 10, aby uzyskać stopnie Celsjusza (np. surowa wartość 235 → 23,5 °C).

Asymetryczne skalowanie termostatów — łatwo przeoczyć. Termostat zasobnika CWU (H:33) używa skalowania ×10, natomiast termostat ogrzewania (H:31) i termostat chłodzenia (H:32) używają skalowania ×1. Oznacza to, że nastawa CWU obsługuje wartości dziesiętne (np. 48,5 °C), ale nastawy ogrzewania/chłodzenia są wyłącznie pełnymi stopniami. Ta asymetria pochodzi z firmware’u sterownika, a nie z TapHome.

Plik XML ustawia IsReadOnly=False na rejestrach H:15, H:16, H:20, H:24, H:25 i H:26, lecz dla żadnego z nich nie dostarczono formuły WriteState. Rejestry te są zatem przez szablon faktycznie tylko do odczytu.

Możliwości urządzeń#

Szablon udostępnia 20 urządzeń obejmujących czujniki, selektor trybu, trzy termostaty i parametr różnicy restartu.

Czujniki temperatury

Dziewięć czujników temperatury tylko do odczytu obejmuje obieg czynnika chłodniczego, obieg hydrauliczny oraz warunki otoczenia:

• Temperatura powietrza zewnętrznego (H:0) — temperatura powietrza zewnętrznego przy jednostce zewnętrznej.
• Temperatura zewnętrznego wymiennika (H:1) — wymiennik czynnika chłodniczego po stronie zewnętrznej (parownik w trybie grzania, skraplacz w trybie chłodzenia).
• Temperatura wewnętrznego wymiennika (H:6) — wymiennik czynnika chłodniczego po stronie wewnętrznej (skraplacz w trybie grzania, parownik w trybie chłodzenia).
• Temperatura tłoczenia sprężarki (H:2) — gorąca strona czynnika chłodniczego opuszczającego sprężarkę.
• Temperatura ssania sprężarki (H:3) — zimna strona czynnika chłodniczego wracającego do sprężarki.
• Temperatura wewnętrzna (reversed) (H:4) — wewnętrzny czujnik środowiskowy. Przyrostek (reversed) jest przeniesiony dosłownie z XML; bez dokumentacji producenta nie można potwierdzić jego dokładnego znaczenia — może wskazywać na odwróconą polaryzację czujnika lub umieszczenie skierowane do wewnątrz na jednostce zewnętrznej.
• Temperatura zasobnika CWU (H:5) — zasobnik ciepłej wody użytkowej. Rejestr ten jest także wykorzystywany jako źródło bieżącej temperatury dla termostatu CWU.
• Temperatura wody wejściowej (H:7) — woda wracająca z obiegu hydraulicznego do wymiennika.
• Temperatura wody wyjściowej (H:8) — woda opuszczająca wymiennik. Rejestr ten jest także wykorzystywany jako źródło bieżącej temperatury dla obu termostatów — ogrzewania i chłodzenia.

Wspólne źródło bieżącej temperatury. Rejestry H:5 (temperatura zasobnika) i H:8 (temperatura wody wyjściowej) są używane po dwa razy — raz jako samodzielny czujnik i drugi raz jako źródło bieżącej temperatury dla termostatu. Termostat ogrzewania i chłodzenia odczytują oba z H:8, dlatego szablon nie potrafi rozróżnić osobnej ‘bieżącej temperatury strefy’ dla ogrzewania i chłodzenia. Sterownik po prostu nie udostępnia niezależnych czujników stref.

Tryb pracy

Selektor trybu pracy (H:30, Read/Write) jest udostępniony jako multi-value switch z następującymi wartościami:

Wartości 71, 72 i 73 pojawiają się w XML jako placeholdery z surowymi nazwami cyfr ("7", "8", "9") — są zarezerwowane w firmware i nie powinny być używane.

Termostaty

Udostępnione są trzy termostaty, każdy jako osobne urządzenie TapHome z własną nastawą i wspólnym źródłem bieżącej temperatury:

• Termostat ogrzewania (H:31, Read/Write, skalowanie ×1) — nastawa z rozdzielczością pełnych stopni dla ogrzewania pomieszczeń. Bieżąca temperatura odczytywana jest z H:8 (woda wyjściowa).
• Termostat chłodzenia (H:32, Read/Write, skalowanie ×1) — nastawa z rozdzielczością pełnych stopni dla chłodzenia pomieszczeń. Bieżąca temperatura odczytywana jest również z H:8.
• Termostat zasobnika CWU (H:33, Read/Write, skalowanie ×10) — nastawa z rozdzielczością dziesiętną dla zasobnika CWU. Bieżąca temperatura odczytywana jest z H:5 (temperatura zasobnika). Informacja zwrotna o stanie zaworu nie jest dostępna (ReadValveState jest na stałe ustawiony na 0).

Wewnętrzna logika pompy ciepła decyduje o tym, czy aktywna jest nastawa ogrzewania czy chłodzenia, na podstawie wybranego trybu pracy w H:30. Zapis do rejestru nastawy samodzielnie nie przełącza jednostki między ogrzewaniem a chłodzeniem — najpierw zmień tryb, a następnie dostosuj odpowiednią nastawę.

Moc i ciśnienia czynnika chłodniczego

• Moc elektryczna (H:24) — chwilowe zużycie energii przez pompę ciepła w watach (W). Ponieważ rejestr to Int16, wartość obcina się przy ±32767 W; duże jednostki komercyjne mogą wykraczać poza ten zakres.
• Ciśnienie niskociśnieniowe (H:25) — ciśnienie czynnika chłodniczego po stronie ssawnej w kilopaskalach (kPa). Typowe wartości dla R410A/R32 po stronie niskociśnieniowej mieszczą się w zakresie ~100–700 kPa.
• Ciśnienie wysokociśnieniowe (H:26) — ciśnienie czynnika chłodniczego po stronie tłocznej w kilopaskalach (kPa). Typowe wartości dla R410A/R32 po stronie wysokociśnieniowej mieszczą się w zakresie ~1500–4500 kPa.

Zmienne stanu (surowe)

Trzy rejestry stanu są udostępnione jako surowe wartości Int16, ponieważ producent sterownika nie udokumentował dla nich maski bitowej ani wyliczenia:

• Output Status (H:15)
• Run Status (H:16)
• Stan zaworu głównego (H:20) — prawdopodobnie stan zaworu czterodrogowego (ścieżka czynnika chłodniczego dla ogrzewania vs chłodzenia), lecz ta interpretacja nie jest potwierdzona.

Wartości te można monitorować w celu wykrywania zmian, ale bez dokumentacji producenta nie da się ich przetłumaczyć na przyjazne dla użytkownika etykiety.

Parametr serwisowy

• Różnica temperatury restartu (H:34, Read/Write, surowa liczba całkowita w °C) — wartość histerezy określająca, o ile stopni poniżej aktywnej nastawy musi spaść temperatura, aby sprężarka ponownie się uruchomiła. Typowe sterowniki w tej klasie używają wartości z zakresu od 1 do 15 °C, jednak prawidłowy zakres dla tego konkretnego urządzenia nie został zweryfikowany.

Rozwiązywanie problemów#

Brak komunikacji Modbus

1. Sprawdź, czy port Ethernet pompy ciepła jest fizycznie podłączony i ma aktywne połączenie (sprawdź diodę LED stanu sieci na sterowniku, jeśli występuje).
2. Zweryfikuj adres IP — sprawdź menu ustawień sieciowych sterownika lub tabelę dzierżaw DHCP w routerze.
3. Upewnij się, że TapHome Core i pompa ciepła znajdują się w tej samej podsieci, lub że routing pomiędzy podsieciami zezwala na port TCP 502.
4. Sprawdź, czy żadna reguła firewalla lub VLAN nie blokuje portu 502.
5. Potwierdź, że Modbus TCP jest rzeczywiście włączony w menu serwisowym sterownika (niektóre sterowniki są dostarczane z wyłączoną tą funkcją).

Wartości wyglądają wyraźnie nieprawidłowo (zniekształcone temperatury, niemożliwe liczby)

Jeśli temperatury odczytywane są jako tysiące stopni, ciśnienia jako drobne liczby, a selektor trybu pokazuje nieznane wartości, twoja pompa ciepła najprawdopodobniej używa innej mapy rejestrów niż ta, której oczekuje ten szablon. Etykieta SVC obejmuje niezidentyfikowany sterownik OEM — inne pompy ciepła OEM (SPRSUN/Carel, Fairland, Gree Versati, Midea/Clivet/Kaisai, LG Therma V, Aermec, Sibotherm) używają różnych układów rejestrów. Nie pozostawiaj szablonu działającego przeciwko niezgodnemu urządzeniu, ponieważ zapisy do rejestrów trybu i termostatów mogłyby zmienić niepowiązane ustawienia.

Zmiany nastawy wyglądają na ‘połowione’ lub ‘dziesięciokrotne’

To niemal zawsze niezgodność skalowania. Termostat CWU (H:33) używa skalowania ×10, podczas gdy termostaty ogrzewania (H:31) i chłodzenia (H:32) używają skalowania ×1. Jeśli widzisz nastawę zastosowaną 10× większą lub mniejszą niż oczekiwana, upewnij się, że piszesz do właściwego termostatu — szablon już stosuje poprawne skalowanie dla każdego urządzenia, więc najbardziej prawdopodobną przyczyną jest to, że firmware sterownika różni się od zakładanej mapy.

Termostaty ogrzewania i chłodzenia pokazują tę samą bieżącą temperaturę

To oczekiwane zachowanie. Zarówno termostat ogrzewania, jak i chłodzenia odczytują bieżącą temperaturę z rejestru H:8 (temperatura wody wyjściowej). Szablon nie potrafi oddzielić ‘bieżącej temperatury strefy ogrzewania’ od ‘bieżącej temperatury strefy chłodzenia’, ponieważ sterownik udostępnia tylko jeden czujnik na wyjściu. Jeśli potrzebujesz odrębnych czujników strefowych, dodaj osobne czujniki temperatury TapHome (podłączone bezpośrednio do TapHome IO).

Odczyt mocy utknął na 32767 lub –32768

Rejestr H:24 dla mocy to 16-bitowa liczba całkowita ze znakiem, więc chwilowe zużycie powyżej 32 767 W (32,77 kW) przepełnia się. Dotyczy to tylko dużych jednostek komercyjnych — jednostki mieszkaniowe zwykle pozostają znacząco poniżej tego limitu.