modelBattery

Simple model of a battery

Extends from Buildings.Electrical.AC.OnePhase.Storage.Battery (Simple model of a battery).

Information

Simple model of a battery.

This model takes as an input the power to be extracted from the AC line and stored in the battery (if P > 0) or to be fed into the AC line after being extracted from the battery. The actual power stored or extracted in the battery differs from P due to AC/DC conversion losses and battery charge and discharge efficiencies.

The output connector SOC is the state of charge of the battery. This model does not enforce that the state of charge is between zero and one. However, each time the state of charge crosses zero or one, a warning will be written to the simulation log file. The model also does not limit the current through the battery. The user should provide a control so that only a reasonable amount of power is exchanged, and that the state of charge remains between zero and one.

Parameters

TypeNameDefaultDescription
Modelica.Units.SI.EfficiencyetaCha (from Battery)0.9Efficiency during charging
Modelica.Units.SI.EfficiencyetaDis (from Battery)0.9Efficiency during discharging
RealSOC_start (from Battery)Initial charge
Modelica.Units.SI.EnergyEMax (from Battery)Maximum available charge
Modelica.Units.SI.VoltageV_nominal (from Battery)Nominal voltage (V_nominal >= 0)
Booleanlinearized (from Battery)falseIf =true introduce a linearization in the load
AC-Conversion
Realpf (from PartialAcDcParameters)0.9Power factor
Realeta_DCAC (from PartialAcDcParameters)0.9Efficiency of DC/AC conversion
Initialization
Buildings.Electrical.Types.InitModeinitMode (from Battery)Buildings.Electrical.Types.InitMode.zero_currentInitialization mode for homotopy operator

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputP (from Battery)Power stored in battery (if positive), or extracted from battery (if negative)
Modelica.Blocks.Interfaces.RealOutputSOC (from Battery)State of charge
Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_pterminal (from Battery)Generalized terminal

Revisions

  • April 2, 2020 by Michael Wetter:
    Corrected model and improved the documentation. The previous model extracted from the AC connector the input power P plus the AC/DC conversion losses, but P should be the power exchanged at the AC connector. Conversion losses are now only accounted for in the energy exchange at the battery.
    This is for issue 1865.
  • September 22, 2014, by Marco Bonvini:
    Added model and documentation