
Familia de dispozitive Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) cuprinde platforme de comunicație și monitorizare care oferă acces Modbus TCP la invertoarele/încărcătoarele Victron VE.Bus conectate (MultiPlus, Quattro). Dispozitivul GX în sine nu este un invertor — funcționează ca gateway Modbus TCP către sistemul VE.Bus.
TapHome se conectează la dispozitivul GX prin Ethernet, folosind Modbus TCP. Șablonul oferă monitorizarea SOC-ului bateriei, contorizarea trifazată a intrării și ieșirii AC, controlul valorii setate a puterii ESS (Energy Storage System), comutarea modului invertorului, gestionarea invertorului fotovoltaic și monitorizarea completă a alarmelor.
Conexiunea la rețea
Dispozitivul GX se conectează la rețeaua locală prin portul Ethernet. TapHome Core și dispozitivul GX trebuie să fie în aceeași subrețea.
- Protocol: Modbus TCP
- Port: 502
- Slave ID implicit: 227 (portul VE.Bus al Cerbo GX)
- Coduri de funcție: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)
Slave ID-ul implicit 227 este valabil pentru portul VE.Bus al Cerbo GX. Celelalte dispozitive GX folosesc alte ID-uri: 246 pentru CCGX, 242 pentru Venus GX, 228 pentru EasySolar-II GX. Începând cu Venus OS 2.60, ID-urile unităților se atribuie dinamic — verificați ID-ul real pe dispozitivul GX în Settings → Services → Modbus/TCP → Available services.
Configurare
Activarea Modbus TCP
Modbus TCP este dezactivat implicit pe toate dispozitivele GX. Pentru a-l activa:
- Mergeți la Settings → Services pe dispozitivul GX
- Activați Modbus-TCP
După activare, dispozitivul GX ascultă pe portul TCP 502.
Importul șablonului în TapHome
La importul șablonului în TapHome introduceți:
- Adresă IP — adresa IP a dispozitivului GX în rețeaua locală
- Slave ID — ID-ul unității VE.Bus (implicit: 227 pentru Cerbo GX)
Atribuiți dispozitivului GX o adresă IP statică în setările DHCP ale routerului sau configurați o adresă IP statică direct pe dispozitivul GX, în Settings → Ethernet, ca adresa să nu se schimbe după o repornire.
Funcțiile dispozitivului
Șablonul oferă 10 dispozitive, grupate în patru categorii: monitorizarea bateriei, contorizarea AC, controlul modului și comutatoare de protecție.
Monitorizarea bateriei
- Baterie — citește starea de încărcare (SOC) VE.Bus din registrul H:30, ca nivel de dimmer. Atributele de service arată tensiunea bateriei (H:26), curentul bateriei cu indicatorul de sens (H:27), temperatura bateriei (H:61), starea de încărcare VE.Bus (Oprit, Putere redusă, Defecțiune, Bulk, Absorbție, Float, Stocare, Egalizare, Passthru, Invertare, Power Assist, Alimentare) și permisiunile BMS de încărcare/descărcare (H:57–59). Scriptul de citire monitorizează H:32 pentru codurile de eroare VE.Bus (1–26) și H:60 pentru erorile BMS. Pentru restabilirea sistemului este disponibilă acțiunea Resetare VE.Bus (H:62).
Contorizarea intrării AC
Trei dispozitive contor electric monitorizează puterea de intrare AC pe fiecare fază:
- Putere intrare L1 — puterea de intrare AC pe faza 1 din H:12, cu atribute de service pentru tensiune (H:3), curent (H:6), frecvență (H:9) și valoarea setată a puterii ESS (H:37). Valoarea setată ESS se poate scrie printr-o acțiune de service.
- Putere intrare L2 — puterea de intrare AC pe faza 2 din H:13, cu atributele de service corespunzătoare pentru L2 și valoarea setată ESS L2 (H:40).
- Putere intrare L3 — puterea de intrare AC pe faza 3 din H:14, cu atributele de service corespunzătoare pentru L3 și valoarea setată ESS L3 (H:41).
Fiecare dispozitiv Putere intrare include o acțiune de service pentru valoarea setată a puterii ESS pe faza respectivă, astfel încât TapHome poate controla încărcarea/descărcarea ESS pe fiecare fază.
Contorizarea ieșirii AC
Trei dispozitive contor electric monitorizează puterea de ieșire AC pe fiecare fază:
- Putere ieșire L1 — ieșirea AC din H:18, cu atribute de service pentru tensiune (H:15), curent (H:18) și frecvență (H:21). Scriptul de citire monitorizează alarmele pe fază pentru temperatură (H:44), baterie descărcată (H:45), suprasarcină (H:46) și riplu (H:47).
- Putere ieșire L2 — ieșirea AC din H:24, cu tensiunea L2 (H:16), curentul (H:19) și frecvența (H:21). Monitorizează alarmele L2 (H:48–51).
- Putere ieșire L3 — ieșirea AC din H:25, cu tensiunea L3 (H:17), curentul (H:20) și frecvența (H:21). Monitorizează alarmele L3 (H:52–55).
Controlul limitei de curent
- Limită activă a curentului de intrare — citește și scrie limita activă a curentului de intrare (H:22), în amperi. Acțiunea de service „Setare limită” acceptă o valoare zecimală (0–100 A).
Comutatoare de protecție
- Injectare supratensiune DC în rețea — comutator (H:65) care stabilește dacă surplusul de putere din fotovoltaica cuplată în DC (care ridică tensiunea DC) este injectat în rețea. Atributele de service arată puterea maximă de injectare a supratensiunii pe fiecare fază (H:66–68) și starea de ignorare a intrărilor AC (H:69–70). O acțiune de service permite setarea puterii maxime de injectare pe fiecare fază.
- Invertor solar — comutator (H:56) care activează sau dezactivează deplasarea frecvenței pentru invertorul solar de pe AC-out. Când este activat (comutator OPRIT), invertorul solar de pe AC-out funcționează normal; când este dezactivat (comutator PORNIT), deplasarea frecvenței limitează producția fotovoltaică.
Atribute și acțiuni de service la nivel de modul
Modulul însuși oferă mai multe atribute de service, accesibile din dispozitivul gateway în TapHome:
| Atribut | Registru | Descriere |
|---|---|---|
| Număr de faze | H:28 | Numărul de faze AC din sistemul VE.Bus |
| Poziția comutatorului | H:33 | Modul invertorului — Doar încărcător, Doar invertor, Pornit, Oprit |
| Intrare activă | H:29 | Sursa de intrare AC activă — Intrare AC 1, Intrare AC 2, Deconectat |
| Dezactivare încărcare ESS | H:38 | Indicator de încărcare — Încărcare activată / Încărcare dezactivată |
| Dezactivare injectare ESS | H:39 | Indicator de injectare în rețea — Injectare activată / Injectare dezactivată |
| Valoare setată putere ESS L1–L3 | H:37, H:40, H:41 | Valoarea setată a puterii ESS pe fiecare fază, în wați |
Acțiunile de service la nivel de modul permit comutarea modului invertorului (Doar încărcător, Doar invertor, Pornit, Oprit), comutarea indicatorului de încărcare ESS și comutarea indicatorului de injectare ESS în rețea.
Monitorizarea alarmelor de sistem
Scriptul de citire al modulului monitorizează 7 alarme la nivel de sistem:
| Registru | Alarmă | Niveluri |
|---|---|---|
| H:34 | Alarmă de temperatură | 0=Ok, 1=Avertisment, 2=Alarmă |
| H:35 | Alarmă baterie descărcată | 0=Ok, 1=Avertisment, 2=Alarmă |
| H:36 | Alarmă de suprasarcină | 0=Ok, 1=Avertisment, 2=Alarmă |
| H:42 | Alarmă senzor de temperatură | 0=Ok, 1=Avertisment, 2=Alarmă |
| H:43 | Alarmă senzor de tensiune | 0=Ok, 1=Avertisment, 2=Alarmă |
| H:63 | Avertisment privind succesiunea fazelor | 0=Ok, 1=Avertisment |
| H:64 | Alarmă pierdere rețea | 0=Ok, 1=Alarmă |
Funcții suplimentare
Setul de registre VE.Bus (H:3–H:231) oferă registre suplimentare față de cele implementate în prezent în șablon. Printre acestea se numără contoarele de energie pentru fluxurile AC-in/out/baterie (H:74–92, volatile — se resetează la repornire), enumerarea stării de încărcare (H:95), valori setate ale puterii ESS pe 32 de biți pentru sisteme mai mari (H:96–100), setări ESS avansate precum Prefer Renewable Energy (H:102), configurarea PowerAssist (H:106–108), controlul funcției UPS (H:109) și registrele pentru modul microrețea/droop (H:200–231). Acestea pot fi adăugate în șablonul TapHome într-o actualizare viitoare.
Depanare
Nu există comunicare Modbus
- Verificați dacă Modbus TCP este activat pe dispozitivul GX (Settings → Services → Modbus-TCP)
- Confirmați adresa IP a dispozitivului GX — în tabelul de alocări DHCP al routerului sau în setările de rețea ale dispozitivului GX
- Asigurați-vă că TapHome Core și dispozitivul GX sunt în aceeași subrețea
- Verificați dacă niciun firewall nu blochează portul TCP 502
- Verificați ID-ul corect al unității — valoarea implicită 227 este valabilă pentru Cerbo GX; celelalte modele GX folosesc alte ID-uri
Valori incorecte ale puterii
Șablonul folosește pentru registrele de putere (H:12–14, H:23–25) factorul de scalare /100, în timp ce documentația Victron indică factorul de scalare 0,1 (adică valoarea brută × 10 = wați reali). Din această cauză, valorile puterii pot fi mai mici decât vă așteptați. Dacă valorile puterii par incorecte, este vorba de o diferență cunoscută a factorului de scalare din șablon — măsurătorile relative rămân corecte proporțional.
Coduri de eroare VE.Bus
Scriptul de citire al dispozitivului Baterie verifică registrul H:32 pentru codurile de eroare VE.Bus. Erori frecvente:
| Cod | Descriere |
|---|---|
| 1 | Dispozitivul s-a oprit pentru că s-a oprit o altă fază |
| 5 | Supratensiune pe AC-out |
| 10 | Problemă de sincronizare a timpului sistemului |
| 14 | Dispozitivul nu poate transmite date |
| 16 | Lipsește dongle-ul |
| 17 | Un dispozitiv a preluat rolul de master, deoarece masterul inițial a cedat |
| 25 | Incompatibilitate de firmware între dispozitivele conectate |
| 26 | Eroare internă |
Dacă erorile VE.Bus persistă, puteți încerca restabilirea funcționării cu acțiunea Resetare VE.Bus (disponibilă pe dispozitivul Baterie).
ID-ul unității s-a schimbat după actualizarea Venus OS
Începând cu Venus OS 2.60, ID-urile unităților se atribuie dinamic. După o actualizare de firmware, ID-ul unității se poate schimba. Mergeți pe dispozitivul GX la Settings → Services → Modbus/TCP → Available services, verificați ID-ul curent al unității VE.Bus și actualizați apoi Slave ID-ul în șablonul TapHome.
