foxBMS - Unit Tests  1.6.0
The foxBMS Unit Tests API Documentation
murata_ncxxxxh103.c File Reference

Resistive divider used for measuring temperature. More...

#include "murata_ncxxxxh103.h"
#include "fassert.h"
#include "foxmath.h"
#include "temperature_sensor_defs.h"
#include <math.h>
#include <stdbool.h>
#include <stdint.h>
Include dependency graph for murata_ncxxxxh103.c:

Go to the source code of this file.

Macros

#define TS_MURATA_NCXXXXH103_ADC_VOLTAGE_V_MAX_V    ((float_t)((TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V * ts_ncxxxxh103Lut[ts_ncxxxxh103LutSize-1u].resistance_Ohm) / (ts_ncxxxxh103Lut[ts_ncxxxxh103LutSize-1u].resistance_Ohm+TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm)))
 
#define TS_MURATA_NCXXXXH103_ADC_VOLTAGE_V_MIN_V    ((float_t)((TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V * ts_ncxxxxh103Lut[0u].resistance_Ohm) / (ts_ncxxxxh103Lut[0u].resistance_Ohm+TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm)))
 

Functions

int16_t TS_Mur00GetTemperatureFromLut (uint16_t adcVoltage_mV)
 returns temperature based on measured ADC voltage. More...
 
int16_t TS_Mur00GetTemperatureFromPolynomial (uint16_t adcVoltage_mV)
 returns temperature based on measured ADC voltage More...
 

Variables

static const TS_TEMPERATURE_SENSOR_LUT_s ts_ncxxxxh103Lut []
 
static const uint16_t ts_ncxxxxh103LutSize = sizeof(ts_ncxxxxh103Lut) / sizeof(TS_TEMPERATURE_SENSOR_LUT_s)
 

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
2022-10-12 (date of creation)
Updated
2023-10-12 (date of last update)
Version
v1.6.0
Prefix
TS

Definition in file murata_ncxxxxh103.c.

Macro Definition Documentation

◆ TS_MURATA_NCXXXXH103_ADC_VOLTAGE_V_MAX_V

Defines for calculating the ADC voltage on the ends of the operating range. The ADC voltage is calculated with the following formula:

V_adc = ( ( V_supply * R_ntc ) / ( R + R_ntc ) )

Depending on the position of the NTC in the voltage resistor (R_1/R_2), different R_ntc values are used for the calculation.

Definition at line 97 of file murata_ncxxxxh103.c.

◆ TS_MURATA_NCXXXXH103_ADC_VOLTAGE_V_MIN_V

#define TS_MURATA_NCXXXXH103_ADC_VOLTAGE_V_MIN_V    ((float_t)((TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_SUPPLY_VOLTAGE_V * ts_ncxxxxh103Lut[0u].resistance_Ohm) / (ts_ncxxxxh103Lut[0u].resistance_Ohm+TS_MURATA_NCXXXXH103_RESISTOR_DIVIDER_RESISTANCE_R_1_R_2_Ohm)))

Defines for calculating the ADC voltage on the ends of the operating range. The ADC voltage is calculated with the following formula:

V_adc = ( ( V_supply * R_ntc ) / ( R + R_ntc ) )

Depending on the position of the NTC in the voltage resistor (R_1/R_2), different R_ntc values are used for the calculation.

Definition at line 99 of file murata_ncxxxxh103.c.

Function Documentation

◆ TS_Mur00GetTemperatureFromLut()

int16_t TS_Mur00GetTemperatureFromLut ( uint16_t  adcVoltage_mV)

returns temperature based on measured ADC voltage.

Parameters
adcVoltage_mVvoltage in mV
Returns
corresponding temperature in deci °C or INT16_MAX/INT16_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 115 of file murata_ncxxxxh103.c.

Here is the call graph for this function:

◆ TS_Mur00GetTemperatureFromPolynomial()

int16_t TS_Mur00GetTemperatureFromPolynomial ( uint16_t  adcVoltage_mV)

returns temperature based on measured ADC voltage

Parameters
adcVoltage_mVvoltage in mV
Returns
corresponding temperature in deci °C

Definition at line 166 of file murata_ncxxxxh103.c.

Variable Documentation

◆ ts_ncxxxxh103Lut

const TS_TEMPERATURE_SENSOR_LUT_s ts_ncxxxxh103Lut[]
static
Initial value:
= {
{-400, 195652.0f}, {-350, 148171.0f}, {-300, 113347.0f}, {-250, 87559.0f}, {-200, 68237.0f}, {-150, 53650.0f},
{-100, 42506.0f}, {-50, 33892.0f}, {0, 27219.0f}, {50, 22021.0f}, {100, 17926.0f}, {150, 14674.0f},
{200, 12081.0f}, {250, 10000.0f}, {300, 8315.0f}, {350, 6948.0f}, {400, 5834.0f}, {450, 4917.0f},
{500, 4161.0f}, {550, 3535.0f}, {600, 3014.0f}, {650, 2586.0f}, {700, 2228.0f}, {750, 1925.0f},
{800, 1669.0f}, {850, 1452.0f}, {900, 1268.0f}, {950, 1110.0f}, {1000, 974.0f}, {1050, 858.0f},
{1100, 758.0f}, {1150, 672.0f}, {1200, 596.0f}, {1250, 531.0f}, {1300, 474.0f}, {1350, 424.0f},
{1400, 381.0f}, {1450, 342.0f}, {1500, 309.0f},
}

LUT filled from higher resistance to lower resistance - datasheet: RO3E - Aug. 3, 2018

Definition at line 71 of file murata_ncxxxxh103.c.

◆ ts_ncxxxxh103LutSize

const uint16_t ts_ncxxxxh103LutSize = sizeof(ts_ncxxxxh103Lut) / sizeof(TS_TEMPERATURE_SENSOR_LUT_s)
static

size of the ts_ntcle317e4103sbaLut LUT

Definition at line 82 of file murata_ncxxxxh103.c.