SystemPowerBasic - Functional Description

Overview

Type:

Function block

Available as of:

V2.0.3.0

Functional Description

The function block SystemPowerBasic returns power information and resets the power registers of the system avatar.

Interface

Input

Data type

Description

iq_TeSysIslandRef

FB_TeSys_island

Reference to the TeSys island device.

i_xExecute

BOOL

Upon a rising edge of this input, the function block starts the execution. The outputs q_xDone, q_xError, q_etResult, and q_etResultMsg are reset with the falling edge of i_xExecute. Refer to Behavior of Function Blocks with the Input i_xExecute.

i_xResetMaxActivePower

BOOL

If this input is set to TRUE, the value of the parameter q_udiMaxActivePower and the associated time stamp q_stMaxActivePowerTimestamp are reset.

i_xResetMaxReactivePower

BOOL

If this input is set to TRUE, the value of the parameter q_udiMaxReactivePower and the associated time stamp q_stMaxReactivePowerTimestamp are reset.

i_xResetMinPowerFactor

BOOL

If this input is set to TRUE:

  • The value of the parameter q_usiMinPowerFactor is set to 1.

  • The associated time stamp q_stMinPowerFactorTimestamp is updated.

i_xResetMaxPowerFactor

BOOL

If this input is set to TRUE:

  • The value of the parameter q_usiMaxPowerFactor is set to 0.

  • The associated time stamp q_stMaxPowerFactorTimestamp is updated.

Output

Data type

Description

q_xError

BOOL

If this output is set to TRUE, an error has been detected. For details, refer to q_etResult and q_etResultMsg.

q_etResult

ET_Result

Provides diagnostic and status information as a numeric value.

q_sResultMsg

STRING[30]

Provides additional diagnostic and status information as a text message.

q_xBusy

BOOL

If this output is set to TRUE, the function block execution is in progress.

q_xDone

BOOL

If this output is set to TRUE, the execution has been completed successfully.

q_udiInstActivePower

UDINT

Total active power for the avatar.

(Unit: W)

q_udiMaxActivePower

UDINT

Maximum value of the active power for the avatar.

(Unit: W)

q_stMaxActivePowerTimestamp

SysTimeRtc.RTS_SYSTIMEDATE

Date and time when the maximum active power value was recorded.

Refer to the SysTimeRtc library.

q_udiInstReactivePower

UDINT

Total reactive power for the avatar.

(Unit: VAR)

q_udiMaxReactivePower

UDINT

Maximum value of the reactive power for the avatar.

(Unit: VAR)

q_stMaxReactivePowerTimestamp

SysTimeRtc.RTS_SYSTIMEDATE

Date and time when the maximum reactive power value was recorded.

Refer to the SysTimeRtc library.

q_usiPowerFactor

USINT

Power factor value.

q_usiMinPowerFactor

USINT

Minimum power factor value.

q_usiMaxPowerFactor

USINT

Maximum power factor value.

q_stMinPowerFactorTimestamp

SysTimeRtc.RTS_SYSTIMEDATE

Date and time when the minimum power factor value was recorded.

Refer to the SysTimeRtc library.

q_stMaxPowerFactorTimestamp

SysTimeRtc.RTS_SYSTIMEDATE

Date and time when the maximum power factor value was recorded.

Refer to the SysTimeRtc library.