# 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                                                                  | <p>Address of the device ( 1 .. 247 ) ( 1 .. 63 via DIP<br>switch, 1 .. 247 via Modbus commands )</p>                                                                          |
| Input       | `xUpdateActual`         | `BOOL`                                       | FALSE                                                              | <p>Update of actual values (on each rising edge<br>) (Range: operation)</p>                                                                                                    |
| Input       | `xUpdateSetp`           | `BOOL`                                       | FALSE                                                              | <p>Update of setpoint values (on every rising edge<br>)</p>                                                                                                                    |
| Input       | `xUpdateConfigRead`     | `BOOL`                                       | FALSE                                                              | <p>Update of configuration (read access) (on<br>each rising edge)</p>                                                                                                          |
| Input       | `xUpdateConfigWrite`    | `BOOL`                                       | FALSE                                                              | <p>Update of the configuration (write access) (<br>on each rising edge)</p>                                                                                                    |
| Input       | `xUpdateStates`         | `BOOL`                                       | FALSE                                                              | <p>Update of states (registers 256 - 257) (on<br>each rising edge)</p>                                                                                                         |
| Input       | `xResDefault`           | `BOOL`                                       | FALSE                                                              | <p>Reset configuration to default state (<br>registers 0 - 69) (coils 0 - 5) (on each rising<br>edge)</p>                                                                      |
| Input       | `rSetpTempBase`         | `REAL`                                       | 22.0                                                               | Base setpoint temperature ( degrees Celsius )                                                                                                                                  |
| Input       | `xLED9`                 | `BOOL`                                       | FALSE                                                              | Control of LED9 ( TRUE = On )                                                                                                                                                  |
| Input       | `xEnOffset`             | `BOOL`                                       | FALSE                                                              | <p>Enable / disable the influence of the setpoint adjuster<br>‘rOffset’ on the setpoint temperature ( ‘rSetpTemp’ )</p>                                                        |
| Input       | `xResError`             | `BOOL`                                       | FALSE                                                              | <p>Reinitialization of the output 'eErrorCodeCom' (on each<br>rising edge)</p>                                                                                                 |
| 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`                                       |                                                                    | <p>Indicator whether the calibration of the sensors must be<br>performed in the device (TRUE = calibration in device required, FALSE = calibration in<br>FB required)</p>      |
| 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                                                              | <p>Actuation of button 1 ( RAW, pulse with duration<br>‘tTimeButtonPulse’ )</p>                                                                                                |
| 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                                                              | <p>State of digital input 1 (assignment depending on<br>function 'eFunctionDI1') (FALSE = Open, TRUE =<br>Closed)</p>                                                          |
| Output      | `eFunctionDI1Fb`        | THERMOKON\_WRF07\_DIGITAL\_INPUT\_FUNCTION   |                                                                    | Function of digital input 1 — feedback                                                                                                                                         |
| Output      | `xDI2`                  | `BOOL`                                       | FALSE                                                              | <p>State of digital input 2 (assignment depending on<br>function 'eFunctionDI2') (FALSE = Open, TRUE =<br>Closed)</p>                                                          |
| Output      | `eFunctionDI2Fb`        | THERMOKON\_WRF07\_DIGITAL\_INPUT\_FUNCTION   |                                                                    | Function of digital input 2 — feedback                                                                                                                                         |
| Output      | `xDI3`                  | `BOOL`                                       | FALSE                                                              | <p>State of digital input 3 (assignment depending on<br>function 'eFunctionDI1') (FALSE = Open, TRUE =<br>Closed)</p>                                                          |
| Output      | `eFunctionDI3Fb`        | THERMOKON\_WRF07\_DIGITAL\_INPUT\_FUNCTION   |                                                                    | Function of digital input 3 — feedback                                                                                                                                         |
| Output      | `xDI4`                  | `BOOL`                                       | FALSE                                                              | <p>State of digital input 4 (assignment depending on<br>function 'eFunctionDI2') (FALSE = Open, TRUE =<br>Closed)</p>                                                          |
| 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                                                                | <p>Offset of the room humidity ( for calibration of the humidity sensor<br>) in percent</p>                                                                                    |
| 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                                                                | <p>Adjustment range of the setpoint potentiometer (symmetric,<br>3.0 = +/- 3.0K)</p>                                                                                           |
| Input Const | `rRoomTempOffset`       | `REAL`                                       | 0.0                                                                | <p>Offset of the room temperature ( for calibration of the<br>temperature sensor ) in K</p>                                                                                    |
| 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                         | <p>General operating mode of the device (ROOM\_CONTROL\_UNIT: device<br>serves as RBG, INTERNAL\_REGULATION: setpoint formation /<br>temperature regulation in the device)</p> |
| Input Const | `tTimeButtonPulse`      | `TIME`                                       | TIME#1s0ms                                                         | <p>Duration of the pulse at the output if the assigned<br>button was actuated</p>                                                                                              |
| Input Const | `tTimeUpdateStates`     | `TIME`                                       | TIME#500ms                                                         | <p>Update interval for the processes influenced by the input<br>‘xUpdateStates’</p>                                                                                            |
| Input Const | `tTimeUpdateConfig`     | `TIME`                                       | TIME#0ms                                                           | <p>Update interval for the processes influenced by the input<br>‘xUpdateConfig’</p>                                                                                            |
| Input Const | `tTimeUpdateSetp`       | `TIME`                                       | TIME#45s0ms                                                        | <p>Update interval for operations influenced by the input<br>'xUpdateSetp'</p>                                                                                                 |
| Input Const | `tTimeUpdateActual`     | `TIME`                                       | TIME#3s0ms                                                         | <p>Update interval for operations influenced by the input<br>'xUpdateActual'</p>                                                                                               |
