Victron Energy · Inverter/charger
MultiPlus / MultiPlus-II / Quattro / Quattro-II inverter/chargers (VE.Bus service on a GX device) Modbus register map
Default configuration
- Protocol
- Modbus TCP
- Port
- 502
- Unit ID
- 227
- Addressing
- 0-based
- Byte order
- Big endian
- Word order
- High word first
Register map
| Address | Count | Name | Type | Unit | Scale | Access |
|---|---|---|---|---|---|---|
| 3 | 1 | Input voltage phase 1 | UInt16 | V AC | 0.1 | R |
| 4 | 1 | Input voltage phase 2 | UInt16 | V AC | 0.1 | R |
| 5 | 1 | Input voltage phase 3 | UInt16 | V AC | 0.1 | R |
| 6 | 1 | Input current phase 1 Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains. | Int16 | A AC | 0.1 | R |
| 7 | 1 | Input current phase 2 Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains. | Int16 | A AC | 0.1 | R |
| 8 | 1 | Input current phase 3 Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains. | Int16 | A AC | 0.1 | R |
| 9 | 1 | Input frequency 1 | Int16 | Hz | 0.01 | R |
| 10 | 1 | Input frequency 2 | Int16 | Hz | 0.01 | R |
| 11 | 1 | Input frequency 3 | Int16 | Hz | 0.01 | R |
| 12 | 1 | Input power 1 Sign meaning equal to Input current | Int16 | W | 10 | R |
| 13 | 1 | Input power 2 Sign meaning equal to Input current | Int16 | W | 10 | R |
| 14 | 1 | Input power 3 Sign meaning eaqual to Input current | Int16 | W | 10 | R |
| 15 | 1 | Output voltage phase 1 | UInt16 | V AC | 0.1 | R |
| 16 | 1 | Output voltage phase 2 | UInt16 | V AC | 0.1 | R |
| 17 | 1 | Output voltage phase 3 | UInt16 | V AC | 0.1 | R |
| 18 | 1 | Output current phase 1 Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi. | Int16 | A AC | 0.1 | R |
| 19 | 1 | Output current phase 2 Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi. | Int16 | A AC | 0.1 | R |
| 20 | 1 | Output current phase 3 Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi. | Int16 | A AC | 0.1 | R |
| 21 | 1 | Output frequency | Int16 | Hz | 0.01 | R |
| 22 | 1 | Active input current limit See Venus-OS manual for limitations, for example when VE.Bus BMS or DMC is installed. | Int16 | A | 0.1 | RW |
| 23 | 1 | Output power 1 Sign meaning equal to Output current | Int16 | W | 10 | R |
| 24 | 1 | Output power 2 Sign meaning equal to Output current | Int16 | W | 10 | R |
| 25 | 1 | Output power 3 Sign meaning equal to Output current | Int16 | W | 10 | R |
| 26 | 1 | Battery voltage | UInt16 | V DC | 0.01 | R |
| 27 | 1 | Battery current Positive: current flowing from the Multi to the dc system. Negative: the other way around. | Int16 | A DC | 0.1 | R |
| 28 | 1 | Phase count | UInt16 | - | 1 | R |
| 29 | 1 | Active input 0=AC Input 1;1=AC Input 2;240=Disconnected | UInt16 | - | 1 | R |
| 30 | 1 | VE.Bus state of charge | UInt16 | % | 0.1 | RW |
| 31 | 1 | VE.Bus state 0=Off;1=Low Power;2=Fault;3=Bulk;4=Absorption;5=Float;6=Storage;7=Equalize;8=Passthru;9=Inverting;10=Power assist;11=Power supply;244=Sustain;252=External control | UInt16 | - | 1 | R |
| 32 | 1 | VE.Bus Error 0=No error;1=VE.Bus Error 1: Device is switched off because one of the other phases in the system has switched off;2=VE.Bus Error 2: New and old types MK2 are mixed in the system;3=VE.Bus Error 3: Not all- or more than- the expected devices were found in the system;4=VE.Bus Error 4: No other device whatsoever detected;5=VE.Bus Error 5: Overvoltage on AC-out;6=VE.Bus Error 6: Error in DDC Program;7=VE.Bus BMS connected- which requires an Assistant- but no assistant found;10=VE.Bus Error 10: System time synchronisation problem occurred;14=VE.Bus Error 14: Device cannot transmit data;16=VE.Bus Er | UInt16 | - | 1 | R |
| 33 | 1 | Switch Position 1=Charger Only;2=Inverter Only;3=On;4=Off See Venus-OS manual for limitations, for example when VE.Bus BMS or DMC is installed. | UInt16 | - | 1 | RW |
| 34 | 1 | Temperature alarm 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 35 | 1 | Low battery alarm 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 36 | 1 | Overload alarm 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 37 | 1 | ESS power setpoint phase 1 ESS Mode 3 - Instructs the multi to charge/discharge with giving power. Negative = discharge. Used by the control loop in grid-parallel systems. | Int16 | W | 1 | RW |
| 38 | 1 | ESS disable charge flag phase 0=Charge allowed;1=Charge disabled ESS Mode 3 - Enables/Disables charge (0=enabled, 1=disabled). Note that power setpoint will yield to this setting | UInt16 | - | 1 | RW |
| 39 | 1 | ESS disable feedback flag phase 0=Feed in allowed;1=Feed in disabled ESS Mode 3 - Enables/Disables feedback (0=enabled, 1=disabled). Note that power setpoint will yield to this setting | UInt16 | - | 1 | RW |
| 40 | 1 | ESS power setpoint phase 2 ESS Mode 3 - Instructs the multi to charge/discharge with giving power. Negative = discharge. Used by the control loop in grid-parallel systems. | Int16 | W | 1 | RW |
| 41 | 1 | ESS power setpoint phase 3 ESS Mode 3 - Instructs the multi to charge/discharge with giving power. Negative = discharge. Used by the control loop in grid-parallel systems. | Int16 | W | 1 | RW |
| 42 | 1 | Temperatur sensor alarm 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 43 | 1 | Voltage sensor alarm 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 44 | 1 | Temperature alarm L1 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 45 | 1 | Low battery alarm L1 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 46 | 1 | Overload alarm L1 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 47 | 1 | Ripple alarm L1 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 48 | 1 | Temperature alarm L2 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 49 | 1 | Low battery alarm L2 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 50 | 1 | Overload alarm L2 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 51 | 1 | Ripple alarm L2 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 52 | 1 | Temperature alarm L3 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 53 | 1 | Low battery alarm L3 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 54 | 1 | Overload alarm L3 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 55 | 1 | Ripple alarm L3 0=Ok;1=Warning;2=Alarm | UInt16 | - | 1 | R |
| 56 | 1 | Disable PV inverter 0=PV enabled;1=PV disabled Disable PV inverter on AC out (using frequency shifting). Only works when vebus device is in inverter mode. Needs ESS or PV inverter assistant | UInt16 | - | 1 | RW |
| 57 | 1 | VE.Bus BMS allows battery to be charged 0=No;1=Yes VE.Bus BMS allows the battery to be charged | UInt16 | - | 1 | R |
| 58 | 1 | VE.Bus BMS allows battery to be discharged 0=No;1=Yes VE.Bus BMS allows the battery to be discharged | UInt16 | - | 1 | R |
| 59 | 1 | VE.Bus BMS is expected 0=No;1=Yes Presence of VE.Bus BMS is expected based on vebus settings (presence of ESS or BMS assistant) | UInt16 | - | 1 | R |
| 60 | 1 | VE.Bus BMS error 0=No;1=Yes | UInt16 | - | 1 | R |
| 61 | 1 | Battery temperature | Int16 | °C | 0.1 | R |
| 62 | 1 | VE.Bus Reset 1=VE.Bus reset Any write action will cause a reset | UInt16 | - | 1 | RW |
| 63 | 1 | Phase rotation warning 0=Ok;1=Warning | UInt16 | - | 1 | R |
| 64 | 1 | Grid lost alarm 0=Ok;2=Alarm | UInt16 | - | 1 | R |
| 65 | 1 | Feed DC overvoltage into grid 0=Feed in overvoltage;1=Do not feed in overvoltage | UInt16 | - | 1 | RW |
| 66 | 1 | Maximum overvoltage feed-in power L1 | UInt16 | W | 100 | RW |
| 67 | 1 | Maximum overvoltage feed-in power L2 | UInt16 | W | 100 | RW |
| 68 | 1 | Maximum overvoltage feed-in power L3 | UInt16 | W | 100 | RW |
| 69 | 1 | AC input 1 ignored 0=AC input not ignored;1=AC input ignored | UInt16 | - | 1 | R |
| 70 | 1 | AC input 2 ignored 0=AC input not ignored;1=AC input ignored | UInt16 | - | 1 | R |
| 71 | 1 | AcPowerSetpoint acts as feed-in limit 0=AcPowerSetpoint interpreted normally; 1=AcPowerSetpoint is OvervoltageFeedIn limit When set to 1, the Multi behaves as if DoNotFeedInOvervoltage is disabled and AcPowerSetpoint is the maximum allowed feed-in | UInt16 | - | 1 | RW |
| 72 | 1 | Solar offset voltage 0=OvervoltageFeedIn uses 1V offset; 1=OvervoltageFeedIn uses 0.1V offset When feeding overvoltage into the grid, the solar chargers are set to a higher voltage. This flag determines the size of the offset (per 12V increment). | UInt16 | - | 1 | RW |
| 73 | 1 | Sustain active 0=Sustain inactive; 1=Sustain active | UInt16 | - | 1 | R |
| 74 | 2 | Energy from AC-In 1 to AC-out PLEASE NOTE: | UInt32 | kWh | 0.01 | R |
| 76 | 2 | Energy from AC-In 1 to battery Energy counters from the Multi(s) are volatile. | UInt32 | kWh | 0.01 | R |
| 78 | 2 | Energy from AC-In 2 to AC-out These energy counters reset to zero when the Multi is switched off. | UInt32 | kWh | 0.01 | R |
| 80 | 2 | Energy from AC-In 2 to battery These energy counters ALSO reset to zero when the GX-device reboots. | UInt32 | kWh | 0.01 | R |
| 82 | 2 | Energy from AC-out to AC-in 1 (reverse fed PV) | UInt32 | kWh | 0.01 | R |
| 84 | 2 | Energy from AC-out to AC-in 2 (reverse fed PV) | UInt32 | kWh | 0.01 | R |
| 86 | 2 | Energy from battery to AC-in 1 | UInt32 | kWh | 0.01 | R |
| 88 | 2 | Energy from battery to AC-in 2 | UInt32 | kWh | 0.01 | R |
| 90 | 2 | Energy from battery to AC-out | UInt32 | kWh | 0.01 | R |
| 92 | 2 | Energy from AC-out to battery (typically from PV-inverter) | UInt32 | kWh | 0.01 | R |
| 94 | 1 | Low cell voltage imminent 0=OK;1=Warning | UInt16 | - | 1 | R |
| 95 | 1 | Charge state 0=Initialising;1=Bulk;2=Absorption;3=Float;4=Storage;5=Absorb repeat;6=Forced absorb;7=Equalise;8=Bulk stopped;9=Unknown | UInt16 | - | 1 | R |
| 96 | 2 | ESS power setpoint phase 1 32-bit compliment to 37, 40 and 41 | Int32 | W | 1 | RW |
| 98 | 2 | ESS power setpoint phase 2 | Int32 | W | 1 | RW |
| 100 | 2 | ESS power setpoint phase 3 | Int32 | W | 1 | RW |
| 102 | 1 | Prefer Renewable Energy 0=Renewable energy not preferred;1=Renewable energy preferred Must be enabled in VE.Configure. This causes the system to charge from the grid at a lower sustain voltage. See manual. | UInt16 | - | 1 | RW |
| 103 | 1 | Select Remote Generator 0=Generator not selected;1=Generator selected Informs Multi that a generator is active on AC-in | UInt16 | - | 1 | RW |
| 104 | 1 | Remote generator selected 0=Generator not selected;1=Generator selected | UInt16 | - | 1 | R |
| 105 | 1 | Redetect VE.Bus system 0=No action;1=Redetect system | UInt16 | - | 1 | RW |
| 106 | 1 | Power Assist boost factor These 4 settings were first introduced I Venus 3.30, but immediately redefined as they did not work properly. | UInt16 | - | 0.01 | RW |
| 107 | 1 | Configured output voltage | UInt16 | V AC | 0.01 | RW |
| 108 | 1 | PowerAssist enabled 0=Disabled;1=Enabled | UInt16 | - | 1 | RW |
| 109 | 1 | UPS function enabled 0=Enabled;1=Disabled | UInt16 | - | 1 | RW |
| 110 | 1 | Relay test OK, VE.Bus unit L1 master 0=No;1=Yes | UInt16 | - | 1 | R |
| 111 | 1 | Relay test OK, VE.Bus unit L2 master 0=No;1=Yes | UInt16 | - | 1 | R |
| 112 | 1 | Relay test OK, VE.Bus unit L3 master 0=No;1=Yes | UInt16 | - | 1 | R |
| 113 | 1 | Relay test OK, VE.Bus unit L1 parallel unit 1 0=No;1=Yes | UInt16 | - | 1 | R |
| 114 | 1 | Relay test OK, VE.Bus unit L2 parallel unit 1 0=No;1=Yes | UInt16 | - | 1 | R |
| 115 | 1 | Relay test OK, VE.Bus unit L3 parallel unit 1 0=No;1=Yes | UInt16 | - | 1 | R |
| 116 | 1 | Relay test OK, VE.Bus unit L1 parallel unit 2 0=No;1=Yes | UInt16 | - | 1 | R |
| 117 | 1 | Relay test OK, VE.Bus unit L2 parallel unit 2 0=No;1=Yes | UInt16 | - | 1 | R |
| 118 | 1 | Relay test OK, VE.Bus unit L3 parallel unit 2 0=No;1=Yes | UInt16 | - | 1 | R |
| 119 | 1 | Relay test OK, VE.Bus unit L1 parallel unit 3 0=No;1=Yes | UInt16 | - | 1 | R |
| 120 | 1 | Relay test OK, VE.Bus unit L2 parallel unit 3 0=No;1=Yes | UInt16 | - | 1 | R |
| 121 | 1 | Relay test OK, VE.Bus unit L3 parallel unit 3 0=No;1=Yes | UInt16 | - | 1 | R |
| 129 | 1 | Weak AC input setting 0=Strong AC input;1=Weak AC input | UInt16 | - | 1 | RW |
| 130 | 2 | Nominal inverter power – Total | UInt32 | W | 1 | R |
| 132 | 2 | Nominal inverter power – L1 | UInt32 | W | 1 | R |
| 134 | 2 | Nominal inverter power – L2 | UInt32 | W | 1 | R |
| 136 | 2 | Nominal inverter power – L3 | UInt32 | W | 1 | R |
| 140 | 8 | Custom Name String[8]: 8 registers, 16 characters. The list prints string[6] as "12 characters", string[7] as "Max 14 characters" and string[16] as "32 characters", so string[n] is n registers of two characters each. | Ascii | - | 1 | RW |
| 200 | 1 | Micro grid mode 0=Grid-forming;1=Grid-following;2=reserved;3=Hybrid droop mode | UInt16 | - | 1 | R |
| 201 | 1 | Reference frequency f0 | Int16 | Hz | 0.01 | RW |
| 202 | 1 | Reference power P0 | Int16 | % | 0.01 | RW |
| 203 | 1 | Minimum active power | Int16 | % | 0.01 | RW |
| 204 | 1 | Maximum active power | Int16 | % | 0.01 | RW |
| 205 | 1 | Frequency droop value | UInt16 | % | 0.01 | RW |
| 206 | 1 | Reference reactive power Q0 | Int16 | % | 0.01 | RW |
| 207 | 1 | Minimum reactive power | Int16 | % | 0.01 | RW |
| 208 | 1 | Maximum reactive power | Int16 | % | 0.01 | RW |
| 209 | 1 | Voltage droop slope | UInt16 | % | 0.01 | RW |
| 210 | 1 | Reference voltage U0 | UInt16 | V | 0.01 | RW |
| 211 | 1 | Activate droop mode parameters 1=Send values | UInt16 | - | 1 | RW |
| 230 | 1 | Keep Grid-following or Grid-forming mode alive 1=Keep alive for 2 seconds Must be written every 2 seconds | UInt16 | - | 1 | RW |
| 231 | 1 | Microgrid error 0=No Error;1=Different fallback hybrid droop parameter values between phase masters;2=Hybrid droop parameter write failed | UInt16 | - | 1 | R |
| 232 | 1 | Microgrid operation 0 = standard operation; 1 = microgrid operation | UInt16 | - | 1 | RW |
| 233 | 1 | Operation change requires reset 1 = System needs to be reset to activate the operation choice | UInt16 | - | 1 | R |
| 234 | 1 | Operation can be changed through modbus 0 = Operation can be changed through inverter/charger AUX inputs only; 1 = Operation can be changed through dbus/modbus | UInt16 | - | 1 | R |
| 235 | 1 | Microgrid black start allowed 0=Not allowed;1=Allowed | UInt16 | - | 1 | R |
| 240 | 2 | Microgrid hybrid droop active power reference (100%) | UInt32 | W | 1 | R |
| 242 | 2 | Microgrid hybrid droop reactive power reference (100%) | UInt32 | W | 1 | R |
| 244 | 2 | Grid-following (P-Q) active power reference (100%) | UInt32 | W | 1 | R |
| 246 | 2 | Grid-following (P-Q) reactive power reference (100%) | UInt32 | W | 1 | R |
Read this device live with Modbus Connect, free for Windows, macOS and Linux
Related guides
Notes
A MultiPlus, MultiPlus-II, Quattro or Quattro-II is controlled over VE.Bus, not over a network port of its own: these are the com.victronenergy.vebus registers of the Modbus TCP server that the GX device (Cerbo GX, Ekrano GX, MultiPlus-II GX, Venus GX) runs. Read them with the VE.Bus service's own unit ID, not the system unit ID 100 used by victron-gx-cerbo: the register list's Unit ID mapping sheet gives the preferred ID 227 for the Cerbo GX VE.Bus port and 228 for the EasySolar-II/MultiPlus-II GX VE.Bus port, and since Venus OS 2.60 unit IDs are assigned dynamically, so check Settings > Integrations > Modbus TCP server > Available services on the GX device and use the ID listed there; 227 is only the preferred value. Addresses are the decimal addresses of Victron's CCGX Modbus TCP register list (version 3.81, the vendor-hosted workbook linked on the supplier page), used unchanged as wire addresses. That list's 'Scalefactor' column is a divisor, so the factors here are the equivalent multipliers (10 becomes 0.1, 0.1 becomes 10). Left out: the RESERVED rows 122-128 and 138-139, and the grid-following/grid-forming micro-grid setpoints 213-222, which the list marks 'Unsupported'. The Custom Name at 140 is a String[8], which the list's own ranges (string[6] = 12 characters, string[16] = 32 characters) make eight registers of two characters each. The energy counters at 74-92 are 32-bit pairs, which is why every second address is absent. The VE.Bus state, charge state, switch position and VE.Bus error rows carry the list's full value tables in their descriptions. The list prints no byte or word order for its 32-bit values, so HighFirst is the Modbus convention, as in the library's other Victron seeds; if a two-register reading looks word-swapped, switch the device to LowFirst. Source: Victron Energy 'CCGX-Modbus-TCP-register-list-3.81.xlsx' — version 3.81, whose 'Document versions' sheet ends at Rev 54 — on victronenergy.com.
Related devices
- EV Charging Station (EVCS) / EVCS NSVictron Energy
- GX device (Cerbo GX / Venus GX / Ekrano GX) Modbus TCP serverVictron Energy
- Multi RS Solar 48/6000 inverter/charger with two MPPT trackers (multi service on a GX device)Victron Energy
- SmartShunt 500 A / 1000 A / 2000 A and BMV-700 / BMV-702 / BMV-712 battery monitors (battery service on a GX device)Victron Energy