Battery Voltage Monitoring

Monitor for battery voltage

Since R2022b

Libraries:
Simscape / Battery / BMS / Protection

Description

The Battery Voltage Monitoring block monitors the voltage of a battery. Voltage protection is necessary in electrical circuits. A battery that is exposed to extremely high or extremely low voltages 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 shows the structure of the block:

Equations

This block computes the undervoltage symptom with this equation:

$U n d e r v o l t a g e S y m p t o m = m i n (C e l l V o l t a g e) \leq U n d e r v o l t a g e L i m i t$

This block computes the overvoltage symptom with this equation:

$O v e r v o l t a g e S y m p t o m = \max (C e l l V o l t a g e) \geq O v e r v o l t a g e L i m i t$

This block computes the faulty sensor symptom with this equation:

$F a u l t y S e n s o r S y m p t o m = | P a c k V o l t a g e - \sum_{i - 1}^{n} C e l l V o l t a g e^{i} | \geq F a u l t y S e n s o r T h r e s h o l d$

The check on the sum of the cell voltages assumes that all the cells are in series.

The Battery Voltage Monitoring block then passes these symptoms to a Fault Qualification block, which qualifies the errors.

Examples

Battery Monitoring

Use battery management system blocks to monitor the current and temperature of a battery. A random current and temperature profile is applied to the battery which is then simulated for 6 hours.

Open Model

Ports

Input

expand all

CellVoltage — Cell voltage
scalar | vector

Cell voltage, in volt, specified as a scalar for a single cell or a vector for multiple cells.

PackVoltage — Battery pack voltage
scalar

Battery pack voltage, in volt, specified as a scalar.

Output

expand all

UndervoltageError — Indication of undervoltage error
`0` | `1`

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

OvervoltageError — Indication of overvoltage error
`0` | `1`

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

SensoryFaultyError — Indication of sensor faulty error
`0` | `1`

Indication of a sensor faulty error. If this output is equal to 1, the sensor is faulty.

Parameters

expand all

Undervoltage limit (V) — Undervoltage limit
`2.5` (default) | positive scalar

Voltage limit under which the battery is in an undervoltage state, in volt.

Overvoltage limit (V) — Overvoltage limit
`4.5` (default) | positive scalar

Voltage limit over which the battery is in an overvoltage state, in volt. The value of this parameter must be greater than the value of the Undervoltage limit (V) parameter.

Voltage sensor fault threshold (V) — Threshold for voltage sensor fault
`0.25` (default) | positive scalar

Voltage threshold over which the sensor is faulty, in volt.

Qualification time undervoltage (s) — Undervoltage qualification time
`2` (default) | positive scalar

Time required to qualify the undervoltage error, in seconds.

Disqualification time undervoltage (s) — Undervoltage disqualification time
`0` (default) | nonnegative scalar

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

Qualification time overvoltage (s) — Overvoltage qualification time
`2` (default) | positive scalar

Time required to qualify the overvoltage error, in seconds.

Disqualification time overvoltage (s) — Overvoltage disqualification time
`0` (default) | nonnegative scalar

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

Qualification time faulty sensor (s) — Faulty sensor qualification time
`2` (default) | positive scalar

Time required to qualify the faulty sensor error, in seconds.

Disqualification time faulty sensor (s) — Faulty sensor disqualification time
`0` (default) | nonnegative scalar

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

Sample time (-1 for inherited) — Block sample time
`-1` (default) | 0 | positive integer

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.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2022b

Battery Voltage Monitoring

Description

Equations

Examples

Battery Monitoring

Ports

Input

CellVoltage — Cell voltage scalar | vector

PackVoltage — Battery pack voltage scalar

Output

UndervoltageError — Indication of undervoltage error 0 | 1

OvervoltageError — Indication of overvoltage error 0 | 1

SensoryFaultyError — Indication of sensor faulty error 0 | 1

Parameters

Undervoltage limit (V) — Undervoltage limit 2.5 (default) | positive scalar

Overvoltage limit (V) — Overvoltage limit 4.5 (default) | positive scalar

Voltage sensor fault threshold (V) — Threshold for voltage sensor fault 0.25 (default) | positive scalar

Qualification time undervoltage (s) — Undervoltage qualification time 2 (default) | positive scalar

Disqualification time undervoltage (s) — Undervoltage disqualification time 0 (default) | nonnegative scalar

Qualification time overvoltage (s) — Overvoltage qualification time 2 (default) | positive scalar

Disqualification time overvoltage (s) — Overvoltage disqualification time 0 (default) | nonnegative scalar

Qualification time faulty sensor (s) — Faulty sensor qualification time 2 (default) | positive scalar

Disqualification time faulty sensor (s) — Faulty sensor disqualification time 0 (default) | nonnegative scalar

Sample time (-1 for inherited) — Block sample time -1 (default) | 0 | positive integer

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using Simulink® Coder™.

Version History

See Also

CellVoltage — Cell voltage
scalar | vector

PackVoltage — Battery pack voltage
scalar

UndervoltageError — Indication of undervoltage error
`0` | `1`

OvervoltageError — Indication of overvoltage error
`0` | `1`

SensoryFaultyError — Indication of sensor faulty error
`0` | `1`

Undervoltage limit (V) — Undervoltage limit
`2.5` (default) | positive scalar

Overvoltage limit (V) — Overvoltage limit
`4.5` (default) | positive scalar

Voltage sensor fault threshold (V) — Threshold for voltage sensor fault
`0.25` (default) | positive scalar

Qualification time undervoltage (s) — Undervoltage qualification time
`2` (default) | positive scalar

Disqualification time undervoltage (s) — Undervoltage disqualification time
`0` (default) | nonnegative scalar

Qualification time overvoltage (s) — Overvoltage qualification time
`2` (default) | positive scalar

Disqualification time overvoltage (s) — Overvoltage disqualification time
`0` (default) | nonnegative scalar

Qualification time faulty sensor (s) — Faulty sensor qualification time
`2` (default) | positive scalar

Disqualification time faulty sensor (s) — Faulty sensor disqualification time
`0` (default) | nonnegative scalar

Sample time (-1 for inherited) — Block sample time
`-1` (default) | 0 | positive integer

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.