Anwendungshinweis

e!COCKPIT

WagoAppPowerPlantControl
a2019015

1.0.1

Public
2 e!COCKPIT
a2019015 WagoAppPowerPlantControl

© 2021 WAGO GmbH & Co. KG

All rights reserved.

WAGO GmbH & Co. KG

Hansastrasse 27
D-32423 Minden

Phone: +49 (0) 571/8 87 – 0

Fax: +49 (0) 571/8 87 – 1 69

Email: [email protected]

Online: www.wago.com

Technical Support

Phone: +49 (0) 571/8 87 – 4 45 55

Fax: +49 (0) 571/8 87 – 84 45 55

Email: [email protected]

Every conceivable measure has been taken to ensure the accuracy and
completeness of this documentation. However, as errors can never be fully
excluded, we always appreciate any information or suggestions for improving the
documentation.

Email: [email protected]

We wish to point out that the software and hardware names, as well as the
trademarks of companies used and/or mentioned in the present manual, are
generally protected by trademark or patent.

WAGO is a registered trademark of WAGO Verwaltungsgesellschaft mbH.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Table of Contents 3
a2019015 WagoAppPowerPlantControl

Table of Contents
1 Notes about this Documentation ............................................................. 4
1.1 Copyright ................................................................................................ 4
1.2 Symbols ................................................................................................. 4
1.3 Number Notation .................................................................................... 6
1.4 Font Conventions ................................................................................... 6
1.5 Legal Bases............................................................................................ 7
1.5.1 Subject to Changes ............................................................................ 7
1.5.2 Personnel Qualification ...................................................................... 7
1.5.3 Limitation of Liability ........................................................................... 7
1.6 Revision History...................................................................................... 8
2 Application Examples ............................................................................... 9
2.1 WagoApp_v1.***_PowerPlantControl_Example_01 .............................. 10
2.1.1 Components Used ........................................................................... 11
2.1.2 Structure .......................................................................................... 11
2.1.3 Starting the Simulation ..................................................................... 12
2.1.3.1 Power Plant Control..................................................................... 13
2.2 WagoApp_v1.***_PowerPlantControl_Example_02 .............................. 15
2.2.1 Components Used ........................................................................... 15
2.2.2 Structure .......................................................................................... 16
2.2.3 Sample Program .............................................................................. 17
2.2.3.1 Application Overview ................................................................... 17
2.2.4 Grid Information ............................................................................... 18
2.2.4.1 prgWagoApp494 ......................................................................... 18
2.2.5 Telecontrol Interface: prgWagoAppRTU........................................... 18
2.2.6 18
2.2.7 Controller Function: prgPowerPlantControl ...................................... 19
2.2.8 The “FbPowerPlantControl” Function Block ..................................... 20
2.2.9 The Configuration Parameters ......................................................... 21
2.3 Visualization ......................................................................................... 22
2.3.1 Global Configuration ........................................................................ 22
2.3.2 Configuration of the Active Power Functions .................................... 23
2.3.3 Configuration of Reactive Power Functions...................................... 25
List of Figures .................................................................................................. 30
List of Tables .................................................................................................... 31

Anwendungshinweis
1.0.1
Public
4 Notes about this Documentation e!COCKPIT
a2019015 WagoAppPowerPlantControl

1 Notes about this Documentation

1.1 Copyright
This Manual, including all figures and illustrations, is copyright-protected. Any
further use of this Manual by third parties that violate pertinent copyright
provisions is prohibited. Reproduction, translation, electronic and phototechnical
filing/archiving (e.g., photocopying) as well as any amendments require the
written consent of WAGO GmbH & Co. KG, Minden, Germany. Non-observance
will involve the right to assert damage claims.

1.2 Symbols

Personal Injury!
Indicates a high-risk, imminently hazardous situation which, if not avoided, will
result in death or serious injury.

Personal Injury Caused by Electric Current!

Indicates a high-risk, imminently hazardous situation which, if not avoided, will
result in death or serious injury.

Personal Injury!
Indicates a moderate-risk, potentially hazardous situation which, if not avoided,
could result in death or serious injury.

Personal Injury!
Indicates a low-risk, potentially hazardous situation which, if not avoided, may
result in minor or moderate injury.

Damage to Property!
Indicates a potentially hazardous situation which, if not avoided, may result in
damage to property.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Notes about this Documentation 5
a2019015 WagoAppPowerPlantControl

Damage to Property Caused by Electrostatic Discharge (ESD)!

Indicates a potentially hazardous situation which, if not avoided, may result in
damage to property.

Important Note!
Indicates a potential malfunction which, if not avoided, however, will not result in
damage to property.

Additional Information:
Refers to additional information which is not an integral part of this
documentation (e.g., the Internet).

Anwendungshinweis
1.0.1
Public
6 Notes about this Documentation e!COCKPIT
a2019015 WagoAppPowerPlantControl

1.3 Number Notation

Table 1: Number Notation
Number Example Comment
Notation
Decimal 100 Normal notation
Hexadecimal 0x64 C notation
Binary '100' In single quotes,
'0110.0100' nibble separated by a period

1.4 Font Conventions

Table 2: Font Conventions
Font Meaning
Type
italic Names of paths and files are shown in italics; e.g.:
C:\Programs\WAGO Software
Menu Menu options are shown in bold, e.g.:
Save
> A “greater than” symbol between two names denotes the selection
of a menu option, e.g.:
File > New
Input Names of input or selection fields are shown in bold, e.g.:
Start of measurement range
“Value” Input or selection values are shown in quotation marks, e.g.:
Enter the value “4 mA” under Start of measurement range.
[Button] Button labels within the dialogs are shown in bold and enclosed in
square brackets, e.g.:
[Input]
[Key] Key labels on the keyboard are shown in bold and enclosed in
square brackets, e.g.:
[F5]

Anwendungshinweis
1.0.1
Public
e!COCKPIT Notes about this Documentation 7
a2019015 WagoAppPowerPlantControl

1.5 Legal Bases

1.5.1 Subject to Changes
Die WAGO GmbH & Co. KG reserves the right to make alterations or
modifications. WAGO GmbH & Co. KG owns all rights arising from the granting of
patents or from the legal protection of utility patents. Third-party products are
always mentioned without any reference to patent rights. Thus, the existence of
such rights cannot be excluded.

1.5.2 Personnel Qualification

The use of the product described in this document is exclusively geared to
specialists having qualifications in PLC programming, electrical specialists or
persons instructed by electrical specialists who are also familiar with the
applicable current standards.

Moreover, the persons named here must also be familiar with all of the products
cited in this document, along with the operating instructions. They must also be
capable of correctly predicting any hazards which may not arise until the products
are combined.

WAGO GmbH & Co. KG assumes no liability resulting from improper action and
damage to WAGO products and third-party products due to non-observance of
the information contained in this document.

1.5.3 Limitation of Liability

This documentation describes the use of various hardware and software
components in specific example applications. The components may be products
or parts of products from different manufacturers. The respective operating
instructions from the manufacturers apply exclusively with regard to intended and
safe use of the products. The manufacturers of the respective products are solely
responsible for the contents of these instructions.

The sample applications described in this documentation represent concepts,

that is, technically feasible applications. Whether these concepts can actually be
implemented depends on various general conditions. For example, different
versions of the hardware or software components may require different handling
than that described here. Therefore, the descriptions contained in this
documentation do not form the basis for assertion of a particular product
characteristic.

Responsibility for safe use of a specific software or hardware configuration lies

with the party that produces or operates the configuration. This also applies if one
of the concepts described in this document was used for implementation of the
configuration.

WAGO GmbH & Co. KG assumes no liability for the realization of these
concepts.

Anwendungshinweis
1.0.1
Public
8 Notes about this Documentation e!COCKPIT
a2019015 WagoAppPowerPlantControl

1.6 Revision History

Table 3: Revision History
Version Author Change
1.0.0 u0100662 Initial draft
1.0.1 u018088 Modification of the company name

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 9
a2019015 WagoAppPowerPlantControl

2 Application Examples
Note Installation of Sample Projects for e!COCKPIT

Figure 1: e!COCKPIT Sample Projects

Sample programs can be opened from the e!COCKPIT Backstage

view by clicking the Updates & Add-ons button in the navigation
bar.

This application note presents the sample projects for the

“WagoAppPowerPlantControl” library. The projects are intended to introduce the
functionality of the power plant controller and help you get started with your own
projects.

Anwendungshinweis
1.0.1
Public
10 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.1 WagoApp_v1.***_PowerPlantControl_Example_01
This example is a minimal project that requires no hardware and is designed to
be simulated in the e!COCKPIT development environment.

During the simulation, the individual functions of the power plant controller
function block can be tested. To allow visualization of the controller behavior,
traces are prepared in which the signals (setpoint, actual value and controller)
are recorded.

In the program, an FbPowerPlantControl instance is created that controls the

active and reactive power of an adjustable control process (power plant/grid).
Two control loops are illustrated below.

Information Function description

A detailed description of the power plant controller functions can be found
in the documentation for the WagoAppPowerPlantControl library.

Figure 2: Power Plant Controller: Active Power Control Loop

Figure 3: Power Plant Controller: Reactive Power Control Loop

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 11
a2019015 WagoAppPowerPlantControl

2.1.1 Components Used

Table 4: Required Devices, Materials and Libraries
Device/Material/Library Description
WagoAppPowerPlantControl Library with certified Power Plant Controller
2759-203 / 211-1000 License for using the
WagoAppPowerPlantControl library in an
application on a controller
e!COCKPIT Development environment
2759-101 / 1110-2002 Workstation license for the development
environment
2.1.2 Structure

Figure 4: Example_01 Project Structure

The entire application sequence takes place within the prgPowerPlantControl

program. This consists of both the power plant controller instance and the two
control loops for active and reactive power.
The configuration structures are found in the Persistent Variable List (PVL). The
parameters used for the setpoints and actual values can be found in the Global
Variable List (GVL).

The two traces are used to record and display the active1 and reactive2 power
control. This allows the behavior of the power plant controller to be verified for
different settings and situations.

1 Active power, symbol P

2 Reactive power, symbol Q
Anwendungshinweis
1.0.1
Public
12 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.1.3 Starting the Simulation

Clicking the Program > [Simulate Application] button prepares and loads the
simulation.

Figure 5: “Simulate Application” Button

After that, it is still necessary to start the application by clicking [Start].

Figure 6: Starting the Simulation

You should now see that the symbolical representation of the controller and the
feedback symbol to the left of the prgPowerPlantControl program have changed
to green.

The functions of the power plant controller can now be tested.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 13
a2019015 WagoAppPowerPlantControl

2.1.3.1 Power Plant Control

First, the power plant controller must be enabled. This is done by setting the
variable g_xPPC_Enable from the GVL to “TRUE.” Until this is enabled, the
controller performs no control functions.

Figure 7: Enabling the Power Plant Controller

For a trace to be used, it first needs to be loaded. To do this, open the

corresponding trace by double-clicking it, and then transfer it via Trace >
Execute > [Download Trace].

Figure 8: Download Trace

The trace then starts recording automatically.

If the functions to be tested are configured correctly in the PVL, the scenarios can
be executed by adjusting the corresponding parameters in the GVL. The result of
the parameter changes can be observed in the trace.

Anwendungshinweis
1.0.1
Public
14 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

Figure 9: Trace View

In the above trace, an active power setpoint change from 0.5 pu to 0.75 pu was
recorded.

The setpoint is shown in red, the actual values in blue and the controller value in
green. The blue value in the upper diagram is the time progression of the internal
setpoint. The blue value in the lower diagram represents the time progression of
the current active power.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 15
a2019015 WagoAppPowerPlantControl

2.2 WagoApp_v1.***_PowerPlantControl_Example_02
2.2.1 Components Used
Table 5: Required Devices, Materials and Libraries
Device/Material/Library Description
WagoAppPowerPlantControl Library with certified Power Plant Controller
2759-203 / 211-1000 License for using the
WagoAppPowerPlantControl library in an
application on a controller
750-8212 2nd Generation WAGO 2nd Generation PFC200 Controller
PFC200
750-402 4-Channel Digital Input; 24 VDC; 3 ms
750-555 4-Channel Analog Output; 4 … 20 mA
750-494/025-001 3-Phase Power Measurement Module; 480 VAC;
5A
750-600 End Module
2857-570/024-005 (optional) 3-Phase Power Measurement Module;
AC 3x400/690 5 A; Modbus RTU
e!COCKPIT Development environment
2759-101 / 1110-2002 Workstation license for the development
environment

Anwendungshinweis
1.0.1
Public
16 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.2.2 Structure
The hardware used is a second generation PFC200 with telecontrol technology.

Figure 10: Node Image

Note WagoAppPowerPlantControl requires license!

To use an application that uses the WagoAppPowerPlantControl library, a
license is required for each controller after a 30 day evaluation period.

The grid information, such as voltage, frequency and active/reactive power, can
be acquired in different ways. The most common way is with the 3-phase
measurement module (750-494 or 750-495) or by coupling an external
measuring device, e.g. via Modbus.

The application note uses a 750-494 3-phase measurement module.

The setpoint specifications, as well as function switchovers, are implemented via

the IEC60870-5-104 telecontrol interface. Here the controller acts as a server, so
a control center can connect, for example. In addition, a ripple control device can
be connected via a digital input module in order to adjust the active power
setpoint specification.
In the event of failure of the telecontrol interface, the system switches to a
defined behavior.

The output setpoints from the Power Plant Control function block (power plant
controller) are output via an analog output module.

The Power Plant Control function block configuration can be imported or

exported. The internal RecipeManager is used for this purpose.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 17
a2019015 WagoAppPowerPlantControl

2.2.3 Sample Program

In this application example, it is possible to switch between the 3-phase
measurement module on the local bus and an external 3-phase power
measurement module as the source of the grid information.

A ripple control device, which may be present in some situations, is connected

via the digital inputs of the DI terminal. The resulting setpoint is used as Ptarget2 in
the program. Ptarget1 is specified by a control system via the IEC60870-5-104
telecontrol interface.

2.2.3.1 Application Overview

The application is divided into the following parts:

- prgPowerPlantControl – power plant controller

- prgWagoApp494 – processing of the 3-phase measurement

module

- prgWagoAppRTU – processing of the telecontrol interface

- Visualization

The four parts of the application are assigned to their own tasks, so they are
decoupled from each other. Parameters are passed between the individual parts
via globally defined variables.

The application contains a visualization, which serves as the HMI.3 It can be used
to parameterize the configuration, among other things.

Figure 11: Example_02 Project Structure

3
HMI = Human Machine Interface: interface for users to display information, make
settings and/or control the application
Anwendungshinweis
1.0.1
Public
18 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.2.4 Grid Information

The grid information is provided by the 3-phase power measurement module.

2.2.4.1 prgWagoApp494

In this program, the required voltage and frequency parameters and the power
values are retrieved from the 3-phase measurement module. According to the
description in the module manual, this is done by a function block from the Wago
WagoAppPowerMeasurement library.

The grid parameters are provided as variables with global scope.

2.2.5 Telecontrol Interface: prgWagoAppRTU

The telecontrol interface processing occurs in this program. This program was
generated automatically by the development environment on the basis of the
telecontrol configurator. The parameters defined in this way are automatically
provided in the global variable list GVWagoAppRTU, which is also created
automatically.

Note Changes in the prgWagoAppRTU program or the GVWagoAppRTU

GVL
If manual modifications are made in the parts that are generated
automatically, these modifications may be lost when the application is
compiled, since these parts may be regenerated automatically during the
compilation process.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 19
a2019015 WagoAppPowerPlantControl

2.2.6 Controller Function: prgPowerPlantControl

This program part uses methods to delimit the additional functions needed in
order to use the Power Plant Control function block.

Figure 12: “prgPowerPlantControl” Program Structure

First the _updGridInfo() method is called. In this method, the grid information is
updated.

Then the _updRequest() method is called. This updates the setpoint

specifications of the ripple control device and the telecontrol interface. In addition,
the error bit of the telecontrol communication is also generated here. Next the
Power Plant Control function block is executed.

Then the Power Plant Control function block is executed to update the control on
the basis of the new values.

Finally, the outputs are set according to the setpoint specifications by calling the
_updOutput() method.

Anwendungshinweis
1.0.1
Public
20 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.2.7 The “FbPowerPlantControl” Function Block

Figure 13: “FbPowerPlantControl” Function Block

Information Parameter Description

The description of the individual parameters of the function block is part of
the library.
This information can be viewed via the library manager in the sample
project.

This function block is the certified function block that must be used as the basic
component for creating your own power plant controller application.

Note Update time

To meet all the requirements of the standards, a specific task cycle time
and minimum update rate of the inputs and outputs must be ensured.

The exact requirements can be found in the library documentation.

This is available for download from www.wago.com

In addition to the current grid information such as voltage, frequency and active
and reactive power, as well as the setpoints, a configuration is also required. This
structure should always be created with a default configuration.

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 21
a2019015 WagoAppPowerPlantControl

2.2.8 The Configuration Parameters

The FbPowerPlantControl function block is configured via the structured
parameter typConfigParameters. An instance of the structure of type
typPPC_Settings from the WagoAppPowerPlantControl library must be
connected to this input.

Note Default configuration

The configuration instance should always be declared with a default
configuration suitable for the application.

Note Import/export configuration

The recipe manager provides a quick and easy way to import and export
the configuration.

In the application example, the corresponding instance has been defined in the
persistent area to ensure a consistent configuration.

Information Declare configuration instance with default values

A detailed description can be found in the documentation of the
WagoAppPowerPlantControl library.

There is also a corresponding section in the library itself under: 10

Documentation -> doc20_ExamplePowerPlantControl.

Anwendungshinweis
1.0.1
Public
22 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

2.3 Visualization
The visualization in Application Note 02 mainly uses the visualization templates
provided in the “WagoAppPowerPlantControl” library.

2.3.1 Global Configuration

Figure 14: Global Configuration of the Power Plant Control Function Block

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 23
a2019015 WagoAppPowerPlantControl

2.3.2 Configuration of the Active Power Functions

Figure 15: Active Power PID Controller

Figure 16: Active Power Setpoint Configuration

Anwendungshinweis
1.0.1
Public
24 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

Figure 17: Active Power Gradient Configuration after Voltage Recovery

Figure 18: Configuration of the Active Power Adjustment Based on Mains Frequency

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 25
a2019015 WagoAppPowerPlantControl

2.3.3 Configuration of Reactive Power Functions

Figure 19: Reactive Power Function and PID Controller Configuration

Figure 20: Configuration of the Control According to Reactive Power/Voltage Characteristic

Anwendungshinweis
1.0.1
Public
26 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

Figure 21: Configuration of the Control According to Reactive Power/Active Power Characteristic

Figure 22: Configuration of the Control According to the Reactive Power/Voltage Characteristic with
Limiting Function

Anwendungshinweis
1.0.1
Public
e!COCKPIT Application Examples 27
a2019015 WagoAppPowerPlantControl

Figure 23: Configuration of the cos(φ) Control

Figure 24: Configuration of the Reactive Power Setpoint Specification

Anwendungshinweis
1.0.1
Public
28 Application Examples e!COCKPIT
a2019015 WagoAppPowerPlantControl

Figure 25: Configuration of the Slave Mode of the Reactive Power Control Function

Anwendungshinweis
1.0.1
Public
e!COCKPIT List of Figures 29
a2019015 WagoAppPowerPlantControl

Anwendungshinweis
1.0.1
Public
30 List of Figures e!COCKPIT
a2019015 WagoAppPowerPlantControl

List of Figures
Figure 1: e!COCKPIT Sample Projects ............................................................... 9
Figure 2: Power Plant Controller: Active Power Control Loop .............................10
Figure 3: Power Plant Controller: Reactive Power Control Loop .........................10
Figure 4: Example_01 Project Structure .............................................................11
Figure 5: “Simulate Application” Button ..............................................................12
Figure 6: Starting the Simulation ........................................................................12
Figure 7: Enabling the Power Plant Controller ....................................................13
Figure 8: Download Trace ..................................................................................13
Figure 9: Trace View ..........................................................................................14
Figure 10: Node Image.......................................................................................16
Figure 11: Example_02 Project Structure ...........................................................17
Figure 12: “prgPowerPlantControl” Program Structure .......................................19
Figure 13: “FbPowerPlantControl” Function Block ..............................................20
Figure 14: Global Configuration of the Power Plant Control Function Block .......22
Figure 15: Active Power PID Controller ..............................................................23
Figure 16: Active Power Setpoint Configuration .................................................23
Figure 17: Active Power Gradient Configuration after Voltage Recovery ............24
Figure 18: Configuration of the Active Power Adjustment Based on Mains
Frequency .................................................................................................24
Figure 19: Reactive Power Function and PID Controller Configuration ...............25
Figure 20: Configuration of the Control According to Reactive Power/Voltage
Characteristic ............................................................................................25
Figure 21: Configuration of the Control According to Reactive Power/Active
Power Characteristic .................................................................................26
Figure 22: Configuration of the Control According to the Reactive Power/Voltage
Characteristic with Limiting Function .........................................................26
Figure 23: Configuration of the cos(φ) Control....................................................27
Figure 24: Configuration of the Reactive Power Setpoint Specification ..............27
Figure 25: Configuration of the Slave Mode of the Reactive Power Control
Function ....................................................................................................28

Anwendungshinweis
1.0.1
Public
e!COCKPIT List of Tables 31
a2019015 WagoAppPowerPlantControl

List of Tables
Table 1: Number Notation ................................................................................... 6
Table 2: Font Conventions .................................................................................. 6
Table 3: Revision History .................................................................................... 8
Table 4: Required Devices, Materials and Libraries ...........................................11
Table 5: Required Devices, Materials and Libraries ...........................................15

Anwendungshinweis
1.0.1
Public
WAGO GmbH & Co. KG
Postfach 2880 • D-32385 Minden
Hansastraße 27 • D-32423 Minden
Phone: 0571/887 – 0
Fax: 0571/887 – 844169
Email: [email protected]
Internet: www.wago.com

Public