---
title: "Victron Energy GX Střídač"
description: "Zařízení Victron Energy GX (Cerbo GX, Venus GX, CCGX) připojená k TapHome přes Modbus TCP."
url: "https://taphome.com/cs/compatibility/victron-energy-gx/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["modbus-tcp","inverter","energy-storage","ethernet","3-phase","ess"]
  questions: ["Jak integrovat Victron Energy GX s TapHome?","Co monitoruje a ovládá šablona Victron GX Line Inverter v TapHome?","Jak připojit Victron Cerbo GX přes Modbus TCP k TapHome?","Jak nastavit ESS výkonové setpointy Victron přes TapHome?","Co je Slave ID 227 na Victron GX?","Proč šablona Victron GX zobrazuje nesprávné hodnoty výkonu?"]
---

# Victron Energy GX Střídač

Komunikace: Modbus TCP

- [Oficiální stránka Victron Energy](https://www.victronenergy.com/)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Rodina zařízení Victron GX (Cerbo GX, Cerbo GX MK2, Venus GX, CCGX) jsou komunikační a monitorovací platformy, které poskytují přístup přes Modbus TCP k připojeným střídačům/nabíječkám Victron VE.Bus (MultiPlus, Quattro). Samotné GX zařízení není střídač — funguje jako Modbus TCP brána k systému VE.Bus.

TapHome se připojuje k GX zařízení přes Ethernet pomocí Modbus TCP. Šablona zpřístupňuje monitorování SOC baterie, měření AC vstupu a výstupu na 3 fázích, řízení výkonového setpointu ESS (Energy Storage System), přepínání režimu střídače, správu FV střídače a komplexní monitorování alarmů.

## Síťové připojení

GX zařízení se připojuje k lokální síti přes Ethernet port. TapHome Core a GX zařízení musí být ve stejné podsíti.

- **Protokol:** Modbus TCP
- **Port:** 502
- **Výchozí Slave ID:** 227 (port VE.Bus Cerbo GX)
- **Funkční kódy:** 3 (ReadHoldingRegisters), 6 (WriteSingleRegister), 16 (WriteMultipleRegisters)

> [!NOTE]
> Výchozí slave ID 227 platí pro port VE.Bus Cerbo GX. Jiná GX zařízení používají různá ID: 246 pro CCGX, 242 pro Venus GX, 228 pro EasySolar-II GX. Unit ID jsou dynamicky přidělována od Venus OS 2.60 — aktuální ID ověříte na GX zařízení přes Nastavení → Služby → Modbus/TCP → Dostupné služby.

## Konfigurace

### Povolení Modbus TCP

Modbus TCP je na všech GX zařízeních **výchozně vypnutý**. Zapnutí:

1. Na GX zařízení přejděte na **Nastavení → Služby**
2. Povolte **Modbus-TCP**

Po povolení GX zařízení naslouchá na TCP portu 502.

### Import šablony do TapHome

Při importu šablony v TapHome zadejte:

- **IP adresa** — IP adresa GX zařízení v lokální síti
- **Slave ID** — VE.Bus unit ID (výchozně: 227 pro Cerbo GX)

> [!TIP]
> Přiřaďte GX zařízení statickou IP adresu v nastavení DHCP routeru, nebo nakonfigurujte statickou IP přímo na GX zařízení přes Nastavení → Ethernet, aby se adresa nezměnila po restartu.

## Možnosti zařízení

Šablona zpřístupňuje 10 zařízení rozdělených do skupin monitorování baterie, měření AC, řízení režimu a ochranných spínačů.

### Monitorování baterie

- **Baterie** — čte stav nabití (SOC) VE.Bus z registru H:30 jako úroveň stmívače. Atributy služby zobrazují napětí baterie (H:26), proud baterie s indikátorem směru (H:27), teplotu baterie (H:61), stav nabíjení VE.Bus (Vypnutý, Nízký výkon, Porucha, Bulk, Absorpce, Float, Uložení, Ekvalizace, Passthru, Invertor, Power Assist, Napájení) a oprávnění BMS pro nabíjení/vybíjení (H:57–59). Readscript sleduje H:32 pro chybové kódy VE.Bus (1–26) a H:60 pro chyby BMS. Pro obnovu systému je k dispozici akce VE.Bus Reset (H:62).

### Měření AC vstupu

Tři zařízení elektroměrů monitorují příkon AC vstupu na fázi:

- **Příkon vstupu L1** — příkon AC vstupu fáze 1 z H:12, s atributy služby pro napětí (H:3), proud (H:6), frekvenci (H:9) a ESS výkonový setpoint (H:37). ESS setpoint je zapisovatelný přes akci služby.
- **Příkon vstupu L2** — příkon AC vstupu fáze 2 z H:13, s odpovídajícími atributy L2 a ESS setpointem L2 (H:40).
- **Příkon vstupu L3** — příkon AC vstupu fáze 3 z H:14, s odpovídajícími atributy L3 a ESS setpointem L3 (H:41).

Každé zařízení příkonu vstupu obsahuje akci ESS výkonového setpointu pro příslušnou fázi, což umožňuje TapHome řídit chování ESS nabíjení/vybíjení pro každou fázi.

### Měření AC výstupu

Tři zařízení elektroměrů monitorují výkon AC výstupu na fázi:

- **Výkon výstupu L1** — AC výstup z H:18, s atributy služby pro napětí (H:15), proud (H:18) a frekvenci (H:21). Readscript sleduje alarmy na fázi pro teplotu (H:44), nízkou baterii (H:45), přetížení (H:46) a zvlnění (H:47).
- **Výkon výstupu L2** — AC výstup z H:24, s napětím L2 (H:16), proudem (H:19) a frekvencí (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), proudem (H:20) a frekvencí (H:21). Sleduje alarmy L3 (H:52–55).

### Řízení proudového limitu vstupu

- **Aktivní proudový limit vstupu** — čte a zapisuje aktivní proudový limit vstupu (H:22) v ampérech. Akce služby „Nastavit limit" přijímá hodnotu float (0–100 A).

### Ochranné spínače

- **Napájení DC přepětí do sítě** — přepínač (H:65) pro řízení, zda se přebytečný výkon z DC připojené fotovoltaiky (který zvyšuje DC napětí) dodává do sítě. Atributy služby zobrazují maximální výkon napájení přepětí na fázi (H:66–68) a stav ignorování AC vstupu (H:69–70). Akce služby umožňuje nastavit maximální výkon napájení na fázi.
- **FV střídač** — přepínač (H:56) pro povolení nebo zakázání frekvenčního posunování FV střídače na AC výstupu. Při povolení (spínač VYPNUTÝ) FV střídač na AC výstupu pracuje normálně; při zakázání (spínač ZAPNUTÝ) frekvenční posunování omezuje výstup FV.

### Atributy a akce služby na úrovni modulu

Samotný modul zpřístupňuje několik atributů služby dostupných z brány v TapHome:

| Atribut | Registr | Popis |
|---------|---------|-------|
| Počet fází | H:28 | Počet AC fází v systému VE.Bus |
| Poloha spínače | H:33 | Režim střídače — Jen nabíječka, Jen střídač, Zapnutý, Vypnutý |
| Aktivní vstup | H:29 | Aktivní zdroj AC vstupu — AC vstup 1, AC vstup 2, Odpojen |
| ESS zakázat nabíjení | H:38 | Příznak nabíjení — Nabíjení povoleno / Nabíjení zakázáno |
| ESS zakázat napájení | H:39 | Příznak napájení — Napájení povoleno / Napájení zakázáno |
| ESS výkonový setpoint L1–L3 | H:37, H:40, H:41 | ESS výkonový setpoint na fázi ve wattech |

Akce služby na úrovni modulu umožňují přepínání režimu střídače (Jen nabíječka, Jen střídač, Zapnutý, Vypnutý), přepínání příznaku nabíjení ESS a přepínání příznaku napájení ESS.

### Systémové monitorování alarmů

Readscript modulu monitoruje 7 systémových alarmů:

| Registr | Alarm | Úrovně |
|---------|-------|--------|
| H:34 | Tepelný alarm | 0=Ok, 1=Varování, 2=Alarm |
| H:35 | Alarm nízké baterie | 0=Ok, 1=Varování, 2=Alarm |
| H:36 | Alarm přetížení | 0=Ok, 1=Varování, 2=Alarm |
| H:42 | Alarm teplotního senzoru | 0=Ok, 1=Varování, 2=Alarm |
| H:43 | Alarm napěťového senzoru | 0=Ok, 1=Varování, 2=Alarm |
| H:63 | Varování rotace fází | 0=Ok, 1=Varování |
| H:64 | Alarm ztráty sítě | 0=Ok, 1=Alarm |

### Další možnosti

Sada registrů VE.Bus (H:3–H:231) poskytuje další registry nad rámec aktuální implementace šablony. Patří sem čítače energie pro toky AC vstupu/výstupu/baterie (H:74–92, volatilní — reset při restartu), enumerace stavu nabíjení (H:95), 32-bitové ESS výkonové setpointy pro větší systémy (H:96–100), pokročilá nastavení ESS jako Preferování obnovitelné energie (H:102), konfigurace PowerAssist (H:106–108), ovládání funkce UPS (H:109) a registry mikrosite/droop módu (H:200–231). Tyto mohou být přidány do šablony TapHome v budoucí aktualizaci.

## Řešení problémů

### Žádná Modbus komunikace

1. Ověřte, že Modbus TCP je na GX zařízení povolen (Nastavení → Služby → Modbus-TCP)
2. Potvrďte IP adresu GX zařízení — zkontrolujte tabulku DHCP pronájmů routeru nebo síťová nastavení GX zařízení
3. Ujistěte se, že TapHome Core a GX zařízení jsou ve stejné podsíti
4. Zkontrolujte, že žádný firewall neblokuje TCP port 502
5. Ověřte správné unit ID — výchozí 227 platí pro Cerbo GX; jiné modely GX používají různá ID

### Nesprávné hodnoty výkonu

Šablona používá faktor `/100` pro registry výkonu (H:12–14, H:23–25), zatímco dokumentace Victron uvádí faktor 0,1 (což znamená surová hodnota × 10 = skutečné watty). To může vést k hodnotám výkonu nižším, než se očekává. Pokud se hodnoty výkonu jeví jako nesprávné, jde o známý rozdíl faktoru šablony — relativní měření zůstávají proporcionálně správná.

### Chybové kódy VE.Bus

Readscript zařízení Baterie kontroluje registr H:32 pro chybové kódy VE.Bus. Běžné chyby:

| Kód | Popis |
|-----|-------|
| 1 | Zařízení vypnuto, protože jiná fáze se vypnula |
| 5 | Přepětí na AC výstupu |
| 10 | Problém se synchronizací systémového času |
| 14 | Zařízení nemůže přenášet data |
| 16 | Chybí dongle |
| 17 | Zařízení převzalo status masteru, protože původní master selhal |
| 25 | Nekompatibilita firmwaru mezi připojenými zařízeními |
| 26 | Interní chyba |

Pokud se vyskytují trvalé chyby VE.Bus, akce VE.Bus Reset (dostupná na zařízení Baterie) může být použita k pokusu o obnovu.

### Unit ID se změnilo po aktualizaci Venus OS

Od Venus OS 2.60 jsou unit ID dynamicky přidělována. Po aktualizaci firmwaru se unit ID může změnit. Přejděte na Nastavení → Služby → Modbus/TCP → Dostupné služby na GX zařízení pro ověření aktuálního VE.Bus unit ID, poté aktualizujte slave ID v šabloně TapHome.

## Dostupná zařízení 10

Tato zařízení se po importu zobrazí v TapHome.

Victron GX Line Inverter Modul

Servisní atributy

|                                    |                                                                        |
|------------------------------------|------------------------------------------------------------------------|
| Počet fází                         |                                                                        |
| Poloha spínače                     | Provozní režim střídače — Jen nabíječka, Jen střídač, Zapnutý, Vypnutý |
| Aktivní vstup                      | Aktivní zdroj AC vstupu — AC vstup 1, AC vstup 2, Odpojen              |
| ESS příznak zakázání nabíjení fáze | Oprávnění nabíjení ESS — Nabíjení povoleno nebo Nabíjení zakázáno      |
| ESS zakázat napájení               | Oprávnění napájení ESS — Napájení povoleno nebo Napájení zakázáno      |
| ESS výkonový setpoint fáze 1       |                                                                        |
| ESS výkonový setpoint fáze 2       |                                                                        |
| ESS výkonový setpoint fáze 3       |                                                                        |

Servisní akce

|                       |                                                                        |
|-----------------------|------------------------------------------------------------------------|
| Poloha spínače        | Nastavit režim střídače — Jen nabíječka, Jen střídač, Zapnutý, Vypnutý |
| Příznak nabíjení fáze | Povolit nebo zakázat nabíjení baterie ESS                              |
| ESS příznak napájení  | Povolit nebo zakázat napájení sítě ESS                                 |

Čtení (modul)

```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"));
```

Servisní atributy

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";
```

Servisní akce

Switch Position

Parametry: Switch Position

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

Charge flag phase

Parametry: Charge flag phase

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

Feedback flag phase

Parametry: Feedback flag phase

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

Aktivní proudový limit vstupu Proměnná Čtení i zápis

Proudový limit AC vstupu v ampérech — nastavitelný akcí Nastavit limit (0–100 A)

Registr: H:22 Int16 Jednotka: A numeric

Servisní akce

|                |
|----------------|
| Nastavit limit |

Čtení

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

Servisní akce

Set Limit

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

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

Baterie Stmívač Čtení i zápis

Stav nabití baterie s napětím, proudem, teplotou, stavem nabíjení VE.Bus a oprávněními BMS

Registr: H:30 UInt16 Jednotka: % numeric

Servisní atributy

|                                      |                                                                                                                                              |
|--------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
| Napětí baterie                       |                                                                                                                                              |
| Proud baterie                        |                                                                                                                                              |
| Směr toku                            | Směr proudu — DC systém do Multi, Multi do DC systému, nebo nečinný                                                                          |
| Teplota baterie                      |                                                                                                                                              |
| Stav                                 | Stav nabíjení VE.Bus — Vypnutý, Nízký výkon, Porucha, Bulk, Absorpce, Float, Uložení, Ekvalizace, Passthru, Invertor, Power Assist, Napájení |
| VE.Bus BMS umožňuje nabíjení baterie |                                                                                                                                              |
| VE.Bus BMS umožňuje vybíjení baterie |                                                                                                                                              |
| VE.Bus BMS je očekáváno              |                                                                                                                                              |

Servisní akce

|              |
|--------------|
| VE.Bus Reset |

Čtení (modul)

```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"));
```

Čtení úrovně

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

Servisní atributy

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");
```

Servisní akce

VE.Bus Reset

Parametry: Reset

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

Napájení DC přepětí do sítě Přepínač Čtení i zápis

Přepínání napájení DC přepětí do sítě s maximálními výkonovými limity na fázi

Registr: H:65 UInt16 numeric

Hodnoty / Stavy: Feed in overvoltage · Don't feed in overvoltage

Servisní akce

|                                  |                                                                   |
|----------------------------------|-------------------------------------------------------------------|
| Maximální výkon napájení přepětí | Nastavit maximální výkon napájení DC přepětí na fázi (L1, L2, L3) |

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Servisní atributy

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");
```

Servisní akce

Maximum overvoltage feed-in power

Parametry: 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;
```

Příkon vstupu L1 Elektroměr Čtení i zápis

Příkon AC vstupu fáze 1 s napětím, proudem, frekvencí a ESS výkonovým setpointem

Registr: H:12 Int16 Jednotka: W numeric

Servisní atributy

|                              |
|------------------------------|
| Napětí vstupu L1             |
| Proud vstupu L1              |
| Frekvence vstupu 1           |
| ESS výkonový setpoint fáze 1 |

Servisní akce

|                              |
|------------------------------|
| ESS výkonový setpoint fáze 1 |

Čtení odběru

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

Servisní atributy

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";
```

Servisní akce

ESS power setpoint phase 1

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

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

Příkon vstupu L2 Elektroměr Čtení i zápis

Příkon AC vstupu fáze 2 s napětím, proudem, frekvencí a ESS výkonovým setpointem

Registr: H:13 Int16 Jednotka: W numeric

Servisní atributy

|                              |
|------------------------------|
| Napětí vstupu L2             |
| Proud vstupu L2              |
| Frekvence vstupu 2           |
| ESS výkonový setpoint fáze 2 |

Servisní akce

|                              |
|------------------------------|
| ESS výkonový setpoint fáze 2 |

Čtení odběru

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

Servisní atributy

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";
```

Servisní akce

ESS power setpoint phase 2

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

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

Příkon vstupu L3 Elektroměr Čtení i zápis

Příkon AC vstupu fáze 3 s napětím, proudem, frekvencí a ESS výkonovým setpointem

Registr: H:14 Int16 Jednotka: W numeric

Servisní atributy

|                              |
|------------------------------|
| Napětí vstupu L3             |
| Proud vstupu L3              |
| Frekvence vstupu 3           |
| ESS výkonový setpoint fáze 3 |

Servisní akce

|                              |
|------------------------------|
| ESS výkonový setpoint fáze 3 |

Čtení odběru

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

Servisní atributy

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";
```

Servisní akce

ESS power setpoint phase 3

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

```taphome
MODBUSW(H, 41, Int16, L3)
```

Výkon výstupu L1 Elektroměr Pouze ke čtení

AC výstup fáze 1 s napětím, proudem, frekvencí a monitorováním alarmů na fázi

Registr: H:18 Int16 Jednotka: W numeric

Servisní atributy

|                   |
|-------------------|
| Napětí výstupu L1 |
| Proud výstupu L1  |
| Frekvence výstupu |

Čtení odběru

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

Čtení (modul)

```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"),"");
```

Servisní atributy

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";
```

Výkon výstupu L2 Elektroměr Pouze ke čtení

AC výstup fáze 2 s napětím, proudem, frekvencí a monitorováním alarmů na fázi

Registr: H:24 Int16 Jednotka: W numeric

Servisní atributy

|                   |
|-------------------|
| Napětí výstupu L2 |
| Proud výstupu L2  |
| Frekvence výstupu |

Čtení odběru

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

Čtení (modul)

```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"),"");
```

Servisní atributy

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";
```

Výkon výstupu L3 Elektroměr Pouze ke čtení

AC výstup fáze 3 s napětím, proudem, frekvencí a monitorováním alarmů na fázi

Registr: H:25 Int16 Jednotka: W numeric

Servisní atributy

|                   |
|-------------------|
| Napětí výstupu L3 |
| Proud výstupu L3  |
| Frekvence výstupu |

Čtení odběru

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

Čtení (modul)

```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"),"");
```

Servisní atributy

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";
```

FV střídač Přepínač Čtení i zápis

Řízení frekvenčního posunování FV střídače — povolení nebo zakázání výstupu FV na AC výstupu

Registr: H:56 UInt16 numeric

Hodnoty / Stavy: PV disabled · PV enabled

Čtení stavu přepínače

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

Zápis stavu přepínače

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

**Připojení:** Modbus TCP • Slave ID: $\[SlaveId]

Možná vylepšení (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

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| Slave ID          | `227`         |
| IP adresa         | `192.168.1.0` |

## Zdroje

- 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

## Související dokumentace

- [Modbus Integration](https://taphome.com/cs/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/cs/docs/integration/modbus/)
- [Jednoduché nastavení pomocí šablon](https://taphome.com/cs/docs/integration/modbus/templates/)
- [Skripty Modbus a prefetch](https://taphome.com/cs/docs/script/modbus-scripts/)
- [Funkce Modbus](https://taphome.com/cs/docs/script/modbus/)
- [Datové typy Modbus](https://taphome.com/cs/docs/script/modbus-data-types/)