FB_ALY_Energy_EP9224

The Energy EP9224 module is suitable for the energy monitoring of EP9224 EtherCAT Box modules. The input data is averaged over a configurable interval and then calculated. To ensure that the required input data is available, it must be added to the process image.

Syntax

Definition:

FUNCTION_BLOCK FB_ALY_Energy_EP9224
VAR_INPUT
    bPersistent: BOOL;
END_VAR
VAR_OUTPUT
    ipResultMessage: Tc3_EventLogger.I_TcMessage;
    bError: BOOL;
    bNewResult: BOOL;
    bConfigured: BOOL;
    fElectricalPower: LREAL;
    fElectricalEnergy: LREAL;
END_VAR

Inputs

Name	Type	Description
bPersistent	BOOL	If the value is `TRUE`, the internal data is stored persistently.

Outputs

Name	Type	Description
ipResultMessage	I_TcMessage	Contains more detailed information on the current return value. For this special interface pointer, it is ensured internally that it is always valid/assigned.
bError	BOOL	The output is `TRUE` if an error occurs.
bNewResult	BOOL	When a new result has been calculated, the output is `TRUE.`
bConfigured	BOOL	Displays `TRUE` when the function block is successfully configured.
fElectricalPower	LREAL	Electrical power in watts.
fElectricalEnergy	LREAL	Electrical energy in watt-hours.

Methods

Name	Definition location	Description
Call()	Local	Method for calculating the outputs for a specific configuration.
Configure()	Local	General configuration of the algorithm with its parameterized conditions.
Reset()	Local	Resets all internal states or the calculations performed so far.
SetChannelValue()	Local	Method for passing values to the algorithm.

Sample

VAR
    fbEnergy : FB_ALY_Energy_EP9224;
    fbSystemTime : FB_ALY_GetSystemTime;
    fSampleRate : LREAL := 1000.0;
    tInterval : LTIME := LTIME#1S;
    bConfigure : BOOL := TRUE;
    nInDeviceVoltageUs : INT;
    nInDeviceCurrentUs : INT;
    nInDeviceVoltageUp : INT;
    nInDeviceCurrentUp : INT;
END_VAR
// Get current system time
fbSystemTime.Call();

// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;

    fbEnergy.Configure(fSampleRate, tInterval);
END_IF

// Call algorithm
fbEnergy.SetChannelValue(1, nInDeviceVoltageUs);
fbEnergy.SetChannelValue(2, nInDeviceCurrentUs);
fbEnergy.SetChannelValue(3, nInDeviceVoltageUp);
fbEnergy.SetChannelValue(4, nInDeviceCurrentUp);
fbEnergy.Call(fbSystemTime.tSystemTime);

Requirements

Development environment	Target platform	Plc libraries to include
TwinCAT v3.1.4024.0	PC or CX (x64, x86)	Tc3_Analytics

Further Information