Victron Meter AcIn
The Victron Meter AcIn is a Modbus TCP register view into the AC-input measurement of a Victron Multi or Quattro inverter/charger, accessed through a Victron GX device such as the Cerbo GX or Venus GX acting as a gateway. This template reads the per-phase voltage, current, active power, and grid frequency at the AC-input terminals across all three phases. With these ten registers, your ModbusCloud portal can continuously track the quality and load of the grid connection feeding the Victron system, enabling alerts, trend analysis, and integration into broader site energy monitoring.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 10, read only
- Brand
- Victron
- Last updated
Registers (10)
10 read, 0 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| voltage_l1 | V | Read | |||
| voltage_l2 | V | Read | |||
| voltage_l3 | V | Read | |||
| current_l1 | A | Read | |||
| current_l2 | A | Read | |||
| current_l3 | A | Read | |||
| frequency | Hz | Read | |||
| active_power_l1 | W | Read | |||
| active_power_l2 | W | Read | |||
| active_power_l3 | W | Read |
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-input voltage on all three phases to detect grid sags or swells in real time.
- Track per-phase active power on L1, L2, and L3 to verify balanced load distribution across the AC input.
- Alert on grid frequency deviations at the AC-input connection to spot supply instability early.
- Compare AC-input current per phase over time to identify progressive load growth before capacity limits are reached.
- Report historical AC-input power data per phase for monthly energy audits at multi-site installations.
Installation
Enable Modbus TCP on the Victron GX device by navigating to Settings, then Services, and switching on the Modbus-TCP service.
Connect the ModbusCloud Gateway to the same LAN as the Victron GX device, ensuring the GX device has a fixed or reserved IP address.
In the ModbusCloud portal, add the Gateway, import the Victron Meter AcIn template, set the target IP to the GX device address, and assign unit ID 246 (the VE.Bus port).
Verify the connection by spot-checking the voltage_l1 register: the raw int16 value should equal the phase-1 AC voltage multiplied by 10, for example 2302 for 230.2 V.
Things to watch for
Why are voltage and current values ten times too high?
Victron's GX Modbus TCP register map applies a scale factor of 10 to voltage and current registers: the raw int16 value must be divided by 10 to obtain the engineering value in volts or amperes. Confirm the scaling is applied correctly in your ModbusCloud template configuration.
The Gateway connects but all register values show zero or error.
The most common cause is a wrong unit ID. The AC-input registers for the VE.Bus device use unit ID 246 on the GX device. Check Settings, then Services, then Modbus-TCP on the GX to see the last Modbus error and confirm which unit IDs are active in your installation.
Modbus TCP is enabled but the GX device is unreachable from the Gateway.
Ensure the ModbusCloud Gateway and the GX device are on the same network segment and that no firewall blocks TCP port 502. The GX device exposes Modbus TCP on port 502. Confirm the IP address has not changed by assigning a DHCP reservation on your router.
Some phase registers return valid data while others return exception codes.
Not all phase registers are populated in every installation. In a single-phase or split-phase system, registers for unused phases (such as voltage_l2 and voltage_l3) may return Modbus exception code 02 (illegal data address). This is normal. Only registers for physically present and configured phases will return valid data.
Want to see how it works?
