ValveTherm (FB)¶

FUNCTION_BLOCK ValveTherm

Short Description¶

Control of a thermal actuator with blocking protection function

Typical application: Valve actuator on radiator

Portrayal¶

Interfaces¶

Inputs¶

Name
Datatype

Range

Init-Value

Function

xY BOOL
Requirement

eAOO HVACTYPES.eManBin HVACTYPES.eManBin.Auto, HVACTYPES.eManBin.ManOff, HVACTYPES.eManBin.ManOn HVACTYPES.eManBin.Auto
Operating mode of manual override - Hardware

Outputs¶

Name
Datatype

Range

Init-Value

Function

xHB BOOL
Enable after manual override

xAB BOOL
Enable before manual override

xHeatRequest BOOL
Requirements - Heat generation

dtAbsLastOn DATE_AND_TIME
Date / time of the last blocking protection operation

Setpoints / Parameters¶

Name
Datatype

Range

Init-Value

Function

udiAbsTime UDINT 0 ... 600s 200s
Duration of blocking protection operation

todAbsStartTime TOD 00:00:00 - 23:59:59 Uhr 09:00:00 Uhr
Time point of blocking protection operation

eAbsDay eDoW eDoW.Monday ... eDoW.Sunday eDoW.Monday
Weekday of the blocking protection operation

eManModeB eMANBIN eMANBIN.Auto, eMANBIN.Off, eMANBIN.On eMANBIN.Auto
Manual override mode

Functional description¶

Enable before manual override xAB.¶

The output enable before manual override xAB is influenced by the input xY and the blocking protection module.

xY
blocking protection module
xAB
Notes

TRUE X TRUE
Enable before manual override via request

X TRUE TRUE
Enable before manual override via blocking protection module

FALSE FALSE FALSE
Disable enable before manual override via the requirements

Legend: X = any

Enable after manual override xHB¶

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

xAB eManModeB xHB
Notes

FALSE eMANBIN.Auto FALSE
Manual override module in automatic mode

TRUE eMANBIN.Auto TRUE
Manual override module in automatic mode

X eMANBIN.On TRUE
Manual override module in manual mode On

X eMANBIN.Off FALSE
Manual override module in manual mode Off

Legend: X = any

Requirement - Heat generation xHeatRequest¶

The requirement - heat generation xHeatRequest is influenced by the blocking protection process, the release after manual override xHB and the operating mode of the manual override - hardware eAOO.

Blocking protection process
xHB eAOO xHeatRequest
Notes

FALSE TRUE HVACTYPES.eManBin.Auto TRUE
Requirement in automatic mode of manual override - Hardware

X X HVACTYPES.eManBin.ManOn TRUE
Requirement in manual operation of manual override - Hardware

In all other situations the requirement - heat generation xHeatRequest is not active (= FALSE).

Legend: X = any

blocking protection module¶

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

Visualization¶

Information¶

Element
Authors

Date
Version
Note

Function
Alexander Halter 06.2016 1.0
Initial version

Programming
Alexander Halter 06.2016 1.0
Initial version

Test Jochen Reu 11.2017 1.0
Initial version

Documentation
Jochen Reu 11.2017 1.0
Initial version

Codesys¶

InOut:

Scope	Name	Type	Initial	Comment
Input	xY	BOOL		Stellsignal z.B. vom 2P-Regler
Input	eAOO	eManBin	HVACTYPES.eManBin.Auto
Output	xHB	BOOL		Control
	xAB	BOOL		Control of regulation
	xHeatRequest	BOOL		Heating circuit request
	dtAbsLastOn	DT		Last Start ABS function
Input	udiAbsTime	UDINT	200	ABS Time of the valve. Time in seconds from 0sec - 10min
	todAbsStartTime	TOD	TIME_OF_DAY#9:0	Time at which blocking protection is executed
	eAbsDay	eDoW	eDow.Monday	Weekday on which the blocking protection is executed
	eManModeB	eMANBIN	eMANBIN.Auto	0=Auto, 1=Hand Aus, 2=Hand Ein