---
title: "Victron Energy GX Inverter"
description: "Victron GX (Cerbo GX, Venus GX, CCGX) in TapHome via Modbus TCP: SOC batteria, AC ingresso/uscita trifase, setpoint ESS, modalità inverter e allarmi."
url: "https://taphome.com/it/compatibility/victron-energy-gx/"
language: it
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["modbus-tcp","inverter","energy-storage","ethernet","3-phase","ess"]
  questions: ["Come integrare Victron Energy GX con TapHome?","Cosa monitora e controlla il template Victron GX Line Inverter in TapHome?","Come collegare Victron Cerbo GX tramite Modbus TCP a TapHome?","Come impostare i setpoint di potenza ESS su Victron tramite TapHome?","Cos'è lo Slave ID 227 su Victron GX?","Perché il template Victron GX mostra valori di potenza errati?"]
---

# Victron Energy GX Inverter

Comunicazione: Modbus TCP

- [Sito ufficiale Victron Energy](https://www.victronenergy.com/)

> Indirizzo di rete
> 
> TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.
> 
> [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)

## Guida all'integrazione

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)

> [!NOTE]
> 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:

1. Sul dispositivo GX navigare su **Impostazioni → Servizi**
2. 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)

> [!TIP]
> 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 potenza in eccesso dal fotovoltaico accoppiato in DC (che aumenta la tensione DC) viene immessa 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

1. Verificare che Modbus TCP sia abilitato sul dispositivo GX (Impostazioni → Servizi → Modbus-TCP)
2. Confermare l'indirizzo IP del dispositivo GX — controllare la tabella lease DHCP del router o le impostazioni di rete del dispositivo GX
3. Assicurarsi che TapHome Core e il dispositivo GX siano nella stessa sottorete
4. Verificare che nessun firewall stia bloccando la porta TCP 502
5. 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 10

Questi dispositivi compaiono in TapHome dopo l'importazione.

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 disabilita immissione            | 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                            |
| ESS flag di immissione | Abilitare o disabilitare l'immissione in rete ESS                          |

Lettura (modulo)

```taphome
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

```taphome
MODBUSR(H, 28, Uint16);
```

Switch Position

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

Active Input

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

ESS Disable Charge flag phase

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

ESS Disable Charge feedback phase

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

ESS power setpoint phase 1

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

ESS power setpoint phase 2

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

ESS power setpoint phase 3

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

Azioni di servizio

Switch Position

Parametri: Switch Position

```taphome
MODBUSWNE(H, 33, uint16, pos);
```

Charge flag phase

Parametri: Charge flag phase

```taphome
MODBUSWNE(H, 38, Uint16, chfp);
```

Feedback flag phase

Parametri: Feedback flag phase

```taphome
MODBUSWNE(H, 39, Uint16, ffp);
```

Limite corrente ingresso attivo Variabile Lettura e scrittura

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 |

Lettura

```taphome
MODBUSR(H, 22, int16)/10
```

Azioni di servizio

Set Limit

Parametri: Active Input Current Limit \[A] (0–100 aic)

```taphome
MODBUSWNE(H, 22, Int16, aic*10)
```

Batteria Dimmer Lettura e scrittura

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 |

Lettura (modulo)

```taphome
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

```taphome
MODBUSR(H, 30, UInt16) / 1000
```

Attributi di servizio

Battery Voltage

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

Battery Current

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

Flow

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

Battery Temperature

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

State

```taphome
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

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

VE.Bus BMS allows battery to be discharged

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

VE.Bus BMS is expected

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

Azioni di servizio

VE.Bus Reset

Parametri: Reset

```taphome
MODBUSW(H, 62, Uint16, res);
```

Immissione in rete sovratensione DC Interruttore Lettura e scrittura

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) |

Lettura stato interruttore

```taphome
MODBUSR(H, 65, Uint16);
```

Scrittura stato interruttore

```taphome
MODBUSW(H, 65, Uint16, St);
```

Attributi di servizio

Maximum overvoltage feed-in power L1

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

Maximum overvoltage feed-in power L2

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

Maximum overvoltage feed-in power L3

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

AC input 1

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

AC input 2

```taphome
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)

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

Potenza ingresso L1 Contatore elettrico Lettura e scrittura

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 |

Lettura domanda

```taphome
MODBUSR(H, 12, Int16) / 100
```

Attributi di servizio

Input Voltage L1

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

Input Current L1

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

Input Frequency 1

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

ESS power setpoint phase 1

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

Azioni di servizio

ESS power setpoint phase 1

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

```taphome
MODBUSW(H, 37, int16, L1);
```

Potenza ingresso L2 Contatore elettrico Lettura e scrittura

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 |

Lettura domanda

```taphome
MODBUSR(H, 13, Int16) / 100
```

Attributi di servizio

Input Voltage L2

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

Input Current L2

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

Input Frequency 2

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

ESS power setpoint phase 2

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

Azioni di servizio

ESS power setpoint phase 2

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

```taphome
MODBUSW(H, 40, Int16, L2)
```

Potenza ingresso L3 Contatore elettrico Lettura e scrittura

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 |

Lettura domanda

```taphome
MODBUSR(H, 14, Int16) / 100
```

Attributi di servizio

Input Voltage L3

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

Input Current L3

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

Input Frequency 3

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

ESS power setpoint phase 3

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

Azioni di servizio

ESS power setpoint phase 3

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

```taphome
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   |

Lettura domanda

```taphome
MODBUSR(H, 18, Int16) / 100
```

Lettura (modulo)

```taphome
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

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

Output Current L1

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

Output Frequency

```taphome
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   |

Lettura domanda

```taphome
MODBUSR(H, 24, Int16) / 100
```

Lettura (modulo)

```taphome
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

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

Output Current L2

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

Output Frequency

```taphome
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   |

Lettura domanda

```taphome
MODBUSR(H, 25, Int16) / 100
```

Lettura (modulo)

```taphome
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

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

Output Current L3

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

Output Frequency

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

Inverter FV Interruttore Lettura e scrittura

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

Registro: H:56 UInt16 numeric

Valori / Stati: PV disabled · PV enabled

Lettura stato interruttore

```taphome
MODBUSR(H, 56, Uint16)
```

Scrittura stato interruttore

```taphome
MODBUSWNE(H, 56, Uint16, St);
```

**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

## Parametri di importazione

Inserisci questi valori quando importi l'XML.

| Richiesto nell'app | Predefinito   |
|--------------------|---------------|
| Slave ID           | `227`         |
| Indirizzo IP       | `192.168.1.0` |

## Fonti

- GX Modbus-TCP Manual
  
  [www.victronenergy.com](https://www.victronenergy.com/live/ccgx:modbustcp_faq) 2026-03-28
- CCGX Modbus TCP Register List v3.70
  
  [www.victronenergy.com](https://www.victronenergy.com/upload/documents/CCGX-Modbus-TCP-register-list-3.70.xlsx) 2026-03-28
- hass-victron — Home Assistant Integration
  
  [github.com](https://github.com/sfstar/hass-victron) 2026-03-28

## Documentazione correlata

- [Modbus Integration](https://taphome.com/it/compatibility/modbus-guide/)
- [Modbus - Configurazione](https://taphome.com/it/docs/integration/modbus/)
- [Configurazione semplice utilizzando modelli](https://taphome.com/it/docs/integration/modbus/templates/)
- [Script Modbus e prefetch](https://taphome.com/it/docs/script/modbus-scripts/)
- [Funzioni Modbus](https://taphome.com/it/docs/script/modbus/)
- [Tipi di dati Modbus](https://taphome.com/it/docs/script/modbus-data-types/)