The foxBMS secondary mcu API documentation
BATTERYCELL User configuration

Macros

#define BC_TEMPMAX_DISCHARGE_MSL   55
 
#define BC_TEMPMIN_DISCHARGE_MSL   -20 /* °C */
 
#define BC_TEMPMAX_CHARGE_MSL   45
 
#define BC_TEMPMIN_CHARGE_MSL   -20
 
#define BC_VOLTMAX_MSL   2650
 
#define BC_VOLT_NOMINAL   2500
 
#define BC_VOLTMIN_MSL   1700
 
#define BC_CURRENTMAX_DISCHARGE_MSL   180000
 
#define BC_CURRENTMAX_CHARGE_MSL   180000
 

Detailed Description

Contains the configuration settings of the battery cell, e.g. current, voltage and temperature limits.

Macro Definition Documentation

◆ BC_CURRENTMAX_CHARGE_MSL

#define BC_CURRENTMAX_CHARGE_MSL   180000

Maximum charge current limit. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
mA
Default:
180000

◆ BC_CURRENTMAX_DISCHARGE_MSL

#define BC_CURRENTMAX_DISCHARGE_MSL   180000

Maximum discharge current limit. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
mA
Default:
180000

◆ BC_TEMPMAX_CHARGE_MSL

#define BC_TEMPMAX_CHARGE_MSL   45

Maximum temperature limit during charge. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
°C
Default:
45

◆ BC_TEMPMAX_DISCHARGE_MSL

#define BC_TEMPMAX_DISCHARGE_MSL   55

Maximum temperature limit during discharge. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
°C
Default:
55

◆ BC_TEMPMIN_CHARGE_MSL

#define BC_TEMPMIN_CHARGE_MSL   -20

Minimum temperature limit during discharge. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
°C
Default:
0

◆ BC_TEMPMIN_DISCHARGE_MSL

#define BC_TEMPMIN_DISCHARGE_MSL   -20 /* °C */

Minimum temperature limit during discharge. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
°C
Default:
-20

◆ BC_VOLT_NOMINAL

#define BC_VOLT_NOMINAL   2500

nominal cell voltage according to datasheet

Type:
int
Unit:
mV
Default:
2500

◆ BC_VOLTMAX_MSL

#define BC_VOLTMAX_MSL   2650

Maximum cell voltage limit. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
mV
Default:
2800

◆ BC_VOLTMIN_MSL

#define BC_VOLTMIN_MSL   1700

Minimum cell voltage limit. When maximum safety limit (MSL) is violated, error state is requested and contactors will open. When recommended safety limit (RSL) or maximum operating limit (MOL) is violated, the respective flag will be set.

Type:
int
Unit:
mV
Default:
1700