
Rodina zariadení Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) sú komunikačné a monitorovacie platformy, ktoré poskytujú prístup cez Modbus TCP k pripojeným striedačom/nabíjačkám Victron VE.Bus (MultiPlus, Quattro). Samotné GX zariadenie nie je striedač — funguje ako Modbus TCP brána k systému VE.Bus.
TapHome sa pripája k GX zariadeniu cez Ethernet pomocou Modbus TCP. Šablóna sprístupňuje monitorovanie SOC batérie, meranie AC vstupu a výstupu na 3 fázach, riadenie výkonového setpointu ESS (Energy Storage System), prepínanie režimu striedača, správu FV striedača a komplexné monitorovanie alarmov.
Sieťové pripojenie
GX zariadenie sa pripája k lokálnej sieti cez Ethernet port. TapHome Core a GX zariadenie musia byť v rovnakej podsieti.
- Protokol: Modbus TCP
- Port: 502
- Predvolené Slave ID: 227 (port VE.Bus Cerbo GX)
- Funkčné kódy: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)
Predvolené slave ID 227 platí pre port VE.Bus Cerbo GX. Iné GX zariadenia používajú rôzne ID: 246 pre CCGX, 242 pre Venus GX, 228 pre EasySolar-II GX. Unit ID sú dynamicky prideľované od Venus OS 2.60 — aktuálne ID overíte na GX zariadení cez Nastavenia → Služby → Modbus/TCP → Dostupné služby.
Konfigurácia
Povolenie Modbus TCP
Modbus TCP je na všetkých GX zariadeniach predvolene vypnutý. Zapnutie:
- Na GX zariadení prejdite na Nastavenia → Služby
- Povoľte Modbus-TCP
Po povolení GX zariadenie počúva na TCP porte 502.
Import šablóny do TapHome
Pri importe šablóny v TapHome zadajte:
- IP adresa — IP adresa GX zariadenia v lokálnej sieti
- Slave ID — VE.Bus unit ID (predvolene: 227 pre Cerbo GX)
Priraďte GX zariadeniu statickú IP adresu v nastaveniach DHCP routera, alebo nakonfigurujte statickú IP priamo na GX zariadení cez Nastavenia → Ethernet, aby sa adresa nezmenila po reštarte.
Možnosti zariadenia
Šablóna sprístupňuje 10 zariadení rozdelených do skupín monitorovania batérie, merania AC, riadenia režimu a ochranných spínačov.
Monitorovanie batérie
- Batéria — číta stav nabitia (SOC) VE.Bus z registra H:30 ako úroveň stmievača. Atribúty služby zobrazujú napätie batérie (H:26), prúd batérie s indikátorom smeru (H:27), teplotu batérie (H:61), stav nabíjania VE.Bus (Vypnutý, Nízky výkon, Porucha, Bulk, Absorpcia, Float, Uloženie, Ekvalizácia, Passthru, Invertor, Power Assist, Napájanie) a oprávnenia BMS pre nabíjanie/vybíjanie (H:57–59). Readscript sleduje H:32 pre chybové kódy VE.Bus (1–26) a H:60 pre chyby BMS. Pre obnovu systému je k dispozícii akcia VE.Bus Reset (H:62).
Meranie AC vstupu
Tri zariadenia elektromerov monitorujú príkon AC vstupu na fázu:
- Príkon vstupu L1 — príkon AC vstupu fáza 1 z H:12, s atribútmi služby pre napätie (H:3), prúd (H:6), frekvenciu (H:9) a ESS výkonový setpoint (H:37). ESS setpoint je zapisovateľný cez akciu služby.
- Príkon vstupu L2 — príkon AC vstupu fáza 2 z H:13, so zodpovedajúcimi atribútmi L2 a ESS setpointom L2 (H:40).
- Príkon vstupu L3 — príkon AC vstupu fáza 3 z H:14, so zodpovedajúcimi atribútmi L3 a ESS setpointom L3 (H:41).
Každé zariadenie príkonu vstupu obsahuje akciu ESS výkonového setpointu pre príslušnú fázu, čo umožňuje TapHome riadiť správanie ESS nabíjania/vybíjania pre každú fázu.
Meranie AC výstupu
Tri zariadenia elektromerov monitorujú výkon AC výstupu na fázu:
- Výkon výstupu L1 — AC výstup z H:18, s atribútmi služby pre napätie (H:15), prúd (H:18) a frekvenciu (H:21). Readscript sleduje alarmy na fázu pre teplotu (H:44), nízku batériu (H:45), preťaženie (H:46) a zvlnenie (H:47).
- Výkon výstupu L2 — AC výstup z H:24, s napätím L2 (H:16), prúdom (H:19) a frekvenciou (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), prúdom (H:20) a frekvenciou (H:21). Sleduje alarmy L3 (H:52–55).
Riadenie prúdového limitu vstupu
- Aktívny prúdový limit vstupu — číta a zapisuje aktívny prúdový limit vstupu (H:22) v ampéroch. Akcia služby „Nastaviť limit" akceptuje hodnotu float (0–100 A).
Ochranné spínače
- Napájanie DC prepätia do siete — prepínač (H:65) na riadenie, či sa DC prepätie vracia späť do siete. Atribúty služby zobrazujú maximálny výkon napájania prepätia na fázu (H:66–68) a stav ignorovania AC vstupu (H:69–70). Akcia služby umožňuje nastaviť maximálny výkon napájania na fázu.
- FV striedač — prepínač (H:56) na povolenie alebo zakázanie frekvenčného posúvania FV striedača na AC výstupe. Pri povolení (spínač VYPNUTÝ) FV striedač na AC výstupe pracuje normálne; pri zakázaní (spínač ZAPNUTÝ) frekvenčné posúvanie obmedzuje výstup FV.
Atribúty a akcie služby na úrovni modulu
Samotný modul sprístupňuje niekoľko atribútov služby dostupných z brány v TapHome:
| Atribút | Register | Popis |
|---|---|---|
| Počet fáz | H:28 | Počet AC fáz v systéme VE.Bus |
| Poloha spínača | H:33 | Režim striedača — Len nabíjačka, Len striedač, Zapnutý, Vypnutý |
| Aktívny vstup | H:29 | Aktívny zdroj AC vstupu — AC vstup 1, AC vstup 2, Odpojený |
| ESS zakázať nabíjanie | H:38 | Príznak nabíjania — Nabíjanie povolené / Nabíjanie zakázané |
| ESS zakázať napájanie | H:39 | Príznak napájania — Napájanie povolené / Napájanie zakázané |
| ESS výkonový setpoint L1–L3 | H:37, H:40, H:41 | ESS výkonový setpoint na fázu vo wattoch |
Akcie služby na úrovni modulu umožňujú prepínanie režimu striedača (Len nabíjačka, Len striedač, Zapnutý, Vypnutý), prepínanie príznaku nabíjania ESS a prepínanie príznaku napájania ESS.
Systémové monitorovanie alarmov
Readscript modulu monitoruje 7 systémových alarmov:
| Register | Alarm | Úrovne |
|---|---|---|
| H:34 | Tepelný alarm | 0=Ok, 1=Varovanie, 2=Alarm |
| H:35 | Alarm nízkej batérie | 0=Ok, 1=Varovanie, 2=Alarm |
| H:36 | Alarm preťaženia | 0=Ok, 1=Varovanie, 2=Alarm |
| H:42 | Alarm teplotného senzora | 0=Ok, 1=Varovanie, 2=Alarm |
| H:43 | Alarm napäťového senzora | 0=Ok, 1=Varovanie, 2=Alarm |
| H:63 | Varovanie rotácie fáz | 0=Ok, 1=Varovanie |
| H:64 | Alarm straty siete | 0=Ok, 1=Alarm |
Ďalšie možnosti
Sada registrov VE.Bus (H:3–H:231) poskytuje ďalšie registre nad rámec aktuálnej implementácie šablóny. Patria sem počítadlá energie pre toky AC vstupu/výstupu/batérie (H:74–92, volatilné — reset pri reštarte), enumerácia stavu nabíjania (H:95), 32-bitové ESS výkonové setpointy pre väčšie systémy (H:96–100), pokročilé nastavenia ESS ako Preferovanie obnoviteľnej energie (H:102), konfigurácia PowerAssist (H:106–108), ovládanie funkcie UPS (H:109) a registre mikrosiete/droop módu (H:200–231). Tieto môžu byť pridané do šablóny TapHome v budúcej aktualizácii.
Riešenie problémov
Žiadna Modbus komunikácia
- Overte, že Modbus TCP je na GX zariadení povolený (Nastavenia → Služby → Modbus-TCP)
- Potvrďte IP adresu GX zariadenia — skontrolujte tabuľku DHCP prenájmov routera alebo sieťové nastavenia GX zariadenia
- Uistite sa, že TapHome Core a GX zariadenie sú v rovnakej podsieti
- Skontrolujte, že žiadny firewall neblokuje TCP port 502
- Overte správne unit ID — predvolené 227 platí pre Cerbo GX; iné modely GX používajú rôzne ID
Nesprávne hodnoty výkonu
Šablóna používa faktor /100 pre registre výkonu (H:12–14, H:23–25), zatiaľ čo dokumentácia Victron uvádza faktor 0,1 (čo znamená surová hodnota × 10 = skutočné watty). To môže viesť k hodnotám výkonu nižším, ako sa očakáva. Ak sa hodnoty výkonu javia ako nesprávne, ide o známy rozdiel faktora šablóny — relatívne merania zostávajú proporcionálne správne.
Chybové kódy VE.Bus
Readscript zariadenia Batéria kontroluje register H:32 pre chybové kódy VE.Bus. Bežné chyby:
| Kód | Popis |
|---|---|
| 1 | Zariadenie vypnuté, pretože iná fáza sa vypla |
| 5 | Prepätie na AC výstupe |
| 10 | Problém so synchronizáciou systémového času |
| 14 | Zariadenie nemôže prenášať dáta |
| 16 | Chýba dongle |
| 17 | Zariadenie prevzalo status mastera, pretože pôvodný master zlyhal |
| 25 | Nekompatibilita firmvéru medzi pripojenými zariadeniami |
| 26 | Interná chyba |
Ak sa vyskytujú trvalé chyby VE.Bus, akcia VE.Bus Reset (dostupná na zariadení Batéria) môže byť použitá na pokus o obnovu.
Unit ID sa zmenilo po aktualizácii Venus OS
Od Venus OS 2.60 sú unit ID dynamicky prideľované. Po aktualizácii firmvéru sa unit ID môže zmeniť. Prejdite na Nastavenia → Služby → Modbus/TCP → Dostupné služby na GX zariadení pre overenie aktuálneho VE.Bus unit ID, potom aktualizujte slave ID v šablóne TapHome.
