THERMOKON_WRF07

THERMOKON_WRF07 (FB)

FUNCTION_BLOCK THERMOKON_WRF07

General

Notes:

The setpoint / parameter 'eMode' currently (16.05.2022) only affects the formation of the room set temperature 'rSetpTemp' and the setpoint temperature offset 'rOffset'.

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

* Device configuration *

The current device configuration is stored in registers 0 - 69 and in coils 0 - 5. It is read once at restart / once at every rising edge (xUpdateConfigRead) / cyclically (tTimeUpdateConfigRead) and saved into the arrays '_arwKonfiguration_0' and 'arbyKonfiguration_1'.

During operation, registers 2 - 69 and coils 0 - 3 are rewritten upon a single restart / when values change ('_arwKonfiguration_2' and '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 reset to factory defaults; 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	Address of the device ( 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 setpoint values (on every rising edge )
Input	xUpdateConfigRead	BOOL	FALSE	Update of configuration (read access) (on each rising edge)
Input	xUpdateConfigWrite	BOOL	FALSE	Update of the configuration (write access) ( on each 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 each rising edge)
Inout	ModbusClient	ModbusClientBase		Client of the device
Output	eDeviceType	THERMOKON_WRF07_DEVICE_TYPE		Type of 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 set temperature (degrees Celsius) — feedback
Output	rOffset	REAL		Current offset of the room set temperature in K
Output	rSetpTemp	REAL		Current setpoint temperature in degrees Celsius
Output	rRelHumidity	REAL		Relative room humidity in percent
Output	xSensorOffsetInDevice	BOOL		Indicator whether the calibration of the sensors must be performed in the device (TRUE = calibration in device required, FALSE = calibration in FB required)
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	General fault ( TRUE = fault )
Output	xAlarmCom	BOOL	FALSE	General 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 set 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 RBG, 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 actuated
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 operations influenced by the input 'xUpdateSetp'
Input Const	tTimeUpdateActual	TIME	TIME#3s0ms	Update interval for operations influenced by the input 'xUpdateActual'