Cell voltage limitation
In folder /driver/balancing you can find cell voltages.
More about protection and limitation
Protection
Undervoltage:
If the voltage of the cell with the lowest voltage is below the cellMinVoltage parameter, the BMS will turn off both ports and enter UNDERVOLTAGE state. If you connect the charger and turn the ports on, the BMS will allow it.
Overvoltage:
If the voltage of the cell with the highest voltage is above the cellMaxVoltage parameter, the BMS will turn off the CHG port and enter OVERVOLTAGE state.
If the current is flowing into the DSC port, the BMS does not have the ability to stop the current. (The current will flow through diodes inside MOSFETS)
If the ports are turned off due to the UV/OV limitation, the BMS will enter PROTECT state.
Limitation configuration
Limitation parameters are located in the /driver/balancing/limiter folder.
| Parameter | Description |
|---|---|
cellMaxVoltage | Maximum voltage for the cell. If the cell voltage is above this value, the BMS will enter OVERVOLTAGE state. |
cellMinVoltage | Minimum voltage for the cell. If the cell voltage is below this value, the BMS will enter UNDERVOLTAGE state. |
cellMaxMargin | Recuperation is disabled |
cellMaxDec | Recuperation is reduced |
cellMinMargin | Discharge is disabled |
cellMinDec | Discharge is reduced |
uv_hyst | Hysteresis for leaving the undervoltage state |
ov_hyst | Hysteresis for leaving the overvoltage state |
CritUnderVoltage | Critical undervoltage: If the cell voltage is below this value, the BMS will enter ERROR state. (and immediatelly sleep) |
- First, configure the
cellMaxVoltageandcellMinVoltageparameters, after that tune the limitation parameters