This is an old revision of the document!
The combination of Victron products with BYD Battery-Box LV lithium batteries has been tested and certified by the Victron and BYD R&D departments. This combination has extensive field experience and is actively supported by both companies.
The BYD B-Box includes an integrated Battery Management System (BMS) with each battery cell module, and a Battery Management Unit (BMU) that interfaces with the Victron GX device and supports multiple battery modules.
|Battery||Pro 2.5-10.0||Pro 12.8 & 13.8||L 3.5-14.0|
|Module capacity||2.5 kWh||13.8 kWh||3.5 kWh|
|Max capacity||80 kWh||441.6 kWh||42 kWh|
Victron + BYD B-Box can be used for the following system types:
It is essential to use the CAN-bus connection of a GX device with the BYD batteries for the keep-alive signal, communication of charge and discharge limits, error codes and state of charge.
When used with B-Box batteries, the minimum supported firmware version for the GX device is v2.42. It is highly recommended to use the latest firmware version on all connected devices, including CCGX/VGX, Inverter/Charger and MPPTs. There are regular updates to improve performance and reliability.
The minimum supported firmware version is 469. Updating to the latest firmware is recommended for new installations, and troubleshooting issues.
These inverter/charger units must be connected to the GX device via the VE.Bus connection port.
In grid connected systems, advanced control functions are configurable in the ESS settings on the GX device.
In off-grid systems, the control functions of the BYD Battery Management System (BMS) are built into the latest version of the GX device.
For proper operation, the B-Box battery needs to be able to control the charge current of the solar MPPTs. It is recommended to use the MPPTs with VE.Direct port with BYD batteries.
MPPTs with a VE.Direct port
The MPPT requires connection to the GX device to regulate charge currents as the batteries require (due to temperature, etc) To test operation, try disconnecting the GX device from the MPPT. After a time-out, the MPPT will stop charging and flash an error code on its LEDs. The error code is error #67: no BMS.
MPPTs with a VE.Can port and VE.Direct port
Firmware should be at least version 1.04.
When using VE.Can MPPT's, it is recommended to use the a GX device with a BMS-Can interface as well as the VE.Can interface (eg Cerbo GX, or Venus GX), instead of the CCGX. This allows communication between the MPPTs, BYD and the GX.
Please note that older model VE.Can MPPTs (without VE.direct and with built in screen) are no longer supported with BYD managed batteries.
The following batteries are supported:
|B-BOX LV series type|
|B-BOX Pro 2.5-10.0|
|B-BOX Pro 12.8|
|B-BOX Pro 13.8|
|B-BOX Res 2.5-10.0|
|B-BOX L 3.5-14.0|
BYD also releases firmware update for their BMU and BMS. BMU Firmware versions earlier than V4-13 are not compatible with Victron equipment and can cause the battery to not be detected.
Minimum BYD firmware version: BMU_V2_V4-13_15-Mar-2017.
On-screen, or via Remote Console on the GX device, this version is named v4.13.
Batteries with older firmware versions can be updated. Please contact BYD for more information.
The following information is provided by BYD, it is reproduced here for your convenience and should always be confirmed with the latest BYD manuals and specifications.
Each battery cell is approximately 50Ah at 48V (51.2V nominal).
The following charge rates are managed automatically by the BYD BMU and GX device. Temperature effects on charge rates should be considered in the design stage in hot and cold climates.
Using very large solar arrays with battery banks that are too small can exceed the limits of the batteries ability to charge and possibly lead to the BMU triggering over-current alarms.
The table below shows the minimum number of battery modules required for the specified inverter/charger configuration:
|Phases||Single Phase||Three Phase||Single Phase||Three Phase|
|Quattro 48/10000/140- 100/100||1||5||6||18|
|Quattro 48/15000/200- 100/100||1||6||9||27|
|EasySolar 48/3000/35-50 MPPT150/70||1||3||2||6|
|EasySolar 48/5000/70-100 MPPT150/100||1||3||3||9|
|Phases||Single Phase||Three Phase||Single Phase||Three Phase|
|Quattro 48/10000/140- 100/100||1||2||2||6|
|Quattro 48/15000/200- 100/100||1||3||3||7|
|EasySolar 48/3000/35-50 MPPT150/70||1||1||1||2|
|EasySolar 48/5000/70-100 MPPT150/100||1||1||1||3|
|Phases||Single Phase||Three Phase||Single Phase||Three Phase|
|Quattro 48/10000/140- 100/100||1||4||7||x|
|Quattro 48/15000/200- 100/100||1||5||10||x|
|EasySolar 48/3000/35-50 MPPT150/70||1||2||2||6|
|EasySolar 48/5000/70-100 MPPT150/100||1||2||4||10|
Minimum discharge SOC for 1 single Battery Box L 3.5 is 12%; for 2 or more (7kWh+) it can be 10%.
Up to 4 L modules can be installed per L series BCU; 5 or more will require additional BCU.
Use the VE.Can to CAN-bus BMS type A Cable, part number ASS030710018. Plug the side which is labeled Battery BMS into the BYD BMS. Plug the side labeled Victron VE.Can into the GX device.
Then, plug a VE.Can terminator in the other VE.Can socket on the GX device. Two VE.Can terminators are included with the package of the GX device as an accessory, only one is used. Keep the other one as a spare.
More information about the cable can be found in its manual.
Without properly connecting this cable, the battery will not show up on the display of the GX device. The battery will also turn itself off after several minutes.
It is important to ensure this connection and display of the battery on the GX device display before attempting firmware updates or settings changes on other devices if they depend on the power supply from the battery. Without this connection, the battery may turn off unexpectedly. If a reliable DC power supply is required, you can temporarily disconnect the individual BYD battery cells inside their cabinet from the internal Battery Management Unit (BMU). It is the BMU that signals the battery cells to shut down if the signal from the GX device has not been received. This is a temporary measure, DO NOT attempt to operate the battery cells normally without connection to the BMU.
Using the latest firmware on all devices, the BYD allow to charge contacts are only required when using VE.Can MPPT's. If you have an existing system that is configured using the Allow-to-charge contacts, and it is operating correctly, you do not need to make any changes.
The MPPTs with a VE.Can port have a dedicated Remote On/Off input. It needs to be connected to battery positive to enable the charger. Leaving the Remote On/Off input floating or pulling it to ground will disable the charger.
This section presumes familiarity with VEConfigure software.
In normal operation, the charge parameters are controlled by the BYD BMU and communicated through the system by the GX device to the inverter/charger and MPPT. However as a precaution it is advised to set these as suggested below.
|VEConfigure Charge Parameter||Setting|
|Absorption voltage||55.2 V|
|Float voltage||55 V|
|Absorption time||1 Hr|
Note: make sure to double check the float voltage after completing Assistants, and if necessary set it back to 55 V.
In the Inverter tab of VEConfigure
|VEConfigure Inverter Parameter||Setting|
|DC input low shut-down||47V|
|DC input low restart||51V|
|DC input low pre-alarm*||51V|
* The pre-alarm setting is dependant on your preference and on site specific requirements. You may wish for this to be activated earlier (eg 53V) in an off grid situation to allow time to start a backup generator. If the system is configured in ESS mode, you may not wish to have this alarm trigger until below the Sustain threshold voltage (eg 49V), as this system is in no danger normally and will 'sustain' at 50V without needing to trigger an alarm.
The settings that are specific to the BYD battery in the VEConfigure ESS Assistant are below:
Select the externally managed Lithium battery option
|Dynamic cut-off values||set all values to 47V.|
|Restart offset:||1.2 V (Default)|
On the GX device, go to Settings, System setup:
|Venus Settings → System Setup Parameter||Value|
|Shared Voltage Sense||OFF|
If you have a VE.Can MPPT, it is advised to use the Venus GX in place of the CCGX.
* Select the CAN-bus BMS (500 kbit/s) CAN-profile in the CCGX. Menu path: Settings → Services → CAN-profile.
(if you have multiple batteries a single entry will show up, which represents all batteries).
This parameters page is also a good place to check that all batteries are connected and working properly. In normal working conditions, for the 2.5 model, the charge current limit is ~35-50 A per cell. For example, 140A charge current limit ( 140 / 35 = 4 ) means there are 4 BYD battery cells connected.
Note these limits have been adjusted higher by BYD during firmware updates, so the charge and discharge current limit figure may appear slightly higher.
The CCGX only has one available VE.Can port. It is not possible to connect both CAN products such as VE.Can MPPT (250 kbit/s) and an B-Box battery CAN-bus (500 kbit/s) together on the CCGX. As the BYD Battery MUST be connected, you will need to use the port for that. This will mean no data is collected from the VE.Can MPPT, nor can the CCGX control it. This means you are required to use the “Allow to Charge” wire configuration for the MPPT.
With GX devices that have two CAN-bus interfaces available (eg Cerbo GX and Venus GX), the VE.Can MPPT will remain connected to the VE.Can port, while the BYD CAN-bus cable should use the specific CAN-bus connections (H, L, GND), or BMS-Can ports.
This allows data from the MPPT and BYD battery simultaneously.
The CAN-bus connections are galvanically isolated at the BYD BMU. There is no issues using the non-isolated connection of the VGX.
In normal operation the MPPT charge characteristics are governed by the GX device connected to the BYD battery.
This section presumes familiarity with VictronConnect
The settings below are a precautionary measure.
If the system is not operating correctly, go through these steps.
As a safety precaution, the inverter/charger will not switch on if the GX device is not on. If you are unable to start the system due to a total system blackout / battery shutdown due to low voltage, you may need to disconnect the VE.BUS connection cable between the inverter/charger and GX device.
You can then start the inverter/charger from an external charge source such as a generator or grid connection. Once the inverter/charger has started, it should supply power to the DC terminals and this should start the GX device and BYD battery again. You will need to then reconnect the VE.Bus Communications cable back to the inverter/charger and GX device.
If its not visible, check:
Check the Max Charge Voltage parameter. This voltage parameter is sent, together with the other three parameters, by the BYD system via the CAN-bus cable. They are visible on the GX device: Device List → BYD B-Box battery → Parameters menu.
When ready for use, the Max Charge Voltage will read 56.5 V. In case there is an error in the BYD system (wiring, addressing, or other), it will be 42 V:
Also check that your are seeing the expected 35-40 A of discharge current per installed module.
Locally on-site, you can check the Run LED on the BYD BMU, it needs to be lit up continuously:
A blinking RUN led indicates an error. On the Victron system this is visible as a Max Charge Voltage of 42 V instead of 56.5 V.
Addressing of the battery modules must start at 1, must be continuous and there may not be two modules with the same address. See BYD documentation for details.
In case above doesn't help, and the battery indicates 42V and/or the RUN led is not blinking continuous, please contact BYD support or refer to BYD documentation.
Restarting the BYD system
Restarting the BYD system is always necessary after adding, or removing, battery modules from the system. It may also be necessary to clear some severe error conditions.
To power down a battery module: one by one, push the reset button on the Battery Module for 5 seconds, until the yellow ARM LED flashes. Once releasing the button, the ARM LED will keep blinking for a few more seconds and then all LEDs switch off on the battery module.
Once all battery modules are powered down, the BMU will shut down also: RUN LED is off.
To power up: one by one shortly press the reset button on the battery modules.
It might be that after power up one or modules will light the ARM (Alarm) LED continuously for a short while. Wait for this to auto-correct itself.
In general the ARM LED on the battery module has these meanings:
There is a step by step installation video that demonstrates the essential connections and programming that is required for installation of a BYD battery in a Victron system. It is accessible via the E-Learning section in Victron Professional, and a free Victron Professional Installer Account is required.
This written manual should be assumed to be the more accurate and up-to-date, if there are any discrepancies between the video and the written manual,
A user contributed step by step installation guide is available here. Please be aware that this guide is no longer current. It should not be considered a best practice, but provides further detail and insights from an actual installation.
Each BYD battery module has it’s own BMS. This BMS reports it’s battery information to the BMU which is connected to the GX device and reported to the user and the system.
Each BYD module BMS has a threshold current of 1A (~50W) before it begins to report. For multiple modules, this is additive. So 4 modules could supply a 180W load and report it as 0 W.
This leads to the state of charge reported by the BMU to not accurately match the actual state of charge of the battery.
This limitation also applies to charge currents as well as loads. However it is more common to have low powered loads for long periods of time than low charge currents.
The reported State of Charge will self correct when it reaches the calibration voltage point (55.2v ~ 100% full) or near 10% empty, and this can appear as sudden jumps in the VRM from very little load or charge.
This has no impact on actual usable capacity of battery, only on the how it is reported to the user and other systems (such as alarms or triggers).
If precise state of charge is important, it is possible to install a Victron BMV shunt, and program the GX device to use it for the displayed State of Charge. The limitations of this method are if cells are added, removed or shut down, the BMV will continue to report SoC based on the total Ah of storage set.
You should have alarms and auto-start generators programmed to operate on system voltage as well as state of charge.
System voltage is always reported accurately, and action should be taken once batteries are below 50V for any length of time,
This example below clearly shows the comparison between a BYD BMU (512) and the shunt reading that is reported by the BMV-700 (258).
You can observe a ‘flat’ reading from the BYD during the night, while the BMV continues to read the discharge and report a slowly decreasing state of charge.
The IP55 BYD cabinets are designed to take 4 battery modules and are supplied with 125A circuit breakers. Each battery module is able to supply and receive a continuous 35A, all together a combined 140A. This means it is possible to overload the circuit breaker.
If you have multiple large charge sources, set the DVCC distributed charge current limit to 120A per cabinet to stay under the circuit breaker limit.
If you have a system with multiple cabinets, try to balance the modules evenly between the cabinets to make it less likely to overload the breakers.
Multiple cabinets will also require other circuit protection at the DC bus level.
The BYD cells will limit the charge current allowed at lower temperatures.
|Temperature (Celsius)||Charge Current Limit Per Cell||C rating|
|50 to 13 degrees||35 A||0.7C|
|12 to 3 degrees||6 A||0.12C|
|2 to -7 degrees||3 A||0.06C|
Keep your batteries in a climate controlled environment as close to 20 degrees celsius as possible for best performance. Depending on your climate, consider insulation and reverse cycle air-conditioning to prevent issues in hot and cold weather.
Cells will also heat themselves up when charged and discharged.
There has been a firmware revision for the BYD battery modules and BMU that improves cold weather performance slightly. This manual will be updated with the new (slightly improved) specifications when stock supplied with the new firmware has had sufficient time to enter the market. Contact your BYD distributor for further information about this.
In a correctly configured system, the inverter will shut itself down before the batteries enter a self protective shut down state.
If your system is supplied only with AC-bus solar charging, this may prevent the solar inverter from starting up to recharge the batteries. Therefore it is strongly recommended that there is also either a generator or DC MPPT charge controller to provide DC bus power to bring the inverter back online to allow normal recharging to resume.
Even a single 100/20 48V MPPT charger unit with 2 x 60 cell solar panels would be sufficient to add this self correcting mechanism able to maintain the DC bus voltage and improve longterm system reliability considerably from accidental deep discharge and subsequent shut down.
For information about where to buy or find suitably qualified installers, visit the Where to Buy Page.
Further community discussion about installing and using BYD and Victron can found at Victron Community, use the topic label 'BYD'.