
Rodzina urządzeń Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) to platformy komunikacyjne i monitorujące, które zapewniają dostęp Modbus TCP do podłączonych falowników/ładowarek Victron VE.Bus (MultiPlus, Quattro). Samo urządzenie GX nie jest falownikiem — działa jako brama Modbus TCP do systemu VE.Bus.
TapHome łączy się z urządzeniem GX przez Ethernet za pomocą Modbus TCP. Szablon udostępnia monitorowanie SOC baterii, 3-fazowy pomiar AC wejścia i wyjścia, sterowanie punktem pracy ESS (Energy Storage System), przełączanie trybu falownika, zarządzanie falownikiem FV i kompleksowe monitorowanie alarmów.
Połączenie sieciowe
Urządzenie GX łączy się z siecią lokalną przez port Ethernet. TapHome Core i urządzenie GX muszą być w tej samej podsieci.
- Protokół: Modbus TCP
- Port: 502
- Domyślne Slave ID: 227 (port VE.Bus Cerbo GX)
- Kody funkcji: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)
Domyślne slave ID 227 dotyczy portu VE.Bus Cerbo GX. Inne urządzenia GX używają różnych ID: 246 dla CCGX, 242 dla Venus GX, 228 dla EasySolar-II GX. Unit ID są przydzielane dynamicznie od Venus OS 2.60 — rzeczywiste ID można sprawdzić na urządzeniu GX przez Ustawienia → Usługi → Modbus/TCP → Dostępne usługi.
Konfiguracja
Włączanie Modbus TCP
Modbus TCP jest domyślnie wyłączony na wszystkich urządzeniach GX. Włączenie:
- Na urządzeniu GX przejdź do Ustawienia → Usługi
- Włącz Modbus-TCP
Po włączeniu urządzenie GX nasłuchuje na porcie TCP 502.
Import szablonu TapHome
Podczas importowania szablonu w TapHome podaj:
- Adres IP — adres IP urządzenia GX w sieci lokalnej
- Slave ID — VE.Bus unit ID (domyślnie: 227 dla Cerbo GX)
Przypisz urządzeniu GX statyczny adres IP w ustawieniach DHCP routera lub skonfiguruj statyczny IP bezpośrednio na urządzeniu GX przez Ustawienia → Ethernet, aby adres nie zmieniał się po restarcie.
Możliwości urządzenia
Szablon udostępnia 10 urządzeń podzielonych na monitorowanie baterii, pomiary AC, sterowanie trybem i wyłączniki ochronne.
Monitorowanie baterii
- Bateria — odczytuje stan naładowania VE.Bus (SOC) z rejestru H:30 jako poziom ściemniacza. Atrybuty usługi pokazują napięcie baterii (H:26), prąd baterii ze wskaźnikiem kierunku (H:27), temperaturę baterii (H:61), stan ładowania VE.Bus (Wyłączony, Mała moc, Błąd, Bulk, Absorpcja, Float, Magazynowanie, Wyrównanie, Passthru, Praca falownikowa, Power Assist, Zasilanie) i uprawnienia BMS do ładowania/rozładowania (H:57–59). Readscript monitoruje H:32 pod kątem kodów błędów VE.Bus (1–26) i H:60 pod kątem błędów BMS. Dla odzyskiwania systemu dostępna jest akcja VE.Bus Reset (H:62).
Pomiar AC wejścia
Trzy urządzenia licznika energii monitorują moc wejściową AC na fazę:
- Moc wejściowa L1 — moc wejściowa AC faza 1 z H:12, z atrybutami usługi dla napięcia (H:3), prądu (H:6), częstotliwości (H:9) i punktu pracy ESS (H:37). Punkt pracy ESS jest zapisywalny przez akcję usługi.
- Moc wejściowa L2 — moc wejściowa AC faza 2 z H:13, z odpowiednimi atrybutami L2 i punktem pracy ESS L2 (H:40).
- Moc wejściowa L3 — moc wejściowa AC faza 3 z H:14, z odpowiednimi atrybutami L3 i punktem pracy ESS L3 (H:41).
Każde urządzenie mocy wejściowej zawiera akcję usługi punktu pracy ESS dla odpowiedniej fazy, umożliwiając TapHome kontrolę zachowania ładowania/rozładowania ESS na fazę.
Pomiar AC wyjścia
Trzy urządzenia licznika energii monitorują moc wyjściową AC na fazę:
- Moc wyjściowa L1 — wyjście AC z H:18, z atrybutami usługi dla napięcia (H:15), prądu (H:18) i częstotliwości (H:21). Readscript monitoruje alarmy na fazę dla temperatury (H:44), niskiej baterii (H:45), przeciążenia (H:46) i tętnień (H:47).
- Moc wyjściowa L2 — wyjście AC z H:24, z napięciem L2 (H:16), prądem (H:19) i częstotliwością (H:21). Monitoruje alarmy L2 (H:48–51).
- Moc wyjściowa L3 — wyjście AC z H:25, z napięciem L3 (H:17), prądem (H:20) i częstotliwością (H:21). Monitoruje alarmy L3 (H:52–55).
Sterowanie limitem prądu wejścia
- Aktywny limit prądu wejścia — odczytuje i zapisuje aktywny limit prądu wejściowego (H:22) w amperach. Akcja usługi „Ustaw limit" przyjmuje wartość float (0–100 A).
Wyłączniki ochronne
- Podawanie przepięcia DC do sieci — przełącznik (H:65) do kontroli czy przepięcie DC jest podawane z powrotem do sieci. Atrybuty usługi pokazują maksymalną moc podawania przepięcia na fazę (H:66–68) i status ignorowania wejścia AC (H:69–70). Akcja usługi umożliwia ustawienie maksymalnej mocy podawania na fazę.
- Falownik FV — przełącznik (H:56) do włączania lub wyłączania modulacji częstotliwości falownika FV na wyjściu AC. Gdy włączony (przełącznik WYŁĄCZONY), falownik FV na wyjściu AC pracuje normalnie; gdy wyłączony (przełącznik WŁĄCZONY), modulacja częstotliwości ogranicza wyjście FV.
Atrybuty i akcje usługi na poziomie modułu
Sam moduł udostępnia kilka atrybutów usługi dostępnych z urządzenia bramy w TapHome:
| Atrybut | Rejestr | Opis |
|---|---|---|
| Liczba faz | H:28 | Liczba faz AC w systemie VE.Bus |
| Pozycja przełącznika | H:33 | Tryb falownika — Tylko ładowarka, Tylko falownik, Włączony, Wyłączony |
| Aktywne wejście | H:29 | Aktywne źródło wejścia AC — Wejście AC 1, Wejście AC 2, Rozłączone |
| ESS wyłącz ładowanie | H:38 | Flaga ładowania — Ładowanie włączone / Ładowanie wyłączone |
| ESS wyłącz podawanie | H:39 | Flaga podawania — Podawanie włączone / Podawanie wyłączone |
| Punkt pracy ESS L1–L3 | H:37, H:40, H:41 | Punkt pracy mocy ESS na fazę w watach |
Akcje usługi na poziomie modułu umożliwiają przełączanie trybu falownika (Tylko ładowarka, Tylko falownik, Włączony, Wyłączony), przełączanie flagi ładowania ESS i przełączanie flagi podawania ESS.
Monitorowanie alarmów systemu
Readscript modułu monitoruje 7 alarmów systemowych:
| Rejestr | Alarm | Poziomy |
|---|---|---|
| H:34 | Alarm temperatury | 0=Ok, 1=Ostrzeżenie, 2=Alarm |
| H:35 | Alarm niskiej baterii | 0=Ok, 1=Ostrzeżenie, 2=Alarm |
| H:36 | Alarm przeciążenia | 0=Ok, 1=Ostrzeżenie, 2=Alarm |
| H:42 | Alarm czujnika temperatury | 0=Ok, 1=Ostrzeżenie, 2=Alarm |
| H:43 | Alarm czujnika napięcia | 0=Ok, 1=Ostrzeżenie, 2=Alarm |
| H:63 | Ostrzeżenie rotacji faz | 0=Ok, 1=Ostrzeżenie |
| H:64 | Alarm utraty sieci | 0=Ok, 1=Alarm |
Dodatkowe możliwości
Zestaw rejestrów VE.Bus (H:3–H:231) zawiera dodatkowe rejestry wykraczające poza bieżącą implementację szablonu. Należą do nich liczniki energii dla przepływów AC wejście/wyjście/bateria (H:74–92, ulotne — reset przy restarcie), enumeracja stanu ładowania (H:95), 32-bitowe punkty pracy ESS dla większych systemów (H:96–100), zaawansowane ustawienia ESS jak Preferowanie energii odnawialnej (H:102), konfiguracja PowerAssist (H:106–108), sterowanie funkcją UPS (H:109) i rejestry trybu mikrosieć/droop (H:200–231). Mogą być dodane do szablonu TapHome w przyszłej aktualizacji.
Rozwiązywanie problemów
Brak komunikacji Modbus
- Sprawdź, czy Modbus TCP jest włączony na urządzeniu GX (Ustawienia → Usługi → Modbus-TCP)
- Potwierdź adres IP urządzenia GX — sprawdź tabelę dzierżaw DHCP routera lub ustawienia sieciowe urządzenia GX
- Upewnij się, że TapHome Core i urządzenie GX są w tej samej podsieci
- Sprawdź, czy żadna zapora sieciowa nie blokuje portu TCP 502
- Zweryfikuj prawidłowe unit ID — domyślne 227 dotyczy Cerbo GX; inne modele GX używają różnych ID
Nieprawidłowe odczyty mocy
Szablon używa współczynnika skalowania /100 dla rejestrów mocy (H:12–14, H:23–25), podczas gdy dokumentacja Victron określa współczynnik 0,1 (czyli wartość surowa × 10 = rzeczywiste waty). Może to powodować wartości mocy niższe od oczekiwanych. Jeśli wartości mocy wydają się nieprawidłowe, jest to znana różnica współczynnika szablonu — pomiary względne pozostają proporcjonalnie poprawne.
Kody błędów VE.Bus
Readscript urządzenia Bateria sprawdza rejestr H:32 pod kątem kodów błędów VE.Bus. Typowe błędy:
| Kod | Opis |
|---|---|
| 1 | Urządzenie wyłączone, ponieważ inna faza się wyłączyła |
| 5 | Przepięcie na wyjściu AC |
| 10 | Problem z synchronizacją czasu systemowego |
| 14 | Urządzenie nie może przesyłać danych |
| 16 | Brak dongla |
| 17 | Urządzenie przejęło status mastera, ponieważ oryginalny master uległ awarii |
| 25 | Niezgodność oprogramowania między podłączonymi urządzeniami |
| 26 | Błąd wewnętrzny |
W przypadku utrzymujących się błędów VE.Bus, akcja VE.Bus Reset (dostępna na urządzeniu Bateria) może być użyta do próby odzyskania.
Unit ID zmienione po aktualizacji Venus OS
Od Venus OS 2.60 unit ID są przydzielane dynamicznie. Po aktualizacji oprogramowania unit ID może się zmienić. Przejdź do Ustawienia → Usługi → Modbus/TCP → Dostępne usługi na urządzeniu GX, aby zweryfikować bieżące VE.Bus unit ID, a następnie zaktualizuj slave ID w szablonie TapHome.
