Generic battery
Description and demonstration of the capabilities of the Generic Battery component.
Introduction
The use of microgrids has been steadily increasing over the last few years, and so has been the need to model and test their control systems. In short, the microgrid field is currently on the rise, accompanied by a growing need for more efficient microgrid components.
- different operation modes (e.g. PQ control, Droop, and VF control),
- limitations based on the nominal parameters, and
- fault detection.
This application note describes the main characteristics of a battery inverter and presents a use case typical for generic components.
Model description
The model consists of a Battery EES (Generic) connected to the Grid with corresponding UI components and a passive load that can be connected or disconnected.
Unlike common microgrid components where you need to define all inputs and outputs, generic components have a user interface where all the inputs and outputs necessary for the operation of the General Battery are already defined. Because this block is unlocked, there is also a possibility for adding additional, user-specific functionalities and improvements such as communication interfaces or optimization logic. In addition to the usual inputs and outputs set by the power management system, there are also external inputs related to system specific factors. In this case, the external input is the initial State Of Charge (SOC).
Simulation
This application comes with a pre-built SCADA panel shown in Figure 4. It offers the most essential user interface elements (widgets) to monitor and interact with the simulation at runtime, allowing you to further customize it according to your needs.
- grid following
- droop
- isochronous
Figure 4. SCADA_panel
- Disabled – the state when the inverter is turned off and the main circuit breaker is open.
- Starting up - the state of the converter between the moment of enabling signal activation and the moment when the converter starts operating, e.g. the synchronization time.
- Running state – the state when the inverter is operating.
- Fault state – the state when a fault is detected. If the inverter is in the error state, in order to start the plant again, it is necessary to reset the alarm.
In isochronous mode, voltage and frequency are set directly, as in Figure 7.

- Over-current protection - when some of the input phase currents are 1.5 times over the maximum allowed instantaneous current
- Grid voltage out of range - when the grid voltage is outside the specified relative range [0.5, 1.5] pu. This protection is active in grid-following mode
- Grid frequency out of range - when the grid frequency is outside the specific relative range [0.5, 1.5] pu. This protection is active in grid-following mode
- Over-power protection - when the measured apparent power is more than 1.2 times greater than the maximum allowed apparent power. This protection is active in grid-forming mode.
- SOC at critical level - If the SOC is higher than Max SOC + 2% or lower than Min SOC - 2% this fault will be generated.

Files | |
---|---|
Typhoon HIL files |
examples\models\microgrid\energy_storage\ simple_battery_ess(generic)
examples\models\microgrid\energy_storage\ simple_battery_ess(generic) \ simple_battery_ess _gen.tse
SCADA_panel.cus, etc. |
Minimum hardware requirements | |
No. of HIL devices | 1 |
HIL device model | HIL402 |
Device configuration | 1 |
Test automation
We don’t have a test automation for this example yet. Let us know if you wish to contribute and we will gladly have you signed on the application note!
Authors
[1] Jovana Markovic