Name

Type

Description

Modelica ID

$p$

Electrical

Positive pin

p

$n$

Electrical

Negative pin

n

$\mathrm{soc}$

Real output

State of charge [0..1]

soc

$C_{\mathrm{in}}$

Real input

Sets capacity of cell, in ampere hours; available when use capacity input is true

Cin

$R_{\mathrm{in}}$

Real input

Sets resistance of cell, in ohms; available when use cell resistance input is true

Rin

Name

Units

Description

Modelica ID

$T_{\mathrm{cell}}$

$K$

Internal temperature of battery

Tcell

$i$

$A$

Current into battery

i

$v$

$V$

Voltage across battery

v

Name

Default

Units

Description

Modelica ID

$N_{\mathrm{cell}}$

$1$

Number of cells, connected in series

Ncell

$\mathrm{CA}$

$1$

$\mathrm{A\·h}$

Capacity of cell; available when use capacity input is false

C

${\mathrm{SOC}}_0$

$1$

Initial state-of-charge [0..1]

SOC0

${\mathrm{SOC}}_{\min }$

$0.02$

Minimum allowable state-of-charge

SOCmin

$R_{\mathrm{cell}}$

$0.005$

$\mathrm{\Omega }$

Fixed cell resistance, if use cell resistance input is false

Rcell

allow overcharge

false

True allows simulation to continue with $1<\mathrm{SoC}$

allow_overcharge

allow overdischarge

false

True allows simulation to continue with $\mathrm{SoC}<{\mathrm{SoC}}_{\min }$

allow_overdischarge

use capacity input

false

True allows enables the $C_{\mathrm{in}}$ input port

useCapacityInput

use cell resistance input

false

True allows enables the $R_{\mathrm{in}}$ input port

useResistInput

Name

Default

Units

Description

Modelica ID

$T_{\mathrm{iso}}$

$298.15$

$K$

Constant cell temperature; used with isothermal heat model

Tiso

$c_p$

$750$

$\frac{J}{\mathrm{kg}K}$

Specific heat capacity of cell

cp

$m_{\mathrm{cell}}$

$0.014$

$\mathrm{kg}$

Mass of one cell

mcell

$h$

$100$

$\frac{W}{m^{2}K}$

Surface coefficient of heat transfer; used with convection heat model

h

$A_{\mathrm{cell}}$

$0.0014$

$m^2$

Surface area of one cell; used with convection heat model

Acell

$T_{\mathrm{amb}}$

$298.15$

$K$

Ambient temperature; used with convection heat model

Tamb

Name

Units

Description

Modelica ID

Use temperature

True means use the 2D table

VocUseTemp

Data Source

Selects whether the table is inline, an attachment, or a file

VocDataSource

Data

Name of file or attachment

VocData

Table 1D

Inline 1D interpolation table

VocTable1D

Table 2D

Inline 2D interpolation table

VocTable2D

Column

Specifies data column; used with 1D attachment/file

VocColumn

Skip rows

Specifies rows to skip; used with 1D attachment/file

VocSkipRows

Name

Default

Units

Description

Modelica ID

$R_{\mathrm{out}}$

$\mathrm{\Omega }$

1D interpolation table for series resistance

Rout

$R_{\mathrm{tc1}}$

$\mathrm{\Omega }$

1D interpolation table for short time-constant resistance

Rtc1

$T_{\mathrm{tc1}}$

$s$

1D interpolation table for short time-constant duration

Ttc1

$R_{\mathrm{tc2}}$

$\mathrm{\Omega }$

1D interpolation table for long time-constant resistance

Rtc2

$T_{\mathrm{tc2}}$

$s$

1D interpolation table for long time-constant duration

Ttc2