OTCmatrix
One time-constant matrix-based equivalent-circuit model of a battery
Description
Connections
Variables
Basic Parameters
Circuit Parameters
References
The EquivCircuit.OTCmatrix component is an equivalent-circuit model of a generic battery. The open-circuit voltage is interpolated using the state-of-charge (SoC) and the internal temperature from a matrix. The transient response is modeled by an SoC-dependent resistor-capacitor network.
Degradation
The gradual decay, with use, of a cell's capacity and increase of its resistance is modeled by enabling the include degradation effects boolean parameter. Enabling this feature adds a state-of-health (soh) output to the model. This signal is 1 when the cell has no decay and 0 when is completely decayed.
The soh output is given by
soh=1−sRs3
where
s is thickness of the solid-electrolyte interface (SEI),
Rs is radius of the particles of active material in the SEI.
The decay of the capacity is
C=Cmax⁢soh
C is the effective capacity, and
Cmax is the specified capacity equal to either the parameter CA or the input Cin.
The additional series resistance added to a cell is
Rsei=sκ
with κ a parameter of the model.
The following equations govern the increase in the thickness of the SEI layer (s).
k=Ae⁢exp⁡−EaR⁢T
dsdt={k⁢c⁢M1+k⁢sDdiff⁢ρseicharging0otherwise
Thermal Effects
Select the thermal model of the battery from the heat model drop-down list. The available models are: isothermal, external port, and convection.
Isothermal
The isothermal model sets the cell temperature to a constant parameter, Tiso.
External Port
The external port model adds a thermal port to the battery model. The temperature of the heat port is the cell temperature. The parameters mcell and cp become available and are used in the heat equation
mcell⁢cp⁢dTcelldt=Pcell−Qcell
Qflow=ncell⁢Qcell
Pcell=icell⁢vcell−voc
where Pcell is the heat generated in each cell, including chemical reactions and ohmic resistive losses, Qcell is the heat flow out of each cell, and Qflow is the heat flow out of the external port.
Convection
The convection model assumes the heat dissipation from each cell is due to uniform convection from the surface to an ambient temperature. The parameters mcell, cp, Acell, h, and Tamb become available, as does an output signal port that gives the cell temperature in Kelvin. The heat equation is the same as the heat equation for the external port, with Qcell given by
Qcell=h⁢Acell⁢Tcell−Tamb
Capacity
The capacity of a cell can either be a fixed value, CA, or be controlled via an input signal, Cin, if the use capacity input box is checked.
State of Charge
A signal output, soc, gives the state-of-charge of the battery, with 0 being fully discharged and 1 being fully charged.
The parameter SOCmin sets the minimum allowable state-of-charge; if the battery is discharged past this level, the simulation is either terminated and an error message is raised, or, if the allow overdischarge parameter is true, a warning is generated. A similar effect occurs if the battery is fully charged so that the state of charge reaches one; the simulation is terminated unless allow overcharge is true.
The parameter SOC0 assigns the initial state-of charge of the battery.
Name
Type
Modelica ID
p
Electrical
Positive pin
n
Negative pin
soc
Real output
State of charge [0..1]
Cin
Real input
Sets capacity of cell, in ampere hours; available when use capacity input is true
Rin
Sets resistance of cell, in ohms; available when use cell resistance input is true
Units
Tcell
K
Internal temperature of battery
i
A
Current into battery
v
V
Voltage across battery
Default
Ncell
1
Number of cells, connected in series
CA
A·h
Capacity of cell; available when use capacity input is false
C
SOC0
Initial state-of-charge [0..1]
SOCmin
0.02
Minimum allowable state-of-charge
Rcell
0.005
Ω
Fixed cell resistance, if use cell resistance input is false
allow overcharge
false
True allows simulation to continue with 1<SoC
allow_overcharge
allow overdischarge
True allows simulation to continue with SoC<SoCmin
allow_overdischarge
use capacity input
True allows enables the Cin input port
useCapacityInput
use cell resistance input
True allows enables the Rin input port
useResistInput
Voc
interpolation matrix for open-circuit voltage
Rout
interpolation table for series resistance
Rtc
interpolation table for time-constant resistance
Ttc
interpolation table for time-constant duration
A 1D interpolation table is a two-column Matrix. The first column is the state-of-charge, sorted, with low value (0) first. The second column is the corresponding parameter value at that state-of-charge.
[1] Chen, M. and Rincón-Mora, G.A., Accurate electrical battery model capable of predicting runtime and I-V performance, IEEE Transactions of Energy Conversion, Vol. 21, No. 2, 2006.
See Also
Battery Library Overview
Equivalent Circuit Overview
Download Help Document