> For the complete documentation index, see [llms.txt](https://support.powerio.com/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.powerio.com/hub/codesys-hvac/en/hvac-library/functionblocks/components/damper3p.md).

# Damper3P

## `Damper3P` (FB)

FUNCTION\_BLOCK Damper3P

### Short description

> Control of a 3-point damper actuator and calculation of the valve position\
> Typical application: Control of a 3-point damper actuator in a recirculation damper system of a ventilation system

### Representation

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FTIHgmoh5ZuwOM9x3eNYq%2FDamper3P.png?alt=media&amp;token=c6049ec4-5ff6-4d4e-926d-b8cd6ee29952" alt=""><figcaption></figcaption></figure>

### Interfaces

#### Inputs

| Name        | Data type         | Value range                                                               | Initial value | Function                                                       |
| ----------- | ----------------- | ------------------------------------------------------------------------- | ------------- | -------------------------------------------------------------- |
| *xYOpen*    | BOOL              |                                                                           |               | Control signal - valve opening                                 |
| *xYClose*   | BOOL              |                                                                           |               | Control signal - valve closing                                 |
| *xForce*    | BOOL              |                                                                           | FALSE         | Forced override after manual override                          |
| *xAlarmIn*  | BOOL              |                                                                           | FALSE         | Actuator fault message                                         |
| *eAOOOpen*  | HVACTYPES.eManBin | HVACTYPES.eManBin.Auto, HVACTYPES.eManBin.ManOff, HVACTYPES.eManBin.ManOn |               | Operating mode of manual override - hardware for valve opening |
| *eAOOClose* | HVACTYPES.eManBin | HVACTYPES.eManBin.Auto, HVACTYPES.eManBin.ManOff, HVACTYPES.eManBin.ManOn |               | Operating mode of manual override - hardware for valve closing |

#### Outputs

| Name          | Data type       | Value range | Initial value | Function                                          |
| ------------- | --------------- | ----------- | ------------- | ------------------------------------------------- |
| *xHBOpen*     | BOOL            |             |               | Enable - valve opening after manual override      |
| *xHBClose*    | BOOL            |             |               | Enable - valve closing after manual override      |
| *xABOpen*     | BOOL            |             |               | Enable - valve opening before manual override     |
| *xABClose*    | BOOL            |             |               | Enable - valve closing before manual override     |
| *dtAbsLastOn* | DATE\_AND\_TIME |             |               | Start date/time of the last anti-blocking process |
| *rPos*        | REAL            | 0.0 … 100.0 |               | Calculated current valve position                 |
| *xAuto*       | BOOL            |             |               | Collective automatic operation message            |

#### Setpoints / Parameters

| Name                | Data type | Value range                           | Initial value    | Function                                                            |
| ------------------- | --------- | ------------------------------------- | ---------------- | ------------------------------------------------------------------- |
| **tDuration**       | TIME      |                                       | 120s             | Actuator runtime                                                    |
| **udiAbsTime**      | UDINT     | 0 to 3600s                            | 200s             | Duration of the anti-blocking process                               |
| **todAbsStartTime** | TOD       |                                       | TOD#09:00:00 Uhr | Start time of the anti-blocking process                             |
| **eAbsDay**         | eDoW      |                                       | eDow\.Monday     | Weekday of the anti-blocking process                                |
| **xForceOption**    | BOOL      |                                       | TRUE             | Status of the outputs *xHBOpen* or *xHBClose* under forced override |
| **eManModeOpen**    | eMANBIN   | eMANBIN.Auto, eMANBIN.Off, eMANBIN.On | eMANBIN.Auto     | Operating mode of manual override - valve opening                   |
| **eManModeClose**   | eMANBIN   | eMANBIN.Auto, eMANBIN.Off, eMANBIN.On | eMANBIN.Auto     | Operating mode of manual override - valve closing                   |

### Functional description

#### General

This function block serves to control the position of a 3-point valve actuator via the outputs Enable - valve opening after manual override *xHBOpen* or *xHBClose*.\
The current valve position is continuously calculated and is available at the output *rPos* for use.\
The following function blocks are mainly used:

* Abs3P
* ManBin
* Position3P

#### Anti-blocking protection process

This process is implemented by monitoring signals 1 and 2 for activity and, if necessary, by triggering the anti-blocking protection.\
The test period is always 168 hours (= 1 week).\
The signals 1 and 2 are active if they are continuously active during the minimum operating time of 30.0 s within the test period (only signal 1 or only signal 2 or both).\
The anti-blocking protection process is thus prevented; the test period starts again.\
\
Signal 1: (*xYOpen* AND *eAOOOpen* = HVACTYPES.eManBin.Auto) OR (eAOOOpen = HVACTYPES.eManBin.ManOn)\
\
Signal 2: (*xYClose* AND *eAOOClose* = HVACTYPES.eManBin.Auto) OR (eAOOClose = HVACTYPES.eManBin.ManOn)\
\
If no activity was detected during the test period, the anti-blocking protection process is triggered on the weekday **eAbsDay** at the time **todAbsStartTime** .\
At the same time, the test duration starts again.\
\
The active anti-blocking protection process is divided into two consecutive time periods (section 1 and section 2)\
In section 1, during the duration **udiAbsTime** the combination Enable - Output *xABOpen* = TRUE, Enable - Output *xABClose* = FALSE is output.\
In section 2, during the duration **udiAbsTime** the combination Enable - Output *xABOpen* = FALSE, Enable - Output *xABClose* = TRUE is output.\
\
The initial triggering of the anti-blocking protection process can be delayed depending on the relevant settings (weekday **eAbsDay** and **todAbsStartTime**).

> **Example**
>
> Test period ended on Tuesday morning, triggering of the anti-blocking protection process only next Monday.

At output *dtAbsLastOn* the start date and start time of the last anti-blocking process are available.

> **Requirement for the use of the function block Abs3P**
>
> For correct operation, the use of the TimeRead2 function block is required.

#### Enable - valve opening before manual override *xABOpen*

The enable - valve opening before manual override *xABOpen* is influenced by the input request - valve opening *xYOpen* and the anti-blocking protection module.

| *xYOpen* | Anti-blocking protection process | *xABOpen*                        | Notes                                                   |
| -------- | -------------------------------- | -------------------------------- | ------------------------------------------------------- |
| FALSE    | FALSE                            | FALSE                            | Request not active, no anti-blocking protection process |
| X        | TRUE                             | Section 1: TRUE Section 2: FALSE | Anti-blocking protection process active                 |
| TRUE     | FALSE                            | TRUE                             | Request active, no anti-blocking protection process     |

Legend: X = any

#### Enable - valve closing before manual override *xABClose*

The enable - valve closing before manual override *xABClose* is influenced by the input request - valve closing *xYClose* and the anti-blocking protection module.

| *xYClose* | Anti-blocking protection process | *xABClose*                       | Notes                                                   |
| --------- | -------------------------------- | -------------------------------- | ------------------------------------------------------- |
| FALSE     | FALSE                            | FALSE                            | Request not active, no anti-blocking protection process |
| X         | TRUE                             | Section 1: FALSE Section 2: TRUE | Anti-blocking protection process active                 |
| TRUE      | FALSE                            | TRUE                             | Request active, no anti-blocking protection process     |

Legend: X = any

#### Enable - valve opening after manual override *xHBOpen*

The enable - valve opening after manual override *xHBOpen* corresponds to the enable - valve opening before manual override *xABOpen* additionally extended by a manual override module and a forced override.

| *xABOpen* | **eManModeOpen** | *xForce* | **xForceOption** | *xHBOpen* | Notes                                     |
| --------- | ---------------- | -------- | ---------------- | --------- | ----------------------------------------- |
| FALSE     | eMANBIN.Auto     | FALSE    | X                | FALSE     | Manual override module in automatic mode  |
| TRUE      | eMANBIN.Auto     | FALSE    | X                | TRUE      | Manual override module in automatic mode  |
| X         | eMANBIN.On       | FALSE    | X                | TRUE      | Manual override module in manual mode On  |
| X         | eMANBIN.Off      | FALSE    | X                | FALSE     | Manual override module in manual mode Off |
| X         | X                | TRUE     | FALSE            | FALSE     | Forced override Close                     |
| X         | X                | TRUE     | TRUE             | TRUE      | Forced override Open                      |

Legend: X = any

#### Enable - valve closing after manual override *xHBClose*

The enable - valve closing after manual override *xHBClose* corresponds to the enable - valve closing before manual override *xABClose* additionally extended by a manual override module and a forced override.

| *xABClose* | **eManModeOpen** | *xForce* | **xForceOption** | *xHBClose* | Notes                                     |
| ---------- | ---------------- | -------- | ---------------- | ---------- | ----------------------------------------- |
| FALSE      | eMANBIN.Auto     | FALSE    | X                | FALSE      | Manual override module in automatic mode  |
| TRUE       | eMANBIN.Auto     | FALSE    | X                | TRUE       | Manual override module in automatic mode  |
| X          | eMANBIN.On       | FALSE    | X                | TRUE       | Manual override module in manual mode On  |
| X          | eMANBIN.Off      | FALSE    | X                | FALSE      | Manual override module in manual mode Off |
| X          | X                | TRUE     | FALSE            | FALSE      | Forced override Close                     |
| X          | X                | TRUE     | TRUE             | TRUE       | Forced override Open                      |

Legend: X = any

#### Forced control of the manual overrides of the outputs

If the operating mode of the manual override - valve opening **eManModeOpen** is in state eMANBIN.On (= manual override opening active), then the operating mode of the manual override - valve closing is inevitably **eManModeClose** set to state eMANBIN.Off (= manual override closing not active).\
\
If the operating mode of the manual override - valve closing **eManModeClose** is in state eMANBIN.On (= manual override closing active), then the operating mode of the manual override - valve opening is inevitably **eManModeOpen** set to state eMANBIN.Off (= manual override opening not active).

#### Current valve position *rPos*

It is used to display the current position of the 3-point actuator in the range 0 - 100% and is calculated from the duration of the signals at the outputs Enable - valve opening after manual override *xHBOpen* and Enable - valve closing after manual override *xHBClose* in combination with the actuator runtime **tDuration** calculated.\
\
The position display is independent of signal generation, i.e. if the position display reaches an end position (0% or 100%), signals are still generated at the outputs *xABOpen* and *xABClose* or *xHBOpen* and *xHBClose* generated.\
The position display does not take into account any position changes due to the hardware manual override.

#### Collective fault *xAlarm*

The collective fault *xAlarm* is activated (= TRUE) if the input *xAlarmIn* is active.\
In all other cases the collective fault is *xAlarm* is not activated (= FALSE).

#### Collective automatic operation message *xAuto*

The collective automatic operation message *xAuto* is activated (= TRUE) if the following conditions are simultaneously met:

* Input *eAOOUp* = HVACTYPES.eManBin.Auto
* Input *eAOODown* = HVACTYPES.eManBin.Auto
* Setpoint / parameter **eManModeUp** = eMANBIN.Auto
* Setpoint / parameter **eManModeDown** = eMANBIN.Auto

#### Forced override *xForce*

The forced override acts directly on the outputs *xHBOpen* and *xHBClose*. With the parameter **xForceOption** it is determined which state the output *xHB* assumes when TRUE is at the input *xForce* takes.\
\
With **xForceOption** = FALSE\
If the input *xForce* is TRUE, then the output *xHBOpen* is set to FALSE and at the same time the output *xHBClose* is set to TRUE.\
\
With **xForceOption** = TRUE\
If the input *xForce* is TRUE, then the output *xHBOpen* is TRUE and at the same time the output *xHBClose* is set to FALSE.

### CODESYS

InOut:

| Scope       | Name            | Type    | Initial      |
| ----------- | --------------- | ------- | ------------ |
| Input       | `xYOpen`        | `BOOL`  |              |
| Input       | `xYClose`       | `BOOL`  |              |
| Input       | `xForce`        | `BOOL`  | FALSE        |
| Input       | `xAlarmIn`      | `BOOL`  | FALSE        |
| Input       | `eAOOOpen`      | eManBin |              |
| Input       | `eAOOClose`     | eManBin |              |
| Output      | `xHBOpen`       | `BOOL`  |              |
| Output      | `xHBClose`      | `BOOL`  |              |
| Output      | `xABOpen`       | `BOOL`  |              |
| Output      | `xABClose`      | `BOOL`  |              |
| Output      | `rPos`          | `REAL`  |              |
| Output      | `xAlarm`        | `BOOL`  |              |
| Output      | `xAuto`         | `BOOL`  |              |
| Input Const | `udiDuration`   | `UDINT` | 120          |
| Input Const | `xForceOption`  | `BOOL`  | FALSE        |
| Input Const | `eManModeOpen`  | eMANBIN | eMANBIN.Auto |
| Input Const | `eManModeClose` | eMANBIN | eMANBIN.Auto |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.powerio.com/hub/codesys-hvac/en/hvac-library/functionblocks/components/damper3p.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
