All devices

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

AddressCountNameTypeUnitScaleAccess
31
Input voltage phase 1
UInt16V AC0.1R
41
Input voltage phase 2
UInt16V AC0.1R
51
Input voltage phase 3
UInt16V AC0.1R
61
Input current phase 1
Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains.
Int16A AC0.1R
71
Input current phase 2
Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains.
Int16A AC0.1R
81
Input current phase 3
Positive: current flowing from mains to Multi. Negative: current flowing from Multi to mains.
Int16A AC0.1R
91
Input frequency 1
Int16Hz0.01R
101
Input frequency 2
Int16Hz0.01R
111
Input frequency 3
Int16Hz0.01R
121
Input power 1
Sign meaning equal to Input current
Int16W10R
131
Input power 2
Sign meaning equal to Input current
Int16W10R
141
Input power 3
Sign meaning eaqual to Input current
Int16W10R
151
Output voltage phase 1
UInt16V AC0.1R
161
Output voltage phase 2
UInt16V AC0.1R
171
Output voltage phase 3
UInt16V AC0.1R
181
Output current phase 1
Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi.
Int16A AC0.1R
191
Output current phase 2
Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi.
Int16A AC0.1R
201
Output current phase 3
Postive: current flowing from Multi to the load. Negative: current flowing from load to the Multi.
Int16A AC0.1R
211
Output frequency
Int16Hz0.01R
221
Active input current limit
See Venus-OS manual for limitations, for example when VE.Bus BMS or DMC is installed.
Int16A0.1RW
231
Output power 1
Sign meaning equal to Output current
Int16W10R
241
Output power 2
Sign meaning equal to Output current
Int16W10R
251
Output power 3
Sign meaning equal to Output current
Int16W10R
261
Battery voltage
UInt16V DC0.01R
271
Battery current
Positive: current flowing from the Multi to the dc system. Negative: the other way around.
Int16A DC0.1R
281
Phase count
UInt16-1R
291
Active input
0=AC Input 1;1=AC Input 2;240=Disconnected
UInt16-1R
301
VE.Bus state of charge
UInt16%0.1RW
311
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-1R
321
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-1R
331
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-1RW
341
Temperature alarm
0=Ok;1=Warning;2=Alarm
UInt16-1R
351
Low battery alarm
0=Ok;1=Warning;2=Alarm
UInt16-1R
361
Overload alarm
0=Ok;1=Warning;2=Alarm
UInt16-1R
371
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.
Int16W1RW
381
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-1RW
391
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-1RW
401
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.
Int16W1RW
411
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.
Int16W1RW
421
Temperatur sensor alarm
0=Ok;1=Warning;2=Alarm
UInt16-1R
431
Voltage sensor alarm
0=Ok;1=Warning;2=Alarm
UInt16-1R
441
Temperature alarm L1
0=Ok;1=Warning;2=Alarm
UInt16-1R
451
Low battery alarm L1
0=Ok;1=Warning;2=Alarm
UInt16-1R
461
Overload alarm L1
0=Ok;1=Warning;2=Alarm
UInt16-1R
471
Ripple alarm L1
0=Ok;1=Warning;2=Alarm
UInt16-1R
481
Temperature alarm L2
0=Ok;1=Warning;2=Alarm
UInt16-1R
491
Low battery alarm L2
0=Ok;1=Warning;2=Alarm
UInt16-1R
501
Overload alarm L2
0=Ok;1=Warning;2=Alarm
UInt16-1R
511
Ripple alarm L2
0=Ok;1=Warning;2=Alarm
UInt16-1R
521
Temperature alarm L3
0=Ok;1=Warning;2=Alarm
UInt16-1R
531
Low battery alarm L3
0=Ok;1=Warning;2=Alarm
UInt16-1R
541
Overload alarm L3
0=Ok;1=Warning;2=Alarm
UInt16-1R
551
Ripple alarm L3
0=Ok;1=Warning;2=Alarm
UInt16-1R
561
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-1RW
571
VE.Bus BMS allows battery to be charged
0=No;1=Yes VE.Bus BMS allows the battery to be charged
UInt16-1R
581
VE.Bus BMS allows battery to be discharged
0=No;1=Yes VE.Bus BMS allows the battery to be discharged
UInt16-1R
591
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-1R
601
VE.Bus BMS error
0=No;1=Yes
UInt16-1R
611
Battery temperature
Int16°C0.1R
621
VE.Bus Reset
1=VE.Bus reset Any write action will cause a reset
UInt16-1RW
631
Phase rotation warning
0=Ok;1=Warning
UInt16-1R
641
Grid lost alarm
0=Ok;2=Alarm
UInt16-1R
651
Feed DC overvoltage into grid
0=Feed in overvoltage;1=Do not feed in overvoltage
UInt16-1RW
661
Maximum overvoltage feed-in power L1
UInt16W100RW
671
Maximum overvoltage feed-in power L2
UInt16W100RW
681
Maximum overvoltage feed-in power L3
UInt16W100RW
691
AC input 1 ignored
0=AC input not ignored;1=AC input ignored
UInt16-1R
701
AC input 2 ignored
0=AC input not ignored;1=AC input ignored
UInt16-1R
711
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-1RW
721
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-1RW
731
Sustain active
0=Sustain inactive; 1=Sustain active
UInt16-1R
742
Energy from AC-In 1 to AC-out
PLEASE NOTE:
UInt32kWh0.01R
762
Energy from AC-In 1 to battery
Energy counters from the Multi(s) are volatile.
UInt32kWh0.01R
782
Energy from AC-In 2 to AC-out
These energy counters reset to zero when the Multi is switched off.
UInt32kWh0.01R
802
Energy from AC-In 2 to battery
These energy counters ALSO reset to zero when the GX-device reboots.
UInt32kWh0.01R
822
Energy from AC-out to AC-in 1 (reverse fed PV)
UInt32kWh0.01R
842
Energy from AC-out to AC-in 2 (reverse fed PV)
UInt32kWh0.01R
862
Energy from battery to AC-in 1
UInt32kWh0.01R
882
Energy from battery to AC-in 2
UInt32kWh0.01R
902
Energy from battery to AC-out
UInt32kWh0.01R
922
Energy from AC-out to battery (typically from PV-inverter)
UInt32kWh0.01R
941
Low cell voltage imminent
0=OK;1=Warning
UInt16-1R
951
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-1R
962
ESS power setpoint phase 1
32-bit compliment to 37, 40 and 41
Int32W1RW
982
ESS power setpoint phase 2
Int32W1RW
1002
ESS power setpoint phase 3
Int32W1RW
1021
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-1RW
1031
Select Remote Generator
0=Generator not selected;1=Generator selected Informs Multi that a generator is active on AC-in
UInt16-1RW
1041
Remote generator selected
0=Generator not selected;1=Generator selected
UInt16-1R
1051
Redetect VE.Bus system
0=No action;1=Redetect system
UInt16-1RW
1061
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.01RW
1071
Configured output voltage
UInt16V AC0.01RW
1081
PowerAssist enabled
0=Disabled;1=Enabled
UInt16-1RW
1091
UPS function enabled
0=Enabled;1=Disabled
UInt16-1RW
1101
Relay test OK, VE.Bus unit L1 master
0=No;1=Yes
UInt16-1R
1111
Relay test OK, VE.Bus unit L2 master
0=No;1=Yes
UInt16-1R
1121
Relay test OK, VE.Bus unit L3 master
0=No;1=Yes
UInt16-1R
1131
Relay test OK, VE.Bus unit L1 parallel unit 1
0=No;1=Yes
UInt16-1R
1141
Relay test OK, VE.Bus unit L2 parallel unit 1
0=No;1=Yes
UInt16-1R
1151
Relay test OK, VE.Bus unit L3 parallel unit 1
0=No;1=Yes
UInt16-1R
1161
Relay test OK, VE.Bus unit L1 parallel unit 2
0=No;1=Yes
UInt16-1R
1171
Relay test OK, VE.Bus unit L2 parallel unit 2
0=No;1=Yes
UInt16-1R
1181
Relay test OK, VE.Bus unit L3 parallel unit 2
0=No;1=Yes
UInt16-1R
1191
Relay test OK, VE.Bus unit L1 parallel unit 3
0=No;1=Yes
UInt16-1R
1201
Relay test OK, VE.Bus unit L2 parallel unit 3
0=No;1=Yes
UInt16-1R
1211
Relay test OK, VE.Bus unit L3 parallel unit 3
0=No;1=Yes
UInt16-1R
1291
Weak AC input setting
0=Strong AC input;1=Weak AC input
UInt16-1RW
1302
Nominal inverter power – Total
UInt32W1R
1322
Nominal inverter power – L1
UInt32W1R
1342
Nominal inverter power – L2
UInt32W1R
1362
Nominal inverter power – L3
UInt32W1R
1408
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-1RW
2001
Micro grid mode
0=Grid-forming;1=Grid-following;2=reserved;3=Hybrid droop mode
UInt16-1R
2011
Reference frequency f0
Int16Hz0.01RW
2021
Reference power P0
Int16%0.01RW
2031
Minimum active power
Int16%0.01RW
2041
Maximum active power
Int16%0.01RW
2051
Frequency droop value
UInt16%0.01RW
2061
Reference reactive power Q0
Int16%0.01RW
2071
Minimum reactive power
Int16%0.01RW
2081
Maximum reactive power
Int16%0.01RW
2091
Voltage droop slope
UInt16%0.01RW
2101
Reference voltage U0
UInt16V0.01RW
2111
Activate droop mode parameters
1=Send values
UInt16-1RW
2301
Keep Grid-following or Grid-forming mode alive
1=Keep alive for 2 seconds Must be written every 2 seconds
UInt16-1RW
2311
Microgrid error
0=No Error;1=Different fallback hybrid droop parameter values between phase masters;2=Hybrid droop parameter write failed
UInt16-1R
2321
Microgrid operation
0 = standard operation; 1 = microgrid operation
UInt16-1RW
2331
Operation change requires reset
1 = System needs to be reset to activate the operation choice
UInt16-1R
2341
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-1R
2351
Microgrid black start allowed
0=Not allowed;1=Allowed
UInt16-1R
2402
Microgrid hybrid droop active power reference (100%)
UInt32W1R
2422
Microgrid hybrid droop reactive power reference (100%)
UInt32W1R
2442
Grid-following (P-Q) active power reference (100%)
UInt32W1R
2462
Grid-following (P-Q) reactive power reference (100%)
UInt32W1R

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