SolaX
SolaX X1-HYBRID i X3-HYBRID Gen 4 to falowniki hybrydowe do magazynowania energii z PV i baterią, dostępne w wersjach jednofazowych (3–7,5 kW) i trójfazowych (5–15 kW). Ten szablon społeczności to oficjalny szablon TapHome dla SolaX Gen 4 z odczytami poprawionymi według protokołu SolaX Modbus (V3.21 i V001.02). Komunikuje się przez Modbus RTU po RS-485 i odczytuje stan naładowania oraz temperaturę baterii, moc łańcuchów PV, przepływ mocy sieciowej, sumy energii, tryb ładowania i SOC ładowania nocnego. Nazwy urządzeń są takie same jak w oficjalnym szablonie, więc starszy import można porównać urządzenie po urządzeniu. Wszystkie skrypty zapisu pozostają zakomentowane, tak jak w oficjalnym szablonie, dlatego szablon działa tylko do odczytu.
Moduł analizuje również 32-bitowy kod błędu falownika i 16-bitowy kod błędu menedżera i zgłasza każdą usterkę w TapHome z własnym kodem błędu.
Jak zdobyć szablon
Szablony społeczności 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 jednostki sterującej Core. Moduł zaimportowany wcześniej z oficjalnego szablonu SolaX Hybrid X1/X3 Gen 4 nie aktualizuje się sam — zaimportuj ten szablon jako nowy moduł albo popraw skrypty starego modułu tak, jak pokazuje tabela w sekcji „Co poprawia ten szablon” poniżej.
Podłączenie sprzętu
Falownik SolaX Gen 4 ma na dolnym panelu port COM RS-485 do komunikacji Modbus RTU. Port COM wykorzystuje złącze RJ45.
Przypisanie pinów terminala COM (RJ45):
| Pin | Przypisanie | Opis |
|---|---|---|
| 1 | Drycontact_A(in) | Podłączenie wyłącznika systemowego |
| 2 | Drycontact_B(in) | Podłączenie wyłącznika systemowego |
| 3 | +13V | — |
| 4 | 485A | RS-485 data+ (dla TapHome) |
| 5 | 485B | RS-485 data− (dla TapHome) |
| 6 | GND | Masa |
| 7 | Drycontact_A(out) | Podłączenie generatora |
| 8 | Drycontact_B(out) | Podłączenie generatora |
Podłącz TapHome do portu COM falownika:
- Pin 4 (485A) na porcie COM falownika do A+/D+ na RS-485 TapHome
- Pin 5 (485B) na porcie COM falownika do B-/D- na RS-485 TapHome
- Pin 6 (GND) — podłączenie zalecane dla niezawodnej komunikacji
Instrukcja SolaX wymaga kabla sieciowego CAT5E zaciśniętego we wtyk RJ45 dostarczony z falownikiem oraz długości kabla COM nie większej niż 30 m.
Pinów 3 (+13V) i 6 (GND) nie wolno łączyć ze sobą. Zaizoluj nieużywane piny.
Sam falownik nie obsługuje natywnie Modbus TCP. Modbus TCP jest dostępny wyłącznie przez moduł monitorowania SolaX (dongle Wi-Fi) i nie jest używany przez ten szablon.
W instalacjach, w których okablowanie RS-485 nie jest praktyczne, szablon SolaX Inverter (Cloud API) zapewnia monitoring przez platformę SolaxCloud za pośrednictwem HTTPS — bez fizycznego połączenia. Obsługuje wszystkie typy falowników SolaX, nie tylko Gen 4 Hybrid.
Tryb ładowania i ustawienia ładowania nocnego to rejestry EEPROM w falowniku (oznaczone przez SolaX symbolem ★, około 1 miliona cykli zapisu). Nadmierne operacje zapisu mogą spowodować nieodwracalne uszkodzenie sprzętu — nigdy nie włączaj na nich zapisu, który działa cyklicznie. Ten szablon ma wszystkie skrypty zapisu wyłączone.
Konfiguracja
Włączanie komunikacji Modbus
Modbus RTU jest domyślnie dostępny na porcie COM RS-485 falownika. Następujące parametry muszą być zgodne między falownikiem a modułem TapHome:
- Slave ID – domyślnie 1, konfigurowalny na wyświetlaczu falownika. Szablon pyta o niego jako o jedyny parametr importu, Modbus Slave ID (domyślnie 1)
- Baud rate – 19200 baud, ustawienie fabryczne SolaX; szablon również używa 19200. Jeśli falownik ustawiono na inną prędkość (na przykład 9600), zmień ustawienie falownika albo prędkość interfejsu TapHome, aby obie były zgodne
- Format danych – 8 bitów danych, brak parzystości, 1 bit stopu
Konfiguracja na wyświetlaczu falownika: Menu > Setting > Advance Setting > Modbus. Ustaw adres slave i baud rate. Ustawienia zaawansowane wymagają hasła instalatora, które udostępnia sprzedawca. Baud rate można też odczytać z rejestru holding H:0x00B0 i zapisać przez rejestr 0x00CA (wartości: 0=115200, 1=57600, 2=56000, 3=38400, 4=19200, 5=14400, 6=9600).
W TapHome szablon importuje się następnie na interfejsie RS-485 Modbus RTU jednostki sterującej Core, ustawionym na tę samą prędkość i format danych, z Slave ID falownika.
Taktowanie komunikacji
Protokół wymaga minimalnego odstępu 1 sekundy między kolejnymi instrukcjami Modbus oraz limitu czasu przerwy między znakami wynoszącego co najmniej 100 ms. Limit czasu odpowiedzi wynosi 1 sekundę. Szablon używa indywidualnych interwałów odpytywania dla każdego urządzenia (od 2,5 s do 150 s), które spełniają te wymagania.
Funkcja portu COM RS-485
Rejestr H:0x013E (485CommFunSelect) określa, czy port RS-485 służy do komunikacji Modbus (wartość 0), czy do komunikacji z ładowarką EV (wartość 1). Upewnij się, że do integracji z TapHome jest ustawiony na 0 (Modbus 485).
Możliwości urządzenia
Monitorowanie baterii
- Bateria (SOC) – odczytuje stan naładowania baterii (A:0x001C) jako procent, co 15 sekund. Surowa wartość rejestru w jednostkach 1% jest dzielona przez 100 dla zakresu wejścia analogowego TapHome 0–1 (np. 85% staje się 0,85)
- Battery Temperature – odczytuje temperaturę baterii (A:0x0018) w stopniach Celsjusza jako wartość ze znakiem (Int16), więc temperatury poniżej 0 °C są wyświetlane poprawnie. Odpytywanie co 80 sekund
Moc solarna PV
- PV1 – moc wyjściowa DC łańcucha PV 1 (A:0x000A), wyświetlana w kW po przeliczeniu z watów (/1000)
- PV2 – moc wyjściowa DC łańcucha PV 2 (A:0x000B), wyświetlana w kW po przeliczeniu z watów (/1000)
PV1 i PV2 to zwykłe wartości bez typu energii, więc w Energy Dashboard nie są liczone podwójnie.
Moc sieciowa i pomiar energii
- Purchase/Feed to Grid – chwilowa moc sieciowa (A:0x0046–0x0047, LittleEndianInt32) w kW, zwykła wartość bez typu energii. Wartości dodatnie oznaczają oddawanie energii do sieci, wartości ujemne pobór z sieci. Falownik pobiera tę wartość z podłączonego do niego licznika lub przekładnika prądowego (CT)
- Daily/Actual Energy – licznik produkcji PV dla Energy Dashboard. Jego moc to PV1 + PV2 (A:0x000A + A:0x000B) w kW, a jego suma to całkowita energia PV (A:0x0094–0x0095, SolarEnergyTotal, jednostki 0,1 kWh) w kWh. Wbrew nazwie suma nie zeruje się w nocy
- Total Energy – całkowita skumulowana energia oddana przez port AC falownika od początku pracy (A:0x0052–0x0053, LittleEndianUint32, jednostki 0,1 kWh), wyświetlana w kWh
Tryb ładowania i ładowanie nocne
- Charger Use Mode – odczytuje aktywny tryb ładowania solarnego (H:0x008B): Self Use Mode (0), Feedin Priority (1), Backup Mode (2) lub Manual Mode (3). Rejestr zapisu (H:0x001F) istnieje w szablonie, ale jest zakomentowany, dlatego wartość jest tylko do odczytu
- SelfUse Night Charge – odczytuje górny docelowy SOC ładowania nocnego w trybie Self Use (H:0x0094) jako procent. Rejestr zapisu (H:0x0063) i rejestr włączania (H:0x0062) są oba zakomentowane, więc konfiguracji ładowania nocnego nie można zmienić przez TapHome
Wykrywanie usterek
Skrypt odczytu modułu monitoruje tryb pracy falownika (A:0x0009) i dwa rejestry błędów. Każda usterka ma własny kod błędu:
- Usterki Run mode – błąd 1, gdy tryb pracy wynosi 3 (Fault), błąd 2, gdy wynosi 4 (Permanent Fault)
- Kod błędu falownika (A:0x0040–0x0041, LittleEndianUint32) – 30 pojedynczych usterek z kodami 100–131 (100 + numer bitu), w tym usterki napięcia i częstotliwości sieci, usterki napięcia PV, usterki baterii, usterki izolacji, przegrzanie, zabezpieczenie nadprądowe, usterki przekaźnika i błędy komunikacji. Nazwy usterek odpowiadają tabeli X3 protokołu SolaX
- Kod błędu menedżera (A:0x0043) – kody 200–211 (200 + numer bitu) dla usterek typu mocy, błędów EEPROM, problemów z czujnikami NTC, za niskiej/za wysokiej temperatury baterii, usterek licznika, przekaźnika bypass i wentylatora. Port OC Warning (201) jest zgłaszany jako ostrzeżenie, pozostałe jako błędy
Atrybut serwisowy Run mode w module wyświetla bieżący stan falownika jako tekst: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle lub Standby.
Co poprawia ten szablon
Oficjalny szablon TapHome SolaX Hybrid X1/X3 Gen 4 błędnie odczytuje kilka rejestrów (sprawdzone na podstawie protokołu SolaX Modbus V3.21 i V001.02). Ten szablon je poprawia:
| Gdzie | Oficjalny szablon | Ten szablon | Skutek błędu w oficjalnym szablonie |
|---|---|---|---|
| Moduł — skrypt odczytu | var x3 := MODBUSR(A, 0x0040, Uint32); | VAR inv := MODBUSR(A, 0x0040, LittleEndianUint32); | Dwie połowy 32-bitowego kodu błędu są zamienione: usterka w bicie 1 (Grid Lost Fault) jest zgłaszana jako bit 17 (Bat Power Low) |
| Total Energy | MODBUSR(A, 0x52, LittleEndianInt32) / 1000 | MODBUSR(A, 0x0052, LittleEndianUint32) / 10 | Wartość 100× za mała (rejestr liczy w jednostkach 0,1 kWh) |
| Daily/Actual Energy — suma | MODBUSR(A, 0x50, UInt16) /10 | MODBUSR(A, 0x0094, LittleEndianUint32) / 10 | 0x0050 to dzienny licznik portu AC falownika, który każdej nocy spada do 0; 0x0094 to całkowita energia PV |
| Daily/Actual Energy — moc | MODBUSR(A,0x02, Int16)/1000 | (MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16)) / 1000 | 0x0002 to moc sieciowa jednofazowych modeli X1, a nie produkcja PV; w wielu urządzeniach X3 odczytuje 0 |
| Battery Temperature | MODBUSR(A,0x0018, UInt16) | MODBUSR(A, 0x0018, Int16) | Poniżej 0 °C oficjalny szablon pokazuje około 65535 °C |
| Prędkość interfejsu | 9600 baud | 19200 baud | 19200 to ustawienie fabryczne SolaX |
Z poprawionymi skryptami licznik Daily/Actual Energy mierzy produkcję PV (PV1 + PV2), czyli to, czego oczekuje jego typ energii w Energy Dashboard. PV1, PV2 i Purchase/Feed to Grid nie mają już typu energii — są zwykłymi wartościami. Wszystkie zapisy pozostają wyłączone, tak jak w oficjalnym szablonie.
Rozwiązywanie problemów
Brak komunikacji z falownikiem
- Sprawdź połączenia kabla RS-485: A+ do A+, B- do B-, GND do GND
- Sprawdź, czy rejestr H:0x013E jest ustawiony na 0 (tryb Modbus 485, nie EV Charger)
- Potwierdź, że baud rate jest zgodny między falownikiem a TapHome – szablon używa 19200, wartości domyślnej falownika; falownik ustawiony na 9600 wymaga zmiany po jednej ze stron
- Sprawdź, czy Modbus Slave ID w TapHome odpowiada ustawieniu falownika (domyślnie: 1)
- Upewnij się, że do tej samej magistrali RS-485 nie jest podłączony żaden inny master Modbus – Modbus obsługuje tylko jednego mastera
Wartości wyglądają jak w oficjalnym szablonie
Gdy Total Energy jest 100× za mała, Daily/Actual Energy spada do 0 każdej nocy albo Battery Temperature pokazuje około 65535 °C poniżej zera, moduł nadal wykonuje skrypty oficjalnego szablonu. Moduł nie aktualizuje się sam z nowszego szablonu — zaimportuj ten szablon jako nowy moduł albo popraw skrypty tak, jak pokazuje tabela powyżej.
Nieprawidłowy odczyt Bateria (SOC)
Rejestr Bateria (SOC) (A:0x001C) raportuje wartości w jednostkach 1%. Szablon dzieli przez 100 dla zakresu wejścia analogowego TapHome 0–1. Jeśli wyświetlana wartość wydaje się błędna, sprawdź, czy urządzenie TapHome jest skonfigurowane jako wejście analogowe (zakres 0–1, nie 0–100).
Konwencja znaku mocy sieciowej
Purchase/Feed to Grid (A:0x0046) używa konwencji znaku, w której wartości dodatnie oznaczają oddawanie energii (eksport do sieci), a wartości ujemne pobór (zużycie z sieci). Falownik otrzymuje tę wartość ze swojego licznika lub przekładnika prądowego (CT), dlatego zależy ona od prawidłowo podłączonego licznika lub przekładnika.
Różnice między X1 a X3
Szablon odczytuje moc PV (A:0x000A i A:0x000B) zamiast rejestru mocy sieciowej X1, więc licznik Daily/Actual Energy działa tak samo w modelach X1 i X3. Nazwy usterek odpowiadają tabeli X3 protokołu SolaX. W falowniku X1 niektóre bity usterek oznaczają inne usterki — bit 9 i większość bitów od bitu 15 w górę (na przykład bit 15 to w X1 Missed CT Fault, a w X3 Off-grid Overload).
