Victron ESS Mode 2 and 3 External Control via Modbus TCP

Key Takeaways

• External control of Victron ESS Mode 2 and 3 uses ModbusTCP or D-Bus protocols.
• Grid power setpoints can be adjusted to control energy flow to or from the grid.
• Specific ModbusTCP registers and D-Bus paths are used for various control functions.
• Victron Energy does not offer general support for implementing these advanced features.

How do I externally control my Victron ESS in Mode 2 or Mode 3?

You can externally control Victron ESS in Mode 2 or Mode 3 primarily using ModbusTCP or D-Bus communication protocols. This allows you to adjust settings like grid power setpoints and charge/discharge limits on your Multi or Quattro inverter/charger via a GX device.

Diagnosis and Setup Steps for External Control

To implement or troubleshoot external control of your Victron ESS system, follow these steps to ensure proper configuration and communication.

1. Verify ESS Mode Configuration:

• • Check: Confirm that your Victron ESS is configured for Mode 2 or Mode 3. These modes are designed to enable external control of grid setpoints and other parameters.
  • Meaning: If your system is not in Mode 2 or 3, external commands will not be processed as expected.

2. Confirm GX Device Connectivity:

• • Check: Ensure your GX device is powered on and connected to your local network. The GX device acts as the communication gateway for ModbusTCP and D-Bus.
  • Meaning: Without a functional GX device and network connection, external control commands cannot reach the inverter/charger.

3. Identify Venus OS Version:

• • Check: Determine the Venus OS version running on your GX device.
  • Meaning: The ModbusTCP register usage for grid power setpoints differs based on whether your Venus OS version is before v3.50 or v3.50 and later. Using the incorrect register will result in failed commands or unexpected behavior.

4. Check ModbusTCP Unit ID:

• • Check: If using ModbusTCP, confirm that your external control system is addressing the GX device using ModbusTCP unit address 100.
  • Meaning: The ModbusTCP unitaddress 100 is the designated address for communication with the GX device for ESS control. Incorrect unit ID will prevent communication.

5. Review ModbusTCP Register Usage:

• • Check: Refer to the table below for the correct ModbusTCP registers and D-Bus paths for specific control functions based on your Venus OS version.
  • Meaning: Using deprecated or incorrect registers will prevent your commands from being applied. For example, registers 2701 (charge) and 2702 (inverter) are deprecated for enabling/disabling charging and inverting.

External Control Parameters and Protocols

The following table details the ModbusTCP registers and D-Bus paths used for external control of Victron ESS Mode 2 and 3.

Safety: Working with Electrical Systems

Working with Victron Multi or Quattro inverter/chargers and their associated electrical systems involves significant hazards. Always kill power to the inverter/charger, PV array, and battery bank before performing any physical work or making connections. Use insulated tools to prevent accidental short circuits, as a spanner across a battery bank can short hundreds of amps. Opening the unit or making internal modifications should only be performed by authorized service personnel.

When to call a technician instead

Implementing external control for Victron ESS Mode 2 and 3 requires advanced technical knowledge of ModbusTCP, D-Bus, and network communication. Victron Energy does not offer general support for these features, except in "real specific situations." If you are unsure about configuring ModbusTCP registers, scripting on the GX device, or integrating with external systems, it is advisable to consult a qualified Victron installer or system integrator. Attempting to implement complex control without adequate understanding can lead to system instability, incorrect energy management, or damage to equipment.