This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Datasheet Battery

Lithium-ion, lithium-polymer, or lead-acid battery

  • Library:
  • Powertrain Blockset / Energy Storage and Auxiliary Drive / Datasheet Battery

Description

The Datasheet Battery block implements a lithium-ion, lithium-polymer, or lead-acid battery that you can parameterize using manufacturer data. To create the open-circuit voltage and internal resistance parameters that you need for the block, use the manufacturer discharge characteristics by temperature data. For an example, see Generate Parameter Data for Datasheet Battery Block.

To determine the battery output voltage, the block uses lookup tables for the battery open-circuit voltage and the internal resistance. The lookup tables are functions of the state-of charge (SOC) and battery temperature, characterizing the battery performance at various operating points:

Em=f(SOC)Rint=f(T,SOC)

To calculate the voltage, the block implements these equations.

VT=EmIbattRintIbatt=IinNpVout=NsVTSOC=1Capbatt0tIbattdt

Positive current indicates battery discharge. Negative current indicates battery charge.

The equations use these variables.

SOC

State-of-charge

Em

Battery open-circuit voltage

Ibatt

Per module battery current

Iin

Combined current flowing from the battery network

Rint

Battery internal resistance

Ns

Number of cells in series

Np

Number of cells in parallel

Vout

Combined voltage of the battery network

VT

Per module battery voltage

Capbatt

Battery capacity

Ports

Inputs

expand all

Rated battery capacity at the nominal temperature, Capbatt, in Ah.

Dependencies

To create this port, select External Input for the Initial battery capacity parameter.

Combined current flowing from the battery network, Iin, in A.

Temperature measured at the battery housing, T, in K.

Output

expand all

Bus signal containing these block calculations.

SignalDescriptionUnits

BattCurr

Combined current flowing from the battery network

A

BattAmpHr

Normalized current flowing from the battery network

A*h

BattSoc

State-of-charge capacity

NA

BattVolt

Combined voltage of the battery network

V

BattPwr

Battery power

W

Combined voltage of the battery network, Vout, in V.

Parameters

expand all

Block Options

Initial battery capacity, Capbatt, in Ah.

Dependencies

Block Parameter Initial battery capacity Option

Creates

External Input

Input port CapInit
ParameterParameter Initial battery capacity, BattCapInit

Select Filtered to apply a first-order filter to the output batter voltage.

Dependencies

Setting Output battery voltage parameter to Filtered creates these parameters:

  • Output battery voltage time constant, Tc

  • Output battery voltage initial value, Vinit

Rated battery capacity at the nominal temperature, in Ah.

Open-circuit voltage data curve, Em, as a function of the discharged capacity for P operating points, in V.

Discharge capacity breakpoints for P operating points, dimensionless.

Although this parameter is the same as the Battery capacity breakpoints 2, CapSOCBp parameter, the block uses unique parameters for calibration flexibility.

Internal resistance map, Rint, as a function of N temperatures and M SOCs, in ohms.

Battery temperature breakpoints for N temperatures, in K.

Battery capacity breakpoints for M SOCs, dimensionless.

Although this parameter is the same as the Open circuit voltage breakpoints 1, CapLUTBp parameter, the block uses unique parameters for calibration flexibility.

Number of cells in series, dimensionless, Ns.

Number of cells in parallel, dimensionless, Np.

Initial battery capacity, Capbatt, in Ah.

Dependencies

Block Parameter Initial battery capacity Option

Creates

External Input

Input port CapInit
ParameterParameter Initial battery capacity, BattCapInit

Output battery voltage time constant, Tc, in s. Used in a first-order voltage filter.

Dependencies

Setting Output battery voltage parameter to Filtered creates these parameters:

  • Output battery voltage time constant, Tc

  • Output battery voltage initial value, Vinit

Output battery voltage initial value, Vinit, in V. Used in a first-order voltage filter.

Dependencies

Setting Output battery voltage parameter to Filtered creates these parameters:

  • Output battery voltage time constant, Tc

  • Output battery voltage initial value, Vinit

References

[1] Arrhenius, S.A. “Über die Dissociationswärme und den Einflusß der Temperatur auf den Dissociationsgrad der Elektrolyte.” Journal of Physical Chemistry. 4 (1889): 96–116.

[2] Connors, K. Chemical Kinetics. New York: VCH Publishers, 1990.

[3] Ji, Yan, Yancheng Zhang, and Chao-Yang Wang. Journal of the Electrochemical Society. Volume 160, Issue 4 (2013), A636-A649.

Introduced in R2017a