THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H

THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H (FB)

FUNCTION_BLOCK THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H

General

Due to the setpoint / parameter ‘eDeviceMode’, as of 29.10.2024 only the formation of the room setpoint temperature ‘rSetpTemp’ and the setpoint temperature offset ‘rOffset’ is currently affected.

The configuration registers (R2 - R46) and -coils (C0 - C6) are always set for operation of the WRF07 as a pure room control unit (i.e. without its own internal control).

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

This function block can be used for all device types except the ‘4DI’ variant.

Depending on the function code, only a respective maximum number of resources may be read / written:

Read registers: <= 20 registers Write registers: <= 20 registers Read coils: <= 16 coils Write coils: <= 8 coils

There is only one temperature sensor !!!

* Device configuration *

* Thermokon - Configuration Software *

The configuration can be read and written independently of this function block using Thermokon’s software ‘WRF07-RS485-MODBUS Version 1.7’. The captured configuration data can be saved in a readable file and transferred to a new device.

* Function Block *

In this function block the configuration is read (see Function 1) and, if necessary, the parameters set here are written anew (Function 2). Parameters not set here remain unchanged. The default values according to the documentation can be restored using Function 3.

* Function 1 *

The current configuration of the device is stored in registers 0 - 46 and in coils 0 - 6.

This is a) read once at startup b) read once at every rising edge on the input ‘xUpdateConfigRead’ c) read cyclically (time interval ‘tTimeUpdateConfigRead’) d) read before each write operation (see Function 2)

read (FC03, FC01) and stored in the arrays ‘_arwKonfiguration_0’, ‘_arwKonfiguration_1’, ‘_arwKonfiguration_2’ and ‘arbyKonfiguration_3’. Additionally, the selected outputs are updated.

* Function 2 *

During operation, registers 2 - 46 and coils 0 - 6 are written a) once at startup b) when relevant parameters change c) once at every rising edge on the input ‘xUpdateConfigWrite’

written (FC16, FC15) (arrays ‘_arwKonfiguration_4’, ‘_arwKonfiguration_5’, ‘_arwKonfiguration_6’ and ‘arbyKonfiguration_7’).

This write access must not be performed cyclically, as the number of write accesses is limited (EEPROM).

* Function 3 *

The device configuration cannot be returned to the factory state; the default values are saved in the arrays ‘_arwKonfiguration_8’, ‘_arwKonfiguration_9’, ‘_arwKonfiguration_10’ and ‘_arbyKonfiguration_11’ and can be loaded/written into the device via the input ‘xResDefault’ (rising edge).

* Device setpoints *

* Thermokon - Configuration Software *

The setpoints can be read and written independently of this function block using Thermokon’s software ‘WRF07-RS485-MODBUS Version 1.7’. The captured setpoints can be saved in a readable file and transferred to a new device.

* Function Block *

In this function block the setpoints are read (see Function 1) and, if necessary, the setpoints defined here are written anew (Function 2). Setpoints not defined here remain unchanged.

* Function 1 *

The current setpoints of the device are stored in registers 512 - 517 and in coils 256 - 264.

These are a) read once at startup b) read once at every rising edge on the input ‘xUpdateActual’ c) read cyclically (time interval ‘tTimeUpdateActual’) d) read before each write operation (see Function 2)

read (FC03, FC01) and stored in the arrays ‘_arwIstwerte_1’, ‘arbyIstwerte_2’ and ‘arbyIstwerte_3’. Additionally, the selected outputs are updated.

* Function 2 *

During operation, registers 512 - 517 and coils 256+ - 264 are written a) once at startup b) once at every rising edge on the input ‘xUpdateSetp’ c) cyclically (time interval ‘tTimeUpdateSetp’) d) at every change of the relevant setpoint values

written (FC16, FC15) (arrays ‘_arwSollwerte_0’, ‘arbySollwerte_1’ and ‘arbySollwerte_2’).

InOut:

Scope	Name	Type	Initial	Comment
Input	xEn	BOOL	TRUE	Enable / disable communication ( TRUE = enabled )
Input	byUnitId	BYTE	0	Device address (1 .. 247) (1 .. 31 via DIP switches, 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 2 - 45) (coils 0 - 5) (on every rising edge)
Input	eMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_MODE.NO_OCCUPANCY	Definition of the room occupancy state
Input	rSetpTempBase	REAL	22.0	Base setpoint temperature ( degrees Celsius )
Input	xLED1	BOOL	FALSE	Control of LED1 ( TRUE = On )
Input	xLED2	BOOL	FALSE	Control of LED2 ( TRUE = On )
Input	xLED3	BOOL	FALSE	Control of LED3 ( TRUE = On )
Input	xLED4	BOOL	FALSE	Control of LED4 ( TRUE = On )
Input	xLED5	BOOL	FALSE	Control of LED5 ( TRUE = On )
Input	xEnOffset	BOOL	FALSE	Enable / disable the influence of the setpoint adjuster ‘rOffset’ on the setpoint temperature ( ‘rSetpTemp’ )
Input	rAO1Manual	REAL	0.0	State of analog output 1 (‘eOutputsMode’ = THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 516, FC16)
Input	rAO2Manual	REAL	0.0	State of analog output 2 (‘eOutputsMode’ = THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 517, FC16)
Input	xDO1Manual	BOOL	FALSE	State of digital output 1 (‘eOutputsMode’ = THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_ANALOG_OUTP_MODE.MANUAL_MODE) (0 = open, 1 = closed) (address 516, FC16)
Input	xDO2Manual	BOOL	FALSE	State of digital output 2 (‘eOutputsMode’ = THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_ANALOG_OUTP_MODE.MANUAL_MODE) (0 = open, 1 = closed) (address 517, FC16)
Input	xResError	BOOL	FALSE	Reinitialization of the output 'eErrorCodeCom' (on each rising edge)
Inout	ModbusClient	ModbusClientBase		Client of the device
Output	eDeviceType	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DEVICE_TYPE		Type of device
Output	wFirmwareVersion	WORD		Firmware version of the device (101 = 1.01)
Output	eTemperatureUnitFb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_TEMPERATURE_UNIT		Current unit system of the device for temperature — feedback
Output	eControlMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_CONTROL_MODE_FEEDBACK		Current mode of the device's internal controller
Output	xMode	BOOL		Current operating mode of the RBG (FALSE = not occupied, TRUE = occupied)
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	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	xButton1	BOOL		Actuation of button 1 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton1Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION		Function of button 1 — feedback
Output	xButton2	BOOL		Actuation of button 2 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton2Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION		Function of button 2 — feedback
Output	xButton3	BOOL		Actuation of button 3 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton3Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION		Function of button 3 — feedback
Output	xButton4	BOOL		Actuation of button 4 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton4Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION		Function of button 4 — feedback
Output	xButton5	BOOL		Actuation of button 5 ( RAW, pulse with duration ‘tTimeButtonPulse’ )
Output	eFunctionButton5Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION		Function of button 5 — feedback
Output	xLED1Fb	BOOL		State of LED 1 — feedback ( TRUE = On )
Output	eFunctionLED1Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION		Function of LED 1 — feedback
Output	xLED2Fb	BOOL		State of LED 2 — feedback ( TRUE = On )
Output	eFunctionLED2Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION		Function of LED 2 — feedback
Output	xLED3Fb	BOOL		State of LED 3 — feedback ( TRUE = On )
Output	eFunctionLED3Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION		Function of LED 3 — feedback
Output	xLED4Fb	BOOL		State of LED 4 — feedback ( TRUE = On )
Output	eFunctionLED4Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION		Function of LED 4 — feedback
Output	xLED5Fb	BOOL		State of LED 5 — feedback ( TRUE = On )
Output	eFunctionLED5Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION		Function of LED 5 — feedback
Output	xDI1	BOOL		State of digital input 1 (assignment depending on function 'eFunctionDI1') (FALSE = Open, TRUE = Closed)
Output	eFunctionDI1Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION		Function of digital input 1 — feedback
Output	xDI2	BOOL		State of digital input 2 (assignment depending on function 'eFunctionDI2') (FALSE = Open, TRUE = Closed)
Output	eFunctionDI2Fb	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION		Function of digital input 2 — feedback
Output	rAO1	REAL		Current state at analog output 1 ( 0.0 - 100.0% = 0.0 - 10.0 V )
Output	rAO2	REAL		Current state at analog output 2 ( 0.0 - 100.0% = 0.0 - 10.0 V )
Output	xDO1	BOOL		Current state at digital output 1 ( 0 = Open, 1 = Closed )
Output	xDO2	BOOL		Current state at digital output 2 ( 0 = Open, 1 = Closed )
Output	xAlarm	BOOL		General fault ( TRUE = fault )
Output	xAlarmCom	BOOL		General fault - communication ( TRUE = fault )
Output	eErrorCodeCom	ModbusErrorCode		Error code - communication ( 0 = no error )
Output	xBusy	BOOL		Communication indicator ( TRUE = communication )
Input Const	rAO2_DO2_AfterReset	REAL	0.0	State of the analog / digital outputs AO2 or DO2 after a reset on the WRF07
Input Const	rAO1_DO1_AfterReset	REAL	0.0	State of the analog / digital outputs AO1 or DO1 after a reset on the WRF07
Input Const	eOutputsMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_OUTPUTS_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_OUTPUTS_MODE.MANUAL_MODE	Analog output: 0.0 - 100.0 = 0.0 - 10.0V Digital output: 0 = open, >=1 = closed Mode for the analog / digital outputs AO1, AO2, DO1, DO2 (MANUAL_MODE: <br/>*<br/> rAO1Manual, ‘rAO2Manual’, ‘xDO1Manual’ and ‘xDO2Manual’ define the current states of the outputs)
Input Const	eFunctionLED5	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 5
Input Const	eFunctionLED4	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 4
Input Const	eFunctionLED3	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 3
Input Const	eFunctionLED2	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 2
Input Const	eFunctionLED1	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_LED_FUNCTION.EXTERNAL_CONTROL	Function of LED 1
Input Const	eFunctionDI2	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 2
Input Const	eFunctionDI1	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DIGITAL_INPUT_FUNCTION.NORMALLY_OPEN_CONTACT	Function of digital input 1
Input Const	eFunctionButton5	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION.NO_SPECIAL_FUNCTION	Function of button 5
Input Const	eFunctionButton4	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION.NO_SPECIAL_FUNCTION	Function of button 4
Input Const	eFunctionButton3	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION.NO_SPECIAL_FUNCTION	Function of button 3
Input Const	eFunctionButton2	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION.NO_SPECIAL_FUNCTION	Function of button 2
Input Const	eFunctionButton1	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_FUNCTION.NO_SPECIAL_FUNCTION	Function of button 1
Input Const	eButton5OutpMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE.PULSE	Operating mode of the output 'xButton5' ( RAW, PULSE )
Input Const	eButton4OutpMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE.PULSE	Operating mode of the output 'xButton4' ( RAW, PULSE )
Input Const	eButton3OutpMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE.PULSE	Operating mode of the output 'xButton3' ( RAW, PULSE )
Input Const	eButton2OutpMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE.PULSE	Operating mode of the output 'xButton2' ( RAW, PULSE )
Input Const	eButton1OutpMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_BUTTON_OUTP_MODE.PULSE	Operating mode of the output ‘xButton1’ ( RAW, PULSE )
Input Const	tTimeButtonPulse	TIME	TIME#1s0ms	Duration of the pulse at the output if the assigned button was actuated
Input Const	eContrModeAfterReset	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_CONTROL_MODE_AFTER_RESET	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_CONTROL_MODE_AFTER_RESET.OFF	Mode of the internal controller after a reset / restart (0 = control off)
Input Const	eContrMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_CONTROL_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_CONTROL_MODE.OFF	Mode of the internal controller (0 = control off)
Input Const	xEnContr	BOOL	FALSE	Enable / disable of the internal controller (FALSE = internal controller disabled)
Input Const	xModeAfterReset	BOOL	FALSE	State of room occupancy after a reset
Input Const	tTimeBypass	TIME	TIME#120m0s0ms	Duration of the occupancy extension in minutes (1 minute <= tTimeBypass <= 1440 minutes)
Input Const	rNightShiftSetpTemp	REAL	5.0	Setpoint temperature - night setback (relative) (address 19) (important for the formation of the effective setpoint temperature ‘rSetpTemp’ when ‘eDeviceMode’ = INTERNAL_REGULATIOM)
Input Const	rDeadBandSetpTemp	REAL	2.0	Setpoint temperature - deadband between heating and cooling operation (address 20) (important for the formation of the effective setpoint temperature ‘rSetpTemp’ when ‘eDeviceMode’ = INTERNAL_REGULATIOM)
Input Const	rOffsetSetpTemp	REAL	0.0	Setpoint temperature - offset (address 512) (important for the formation of the effective setpoint temperature ‘rSetpTemp’ when ‘eDeviceMode’ = INTERNAL_REGULATIOM)
Input Const	rAntifreezeTemp	REAL	0.0	Limit temperature - frost protection (degrees Celsius), 0.0 disables the frost protection function
Input Const	eTemperatureUnit	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_TEMPERATURE_UNIT	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_TEMPERATURE_UNIT.DEGREE_CELSIUS	Current unit system of the device for temperature
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	eDeviceMode	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DEVICE_MODE	THERMOKON_WRF07_TEMP_HUM_AO2V_REV_A_H_DEVICE_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	tTimeUpdateStates	TIME	TIME#1s0ms	Update interval for the processes influenced by the input ‘xUpdateStates’
Input Const	tTimeUpdateConfigRead	TIME	TIME#0ms	Update interval for the operations influenced by the input 'xUpdateConfigRead'
Input Const	tTimeUpdateSetp	TIME	TIME#45s0ms	Update interval for operations influenced by the input 'xUpdateSetp'
Input Const	tTimeUpdateActual	TIME	TIME#5s0ms	Update interval for operations influenced by the input 'xUpdateActual'