EditRealVisu

EditRealVisu (FB)

FUNCTION_BLOCK EditRealVisu

Short description

Input of a numeric value with input limits (visualization) Typical application: Entering a target temperature in the visualization Special feature: Min/Max inputs, unit, decimal places and other parameters are configured directly in the CFC editor and not in the visualization object. This allows changes and limits to be modified online in the application without download.

Representation

Interfaces

Outputs

Name	Data type	Value range	Initial value	Function
rOut	REAL			Numeric output value

Setpoints / parameters

Name	Data type	Value range	Initial value	Function
xDisableSeparator	BOOL		FALSE	TRUE = Disables the thousands separator in the visualization display
bDecimals	BYTE		1	Number of decimal places
sDialogTitle	STRING			Dialog title of the input value
sUnit	STRING			Unit of the input value
rMaxInputVisu	REAL		100.0	Upper input limit of the input value
rMinInputVisu	REAL		0.0	Lower input limit of the input value
rSetPoint	REAL		0.0	Numeric input value

Function description

General

This function block is used to pass a numeric input value rSetPoint and to directly transfer it to the numeric output value rOut. Additionally, further properties of the input value can be defined here, which are not used in the function block itself but, for example, in a suitable visualization element. Thus the number of decimal places bDecimals, the title of the input value sDialogTitle, the unit of the input value sUnit as well as the input limit values rMinInputVisu and rMaxInputVisu can be passed to the visualization element and taken into account during input. With the parameter xDisableSeparator the thousands separator in the visualization can be disabled.

Behavior on power failure

All setpoints / parameters are stored fail-safe and automatically restored.

Visualization

Matching visualization element from the HVACV Visu Library: EditRealVisu

Representation

Interfaces Visu-Element

Name	Data type	Type	Initial value	Function
rValue	FB_EditRealVisu	VAR_IN_OUT		Enter FB instance HVAC.EditRealVisu here e.g. PRG.EditRealVisu
iFieldSizeL	INT	VAR_INPUT	0	Field expands by the number of entered pixels to the left. Required to display long numbers or units.
iFieldSizeR	INT	VAR_INPUT	0	Field expands by the number of entered pixels to the right. Required to display long numbers or units.

The following inputs of the FB HVAC.EditRealVisu are automatically adopted and can be changed at runtime: rMinInputVisu, rMaxInputVisu, sUnit, sDialogTitle, bDecimals, xDisableSeperator

Note: VAR_IN_OUT interfaces must be assigned, VAR_INPUT are optional.

CODESYS

InOut:

Scope	Name	Type	Initial
Input Const	xDisableSeparator	BOOL
Input Const	bDecimals	BYTE	1
Input Const	sDialogTitle	STRING
Input Const	sUnit	STRING
Input Const	rMaxInputVisu	REAL	100
Input Const	rMinInputVisu	REAL	0
Input Const	rSetPoint	REAL	0
Output	rOut	REAL