Victron Meter Grid
The Victron Meter Grid is a three-phase grid measurement point within Victron Energy Storage Systems, surfaced through the GX device (Cerbo GX, Ekrano GX, or Venus GX) over Modbus TCP. The template reads the com.victronenergy.grid register block, covering per-phase active power (L1, L2, L3), voltage, current, and cumulative import and export energy counters for each phase. Together these registers give installers a complete, phase-resolved view of what flows between the site and the public grid, enabling precise import/export accounting and real-time ESS control feedback in the ModbusCloud portal.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 16, read only
- Brand
- Victron
- Last updated
Registers (16)
16 read, 0 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| active_power_l1 | W | Read | |||
| active_power_l2 | W | Read | |||
| active_power_l3 | W | Read | |||
| serial_number | Read | ||||
| voltage_l1 | V | Read | |||
| current_l1 | A | Read | |||
| voltage_l2 | V | Read | |||
| current_l2 | A | Read | |||
| voltage_l3 | V | Read | |||
| current_l3 | A | Read | |||
| active_consumption_energy_l1 | Wh | Read | |||
| active_consumption_energy_l2 | Wh | Read | |||
| active_consumption_energy_l3 | Wh | Read | |||
| active_production_energy_l1 | Wh | Read | |||
| active_production_energy_l2 | Wh | Read | |||
| active_production_energy_l3 | Wh | 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 active power on L1, L2, and L3 to detect persistent phase imbalances across three-phase sites.
- Track cumulative import energy per phase to verify monthly grid consumption figures against utility invoices.
- Track cumulative export energy per phase to confirm feed-in volumes reported to the grid operator.
- Alert on unexpected active power reversals on any single phase to spot wiring or CT orientation errors early.
- Compare per-phase voltage readings over time to identify gradual supply-voltage deviation on individual phases.
Installation
Enable Modbus TCP on the GX device by navigating to Settings, then Services, then Modbus TCP, and toggling the service on.
Connect the ModbusCloud Gateway to the same LAN as the GX device, ensuring TCP port 502 is reachable between them.
In the ModbusCloud portal, add the Gateway, import the Victron Meter Grid template, and set the Unit ID to the value shown under Settings, Services, Modbus TCP, Available services for the com.victronenergy.grid instance.
Spot-check register 2600 (active_power_l1) against the live reading visible on the GX remote console to confirm data is flowing correctly.
Things to watch for
All grid registers return zero or an error. What is wrong?
Modbus TCP is disabled by default on GX devices. Navigate to Settings, Services, Modbus TCP on the GX device and enable the service. Also confirm that no firewall or VLAN is blocking TCP port 502 between the ModbusCloud Gateway and the GX device's IP address.
I get valid data but the Unit ID keeps timing out.
The Unit ID for the grid meter is not fixed. It depends on the device instance assigned by Venus OS and is shown under Settings, Services, Modbus TCP, Available services. Using Unit ID 0 is unreliable because many Modbus TCP clients do not accept it. Use the instance-specific ID listed there instead.
Voltage and current values look ten times too large. Why?
The voltage and current registers carry a scale factor of 10 in the official Victron Modbus TCP register list, meaning the raw int16 value must be divided by 10 to obtain the actual reading in volts or amperes. Verify that your portal scaling configuration matches this factor.
Energy counter registers 2622 to 2633 have no unit. What are they in?
The official Victron register documentation lists these cumulative energy counters in kWh with a scale factor applied. The unit field in this template is empty because the OpenEMS import did not carry it. Consult the Victron CCGX Modbus TCP register list spreadsheet to confirm the exact scale factor for your firmware version before building dashboards or billing reports.
Want to see how it works?
