Blue Power
https://www.victronenergy.com/
App Store Page
https://homey.app/a/com.victronenergy
Description
Monitor and control your Victron system through its GX device (Cerbo GX, Ekrano GX, Venus GX, …). The app talks to the GX using its Modbus TCP interface. All communication goes via the GX, never directly to the other Victron products.
Device types
Add the device types that match the equipment in your system. You don’t need all of them, and you can add more than one of the same type, e.g. several batteries, solar chargers or tanks.
| Device type | What it shows / does | Homey Energy | Modbus service (Unit ID) |
|---|---|---|---|
| Battery | State of charge, power, voltage, current, temperature, cell voltages, charged/discharged energy | Home battery | com.victronenergy.battery |
| Solar Charger (MPPT) | PV power, current, voltage, daily and total yield | Solar panel | com.victronenergy.solarcharger |
| PV Inverter (AC-coupled, e.g. Fronius) | Power, current and voltage per phase | Solar panel | com.victronenergy.pvinverter |
| Energy Meter (grid meter) | Power, current and voltage per phase, imported/exported energy | Main meter | com.victronenergy.grid |
| EV Charger (Victron EVCS) | Charging state, power, energy, start/stop, mode and current | EV charger | com.victronenergy.evcharger |
| Generator | Generator status and power | – | com.victronenergy.generator |
| Tank sensor | Tank level and status | – | com.victronenergy.tank |
| Temperature sensor | Temperature, humidity, pressure | – | com.victronenergy.temperature |
| Victron GX | System overview (grid, PV, battery, consumption), ESS and Dynamic ESS control, relays, charging schedules | – | com.victronenergy.vebus |
| Victron VRM | Solar and consumption forecasts, Dynamic ESS Green/Trade mode. Uses the VRM cloud API, not Modbus | – | – (personal access token) |
Do I need the “Victron GX” device type?
Only if your system has a VE.Bus inverter/charger (MultiPlus, Quattro, …). Despite the name, this device type reads from the VE.Bus service and is used to control ESS. If your system has no Multi or Quattro, e.g. just MPPTs and a battery, adding it will fail with “Wrong unitId for this device type”. Add the Battery, Solar Charger, Energy Meter etc. device types instead. They give you the same readings.
Before adding devices
- Your Homey must be able to reach the GX on the network. You need its IP address and the Modbus port (502 by default).
- Enable Modbus TCP on the GX: Settings → Integrations → Modbus TCP Server → Enable Modbus/TCP (on older firmware: Settings → Services → Modbus/TCP).
- Each device type needs its own Unit ID. Find it on the GX under Settings → Integrations → Modbus TCP Server → Available services. Look up the service name from the table above and use the Unit ID listed next to it. Unit ID 100 (
com.victronenergy.system) is not the right one for any of the device types. - Charging schedule actions on the GX device type use MQTT. Enable MQTT on the GX (Settings → Integrations → MQTT) if you want to use them.
- For the VRM device, create a personal access token in the VRM Portal (Preferences → Integrations → Access tokens).
Flow cards
Most device types come with triggers, conditions and actions. The GX device type has the most: switch position, grid setpoint, charge/discharge/feed-in limits, minimum SoC, ESS and Dynamic ESS mode, relays and charging schedules. Browse them in the Flow editor.
Disclaimer
Use this app at your own risk.
An ESS is complex, and it’s easy to forget that some flow changes a setting. Pay attention to the actions you use. If your system is configured to charge at max 40 A, don’t set it to 200 A and hope for the best.
As usual, any feedback is welcome 
