Victron Energy GX Inverter

Modbus TCP

Inviato da

Ultimo aggiornamento: 03. 2026

Sito ufficiale Victron Energy

La famiglia di dispositivi Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) sono piattaforme di comunicazione e monitoraggio che forniscono accesso Modbus TCP agli inverter/caricatori Victron VE.Bus collegati (MultiPlus, Quattro). Il dispositivo GX non è un inverter — funge da gateway Modbus TCP verso il sistema VE.Bus.

TapHome si collega al dispositivo GX tramite Ethernet usando Modbus TCP. Il template espone il monitoraggio SOC della batteria, la misurazione AC ingresso e uscita su 3 fasi, il controllo del setpoint di potenza ESS (Energy Storage System), la commutazione della modalità inverter, la gestione dell’inverter FV e un monitoraggio allarmi completo.

Connessione di rete

Il dispositivo GX si collega alla rete locale tramite la porta Ethernet. TapHome Core e il dispositivo GX devono trovarsi nella stessa sottorete.

Protocollo: Modbus TCP
Porta: 502
Slave ID predefinito: 227 (porta VE.Bus Cerbo GX)
Codici funzione: 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)

Lo slave ID predefinito 227 si applica alla porta VE.Bus del Cerbo GX. Altri dispositivi GX usano ID diversi: 246 per CCGX, 242 per Venus GX, 228 per EasySolar-II GX. Gli unit ID vengono assegnati dinamicamente da Venus OS 2.60 — verificare l’ID effettivo sul dispositivo GX tramite Impostazioni → Servizi → Modbus/TCP → Servizi disponibili.

Configurazione

Abilitazione Modbus TCP

Modbus TCP è disabilitato per impostazione predefinita su tutti i dispositivi GX. Per abilitarlo:

Sul dispositivo GX navigare su Impostazioni → Servizi
Abilitare Modbus-TCP

Una volta abilitato, il dispositivo GX resta in ascolto sulla porta TCP 502.

Importazione del template TapHome

Quando si importa il template in TapHome, fornire:

Indirizzo IP — l’IP del dispositivo GX sulla rete locale
Slave ID — VE.Bus unit ID (predefinito: 227 per Cerbo GX)

Assegnare un indirizzo IP statico al dispositivo GX nelle impostazioni DHCP del router, oppure configurare un IP statico direttamente sul dispositivo GX tramite Impostazioni → Ethernet, per evitare che l’indirizzo cambi dopo un riavvio.

Funzionalità del dispositivo

Il template espone 10 dispositivi organizzati in monitoraggio batteria, misurazione AC, controllo modalità e interruttori di protezione.

Monitoraggio batteria

Batteria — legge lo stato di carica (SOC) VE.Bus dal registro H:30 come livello dimmer. Gli attributi di servizio mostrano la tensione della batteria (H:26), la corrente della batteria con indicatore di direzione (H:27), la temperatura della batteria (H:61), lo stato di carica VE.Bus (Spento, Bassa potenza, Guasto, Bulk, Assorbimento, Float, Stoccaggio, Equalizzazione, Passthru, Inversione, Power Assist, Alimentazione) e i permessi BMS di carica/scarica (H:57–59). Il readscript monitora H:32 per i codici errore VE.Bus (1–26) e H:60 per gli errori BMS. È disponibile un’azione VE.Bus Reset (H:62) per il recupero del sistema.

Misurazione AC ingresso

Tre dispositivi contatore elettrico monitorano la potenza di ingresso AC per fase:

Potenza ingresso L1 — potenza di ingresso AC fase 1 da H:12, con attributi di servizio per tensione (H:3), corrente (H:6), frequenza (H:9) e setpoint di potenza ESS (H:37). Il setpoint ESS è scrivibile tramite un’azione di servizio.
Potenza ingresso L2 — potenza di ingresso AC fase 2 da H:13, con attributi L2 corrispondenti e setpoint ESS L2 (H:40).
Potenza ingresso L3 — potenza di ingresso AC fase 3 da H:14, con attributi L3 corrispondenti e setpoint ESS L3 (H:41).

Ogni dispositivo di potenza ingresso include un’azione di servizio setpoint di potenza ESS per la rispettiva fase, consentendo a TapHome di controllare il comportamento di carica/scarica ESS per fase.

Misurazione AC uscita

Tre dispositivi contatore elettrico monitorano la potenza di uscita AC per fase:

Potenza uscita L1 — uscita AC da H:18, con attributi di servizio per tensione (H:15), corrente (H:18) e frequenza (H:21). Il readscript monitora gli allarmi per fase per temperatura (H:44), batteria scarica (H:45), sovraccarico (H:46) e ondulazione (H:47).
Potenza uscita L2 — uscita AC da H:24, con tensione L2 (H:16), corrente (H:19) e frequenza (H:21). Monitora allarmi L2 (H:48–51).
Potenza uscita L3 — uscita AC da H:25, con tensione L3 (H:17), corrente (H:20) e frequenza (H:21). Monitora allarmi L3 (H:52–55).

Controllo limite corrente ingresso

Limite corrente ingresso attivo — legge e scrive il limite di corrente di ingresso attivo (H:22) in ampere. L’azione di servizio “Imposta limite” accetta un valore float (0–100 A).

Interruttori di protezione

Immissione in rete sovratensione DC — interruttore (H:65) per controllare se la sovratensione DC viene reimmessa in rete. Gli attributi di servizio mostrano la potenza massima di immissione sovratensione per fase (H:66–68) e lo stato di ignoramento ingresso AC (H:69–70). Un’azione di servizio consente di impostare la potenza massima di immissione per fase.
Inverter FV — interruttore (H:56) per abilitare o disabilitare la modulazione di frequenza dell’inverter FV sull’uscita AC. Quando abilitato (interruttore SPENTO), l’inverter FV sull’uscita AC funziona normalmente; quando disabilitato (interruttore ACCESO), la modulazione di frequenza limita la produzione FV.

Attributi e azioni di servizio a livello di modulo

Il modulo stesso espone diversi attributi di servizio accessibili dal dispositivo gateway in TapHome:

Attributo	Registro	Descrizione
Numero fasi	H:28	Numero di fasi AC nel sistema VE.Bus
Posizione interruttore	H:33	Modalità inverter — Solo caricatore, Solo inverter, Acceso, Spento
Ingresso attivo	H:29	Sorgente di ingresso AC attiva — Ingresso AC 1, Ingresso AC 2, Disconnesso
ESS disabilita carica	H:38	Flag di carica — Carica abilitata / Carica disabilitata
ESS disabilita immissione	H:39	Flag di immissione — Immissione abilitata / Immissione disabilitata
Setpoint potenza ESS L1–L3	H:37, H:40, H:41	Setpoint di potenza ESS per fase in watt

Le azioni di servizio a livello di modulo consentono la commutazione della modalità inverter (Solo caricatore, Solo inverter, Acceso, Spento), la commutazione del flag di carica ESS e la commutazione del flag di immissione ESS.

Monitoraggio allarmi di sistema

Il readscript del modulo monitora 7 allarmi di sistema:

Registro	Allarme	Livelli
H:34	Allarme temperatura	0=Ok, 1=Avviso, 2=Allarme
H:35	Allarme batteria scarica	0=Ok, 1=Avviso, 2=Allarme
H:36	Allarme sovraccarico	0=Ok, 1=Avviso, 2=Allarme
H:42	Allarme sensore temperatura	0=Ok, 1=Avviso, 2=Allarme
H:43	Allarme sensore tensione	0=Ok, 1=Avviso, 2=Allarme
H:63	Avviso rotazione fasi	0=Ok, 1=Avviso
H:64	Allarme perdita rete	0=Ok, 1=Allarme

Funzionalità aggiuntive

Il set di registri VE.Bus (H:3–H:231) fornisce registri aggiuntivi oltre all’implementazione corrente del template. Questi includono contatori di energia per i flussi AC ingresso/uscita/batteria (H:74–92, volatili — reset al riavvio), enumerazione stato di carica (H:95), setpoint di potenza ESS a 32 bit per sistemi più grandi (H:96–100), impostazioni ESS avanzate come Preferenza energia rinnovabile (H:102), configurazione PowerAssist (H:106–108), controllo funzione UPS (H:109) e registri microgrid/droop mode (H:200–231). Questi potranno essere aggiunti al template TapHome in un futuro aggiornamento.

Risoluzione dei problemi

Nessuna comunicazione Modbus

Verificare che Modbus TCP sia abilitato sul dispositivo GX (Impostazioni → Servizi → Modbus-TCP)
Confermare l’indirizzo IP del dispositivo GX — controllare la tabella lease DHCP del router o le impostazioni di rete del dispositivo GX
Assicurarsi che TapHome Core e il dispositivo GX siano nella stessa sottorete
Verificare che nessun firewall stia bloccando la porta TCP 502
Verificare il corretto unit ID — il valore predefinito 227 si applica al Cerbo GX; altri modelli GX usano ID diversi

Valori di potenza errati

Il template utilizza un fattore di scala /100 per i registri di potenza (H:12–14, H:23–25), mentre la documentazione Victron specifica un fattore 0,1 (ovvero valore grezzo × 10 = watt effettivi). Questo può produrre valori di potenza inferiori al previsto. Se i valori di potenza appaiono errati, si tratta di una differenza nota nel fattore di scala del template — le misurazioni relative rimangono proporzionalmente corrette.

Codici errore VE.Bus

Il readscript del dispositivo Batteria controlla il registro H:32 per i codici errore VE.Bus. Errori comuni:

Codice	Descrizione
1	Dispositivo spento perché un’altra fase si è spenta
5	Sovratensione sull’uscita AC
10	Problema di sincronizzazione dell’ora di sistema
14	Il dispositivo non può trasmettere dati
16	Dongle mancante
17	Il dispositivo ha assunto lo stato master perché il master originale è andato in guasto
25	Incompatibilità firmware tra i dispositivi collegati
26	Errore interno

In presenza di errori VE.Bus persistenti, l’azione VE.Bus Reset (disponibile sul dispositivo Batteria) può essere utilizzata per tentare il recupero.

Unit ID cambiato dopo aggiornamento Venus OS

Da Venus OS 2.60, gli unit ID vengono assegnati dinamicamente. Dopo un aggiornamento firmware, l’unit ID potrebbe cambiare. Navigare su Impostazioni → Servizi → Modbus/TCP → Servizi disponibili sul dispositivo GX per verificare l’unit ID VE.Bus corrente, quindi aggiornare lo slave ID nel template TapHome di conseguenza.

Dispositivi disponibili

Victron GX Line Inverter Modulo

Attributi di servizio

Numero fasi
Posizione interruttore	Modalità operativa inverter — Solo caricatore, Solo inverter, Acceso, Spento
Ingresso attivo	Sorgente ingresso AC attiva — Ingresso AC 1, Ingresso AC 2, Disconnesso
ESS flag disabilitazione carica fase	Permesso carica ESS — Carica abilitata o Carica disabilitata
ESS feedback disabilitazione carica fase	Permesso immissione ESS — Immissione abilitata o Immissione disabilitata
Setpoint potenza ESS fase 1
Setpoint potenza ESS fase 2
Setpoint potenza ESS fase 3

Azioni di servizio

Posizione interruttore	Imposta modalità inverter — Solo caricatore, Solo inverter, Acceso, Spento
Flag carica fase	Abilitare o disabilitare la carica batteria ESS
Flag feedback fase	Abilitare o disabilitare l'immissione in rete ESS

Vitron GX Line Inverter

Lettura (modulo)

var temp := MODBUSR(H, 34, Uint16);
IF(temp = 1, ADDWARNING("Temperature alarm"));
IF(temp = 2, ADDERROR("Temperature alarm"));
var low := MODBUSR(H, 35, Uint16);
IF(low = 1, ADDWARNING("Low Battery alarm"));
IF(low = 2, ADDERROR("Low Battery alarm"));
var over := MODBUSR(H, 36, Uint16);
IF(over = 1, ADDWARNING("Overload alarm"));
IF(over = 2, ADDERROR("Overload alarm"));
var seb := MODBUSR(H, 42, Uint16);
IF(seb = 1, ADDWARNING("Temperature sensor alarm"));
IF(seb = 2, ADDERROR("Temperature sensor alarm"));
var vol := MODBUSR(H, 43, Uint16);
IF(vol = 1, ADDWARNING("Voltage sensor alarm"));
IF(vol = 2, ADDERROR("Voltage sensor alarm"));
IF(MODBUSR(H, 63, Uint16) = 1, ADDWARNING("Phase Rotation Warning"));
IF(MODBUSR(H, 64, Uint16) = 1, ADDERROR("Grid Lost Alarm"));

Attributi di servizio

Phase Count

MODBUSR(H, 28, Uint16);

Switch Position

var reg := MODBUSR(H, 33, Uint16);
Switch(reg, 1, "Charger Only", 2, "Inverter Only", 3 ,"On", 4, "Off", "Unknown");

Active Input

var reg := MODBUSR(H, 29, Uint16);
switch(reg, 0, "AC Input 1", 1, "AC Input 2", 240, "Disconnected", "Unknown");

ESS Disable Charge flag phase

IF(MODBUSR(H, 38, Uint16) = 1, "Charge disabled", "Charge enabled")

ESS Disable Charge feedback phase

IF(MODBUSR(H, 39, Uint16) = 1, "Feed disabled");
IF(MODBUSR(H, 39, Uint16) = 0, "Feed in enabled", "Not set");

ESS power setpoint phase 1

MODBUSR(H, 37, Uint16) + " W";

ESS power setpoint phase 2

MODBUSR(H, 40, Uint16) + " W";

ESS power setpoint phase 3

MODBUSR(H, 41, Uint16) + " W";

Azioni di servizio

Switch Position

Parametri: Switch Position

MODBUSWNE(H, 33, uint16, pos);

Charge flag phase

Parametri: Charge flag phase

MODBUSWNE(H, 38, Uint16, chfp);

Feedback flag phase

Parametri: Feedback flag phase

MODBUSWNE(H, 39, Uint16, ffp);

Limite corrente ingresso attivo Variabile

Limite corrente ingresso AC in ampere — regolabile tramite azione Imposta limite (0–100 A)

Registro: H:22 Int16 Unità: A numeric

Azioni di servizio

Imposta limite

Batteria Dimmer

Stato di carica batteria con tensione, corrente, temperatura, stato carica VE.Bus e permessi BMS

Registro: H:30 UInt16 Unità: % numeric

Attributi di servizio

Tensione batteria
Corrente batteria
Flusso	Direzione corrente — sistema DC verso Multi, Multi verso sistema DC, o inattivo
Temperatura batteria
Stato	Stato di carica VE.Bus — Spento, Bassa potenza, Guasto, Bulk, Assorbimento, Float, Stoccaggio, Equalizzazione, Passthru, Inversione, Power Assist, Alimentazione
VE.Bus BMS consente la carica della batteria
VE.Bus BMS consente lo scarico della batteria
VE.Bus BMS atteso

Azioni di servizio

VE.Bus Reset

Batteria

Lettura (modulo)

var reg := MODBUSR(H, 32, Uint16);
SWITCH(reg, 1, ADDERROR("VE.Bus Error 1: Device is switched off because one of the other phases in the system has switched of"), 2, "VE.Bus Error 2: New and old types MK2 are mixed in the system", 3, "VE.Bus Error 3: Not all- or more than- the expected devices were found in the system", 4, "VE.Bus Error 4: No other device whatsoever detected", 5, "VE.Bus Error 5: Overvoltage on AC-out", 6, "VE.Bus Error 6: Error in DDC Program", 7, "VE.Bus BMS connected- which requires an Assistant- but no assistant found", 10, "VE.Bus Error 10: System time synchronisation problem occurred", 14, "VE.Bus Error 14: Device cannot transmit data", 16, "VE.Bus Error 16: Dongle missing", 17, "VE.Bus Error 17: One of the devices assumed master status because the original master failed",18, "VE.Bus Error 18: AC Overvoltage on the output of a slave has occurred while already switched off", 22, "VE.Bus Error 22: This device cannot function as slave", 24, "VE.Bus Error 24: Switch-over system protection initiated", 25, "VE.Bus Error 25: Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device", 26, "VE.Bus Error 26: Internal error", "No error");
IF(MODBUSR(H, 60, Uint16) = 1, ADDERROR("VE.Bus BMS error"));

Lettura livello

MODBUSR(H, 30, UInt16) / 1000

Attributi di servizio

Battery Voltage

MODBUSR(H, 26, Uint16)/100 + " V";

Battery Current

ABS(MODBUSR(H, 27, int16)/10) + " A";

Flow

var reg := MODBUSR(H, 27, int16);
IF(reg = 0, "-");
IF(reg < 0, "DC system to Multi", "Multi to DC system");

Battery Temperature

var tempt := MODBUSR(H, 61, Int16)/10; 
IF(tempt = 0, "Unknown", tempt + " °C")

State

var reg := MODBUSR(H, 31, Uint16);
SWITCH(reg, 0, "Off",
 1, "Low Power",
 2, "Fault",
 3, "Bulk",
 4, "Absorbtion",
 5, "Float", 
 6, "Storage", 
 7, "Equalize", 
 8, "Passtru", 
 9, "Inverting", 
 10, "Power Assist", 
 11, "Power Supply", 
 252, "Bulk protection",
 "Unknown" );

VE.Bus BMS allows battery to be charged

SWITCH(MODBUSR(H, 57, Uint16), 0, "No", 1, "Yes", "Unknown");

VE.Bus BMS allows battery to be discharged

SWITCH(MODBUSR(H, 58, Uint16), 0, "No", 1, "Yes", "Unknown");

VE.Bus BMS is expected

SWITCH(MODBUSR(H, 59, Uint16), 0, "No", 1, "Yes", "Unknown");

Azioni di servizio

VE.Bus Reset

Parametri: Reset

MODBUSW(H, 62, Uint16, res);

Immissione in rete sovratensione DC Interruttore

Commutazione immissione in rete sovratensione DC con limiti di potenza massima per fase

Registro: H:65 UInt16 numeric

Valori / Stati: Feed in overvoltage · Don't feed in overvoltage

Azioni di servizio

Potenza massima immissione sovratensione

Impostare la potenza massima di immissione sovratensione DC per fase (L1, L2, L3)

Immissione in rete sovratensione DC

Lettura stato interruttore

MODBUSR(H, 65, Uint16);

Scrittura stato interruttore

MODBUSW(H, 65, Uint16, St);

Attributi di servizio

Maximum overvoltage feed-in power L1

MODBUSR(H, 66, Uint16)/ 0.01 + " W";

Maximum overvoltage feed-in power L2

MODBUSR(H, 67, Uint16)/ 0.01 + " W";

Maximum overvoltage feed-in power L3

MODBUSR(H, 68, Uint16)/ 0.01 + " W";

AC input 1

SWITCH(MODBUSR(H, 69, Uint16), 0, "not ignored", 1, "ignored", "Unknown");

AC input 2

SWITCH(MODBUSR(H, 70, Uint16), 0, "not ignored", 1, "ignored", "Unknown");

Azioni di servizio

Maximum overvoltage feed-in power

Parametri: L1[W] (0–6.5535e+06 L1), L2[W] (0–6.5535e+06 L2), L3[W] (0–65535 L3)

MODBUSWNE(H, 66, Uint16, L1)/100;
MODBUSWNE(H, 67, Uint16, L2)/100;
MODBUSWNE(H, 68, Uint16, L2)/100;

Potenza ingresso L1 Contatore elettrico

Potenza ingresso AC fase 1 con tensione, corrente, frequenza e setpoint potenza ESS

Registro: H:12 Int16 Unità: W numeric

Attributi di servizio

Tensione ingresso L1

Corrente ingresso L1

Frequenza ingresso 1

Setpoint potenza ESS fase 1

Azioni di servizio

Setpoint potenza ESS fase 1

Potenza ingresso L1

Lettura domanda

MODBUSR(H, 12, Int16) / 100

Attributi di servizio

Input Voltage L1

MODBUSR(H, 3, Uint16)/10  + " V"

Input Current L1

MODBUSR(H, 6, Int16)/10  + " A";

Input Frequency 1

MODBUSR(H, 9, Int16)/100  + " Hz";

ESS power setpoint phase 1

MODBUSR(H, 37, int16) + " W";

Azioni di servizio

ESS power setpoint phase 1

Parametri: Power setpoint L1 [W] (-32768–32768 L1)

MODBUSW(H, 37, int16, L1);

Potenza ingresso L2 Contatore elettrico

Potenza ingresso AC fase 2 con tensione, corrente, frequenza e setpoint potenza ESS

Registro: H:13 Int16 Unità: W numeric

Attributi di servizio

Tensione ingresso L2

Corrente ingresso L2

Frequenza ingresso 2

Setpoint potenza ESS fase 2

Azioni di servizio

Setpoint potenza ESS fase 2

Potenza ingresso L2

Lettura domanda

MODBUSR(H, 13, Int16) / 100

Attributi di servizio

Input Voltage L2

MODBUSR(H, 4, Uint16)/10  + " V"

Input Current L2

MODBUSR(H, 7, Int16)/10  + " A";

Input Frequency 2

MODBUSR(H, 10, Int16)/100  + " Hz";

ESS power setpoint phase 2

MODBUSR(H, 40, int16) + " W";

Azioni di servizio

ESS power setpoint phase 2

Parametri: ESS Power setpoint L2 [W] (-32768–32768 L2)

MODBUSW(H, 40, Int16, L2)

Potenza ingresso L3 Contatore elettrico

Potenza ingresso AC fase 3 con tensione, corrente, frequenza e setpoint potenza ESS

Registro: H:14 Int16 Unità: W numeric

Attributi di servizio

Tensione ingresso L3

Corrente ingresso L3

Frequenza ingresso 3

Setpoint potenza ESS fase 3

Azioni di servizio

Setpoint potenza ESS fase 3

Potenza ingresso L3

Lettura domanda

MODBUSR(H, 14, Int16) / 100

Attributi di servizio

Input Voltage L3

MODBUSR(H, 5, Uint16)/10  + " V"

Input Current L3

MODBUSR(H, 8, Int16)/10  + " A";

Input Frequency 3

MODBUSR(H, 11, Int16)/100  + " Hz";

ESS power setpoint phase 3

MODBUSR(H, 41, int16) + " W";

Azioni di servizio

ESS power setpoint phase 3

Parametri: ESS power setpoint L3 [W] (-32768–32768 L3)

MODBUSW(H, 41, Int16, L3)

Potenza uscita L1 Contatore elettrico Solo lettura

Uscita AC fase 1 con tensione, corrente, frequenza e monitoraggio allarmi per fase

Registro: H:18 Int16 Unità: W numeric

Attributi di servizio

Tensione uscita L1

Corrente uscita L1

Frequenza uscita

Potenza uscita L1

Lettura domanda

MODBUSR(H, 18, Int16) / 100

Lettura (modulo)

var tem := MODBUSR(H, 44, Uint16);
SWITCH(tem,1, ADDWARNING("Temperature Alarm L1"), 2, ADDERROR("Temperature Alarm L1"),"");
var bat := MODBUSR(H, 45, Uint16);
SWITCH(bat,1, ADDWARNING("Low Battery Alarm L1"), 2, ADDERROR("Low Battery Alarm L1"),"");
var ove := MODBUSR(H, 46, Uint16);
SWITCH(ove,1, ADDWARNING("Overload Alarm L1"), 2, ADDERROR("Overload Alarm L1"),"");
var rip := MODBUSR(H, 47, Uint16);
SWITCH(rip,1, ADDWARNING("Ripple Alarm L1"), 2, ADDERROR("Ripple Alarm L1"),"");

Attributi di servizio

Output Voltage L1

MODBUSR(H, 15, UInt16)/10  + " V";

Output Current L1

MODBUSR(H, 18, Int16)/10  + " A";

Output Frequency

MODBUSR(H, 21, Int16)/100 + " Hz";

Potenza uscita L2 Contatore elettrico Solo lettura

Uscita AC fase 2 con tensione, corrente, frequenza e monitoraggio allarmi per fase

Registro: H:24 Int16 Unità: W numeric

Attributi di servizio

Tensione uscita L2

Corrente uscita L2

Frequenza uscita

Potenza uscita L2

Lettura domanda

MODBUSR(H, 24, Int16) / 100

Lettura (modulo)

var tem := MODBUSR(H, 48, Uint16);
SWITCH(tem,1, ADDWARNING("Temperature Alarm L2"), 2, ADDERROR("Temperature Alarm L2"),"");
var bat := MODBUSR(H, 49, Uint16);
SWITCH(bat,1, ADDWARNING("Low Battery Alarm L2"), 2, ADDERROR("Low Battery Alarm L2"),"");
var ove := MODBUSR(H, 50, Uint16);
SWITCH(ove,1, ADDWARNING("Overload Alarm L2"), 2, ADDERROR("Overload Alarm L2"),"");
var rip := MODBUSR(H, 51, Uint16);
SWITCH(rip,1, ADDWARNING("Ripple Alarm L2"), 2, ADDERROR("Ripple Alarm L2"),"");

Attributi di servizio

Output voltage L2

MODBUSR(H, 16, UInt16)/10  + " V";

Output Current L2

MODBUSR(H, 19, Int16)/10  + " A";

Output Frequency

MODBUSR(H, 21, Int16)/100 + " Hz";

Potenza uscita L3 Contatore elettrico Solo lettura

Uscita AC fase 3 con tensione, corrente, frequenza e monitoraggio allarmi per fase

Registro: H:25 Int16 Unità: W numeric

Attributi di servizio

Tensione uscita L3

Corrente uscita L3

Frequenza uscita

Potenza uscita L3

Lettura domanda

MODBUSR(H, 25, Int16) / 100

Lettura (modulo)

var tem := MODBUSR(H, 52, Uint16);
SWITCH(tem,1, ADDWARNING("Temperature Alarm L3"), 2, ADDERROR("Temperature Alarm L3"),"");
var bat := MODBUSR(H, 53, Uint16);
SWITCH(bat,1, ADDWARNING("Low Battery Alarm L3"), 2, ADDERROR("Low Battery Alarm L3"),"");
var ove := MODBUSR(H, 54, Uint16);
SWITCH(ove,1, ADDWARNING("Overload Alarm L3"), 2, ADDERROR("Overload Alarm L3"),"");
var rip := MODBUSR(H, 55, Uint16);
SWITCH(rip,1, ADDWARNING("Ripple Alarm L3"), 2, ADDERROR("Ripple Alarm L3"),"");

Attributi di servizio

Output Voltage L3

MODBUSR(H, 17, UInt16)/10  + " V";

Output Current L3

MODBUSR(H, 20, Int16)/10  + " A";

Output Frequency

MODBUSR(H, 21, Int16)/100 + " Hz";

Inverter FV Interruttore

Controllo modulazione frequenza inverter FV — abilitare o disabilitare uscita FV sull'AC-out

Registro: H:56 UInt16 numeric

Valori / Stati: PV disabled · PV enabled

Connessione: Modbus TCP • Slave ID: $[SlaveId]

Possibili miglioramenti (16)

H:23 Output Power L1 — Int16, ×10, W — actual output power L1 register; template uses H:18 (current) for Output Power 1 readdemand instead
H:71 AcPowerSetpoint acts as feed-in limit — UInt16, 0=Normal, 1=OvervoltageFeedIn limit
H:72 Solar offset voltage — UInt16, 0=1V offset, 1=0.1V offset
H:73 Sustain active — UInt16, 0=Inactive, 1=Active
H:74-92 Energy Counters (10 × UInt32) — /100, kWh — AC-In/Out/Battery energy flow counters; volatile (reset on Multi/GX reboot)
H:94 BMS Pre-Alarm (Low cell voltage imminent) — UInt16, 0=Ok, 1=Warning, 2=Alarm
H:95 Charge State — UInt16, enum: 0=Initialising, 1=Bulk, 2=Absorption, 3=Float, 4=Storage, 5=Absorb repeat, 6=Forced absorb, 7=Equalise, 8=Bulk stopped, 9=Unknown
H:96-100 ESS 32-bit Power Setpoints (L1-L3) — Int32, W — 32-bit complement of H:37/40/41 for larger systems
H:102 Prefer Renewable Energy — UInt16, 0=No, 1=Yes; Venus 3.30+
H:103-104 Remote Generator Selected — UInt16, select/status; Venus 3.30+
H:105 Redetect VE.Bus system — Write 1 to redetect
H:106 Power Assist boost factor — UInt16, /100; Venus 3.30+
H:107 Configured output voltage — UInt16, /100, V AC; Venus 3.30+
H:108 PowerAssist enabled — UInt16, 0=Disabled, 1=Enabled; Venus 3.30+
H:109 UPS function enabled — UInt16, 0=Enabled, 1=Disabled (inverted); Venus 3.30+
H:200-231 Microgrid Registers — Grid-forming / grid-following / droop mode control; most RW, some unsupported in current firmware

Scarica template

Fonti

GX Modbus-TCP Manual
www.victronenergy.com 2026-03-28
CCGX Modbus TCP Register List v3.70
www.victronenergy.com 2026-03-28
hass-victron — Home Assistant Integration
github.com 2026-03-28