ValveTherm

ValveTherm (FB)

FUNCTION_BLOCK ValveTherm

Short description

Control of a thermal actuator with anti-blocking function Typical application: valve actuator on the radiator

Representation

Interfaces

Inputs

Name	Data type	Value range	Initial value	Function
xY	BOOL			Request
xForce	BOOL		FALSE	Forced override after manual override
xAlarmIn	BOOL		FALSE	Actuator fault message
eAOO	HVACTYPES.eManBin	HVACTYPES.eManBin.Auto, HVACTYPES.eManBin.ManOff, HVACTYPES.eManBin.ManOn	HVACTYPES.eManBin.Auto	Operating mode of manual override - hardware

Outputs

Name	Data type	Value range	Initial value	Function
xHB	BOOL			Release after manual override
xAB	BOOL			Release before manual override
xEnergyRequest	BOOL			Request - energy generation
dtAbsLastOn	DATE_AND_TIME			Date / time of the last anti-blocking operation
xAuto	BOOL			Collective automatic mode message

Setpoints / parameters

Name	Data type	Value range	Initial value	Function
udiAbsTime	UDINT	0 … 600s	200s	Duration of anti-blocking operation in seconds
todAbsStartTime	TOD	00:00:00 - 23:59:59 hrs	09:00:00 hrs	Time of the anti-blocking operation
eAbsDay	eDoW	eDow.Inactive, eDoW.Monday … eDoW.Sunday	eDoW.Monday	Weekday of the anti-blocking operation
xForceOption	BOOL		TRUE	State of the output xHB under forced override
eManModeB	eMANBIN	eMANBIN.Auto, eMANBIN.Off, eMANBIN.On	eMANBIN.Auto	Operating mode of the manual override

Function description

Release before manual override xAB

The output Release before manual override xAB is influenced by the input xY and the anti-lock protection module.

xY	Anti-blocking module	xAB	Notes
TRUE	X	TRUE	Release before manual override via request
X	TRUE	TRUE	Release before manual override via anti-blocking module
FALSE	FALSE	FALSE	Lock Release before manual override via the requests

Legend: X = don't care

Release after manual override xHB

The output Release after manual override xHB corresponds to the Release before manual override xAB, additionally extended by a manual override module and by a forced override.

xAB	eManModeB	xForce	xForceOption	xHB	Notes
FALSE	eMANBIN.Auto	FALSE	X	FALSE	Manual override module in automatic
TRUE	eMANBIN.Auto	FALSE	X	TRUE	Manual override module in automatic
X	eMANBIN.On	FALSE	X	TRUE	Manual override module in manual operation On
X	eMANBIN.Off	FALSE	X	FALSE	Manual override module in manual operation Off
X	X	TRUE	FALSE	FALSE	Forced override Off
X	X	TRUE	TRUE	TRUE	Forced override On

Legend: X = don't care

Request - energy generation xEnergyRequest

The request - energy generation xEnergyRequest is influenced by the anti-blocking process, the Release after manual override xHB and the mode of manual override - hardware eAOO is affected.

Anti-blocking process	xHB	eAOO	xEnergyRequest	Notes
FALSE	TRUE	HVACTYPES.eManBin.Auto	TRUE	Request in automatic mode of the manual override - hardware
X	X	HVACTYPES.eManBin.ManOn	TRUE	Request in manual mode of the manual override - hardware

In all other situations the request - energy generation xEnergyRequest is not active ( = FALSE ). Legend: X = any

Anti-blocking module

The anti-blocking module is implemented by the binary anti-blocking module with adjustable duration ( FB: AbsB ). The duration udiAbsTime, the time todAbsStartTime and the weekday eAbsDay are adjustable. The minimum runtime to lock the anti-blocking operation is 30 s. The timestamp (date / time) of the last anti-blocking operation dtAbsLastOn is available.

Aggregate fault xAlarm

The aggregate fault xAlarm is activated ( = TRUE ) if the input xAlarmIn is active. In all other cases the collective fault xAlarm is not activated ( = FALSE ).

Collective automatic mode message xAuto

The collective automatic mode message xAuto is activated ( = TRUE ) if the input eAOO has the value HVACTYPES.eManBin.Auto and the setpoint / parameter eManModeB contains the value eMANBIN.Auto. In all other cases the collective message automatic mode xAuto is not activated ( = FALSE ).

Forced override xForce

The forced override acts directly on the output xHB. With the parameter xForceOption it is defined which state the output xHB assumes at TRUE on the input xForce .

CODESYS

InOut:

Scope	Name	Type	Initial
Input	xY	BOOL
Input	xForce	BOOL	FALSE
Input	xAlarmIn	BOOL	FALSE
Input	eAOO	eManBin	eManBin.Auto
Output	xHB	BOOL
Output	xAB	BOOL
Output	xEnergyRequest	BOOL
Output	dtAbsLastOn	DT
Output	xAlarm	BOOL
Output	xAuto	BOOL
Input Const	udiAbsTime	UDINT	200
Input Const	todAbsStartTime	TOD	TIME_OF_DAY#9:0
Input Const	eAbsDay	eDoW	eDow.Monday
Input Const	xForceOption	BOOL	TRUE
Input Const	eManModeB	eMANBIN	eMANBIN.Auto