Victron Energy GX AC load meter Modbus register map
Energy meters configured as AC load meter, read through a GX device
- Official
- 22 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
- 22 holding registers
- Revision
- 1 · 2026-10-14
- Firmware
- Venus OS; register list 3.81
- Added
- ()
- File
- maps/victron-energy/gx-acload.mbmap.json · 4 KB · history
- SHA-256
- 910f7aa0a95bd6b0bb4e05d82103f71a1e91f2bf414c657615da2dd3a2e04250
- 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 number | holding 3903 | string[7] |
Sources and notes
- CCGX Modbus TCP register list · version 3.81 Field list, service com.victronenergy.acload
Source: Victron Energy, CCGX Modbus TCP register list 3.81
- Registers of the com.victronenergy.acload 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 | 3900 | uint16 | R | W | D-Bus /Ac/L1/Power | ||
| HR | 3901 | uint16 | R | W | D-Bus /Ac/L2/Power | ||
| HR | 3902 | uint16 | R | W | D-Bus /Ac/L3/Power | ||
| HR | 3903 | string[7] | R | D-Bus /Serial | |||
| HR | 3910 | uint16 | R | V | ×0.1 | D-Bus /Ac/L1/Voltage | |
| HR | 3911 | int16 | R | A | ×0.1 | D-Bus /Ac/L1/Current | |
| HR | 3912 | uint16 | R | V | ×0.1 | D-Bus /Ac/L2/Voltage | |
| HR | 3913 | int16 | R | A | ×0.1 | D-Bus /Ac/L2/Current | |
| HR | 3914 | uint16 | R | V | ×0.1 | D-Bus /Ac/L3/Voltage | |
| HR | 3915 | int16 | R | A | ×0.1 | D-Bus /Ac/L3/Current | |
| HR | 3916 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L1/Energy/Forward | |
| HR | 3918 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L2/Energy/Forward | |
| HR | 3920 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L3/Energy/Forward | |
| HR | 3922 | uint16 | R | Hz | ×0.01 | D-Bus /Ac/Frequency | |
| HR | 3924 | int32 ABCD | R | W | D-Bus /Ac/L1/Power | ||
| HR | 3926 | int32 ABCD | R | W | D-Bus /Ac/L2/Power | ||
| HR | 3928 | int32 ABCD | R | W | D-Bus /Ac/L3/Power | ||
| HR | 3930 | int16 | R | ×0.001 | D-Bus /Ac/L1/PowerFactor | ||
| HR | 3931 | int16 | R | ×0.001 | D-Bus /Ac/L2/PowerFactor | ||
| HR | 3932 | int16 | R | ×0.001 | D-Bus /Ac/L3/PowerFactor | ||
| HR | 3933 | int16 | R | ×0.001 | D-Bus /Ac/PowerFactor | ||
| HR | 3940 | 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).