> 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-alarming-library/description.md).

# Beschreibung

Die HVAC Alarming Library meldet Zustände von HVAC Anlagen in fünf Meldeklassen über den CODESYS AlarmManager. Die Seite nennt Funktion und Lizenz.

{% columns %}
{% column width="25%" %}

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FNFJZWlP7xK48PjnmbgFr%2FpowerIO%20Icon%20HVAC%20Alarming.png?alt=media&amp;token=b5460e0e-85b9-49ed-b112-dd629ba19e19" alt="Symbol der HVAC Alarming Library" width="100"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="75%" %}
Die HVAC Alarming Library ist eine CODESYS Bibliothek, die Zustände von HVAC Anlagen in fünf Meldeklassen über den CODESYS AlarmManager meldet. Das Eintragen in die Alarmliste, das Austragen und die Aufbereitung der Meldungstexte übernimmt die Bibliothek.
{% endcolumn %}
{% endcolumns %}

***

Damit Sie direkt loslegen können, bieten wir Ihnen die Bibliothek als Download an. Die Bibliothek ist Bestandteil des HVAC Building Automation Package SL und einzeln als HVAC Alarming SL im CODESYS Store erhältlich. Sollten Sie weitere Unterstützung benötigen, so zögern Sie bitte nicht uns zu kontaktieren.

<a href="/hub/downloads/codesys-hvac-downloads/hvac-alarming-library.md" class="button primary" data-icon="up-right-from-square">Zum Download</a> <a href="https://store.codesys.com/de/hvac-alarming-sl.html" class="button secondary" data-icon="seal">Lizenz erwerben</a> <a href="https://www.powerio.com/de/kontakt" class="button secondary" data-icon="question">Unterstützung erhalten</a>

{% hint style="info" %}
**Lizenzierung:**

Ohne Lizenzerwerb (nur *Download*) läuft die Bibliothek für **30 Minuten als uneingeschränkte Demoversion**. Für den produktiven Einsatz ist pro Steuerung eine Single License (SL) / Einzelgeräte Lizenz erforderlich.\
Für eine Anweisung zur Installation von Lizenzen, besuchen Sie bitte die Seite [Produkt Lizenzierung](/hub/codesys-hvac/overview/licensing.md).
{% endhint %}

## Übersicht

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-ada4176c02a7af9bc3b8c23513f6fdf58487916d%2FHVACAlarming%20Demo%20CFC.png?alt=media" alt="CFC Programm in CODESYS mit den Funktionsbausteinen AlarmingAlarm, AlarmingError, AlarmingHand, AlarmingHint, AlarmingService und Alarming. Die Texteingänge sind über ADR mit WSTRING Variablen verbunden."><figcaption><p>Die Funktionsbausteine der HVAC Alarming Library im CFC Editor</p></figcaption></figure>

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-62cb01c460331bfb9888ddab1d80ffedd554f6b5%2FHVACAlarming%20Demo%20Alarmliste.png?alt=media" alt="CODESYS Visualisierung mit Alarmtabelle. Die Meldungen HK01 Pumpe Hand und HK01 Pumpe Alarm stehen mit Zeitstempel, Symbol und Meldeklasse in der Liste."><figcaption><p>Gemeldete Zustände in der Alarmtabelle der CODESYS Visualisierung</p></figcaption></figure>

## Funktionsweise

Die HVAC Alarming Library meldet Anlagenzustände zyklisch am CODESYS AlarmManager an und wieder ab. Ein Anwenderbaustein übergibt nur das anstehende Signal und einen Zeiger auf den Meldungstext. Das Eintragen in die Alarmliste, das Austragen und die Aufbereitung des Anzeigetextes übernimmt die Bibliothek.

Für jede Meldeklasse gibt es einen Einzelbaustein. Der Sammelbaustein [`Alarming`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarming.md) vereint alle fünf Meldeklassen und bietet zusätzlich eine Prioritätssteuerung zwischen Alarm, Störung und Hinweis.

## Meldeklassen

Jede Meldeklasse entspricht einer festen Alarm ID der Alarmgruppe `HVAC_Alarming`.

| Meldeklasse        | Alarm ID | Eingang an `Alarming` | Einzelbaustein                                                                                     |
| ------------------ | -------- | --------------------- | -------------------------------------------------------------------------------------------------- |
| Alarm              | ID\_0    | *xAlarm*              | [`AlarmingAlarm`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarmingalarm.md)     |
| Störung / Warnung  | ID\_1    | *xError*              | [`AlarmingError`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarmingerror.md)     |
| Hand / Handbetrieb | ID\_2    | *xHand*               | [`AlarmingHand`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarminghand.md)       |
| Hinweis / Info     | ID\_3    | *xHint*               | [`AlarmingHint`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarminghint.md)       |
| Service / Wartung  | ID\_4    | *xService*            | [`AlarmingService`](/hub/codesys-hvac/hvac-alarming-library/funktionsbausteine/alarmingservice.md) |

## Meldungstext

Die HVAC Alarming Library setzt den Text in der Alarmliste aus bis zu vier Teilen zusammen, jeweils durch ein Leerzeichen getrennt:

1. Präfix 1 aus *pwsPrefix1*, optional
2. Präfix 2 aus *pwsPrefix2*, optional
3. Basistext aus *pwsText*
4. Instanzpfad in der Form `>>> Instanzpfad <<<`, wenn `GV_Alarming.xInstNameOn` gesetzt ist

Beispiel: Präfix 1 `HK01`, Präfix 2 `Pumpe` und Basistext `Alarm` ergeben die Meldung `HK01 Pumpe Alarm`.

Die Bibliothek berechnet den Text beim ersten Aufruf und nach erneuter Freigabe der Alarmierung. Eine Änderung von `GV_Alarming.xInstNameOn` und eine steigende Flanke an `GV_Alarming.xTextUpdate` oder am Eingang *xTextUpdate* lösen ebenfalls eine Neuberechnung aus.

{% hint style="info" %}
Die Texteingänge sind Zeiger auf `WSTRING` Variablen. Die Zeichenketten müssen dauerhaft in der Anwendung existieren. Übergeben Sie deshalb Variablen wie `ADR(wsTxtAlarm)` und keine temporären Ausdrücke.
{% endhint %}

## Alarmierung abschalten

Die Alarmierung lässt sich für eine Instanz über *xAlarmEn* und global über `GV_Alarming.xAlarmlistOFF` sperren. Nach dem Sperren bleibt der Baustein noch 5 s aktiv und meldet in dieser Zeit alle Meldeklassen der Instanz ab. Diese Nachlaufzeit braucht der Alarmtask, um das Austragen aus der Alarmliste zu erfassen. Die Konstante `GC_Alarming.gc_tAlarmDisableDelay` legt die Nachlaufzeit fest, der Standardwert ist 5 s.

{% hint style="warning" %}
Rufen Sie die Instanz über die gesamte Nachlaufzeit von 5 s weiter zyklisch auf. Andernfalls bleiben ihre Meldungen in der Alarmliste stehen.
{% endhint %}

## Systemvoraussetzungen und Lizenz

Die HVAC Alarming Library ist Bestandteil des [HVAC Building Automation Package SL](https://store.codesys.com/de/hvac-building-process-automation-sl.html). Wenn diese Lizenz auf der Steuerung aktiv ist, ist keine weitere Lizenz erforderlich. Ohne das Paket ist die Bibliothek einzeln als [HVAC Alarming SL](https://store.codesys.com/de/hvac-alarming-sl.html) erhältlich.

| **Dokumentation Version**      | <code class="expression">space.vars.HVACAlarming\_library\_latest</code>                                                                                                                 |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Platzhalter**                | `HVACAlarming`                                                                                                                                                                           |
| **Verfügbar in CODESYS Store** | *Ja*                                                                                                                                                                                     |
| **Programmiersystem**          | *CODESYS V3.5.21.2 oder höher*                                                                                                                                                           |
| **Laufzeitsystem**             | *CODESYS Control V4.10.0.0 oder höher*                                                                                                                                                   |
| **Lizenzierung**               | *Single License (Einzelgerätelizenz)*                                                                                                                                                    |
| **Lizenz**                     | [HVAC Building Automation Package SL](https://store.codesys.com/de/hvac-building-process-automation-sl.html) oder [HVAC Alarming SL](https://store.codesys.com/de/hvac-alarming-sl.html) |


---

# 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-alarming-library/description.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.