
Rodina zařízení Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) jsou komunikační a monitorovací platformy, které poskytují přístup přes Modbus TCP k připojeným střídačům/nabíječkám Victron VE.Bus (MultiPlus, Quattro). Samotné GX zařízení není střídač — funguje jako Modbus TCP brána k systému VE.Bus.
TapHome se připojuje k GX zařízení přes Ethernet pomocí Modbus TCP. Šablona zpřístupňuje monitorování SOC baterie, měření AC vstupu a výstupu na 3 fázích, řízení výkonového setpointu ESS (Energy Storage System), přepínání režimu střídače, správu FV střídače a komplexní monitorování alarmů.
Síťové připojení
GX zařízení se připojuje k lokální síti přes Ethernet port. TapHome Core a GX zařízení musí být ve stejné podsíti.
- Protokol: Modbus TCP
- Port: 502
- Výchozí Slave ID: 227 (port VE.Bus Cerbo GX)
- Funkční kódy: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)
Výchozí slave ID 227 platí pro port VE.Bus Cerbo GX. Jiná GX zařízení používají různá ID: 246 pro CCGX, 242 pro Venus GX, 228 pro EasySolar-II GX. Unit ID jsou dynamicky přidělována od Venus OS 2.60 — aktuální ID ověříte na GX zařízení přes Nastavení → Služby → Modbus/TCP → Dostupné služby.
Konfigurace
Povolení Modbus TCP
Modbus TCP je na všech GX zařízeních výchozně vypnutý. Zapnutí:
- Na GX zařízení přejděte na Nastavení → Služby
- Povolte Modbus-TCP
Po povolení GX zařízení naslouchá na TCP portu 502.
Import šablony do TapHome
Při importu šablony v TapHome zadejte:
- IP adresa — IP adresa GX zařízení v lokální síti
- Slave ID — VE.Bus unit ID (výchozně: 227 pro Cerbo GX)
Přiřaďte GX zařízení statickou IP adresu v nastavení DHCP routeru, nebo nakonfigurujte statickou IP přímo na GX zařízení přes Nastavení → Ethernet, aby se adresa nezměnila po restartu.
Možnosti zařízení
Šablona zpřístupňuje 10 zařízení rozdělených do skupin monitorování baterie, měření AC, řízení režimu a ochranných spínačů.
Monitorování baterie
- Baterie — čte stav nabití (SOC) VE.Bus z registru H:30 jako úroveň stmívače. Atributy služby zobrazují napětí baterie (H:26), proud baterie s indikátorem směru (H:27), teplotu baterie (H:61), stav nabíjení VE.Bus (Vypnutý, Nízký výkon, Porucha, Bulk, Absorpce, Float, Uložení, Ekvalizace, Passthru, Invertor, Power Assist, Napájení) a oprávnění BMS pro nabíjení/vybíjení (H:57–59). Readscript sleduje H:32 pro chybové kódy VE.Bus (1–26) a H:60 pro chyby BMS. Pro obnovu systému je k dispozici akce VE.Bus Reset (H:62).
Měření AC vstupu
Tři zařízení elektroměrů monitorují příkon AC vstupu na fázi:
- Příkon vstupu L1 — příkon AC vstupu fáze 1 z H:12, s atributy služby pro napětí (H:3), proud (H:6), frekvenci (H:9) a ESS výkonový setpoint (H:37). ESS setpoint je zapisovatelný přes akci služby.
- Příkon vstupu L2 — příkon AC vstupu fáze 2 z H:13, s odpovídajícími atributy L2 a ESS setpointem L2 (H:40).
- Příkon vstupu L3 — příkon AC vstupu fáze 3 z H:14, s odpovídajícími atributy L3 a ESS setpointem L3 (H:41).
Každé zařízení příkonu vstupu obsahuje akci ESS výkonového setpointu pro příslušnou fázi, což umožňuje TapHome řídit chování ESS nabíjení/vybíjení pro každou fázi.
Měření AC výstupu
Tři zařízení elektroměrů monitorují výkon AC výstupu na fázi:
- Výkon výstupu L1 — AC výstup z H:18, s atributy služby pro napětí (H:15), proud (H:18) a frekvenci (H:21). Readscript sleduje alarmy na fázi pro teplotu (H:44), nízkou baterii (H:45), přetížení (H:46) a zvlnění (H:47).
- Výkon výstupu L2 — AC výstup z H:24, s napětím L2 (H:16), proudem (H:19) a frekvencí (H:21). Sleduje alarmy L2 (H:48–51).
- Výkon výstupu L3 — AC výstup z H:25, s napětím L3 (H:17), proudem (H:20) a frekvencí (H:21). Sleduje alarmy L3 (H:52–55).
Řízení proudového limitu vstupu
- Aktivní proudový limit vstupu — čte a zapisuje aktivní proudový limit vstupu (H:22) v ampérech. Akce služby „Nastavit limit" přijímá hodnotu float (0–100 A).
Ochranné spínače
- Napájení DC přepětí do sítě — přepínač (H:65) pro řízení, zda se DC přepětí vrací zpět do sítě. Atributy služby zobrazují maximální výkon napájení přepětí na fázi (H:66–68) a stav ignorování AC vstupu (H:69–70). Akce služby umožňuje nastavit maximální výkon napájení na fázi.
- FV střídač — přepínač (H:56) pro povolení nebo zakázání frekvenčního posunování FV střídače na AC výstupu. Při povolení (spínač VYPNUTÝ) FV střídač na AC výstupu pracuje normálně; při zakázání (spínač ZAPNUTÝ) frekvenční posunování omezuje výstup FV.
Atributy a akce služby na úrovni modulu
Samotný modul zpřístupňuje několik atributů služby dostupných z brány v TapHome:
| Atribut | Registr | Popis |
|---|---|---|
| Počet fází | H:28 | Počet AC fází v systému VE.Bus |
| Poloha spínače | H:33 | Režim střídače — Jen nabíječka, Jen střídač, Zapnutý, Vypnutý |
| Aktivní vstup | H:29 | Aktivní zdroj AC vstupu — AC vstup 1, AC vstup 2, Odpojen |
| ESS zakázat nabíjení | H:38 | Příznak nabíjení — Nabíjení povoleno / Nabíjení zakázáno |
| ESS zakázat napájení | H:39 | Příznak napájení — Napájení povoleno / Napájení zakázáno |
| ESS výkonový setpoint L1–L3 | H:37, H:40, H:41 | ESS výkonový setpoint na fázi ve wattech |
Akce služby na úrovni modulu umožňují přepínání režimu střídače (Jen nabíječka, Jen střídač, Zapnutý, Vypnutý), přepínání příznaku nabíjení ESS a přepínání příznaku napájení ESS.
Systémové monitorování alarmů
Readscript modulu monitoruje 7 systémových alarmů:
| Registr | Alarm | Úrovně |
|---|---|---|
| H:34 | Tepelný alarm | 0=Ok, 1=Varování, 2=Alarm |
| H:35 | Alarm nízké baterie | 0=Ok, 1=Varování, 2=Alarm |
| H:36 | Alarm přetížení | 0=Ok, 1=Varování, 2=Alarm |
| H:42 | Alarm teplotního senzoru | 0=Ok, 1=Varování, 2=Alarm |
| H:43 | Alarm napěťového senzoru | 0=Ok, 1=Varování, 2=Alarm |
| H:63 | Varování rotace fází | 0=Ok, 1=Varování |
| H:64 | Alarm ztráty sítě | 0=Ok, 1=Alarm |
Další možnosti
Sada registrů VE.Bus (H:3–H:231) poskytuje další registry nad rámec aktuální implementace šablony. Patří sem čítače energie pro toky AC vstupu/výstupu/baterie (H:74–92, volatilní — reset při restartu), enumerace stavu nabíjení (H:95), 32-bitové ESS výkonové setpointy pro větší systémy (H:96–100), pokročilá nastavení ESS jako Preferování obnovitelné energie (H:102), konfigurace PowerAssist (H:106–108), ovládání funkce UPS (H:109) a registry mikrosite/droop módu (H:200–231). Tyto mohou být přidány do šablony TapHome v budoucí aktualizaci.
Řešení problémů
Žádná Modbus komunikace
- Ověřte, že Modbus TCP je na GX zařízení povolen (Nastavení → Služby → Modbus-TCP)
- Potvrďte IP adresu GX zařízení — zkontrolujte tabulku DHCP pronájmů routeru nebo síťová nastavení GX zařízení
- Ujistěte se, že TapHome Core a GX zařízení jsou ve stejné podsíti
- Zkontrolujte, že žádný firewall neblokuje TCP port 502
- Ověřte správné unit ID — výchozí 227 platí pro Cerbo GX; jiné modely GX používají různá ID
Nesprávné hodnoty výkonu
Šablona používá faktor /100 pro registry výkonu (H:12–14, H:23–25), zatímco dokumentace Victron uvádí faktor 0,1 (což znamená surová hodnota × 10 = skutečné watty). To může vést k hodnotám výkonu nižším, než se očekává. Pokud se hodnoty výkonu jeví jako nesprávné, jde o známý rozdíl faktoru šablony — relativní měření zůstávají proporcionálně správná.
Chybové kódy VE.Bus
Readscript zařízení Baterie kontroluje registr H:32 pro chybové kódy VE.Bus. Běžné chyby:
| Kód | Popis |
|---|---|
| 1 | Zařízení vypnuto, protože jiná fáze se vypnula |
| 5 | Přepětí na AC výstupu |
| 10 | Problém se synchronizací systémového času |
| 14 | Zařízení nemůže přenášet data |
| 16 | Chybí dongle |
| 17 | Zařízení převzalo status masteru, protože původní master selhal |
| 25 | Nekompatibilita firmwaru mezi připojenými zařízeními |
| 26 | Interní chyba |
Pokud se vyskytují trvalé chyby VE.Bus, akce VE.Bus Reset (dostupná na zařízení Baterie) může být použita k pokusu o obnovu.
Unit ID se změnilo po aktualizaci Venus OS
Od Venus OS 2.60 jsou unit ID dynamicky přidělována. Po aktualizaci firmwaru se unit ID může změnit. Přejděte na Nastavení → Služby → Modbus/TCP → Dostupné služby na GX zařízení pro ověření aktuálního VE.Bus unit ID, poté aktualizujte slave ID v šabloně TapHome.
