
A Victron GX eszközcsalád (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) kommunikációs és monitorozó platformok, amelyek Modbus TCP hozzáférést biztosítanak a csatlakoztatott Victron VE.Bus inverter/töltőkhöz (MultiPlus, Quattro). Maga a GX eszköz nem inverter — Modbus TCP átjáróként működik a VE.Bus rendszerhez.
A TapHome Ethernet-en keresztül, Modbus TCP-vel csatlakozik a GX eszközhöz. A sablon akkumulátor SOC figyelést, 3 fázisú AC bemeneti és kimeneti mérést, ESS (Energy Storage System) teljesítmény-alapérték vezérlést, inverter üzemmód kapcsolást, PV inverter kezelést és átfogó riasztásfigyelést tesz elérhetővé.
Hálózati csatlakozás
A GX eszköz az Ethernet porton keresztül csatlakozik a helyi hálózathoz. A TapHome Core-nak és a GX eszköznek ugyanabban az alhálózatban kell lenniük.
- Protokoll: Modbus TCP
- Port: 502
- Alapértelmezett Slave ID: 227 (Cerbo GX VE.Bus port)
- Funkcióakódok: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)
Az alapértelmezett 227-es slave ID a Cerbo GX VE.Bus portjára vonatkozik. Más GX eszközök különböző ID-kat használnak: 246 a CCGX-hez, 242 a Venus GX-hez, 228 az EasySolar-II GX-hez. A unit ID-k a Venus OS 2.60 óta dinamikusan kerülnek hozzárendelésre — az aktuális ID-t a GX eszközön ellenőrizze: Beállítások → Szolgáltatások → Modbus/TCP → Elérhető szolgáltatások.
Konfiguráció
Modbus TCP engedélyezése
A Modbus TCP minden GX eszközön alapértelmezés szerint letiltva van. Engedélyezés:
- A GX eszközön navigáljon a Beállítások → Szolgáltatások menübe
- Engedélyezze a Modbus-TCP opciót
Engedélyezés után a GX eszköz a 502-es TCP porton figyel.
TapHome sablon importálása
A sablon TapHome-ba importálásakor adja meg:
- IP cím — a GX eszköz IP-címe a helyi hálózaton
- Slave ID — VE.Bus unit ID (alapértelmezett: 227 Cerbo GX esetén)
Rendeljen statikus IP-címet a GX eszközhöz a router DHCP beállításaiban, vagy konfigurálja közvetlenül a GX eszközön a Beállítások → Ethernet menüben, hogy az újraindítás után ne változzon meg a cím.
Eszköz lehetőségek
A sablon 10 eszközt tesz elérhetővé, amelyek akkumulátor figyelésre, AC mérésre, üzemmód vezérlésre és védelmi kapcsolókra vannak felosztva.
Akkumulátor figyelés
- Akkumulátor — a VE.Bus töltöttségi állapotát (SOC) a H:30 regiszterből olvassa dimmer szintként. A szolgáltatás attribútumok mutatják az akkumulátor feszültségét (H:26), az irányvezérlővel ellátott akkumulátor áramát (H:27), az akkumulátor hőmérsékletét (H:61), a VE.Bus töltési állapotot (Ki, Alacsony teljesítmény, Hiba, Bulk, Abszorpció, Float, Tárolás, Egyenlítés, Passthru, Invertálás, Power Assist, Tápellátás) és a BMS töltési/kisütési engedélyeket (H:57–59). A readscript figyeli a H:32 regisztert VE.Bus hibakódokhoz (1–26) és a H:60-at BMS hibákhoz. A rendszer-helyreállításhoz VE.Bus Reset művelet (H:62) áll rendelkezésre.
AC bemeneti mérés
Három villamosenergia-mérő eszköz figyeli az AC bemeneti teljesítményt fázisonként:
- Bemeneti teljesítmény L1 — AC bemeneti teljesítmény 1. fázis a H:12-ből, a szolgáltatás attribútumaival a feszültséghez (H:3), áramhoz (H:6), frekvenciához (H:9) és ESS teljesítmény-alapértékhez (H:37). Az ESS alapérték egy szolgáltatás művelettel írható.
- Bemeneti teljesítmény L2 — AC bemeneti teljesítmény 2. fázis a H:13-ból, megfelelő L2 attribútumokkal és ESS alapértékkel L2 (H:40).
- Bemeneti teljesítmény L3 — AC bemeneti teljesítmény 3. fázis a H:14-ből, megfelelő L3 attribútumokkal és ESS alapértékkel L3 (H:41).
Minden bemeneti teljesítmény eszköz tartalmaz egy ESS teljesítmény-alapérték szolgáltatás műveletet a megfelelő fázishoz, lehetővé téve a TapHome számára az ESS töltési/kisütési viselkedés vezérlését fázisonként.
AC kimeneti mérés
Három villamosenergia-mérő eszköz figyeli az AC kimeneti teljesítményt fázisonként:
- Kimeneti teljesítmény L1 — AC kimenet a H:18-ból, a szolgáltatás attribútumaival a feszültséghez (H:15), áramhoz (H:18) és frekvenciához (H:21). A readscript figyeli a fázisriasztásokat a hőmérséklethez (H:44), alacsony akkumulátorhoz (H:45), túlterheléshez (H:46) és hullámhoz (H:47).
- Kimeneti teljesítmény L2 — AC kimenet a H:24-ből, L2 feszültséggel (H:16), árammal (H:19) és frekvenciával (H:21). Figyeli az L2 riasztásokat (H:48–51).
- Kimeneti teljesítmény L3 — AC kimenet a H:25-ből, L3 feszültséggel (H:17), árammal (H:20) és frekvenciával (H:21). Figyeli az L3 riasztásokat (H:52–55).
Bemeneti áramkorlát vezérlés
- Aktív bemeneti áramkorlát — olvassa és írja az aktív bemeneti áramkorlátot (H:22) amperben. A „Korlát beállítása" szolgáltatás művelet float értéket fogad el (0–100 A).
Védelmi kapcsolók
- DC túlfeszültség betáplálása a hálózatba — kapcsoló (H:65) a DC túlfeszültség hálózatba visszatáplálásának vezérlésére. A szolgáltatás attribútumok mutatják a maximális túlfeszültség betáplálási teljesítményt fázisonként (H:66–68) és az AC bemenet mellőzési állapotát (H:69–70). Egy szolgáltatás művelet lehetővé teszi a maximális betáplálási teljesítmény beállítását fázisonként.
- PV inverter — kapcsoló (H:56) a PV inverter frekvencia-eltolásának engedélyezésére vagy letiltására az AC kimeneten. Engedélyezéskor (kapcsoló KI) az AC kimeneten lévő PV inverter normálisan működik; letiltáskor (kapcsoló BE) a frekvencia-eltolás korlátozza a PV kimenetet.
Modul szintű szolgáltatás attribútumok és műveletek
Maga a modul több szolgáltatás attribútumot tesz elérhetővé a TapHome átjáró eszközéből:
| Attribútum | Regiszter | Leírás |
|---|---|---|
| Fázisszám | H:28 | AC fázisok száma a VE.Bus rendszerben |
| Kapcsoló pozíció | H:33 | Inverter üzemmód — Csak töltő, Csak inverter, Be, Ki |
| Aktív bemenet | H:29 | Aktív AC bemeneti forrás — AC bemenet 1, AC bemenet 2, Leválasztva |
| ESS töltés letiltása | H:38 | Töltési jelző — Töltés engedélyezve / Töltés letiltva |
| ESS betáplálás letiltása | H:39 | Betáplálási jelző — Betáplálás engedélyezve / Betáplálás letiltva |
| ESS teljesítmény-alapérték L1–L3 | H:37, H:40, H:41 | ESS teljesítmény-alapérték fázisonként wattban |
A modul szintű szolgáltatás műveletek lehetővé teszik az inverter üzemmód kapcsolást (Csak töltő, Csak inverter, Be, Ki), az ESS töltési jelző kapcsolást és az ESS betáplálási jelző kapcsolást.
Rendszer riasztásfigyelés
A modul readscriptje 7 rendszerszintű riasztást figyel:
| Regiszter | Riasztás | Szintek |
|---|---|---|
| H:34 | Hőmérsékleti riasztás | 0=Ok, 1=Figyelmeztetés, 2=Riasztás |
| H:35 | Alacsony akkumulátor riasztás | 0=Ok, 1=Figyelmeztetés, 2=Riasztás |
| H:36 | Túlterhelési riasztás | 0=Ok, 1=Figyelmeztetés, 2=Riasztás |
| H:42 | Hőmérséklet-érzékelő riasztás | 0=Ok, 1=Figyelmeztetés, 2=Riasztás |
| H:43 | Feszültségérzékelő riasztás | 0=Ok, 1=Figyelmeztetés, 2=Riasztás |
| H:63 | Fázissorrend figyelmeztetés | 0=Ok, 1=Figyelmeztetés |
| H:64 | Hálózatvesztési riasztás | 0=Ok, 1=Riasztás |
További lehetőségek
A VE.Bus regiszterkészlet (H:3–H:231) a sablon jelenlegi implementációján túl további regisztereket biztosít. Ezek közé tartoznak az AC bemenet/kimenet/akkumulátor energiaáramlás számlálók (H:74–92, változékony — újraindításkor nullázódik), töltési állapot felsorolás (H:95), 32 bites ESS teljesítmény-alapértékek nagyobb rendszerekhez (H:96–100), fejlett ESS beállítások mint a Megújuló energia preferálása (H:102), PowerAssist konfiguráció (H:106–108), UPS funkció vezérlés (H:109) és mikróhálózat/droop üzemmód regiszterek (H:200–231). Ezek egy jövőbeli frissítésben hozzáadhatók a TapHome sablonhoz.
Hibaelhárítás
Nincs Modbus kommunikáció
- Ellenőrizze, hogy a Modbus TCP engedélyezve van-e a GX eszközön (Beállítások → Szolgáltatások → Modbus-TCP)
- Erősítse meg a GX eszköz IP-címét — ellenőrizze a router DHCP bérleti táblázatát vagy a GX eszköz hálózati beállításait
- Győződjön meg arról, hogy a TapHome Core és a GX eszköz ugyanabban az alhálózatban vannak
- Ellenőrizze, hogy egyik tűzfal sem blokkolja a 502-es TCP portot
- Ellenőrizze a helyes unit ID-t — az alapértelmezett 227 a Cerbo GX-re vonatkozik; más GX modellek különböző ID-kat használnak
Helytelen teljesítményértékek
A sablon /100 skálázási tényezőt használ a teljesítmény regiszterekhez (H:12–14, H:23–25), míg a Victron dokumentáció 0,1-es tényezőt ad meg (vagyis nyers érték × 10 = tényleges watt). Ez a vártnál alacsonyabb teljesítményértékeket eredményezhet. Ha a teljesítményértékek helytelennek tűnnek, ez egy ismert sablon skálázási különbség — a relatív mérések arányosan helyesek maradnak.
VE.Bus hibakódok
Az akkumulátor eszköz readscriptje a H:32 regisztert ellenőrzi VE.Bus hibakódokhoz. Gyakori hibák:
| Kód | Leírás |
|---|---|
| 1 | Az eszköz kikapcsolt, mert egy másik fázis kikapcsolt |
| 5 | Túlfeszültség az AC kimeneten |
| 10 | Rendszeridő szinkronizálási probléma |
| 14 | Az eszköz nem tud adatot továbbítani |
| 16 | Dongle hiányzik |
| 17 | Az eszköz átvette a master státuszt, mert az eredeti master meghibásodott |
| 25 | Firmware inkompatibilitás a csatlakoztatott eszközök között |
| 26 | Belső hiba |
Ha tartós VE.Bus hibák jelentkeznek, a VE.Bus Reset művelet (az Akkumulátor eszközön elérhető) felhasználható a helyreállítás megkísérléséhez.
Unit ID megváltozott Venus OS frissítés után
A Venus OS 2.60 óta a unit ID-k dinamikusan kerülnek hozzárendelésre. Firmware frissítés után a unit ID megváltozhat. Navigáljon a Beállítások → Szolgáltatások → Modbus/TCP → Elérhető szolgáltatások menübe a GX eszközön az aktuális VE.Bus unit ID ellenőrzéséhez, majd frissítse a TapHome sablon slave ID-ját ennek megfelelően.
