Monitors Victron energy systems via CerboGX Modbus TCP connection.
Overview
This template reads AC consumption, grid power, battery voltage, state of charge, and battery power from a Victron Energy system via a CerboGX over Modbus TCP. It supports system, VeBus, and SmartSolar charger device types, each addressed by their own Unit ID.
Key readings
AC Consumption L1 to L3
Grid Power L1 to L3
Battery Power (System)
Battery State of Charge (System)
Battery Voltage (System)
Use cases
Monitor AC consumption per phase and grid power on a live cloud dashboard for your customer.
Track battery state of charge and voltage over time to detect degradation or undersizing.
Create an alert when battery state of charge drops below a critical threshold for more than 15 minutes.
Compare SmartSolar charger output with total AC consumption to evaluate self-consumption ratios.
Generate daily and monthly energy reports for off-grid or hybrid Victron installations.
Verify correct system operation remotely after commissioning a new Victron setup.
Installation
1Enable Modbus TCP in the CerboGX settings under Services and note the IP address and port (default 502).
2Navigate to Available Services on the CerboGX and record the Unit ID for com.victronenergy.system, com.victronenergy.vebus, and com.victronenergy.solarcharger.
3Connect your ModbusCloud gateway (MCG or MLP series) to the same local network as the CerboGX.
4Import the Victron Modbus Integration template in the ModbusCloud platform and enter the CerboGX IP address and port.
5Configure each Modbus device in the template with the correct Unit ID as noted from the CerboGX.
6Verify that live readings for AC consumption, grid power, and battery data appear on your ModbusCloud dashboard.
Things to watch for
01
I see no data after importing the template. What should I check first?
Confirm that Modbus TCP is enabled on the CerboGX under Services. Then verify that the ModbusCloud gateway and the CerboGX are on the same network, or that TCP port 502 is open through any firewall between them.
02
How do I find the correct Unit ID for each Victron device?
On the CerboGX, go to Settings, then Services, then Available Services. Each device type (system, vebus, solarcharger) is listed with its Unit ID. Enter these IDs in the corresponding Modbus device entries in the template.
03
Can I add more registers, for example tank levels or additional MPPT chargers?
Yes. Download the official Victron Modbus TCP register file from the Victron GitHub repository. It lists all available registers with addresses, data types, and scale factors. Add new registers in the ModbusCloud template accordingly.
04
Do I need RS-485 wiring for this template?
No. The CerboGX communicates over Modbus TCP via Ethernet or Wi-Fi. Only a standard network connection between the ModbusCloud gateway and the CerboGX is required.
Registers (9)
9 read / 0 write
Name
Address
Function
Type
Unit
Access
AC Consumption L1
817
FC04
uint16
W
R
AC Consumption L2
818
FC04
uint16
W
R
AC Consumption L3
819
FC04
uint16
W
R
Battery Power (System)
842
FC04
uint16
W
R
Battery State of Charge (System)
843
FC04
uint16
%
R
Battery Voltage (System)
840
FC04
uint16
V
R
Grid L2
821
FC04
uint16
V
R
Grid L3
822
FC04
uint16
V
R
Grid L1
820
FC04
uint16
V
R
Working with Modbus in your projects?
ModbusCloud is the hardware-plus-software platform that installers use to monitor, visualise and control Modbus devices from one portal. This template is one of hundreds you can use right away.
