THERMOKON_WRF07

THERMOKON_WRF07 (FB)

FUNCTION_BLOCK THERMOKON_WRF07

Representation

General

Notes:

Through the setpoint / parameter ‘eMode’ currently (16.05.2022) only the formation of the room setpoint temperature ‘rSetpTemp’ and the setpoint temperature offset ‘rOffset’ is affected.

The configuration registers (R0 - R69) or coils (C0 - C5) are always set for operating the WRF07 as a pure room control device (i.e. without its own internal regulation).

* Device configuration *

The current configuration of the device is stored in registers 0 - 69 or in coils 0 - 5. This is read once at startup / once at every rising edge (xUpdateConfigRead) / cyclically (tTimeUpdateConfigRead) and saved into the arrays ‘_arwKonfiguration_0’ or ‘arbyKonfiguration_1’.

During operation, registers 2 - 69 or coils 0 - 3 are rewritten once at startup / on value changes (‘_arwKonfiguration_2’ or ‘arbyKonfiguration_3’). Additionally, this write access can be triggered by a rising edge at the input ‘xUpdateConfigWrite’. This write access must not occur cyclically, because the number of write operations is limited (EEPROM).

The device configuration cannot be returned to the factory default; the default values are stored in the arrays ‘_arwKonfiguration_4’ and ‘_arbyKonfiguration_5’ and can be loaded/written into the device via the input ‘xResDefault’.

Setpoint / parameter ‘rOffsetRange’: A change is transmitted immediately without error, however the new offset is only used after a cold start of the WRF07.

InOut:

Scope	Name	Type	Initial	Comment
Input	xEn	BOOL	TRUE	Enable / disable communication (TRUE = enabled)
Input	byUnitId	BYTE	0	Device address ( 1 .. 247 ) ( 1 .. 63 via DIP switch, 1 .. 247 via Modbus commands )
Input	xUpdateActual	BOOL	FALSE	Update of actual values (on each rising edge ) ( Range: Operation )
Input	xUpdateSetp	BOOL	FALSE	Update of setpoints (on every rising edge )
Input	xUpdateConfigRead	BOOL	FALSE	Update of configuration (read access) (on each rising edge)
Input	xUpdateConfigWrite	BOOL	FALSE	Update of configuration (write access) ( on every rising edge)
Input	xUpdateStates	BOOL	FALSE	Update of states (Registers 256 - 257) (on each rising edge)
Input	xResDefault	BOOL	FALSE	Reset configuration to default state ( Registers 0 - 69) (Coils 0 - 5) (on each rising edge)
Input	rSetpTempBase	REAL	22.0	Base setpoint temperature ( degrees Celsius )
Input	xLED9	BOOL	FALSE	Control of LED9 ( TRUE = On )
Input	xEnOffset	BOOL	FALSE	Enable / disable the influence of the setpoint adjuster ( ‘rOffset’ ) on the setpoint temperature ( ‘rSetpTemp’ )
Input	xResError	BOOL	FALSE	Reinitialization of the output ‘eErrorCodeCom’ ( on every rising edge )
Inout	ModbusClient	ModbusClientBase		Client of the device
Output	eDeviceType	THERMOKON_WRF07_DEVICE_TYPE		Type of the device
Output	eUnitFb	THERMOKON_WRF07_UNIT		Current unit system of the device — feedback
Output	eRegulationModeFb	THERMOKON_WRF07_REGULATION_MODE_FEEDBACK		Current controller mode of the device
Output	rRoomTemp	REAL		Current room temperature in degrees Celsius
Output	rSetpTempBaseFb	REAL		Base setpoint temperature (degrees Celsius) — feedback
Output	rOffset	REAL		Current offset of the room setpoint temperature in K
Output	rSetpTemp	REAL		Current setpoint temperature in degrees Celsius
Output	rRelHumidity	REAL		Relative room humidity in percent
Output	xSensorOffsetInDevice	BOOL		Indicates whether sensor calibration must be performed in the device ( TRUE = calibration required in the device, FALSE = calibration required in the FB )
Output	rDewPointTemp	REAL		Dew point temperature in degrees Celsius or Fahrenheit
Output	rAbsHumidity	REAL		Absolute room humidity in g/m3 or grain/ft3
Output	rEnthalpy	REAL		Enthalpy in kJ/kg or BTU/lb3
Output	xButton1	BOOL	FALSE	Actuation of button 1 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton1Fb	THERMOKON_WRF07_BUTTON_FUNCTION		Function of button 1 — feedback
Output	xLED9Fb	BOOL	FALSE	State of LED 9 — feedback (TRUE = On)
Output	eFunctionLED9Fb	THERMOKON_WRF07_LED_FUNCTION		Function of LED 9 — feedback
Output	xDI1	BOOL	FALSE	State of digital input 1 (assignment depending on function ‘eFunctionDI1’) (FALSE = Open, TRUE = Closed)
Output	eFunctionDI1Fb	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION		Function of digital input 1 — feedback
Output	xDI2	BOOL	FALSE	State of digital input 2 (assignment depending on function ‘eFunctionDI2’) (FALSE = Open, TRUE = Closed)
Output	eFunctionDI2Fb	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION		Function of digital input 2 — feedback
Output	xDI3	BOOL	FALSE	State of digital input 3 (assignment depending on function ‘eFunctionDI1’) (FALSE = Open, TRUE = Closed)
Output	eFunctionDI3Fb	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION		Function of digital input 3 — feedback
Output	xDI4	BOOL	FALSE	State of digital input 4 (assignment depending on function ‘eFunctionDI2’) (FALSE = Open, TRUE = Closed)
Output	eFunctionDI4Fb	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION		Function of digital input 4 — feedback
Output	xAlarm	BOOL	FALSE	Collective fault (TRUE = fault)
Output	xAlarmCom	BOOL	FALSE	Collective fault - communication (TRUE = fault)
Output	eErrorCodeCom	ModbusErrorCode		Error code - communication (0 = no error)
Output	xBusy	BOOL		Communication indicator (TRUE = communication)
Input Const	eUnit	THERMOKON_WRF07_UNIT	THERMOKON_WRF07_UNIT.SI	Current unit system of the device
Input Const	rRoomHumityOffset	REAL	0.0	Offset of the room humidity ( for calibration of the humidity sensor ) in percent
Input Const	eFunctionLED9	THERMOKON_WRF07_LED_FUNCTION	THERMOKON_WRF07_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 9
Input Const	eFunctionDI4	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 4
Input Const	eFunctionDI3	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 3
Input Const	eFunctionDI2	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 2
Input Const	eFunctionDI1	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 1
Input Const	eFunctionButton1	THERMOKON_WRF07_BUTTON_FUNCTION		Function of button 1
Input Const	rSetpTempMax	REAL	26.0	Absolute maximum - setpoint temperature ( degrees Celsius )
Input Const	rSetpTempMin	REAL	18.0	Absolute minimum - setpoint temperature ( degrees Celsius )
Input Const	rSetpTempBaseReset	REAL	22.0	Base setpoint temperature in degrees Celsius after a reset
Input Const	rOffsetRange	REAL	3.0	Adjustment range of the setpoint potentiometer (symmetric, 3.0 = +/- 3.0K)
Input Const	rRoomTempOffset	REAL	0.0	Offset of the room temperature ( for calibration of the temperature sensor ) in K
Input Const	eButton1OutpMode	THERMOKON_WRF07_BUTTON_OUTP_MODE	THERMOKON_WRF07_BUTTON_OUTP_MODE.RAW	Operating mode of the output ‘xButton1’ ( RAW, PULSE )
Input Const	eMode	THERMOKON_WRF07_MODE	THERMOKON_WRF07_MODE.ROOM_CONTROL_UNIT	General operating mode of the device (ROOM_CONTROL_UNIT: Device serves as RCU, INTERNAL_REGULATION: setpoint formation / temperature regulation in the device)
Input Const	tTimeButtonPulse	TIME	TIME#1s0ms	Duration of the pulse at the output if the assigned button was pressed
Input Const	tTimeUpdateStates	TIME	TIME#500ms	Update interval for the processes influenced by the input ‘xUpdateStates’
Input Const	tTimeUpdateConfig	TIME	TIME#0ms	Update interval for the processes influenced by the input ‘xUpdateConfig’
Input Const	tTimeUpdateSetp	TIME	TIME#45s0ms	Update interval for the operations affected by the input 'xUpdateSetp'
Input Const	tTimeUpdateActual	TIME	TIME#3s0ms	Update interval for the operations affected by the input 'xUpdateActual'