# BELIMO\_P\_22RTX\_1U00X\_2\_EASY

## `BELIMO_P_22RTX_1U00X_2_EASY` (FB)

`FUNCTION_BLOCK` BELIMO\_P\_22RTX\_1U00X\_2\_EASY

### Representation

<figure><img src="/files/f040dac92af89d088ee5f2270dbfdc9ab2775a23" alt=""><figcaption></figcaption></figure>

### Short description

> Control of device series P-22RT..-1U00..-2 from Belimo
>
> Typical application: room operating unit in one zone

#### Guidelines - software creation

Supported Modbus function codes: 2, 3, 4, 6 and 16. For addressing, the address values are to be used, not the register addresses. Registers from 111 onward are persistent in the device and must not be written cyclically. Unused registers contain the value 65535 (unsigned)(FFFF - hex) or -1 (signed). Unused registers within the defined ranges may be read/written.

In the constellation `eEcoBoostOnOffIconMode` = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_ICON\_MODE.OPERATION\_MODE in ECO mode with the first rising edge at input `xBoostIcon` switched to On/Comfort mode. With the second rising edge, BOOST mode is then activated. When operated on the room operating unit, switching from ECO to BOOST takes place immediately.&#x20;

{% hint style="info" %}
Remedy: write address 30 with FC06 !!! with the desired value; do not write address 22 at the same time.
{% endhint %}

Measured values - calibration: Class 4

### Interfaces

#### Inputs

| Name                  | Data type                                    | Value range | Initial value                                     | Function                                                                                      |
| --------------------- | -------------------------------------------- | ----------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| *xEn*                 | `BOOL`                                       |             | TRUE                                              | Enable / disable communication (TRUE = enable)                                                |
| *byUnitId*            | `BYTE`                                       |             | 0                                                 | Device address (0 .. 255)                                                                     |
| *xUpdateActual*       | `BOOL`                                       |             | FALSE                                             | Update of the actual values (on every rising edge)                                            |
| *xUpdateSetp*         | `BOOL`                                       |             | FALSE                                             | Update of setpoints (on every rising edge)                                                    |
| *xUpdateConfig*       | `BOOL`                                       |             | FALSE                                             | Update of the configuration (on every rising edge) (read access)                              |
| *xUpdateStates*       | `BOOL`                                       |             | FALSE                                             | Update of the states (on every rising edge)                                                   |
| *xUpdateInfo*         | `BOOL`                                       |             | FALSE                                             | Update of the information (on every rising edge)                                              |
| *rSetpTempAbsNight*   | `REAL`                                       |             | 18.0                                              | Absolute room setpoint temperature in night mode (unit depends on register address 122)       |
| *rSetpTempAbsBaseDay* | `REAL`                                       |             | 22.0                                              | Absolute base room setpoint temperature in day mode (unit depends on register address 120)    |
| *rSetpTempRelNight*   | `REAL`                                       |             | 0.0                                               | Relative room setpoint temperature in night mode (unit depends on register address 122)       |
| *rSetpTempRelBaseDay* | `REAL`                                       |             | 0.0                                               | Relative base room setpoint temperature in day mode (unit depends on register address 122)    |
| *xMode*               | `BOOL`                                       |             | FALSE                                             | Input for operating mode/the On/Off icon (function depending on register addresses 139 - 141) |
| *xEcoIcon*            | `BOOL`                                       |             | FALSE                                             | Input for operating mode/the Eco icon (function depending on register addresses 139 - 141)    |
| *xBoostIcon*          | `BOOL`                                       |             | FALSE                                             | Input for operating mode/the Boost icon (function depending on register addresses 139 - 141)  |
| *eSetpFanLevel*       | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL       |             | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL.STAGE\_0   | Set fan stage                                                                                 |
| *eIconsHeatCool*      | BELIMO\_P\_22RTX\_1U00X\_2\_MODE\_HEAT\_COOL |             | BELIMO\_P\_22RTX\_1U00X\_2\_MODE\_HEAT\_COOL.NONE | Selection of the icon display for heating or cooling operation                                |
| *xDsplIconWarn*       | `BOOL`                                       |             | FALSE                                             | Input for displaying the warning icon (TRUE = enabled)                                        |
| *xDsplIconWind*       | `BOOL`                                       |             | FALSE                                             | Input for displaying the window icon (TRUE = enabled)                                         |
| *xEnLocalAdj*         | `BOOL`                                       |             | FALSE                                             | Input for displaying the controls on the room operating unit (TRUE = display)                 |
| *xResError*           | `BOOL`                                       |             | FALSE                                             | Input for resetting the output `eErrorCodeCom` (on every rising edge)                         |

#### Outputs

| Name                     | Data type                                    | Value range | Initial value | Function                                                                                                                                                                                         |
| ------------------------ | -------------------------------------------- | ----------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *eOperationMode*         | BELIMO\_P\_22RTX\_1U00X\_2\_OPERATION\_MODE  |             |               | Display of the current operating mode on the room operating unit (register address 30)                                                                                                           |
| *eEcoBoostOnOffIconMode* | BELIMO\_P\_22RTX\_1U00X\_2\_ICON\_MODE       |             |               | Display of the current operating mode                                                                                                                                                            |
| *xModeDev*               | `BOOL`                                       |             |               | Operating mode of zone control on the room operating unit (FALSE = night mode, TRUE = day mode)                                                                                                  |
| *xButtonPresence*        | `BOOL`                                       |             |               | Actuation of the presence button (pulse with duration `tTimeButtonPulse`) (RBG and/or VISU)                                                                                                      |
| *rSetpTempAbs*           | `REAL`                                       |             |               | Current absolute setpoint temperature depending on the parameter `eTemperatureUnit` (e.g. +23.5 degrees Celsius) (register address 34) (unit depends on register address 120)                    |
| *rOffset*                | `REAL`                                       |             |               | Current difference between `rSetpTempAbs` and `rAdjCenterSetpTemp` (range: +/- `rAdjOffsetSetpTemp`) in day mode (unit depends on register address 120)                                          |
| *rSetpTempRel*           | `REAL`                                       |             |               | Current relative setpoint temperature depending on the parameter `eOffsetUnit` (e.g. -2.0 Kelvin) (range: +/- `rAdjOffsetSetpTemp`) (register address 36) (unit depends on register address 122) |
| *rTemp*                  | `REAL`                                       |             |               | Room temperature (unit depends on register address 120)                                                                                                                                          |
| *rRelHumidity*           | `REAL`                                       |             |               | Relative room humidity in percent                                                                                                                                                                |
| *rCO2*                   | `REAL`                                       |             |               | CO2 concentration (ppm)                                                                                                                                                                          |
| *eCO2Status*             | BELIMO\_P\_22RTX\_1U00X\_2\_CO2\_STATUS      |             |               | Current status of the CO2 actual-value monitoring                                                                                                                                                |
| *xSensorOffsetInDevice*  | `BOOL`                                       |             |               | Indication whether the sensor calibration must be performed in the device (TRUE = calibration required in the device, FALSE = calibration required in the FB)                                    |
| *rDewPointTemp*          | `REAL`                                       |             |               | Dew point temperature (unit depends on register address 120 in degrees Celsius or Fahrenheit)                                                                                                    |
| *eFanLevel*              | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL       |             |               | Current fan stage depending on the parameter `eFanLevelConfig` (register address 22)                                                                                                             |
| *xDI1*                   | `BOOL`                                       |             |               | State of digital input 1 depending on the parameter `eDI1OutpMode` (RAW: FALSE = open, TRUE = closed with +24VDC, PULSE: pulse with duration `tTimeDIPulse` on every rising edge at input DI1)   |
| *xEnLocalAdjFb*          | `BOOL`                                       |             |               | Indication whether local operation is possible (TRUE = local operation possible) — feedback                                                                                                      |
| *eBusTermin*             | BELIMO\_P\_22RTX\_1U00X\_2\_BUS\_TERMINATION |             |               | Status of the Modbus termination resistor (Active = Enabled)                                                                                                                                     |
| *sSerialNum*             | `STRING`                                     |             |               | Serial number of the device                                                                                                                                                                      |
| *wFirmwareVer*           | `WORD`                                       |             |               | Firmware version of the device                                                                                                                                                                   |
| *xAlarmCom*              | `BOOL`                                       |             |               | Collective fault - communication (TRUE = fault)                                                                                                                                                  |
| *eErrorCodeCom*          | ModbusErrorCode                              |             |               | Error code - communication (0 = no error)                                                                                                                                                        |
| *eErrorCodeDev*          | SPLUSS\_ERROR\_CODE\_TYPE\_2                 |             |               | Error code - device (0 = no error)                                                                                                                                                               |
| *xBusy*                  | `BOOL`                                       |             |               | Communication display (TRUE = communication)                                                                                                                                                     |

#### Inputs and outputs

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

#### General information on setpoints / parameters (addresses 110 - 149)

The following setpoints / parameters (addresses 110 - 149) are common to the function blocks with index `_EASY` and `_FULL` . In the function block with index `_FULL` additional setpoints / parameters can also be defined, which are shown in the table after next. These additional setpoints / parameters are only read in the function block with index `_EASY` and stored in internal variables. These setpoints / parameters are defined externally there, e.g. using the 'Belimo Assistant' app.

#### Setpoints / parameters EASY / FULL

| Name                     | Data type                                              | Value range | Initial value                                                                     | Address | Function                                                                                                                                                                            |
| ------------------------ | ------------------------------------------------------ | ----------- | --------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **tTimeUpdateActual**    | `TIME`                                                 |             | T#3s                                                                              |         | Update interval for the processes influenced by the input `xUpdateActual` can be influenced (0 = no automatic update, > 0 cyclic update)                                            |
| **tTimeUpdateSetp**      | `TIME`                                                 |             | T#0s                                                                              |         | Update interval for the processes influenced by the input `xUpdateSetp` can be influenced (0 = no automatic update, > 0 cyclic update)                                              |
| **tTimeUpdateConfig**    | `TIME`                                                 |             | T#0s                                                                              |         | Update interval for the processes influenced by the input `xUpdateConfig` can be influenced (0 = no automatic update, > 0 cyclic update)                                            |
| **tTimeUpdateStates**    | `TIME`                                                 |             | T#500ms                                                                           |         | Update interval for the processes influenced by the input `xUpdateStates` can be influenced (0 = no automatic update, > 0 cyclic update)                                            |
| **tTimeUpdateInfo**      | `TIME`                                                 |             | T#0s                                                                              |         | Update interval for the processes influenced by the input `xUpdateInfo` can be influenced (0 = no automatic update, > 0 cyclic update)                                              |
| **eDI1OutpMode**         | BELIMO\_P\_22RTX\_1U00X\_2\_DIGITAL\_INPUT\_OUTP\_MODE |             | BELIMO\_P\_22RTX\_1U00X\_2\_DIGITAL\_INPUT\_OUTP\_MODE.RAW                        |         | Operating mode of the output `xDI1` (RAW, PULSE)                                                                                                                                    |
| **tTimeDIPulse**         | `TIME`                                                 |             | T#1s                                                                              |         | Duration of the pulse at the output `xDI1`, if a rising edge is detected at the digital input (`eDI1OutpMode` = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_DIGITAL\_INPUT\_OUTP\_MODE.PULSE) |
| **eFanStageControlMode** | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_STAGES\_CONTROL\_MODE |             | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_STAGES\_CONTROL\_MODE.AUTOMATIC\_STAGES\_CONTROL | 31      | Definition of the operating mode for controlling the fan stages                                                                                                                     |
| **xVisuPresence**        | `BOOL`                                                 |             | FALSE                                                                             |         | Actuation of the presence button in the visualization (affects the output `xButtonPresence`)                                                                                        |
| **tTimeButtonPulse**     | `TIME`                                                 |             | T#1s                                                                              |         | Duration of the pulse at the output 'xButton Presence'                                                                                                                              |

#### Additional setpoints / parameters FULL

| Name                              | Data type                                              | Value range                              | Initial value                                                             | Address   | Function                                                                                                                                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *rTempOffset*                     | `REAL`                                                 | +/- 15.0 K                               | 0.0                                                                       | 110       | Room temperature offset (for calibration of the temperature sensor) in K                                                                                                                                                                                            |
| *rHumidityOffset*                 | `REAL`                                                 | +/- 20.0 %                               | 0.0                                                                       | 111       | Room humidity offset (for calibration of the humidity sensor) in percent                                                                                                                                                                                            |
| *rCO2Offset*                      | `REAL`                                                 | +/- 500 ppm                              | 0.0                                                                       | 112       | Offset of the CO2 sensor (for calibration of the CO2 sensor) in ppm                                                                                                                                                                                                 |
| *rCO2\_LED\_ThresholdGreenYellow* | `REAL`                                                 | 600.0 - 1249.0 ppm, integer values only  | 1000.0                                                                    | 115       | Threshold for switching the LED color from green to yellow                                                                                                                                                                                                          |
| *rCO2\_LED\_ThresholdYellowRed*   | `REAL`                                                 | 1250.0 - 2000.0 ppm, integer values only | 1500.0                                                                    | 116       | Threshold for switching the LED color from yellow to red                                                                                                                                                                                                            |
| *xCO2\_LED\_Enable*               | `BOOL`                                                 |                                          | TRUE                                                                      | 117       | Enable / disable the CO2 LED (TRUE = enable)                                                                                                                                                                                                                        |
| *eTemperatureUnit*                | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE          |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE.DEGREES\_CELSIUS            | 120       | Definition of the unit for the temperature (influence: `rTemp` (address 1), `rDewPointTemp` (address 5) and `rSetpTemp` (address 34))                                                                                                                               |
| *eTemperatureUnitDisplay*         | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE\_DISPLAY |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE\_DISPLAY.DEGREES\_CELSIUS   | 121       | Definition of the unit for the temperature display on the display (influence: display)                                                                                                                                                                              |
| *eOffsetUnit*                     | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE          |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_UNIT\_TEMPERATURE.DEGREES\_CELSIUS            | 122       | Definition of the unit for the relative setpoint temperature (influence: `rSetpTempRel` (address 36))                                                                                                                                                               |
| *eColorScheme*                    | BELIMO\_P\_22RTX\_1U00X\_2\_COLOR\_SCHEME              |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_COLOR\_SCHEME.WHITE\_BACKGROUND               | 130       | Definition of the color scheme of the display                                                                                                                                                                                                                       |
| *eDsplIconsHeatCool*              | BELIMO\_P\_22RTX\_1U00X\_2\_SYMBOL\_VISIBILITY         |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_SYMBOL\_VISIBILITY.INVISIBLE                  | 134       | Display of the visibility of the icons for heating and cooling operation                                                                                                                                                                                            |
| *eWarningIconFunct*               | BELIMO\_P\_22RTX\_1U00X\_2\_WARNING\_ICON\_FUNCTION    |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_WARNING\_ICON\_FUNCTION.DEVICE\_ERROR\_STATUS | 135       | Definition of the function of the icon `Warning`                                                                                                                                                                                                                    |
| *eWindowIconFunct*                | BELIMO\_P\_22RTX\_1U00X\_2\_WINDOW\_ICON\_FUNCTION     |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_WINDOW\_ICON\_FUNCTION.INPUT\_xDsplIconWind   | 136       | Definition of the function of the icon `Window`                                                                                                                                                                                                                     |
| *eEcoBoostOnOffIconMode*          | BELIMO\_P\_22RTX\_1U00X\_2\_ICON\_MODE                 |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_ICON\_MODE.PRESENCE\_BUTTON                   | 139 - 141 | Central definition of the icon functions `Eco`, `Boost` and `OnOff`                                                                                                                                                                                                 |
| *tBoostModeDuration*              | `TIME`                                                 |                                          | T#900s                                                                    | 142       | Duration of the operating mode `Boost`                                                                                                                                                                                                                              |
| *eSetpTempMode*                   | BELIMO\_P\_22RTX\_1U00X\_2\_SETP\_TEMP\_MODE           |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_SETP\_TEMP\_MODE.ABSOLUTE\_SETPOINT           | 145       | Definition of the operating mode of the setpoint display (absolute / relative)                                                                                                                                                                                      |
| *rAdjCenterSetpTempAbs*           | `REAL`                                                 | +15.0 … +35.0 degrees Celsius            | 22.0                                                                      | 146       | Definition of the absolute base setpoint temperature (center value) for adjusting the setpoint temperature (+15.00 - 35.00 degrees Celsius) (automatic, internal conversion to other temperature units in the RBG) Affects the absolute setpoint temperature.       |
| *rAdjOffsetSetpTempAbs*           | `REAL`                                                 | -5.0 … +5.0 Kelvin                       | 3.0                                                                       | 147       | Definition of the adjustment range around the absolute base setpoint temperature (center value) (+/- 5.0 K) (automatic, internal conversion to other temperature units in the RBG). Affects the adjustment ranges of the absolute and relative setpoint temperature |
| *eFanLevelConfig*                 | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL\_CONFIG         |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL\_CONFIG.SEVEN\_STAGES              | 148       | Definition of the number of fan stages                                                                                                                                                                                                                              |
| *eFanControlMode*                 | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_CONTROL\_MODE         |                                          | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_CONTROL\_MODE.MANUAL\_MODE\_ONLY         | 1498      | Definition of the operating mode for controlling the fan                                                                                                                                                                                                            |

### Function description

#### General

This function block controls room operating units of the device series P-22RT..-1U00..-2 from Belimo via Modbus communication. Configuration (addresses 110 - 149) is carried out in the function block with index `_FULL` internally, in the function block with index `_EASY` externally.

#### Operating modes - room operating unit (address 30) — outputs `eOperationMode` and `xModeDev`

Four operating modes are distinguished:

0: Off/Protection (`xModeDev` = FALSE) 1: On/Comfort (`xModeDev` = TRUE) 2: Eco Mode (`xModeDev` = TRUE) 3: Boost Mode (`xModeDev` = TRUE)

Operating modes 2 and 3 can only be selected in addition to operating mode 1. Operating mode 3 is active for a limited time and requires enablement of the highest fan stage for correct operation. The operating modes are automatically determined depending on the operating mode (see below).

#### Central definition of the functions of the icons / controls `OnOff`, `Eco` and `Boost` (operating modes)

A total of four operating modes are distinguished, which are defined via addresses 139 - 141: (FULL: parameter `eEcoBoostOnOffIconMode`, EASY: define the contents of addresses 139 - 141 externally according to the following list.)

#### Operating mode INVISIBLE

| Visibility | Operability | Function                      |
| ---------- | ----------- | ----------------------------- |
| Eco: NO    | Eco: NO     | Icons not visible or operable |
| Boost: NO  | Boost: NO   | Icons not visible or operable |
| OnOff: NO  | OnOff: NO   | Icons not visible or operable |

#### Operating mode DISPLAY\_MODE

| Visibility | Operability | Function                           |
| ---------- | ----------- | ---------------------------------- |
| Eco: YES   | Eco: NO     | Display of the Eco and OnOff modes |
| Boost: NO  | Boost: NO   | Display of the Eco and OnOff modes |
| OnOff: YES | OnOff: NO   | Display of the Eco and OnOff modes |

#### Operating mode OPERATION\_MODE

| Visibility | Operability | Function                                                                                 |
| ---------- | ----------- | ---------------------------------------------------------------------------------------- |
| Eco: YES   | Eco: YES    | Switching of the functions on the RBG as well as through rising edges at the icon inputs |
| Boost: YES | Boost: YES  | Switching of the functions on the RBG as well as through rising edges at the icon inputs |
| OnOff: YES | OnOff: YES  | Switching of the functions on the RBG as well as through rising edges at the icon inputs |

#### Operating mode PRESENCE\_BUTTON

| Visibility | Operability | Function                                           |
| ---------- | ----------- | -------------------------------------------------- |
| Eco: NO    | Eco: NO     | Usage time extension with external HVAC.Button1 FB |
| Boost: NO  | Boost: NO   | Usage time extension with external HVAC.Button1 FB |
| OnOff: YES | OnOff: YES  | Usage time extension with external HVAC.Button1 FB |

In DISPLAY mode, the operating modes Eco Mode and On/Comfort are defined by the inputs `xEcoIcon` and `xMode` (TRUE = On). If none of the inputs is active, operating mode Off/Protection is selected automatically.

In OPERATION mode, the operating modes ECO, Boost and OnOff are defined by the corresponding inputs (rising edges) and by operation on the room operating unit.

In PRESENCE\_BUTTON mode, the operating modes Off/Protection and On/Comfort are defined by the input `xMode` (rising edges: On / Comfort, falling edge: Off/Protection) and in parallel by operation on the room operating unit. With every change from night mode to day mode and vice versa triggered by the room operating unit, an impulse of duration `xButtonPresence` is generated at output `tTimeButtonPulse` .

#### Day mode / night mode (output `xModeDev`)

At output `xModeDev` the current state of day mode on the room operating unit is displayed (TRUE = day mode).

#### Room setpoint temperatures

The room setpoint temperatures are defined in different ways depending on the parameter `eSetpTempMode` (address 145):

1. Absolute setpoint (e.g. +23.5 degrees Celsius) (index `Abs`) (inputs `rSetpTempAbsNight`, `rSetpTempAbsBaseDay`) (output `rSetpTempAbs`)
2. Relative setpoint (e.g. +1.0 Kelvin) (index `Rel`) (inputs `rSetpTempRelNight`, `rSetpTempRelBaseDay`) (output `rSetpTempRel`)

Changes to the associated inputs are transferred immediately in the corresponding state, otherwise at the next transition to this state. Example: A change at input `rSetpTempAbsNight` is transferred and becomes effective immediately in night mode. Example: A change at input `rSetpTempBaseDay` does not take effect immediately in night mode, but only at the next transition to day mode.

Changes to the parameters `rAdjCenterSetpTempAbs` (address 146) or `rAdjOffsetSetpTempAbs` (address 147) are transferred immediately in the appropriate state, otherwise with a delay. (FULL). Changes to addresses 146 and 147 are recorded after the configuration has been read again and transferred accordingly (EASY). Changes to the content of address 146 affect only the absolute setpoint temperature; changes to the content of address 147 affect the absolute and relative setpoint temperature.

The current values at inputs `rSetpTempAbsNight` and `rSetpTempAbsBaseDay` are to be specified depending on the parameter `eTemperatureUnit` (address 120). At output output `rSetpTempAbs` the current setpoint value is then available in the selected unit. The current values at inputs `rSetpTempRelNight` and `rSetpTempRelBaseDay` are to be specified depending on the parameter `eOffsetUnit` (address 122). At output output `rSetpTempRel` the current setpoint value is then available in the selected unit.

Night mode - room setpoint temperature

When switching from day mode to night mode, the state at input `rSetpTempAbsNight` is transferred to the room operating unit and displayed there (`eSetpTempMode` = absolute setpoint temperature). When switching from day mode to night mode, the state at input `rSetpTempRelNight` is transferred to the room operating unit and displayed there (`eSetpTempMode` = relative setpoint temperature). Any change of state at input `rSetpTempXXXNight` is transferred to the room operating unit during night mode.

Day mode - room setpoint temperature

Case 1 - There is not yet a valid room setpoint temperature in day mode

When switching from night mode to day mode, the state at input `rSetpTempAbsBaseDay` is transferred to the room operating unit and displayed there. On the room operating unit, adjustment is possible in the symmetrical range defined by address 147. The step size is 0.5K.

Case 2 - There is already a valid room setpoint temperature in day mode

When switching from night mode to day mode, the previous valid room setpoint temperature is transferred to the room operating unit and displayed there. On the room operating unit, adjustment is possible in the symmetrical range defined by address 147. The step size is 0.5K.

#### Output `xDI1`

At output `xDI1` the state at input DI1 of the room operating unit is available in different ways (parameter `xDI1OutpMode`).

Operating modes

RAW

The output immediately adopts the state at input DI1 (FALSE: contact open, TRUE: contact closed with +24VDC)

PULSE

Each rising edge at input DI1 triggers a pulse of duration `tTimeDIPulse` (default: 1s) at the corresponding output xDI1.

#### Specification / display of the fan stage

The preselection of the number of fan stages is made via the parameter `eFanLevelConfig` (address 148). In Boost Mode, the maximum fan stage is specified (independent of input `eSetpFanLevel`). The fan stage is selected and transferred via input `eSetpFanLevel` within the permissible limits. The current fan stage is output via output `eFanLevel` within the permissible limits. The display of the current fan stage and the setting options are additionally defined by the parameters `eFanStagesControlMode` (address 31) `eFanControlMode` (address 149), `eFanLevelConfig` (address 148) and `xDsplFanStages` (address 138).

#### Assessment of the current CO2 content using a multicolor LED

The assessment of the current CO2 content is performed using a multicolor LED (off / green / yellow / red) and output `eCO2Status` . The threshold for the transition of the LED color from green to yellow is defined by the parameter `rCO2_LED_ThresholdwGreenYellow` (address 115). The threshold for the transition of the LED color from yellow to red is defined by the parameter `rCO2_LED_ThresholdYellowRed` (address 116). The assessment and the LED display can be defined by the parameter `xCO2_LED_Enable` (address 117) (TRUE = display).

#### Display of symbols / actual values

The display of the desired symbols in the room operating unit display is triggered by the TRUE state of the associated inputs. These inputs are identified with the index `Dspl` . Example: xDsplTemp = TRUE causes the current room temperature to be displayed on the screen.

#### Display of faults

Faults are displayed at the collective output `xAlarm` (= TRUE). It includes communication faults (time delay: gc\_Parameters.gc\_tOnDelayxAlarmCom, default = 60s) and device faults (direct). The collective error message, the collective warning message and the CO2 level that is too high (LED = red) are output here as device fault. At output `eErrorCodeCom` an explanatory text for the cause is available in the event of a communication error. The cause of the last communication error is always displayed there.

### Codesys

InOut:

| Scope       | Name                     | Type                                                   | Initial                                                                           | Comment                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ----------- | ------------------------ | ------------------------------------------------------ | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Input       | `xEn`                    | `BOOL`                                                 | TRUE                                                                              | Enable / disable communication (TRUE = enable)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Input       | `byUnitId`               | `BYTE`                                                 | 0                                                                                 | Device address (1 .. 247) (via Belimo Assistant app via NFC)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Input       | `xUpdateActual`          | `BOOL`                                                 | FALSE                                                                             | <p>Update of actual values (on every rising edge<br>)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Input       | `xUpdateSetp`            | `BOOL`                                                 | FALSE                                                                             | <p>Update of setpoints (on every rising edge<br>)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Input       | `xUpdateConfig`          | `BOOL`                                                 | FALSE                                                                             | Update of the configuration (on every rising edge) (read access)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Input       | `xUpdateStates`          | `BOOL`                                                 | FALSE                                                                             | Update of the states (on every rising edge)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Input       | `xUpdateInfo`            | `BOOL`                                                 | FALSE                                                                             | <p>Update of the information (on every rising<br>edge)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Input       | `rSetpTempAbsNight`      | `REAL`                                                 | 18.0                                                                              | Absolute setpoint temperature - night mode (unit depending on `eTemperatureUnit`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Input       | `rSetpTempAbsBaseDay`    | `REAL`                                                 | 22.0                                                                              | Absolute base setpoint temperature - day mode (unit depending on `eTemperatureUnit`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Input       | `rSetpTempRelNight`      | `REAL`                                                 | 0.0                                                                               | Relative setpoint temperature - night mode (unit depending on `eTemperatureUnit`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Input       | `rSetpTempRelBaseDay`    | `REAL`                                                 | 0.0                                                                               | Relative base setpoint temperature - day mode (unit depending on `eTemperatureUnit`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Input       | `xMode`                  | `BOOL`                                                 | FALSE                                                                             | Display of the icon `OnOff` (`eOnOffIconMode` = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_ICON\_MODE.DISPLAY\_MODE)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Input       | `xEcoIcon`               | `BOOL`                                                 | FALSE                                                                             | Display of the icon `Eco` (`eEcoIconMode` = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_ICON\_MODE.DISPLAY\_MODE)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Input       | `xBoostIcon`             | `BOOL`                                                 | FALSE                                                                             | Operation of the icon `Boost` (`eBoostIconMode` = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_ICON\_MODE.OPERATION\_MODE)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Input       | `eSetpFanLevel`          | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL                 | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL.STAGE\_0                                   | <p>(each rising edge toggles Boost mode)<br>Setpoint - current fan stage depending on the parameter <code>eFanLevelConfig</code><br><br>Depending on the parameters <code>eFanStagesControlMode</code> (register 31 - setpoints\_0) and <code>eFanControlMode</code> (register 149 - configuration\_0), the following operating options are available:<br>Register 31 = Automatic // Register 149 = Hybrid:<br>If stage 0 is selected on the RBG, the display of the current stage is deactivated and an automatic symbol is shown.<br>If a stage greater than 0 is selected on the RBG, the display of the current stage is activated and the automatic symbol is hidden.<br>Stage selection is possible on the RBG and via register 22.<br><br>In all other constellations, the following applies:<br>The display of the current stage is active, it can be changed on the RBG and via register 22, and the last change made remains in effect.</p>                 |
| Input       | `eIconsHeatCool`         | BELIMO\_P\_22RTX\_1U00X\_2\_MODE\_HEAT\_COOL           | BELIMO\_P\_22RTX\_1U00X\_2\_MODE\_HEAT\_COOL.NONE                                 | <p>0.0 = stage 0<br>1.0 = stage 1<br>2.0 = stage 2<br>3.0 = stage 3<br>4.0 = stage 4<br>5.0 = stage 5<br>6.0 = stage 6<br>Selection of heating or cooling operation</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Input       | `xDsplIconWarn`          | `BOOL`                                                 | FALSE                                                                             | Display of the symbol `Warning` (TRUE = display)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Input       | `xDsplIconWind`          | `BOOL`                                                 | FALSE                                                                             | Display of the symbol `Window` (TRUE = display)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Input       | `xEnLocalAdj`            | `BOOL`                                                 | TRUE                                                                              | <p>Definition of whether local operation is possible (TRUE =<br>enable)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Input       | `xResError`              | `BOOL`                                                 | FALSE                                                                             | <p>Reinitialization of the output <code>eErrorCodeCom</code> (on every<br>rising edge)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Inout       | `ModbusClient`           | `ModbusClientBase`                                     |                                                                                   | Client of the device                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Output      | `eOperationMode`         | BELIMO\_P\_22RTX\_1U00X\_2\_OPERATION\_MODE            |                                                                                   | <p>Current operating mode<br>0 = OFF\_PROTECTION: night mode<br>1 = ON\_COMFORT: day mode<br>2 = ECO\_MODE: day mode — eco mode<br>3 = BOOST\_MODE: day mode — boost mode</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Output      | `eEcoBoostOnOffIconMode` | BELIMO\_P\_22RTX\_1U00X\_2\_ICON\_MODE                 |                                                                                   | <p>Central definition of the icon functions <code>Eco</code>, <code>Boost</code> and <code>OnOff</code><br><br>INVISIBLE (icons not visible or operable)<br><br>> Visibility Operability on the RBG<br><br>Eco: no no<br>Boost: no no<br>OnOff: no no<br><br>DISPLAY\_MODE (display of the Eco and OnOff modes)<br><br>> Visibility Operability on the RBG<br><br>Eco: yes no<br>Boost: no no<br>OnOff: yes no<br><br>OPERATION\_MODE (switching of the functions on the RBG as well as by rising edges at the icon inputs)<br><br>> Visibility Operability on the RBG<br><br>Eco: yes yes<br>Boost: yes yes<br>OnOff: yes yes<br><br>PRESENCE\_BUTTON (usage time extension with external HVAC.Button1 FB)<br><br>> Visibility Operability on the RBG<br><br>Eco: no no<br>Boost: no no<br>OnOff: yes yes<br><br>Address 139 Address 140 Address 141 Operating mode<br>0 0 0 INVISIBLE<br>1 0 1 DISPLAY\_MODE<br>2 1 2 OPERATION\_MODE<br>0 0 2 PRESENCE\_BUTTON</p> |
| Output      | `xModeDev`               | `BOOL`                                                 |                                                                                   | <p>Operating mode of zone control from the device (FALSE =<br>night mode, TRUE = day mode)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Output      | `xButtonPresence`        | `BOOL`                                                 |                                                                                   | <p>Actuation of the presence button (pulse with duration<br><code>tTimeButtonPulse</code>) (RBG and/or VISU)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Output      | `rSetpTempAbs`           | `REAL`                                                 |                                                                                   | <p>Current absolute setpoint temperature depending on the<br>parameter <code>eTemperatureUnit</code> (e.g. +23.5 degrees Celsius) (<br>register 34)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Output      | `rOffset`                | `REAL`                                                 |                                                                                   | <p>Current difference between <code>rSetpTempAbs</code> and<br><code>rAdjCenterSetpTemp</code> (range: +/- <code>rAdjOffsetSetpTemp</code>)<br>in day mode</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Output      | `rSetpTempRel`           | `REAL`                                                 |                                                                                   | <p>Current relative setpoint temperature depending on the<br>parameter <code>eOffsetUnit</code> (e.g. -2.0 Kelvin) (range: +/-<br><code>rAdjOffsetSetpTemp</code>) (register 36)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Output      | `rTemp`                  | `REAL`                                                 |                                                                                   | <p>Current room temperature depending on the parameter<br><code>eUnitTemperature</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Output      | `rRelHumidity`           | `REAL`                                                 |                                                                                   | Relative room humidity in percent                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Output      | `rCO2`                   | `REAL`                                                 |                                                                                   | Current CO2 level in ppm                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Output      | `eCO2Status`             | BELIMO\_P\_22RTX\_1U00X\_2\_CO2\_STATUS                |                                                                                   | Current status of the CO2 actual-value monitoring                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Output      | `xSensorOffsetInDevice`  | `BOOL`                                                 |                                                                                   | <p>Indication whether the sensor calibration must be carried out in the device<br>(TRUE = calibration required in the device, FALSE = calibration required in the<br>FB)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Output      | `rDewPointTemp`          | `REAL`                                                 |                                                                                   | Dew point temperature in degrees Celsius or Fahrenheit                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Output      | `eFanLevel`              | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_LEVEL                 |                                                                                   | <p>Current fan stage depending on the parameter<br><code>eFanLevelConfig</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Output      | `xDI1`                   | `BOOL`                                                 |                                                                                   | <p>State of digital input 1 depending on the<br>parameter <code>eDI1OutpMode</code>:</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Output      | `xEnLocalAdjFb`          | `BOOL`                                                 |                                                                                   | <p>Indication whether local operation is possible (TRUE = local<br>operation possible) — feedback</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Output      | `eBusTermin`             | BELIMO\_P\_22RTX\_1U00X\_2\_BUS\_TERMINATION           |                                                                                   | Status of the Modbus termination resistor (Active = Enabled)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Output      | `sSerialNum`             | `STRING`                                               |                                                                                   | Serial number of the device                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Output      | `wFirmwareVer`           | `WORD`                                                 |                                                                                   | Firmware version of the device                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 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 display (TRUE = communication)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Input Const | `tTimeButtonPulse`       | `TIME`                                                 | TIME#1s0ms                                                                        | Duration of the pulse at the output 'xButton Presence'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Input Const | `xVisuPresence`          | `BOOL`                                                 | FALSE                                                                             | Actuation of the presence button in the visualization                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Input Const | `eFanStageControlMode`   | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_STAGES\_CONTROL\_MODE | BELIMO\_P\_22RTX\_1U00X\_2\_FAN\_STAGES\_CONTROL\_MODE.AUTOMATIC\_STAGES\_CONTROL | <p>Definition of the operating mode for controlling the fan stages<br>of the fan</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Input Const | `tTimeDIPulse`           | `TIME`                                                 | TIME#1s0ms                                                                        | <p>Duration of the pulse at the output <code>xDI1</code>, if a rising edge is detected at the digital<br>input (<br><code>eDI1OutpMode</code> = BELIMO\_P\_22RTX\_1U00X\_2\_FULL\_DIGITAL\_INPUT\_OUTP\_MODE.PULSE)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Input Const | `eDI1OutpMode`           | BELIMO\_P\_22RTX\_1U00X\_2\_DIGITAL\_INPUT\_OUTP\_MODE | BELIMO\_P\_22RTX\_1U00X\_2\_DIGITAL\_INPUT\_OUTP\_MODE.RAW                        | Operating mode of the output `xDI1` (RAW, PULSE)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Input Const | `tTimeUpdateInfo`        | `TIME`                                                 | TIME#0ms                                                                          | <p>Update interval for the processes influenced by the input<br><code>xUpdateInfo</code> influenced</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Input Const | `tTimeUpdateStates`      | `TIME`                                                 | TIME#500ms                                                                        | <p>Update interval for the processes influenced by the input<br><code>xUpdateStates</code> influenced</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Input Const | `tTimeUpdateConfig`      | `TIME`                                                 | TIME#0ms                                                                          | <p>Update interval for the processes influenced by the input<br><code>xUpdateConfig</code> influenced</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Input Const | `tTimeUpdateSetp`        | `TIME`                                                 | TIME#45s0ms                                                                       | <p>Update interval for the processes influenced by the input<br><code>xUpdateSetp</code> influenced</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Input Const | `tTimeUpdateActual`      | `TIME`                                                 | TIME#3s0ms                                                                        | <p>Update interval for the processes influenced by the input<br><code>xUpdateActual</code> influenced</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.powerio.com/hub/codesys-hvac/en/hvac-modbus-library/functionblocks/belimo/belimo_p_22rtx_1u00x_2_easy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
