THERMOKON_WRF06

THERMOKON_WRF06 (FB)

FUNCTION_BLOCK THERMOKON_WRF06

Representation

Short description

Control of the WRF06 device series from Thermokon Typical application: Room operating unit in a zone\

Guidelines - Software creation

The following function codes (FC) are supported: 1 - 6, 15 - 16 For addressing, use the address numbers, not the register addresses. This room operating unit can be delivered in different device types (without / with integrated temperature controller). The function block supports up to four digital inputs and two analog outputs. The two analog outputs can be written to directly. The four function keys F1 (right) - F4 (left) are supported by the function block. The function block exclusively supports use as a pure room operating unit; the internal PI controller (present depending on device type) is not used. Calibration of the room temperature sensor is performed either on the room operating unit (parameter mode, see documentation) or using the configuration software ‘WRF06-RS485_MODBUS_V_2_9’. The RBG monitors the Modbus communication. If no valid Modbus telegram is received for more than 90 s, the analog/digital outputs are set to standard values (registers 53 and 54). Modbus addresses 1 - 32 can be set directly on the DIP switches in the RBG. The address range 1 - 247 can be used via a procedure described in the documentation. In the data field (ADR - FC - data field - CRC1 - CRC2) a maximum of 100 bytes (= 50 registers) may be transmitted (deviating from the Modbus standard). The following transmission parameters were tested: 19200 baud, 8-N-1 This function block currently only supports the device types ‘AO2V’ and ‘4DI’ with printing type 2. Setpoint temperature 1 can be changed using the UP / DOWN keys only during daytime operation (= comfort / occupied) (property of the room operating unit) For the internal PI controller the following quantities are used: Actual value: address 258 (= room temperature) Setpoint: address 260 (= setpoint 1 effective) Control signal: The control signal is output directly to the outputs. Measured values - Calibration: Class 4

Configuration data

The data in the EEPROM (= configuration data) may be written a maximum of 10000 times!!! Data in the EEPROM: Addresses 2 - 58: configuration registers Addresses 768 - 987: text message line 1 and 2 Addresses 1024 - 1080: unit line 1, 2 and 3 Coils 0 - 30: configuration bits These configuration data can be read from the room operating unit, backed up, changed and written to a new room operating unit using the software ‘WRF06-RS485_MODBUS_V_2_9’. Therefore, no configuration data are present in the function block. In the function block addresses 0 - 58 are read if the configuration (xUpdateConfig, tTimeUpdateConfig, once after restart) is read. The device configuration cannot be reset to factory settings (neither via Modbus nor via the configuration software). Register 528 (address 527) - specification of the fan stage (FC06 / FC16): If a manual fan stage (0 - 3) is specified, it is correctly displayed and reported back in the RBG. If an automatic fan stage (65280 - 65283) is specified, it is — temporarily — correctly displayed and reported back in the RBG. However, writing with an automatic stage activates the internal automatic mode, which depends on the heating/cooling control signal (adjustable thresholds). Therefore, this function block only supports specifications of the manual fan stages. Interfaces \

Inputs

Name	Data type	Value range	Initial value	Function
xEn	BOOL		TRUE	Enable / disable communication (TRUE = enabled)
byUnitId	BYTE		0	Address of the device ( 0 .. 255 )
xUpdateActual	BOOL		FALSE	Update of actual values ( on each rising edge )
xUpdateSetp	BOOL		FALSE	Update of setpoints ( on each rising edge )
xUpdateConfig	BOOL		FALSE	Update of the configuration (on every rising edge) (read access)
xUpdateStates	BOOL		FALSE	Update of states ( on each rising edge )
xUpdateInfo	BOOL		FALSE	Update of the information (on every rising edge)
rAO1Manual	REAL		0.0	State of analog output 1 (‘eAnalogOutputsMode’ = THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 534, FC16)
rAO2Manual	REAL		0.0	State of analog output 2 (‘eAnalogOutputsMode’ = THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 535, FC16)
xDsplSymb_Alarm	BOOL		FALSE	Enable / disable display of the 'Fault' symbol (TRUE = display) (coil 256, FC15)
xDsplSymb_Heat	BOOL		FALSE	Enable / disable display of the 'Heating, controller heating mode' symbol (TRUE = display) (coil 257, FC15)
xDsplSymb_Cool	BOOL		FALSE	Enable / disable display of the 'Cooling, controller cooling mode' symbol (TRUE = display) (coil 258, FC15)
xDsplSymb_Wind	BOOL		FALSE	Enable / disable display of the 'Window, energy lock' symbol (TRUE = display) (coil 259, FC15)
xDsplSymb_DewP	BOOL		FALSE	Enable / disable display of the 'Dew point, dew point alarm' symbol (TRUE = display) (coil 260, FC15)
xDsplSymb_Off	BOOL		FALSE	Enable / disable display of the 'Off, controller off' symbol (TRUE = display) (coil 261, FC15)
xUpdateDateTime	BOOL		FALSE	Update of the device date / time (on every rising edge)
rExtValue1	REAL		0.0	External measured value 1 for display on the RBG (Modbus register content = rExtValue1 * rExtValue1Mult) (address 519, FC16)
rExtValue2	REAL		0.0	External measured value 2 for display on the RBG (Modbus register content = rExtValue1 * rExtValue1Mult) (address 520, FC16)
rExtValue3	REAL		0.0	External measured value 3 for display on the RBG (Modbus register content = rExtValue1 * rExtValue1Mult) (address 521, FC16)
rExtValue4	REAL		0.0	External measured value 4 for display on the RBG (Modbus register content = rExtValue1 * rExtValue1Mult) (address 522, FC16)
wAutoFanStages	WORD		0	Input for automatic specification of the fan stage
eRegMode	THERMOKON_WRF06_REGULATION_MODE		THERMOKON_WRF06_REGULATION_MODE.NO_REGULATION	Current controller mode in the device (address 533, FC16)
rExtRoomTemp	REAL		0.0	External temperature as replacement for the internal room temperature (address 536, FC16) (‘eRoomTempMode’ = THERMOKON_WRF06_ROOM_TEMP_MODE.EXTERNAL_VALUE)
xMode	BOOL		FALSE	Current room occupancy in the device (TRUE = occupied, comfort mode, day operation, FALSE = not occupied, setback mode, night operation) (address 528, FC16)
rSetpTemp1BaseDay	REAL		22.0	Setpoint temperature 1: base - setpoint temperature in day operation (degrees Celsius)
rSetpTemp1Night	REAL		18.0	Setpoint temperature 1: setpoint temperature in night operation (degrees Celsius)
rSetpTemp2BaseDay	REAL		22.0	Setpoint temperature 2: base - setpoint temperature in day operation (degrees Celsius)
rSetpTemp2Night	REAL		18.0	Setpoint temperature 2: setpoint temperature in night operation (degrees Celsius)
xResError	BOOL		FALSE	Input for resetting the output ‘eErrorCodeCom’ (on every rising edge)

Outputs

Name	Data type	Value range	Initial value	Function
wDeviceCode	WORD		0	Device identification (address 0, FC03)
wFirmwareVer	WORD		0	Device firmware version (address 1, FC03)
eDeviceType	THERMOKON_WRF06_DEVICE_TYPE			Device configuration (address 2, FC03)
rRoomTemp	REAL		0.0	Current room temperature in the selected unit (address 258, FC03)
rRelHumidity	REAL		0.0	Relative room humidity in percent (if sensor present) (address 270, FC03)
rAO1	REAL		0.0	Current state at analog output 1 (0.0 - 100.0% = 0.0 - 10.0 V)
rAO2	REAL		0.0	Current state at analog output 2 (0.0 - 100.0% = 0.0 - 10.0 V)
eRegModeDev	THERMOKON_WRF06_REGULATION_MODE_DEVICE			Current controller mode from the device (address 269, FC03)
rSetpTemp1OffMaxFb	REAL		0.0	Temperature setpoint 1: maximum - adjustment of the base setpoint — feedback (address 17, FC03)
rSetpTemp1OffMinFb	REAL		0.0	Temperature setpoint 1: minimum - adjustment of the base setpoint — feedback (address 18, FC03)
rSetpTemp1StepFb	REAL		0.0	Temperature setpoint 1: +/- - adjustment per button press — feedback (address 19, FC03)
rSetpTemp1ResetFb	REAL		0.0	Temperature setpoint 1: base setpoint after a reset operation — feedback (address 20, FC03)
rSetpTemp2OffMaxFb	REAL		0.0	Temperature setpoint 2: maximum - adjustment of the base setpoint — feedback (address 21, FC03)
rSetpTemp2OffMinFb	REAL		0.0	Temperature setpoint 2: minimum - adjustment of the base setpoint — feedback (address 22, FC03)
rSetpTemp2StepFb	REAL		0.0	Temperature setpoint 2: +/- - adjustment per button press — feedback (address 23, FC03)
rSetpTemp2ResetFb	REAL		0.0	Temperature setpoint 2: base setpoint after a reset operation — feedback (address 24, FC03)
rSetpTemp1Off	REAL		0.0	Temperature setpoint 1: current adjustment of the base setpoint (address 259, FC03) (actual values_1)
rSetpTemp1	REAL		0.0	Temperature setpoint 1: current setpoint (address 260, FC03) (actual values_1)
rSetpTemp2Off	REAL		0.0	Temperature setpoint 2: current adjustment of the base setpoint (address 261, FC03) (actual values_1)
rSetpTemp2	REAL		0.0	Temperature setpoint 2: current setpoint (address 262, FC03) (actual values_1)
xButtonSetpTempUp	BOOL		FALSE	Generation of a pulse with duration ‘tTimeButtonPulse’ when the setpoint temperature is increased
xButtonSetpTempDown	BOOL		FALSE	Generation of a pulse with duration ‘tTimeButtonPulse’ when the setpoint temperature is decreased
xModeDev	BOOL		FALSE	Current room occupancy from the device (TRUE = occupied, comfort mode, day operation) (address 264, FC03)
xButtonPresence	BOOL		FALSE	Generation of a pulse with duration ‘tTimeButtonPulse’ when the presence status has changed
eFanModeDev	THERMOKON_WRF06_FAN_OP_MODE			Current operating mode of the fan (address 263, FC03)
wNbrOfFanStages	WORD		0	Number of available fan stages
xAutoFanStages	BOOL		FALSE	Indication of automatic operation for the fan stages (FALSE: manual correction active, TRUE = automatic operation active)
xButtonFanStages	BOOL		FALSE	Generation of a pulse with duration ‘tTimeButtonPulse’ when the fan stage is changed
xButton1	BOOL		FALSE	Actuation of button 1 (right) (modes: RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
eFunctionButton1Fb	THERMOKON_WRF06_BUTTON_FUNCTION			Function of button 1 — feedback (address 6, FC03)
xButton2	BOOL		FALSE	Actuation of button 2 (middle right) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
eFunctionButton2Fb	THERMOKON_WRF06_BUTTON_FUNCTION			Function of button 2 — feedback (address 7, FC03)
xButton3	BOOL		FALSE	Actuation of button 3 (middle left) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
eFunctionButton3Fb	THERMOKON_WRF06_BUTTON_FUNCTION			Function of button 3 — feedback (address 8, FC03)
xButton4	BOOL		FALSE	Actuation of button 4 (left) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
eFunctionButton4Fb	THERMOKON_WRF06_BUTTON_FUNCTION			Function of button 4 — feedback (address 9, FC03)
xDI1	BOOL		FALSE	State of digital input 1 (assignment depending on function) (FALSE = open, TRUE = closed) (address 265, FC03)
eFunctionDI1Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION			Function of digital input 1 — feedback (address 26, FC03)
xDI2	BOOL		FALSE	State of digital input 2 (assignment depending on function) (FALSE = open, TRUE = closed) (address 266, FC03)
eFunctionDI2Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION			Function of digital input 2 — feedback (address 27, FC03)
xDI3	BOOL		FALSE	State of digital input 3 (assignment depending on function) (FALSE = open, TRUE = closed) (address 267, FC03)
eFunctionDI3Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION			Function of digital input 3 — feedback (address 28, FC03)
xDI4	BOOL		FALSE	State of digital input 4 (assignment depending on function) (FALSE = open, TRUE = closed) (address 268, FC03)
eFunctionDI4Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION			Function of digital input 4 — feedback (address 29, FC03)
xSensorOffsetInDevice	BOOL			Indicates whether sensor calibration must be performed in the device (TRUE = calibration in device required, FALSE = calibration required in the FB)
xAlarm	BOOL		FALSE	Collective fault (TRUE = fault)
xAlarmCom	BOOL		FALSE	Collective fault - communication (TRUE = fault)
eErrorCodeCom	ModbusErrorCode			Error code - communication (0 = no error)
xBusy	BOOL			Communication indicator (TRUE = communication)

Inputs and outputs

Name	Data type	Value range	Initial value	Function
ModbusClient	ModbusClientBase			Client of the device

Setpoints / parameters

Name	Data type	Value range	Initial value	Address	Function
tTimeUpdateActual	TIME		T#3s		Update interval for the operations influenced by the input ‘xUpdateActual’ ( 0 = no automatic update, > 0 cyclical update )
tTimeUpdateSetp	TIME		T#0s		Update interval for the operations influenced by the input ‘xUpdateSetp’ ( 0 = no automatic update, > 0 cyclical update )
tTimeUpdateConfig	TIME		T#0s		Update interval for the operations influenced by the input ‘xUpdateConfig’ ( 0 = no automatic update, > 0 cyclical update )
tTimeUpdateStates	TIME		T#500ms		Update interval for the operations influenced by the input ‘xUpdateStates’ ( 0 = no automatic update, > 0 cyclical update )
tTimeUpdateInfo	TIME		T#0s		Update interval for the operations influenced by the input ‘xUpdateInfo’ (0 = no automatic update, > 0 cyclical update)
tTimeButtonPulse	TIME		T#1s		Duration of the pulse on outputs ‘xButtonX’, ‘xButtonPresence’, ‘xBiuttonFanStages’, ‘xButtonSetpTempUp’ and ‘xButtonSetpTempDown’
eButton1OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE		THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW		Operating mode of the output ‘xButton1’ ( RAW, PULSE )
eButton2OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE		THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW		Operating mode of output ‘xButton2’ ( RAW, PULSE )
eButton3OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE		THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW		Operating mode of output ‘xButton3’ ( RAW, PULSE )
eButton4OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE		THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW		Operating mode of output ‘xButton4’ ( RAW, PULSE )
wDateTime_Seconds	WORD		0		Update of date / time: current second of the minute (0 - 59)
wDateTime_Minutes	WORD		0		Update of date / time: current minute of the hour (0 - 59)
wDateTime_Hours	WORD		0		Update of date / time: current hour of the day (0 - 23)
wDateTime_DayOfMonth	WORD		1		Update of date / time: current day of the month (1 - 31)
wDateTime_Month	WORD		1		Update of date / time: current month (1 - 12)
wDateTime_Year	WORD		2024		Update of date / time: current year (2000 - 2099)
eAnalogOutputsMode	THERMOKON_WRF06_ANALOG_OUTP_MODE		THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE;		Mode for the analog outputs AO1 and AO2 (MANUAL_MODE: <br/>*<br/> ‘rAO1’ and ‘rAO2’ define the current states of the analog outputs)
xDsplAlarm1	BOOL		FALSE		Enable / disable display of alarm message 1 on the RBG (TRUE = display)
xDsplAlarm2	BOOL		FALSE		Enable / disable display of alarm message 2 on the RBG (TRUE = display)
xDsplAlarm3	BOOL		FALSE		Enable / disable display of alarm message 3 on the RBG (TRUE = display)
xDsplAlarm4	BOOL		FALSE		Enable / disable display of alarm message 4 on the RBG (TRUE = display)
eRoomTempMode	THERMOKON_WRF06_ROOM_TEMP_MODE		THERMOKON_WRF06_ROOM_TEMP_MODE.INTERNAL_SENSOR		Mode for the source of the room temperature (EXTERNAL_VALUE: <br/>*<br/> ‘rExtRoomTemp’ defines the room temperature)
rExtValue1Mult	REAL		10.0		Multiplier for external measured value 1 for display on the RBG (address 519 = rExtValue1 * rExtValue1Mult)
rExtValue2Mult	REAL		10.0		Multiplier for external measured value 2 for display on the RBG (address 520 = rExtValue2 * rExtValue2Mult)
rExtValue3Mult	REAL		10.0		Multiplier for external measured value 3 for display on the RBG (address 521 = rExtValue3 * rExtValue3Mult)
rExtValue4Mult	REAL		10.0		Multiplier for external measured value 4 for display on the RBG (address 522 = rExtValue4 * rExtValue4Mult)
xVisuPresence	BOOL		FALSE		Visualization: actuation of the presence button (on every rising edge)
xVisuFanStages	BOOL		FALSE		Visualization: actuation of the button for the fan stages (on every rising edge)
xVisuSetpTempUp	BOOL		FALSE		Visualization: actuation of the button to increase the setpoint temperature in day operation (on every rising edge)
xVisuSetpTempDown	BOOL		FALSE		Visualization: actuation of the button to decrease the setpoint temperature in day operation (on every rising edge)
eButtonSelectionForPresence	THERMOKON_WRF06_BUTTON_SELECTION		THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_4		Selection of the button (1 - 4) for the presence function (output ‘xButtonPresence’)
eButtonSelectionForFanStages	THERMOKON_WRF06_BUTTON_SELECTION		THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_3		Selection of the button (1 - 4) for selecting the fan stages (output ‘xButtonFanStages’)
eButtonSelectionForSetpTempUp	THERMOKON_WRF06_BUTTON_SELECTION		THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_1		Selection of the button (1 - 4) for the button to increase the setpoint temperature (output ‘xButtonSetpTempUp’)
eButtonSelectionForSetpTempDown	THERMOKON_WRF06_BUTTON_SELECTION		THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_2		Selection of the button (1 - 4) for the button to decrease the setpoint temperature (output ‘xButtonSetpTempDown’)
eSetpTempOpMode	THERMOKON_WRF06_SETP_TEMP_OPERATION_MODE		THERMOKON_WRF06_SETP_TEMP_OPERATION_MODE.SETPOINT_1		Selection of the setpoint (1, 2) to be adjusted by the keys on the room operating unit

Function description

General

This function block controls room operating units of the WRF06 device series from Thermokon via Modbus communication. Configuration is performed externally, e.g. by using the configuration software ‘WRF06-RS485_MODBUS_V_2_9’. This function block currently only supports the device types ‘AO2V’ and ‘4DI’ with printing type 2. The function block exclusively supports use as a pure room operating unit; the internal PI controller (present depending on device type) is not used.\

Analog outputs AO1 and AO2 (if present)

The current states of the analog outputs (0.0 - 10.0 V) are determined either by the internal PI controller (eAnalogOutputsMode = AUTOMATIC_MODE) or by the inputs ‘rAO1Manual’ and ‘rAO1Manua2’ (0.0 - 100.0 %) (eAnalogOutputsMode = MANUAL_MODE).\

Display of symbols on the room operating unit

Various symbols on the display of the room operating unit can be shown by the assigned inputs with the prefix ‘xDsplSymb_X’ (FALSE = off, TRUE = on). Update of the date / time on the room operating unit

On every rising edge at the input ‘xUpdateDateTime’, the parameters with the prefix ‘wDateTime_X’ are transferred to the room operating unit. The parameters are checked for compliance with the limit values.\

Display of external measured values

A maximum of four different external measured values can be transferred to the room operating unit via the inputs ‘rExtValueX’ (X = 1 .. 4), multiplied by the respective parameter ‘rExtValueXMult’, and displayed (see configuration).\

Fan stages

The number of switchable fan stages is set in the configuration (output ‘wNbrOfFanStages’). The current operating mode is shown at the output ‘eFanModeDev’. The fan stage in night or day operation is primarily determined by the input ‘wAutoFanStages’ in the range 0 - ‘wNbrOfFanStages’. Manual correction (only in day operation): With each pulse at the output ‘xButtonFanStages’ the fan stage is incrementally increased in day operation from the lower limit ‘wMinFanStageManDay’ to the upper limit ‘wMaxFanStageManDay’ taking into account the output ‘wNbrOfFanStages’. On the next pulse it then returns to the lower limit ‘wMinFanStageManDay’ before the sequence starts again. The manually specified fan stage in day operation is not stored when switching to night operation. The switch from manual correction to automatic operation occurs:\

1. when switching from night to day operation\

2. when switching from day to night operation\

3. if the button to change the fan stage (parameter ‘eButtonSelectionForFanStages’) on the RBG is pressed continuously for more than 3 s.\

4. if the button to switch to automatic mode ‘xVisuAutoFanStages’ was pressed

Mode (night and day operation)

The input ‘xMode’ is monitored for changes. On each rising edge the switch to day operation occurs, on each falling edge the switch to night operation occurs. The current mode is shown at the output ‘xModeDev’.\

Setpoints in the room control unit

The room control unit has two setpoints (1, 2) that can be displayed and used for temperature control. Each setpoint consists of a base value and an offset (effective setpoint = base value + offset). In this function block setpoint 1 is used primarily. The assigned inputs and outputs are each labeled with the prefix ‘rSetpTempX’ (X = 1 .. 2). The outputs ‘rSetpTempXOffMaxFb’, ‘rSetpTempXOffMinFb’, ‘rSetpTempXStepFb’ and ‘rSetpTempXResetFb’ are read from the configuration and displayed. The respective current values on the RBG can be read at the outputs ‘rSetpTempX’ and ‘rSetpTempXOFF’.\

Setpoint temperatures in day and night operation

At each transition to day operation the current setpoint temperatures 1 and 2 for day operation are transferred to the room control unit. At the first transition or after parameter changes the following is transferred: Base value = ‘rSetpTempXBaseDay, Offset = 0.0 At subsequent transitions the following is transferred: Base value = last current base value, Offset = last current offset At each transition to night operation the current setpoint temperatures 1 and 2 for night operation are transferred to the room control unit. Base value = ‘rSetpTempXNight, Offset = 0.0\

Adjustment of setpoint temperatures in day operation

The parameter ‘eSetpTempOpMode’ determines which setpoint the adjustment in day operation should affect. In day operation the current setpoint is increased at each rising edge at the output ‘xButtonSetpTempUp’ by the step size ‘rSetpTempXStepFb’, if the assigned limit ‘rSetpTempXOffMaxFb’ has not yet been exceeded. In day operation the current setpoint is decreased at each rising edge at the output ‘xButtonSetpTempDown’ by the step size ‘rSetpTempXStepFb’, if the assigned limit ‘rSetpTempXOffMinFb’ has not yet been undershot. Output ‘xButtonPresence’

A pulse of duration ‘tTimeButtonPulse’ is generated at this output, if \

1. at the parameter ‘xVisuPresence’ OR\

2. at the output of the selected button ‘xButtonX’ (X = 1 .. 4) (selection via ‘eSelectButtonForPresence’)\

a rising edge is detected ( = actuation ). This output can be linked to the input ‘xButton’ of the function block ‘HVAC.Button1’ in order to realize occupancy time extension.\

Output ‘xButtonFanStages’

A pulse of duration ‘tTimeButtonPulse’ is generated at this output, if \

1. at the parameter ‘xVisuFanStages’ OR\

2. at the output of the selected button ‘xButtonX’ (selection via ‘eSelectButtonForFanStages’)\

a rising edge is detected ( = actuation ). Manual correction (day operation only): With each pulse at the output ‘xButtonFanStages’ the fan stage is incrementally increased in day operation from the lower limit ‘wMinFanStageManDay’ to the upper limit ‘wMaxFanStageManDay’ taking into account the output ‘wNbrOfFanStages’. On the next pulse it then switches back to the lower limit ‘wMinFanStageManDay’ before the sequence begins again. The manually specified fan stage in day operation is not saved when switching to night operation. The switch from manual correction to automatic mode occurs: 1) when switching from night to day operation 2) when switching from day to night operation 3) if the button to change the fan stage (parameter ‘eButtonSelectionForFanStages’) on the RBG is pressed continuously for more than 3 s. 4) if the button to switch to automatic mode ‘xVisuAutoFanStages’ was pressed\

Output ‘xButtonSetpTempUp’

A pulse of duration ‘tTimeButtonPulse’ is generated at this output, if \

1. at the parameter ‘xVisuSetpTempUp’ OR\

2. at the output of the selected button ‘xButtonX’ (selection via ‘eSelectButtonForSetpTempUp’)\

a rising edge is detected ( = actuation ). Two operating modes are distinguished (parameter ‘eSetpTempOpMode’): 1) SETPOINT_1: for each pulse at the output ‘xButtonSetpTempUp’ in day operation the adjustment of setpoint 1 is increased by the step size for setpoint 1 2) SETPOINT_2: for each pulse at the output ‘xButtonSetpTempUp’ in day operation the adjustment of setpoint 2 is increased by the step size for setpoint 2\

Output ‘xButtonSetpTempDown’

A pulse of duration ‘tTimeButtonPulse’ is generated at this output, if \

1. at the parameter ‘xVisuSetpTempDown’ OR\

2. at the output of the selected button ‘xButtonX’ (selection via ‘eSelectButtonForSetpTempDown’)\

a rising edge is detected ( = actuation ). Two operating modes are distinguished (parameter ‘eSetpTempOpMode’): 1) SETPOINT_1: for each pulse at the output ‘xButtonSetpTempDown’ in day operation the adjustment of setpoint 1 is decreased by the step size for setpoint 1 1) SETPOINT_2: for each pulse at the output ‘xButtonSetpTempDown’ in day operation the adjustment of setpoint 2 is decreased by the step size for setpoint 2\

Buttons 1 - 4 (Button 1 = right, Button 4 = left)

Each button can be assigned a defined function in the configuration, which is shown at the assigned output ‘eFunctionButtonXFb’ (X = 1 .. 4). Independent of this, each actuation of button X is recorded and, depending on the operating mode (parameter ‘eButtonXOutpMode’), is displayed at the output ‘xButtonX’.\

1. ‘eButtonXOutpMode’ = RAW: The output is active in parallel with the button actuation.\

2. ‘eButtonXOutpMode’ = PULSE: At the output a pulse of duration ‘tTimeButtonPulse’ is generated for each new actuation of the button

Digital inputs 1 - 4 (depending on version)

Each digital input can be assigned a defined function in the configuration, which is shown at the assigned output ‘eFunctionDIXFb’ (X = 1 .. 4). Independent of this, the current state of each input X is recorded and displayed at the output ‘xDIX’ (FALSE = open, TRUE = closed).\

Display of faults

Faults are indicated at the collective output ‘xAlarm’ ( = TRUE ). It includes communication faults (time delay: gc_Parameters.gc_tOnDelayxAlarmCom, default = 60s) and device faults (direct). At the output ‘eErrorCodeCom’ an explanatory text for the cause is available in the event of a communication error. It always shows the cause of the last communication error.

Codesys

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 every rising edge )
Input	xUpdateSetp	BOOL	FALSE	Update of setpoints (on every rising edge )
Input	xUpdateConfig	BOOL	FALSE	Configuration update (on each rising edge) (read access)
Input	xUpdateStates	BOOL	FALSE	Update of the states ( on every rising edge )
Input	xUpdateInfo	BOOL	FALSE	Update of the information ( on every rising edge )
Input	rAO1Manual	REAL	0.0	Status of analog output 1 (‘eAnalogOutputsMode’ = THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 534, FC16)
Input	rAO2Manual	REAL	0.0	Status of analog output 2 (‘eAnalogOutputsMode’ = THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE) (0.0 - 100.0% = 0.0 - 10.0 V) (address 535, FC16)
Input	xDsplSymb_Alarm	BOOL	FALSE	Enable/disable display of the symbol ‘Fault’ (TRUE = display) (Coil 256, FC15)
Input	xDsplSymb_Heat	BOOL	FALSE	Enable/disable display of the symbol ‘Heating, Controller- Heat mode’ (TRUE = display) (Coil 257, FC15)
Input	xDsplSymb_Cool	BOOL	FALSE	Enable/disable display of the symbol ‘Cooling, Controller- Cool mode’ (TRUE = display) (Coil 258, FC15)
Input	xDsplSymb_Wind	BOOL	FALSE	Enable/disable display of the symbol ‘Window, Energy lock’ (TRUE = display) (Coil 259, FC15)
Input	xDsplSymb_DewP	BOOL	FALSE	Enable/disable display of the symbol ‘Dew point, Dew point alarm’ (TRUE = display) (Coil 260, FC15)
Input	xDsplSymb_Off	BOOL	FALSE	Enable/disable display of the symbol ‘Off, Controller- Off’ (TRUE = display) (Coil 261, FC15)
Input	xUpdateDateTime	BOOL	FALSE	Update device date/time (on each rising edge)
Input	rExtValue1	REAL	0.0	External measured value 1 for display on the RBG (Modbus register content = rExtValue1 * rExtValue1Mult) (address 519, FC16)
Input	rExtValue2	REAL	0.0	External measured value 2 for display on the RBG (Modbus register content = rExtValue2 * rExtValue2Mult) (address 520, FC16)
Input	rExtValue3	REAL	0.0	External measured value 3 for display on the RBG (Modbus register content = rExtValue3 * rExtValue3Mult) (address 521, FC16)
Input	rExtValue4	REAL	0.0	External measured value 4 for display on the RBG (Modbus register content = rExtValue4 * rExtValue4Mult) (address 522, FC16)
Input	wAutoFanStages	WORD	0	Input for automatic specification of the fan stage
Input	eRegMode	THERMOKON_WRF06_REGULATION_MODE	THERMOKON_WRF06_REGULATION_MODE.NO_REGULATION	Current controller mode in the device (address 533, FC16)
Input	rExtRoomTemp	REAL	0.0	External temperature as a substitute for the internal room temperature (address 536, FC16) (‘eRoomTempMode’ = THERMOKON_WRF06_ROOM_TEMP_MODE.EXTERNAL_VALUE)
Input	xMode	BOOL	FALSE	Current room occupancy to the device (TRUE = occupied, comfort mode, day operation, FALSE = not occupied, setback mode, night operation) (address 528, FC16)
Input	rSetpTemp1BaseDay	REAL	22.0	Setpoint temperature 1: Base set temperature in day operation ( degrees Celsius)
Input	rSetpTemp1Night	REAL	18.0	Setpoint temperature 1: Set temperature in night operation (degrees Celsius)
Input	rSetpTemp2BaseDay	REAL	22.0	Setpoint temperature 2: Base set temperature in day operation ( degrees Celsius)
Input	rSetpTemp2Night	REAL	18.0	Setpoint temperature 2: Set temperature in night operation (degrees Celsius)
Input	xResError	BOOL	FALSE	Reinitialization of the output ‘eErrorCodeCom’ ( on every rising edge )
Inout	ModbusClient	ModbusClientBase		Client of the device
Output	wDeviceCode	WORD	0	Device identification (address 0, FC03)
Output	wFirmwareVer	WORD	0	Device firmware version (address 1, FC03)
Output	eDeviceType	THERMOKON_WRF06_DEVICE_TYPE		Device configuration (address 2, FC03)
Output	rRoomTemp	REAL	0.0	Current room temperature in the selected unit ( address 258, FC03)
Output	rRelHumidity	REAL	0.0	Relative room humidity in percent (if sensor present) (address 270, FC03)
Output	rAO1	REAL	0.0	Current state at analog output 1 ( 0.0 - 100.0% = 0.0 - 10.0 V )
Output	rAO2	REAL	0.0	Current state at analog output 2 ( 0.0 - 100.0% = 0.0 - 10.0 V )
Output	eRegModeDev	THERMOKON_WRF06_REGULATION_MODE_DEVICE		THERMOKON_WRF06_ANALOG_OUTP_MODE.AUTOMATIC_MODE: address 268, FC03 THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE: address 535, FC03 Current controller mode from the device (address 269, FC03)
Output	rSetpTemp1OffMaxFb	REAL	0.0	Temperature setpoint 1: Maximum value - adjustment of the base set temperature — feedback (address 17, FC03)
Output	rSetpTemp1OffMinFb	REAL	0.0	Temperature setpoint 1: Minimum value - adjustment of the base set temperature — feedback (address 18, FC03)
Output	rSetpTemp1StepFb	REAL	0.0	Temperature setpoint 1: +/- - adjustment value on a button actuation — feedback (address 19, FC03)
Output	rSetpTemp1ResetFb	REAL	0.0	Temperature setpoint 1: Base setpoint after a reset operation — feedback (address 20, FC03)
Output	rSetpTemp2OffMaxFb	REAL	0.0	Temperature setpoint 2: Maximum value - adjustment of the base set temperature — feedback (address 21, FC03)
Output	rSetpTemp2OffMinFb	REAL	0.0	Temperature setpoint 2: Minimum value - adjustment of the base set temperature — feedback (address 22, FC03)
Output	rSetpTemp2StepFb	REAL	0.0	Temperature setpoint 2: +/- - adjustment value on a button actuation — feedback (address 23, FC03)
Output	rSetpTemp2ResetFb	REAL	0.0	Temperature setpoint 2: Base setpoint after a reset operation — feedback (address 24, FC03)
Output	rSetpTemp1Off	REAL	0.0	Temperature setpoint 1: Current adjustment of the base set temperature (address 259, FC03) (actual_values_1)
Output	rSetpTemp1	REAL	0.0	Temperature setpoint 1: Current setpoint (address 260, FC03) (actual_values_1)
Output	rSetpTemp2Off	REAL	0.0	Temperature setpoint 2: Current adjustment of the base set temperature (address 261, FC03) (actual_values_1)
Output	rSetpTemp2	REAL	0.0	Temperature setpoint 2: Current setpoint (address 262, FC03) (actual_values_1)
Output	xButtonSetpTempUp	BOOL	FALSE	Generation of a pulse of duration ‘tTimeButtonPulse’, if
Output	xButtonSetpTempDown	BOOL	FALSE	Generation of a pulse of duration ‘tTimeButtonPulse’, if
Output	xModeDev	BOOL	FALSE	Current room occupancy from the device (TRUE = occupied, comfort mode, day operation) (address 264, FC03)
Output	xButtonPresence	BOOL	FALSE	Generation of a pulse of duration ‘tTimeButtonPulse’, if
Output	eFanModeDev	THERMOKON_WRF06_FAN_OP_MODE		1. at the parameter ‘xVisuPresence’ OR 2. at the output of the selected button ‘xButtonX’ (selection via ‘eSelectButtonForPresence’) a rising edge is detected ( = actuation ) Current operating mode of the fan (address 263, FC03)
Output	wNbrOfFanStages	WORD	0	Number of fan stages
Output	xAutoFanStages	BOOL	FALSE	Display of automatic mode for fan stages (FALSE: manual correction active, TRUE = automatic mode active)
Output	xButtonFanStages	BOOL	FALSE	Generation of a pulse of duration ‘tTimeButtonPulse’, if
Output	xButton1	BOOL	FALSE	Actuation of button 1 (right) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
Output	eFunctionButton1Fb	THERMOKON_WRF06_BUTTON_FUNCTION		Function of button 1 — feedback (address 6, FC03)
Output	xButton2	BOOL	FALSE	Actuation of button 2 (middle right) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
Output	eFunctionButton2Fb	THERMOKON_WRF06_BUTTON_FUNCTION		Function of button 2 — feedback (address 7, FC03)
Output	xButton3	BOOL	FALSE	Actuation of button 3 (middle left) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
Output	eFunctionButton3Fb	THERMOKON_WRF06_BUTTON_FUNCTION		Function of button 3 — feedback (address 8, FC03)
Output	xButton4	BOOL	FALSE	Actuation of button 4 (left) (RAW, pulse with duration ‘tTimeButtonPulse’) (addresses 256 & 257, FC03)
Output	eFunctionButton4Fb	THERMOKON_WRF06_BUTTON_FUNCTION		Function of button 4 — feedback (address 9, FC03)
Output	xDI1	BOOL	FALSE	State of digital input 1 (assignment depending on function) (FALSE = open, TRUE = closed) (address 265, FC03)
Output	eFunctionDI1Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION		Function of digital input 1 — feedback (address 26, FC03)
Output	xDI2	BOOL	FALSE	State of digital input 2 (assignment depending on function) (FALSE = open, TRUE = closed) (address 266, FC03)
Output	eFunctionDI2Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION		Function of digital input 2 — feedback (address 27, FC03)
Output	xDI3	BOOL	FALSE	State of digital input 3 (assignment depending on function) (FALSE = open, TRUE = closed) (address 267, FC03)
Output	eFunctionDI3Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION		Function of digital input 3 — feedback (address 28, FC03)
Output	xDI4	BOOL	FALSE	State of digital input 4 (assignment depending on function) (FALSE = open, TRUE = closed) (address 268, FC03)
Output	eFunctionDI4Fb	THERMOKON_WRF06_DIGITAL_INPUT_FUNCTION		Function of digital input 4 — feedback (address 29, FC03)
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	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	wMaxFanStageManDay	WORD	2	Maximum fan stage for manual correction in day operation
Input Const	wMinFanStageManDay	WORD	0	Minimum fan stage for manual correction in day operation
Input Const	eSetpTempOpMode	THERMOKON_WRF06_SETP_TEMP_OPERATION_MODE	THERMOKON_WRF06_SETP_TEMP_OPERATION_MODE.SETPOINT_1	Selection of the setpoint (1, 2) for adjustment by the buttons on the room control unit
Input Const	eButtonSelectionForSetpTempDown	THERMOKON_WRF06_BUTTON_SELECTION	THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_2	Selection of the button (1 - 4) to choose the button for decreasing the setpoint temperature (output ‘xButtonSetpTempDown’)
Input Const	eButtonSelectionForSetpTempUp	THERMOKON_WRF06_BUTTON_SELECTION	THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_1	Selection of the button (1 - 4) to choose the button for increasing the setpoint temperature (output ‘xButtonSetpTempUp’)
Input Const	eButtonSelectionForFanStages	THERMOKON_WRF06_BUTTON_SELECTION	THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_3	Selection of the button (1 - 4) to choose the fan stages (output ‘xButtonFanStages’)
Input Const	eButtonSelectionForPresence	THERMOKON_WRF06_BUTTON_SELECTION	THERMOKON_WRF06_BUTTON_SELECTION.BUTTON_4	Selection of the button (1 - 4) for the presence function ( output ‘xButtonPresence’)
Input Const	xVisuSetpTempDown	BOOL	FALSE	Visualization: Actuation of the button to lower the setpoint temperature in day operation (on each rising edge )
Input Const	xVisuSetpTempUp	BOOL	FALSE	Visualization: Actuation of the button to increase the setpoint temperature in day operation (on each rising edge )
Input Const	xVisuAutoFanStages	BOOL	FALSE	Visualization: Actuation of the button to switch to automatic mode for fan stages (on each rising edge)
Input Const	xVisuFanStages	BOOL	FALSE	Visualization: Actuation of the button for the fan stages ( on each rising edge)
Input Const	xVisuPresence	BOOL	FALSE	Visualization: Actuation of the presence button (on each rising edge)
Input Const	rExtValue4Mult	REAL	10.0	Multiplier for external measured value 4 for display on the RBG (address 522 = rExtValue4 * rExtValue4Mult)
Input Const	rExtValue3Mult	REAL	10.0	Multiplier for external measured value 3 for display on the RBG (address 521 = rExtValue3 * rExtValue3Mult)
Input Const	rExtValue2Mult	REAL	10.0	Multiplier for external measured value 2 for display on the RBG (address 520 = rExtValue2 * rExtValue2Mult)
Input Const	rExtValue1Mult	REAL	10.0	Multiplier for external measured value 1 for display on the RBG (address 519 = rExtValue1 * rExtValue1Mult)
Input Const	eRoomTempMode	THERMOKON_WRF06_ROOM_TEMP_MODE	THERMOKON_WRF06_ROOM_TEMP_MODE.INTERNAL_SENSOR	Mode for the source of the room temperature (EXTERNAL_VALUE: <br/>*<br/> ‘rExtRoomTemp’ defines the room temperature)
Input Const	xDsplAlarm4	BOOL	FALSE	Enable/disable display of alarm message 4 on the RBG ( TRUE = display)
Input Const	xDsplAlarm3	BOOL	FALSE	Enable/disable display of alarm message 3 on the RBG ( TRUE = display)
Input Const	xDsplAlarm2	BOOL	FALSE	Enable/disable display of alarm message 2 on the RBG ( TRUE = display)
Input Const	xDsplAlarm1	BOOL	FALSE	Enable/disable display of alarm message 1 on the RBG ( TRUE = display)
Input Const	eAnalogOutputsMode	THERMOKON_WRF06_ANALOG_OUTP_MODE	THERMOKON_WRF06_ANALOG_OUTP_MODE.MANUAL_MODE	Mode for the analog outputs AO1 and AO2 (MANUAL_MODE: <br/>*<br/> ‘rAO1Manual’ and ‘rAO2Manual’ define the current states of the analog outputs )
Input Const	wDateTime_Year	WORD	2024	Update of date/time: Current year (2000 - 2099)
Input Const	wDateTime_Month	WORD	1	Update of date/time: Current month (1 - 12 )
Input Const	wDateTime_DayOfMonth	WORD	1	Update of date/time: Current day of the month (1 - 31)
Input Const	wDateTime_Hours	WORD	0	Update of date/time: Current hour of the day (0 - 23)
Input Const	wDateTime_Minutes	WORD	0	Update of date/time: Current minute of the hour (0 - 59)
Input Const	wDateTime_Seconds	WORD	0	Update of date/time: Current second of the minute (0 - 59)
Input Const	eButton4OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE	THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW	Operating mode of output ‘xButton4’ ( RAW, PULSE )
Input Const	eButton3OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE	THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW	Operating mode of output ‘xButton3’ ( RAW, PULSE )
Input Const	eButton2OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE	THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW	Operating mode of output ‘xButton2’ ( RAW, PULSE )
Input Const	eButton1OutpMode	THERMOKON_WRF06_BUTTON_OUTP_MODE	THERMOKON_WRF06_BUTTON_OUTP_MODE.RAW	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 pressed
Input Const	tTimeUpdateInfo	TIME	TIME#0ms	Update interval for the processes influenced by the input ‘xUpdateInfo’
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'

\