![]() |
foxBMS
1.5.1
The foxBMS Battery Management System API Documentation
|
Configuration of the battery cell (e.g., minimum and maximum cell voltage) More...
#include <stdint.h>
Go to the source code of this file.
Configuration of the battery cell (e.g., minimum and maximum cell voltage)
SPDX-License-Identifier: BSD-3-Clause
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
We kindly request you to use one or more of the following phrases to refer to foxBMS in your hardware, software, documentation or advertising materials:
This files contains basic macros of the battery cell in order to derive needed inputs in other parts of the software. These macros are all depended on the hardware.
Definition in file panasonic_ncr18650bd.h.
#define BC_CAPACITY_mAh (3180u) |
the cell capacity used for SOC calculation, in this case Ah counting
Definition at line 199 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_CHARGE_MOL_mA (45000u) |
the different strings
Definition at line 191 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_CHARGE_MSL_mA (50000u) |
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.
Definition at line 189 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_CHARGE_RSL_mA (47500u) |
current reduced by 4,54 A because of imbalances between
Definition at line 190 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_DISCHARGE_MOL_mA (500000u) |
the different strings
Definition at line 177 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_DISCHARGE_MSL_mA (550000u) |
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.
Definition at line 175 of file panasonic_ncr18650bd.h.
#define BC_CURRENT_MAX_DISCHARGE_RSL_mA (525000u) |
current reduced by 50 A because of imbalances between
Definition at line 176 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_CHARGE_MOL_ddegC (350) |
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.
Definition at line 105 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_CHARGE_MSL_ddegC (450) |
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.
Definition at line 103 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_CHARGE_RSL_ddegC (400) |
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.
Definition at line 104 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_DISCHARGE_MOL_ddegC (500) |
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.
Definition at line 77 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_DISCHARGE_MSL_ddegC (600) |
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.
Definition at line 75 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MAX_DISCHARGE_RSL_ddegC (550) |
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.
Definition at line 76 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_CHARGE_MOL_ddegC (150) |
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.
Definition at line 119 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_CHARGE_MSL_ddegC (100) |
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.
Definition at line 117 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_CHARGE_RSL_ddegC (120) |
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.
Definition at line 118 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_DISCHARGE_MOL_ddegC (-150) |
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.
Definition at line 91 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_DISCHARGE_MSL_ddegC (-200) |
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.
Definition at line 89 of file panasonic_ncr18650bd.h.
#define BC_TEMPERATURE_MIN_DISCHARGE_RSL_ddegC (-180) |
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.
Definition at line 90 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_DEEP_DISCHARGE_mV (BC_VOLTAGE_MIN_MSL_mV - 100u) |
Deep-discharge cell voltage limit. If this voltage limit is violated, the cell is faulty. The BMS won't allow a closing of the contactors until this cell is replaced. a replacement of the cell is confirmed by sending the respective CAN debug message
Definition at line 164 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MAX_MOL_mV (4100u) |
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.
Definition at line 133 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MAX_MSL_mV (4200u) |
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.
Definition at line 131 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MAX_RSL_mV (4150u) |
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.
Definition at line 132 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MIN_MOL_mV (2600u) |
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.
Definition at line 153 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MIN_MSL_mV (2500u) |
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.
Definition at line 151 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_MIN_RSL_mV (2550u) |
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.
Definition at line 152 of file panasonic_ncr18650bd.h.
#define BC_VOLTAGE_NOMINAL_mV (3600u) |
nominal cell voltage according to data sheet
Definition at line 141 of file panasonic_ncr18650bd.h.