Victron Victron Meter AcOut Modbus TCP template

Victron Meter AcOut

Victron Meter AcOut is a Modbus TCP virtual meter that surfaces the AC output measurements of a Victron Multi or Quattro inverter-charger, read through a Victron GX device acting as a Modbus TCP gateway. The template reads per-phase voltage, current, frequency, and active power on all three output phases, plus six cumulative energy counters tracking power flow between AC input 1, AC input 2, the AC output bus, and the battery. This gives installers and asset managers a complete picture of what critical loads connected to the AC output are actually consuming.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
16, read only
Brand
Victron
Last updated

Registers (16)

16 read, 0 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
voltage_l1VRead
voltage_l2VRead
voltage_l3VRead
current_l1ARead
current_l2ARead
current_l3ARead
frequencyHzRead
active_power_l1WRead
active_power_l2WRead
active_power_l3WRead
energy_from_ac_in_1_to_ac_outWhRead
energy_from_ac_in_2_to_ac_outWhRead
energy_from_ac_out_to_ac_in_1WhRead
energy_from_ac_out_to_ac_in_2WhRead
energy_from_battery_to_ac_outWhRead
energy_from_ac_out_to_batteryWhRead

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Use cases

  • Monitor per-phase AC output voltage and current to detect load imbalances across three phases.
  • Track active power on each output phase to verify that critical loads stay within inverter capacity.
  • Compare energy_from_battery_to_ac_out against energy_from_ac_in_1_to_ac_out to audit how much battery discharge supports connected loads.
  • Alert on unexpected drops in output frequency to catch inverter stress or grid instability events early.
  • Report cumulative energy flows from both AC inputs to the AC output bus for site energy balance audits.

Installation

  1. Enable Modbus TCP on the Victron GX device by navigating to Settings, then Services, then Modbus TCP, and switching it on.

  2. Connect the ModbusCloud Gateway to the same LAN as the Victron GX device and confirm the GX device's IP address is reachable on port 502.

  3. In the ModbusCloud portal, add your Gateway, import the Victron Meter AcOut template, and set the unit ID to match the VE.Bus device instance shown under Settings, Services, Modbus TCP on the GX device (commonly 246 for the VE.Bus port).

  4. Spot-check registers voltage_l1 and active_power_l1 in the portal live view and divide the raw uint16 value by 10 to confirm it matches the AC output voltage shown in the GX remote console.

Things to watch for

Voltage and current readings look ten times too high. Why?

Registers 15 to 20 use a scale factor of 10 in the Victron register list, meaning the raw value must be divided by 10 to obtain the actual voltage or current. Confirm your client or dashboard applies this scaling before displaying values.

All registers return an error or no data appears after connection.

The most common cause is a wrong unit ID. The VE.Bus port on a Victron GX device defaults to unit ID 246. Verify the correct unit ID under Settings, Services, Modbus TCP on the GX device, and also check that Modbus TCP is enabled and that port 502 is not blocked by a firewall between the ModbusCloud Gateway and the GX device.

The energy counters reset to zero unexpectedly. Is this normal?

Yes. Victron documents that the energy counters from the Multi or Quattro are volatile: they reset to zero when the inverter is switched off and also when the GX device reboots. Do not rely on these registers for long-term energy accounting without persisting values externally.

Registers 74 to 92 return valid data but have no unit. What is the scale?

The input register list intentionally leaves the unit field empty for the energy counter registers. Cross-reference the official Victron CCGX Modbus TCP register list Excel file from the Victron technical information page to confirm the scaling and unit applicable to your firmware version before using these values in billing or reporting.

Want to see how it works?

Electrician working in an open distribution board