# BELIMO\_EVXXXF\_FW\_3XX\_MOD

## `BELIMO_EVXXXF_FW_3XX_MOD` (FB)

FUNCTION\_BLOCK BELIMO\_EVXXXF\_FW\_3XX\_MOD

### Guidelines - Software creation

The following function codes (FC) are supported: 3, 4 (additionally: 2, 4, 16)\
\
For write operations on 32-bit data points (2 consecutive Modbus registers) FC16 must be used. No other registers may be written in that telegram.\
\
Format of 32-bit data points:\
Register+0 (LSW): H-byte L-byte\
Register+1 (MSW): H-byte L-byte\\

FC 02 may only be used for register 105 (Malfunction and service information, start address = 1664). | | For addressing, use the address values, not the register addresses. | | For unused registers the value 65535 (dec.) is read / written | | The calibration of the temperature sensors must be performed on the device, however no adjustment is possible via Modbus. | | The Modbus addresses 1 - 247 can be set directly in the integrated web server. | | All writable register addresses > 100 are persistent and must not be written cyclically | | This function block can also be used for the EnergyValves EVXXX RX (in-line) with firmware 3.X !!! | For the EnergyValves EVXXX RX (in-line) with firmware 4.X there are separate function blocks. | | Measurements - Adjustment: Class ??? | |

InOut:

| Scope       | Name                       | Type                                                   | Initial                                                         | Comment                                                                                                                                                                                                                                                                                                |
| ----------- | -------------------------- | ------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Input       | `xEn`                      | `BOOL`                                                 | TRUE                                                            | Enable / disable communication ( TRUE = enabled )                                                                                                                                                                                                                                                      |
| Input       | `byUnitId`                 | `BYTE`                                                 | 1                                                               | Device address (1 .. 247)                                                                                                                                                                                                                                                                              |
| Input       | `xUpdateActual`            | `BOOL`                                                 | FALSE                                                           | <p>Update of actual values (on every rising edge<br>)</p>                                                                                                                                                                                                                                              |
| Input       | `xUpdateSetp`              | `BOOL`                                                 | FALSE                                                           | <p>Update of setpoint values (on every rising edge<br>)</p>                                                                                                                                                                                                                                            |
| Input       | `xUpdateConfig`            | `BOOL`                                                 | FALSE                                                           | Update of configuration (on every rising edge) (write and read access)                                                                                                                                                                                                                                 |
| Input       | `xUpdateInfo`              | `BOOL`                                                 | FALSE                                                           | <p>Update of the information ( on every rising<br>edge )</p>                                                                                                                                                                                                                                           |
| Input       | `xResError`                | `BOOL`                                                 | FALSE                                                           | Reinitialization of the outputs 'eErrorCodeCom' and 'xErrorCodeDev' to the error-free state (on each rising edge)                                                                                                                                                                                      |
| Input       | `rRelSetp`                 | `REAL`                                                 | 0.0                                                             | <p>Relative setpoint - position/volume flow/power in % (<br>0.0 - 100.0 %)</p>                                                                                                                                                                                                                         |
| Input       | `eOverrideCon`             | BELIMO\_EVXXXF\_FW\_3XX\_OVERRIDE\_CONTROL             | BELIMO\_EVXXXF\_FW\_3XX\_OVERRIDE\_CONTROL.None                 | <p>Position control: 0.0 - 100.0% refer to the relative position<br>Flow control: 0.0 - 100.0% refer to the range 0 - Vmax (address 105)<br>Power control: 0.0 - 100.0% refer to the range 0 - Pmax (address 116)<br>Forced override of the control signal - position/volume flow/power (0 = None)</p> |
| Input       | `rSetpDeltaTTempKel`       | `REAL`                                                 | 1.0                                                             | <p>Setpoint - temperature difference (Delta-T manager) in<br>Kelvin (minimum value)</p>                                                                                                                                                                                                                |
| Inout       | `ModbusClient`             | `ModbusClientBase`                                     |                                                                 | Client of the device                                                                                                                                                                                                                                                                                   |
| Output      | `eSetpSourceFb`            | BELIMO\_EVXXXF\_FW\_3XX\_SETPOINT\_SOURCE              |                                                                 | <p>Feedback - source for the setpoint -<br>position/volume flow/power (1 = Modbus)</p>                                                                                                                                                                                                                 |
| Output      | `eControlModeFb`           | BELIMO\_EVXXXF\_FW\_3XX\_CONTROL\_MODE                 |                                                                 | Feedback - operating mode of the control (1 = flow)                                                                                                                                                                                                                                                    |
| Output      | `rRelSetpFb`               | `REAL`                                                 |                                                                 | <p>Feedback - relative setpoint -<br>position/volume flow/power in % (0.0 - 100.0 %)</p>                                                                                                                                                                                                               |
| Output      | `rRelSetpAnalog`           | `REAL`                                                 |                                                                 | <p>Relative setpoint - position/volume flow/power in V (<br>0.0 - 10.0 V) from the 0 - 10V input (address 144 = 0 =<br>analog)</p>                                                                                                                                                                     |
| Output      | `rRelPos`                  | `REAL`                                                 |                                                                 | Relative position in XXX.X %                                                                                                                                                                                                                                                                           |
| Output      | `rAbsPos`                  | `REAL`                                                 |                                                                 | Absolute position in XXX degrees (rotation) or mm (linear movement)                                                                                                                                                                                                                                    |
| Output      | `rRelVolFlow`              | `REAL`                                                 |                                                                 | <p>Relative volume flow in % (0.0 - 100.0 %) (relative to<br>'Vmax' - address 105)</p>                                                                                                                                                                                                                 |
| Output      | `rRelVolFlowLimitMax`      | `REAL`                                                 |                                                                 | <p>Limit - maximum percentage volume flow (reference:<br>Vnom) (range: 0.3 - 1.0 Vnom) (Control\_Mode = Flow<br>Control or Power Control)</p>                                                                                                                                                          |
| Output      | `rAbsVolFlowLimitMaxlsFb`  | `REAL`                                                 |                                                                 | <p>Feedback - limit - maximum absolute volume flow<br>in liters/s (reference: Vnom) (range: 0.3 - 1.0 Vnom) (<br>Control\_Mode = Flow Control or Power Control)</p>                                                                                                                                    |
| Output      | `rNomAbsVolFlowUnit`       | `REAL`                                                 |                                                                 | <p>Nominal volume flow in the chosen unit (addresses<br>112 and 113) (unit selection in address 141)</p>                                                                                                                                                                                               |
| Output      | `rSetpAbsVolFlowUnit`      | `REAL`                                                 |                                                                 | <p>Setpoint for the absolute volume flow in the chosen<br>unit (unit selection in address 141)</p>                                                                                                                                                                                                     |
| Output      | `rAbsVolFlowUnit`          | `REAL`                                                 |                                                                 | <p>Absolute volume flow in the chosen unit (unit<br>selection in address 141)</p>                                                                                                                                                                                                                      |
| Output      | `eVolFlowUnitFb`           | BELIMO\_EVXXXF\_FW\_3XX\_VOLUME\_FLOW\_UNIT            |                                                                 | <p>Feedback - unit for the absolute volume flow (<br>unit selection in address 141)</p>                                                                                                                                                                                                                |
| Output      | `rTemp1Deg`                | `REAL`                                                 |                                                                 | Current temperature at the cable sensor in degrees Celsius                                                                                                                                                                                                                                             |
| Output      | `rTemp2Deg`                | `REAL`                                                 |                                                                 | <p>Current temperature at the sensor in the flow meter in degrees<br>Celsius</p>                                                                                                                                                                                                                       |
| Output      | `rDeltaTempKel`            | `REAL`                                                 |                                                                 | Current temperature difference in Kelvin                                                                                                                                                                                                                                                               |
| Output      | `rRelGlycolCon`            | `REAL`                                                 |                                                                 | Current glycol concentration in percent                                                                                                                                                                                                                                                                |
| Output      | `rRelPower`                | `REAL`                                                 |                                                                 | <p>Current power in percent (0.0 - 300.0 %) (<br>Reference: 'Maximum Power Limit' - address 165)</p>                                                                                                                                                                                                   |
| Output      | `rRelMaxPowerLimit`        | `REAL`                                                 |                                                                 | <p>Relative maximum power in percent (reference: Pnom<br>) (range: 0.005 - 1.0 Pnom)</p>                                                                                                                                                                                                               |
| Output      | `rNomAbsPowerUnit`         | `REAL`                                                 |                                                                 | <p>Nominal power in the chosen unit (addresses 163<br>and 164) (unit selection in address 142)</p>                                                                                                                                                                                                     |
| Output      | `rAbsMaxPowerLimitkWFb`    | `REAL`                                                 |                                                                 | <p>Feedback - absolute maximum power in kW (<br>reference: Pnom) (range: 0.005 - 1.0 Pnom)</p>                                                                                                                                                                                                         |
| Output      | `rAbsPowerUnit`            | `REAL`                                                 |                                                                 | <p>Current absolute power in the chosen unit (<br>unit selection in address 142)</p>                                                                                                                                                                                                                   |
| Output      | `ePowerUnitFb`             | BELIMO\_EVXXXF\_FW\_3XX\_POWER\_UNIT                   |                                                                 | <p>Feedback - unit of powers (unit selection in<br>address 142)</p>                                                                                                                                                                                                                                    |
| Output      | `eDeltaTManagerStatus`     | BELIMO\_EVXXXF\_FW\_3XX\_DELTA\_T\_MANAGER\_STATUS     |                                                                 | Status of the Delta-T manager                                                                                                                                                                                                                                                                          |
| Output      | `rSetpDeltaTTempKelFb`     | `REAL`                                                 |                                                                 | <p>Feedback - setpoint - temperature difference (Delta-T<br>manager) in Kelvin (minimum value)</p>                                                                                                                                                                                                     |
| Output      | `rSetpDeltaTAbsFlowls`     | `REAL`                                                 |                                                                 | Setpoint - volume flow in liters/s (Delta-T manager)                                                                                                                                                                                                                                                   |
| Output      | `dwTotalCoolingEnergy`     | `DWORD`                                                |                                                                 | <p>Total cooling energy in the chosen unit (unit<br>selection in address 143)</p>                                                                                                                                                                                                                      |
| Output      | `dwTotalHeatinggEnergy`    | `DWORD`                                                |                                                                 | <p>Total heating energy in the chosen unit (unit<br>selection in address 143)</p>                                                                                                                                                                                                                      |
| Output      | `eEnergyUnitFb`            | BELIMO\_EVXXXF\_FW\_3XX\_ENERGY\_UNIT                  |                                                                 | <p>Feedback - unit of total energy amounts (<br>unit selection in address 143)</p>                                                                                                                                                                                                                     |
| Output      | `eOverrideConFb`           | BELIMO\_EVXXXF\_FW\_3XX\_OVERRIDE\_CONTROL             |                                                                 | <p>Current state - forced override of the control signal -<br>position/volume flow/power (0 = None)</p>                                                                                                                                                                                                |
| Output      | `eDeviceType`              | BELIMO\_EVXXXF\_FW\_3XX\_DEVICE\_TYPE                  |                                                                 | <p>Current state - type of device (0 = Device not<br>connected)</p>                                                                                                                                                                                                                                    |
| Output      | `sSerialNum`               | `STRING`                                               |                                                                 | Device serial number                                                                                                                                                                                                                                                                                   |
| Output      | `wFirmwareVer`             | `WORD`                                                 |                                                                 | Firmware version of the device                                                                                                                                                                                                                                                                         |
| Output      | `eAO`                      | eManNum                                                | eManNum.Auto                                                    | Indicator - manual override on the device (actuator decoupled) ( 0 = Automatic )                                                                                                                                                                                                                       |
| Output      | `xSensorOffsetInDevice`    | `BOOL`                                                 |                                                                 | <p>Indicator whether the calibration of the sensors must be<br>performed in the device (TRUE = calibration in device required, FALSE = calibration in<br>FB required)</p>                                                                                                                              |
| Output      | `xAlarm`                   | `BOOL`                                                 | FALSE                                                           | General fault ( TRUE = fault )                                                                                                                                                                                                                                                                         |
| Output      | `xAlarmCom`                | `BOOL`                                                 | FALSE                                                           | General fault - communication ( TRUE = fault )                                                                                                                                                                                                                                                         |
| Output      | `eErrorCodeCom`            | ModbusErrorCode                                        |                                                                 | Error code - communication ( 0 = no error )                                                                                                                                                                                                                                                            |
| Output      | `stErrorCodeDev`           | `STRING`                                               |                                                                 | String with the numbers of the active device errors                                                                                                                                                                                                                                                    |
| Output      | `xBusy`                    | `BOOL`                                                 |                                                                 | Communication indicator ( TRUE = communication )                                                                                                                                                                                                                                                       |
| Input Const | `eDeltaTManagerLimitation` | BELIMO\_EVXXXF\_FW\_3XX\_DELTA\_T\_MANAGER\_LIMITATION | BELIMO\_EVXXXF\_FW\_3XX\_DELTA\_T\_MANAGER\_LIMITATION.Disabled | Limitation of the Delta-T manager                                                                                                                                                                                                                                                                      |
| Input Const | `rAbsMaxPowerLimitkW`      | `REAL`                                                 | 10.0                                                            | <p>Absolute maximum power in kW (reference: Pnom) (<br>range: 0.005 - 1.0 Pnom)</p>                                                                                                                                                                                                                    |
| Input Const | `eEnergyUnit`              | BELIMO\_EVXXXF\_FW\_3XX\_ENERGY\_UNIT                  | BELIMO\_EVXXXF\_FW\_3XX\_ENERGY\_UNIT.MWh                       | <p>Unit of total energy amounts (unit selection<br>in address 143)</p>                                                                                                                                                                                                                                 |
| Input Const | `ePowerUnit`               | BELIMO\_EVXXXF\_FW\_3XX\_POWER\_UNIT                   | BELIMO\_EVXXXF\_FW\_3XX\_POWER\_UNIT.kW                         | <p>Unit of powers (unit selection in address<br>142)</p>                                                                                                                                                                                                                                               |
| Input Const | `eVolFlowUnit`             | BELIMO\_EVXXXF\_FW\_3XX\_VOLUME\_FLOW\_UNIT            | BELIMO\_EVXXXF\_FW\_3XX\_VOLUME\_FLOW\_UNIT.Litres\_per\_second | <p>Unit for the absolute volume flow (unit selection in<br>address 141)</p>                                                                                                                                                                                                                            |
| Input Const | `rAbsVolFlowLimitMaxls`    | `REAL`                                                 | 3.0                                                             | <p>Limit - maximum absolute volume flow in liters/s (<br>reference: Vnom) (range: 0.3 - 1.0 Vnom) (Control\_Mode<br>= Flow Control or Power Control)</p>                                                                                                                                               |
| Input Const | `eSetpSource`              | BELIMO\_EVXXXF\_FW\_3XX\_SETPOINT\_SOURCE              | BELIMO\_EVXXXF\_FW\_3XX\_SETPOINT\_SOURCE.Bus                   | <p>Source for the setpoint - position/volume flow/power (1<br>= Modbus)</p>                                                                                                                                                                                                                            |
| Input Const | `eControlMode`             | BELIMO\_EVXXXF\_FW\_3XX\_CONTROL\_MODE                 | BELIMO\_EVXXXF\_FW\_3XX\_CONTROL\_MODE.Flow\_Control            | Operating mode of the control (1 = volume flow)                                                                                                                                                                                                                                                        |
| Input Const | `tTimeUpdateInfo`          | `TIME`                                                 | TIME#0ms                                                        | <p>Update interval for the processes influenced by the input<br>‘xUpdateInfo’</p>                                                                                                                                                                                                                      |
| Input Const | `tTimeUpdateConfig`        | `TIME`                                                 | TIME#0ms                                                        | <p>Update interval for the processes influenced by the input<br>‘xUpdateConfig’</p>                                                                                                                                                                                                                    |
| Input Const | `tTimeUpdateSetp`          | `TIME`                                                 | TIME#45s0ms                                                     | <p>Update interval for operations influenced by the input<br>'xUpdateSetp'</p>                                                                                                                                                                                                                         |
| Input Const | `tTimeUpdateActual`        | `TIME`                                                 | TIME#3s0ms                                                      | <p>Update interval for operations influenced by the input<br>'xUpdateActual'</p>                                                                                                                                                                                                                       |
