> 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/hvac-library/functionblocks/components/heatpumpgasboilerselection.md).

# HeatpumpGasboilerSelection

## `HeatpumpGasboilerSelection` (FB)

FUNCTION\_BLOCK HeatpumpGasboilerSelection

### Kurzbeschreibung

Freigabe des Gaskessels oder der Wärmepumpe in Abhängigkeit von verschiedenen Einflussgrössen.\
Einflussgrössen:

1. Aktueller COP-Wert der Wärmepumpe
2. Kosten für elektrische Energie (Wärmepumpe) in Euro je kWh
3. Kosten für Erdgasbezug (Gaskessel) in Euro je kWh
4. Wirkungsgrad der Wärmepumpe (0.0 - 1.0)
5. Wirkungsgrad des Gaskessels (0.0 - 1.0)

Die Voreinstellungen der internen Kennlinie stimmen mit der COP-Kennlinie W35-Heizfall der WP Remeha E-HP AW 84 überein.\
\
Typische Anwendung: Entscheidung über die Freigabe des Gaskessels bzw. der Wärmepumpe je nach Betriebssituation

### Darstellung

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FBjUH8aDicq1X0Xtv83pH%2FHeatpumpGasboilerSelection.png?alt=media&amp;token=3d11049c-bb1a-47d7-b356-a4eb14defe1b" alt=""><figcaption></figcaption></figure>

### Schnittstellen

#### Eingänge

| Name             | Datentyp                               | Wertebereich | Initialwert                                            | Funktion                                                                                  |
| ---------------- | -------------------------------------- | ------------ | ------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| *xEn*            | BOOL                                   |              | TRUE                                                   | Freigabe / Sperrung des Funktionsbausteins (TRUE = Freigabe)                              |
| *eCOPSource*     | eHeatpumpGasboilerSelection\_COPSource |              | eHeatpumpGasboilerSelection\_COPSource.Internal\_Curve | Auswahl der COP-Quelle (Internal\_Curve, External\_Input)                                 |
| *rSourceTempCOP* | REAL                                   |              | 2.0                                                    | Aktuelle Temperatur der Wärmequelle für die Wärmepumpe (Luft-Wasser-WP: Aussentemperatur) |
| *rExtCOP*        | REAL                                   |              | 4.0                                                    | Externer Wert des ‘Coefficient of Performance’ (COP) der Wärmepumpe (typisch: 2.0 - 7.0)  |
| *xExtError*      | BOOL                                   |              | FALSE                                                  | Externer Fehlerzustand (FALSE = kein Fehler, TRUE = Fehler)                               |
| *xExtValidData*  | BOOL                                   |              | FALSE                                                  | Externer Eingang für die Gültigkeit der Daten der Kennlinie (n) (FALSE = ungültig)        |

#### Ausgänge

| Name                          | Datentyp | Wertebereich | Initialwert | Funktion                                                                                       |
| ----------------------------- | -------- | ------------ | ----------- | ---------------------------------------------------------------------------------------------- |
| *tRemainingTimeTestIntervall* | TIME     |              | T#0s        | Restzeit bis zum nächsten Prüfzeitpunkt                                                        |
| *rCOPLimit*                   | REAL     |              | 0.0         | Grenzwert des COP für die Freigabe der Wärmepumpe (rCOP >= rCOPLimit: Freigabe der Wärmepumpe) |
| *rCOP*                        | REAL     |              | 0.0         | Aktueller Wert des ‘Coefficient of Performance’ (COP) der Wärmepumpe (typisch: 2.0 - 7.0)      |
| *xCmdGasboiler*               | BOOL     |              | FALSE       | Freigabe / Sperrung des Gaskessels (TRUE = Freigabe)                                           |
| *xCmdHeatpump*                | BOOL     |              | FALSE       | Freigabe / Sperrung der Wärmepumpe (TRUE = Freigabe)                                           |
| *xError*                      | BOOL     |              | FALSE       | Fehlerzustand (FALSE = kein Fehler, TRUE = Fehler)                                             |

#### Sollwerte / Parameter

| Name                      | Datentyp | Wertebereich | Initialwert | Funktion                                                   |
| ------------------------- | -------- | ------------ | ----------- | ---------------------------------------------------------- |
| **rEfficiencyGasboiler**  | REAL     |              | 0.9         | Gesamtwirkungsgrad der Wärmeerzeugung mit dem Gaskessel    |
| **rEfficiencyHeatpump**   | REAL     |              | 0.9         | Gesamtwirkungsgrad der Wärmeerzeugung mit der Wärmepumpe   |
| **rEnergyPriceGasboiler** | REAL     |              | 0.20        | Energiekosten - Gas (in Euro / kWh erzeugter Wärmeenergie) |
| **rEnergyPriceHeatpump**  | REAL     |              | 0.45        | Energiekosten - Strom (in Euro / kWh)                      |
| **tTimeTestIntervall**    | TIME     |              | T#30M       | Zeitdauer des Test-Intervalls                              |
| **rCOP\_Subst**           | REAL     |              | 3.5         | Ersatzwert für den COP im Fehlerfall                       |
| **rCOP\_Min**             | REAL     |              | 1.0         | Absoluter minimaler Wert des COP                           |
| **rCOP\_Max**             | REAL     |              | 10.0        | Absoluter maximaler Wert des COP                           |
| **rSP1\_X**               | REAL     |              | 1.0         | Stützstelle 1 - X-Wert                                     |
| **rSP1\_Y**               | REAL     |              | 2.0         | Stützstelle 1 - Y-Wert                                     |
| **rSP2\_X**               | REAL     |              | 2.0         | Stützstelle 2 - X-Wert                                     |
| **rSP2\_Y**               | REAL     |              | 4.0         | Stützstelle 2 - Y-Wert                                     |
| **rSP3\_X**               | REAL     |              | 3.0         | Stützstelle 3 - X-Wert                                     |
| **rSP3\_Y**               | REAL     |              | 6.0         | Stützstelle 3 - Y-Wert                                     |
| **rSP4\_X**               | REAL     |              | 4.0         | Stützstelle 4 - X-Wert                                     |
| **rSP4\_Y**               | REAL     |              | 8.0         | Stützstelle 4 - Y-Wert                                     |
| **rSP5\_X**               | REAL     |              | 5.0         | Stützstelle 5 - X-Wert                                     |
| **rSP5\_Y**               | REAL     |              | 10.0        | Stützstelle 5 - Y-Wert                                     |
| **rSP6\_X**               | REAL     |              | 6.0         | Stützstelle 6 - X-Wert                                     |
| **rSP6\_Y**               | REAL     |              | 12.0        | Stützstelle 6 - Y-Wert                                     |
| **rSP7\_X**               | REAL     |              | 7.0         | Stützstelle 7 - X-Wert                                     |
| **rSP7\_Y**               | REAL     |              | 14.0        | Stützstelle 7 - Y-Wert                                     |
| **rSP8\_X**               | REAL     |              | 8.0         | Stützstelle 8 - X-Wert                                     |
| **rSP8\_Y**               | REAL     |              | 16.0        | Stützstelle 8 - Y-Wert                                     |
| **rSP9\_X**               | REAL     |              | 9.0         | Stützstelle 9 - X-Wert                                     |
| **rSP9\_Y**               | REAL     |              | 18.0        | Stützstelle 9 - Y-Wert                                     |
| **rSP10\_X**              | REAL     |              | 10.0        | Stützstelle 10 - X-Wert                                    |
| **rSP10\_Y**              | REAL     |              | 20.0        | Stützstelle 10 - Y-Wert                                    |

### Funktionsbeschreibung

\
Die Freigabe der Wärmeerzeuger Gaskessel oder Wärmepumpe erfolgt aufgrund einer Berechnung unter Berücksichtigung der folgenden Einflussgrössen:\
\
1\) Aktueller COP-Wert der Wärmepumpe\
2\) Kosten für elektrische Energie (Wärmepumpe) in Euro je kWh\
3\) Kosten für Erdgasbezug (Gaskessel) in Euro je kWh\
4\) Wirkungsgrad der Wärmepumpe (0.0 - 1.0)\
5\) Wirkungsgrad des Gaskessels (0.0 - 1.0)\
\
Es ist immer nur ein Wärmeerzeuger freigegeben, der jeweils andere ist automatisch gesperrt.\
\
Diese Berechnung erfolgt (Bedingung: xEn = TRUE), falls mindestens eine der nachfolgend beschriebenen Situationen vorliegt:\
\
1\) Zyklisch im Intervall tTimeTestIntervall\
2\) Einmalig bei einer ansteigenden Flanke am Eingang xEn\
3\) Einmalig nach jedem Neustart\
4\) Einmalig bei jedem Wechsel der Auswahl der COP-Quelle eCOPSource\
\
Der COP-Wert der Wärmepumpe kann durch eine intern hinterlegte Kennlinie mit 10 Wertepaaren (eCOPSource = Internal\_Curve, Temperatur der Wärmequelle rSourceTempCOP) oder\
den externen Eingang rExtCOP (eCOPSource = External\_Input, xExtError = FALSE, xExtValidData = TRUE) bestimmt werden. Er wird durch die absoluten Grenzwerte **rCOP\_Min** bzw.\
**rCOP\_Max** begrenzt, bei Fehlerfreiheit am Ausgang rCOP ausgegeben und für die Berechnung verwendet.\
Im Fehlerfall (eCOPSource = Internal\_Curve: Fehler bei der Eingabe der Wertepaare) bzw. (eCOPSource = External\_Input: xExtError = TRUE oder xExtValidData = FALSE) wird\
der Ersatzwert **rCOP\_Subst** verwandt.\
\
Die X-Werte der 10 Stützstellen der internen COP-Kennlinie müssen folgenden Randbedingungen genügen:\
\
1\) Die X-Werte müssen fortlaufend entweder streng ansteigend oder streng abfallend sein\
2\) Jeder X-Wert darf nur einmal vorhanden sein\
3\) Zwei benachbarte Stützstellen werden jeweils durch eine Gerade verbunden\
\
Am Ausgang tRemainingTimeTestIntervall steht die Restzeit bis zur nächsten zyklischen Berechnung zur Verfügung.\
Am Ausgang rCOPLimit steht der Grenzwert für die Umschaltung zum Gaskessel zur Verfügung (rCOP < rCOPLimit: Freigabe des Gaskessels)\
\
Im gesperrten Zustand (xEn = FALSE) nehmen die Ausgänge sinnvolle, konstante Wert an, es findet keine Berechnung mehr statt.\
\
Am Ausgang \*xError\* steht der aktuelle Fehlerzustand zur Verfügung (xError = TRUE: Fehler aktiv). Er ist aktiv, falls entweder die interne\
COP-Kennlinie fehlerhaft oder der externe Fehlereingang xExtError aktiv (= TRUE) ist.

### CODESYS

InOut:

| Scope       | Name                          | Type                                   | Initial                                                |
| ----------- | ----------------------------- | -------------------------------------- | ------------------------------------------------------ |
| Input       | `xEn`                         | `BOOL`                                 | TRUE                                                   |
| Input       | `eCOPSource`                  | eHeatpumpGasboilerSelection\_COPSource | eHeatpumpGasboilerSelection\_COPSource.Internal\_Curve |
| Input       | `rSourceTempCOP`              | `REAL`                                 | 2.0                                                    |
| Input       | `rExtCOP`                     | `REAL`                                 | 4.0                                                    |
| Input       | `xExtError`                   | `BOOL`                                 | FALSE                                                  |
| Input       | `xExtValidData`               | `BOOL`                                 | FALSE                                                  |
| Output      | `tRemainingTimeTestIntervall` | `TIME`                                 | TIME#0ms                                               |
| Output      | `rCOPLimit`                   | `REAL`                                 | 0.0                                                    |
| Output      | `rCOP`                        | `REAL`                                 | 0.0                                                    |
| Output      | `xCmdGasboiler`               | `BOOL`                                 | FALSE                                                  |
| Output      | `xCmdHeatpump`                | `BOOL`                                 | FALSE                                                  |
| Output      | `xError`                      | `BOOL`                                 | FALSE                                                  |
| Input Const | `rSP10_Y`                     | `REAL`                                 | 6.8                                                    |
| Input Const | `rSP10_X`                     | `REAL`                                 | 20.0                                                   |
| Input Const | `rSP9_Y`                      | `REAL`                                 | 5.85                                                   |
| Input Const | `rSP9_X`                      | `REAL`                                 | 16.1                                                   |
| Input Const | `rSP8_Y`                      | `REAL`                                 | 5.25                                                   |
| Input Const | `rSP8_X`                      | `REAL`                                 | 12.2                                                   |
| Input Const | `rSP7_Y`                      | `REAL`                                 | 4.65                                                   |
| Input Const | `rSP7_X`                      | `REAL`                                 | 8.3                                                    |
| Input Const | `rSP6_Y`                      | `REAL`                                 | 4.2                                                    |
| Input Const | `rSP6_X`                      | `REAL`                                 | 4.4                                                    |
| Input Const | `rSP5_Y`                      | `REAL`                                 | 3.7                                                    |
| Input Const | `rSP5_X`                      | `REAL`                                 | 0.5                                                    |
| Input Const | `rSP4_Y`                      | `REAL`                                 | 3.35                                                   |
| Input Const | `rSP4_X`                      | `REAL`                                 | -3.3                                                   |
| Input Const | `rSP3_Y`                      | `REAL`                                 | 3.1                                                    |
| Input Const | `rSP3_X`                      | `REAL`                                 | -7.2                                                   |
| Input Const | `rSP2_Y`                      | `REAL`                                 | 2.95                                                   |
| Input Const | `rSP2_X`                      | `REAL`                                 | -11.1                                                  |
| Input Const | `rSP1_Y`                      | `REAL`                                 | 2.8                                                    |
| Input Const | `rSP1_X`                      | `REAL`                                 | -15.0                                                  |
| Input Const | `rCOP_Max`                    | `REAL`                                 | 10.0                                                   |
| Input Const | `rCOP_Min`                    | `REAL`                                 | 1.0                                                    |
| Input Const | `rCOP_Subst`                  | `REAL`                                 | 3.5                                                    |
| Input Const | `tTimeTestIntervall`          | `TIME`                                 | TIME#30m0s0ms                                          |
| Input Const | `rEnergyPriceHeatpump`        | `REAL`                                 | 0.45                                                   |
| Input Const | `rEnergyPriceGasboiler`       | `REAL`                                 | 0.2                                                    |
| Input Const | `rEfficiencyHeatpump`         | `REAL`                                 | 0.9                                                    |
| Input Const | `rEfficiencyGasboiler`        | `REAL`                                 | 0.9                                                    |

Methods:

> mCalculateCurveSectionValue\_Real\_Real

> mCalculateCurveValue\_Real\_Real

Structure:

* mCalculateCurveSectionValue\_Real\_Real (Method)
* mCalculateCurveValue\_Real\_Real (Method)


---

# 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/hvac-library/functionblocks/components/heatpumpgasboilerselection.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.
