SolaX X3-Ultra (X3-ULT-15K, 20K, 25K, 30K) to trójfazowy falownik hybrydowy do PV i baterii. Ten szablon społecznościowy autorstwa Martina Kellera łączy go z TapHome przez Modbus RTU na porcie RS-485 COM 1 (19200 bodów, 8N1) i opiera się na rejestrach odczytu protokołu SolaX Modbus V3.29 oraz na protokole SolaX Modbus V001.02. Zapewnia pełny zestaw liczników dla Energy Dashboard, monitorowanie baterii, sieci i błędów, ustawienia falownika zapisywane tylko wtedy, gdy ich wartość naprawdę się zmienia, oraz zdalne sterowanie mocą AC (tryb 1 zdalnego sterowania SolaX) — ładowanie baterii z sieci lub rozładowanie jej do sieci na polecenie, na przykład według cen spot energii elektrycznej.
Jak uzyskać szablon
Szablony społecznościowe nie są oferowane na liście szablonów w aplikacji TapHome. Zaloguj się na portal.taphome.com, pobierz XML tego szablonu i zaimportuj go do Core na interfejsie Modbus RTU (albo na interfejsie Modbus TCP, gdy używasz bramy RS-485-Ethernet). Do monitorowania bez zdalnego sterowania mocą dostępny jest oficjalny szablon SolaX X3 Hybrid Ultra. Moduł zaimportowany wcześniej z oficjalnego szablonu nie aktualizuje się sam — zaimportuj ten szablon jako nowy moduł i usuń stary.
Połączenie sprzętowe
X3-Ultra ma jeden wielofunkcyjny port COM 1 (złącze RJ45 z oznakowanym mocowaniem kabla). Te same fizyczne piny pełnią różne funkcje w zależności od tego, która oznakowana pozycja mocowania kabla jest użyta. Do integracji Modbus innej firmy użyj pozycji RS485 — linii REMOTE_485A i REMOTE_485B.
Pinout portu COM 1

Przypisanie pinów pozycji RS485 (jedynej pozycji istotnej dla TapHome):
| Pin | Sygnał | Okablowanie TapHome |
|---|---|---|
| 1 | REMOTE_485A | A+ / D+ |
| 2 | REMOTE_485B | B− / D− |
| 3 | PARALLEL_485AA | nie używać (tylko akcesoria SolaX) |
| 4 | PARALLEL_485AA | nie używać (tylko akcesoria SolaX) |
| 5 | PARALLEL_485BB | nie używać (tylko akcesoria SolaX) |
| 6 | PARALLEL_485BB | nie używać (tylko akcesoria SolaX) |
| 7 | REMOTE_485A | ten sam sygnał co pin 1 |
| 8 | REMOTE_485B | ten sam sygnał co pin 2 |
Piny 3–6 należą do kanału SolaX PARALLEL_485 i są zarezerwowane dla produktów SolaX (Adapter Box G2, EV-Charger, DataHub). Piny 1, 2, 7 i 8 są przeznaczone dla urządzeń innych niż produkty SolaX. Nie podłączaj mastera Modbus innej firmy do pinów 3–6.
Okablowanie RS-485

Zasady okablowania z instrukcji obsługi X3-Ultra (sekcja 8.6.4):
- Typ kabla: kabel sieciowy CAT5E lub CAT6
- Maksymalna długość: kabel komunikacyjny RS-485 nie może przekraczać 30 m
- Wtyk RJ45: istniejący wtyk kabla należy odciąć i zacisnąć nowy wtyk RJ45 zgodnie z przypisaniem pinów; nie wszystkie urządzenia akceptują w pełni okablowany 8-żyłowy kabel sieciowy
- Pozycja w mocowaniu kabla: wtyk RJ45 wkłada się do gniazda oznaczonego RS485 (nie do Parallel-1, Parallel-2, BMS-1, BMS-2 ani DRM); złącze zatrzaskuje się w porcie COM 1 i jest zabezpieczone nakrętką obrotową
- Jeden master Modbus: z portu może korzystać tylko jeden master Modbus. Odłącz inne monitorowanie Modbus na tym samym porcie, w przeciwnym razie falownik odpowiada obu i odczyty stają się niestabilne
Instrukcja obsługi nie podaje zasady terminacji magistrali RS-485 na pozycji RS485 portu COM 1.
Licznik lub CT dla wartości sieci
Urządzenia sieciowe tego szablonu (Grid - power balance, Z sieci, Do sieci, Konsumpcja) odczytują moc oddawaną do sieci, którą falownik mierzy własnym licznikiem lub CT. Licznik lub CT podłącza się do portu COM 2 (Meter/CT: METER_485A na pinie 4, METER_485B na pinie 5 albo wejścia CT) i konfiguruje na wyświetlaczu falownika w Menu → Setting → Advance Setting → Meter/CT Setting. To osobna linia RS-485 — nie podłączaj do niej TapHome.
Opcje połączenia
- Bezpośrednie połączenie Modbus RTU: podłącz parę RS485 portu COM 1 bezpośrednio do magistrali RS-485 TapHome Core. Najniższe opóźnienie, zalecane do zdalnego sterowania mocą.
- Brama RS-485-Ethernet: gdy falownik jest daleko od TapHome Core, można użyć bramy RS-485-Ethernet innej firmy na parze RS485 portu COM 1; szablon importuje się wtedy na interfejsie Modbus TCP.
- Moduł monitorujący SolaX: sam falownik nie obsługuje Modbus TCP. Modbus TCP (port 502) jest dostępny tylko przez moduł monitorujący SolaX, z cyklem zapytań około 1 sekundy (protokół V3.29).
Konfiguracja
Włączanie komunikacji Modbus na falowniku
Na wyświetlaczu LCD falownika przejdź do:
| |
Menu Advance Setting wymaga hasła instalatora (według instrukcji obsługi początkowo 2014; instrukcja zaleca jego zmianę). W menu Modbus ustaw Baud Rate i Address zewnętrznego protokołu komunikacyjnego:
| Parametr | Domyślnie w szablonie | Domyślnie w falowniku (protokół V3.29) |
|---|---|---|
| Adres Modbus (Slave ID) | 1 | 1 |
| Prędkość transmisji | 19200 | 19200 |
| Parzystość | None | None |
| Bity danych | 8 | 8 |
| Bity stopu | 1 | 1 |
Prędkość transmisji musi być taka sama w falowniku i w interfejsie Modbus RTU TapHome. Jeśli komunikacja zawodzi, najpierw sprawdź prędkość transmisji.
Falownik podaje też adres Modbus w rejestrze holding H:0x00AF i prędkość transmisji w rejestrze holding H:0x00B0 (protokół V3.29).
Parametr importu
Podczas importu szablonu parametr importu Modbus Slave ID (domyślnie 1) musi być zgodny z adresem Modbus ustawionym na wyświetlaczu falownika.
Możliwości urządzenia
Energy Dashboard
| Urządzenie | Odczyt |
|---|---|
| Produkcja fotowoltaiczna | Moc wejściowa PV1 + PV2 + PV3 (A:0x000A, A:0x000B, A:0x0124) w kW; całkowita energia PV (A:0x0094–0x0095) w kWh. Moc PV1–PV3 i całkowita energia wyjściowa AC falownika (A:0x0052) są atrybutami serwisowymi. |
| Z sieci / Do sieci | Część poboru i oddawania mocy sieci z licznika lub CT (A:0x0046–0x0047, młodsze słowo najpierw) wraz z ich licznikami energii całkowitej (A:0x004A i A:0x0048, 0,01 kWh). |
| Do akumulatora / Z baterii | Część ładowania i rozładowania mocy baterii 1 (A:0x0016) wraz z całkowitą energią ładowania i rozładowania (A:0x0021, A:0x001D). |
| Konsumpcja | Obliczone zużycie domu: moc AC falownika minus moc oddawana do sieci. SolaX nie ma rejestru zużycia; odbiorniki na wyjściu EPS (zasilanie awaryjne) nie są uwzględnione. |
| Bateria (SOC) | Stan naładowania baterii 1 (A:0x001C). Pozostała energia i energia możliwa do naładowania (A:0x0118, A:0x0116) są atrybutami serwisowymi. |
Menedżer energii
Dla smart rule Menedżer energii wybierz Grid - power balance. Ma ono znak: dodatni przy poborze z sieci, ujemny przy oddawaniu nadwyżki. Liczniki Z sieci i Do sieci nigdy nie są ujemne i nie pokazują nadwyżki.
Monitorowanie
- Battery 2 - state of charge — drugie przyłącze baterii (BAT 2), z jego mocą i temperaturą jako atrybutami serwisowymi; bez drugiej baterii odczytuje 0
- Battery - temperature — odczytywana jako wartość ze znakiem, więc temperatury poniżej 0 °C są pokazywane poprawnie
- Inverter - AC power — suma mocy trzech faz na porcie AC falownika w kW
- Grid - voltage L1 — z napięciem sieci L2, L3 i trzema częstotliwościami sieci jako atrybutami serwisowymi
Ustawienia falownika
| Urządzenie | Odczyt | Zapis |
|---|---|---|
| Settings - work mode | H:0x008B: Self use, Feed-in priority, Backup, Manual, Peak shaving, Time of use (dwa ostatnie zależą od firmware) | 0x001F |
| Settings - manual mode | H:0x008C: Stop charge and discharge, Force charge, Force discharge (działa tylko w trybie pracy Manual) | 0x0020 |
| Settings - self-use minimum SOC | starszy bajt H:0x0093 | 0x0061 |
| Settings - night charge from grid | młodszy bajt H:0x0093 | 0x0062 |
| Settings - night charge target SOC | H:0x0094 | 0x0063 |
| Settings - export limit | H:0x00B6, w kW (10 W na jednostkę w X3) | 0x0042 |
SolaX odczytuje te ustawienia z innych adresów, niż je zapisuje, dlatego nie można użyć wbudowanej funkcji TapHome „zapisuj tylko przy różnicy”. Każdy skrypt zapisu najpierw odczytuje więc ustawienie i zapisuje (funkcja 06) tylko wtedy, gdy nowa wartość jest inna; gdy falownik zgłasza ustawienia jako zablokowane, najpierw zapisuje hasło ustawień 2014 do rejestru 0x0000. Minimalny SOC i docelowy SOC ładowania nocnego nigdy nie spadają poniżej 10 % (zakres SolaX). Żadne z tych urządzeń nie zapisuje okresowo.
Te ustawienia to rejestry EEPROM (SolaX oznacza je ★, około 1 miliona cykli zapisu). Zmieniaj je rzadko i nigdy z częstych automatyzacji — do ładowania i rozładowania według cen spot używaj Remote control - AC power target.
Remote control - AC power target
To urządzenie korzysta z trybu 1 zdalnego sterowania SolaX (VPP) — sterowania mocą na porcie AC falownika.
- Znak: dodatni cel oznacza, że falownik pobiera moc na swoim porcie AC (ładuje baterię, z sieci, jeśli PV nie wystarcza); ujemny cel oznacza, że oddaje moc (rozładowuje baterię, a to, czego dom nie zużyje, trafia do sieci). Wartość w kW.
- 0 kończy zdalne sterowanie: szablon jednorazowo zapisuje tryb 0 i falownik wraca do swojego trybu pracy. Cele poniżej 0,5 W liczą się jako 0.
- Każda inna wartość: jeśli falownik jest zablokowany, szablon najpierw zapisuje hasło ustawień 2014 (odblokowanie ginie po każdym restarcie falownika), a następnie zapisuje 13 rejestrów
0x007C–0x0088w jednym żądaniu Modbus (funkcja 0x10): tryb 1, cel, czas trwania 120 s i limit czasu 60 s. Polecenie jest powtarzane co 60 s, dopóki cel nie wynosi 0. Jeśli TapHome przestanie je wysyłać, falownik utrzymuje cel do 2 minut, przez kolejną 1 minutę utrzymuje 0 W na swoim porcie AC, a potem sam wraca do swojego trybu pracy. - Tryb pracy Manual blokuje zdalne sterowanie. SolaX nie uruchamia zdalnego sterowania, dopóki falownik jest w trybie pracy Manual — najpierw przełącz go na Self use (lub inny tryb).
- Falownik ogranicza cel do zakresu pokazanego w atrybutach modułu (minimalny i maksymalny cel zdalnego sterowania).
- Akcja modułu End remote control natychmiast zapisuje tryb 0. Dopóki cel nie wynosi 0, kolejne powtórzenie ponownie uruchamia zdalne sterowanie — ustaw cel na 0, aby zakończyć je na dobre.
- Nie łącz tego urządzenia ze zdalnym sterowaniem z SolaX Cloud ani od agregatora energii: gdy cel wynosi 0, szablon kończy każdy tryb zdalnego sterowania w ciągu 60 s.
- Zdalne sterowanie wymaga Core, który zapisuje wszystkie 13 rejestrów w jednym żądaniu. Tak jest w każdym Core od 2022 roku, jeśli moduł zachowuje
MaxPrefetchGroupSize32 z tego szablonu. - Atrybut serwisowy Actual AC power pokazuje moc czynną, którą falownik raportuje na swoim porcie AC, w W (
A:0x0106).
SolaX w swoim protokole nie oznacza rejestrów zdalnego sterowania (
0x007C–0x0088) jako rejestrów EEPROM, ale też nie potwierdza na piśmie, że nimi nie są. Ten szablon opiera się na doświadczeniach społeczności Home Assistant i openHAB, które zapisują te rejestry co kilka sekund do kilku minut.
Atrybuty i akcje modułu
- Run mode (atrybut serwisowy) — stan falownika jako tekst: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle, Standby, Remote control (kod 20); inne kody są pokazywane jako Other
- Machine type (atrybut serwisowy) — X1 (single-phase) lub X3 (three-phase), rejestr holding
H:0x0105 - Settings lock (atrybut serwisowy) — Locked lub Unlocked (
A:0x0054) - Remote control mode (atrybut serwisowy) — aktywny tryb zdalnego sterowania (
A:0x0100): Off, Power control, Energy target, SOC target - Remote control - maximum target / minimum target (atrybuty serwisowe) — dozwolony zakres celu mocy raportowany przez falownik w W (
A:0x010A,A:0x010C) - Unlock settings (password 2014) (akcja serwisowa) — zapisuje
2014do rejestru0x0000 - End remote control (akcja serwisowa) — zapisuje tryb 0 do rejestrów zdalnego sterowania
0x007C–0x0088
Wykrywanie błędów
Skrypt odczytu modułu zgłasza błąd TapHome, gdy stan pracy (A:0x0009) wynosi 3 (Fault) lub 4 (Permanent fault). Analizuje też bit po bicie dwa rejestry błędów, każdy błąd z własnym kodem błędu:
- Kod błędu falownika (32-bitowy,
A:0x0040–A:0x0041, odczytywany młodszym słowem najpierw) — wszystkie 32 bity, od TZ Protect Fault, błędów napięcia sieci, PV, szyny DC i baterii, błędów izolacji i przegrzania po Parallel Fault, Hard Limit Fault i błędy przekaźników - Kod błędu Managera (16-bitowy,
A:0x0043) — Power Type Fault, Mgr EEPROM Fault, NTC Sample Invalid, niska i wysoka temperatura baterii, Meter Fault, Bypass Relay Fault i Fan 2 Fault jako błędy, Port OC Warning jako ostrzeżenie
Rozwiązywanie problemów
Brak komunikacji z falownikiem
- Sprawdź, czy przewody RS-485 są na pinach REMOTE_485A / REMOTE_485B (1 + 2 lub 7 + 8 w pozycji RS485 mocowania kabla COM 1), a nie na pinach PARALLEL_485 3–6 ani na linii licznika portu COM 2
- Sprawdź, czy prędkość transmisji jest zgodna między falownikiem (
Menu → Setting → Advance Setting → Modbus) a interfejsem Modbus RTU TapHome — domyślnie 19200 - Potwierdź, że parametr importu Modbus Slave ID jest zgodny z adresem Modbus falownika (domyślnie
1) - Upewnij się, że do portu podłączony jest tylko jeden master Modbus
- Zamień przewody A i B, jeśli polaryzacja kabla jest niepewna
- Potwierdź, że kabel RS-485 nie przekracza 30 m
Cel zdalnego sterowania wraca do 0 zaraz po ustawieniu
Falownik jest w trybie pracy Manual, firmware nie obsługuje trybu 1 zdalnego sterowania albo cel jest poza minimalnym i maksymalnym celem pokazanym w atrybutach modułu. Najpierw sprawdź tryb pracy.
Zapis ustawień jest odrzucany
Falownik jest zablokowany. Uruchom akcję modułu Unlock settings (password 2014); blokada wraca po każdym restarcie falownika (atrybut modułu Settings lock).
Wartości sieci wynoszą 0 lub Konsumpcja wygląda źle
Grid - power balance, Z sieci, Do sieci i Konsumpcja zależą od licznika lub CT falownika. Sprawdź jego okablowanie na porcie COM 2 i konfigurację w Menu → Setting → Advance Setting → Meter/CT Setting.
Moc PV3 lub Bateria 2 pokazuje 0
PV3 istnieje tylko w modelach z trzema trackerami (na przykład X3-ULT-25K i X3-ULT-30K, patrz liczba MPPT w instrukcji obsługi); Bateria 2 tylko wtedy, gdy do BAT 2 podłączona jest druga bateria. Ukryj nieużywane urządzenia w TapHome.
SolaX