# Battery Temperature Monitoring

Monitor for battery temperature

Since R2022b

Libraries:
Simscape / Battery / BMS / Protection

## Description

The Battery Temperature Monitoring block monitors the temperature of a battery. Temperature protection is necessary in electrical circuits. A battery that is exposed to extremely high or extremely low temperatures can enter a dangerously unstable state.

You can switch between continuous and discrete implementations of the block by using the Sample time (-1 for inherited) parameter. To configure the block for continuous time, set the Sample time (-1 for inherited) parameter to 0. To configure the block for discrete time, set the Sample time (-1 for inherited) parameter to a positive, nonzero value, or to -1 to inherit the sample time from an upstream block.

This diagram illustrates the overall structure of the block:

### Equations

This block computes the undertemperature symptom with this equation:

$Undertemperature\text{\hspace{0.17em}}Symptom=min\left(Temperature\right)\le \text{\hspace{0.17em}}UndertemperatureLimit$

This block computes the overtemperature symptom with this equation:

$Overtemperature\text{\hspace{0.17em}}Symptom=\mathrm{max}\left(Temperature\right)\ge \text{\hspace{0.17em}}OvertemperatureLimit$

The Battery Temperature Monitoring block then passes the undertermperature and overtemperature symptoms to a Fault Qualification block, which qualifies the error.

## Ports

### Input

expand all

Temperature of the battery cell, specified as a scalar for a single cell or a vector for multiple cells.

### Output

expand all

Indication of an undertemperature error. If this output is equal to 1, the battery is in an undertemperature state.

Indication of an overtemperature error. If this output is equal to 1, the battery is in an overtemperature state.

## Parameters

expand all

Temperature limit under which the battery is in an undertemperature state.

Temperature limit over which the battery is in an undertemperature state. The value of this parameter must be greater than the value of the Undertemperature limit parameter.

Time required to qualify the undertemperature error, in seconds.

Time required to disqualify the undertemperature error, in seconds. If you set this parameter to 0, the block does not disqualify the error.

Time required to qualify the overtemperature error, in seconds.

Time required to disqualify the overtemperature error, in seconds. If you set this parameter to 0, the block does not disqualify the error.

Time between consecutive block executions. During execution, the block produces outputs and, if appropriate, updates its internal state. For more information, see What Is Sample Time? and Specify Sample Time.

For inherited discrete-time operation, specify this parameter as -1. For discrete-time operation, specify this parameter as a positive integer. For continuous-time operation, specify this parameter as 0.

If this block is in a masked subsystem or a variant subsystem that allows you to switch between continuous operation and discrete operation, promote the sample time parameter. Promoting the sample time parameter ensures correct switching between the continuous and discrete implementations of the block. For more information, see Promote Block Parameters on a Mask.

## Version History

Introduced in R2022b