Victron Energy GX inverter Modbus register map
Phoenix inverters, read through a GX device
- Official
- 56 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
- 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
- 56 holding registers
- Revision
- 2 · 2026-10-14
- Firmware
- Venus OS; register list 3.81
- Added
- ()
- File
- maps/victron-energy/gx-inverter.mbmap.json · 11 KB · history
- SHA-256
- 743a91f52586f40847a4652160613b61a3d6a82482596d9f1ce8fec86bf61b80
- Manufacturer
- victronenergy.com
Sources and notes
- CCGX Modbus TCP register list · version 3.81 Field list, service com.victronenergy.inverter
Source: Victron Energy, CCGX Modbus TCP register list 3.81
- Registers of the com.victronenergy.inverter 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 | 3100 | int16 | R | A | ×0.1 | D-Bus /Ac/Out/L1/I | |
| HR | 3101 | uint16 | R | V | ×0.1 | D-Bus /Ac/Out/L1/V | |
| HR | 3102 | int16 | R | W | ×10 | D-Bus /Ac/Out/L1/P | |
| HR | 3105 | uint16 | R | V | ×0.01 | D-Bus /Dc/0/Voltage | |
| HR | 3106 | int16 | R | A | ×0.1 | D-Bus /Dc/0/Current | |
| HR | 3110 | uint16 | R | D-Bus /Alarms/HighTemperature | |||
| HR | 3111 | uint16 | R | D-Bus /Alarms/HighVoltage | |||
| HR | 3112 | uint16 | R | D-Bus /Alarms/HighVoltageAcOut | |||
| HR | 3113 | uint16 | R | D-Bus /Alarms/LowTemperature | |||
| HR | 3114 | uint16 | R | D-Bus /Alarms/LowVoltage | |||
| HR | 3115 | uint16 | R | D-Bus /Alarms/LowVoltageAcOut | |||
| HR | 3116 | uint16 | R | D-Bus /Alarms/Overload | |||
| HR | 3117 | uint16 | R | D-Bus /Alarms/Ripple | |||
| HR | 3125 | uint16 | R | D-Bus /FirmwareVersion | |||
| HR | 3126 | uint16 | RW | D-Bus /Mode | |||
| HR | 3127 | uint16 | R | D-Bus /ProductId | |||
| HR | 3128 | uint16 | R | D-Bus /State | |||
| HR | 3130 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Energy/InverterToAcOut | |
| HR | 3132 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Energy/OutToInverter | |
| HR | 3134 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Energy/SolarToAcOut | |
| HR | 3136 | uint32 ABCD | R | kWh | ×0.01 | D-Bus /Energy/SolarToBattery | |
| HR | 3138 | uint16 | R | V | ×0.1 | D-Bus /Pv/V | |
| HR | 3140 | uint16 | R | V | ×0.1 | D-Bus /Pv/0/V | |
| HR | 3141 | uint16 | R | V | ×0.1 | D-Bus /Pv/1/V | |
| HR | 3142 | uint16 | R | V | ×0.1 | D-Bus /Pv/2/V | |
| HR | 3143 | uint16 | R | V | ×0.1 | D-Bus /Pv/3/V | |
| HR | 3148 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/0/Pv/0/Yield | |
| HR | 3149 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/0/Pv/1/Yield | |
| HR | 3150 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/0/Pv/2/Yield | |
| HR | 3151 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/0/Pv/3/Yield | |
| HR | 3152 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/1/Pv/0/Yield | |
| HR | 3153 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/1/Pv/1/Yield | |
| HR | 3154 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/1/Pv/2/Yield | |
| HR | 3155 | uint16 | R | kWh | ×0.1 | D-Bus /History/Daily/1/Pv/3/Yield | |
| HR | 3156 | uint16 | R | W | D-Bus /History/Daily/0/Pv/0/MaxPower | ||
| HR | 3157 | uint16 | R | W | D-Bus /History/Daily/0/Pv/1/MaxPower | ||
| HR | 3158 | uint16 | R | W | D-Bus /History/Daily/0/Pv/2/MaxPower | ||
| HR | 3159 | uint16 | R | W | D-Bus /History/Daily/0/Pv/3/MaxPower | ||
| HR | 3160 | uint16 | R | W | D-Bus /History/Daily/1/Pv/0/MaxPower | ||
| HR | 3161 | uint16 | R | W | D-Bus /History/Daily/1/Pv/1/MaxPower | ||
| HR | 3162 | uint16 | R | W | D-Bus /History/Daily/1/Pv/2/MaxPower | ||
| HR | 3163 | uint16 | R | W | D-Bus /History/Daily/1/Pv/3/MaxPower | ||
| HR | 3164 | uint16 | R | W | D-Bus /Pv/0/P | ||
| HR | 3165 | uint16 | R | W | D-Bus /Pv/1/P | ||
| HR | 3166 | uint16 | R | W | D-Bus /Pv/2/P | ||
| HR | 3167 | uint16 | R | W | D-Bus /Pv/3/P | ||
| HR | 3168 | uint16 | R | D-Bus /Alarms/LowSoc | |||
| HR | 3169 | uint16 | R | D-Bus /Pv/0/MppOperationMode | |||
| HR | 3170 | uint16 | R | D-Bus /Pv/1/MppOperationMode | |||
| HR | 3171 | uint16 | R | D-Bus /Pv/2/MppOperationMode | |||
| HR | 3172 | uint16 | R | D-Bus /Pv/3/MppOperationMode | |||
| HR | 3173 | uint16 | R | D-Bus /Pv/0/Enabled; Only available on Inverter RS | |||
| HR | 3174 | uint16 | R | D-Bus /Pv/1/Enabled | |||
| HR | 3175 | uint16 | R | D-Bus /Pv/2/Enabled | |||
| HR | 3176 | uint16 | R | D-Bus /Pv/3/Enabled | |||
| HR | 3180 | 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).