foxBMS  1.1.1
The foxBMS Battery Management System API Documentation
beta.h File Reference

Resistive divider used for measuring temperature. More...

#include "general.h"
Include dependency graph for beta.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define BETA_POSITION_IN_RESISTOR_DIVIDER_IS_R_1   (false)
 
#define BETA_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V   (4.096f)
 
#define BETA_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm   (10000.0f)
 
#define BETA_T_REF_C   (25.0f)
 
#define BETA_R_REF_Ohm   (10000.0f)
 
#define BETA_BETACOEFFICIENT   (3984.0f)
 

Functions

int16_t BETA_GetTemperatureFromBeta (uint16_t adcVoltage_mV)
 returns temperature based on measured ADC voltage More...
 
int16_t BETA_TemperatureFromResistance (float resistance_Ohm)
 returns temperature corresponding to NTC resistance More...
 
float BETA_ResistanceFromTemperature (int16_t temperature_ddegC)
 returns NTC resistance corresponding to temperature, used to compute Vmin and Vmax of the divider More...
 

Detailed Description

Resistive divider used for measuring temperature.

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:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

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 product uses parts of foxBMS®″
  • ″This product includes parts of foxBMS®″
  • ″This product is derived from foxBMS®″
Author
foxBMS Team
Date
2020-01-17 (date of creation)
Updated
2021-02-24 (date of last update)
Prefix
BETA
     V_supply
       --.--
         |
       +-.-+
       |   |
       |   |  R_1
       |   |
       +-.-+
         |
         .--- V_adc
         |
       +-.-+
       |   |
       |   |  R_2
       |   |
       +-.-+
         |
       --.--
        GND

Definition in file beta.h.

Macro Definition Documentation

◆ BETA_BETACOEFFICIENT

#define BETA_BETACOEFFICIENT   (3984.0f)

BEta coefficient of the NTC

Definition at line 107 of file beta.h.

◆ BETA_POSITION_IN_RESISTOR_DIVIDER_IS_R_1

#define BETA_POSITION_IN_RESISTOR_DIVIDER_IS_R_1   (false)

Position of the NTC in the voltage resistor true: NTC is positioned above the voltage tap for the ADC voltage. This equals resistor R_1 in the above circuit diagram

false: NTC is positioned below the voltage tap for the ADC voltage. This equals resistor R2 in the above circuit diagram

Definition at line 89 of file beta.h.

◆ BETA_R_REF_Ohm

#define BETA_R_REF_Ohm   (10000.0f)

NTC resistance at reference temperature

Definition at line 104 of file beta.h.

◆ BETA_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm

#define BETA_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm   (10000.0f)

Resistance value of the other resistor (not the NTC) in the resistor divider in kOhm.

Definition at line 98 of file beta.h.

◆ BETA_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V

#define BETA_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V   (4.096f)

Resistor divider supply voltage in volt

Definition at line 92 of file beta.h.

◆ BETA_T_REF_C

#define BETA_T_REF_C   (25.0f)

Reference temperature

Definition at line 101 of file beta.h.

Function Documentation

◆ BETA_GetTemperatureFromBeta()

int16_t BETA_GetTemperatureFromBeta ( uint16_t  adcVoltage_mV)

returns temperature based on measured ADC voltage

Parameters
adcVoltage_mVvoltage in mV
Returns
corresponding temperature in deci °C or FLT_MAX/FLT_MIN if NTC is shorted or got disconnected. The caller of this functions needs to check for these return values to prevent invalid data.

Definition at line 95 of file beta.c.

Here is the call graph for this function:

◆ BETA_ResistanceFromTemperature()

float BETA_ResistanceFromTemperature ( int16_t  temperature_ddegC)

returns NTC resistance corresponding to temperature, used to compute Vmin and Vmax of the divider

Parameters
temperature_ddegCin deci °C
Returns
corresponding resistance in Ohm

Definition at line 140 of file beta.c.

◆ BETA_TemperatureFromResistance()

int16_t BETA_TemperatureFromResistance ( float  resistance_Ohm)

returns temperature corresponding to NTC resistance

Parameters
resistance_Ohmresistance in Ohm
Returns
corresponding temperature in deci °C

Definition at line 126 of file beta.c.