Victron Energy GX PV inverter Modbus register map
AC-coupled PV inverters (Fronius, SMA, ...), read through a GX device
- Official
- 25 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
- 25 holding registers
- Revision
- 1 · 2026-10-14
- Firmware
- Venus OS; register list 3.81
- Added
- ()
- File
- maps/victron-energy/gx-pvinverter.mbmap.json · 5 KB · history
- SHA-256
- 1b80392d977131def1b0ead72914febbecf5f2fda019ebca24dab3fcbc87480e
- 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 1039 | string[7] |
Sources and notes
- CCGX Modbus TCP register list · version 3.81 Field list, service com.victronenergy.pvinverter
Source: Victron Energy, CCGX Modbus TCP register list 3.81
- Registers of the com.victronenergy.pvinverter 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 | 1026 | uint16 | R | D-Bus /Position | |||
| HR | 1027 | uint16 | R | V | ×0.1 | D-Bus /Ac/L1/Voltage | |
| HR | 1028 | int16 | R | A | ×0.1 | D-Bus /Ac/L1/Current | |
| HR | 1029 | uint16 | R | W | D-Bus /Ac/L1/Power | ||
| HR | 1030 | uint16 | R | kWh | ×0.01 | D-Bus /Ac/L1/Energy/Forward; Deprecated. Use 1046 instead | |
| HR | 1031 | uint16 | R | V | ×0.1 | D-Bus /Ac/L2/Voltage | |
| HR | 1032 | int16 | R | A | ×0.1 | D-Bus /Ac/L2/Current | |
| HR | 1033 | uint16 | R | W | D-Bus /Ac/L2/Power | ||
| HR | 1034 | uint16 | R | kWh | ×0.01 | D-Bus /Ac/L2/Energy/Forward; Deprecated. Use 1048 instead | |
| HR | 1035 | uint16 | R | V | ×0.1 | D-Bus /Ac/L3/Voltage | |
| HR | 1036 | int16 | R | A | ×0.1 | D-Bus /Ac/L3/Current | |
| HR | 1037 | uint16 | R | W | D-Bus /Ac/L3/Power | ||
| HR | 1038 | uint16 | R | kWh | ×0.01 | D-Bus /Ac/L3/Energy/Forward; Deprecated. Use 1050 instead | |
| HR | 1039 | string[7] | R | D-Bus /Serial; The system serial as string (MSB of first register: first character, LSB of last register: last character) | |||
| HR | 1046 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L1/Energy/Forward | |
| HR | 1048 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L2/Energy/Forward | |
| HR | 1050 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Ac/L3/Energy/Forward | |
| HR | 1052 | int32 ABCD | R | W | D-Bus /Ac/Power | ||
| HR | 1054 | uint32 ABCD | R | W | D-Bus /Ac/MaxPower | ||
| HR | 1056 | uint32 ABCD | RW | W | D-Bus /Ac/PowerLimit; For use in ESS mode 3 | ||
| HR | 1058 | uint32 ABCD | R | W | D-Bus /Ac/L1/Power | ||
| HR | 1060 | uint32 ABCD | R | W | D-Bus /Ac/L2/Power | ||
| HR | 1062 | uint32 ABCD | R | W | D-Bus /Ac/L3/Power | ||
| HR | 1064 | uint16 | R | Hz | ×0.01 | D-Bus /Ac/Frequency | |
| HR | 1070 | 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).