VictronConnect Configuration Guide for VE.Bus Products

Introduction

The VictronConnect App allows configuration, monitoring, updating, and diagnosis of VE.Bus Victron products. Connection is made via a USB-MK3 accessory cable or the VE.Bus Smart Dongle. The MK3-USB is available for Android, Windows, and macOS X, while the VE.Bus Smart Dongle is available for Android, macOS X, and iOS.

VictronConnect is an efficient tool for installers to configure systems quickly. It also facilitates safe and easy firmware updates without requiring an internet connection or file downloads.

The VE.Bus Smart Dongle provides an entry-level user interface for monitoring and operation, allowing control of shore power input current limit or switching the inverter on/off.

This information applies to all Inverters and Inverter/chargers with a VE.Bus communication port, including:

• MultiPlus (including Compact)
• MultiPlus-II
• MultiPlus-II GX
• MultiGrid
• Quattros
• EasySolar
• EasySolar-II
• EasySolar-II GX
• Phoenix Inverters with a VE.Bus port

For general information on installing the VictronConnect App, refer to the overall VictronConnect manual.

Connection Diagram: A laptop connects via USB to a Victron Interface MK3 to USB, which then connects via VE.Bus to the inverter/charger. The inverter/charger is connected to either AC SUPPLY or a BATTERY (or both).

Limitations

VictronConnect vs VEConfigure & VEFlash

VictronConnect is replacing VEConfigure and VEFlash, offering easier use and broader device compatibility. However, the following features are not yet supported in VictronConnect and require VEConfigure:

• Assistants (e.g., AC PV, ESS)
• Virtual Switch (some functionality is available via AC input control)
• Changing the Grid Code
• Lithium Battery Wizard (for batteries requiring an Assistant, e.g., VE.Bus BMS)
• External Current Sensor

Required Firmware Versions

For full functionality (data readout, settings changes, firmware updates), firmware version 415 or higher is required. This applies to VE.Bus products with a new microcontroller (7-digit software number starting with 26 or 27).

For older microcontrollers (starting with 19 or 20), firmware version 19xx200 (European) or 20xx200 (120V models) is supported for data readout only. Settings changes and firmware updates are not possible. Even older products (18xxxxx) are not supported. Use VEFlash for firmware updates on these older products.

VE.Bus Smart Dongle Limitations

When connected via Bluetooth using the VE.Bus Smart Dongle, only status data, voltages, and basic operation (On/Off/Charger-only, Shore current limit) are possible. Changes to product settings or firmware updates require an MK3-USB.

Using an Apple iPad or iPhone with the VE.Bus Smart Dongle is limited to status monitoring and basic operation due to the lack of OTG support for USB connections.

VictronConnect does not work with the MK2-USB.

Overview Video

A video overview of this document is available at: https://player.vimeo.com/video/373215592

Connecting

To connect to a VE.Bus Inverter/Charger, you need either an MK3-USB for configuration or a VE.Bus Smart Dongle for status mode. The interface connects between the VE.Bus port and your computer's USB or Bluetooth connection.

A straight RJ45 UTP cable (Ethernet patch or LAN cable) is required. Use an industrially manufactured cable, as hand-crimped cables may not be of sufficient quality.

For Android devices, an additional OTG cable is needed to connect the USB cable from the MK3-USB to the device's data port (micro-USB or USB-C). This adapter is not provided by Victron.

The Victron device must be supplied with appropriate voltage to communicate:

• Multi/Quattro: Either AC or DC
• Multi Compact: DC
• Inverters: DC

OTG Adapters: Images show USB-C to USB-A and Micro-USB to USB-A adapters.

Demo Mode Menu

Explore VictronConnect features using the demo mode. This allows loading a simulated system to adjust settings. Some settings have in-app descriptions. Access demo mode via the three-bar icon (top left) and selecting 'Demo library'. Configurations made in demo mode can be saved and loaded into real devices.

Display Options

When connecting to a VE.Bus device with VictronConnect, two modes are available: Status and Settings.

Status Mode

Status mode is available on Windows, macOS, Android, and iOS. It can be accessed via the MK3-USB or Bluetooth with the VE.Bus Smart Dongle.

In the status window, you can switch the device On/Off/Charger Only using the switch button. You can also quickly adjust the AC input current limit if the 'overruled by remote panel' setting is enabled.

For more information on Status mode and connecting with the VE.Bus Smart Dongle, watch the video: https://player.vimeo.com/video/373231144

Status Display Example: Shows AC IN 1 (3W, 12.0A), AC OUT L1 (0W), battery status (57.76V, 85% SOC, 25°C), and charging state (Absorption charge).

Settings Mode

Settings mode is accessible only with an MK3-USB, not the VE.Bus Smart Dongle. It is available on Windows, macOS, and Android. iPhone support for Settings mode is not available due to the lack of OTG connections for USB.

Settings Menu: Includes General, Grid, Inverter, Charger, AC input control, and Help & Manuals.

Description of Settings

General

• System frequency setting: Alters the inverter's output frequency.
• AC1 input current limit: Active only if no system panel is installed; overruled by remote panel if connected.
• Current limit overruled by remote: If enabled, the input current limit can be set remotely via a GX Device or Digital Multi Control. If disabled, it cannot be changed. For shore connections, enable this for user adjustment. For stationary or generator inputs, leave unchecked.
• Dynamic current limit: For use with 'small' generators (e.g., HONDA EU series). Dynamically reduces shore current to compensate for engine reaction time during sudden load increases.
• Enable Battery Monitor: Enables the VE.Bus battery monitor and features that utilize State of Charge (SoC).
• Battery capacity: Specify the connected battery capacity in Ah for accurate SoC calculation.
• State of charge when bulk finished: Sets the SoC when the Bulk phase concludes, aiding calibration of SoC values.
• Charge efficiency: Improves SoC accuracy by accounting for charging losses. Adjust if SoC accuracy drifts.

Grid

• Accept wide frequency range (45-65 Hz): Adjusts frequency measurement sensitivity. Useful for generators with unstable speeds to prevent input rejection.
• UPS function: Determines sensitivity to supply waveform distortion. When deselected, prevents lower voltage limits from being exceeded with heavy start-up loads.
• AC Voltage Connection and Disconnection: Sets voltage limits for feedback relay operation. These are the limits for accepting or rejecting the supply. If input voltage drops below the lower limit, the charger output reduces.
• Country / grid code standard: Not yet available in VictronConnect. Use VEConfigure for adjustments.

Inverter

• Inverter output voltage: Typically 120/230 Vac.
• Ground Relay: Enables/disables the internal ground relay (connects N to PE during inverter operation). Useful for earth-leakage circuit-breakers. Disabling on 120/240V models disconnects L2 output.
• DC input low-shutdown: Sets the low battery voltage level for inverter shutdown. Set according to battery manufacturer specifications for longevity.
• DC input low restart: Sets the voltage for inverter restart after low voltage shutdown. Recommended to be at least one volt higher than the shutdown voltage to prevent rapid cycling.
• DC input low pre-alarm: Sets the voltage level for the low battery pre-alarm indication. This setting is relative to the low restart and shutdown levels.
• Low SOC shut-down: If SoC is enabled, shuts down the Multi when a set SoC level is reached. Useful when battery voltage is not a reliable indicator of battery level.
• AES (Autonomous Energy Saving): Energy-saving feature for low load conditions. Deactivate AES for consumers with high inrush characteristics (e.g., microwaves, air-conditioning) to prevent slow switching and overloads.
• PowerAssist: Prevents AC input circuit breaker tripping due to excessive load. If the load exceeds the AC input current limit, the Multi inverts in parallel with the AC supply. Note: A minimum AC input current limit applies when PowerAssist is enabled.
• Assist current boost factor: Typically set to 2. Adjust with caution, considering potential negative aspects.

Charger

• Enable charger: Disabling the charger stops battery charging while inverter and assist functions remain active. This can be useful for systems with large solar arrays to promote 100% self-consumption. Incorrect system design when disabling the charger can lead to battery damage. Recommended only for systems with excess solar power.
• Charge current: Sets the current for the bulk charging phase. Actual current may be lower due to conditions like low AC input current limit, high load, high temperature, or improper cabling. For lead batteries, charge current should be 10-20% of battery capacity.
• Float voltage: Sets the reduced voltage for trickle charging to finish battery charge without excess heat or gassing.
• Absorption voltage: Sets the continuous target voltage during the absorption charge phase, with variable current.
• Repeated absorption interval: Specifies the interval between repeated absorption cycles.
• Repeated absorption time: Sets the duration of repeated absorption pulses.
• Maximum absorption time: Determines absorption time for fixed charge curves or the maximum absorption time for others.
• Charge curve: 'Adaptive' mode is generally recommended. 'Fixed' mode may be better if the charger-battery balance is not ideal, to prevent over or undercharging.
• BatterySafe: A special regulation in the absorption phase. Reduces charge current as voltage approaches the absorption setpoint, extending battery life. It helps extend the lifespan of lead-acid batteries by preventing overcharging. Charging is most efficient between 50-80% SoC; aim for 100% weekly for battery monitor synchronization and a full charge.
• Lithium battery mode:
  • Temperature compensation: Disabled in Lithium mode (uses Lead algorithm by default).
  • Re-bulk voltage: Reduced in Lithium mode (e.g., Vfloat - 0.2V for 12V systems, max 13.5V).

  Required settings per lithium type:

  • A) Batteries with built-in BMS (e.g., Victron Superpack): Enable lithium battery mode and set charging voltages per battery manual.
  • B) Victron V12.8 and 25.6V batteries requiring a VE.Bus BMS: Use VEConfigure, install the VE.Bus BMS Assistant, and check the Lithium battery box.
  • C) Intelligent batteries connected to a GX-device with DVCC enabled: The box setting has no effect; charger settings are overridden by CAN-bus parameters (e.g., Victron 24V Lithiums with Lynx BMS, BYD, Pylontech).
• Storage mode: After 24 hours in float charge, voltage reduces to protect the battery against overcharging, with regular current application to compensate for self-discharge.
• Use equalisation: For traction batteries, requires a fixed charging current phase. Can be damaging to DC loads if charging voltage is too high.
• Weak AC input: Reduces charger output if the supply waveform quality is poor. Can be deactivated for low-capacity or poorly regulated power supplies.
• Stop after excessive bulk: If absorption voltage is not reached after 10 hours, the charger switches off. Triggers lithium battery options and wizard.

AC Input Control

AC Input Control allows the Multi to selectively ignore the grid based on battery voltage and/or AC load parameters. The internal AC input relay opens to disconnect from the grid under certain conditions, acting like a backup generator.

This feature is not enabled by default. Its normal function is to open during blackouts or when a generator is off for safety.

When can the grid be controlled?

• Grid ignored when batteries are full enough; grid let in when batteries are empty: The Multi monitors battery voltage. It allows grid connection when battery voltage is low for a set time and ignores it once voltage increases. Can also disconnect grid based on battery SoC.
• Grid ignored when AC loads are low; grid let in when AC loads are high: The Multi monitors AC load. It allows grid connection when the load exceeds a certain level for a set time, preventing overload. It stops grid connection when the load drops below a set level.

Conditional AC input activation

Enables AC Input Control to modify the feedback relay's operation.

Load Conditions

Allows grid input when AC load exceeds the Multi rating, preventing overload. Example: grid not ignored if load > 4000W with no delay. Grid ignored when load drops below 2000W.

AC input activation based on load:

• Activate when load is higher than: [Value] W
• Delay before activation: [Time]
• Deactivate when load is lower than: [Value] W
• Delay before deactivation: [Time]

Battery Conditions

Allows grid input to charge batteries when they are low. Example: grid not ignored when battery voltage < 47.00V. Grid ignored when battery voltage > 52.00V for 5 minutes.

Options for deactivating AC input: 'Battery voltage', 'Bulk finished', or 'Absorption finished'.

'Absorption finished' ensures a full charge but can increase electricity bills. 'Bulk finished' (approx. 85% full) is less efficient. Refer to Victron Energy book "Energy Unlimited", page 25 for more details.

Grid can also be let in when battery SoC drops below a certain level. For systems with external charge sources or DC loads, use SoC option only if a GX device is present and connected to the Multi and other sources.

Firmware Updates

When to do a firmware update

Firmware updates are not strictly required for stable systems. Perform updates during:

• Commissioning / first install
• Troubleshooting
• Adding a required new feature

Firmware updates are available in Settings Mode and require a password.

Warning - reset to factory defaults

All settings will be reset to factory defaults after a firmware update.

Procedure

Connect to the unit, enter settings, select 'Product Info' (top right dots). VictronConnect includes the latest firmware versions; no internet connection is needed. Click 'Update' and do not touch devices until complete.

A video of the procedure is available: https://www.youtube.com/embed/Z9VKtoAS8o4

Step-by-step images show: Connecting, accessing settings, product info with firmware update available, and firmware library.

If a firmware update fails, try again. If recovery is not possible, use the VEFlash software.

Firmware updates with multiple units (e.g., 3 phase)

VictronConnect can efficiently update firmware for 3-phase or parallel units. Units must be programmed for their multi-unit configuration and connected. Settings will reset to factory defaults; save parameters and reprogram the multi-unit configuration.

Video demonstration: https://player.vimeo.com/video/373208468

Parallel, Three, Split-phase systems

VictronConnect can now configure systems of up to three units, replacing the need for the VE.Bus Quick Configure software. A password from your Victron supplier is required.

Video demonstration: https://www.victronenergy.com/blog/2021/02/02/victronconnect-parallel-three-split-phase-setup-and-more/

Supported features and limitations:

• Configure Parallel, Three phase, and Split phase systems (max 3 units).
• Configure existing systems of up to twelve or fifteen units.
• Copy settings from one unit to others.
• Save system configuration to a file.
• Assistants are removed when setting up a new system.
• Firmware updating is proposed automatically when setting up a new VE.Bus system.

Setup Image: Shows three units connected in a daisy chain using RJ45 Cat5 cables, connected to a laptop via an MK3 interface.

Troubleshooting

Bluetooth connection issues

If experiencing Bluetooth connection issues with a laptop and MK3-USB:

1. Ensure the device is powered on.
2. Test the cable with a tester or try another one. Use a straight-through cable, not a cross-over cable.

Testing MK3-USB with a GX device

1. Ensure the GX device runs v2.23 or later.
2. Disconnect the Multi from the GX device's VE.Bus port.
3. Connect the MK3 USB plug to the GX's USB socket.
4. Connect the Multi to the MK3 with a network cable.
5. The Multi should appear on the GX device.

If issues persist, contact your dealer as the MK3 may be faulty.

Bluetooth connection issues

Specific troubleshooting assistance for Bluetooth connections is available [link not provided in original text].

VE.Bus firmware update fails at 5% on macOS

A workaround exists for macOS users experiencing firmware update failures at 5%. Minimize the VictronConnect window when the progress bar appears, then maximize it after about 20 seconds. This issue is related to a power-saving mode affecting serial communication.

Having settings issues and want to start again

Reset the unit to factory settings by updating its firmware via the Settings / Product info screen. This process resets settings to default.

Still having issues?

For further questions, contact your Victron Dealer. You can also seek help from other Victron users at the Victron Community.