Victron Energy GX settings Modbus register map
ESS, DVCC, generator start/stop and Dynamic ESS settings of a Victron GX device
- Official
- 37 registers
- Modbus TCP
- Revision 2 · 2026-10-14
Official: Written from the manufacturer's documentation, but not tested on a device yet. Check the map against the manufacturer's documentation before you write to a live device. Tested it? Report a test.
Communication
- Protocol
- Modbus TCP
- Unit ID
- 100
- TCP port
- 502
- Byte / word order
- ABCD · bytes big-endian, words high first
- Addresses
- 0-based
Connection values are defaults: the device may be configured differently.
Map
- Registers
- 37 holding registers
- Revision
- 2 · 2026-10-14
- Firmware
- Venus OS; register list 3.81
- Added
- ()
- File
- maps/victron-energy/gx-settings.mbmap.json · 10 KB · history
- SHA-256
- ac7a3d9a0c3a430eb706e6179c2603ee4fa46239b280293d98744e3f6b5e23e1
- Manufacturer
- victronenergy.com
Sources and notes
- CCGX Modbus TCP register list · version 3.81 Field list, service com.victronenergy.settings
Source: Victron Energy, CCGX Modbus TCP register list 3.81
- Registers of the com.victronenergy.settings service of the GX Modbus TCP server (Settings > Integrations > Modbus TCP server).
- The unit ID of this service is 100.
- All registers are holding registers (FC03; FC06/FC16 for the writable ones).
| Area | Address | Name | Type | Access | Unit | Scale | Description |
|---|---|---|---|---|---|---|---|
| HR | 2700 | int16 | RW | W | D-Bus /Settings/Cgwacs/AcPowerSetPoint | ||
| HR | 2701 | uint16 | RW | % | D-Bus /Settings/Cgwacs/MaxChargePercentage; ESS Mode 2 - Max charge current for ESS control-loop. The control-loop will use this value to limit the multi power setpoint. For DVCC, use 2705 instead | ||
| HR | 2702 | uint16 | RW | % | D-Bus /Settings/Cgwacs/MaxDischargePercentage | ||
| HR | 2703 | int16 | RW | W | ×100 | D-Bus /Settings/Cgwacs/AcPowerSetPoint; ESS Mode 2 – Same as 2700, but with a different scale factor. Meant for values larger than +-32kW | |
| HR | 2704 | int16 | RW | W | ×10 | D-Bus /Settings/Cgwacs/MaxDischargePower; ESS Mode 2 – similar to 2702, but as an absolute value instead of a percentage | |
| HR | 2705 | int16 | RW | A | D-Bus /Settings/SystemSetup/MaxChargeCurrent; ESS Mode 2 with DVCC – Maximum system charge current. -1 Disables | ||
| HR | 2706 | int16 | RW | W | ×100 | D-Bus /Settings/Cgwacs/MaxFeedInPower; -1: No limit, >=0: limited system feed-in. Applies to DC-coupled and AC-coupled feed-in | |
| HR | 2707 | int16 | RW | D-Bus /Settings/Cgwacs/OvervoltageFeedIn; Also known as Overvoltage Feed-in | |||
| HR | 2708 | int16 | RW | D-Bus /Settings/Cgwacs/PreventFeedback; Formerly called Fronius Zero-Feedin | |||
| HR | 2710 | uint16 | RW | V | ×0.1 | D-Bus /Settings/SystemSetup/MaxChargeVoltage; Only used if there is a managed battery in the system | |
| HR | 2711 | uint16 | RW | D-Bus /Settings/SystemSetup/AcInput1; For Multi-RS, this is configured on the Inverter/Charger with VictronConnect | |||
| HR | 2712 | uint16 | RW | D-Bus /Settings/SystemSetup/AcInput2 | |||
| HR | 2713 | int16 | RW | D-Bus /Settings/CGwacs/AcExportLimit; -1: Disabled | |||
| HR | 2714 | int16 | RW | D-Bus /Settings/Cgwacs/AcInputLimit; -1: Disabled | |||
| HR | 2715 | uint16 | RW | D-Bus /Settings/CGwacs/AlwaysPeakShave | |||
| HR | 2718 | uint16 | RW | D-Bus /Settings/CGwacs/RunWithoutGridMeter | |||
| HR | 2720 | int32 ABCD | RW | W | D-Bus /Settings/Cgwacs/MaxDischargePower; This is a 32-bit version of 2704 | ||
| HR | 2722 | int32 ABCD | RW | W | D-Bus /Settings/Cgwacs/MaxFeedInPower; This is a 32-bit version of 2706 | ||
| HR | 2900 | uint16 | RW | D-Bus /Settings/CGwacs/BatteryLife/State; Use value 0 (disable) and 1(enable) for writing only | |||
| HR | 2901 | uint16 | RW | % | ×0.1 | D-Bus /Settings/CGwacs/BatteryLife/MinimumSocLimit; Same as the setting in the GUI | |
| HR | 2902 | uint16 | RW | D-Bus /Settings/Cgwacs/Hub4Mode | |||
| HR | 2903 | uint16 | R | % | ×0.1 | D-Bus /Settings/Cgwacs/BatteryLife/SocLimit | |
| HR | 4701 | uint16 | RW | D-Bus /Settings/Pump0/AutoStartEnabled | |||
| HR | 4702 | uint16 | RW | D-Bus /Settings/Pump0/Mode | |||
| HR | 4703 | uint16 | RW | % | D-Bus /Settings/Pump0/StartValue | ||
| HR | 4704 | uint16 | RW | % | D-Bus /Settings/Pump0/StopValue | ||
| HR | 5420 | uint16 | RW | kWh | ×0.1 | D-Bus /Settings/DynamicEss/BatteryCapacity | |
| HR | 5421 | uint16 | RW | h | D-Bus /Settings/DynamicEss/FullChargeDuration | ||
| HR | 5422 | uint16 | RW | d | D-Bus /Settings/DynamicEss/FullChargeInterval | ||
| HR | 5423 | uint16 | RW | D-Bus /Settings/DynamicEss/Mode | |||
| HR | 5424 | uint16 | RW | D-Bus /Settings/DynamicEss/Schedule/0/AllowGridFeedIn | |||
| HR | 5425 | uint16 | RW | s | D-Bus /Settings/DynamicEss/Schedule/0/Duration | ||
| HR | 5426 | uint16 | RW | D-Bus /Settings/DynamicEss/Schedule/0/Restrictions | |||
| HR | 5427 | uint16 | RW | % | D-Bus /Settings/DynamicEss/Schedule/0/Soc | ||
| HR | 5428 | int32 ABCD | RW | D-Bus /Settings/DynamicEss/Schedule/0/Start | |||
| HR | 5430 | uint16 | RW | D-Bus /Settings/DynamicEss/Schedule/0/Strategy | |||
| HR | 5700 | string[8] | RW | D-Bus /Settings/SystemSetup/SystemName |
No registers match
Try part of the name, an address (decimal or 0x hex) or clear the filters.
Help improve this map
- I tested it on a deviceReport whether it worked, even if you did not write the map.
- Suggest a correctionEdit the file on GitHub; it opens a pull request.
- Report a problemA wrong address, type, scale or byte order.
- Read the formatWhat each key of the file means (SPEC.md).