Victron Energy GX EV charger Modbus register map
EV charging stations (EVCS), read through a GX device
- Official
- 23 registers
- Modbus TCP
- Revision 1 · 2026-10-14
- Identity: serial number
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
- 1default
- 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
- 23 holding registers
- Revision
- 1 · 2026-10-14
- Firmware
- Venus OS; register list 3.81
- Added
- ()
- File
- maps/victron-energy/gx-evcharger.mbmap.json · 5 KB · history
- SHA-256
- faa8dfa8eb3d90196651b85448363a724d4686ee3196a4ea719d37301f33980b
- Manufacturer
- victronenergy.com
Device identity
What a tool can read to check that this map fits the connected device (SPEC.md section 4.7). Registers with a role are read like any other register.
| Role | Register | Address | Type | Values |
|---|---|---|---|---|
| Serial number | Serial | holding 3804 | string[6] |
Sources and notes
- CCGX Modbus TCP register list · version 3.81 Field list, service com.victronenergy.evcharger
Source: Victron Energy, CCGX Modbus TCP register list 3.81
- Registers of the com.victronenergy.evcharger service of the GX Modbus TCP server (Settings > Integrations > Modbus TCP server).
- Each device on the GX has its own unit ID. Since Venus OS 2.60 they are assigned dynamically: see the list of available services on the GX device.
- All registers are holding registers (FC03; FC06/FC16 for the writable ones).
| Area | Address | Name | Type | Access | Unit | Scale | Description |
|---|---|---|---|---|---|---|---|
| HR | 3800 | uint16 | R | D-Bus /ProductId | |||
| HR | 3802 | uint32 ABCD | R | D-Bus /FirmwareVersion | |||
| HR | 3804 | string[6] | R | D-Bus /Serial | |||
| HR | 3810 | string[4] | R | D-Bus /Model | |||
| HR | 3814 | uint16 | RW | A | D-Bus /MaxCurrent | ||
| HR | 3815 | uint16 | RW | D-Bus /Mode | |||
| HR | 3816 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Session/Energy | |
| HR | 3818 | uint16 | R | W | D-Bus /Ac/L1/Power | ||
| HR | 3819 | uint16 | R | W | D-Bus /Ac/L2/Power | ||
| HR | 3820 | uint16 | R | W | D-Bus /Ac/L3/Power | ||
| HR | 3821 | uint16 | R | W | D-Bus /Ac/Power | ||
| HR | 3822 | uint16 | R | s | ×100 | D-Bus /ChargingTime | |
| HR | 3823 | uint16 | R | A | D-Bus /Current | ||
| HR | 3824 | uint16 | R | D-Bus /Status | |||
| HR | 3825 | uint16 | RW | A | D-Bus /SetCurrent | ||
| HR | 3826 | uint16 | RW | D-Bus /StartStop | |||
| HR | 3827 | uint16 | RW | D-Bus /Position | |||
| HR | 3828 | uint32 ABCD | R | s | D-Bus /Session/Time | ||
| HR | 3830 | uint32 ABCD | R | W | ×0.01 | D-Bus /Session/Energy | |
| HR | 3832 | int32 ABCD | R | ×0.01 | D-Bus /Session/Cost | ||
| HR | 3834 | int32 ABCD | R | ×0.01 | D-Bus /Session/SavedCost | ||
| HR | 3836 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/Energy/Forward | |
| HR | 3840 | string[8] | RW | D-Bus /CustomName |
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).