modelBaseCellStack
Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance
Extends from Modelica.Electrical.Batteries.Icons.BatteryIcon (Icon for cells and stacks), Modelica.Electrical.Analog.Interfaces.TwoPin (Component with two electrical pins), Modelica.Electrical.Analog.Interfaces.PartialConditionalHeatPort (Partial model to include a conditional HeatPort in order to dissipate losses, used for graphical modeling, i.e., for building models by drag-and-drop).
Information
The battery is modeled by open-circuit voltage (OCV) dependent on state of charge (SOC), a self-discharge component and an inner resistance.
Parameters are collected in parameter record cellData.
All losses are dissipated to the optional heatPort.
For details, see concept and parameterization.
Note
SOC > SOCmax and SOC < SOCmin triggers an error.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | Ns | 1 | Number of serial connected cells |
| Integer | Np | 1 | Number of parallel connected cells |
| ParameterRecords.CellData | cellData | Cell parameters | |
| Boolean | useHeatPort (from PartialConditionalHeatPort) | false | =true, if HeatPort is enabled |
| SI.Temperature | T (from PartialConditionalHeatPort) | 293.15 | Fixed device temperature if useHeatPort = false |
| Advanced | |||
| Real | SOCtolerance | 1e-9 | Tolerance to detect depleted of overcharged battery |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| PositivePin | p (from TwoPin) | Positive electrical pin | |
| NegativePin | n (from TwoPin) | Negative electrical pin | |
| Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a | heatPort (from PartialConditionalHeatPort) | Optional port to which dissipated losses are transported in form of heat |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Real | displaySOC (from BatteryIcon) | SOC for display | |
| SI.Voltage | v (from TwoPin) | Voltage drop of the two pins (= p.v - n.v) | |
| SI.Current | i | p.i | Current into the battery |
| SI.Power | power | v*i | Power to the battery |
| Real | SOC | limIntegrator.y | State of charge |
| Modelica.Electrical.Analog.Sensors.CurrentSensor | currentSensor | ||
| Blocks.Continuous.LimIntegrator | limIntegrator | ||
| Modelica.Blocks.Tables.CombiTable1Ds | ocv_soc | ||
| Modelica.Blocks.Math.Gain | gainV | ||
| Modelica.Electrical.Analog.Sources.SignalVoltage | ocv | ||
| Modelica.Electrical.Analog.Basic.Conductor | selfDischarge | ||
| Modelica.Electrical.Analog.Basic.Resistor | r0 | ||
| Modelica.Thermal.HeatTransfer.Sources.FixedTemperature | fixedTemperature (from PartialConditionalHeatPort) |