Table of Contents

PowerMeasurementEL3403

Namespace
ZEquipmentBeckhoff
Implements
FUNCTION_BLOCK ABSTRACT PowerMeasurementEL3403 IMPLEMENTS ZEquipmentBeckhoff.IPowerMeasurement, ZCore.IObject, ZCore.IError

Properties

Busy 

PROPERTY Busy : BOOL

If the object is in busy or booting state (often mentioned as "the object is busy"), this is indicated by this property returning TRUE. A falling edge on the return of this property indicates that the execution is finished, either with or without error (indicated by Error

Property Value

BOOL

Done 

PROPERTY Done : BOOL

If the object is in idle state (often mentioned as "the object is not busy and not on error"), this is indicated by this property returning TRUE. A rising edge on the return of this property indicates that the execution has started or an error occured (indicated by Error

The property is a shortcut for testing NOT Error AND_THEN NOT Busy.

Property Value

BOOL

Error 

PROPERTY Error : BOOL

This property returns TRUE if a fault occured within a sequence or the initialization phase of an object, respectively. If this property returns TRUE, one of the errorMessage methods give insight about the origin of the fault.

It is also possible to distinguish between initialization errors and sequence errors by checking the exact, internal state of the object using the state method.

Property Value

BOOL

Methods

ActivePower 

METHOD ActivePower (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the active power value for each phase as LREAL in Watt. These values are delivered cyclically by the EL34x3-xxxx terminals and is refreshed every time a new Ethercat frame arrives at its master

Outputs

l1 LREAL

active power in Watt for phase L1

l2 LREAL

active power in Watt for phase L2

l3 LREAL

active power in Watt for phase L3

Returns

LREAL

ApparentPower 

METHOD ApparentPower (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the apparent power value for each phase as LREAL in Watt. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the apparent power value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

apparent power value for phase L1 in Watt

l2 LREAL

apparent power value for phase L2 in Watt

l3 LREAL

apparent power value for phase L3 in Watt

Returns

LREAL

CosPhi 

METHOD CosPhi (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the active factor Cos(phi) for each phase as LREAL value between 0 and 1. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the active factor value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

active factor as Cosine(phi) for phase L1 between 0 and 1

l2 LREAL

active factor as Cosine(phi) for phase L2 between 0 and 1

l3 LREAL

active factor as Cosine(phi) for phase L3 between 0 and 1

Returns

LREAL

Current 

METHOD Current (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the actual current value for each phase as LREAL in Ampere. These values are delivered cyclically by the EL34x3-xxxx terminals and is refreshed every time a new Ethercat frame arrives at its master However, the overall precision depends on actual used current probes and the wiring scheme of your application. For more details please refer to the documentation of your applied terminal

Outputs

l1 LREAL

actual current for phase L1 in Ampere

l2 LREAL

actual current for phase L2 in Ampere

l3 LREAL

actual current for phase L3 in Ampere

Returns

LREAL

Energy 

METHOD Energy (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the energy sum for each phase as LREAL in Watthours. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the energy sum value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

energy sum for phase L1 in Watthours

l2 LREAL

energy sum for phase L2 in Watthours

l3 LREAL

energy sum for phase L3 in Watthours

Returns

LREAL

EnergyNegative 

METHOD EnergyNegative (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the negative energy sum for each phase as LREAL in Watthours. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the negative energy sum value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

negative energy sum for phase L1 in Watthours

l2 LREAL

negative energy sum for phase L2 in Watthours

l3 LREAL

negative energy sum for phase L3 in Watthours

Returns

LREAL

ErrorId 

METHOD ErrorId () : UDINT

Returns the error code of the first error source for this object. The method recursively goes down the error stack until the initial source of error of this object can be found. For performance reasons, the error stack is not cleared when the error state is reset. So this method should always used in conjunction with Error.

Returns

UDINT

ErrorMessage 

METHOD ErrorMessage () : ZCore.ZString

Returns the error description of the first error source for this object. The method recursively goes down the error stack until the initial source of error of this object can be found. For performance reasons, the error stack is not cleared when the error state is reset. So this method should always used in conjunction with Error.

Returns

ZString

ErrorSource 

METHOD ErrorSource () : ZCore.IError

this method returns the direct error source of this object. This method can then be used to retrieve the actual error source by using the method of the returned IError.

Returns

IError

Frequency 

METHOD Frequency (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL)

This method returns the frequency for each phase as LREAL in Hertz. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the frequency value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

frequency for phase L1 in Hertz

l2 LREAL

frequency for phase L2 in Hertz

l3 LREAL

frequency for phase L3 in Hertz

ReactivePower 

METHOD ReactivePower (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the reactive power value for each phase as LREAL in Watt. These values are returned through the variant value feature of the EL34x3-xxxx terminals and is therefore only delivered every cycle when the index is set with the enumeration PowerMeasurementEL34x3VariantValueType to the reactive power value. If this index gets changed every cycle it is not possible to get this value cyclically.

Outputs

l1 LREAL

reactive power for phase L1 in Watt

l2 LREAL

reactive power for phase L2 in Watt

l3 LREAL

reactive power for phase L3 in Watt

Returns

LREAL

SetName 

METHOD SetName (
 [input] name : ZCore.ZString)

this method sets the name for the actuator and, if set, the IDigitals that are used by the actuator.

Inputs

name ZString

SetTransformationRatio 

METHOD SetTransformationRatio (
 [input] voltage : LREAL,
 [input] current : LREAL)

Inputs

voltage LREAL

defaults to 1

current LREAL

defaults to 1

TraceErrorStack 

METHOD TraceErrorStack (
 [input] trace : ZCore.IErrorTrace)

This method is used internally when recording an error trace.

Inputs

trace IErrorTrace

Voltage 

METHOD Voltage (
 [output] l1 : LREAL,
 [output] l2 : LREAL,
 [output] l3 : LREAL) : LREAL

This method returns the actual voltage value for each phase as LREAL in Volt. These values are delivered cyclically by the EL34x3-xxxx terminals and is refreshed every time a new Ethercat frame arrives at its master However, the overall precision of these values depends on the actual used current probes and the wiring scheme of your application. For more details please refer to the documentation of your applied terminal

Outputs

l1 LREAL

actual voltage for phase L1 in Volt

l2 LREAL

actual voltage for phase L2 in Volt

l3 LREAL

actual voltage for phase L3 in Volt

Returns

LREAL