> 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/overview/licensing.md).

# Product Licensing

Description of licensing CODESYS Runtime licenses for use with HVAC by powerIO® products

## Introduction

{% hint style="info" %}
All HVAC by powerIO® libraries, as well as the CODESYS Runtime license, can be run in demo mode for 30 minutes.\
All function blocks and sample applications can be tested in full during this time. After 30 minutes, the execution of the program stops.\
By restarting the controller, the demo mode can be run again.
{% endhint %}

The HVAC by powerIO® libraries must be licensed per controller.\
This licensing variant is indicated in the [CODESYS Store](https://store.codesys.com/) and in the product names with the abbreviation *SL* . This abbreviation stands for *SL* for *Single license*.

> When HVAC by powerIO® libraries are updated, the license remains valid.

## Requirements for using Single License products <a href="#vorraussetzungen-zur-nutzung-von-single-license-produkten" id="vorraussetzungen-zur-nutzung-von-single-license-produkten"></a>

The HVAC by powerIO® libraries can be used on CODESYS controllers that have a software license container (formerly called SoftContainer) *or* with a CODESYS Key (dongle).

Whether the controller supports a software license container and/or the CODESYS Key (dongle) can be checked using a free CODESYS application on the target device. For this, please use the [Device Reader](https://store.codesys.com/de/device-reader.html), which you can download in the [CODESYS Store](https://store.codesys.com/de/device-reader.html) .

For detailed information on licensing, please visit the [CODESYS licensing website](https://de.codesys.com/das-system/lizenzierung.html). Among other things, it includes a decision aid regarding the licensing variants CODESYS Key (dongle) and software license container.

The CODESYS Key (dongle) can be purchased in the [CODESYS Store](https://store.codesys.com/de/codesys-key.html) .

{% hint style="success" %}
When purchasing an H1.M100 controller, the CODESYS Key is already included in the scope of delivery and you do not need to purchase **any** CODESYS Key (dongle).
{% endhint %}

From our perspective, the following practical advantages and disadvantages arise between a CODESYS Key (dongle) and a software license container.

<table><thead><tr><th width="249.33333333333331"></th><th>Software license container</th><th>CODESYS Key (dongle)</th></tr></thead><tbody><tr><td><strong>Advantage</strong></td><td>Cost-effective, as no additional hardware is required</td><td>- Can be used independently of the controller<br><br>- When replacing the controller, only the CODESYS Key needs to be moved</td></tr><tr><td><strong>Disadvantage</strong></td><td>- If the controller fails, the license is lost<br><br>- When replacing the controller, it must be checked which licenses were activated previously (additional effort)</td><td>- Additional costs due to the CODESYS Key<br><br>- Connection to the controller's USB port (must be protected against theft)</td></tr></tbody></table>

### License-required libraries <a href="#lizenzpflichtige-bibliotheken" id="lizenzpflichtige-bibliotheken"></a>

If several libraries are used on one controller that require the same license, the license is only needed once on the controller. It can be used by multiple libraries.

<table><thead><tr><th width="273.772705078125">Library powerIO</th><th>Required license</th></tr></thead><tbody><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-library/description.md">HVAC Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-modbus-library/description.md">HVAC Modbus Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-knx-library/description.md">HVAC KNX Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-knx-sl.html">HVAC KNX SL</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-bacnet2-library/beschreibung.md">HVAC BACnet2 Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a><br>+<br><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/codesys-bacnet-sl.html">BACnet SL from CODESYS</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-alarm-message-library/description.md">HVACFAM Alarm Email Library</a></td><td><p><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a><br>+</p><p><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/codesys-iiot-libraries-sl.html">IIoT Library from CODESYS</a>*<sup>1</sup></p></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-modbusio2-lib/beschreibung.md">HVAC ModbusIO2 Library</a></td><td>License-free</td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/poweriohw-hardware-library/description.md">POWERIOHW Library</a></td><td>License-free</td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-csv-library/beschreibung.md">HVAC CSV Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/mysql-library/description.md">MySQL Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/mysql-library-sl.html">MySQL Library SL</a></td></tr><tr><td><i class="fa-book">:book:</i> <a href="https://support.powerio.com/hub/codesys-hvac/en/hvac-alarming-library/description.md">HVAC Alarming Library</a></td><td><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-building-process-automation-sl.html">HVAC Building Automation Package SL</a><br>or<br><i class="fa-certificate">:certificate:</i> <a href="https://store.codesys.com/de/hvac-alarming-sl.html">HVAC Alarming SL</a>*<sup>2</sup></td></tr></tbody></table>

{% hint style="info" %}
Optional licenses\
\ <sup>\*1</sup> For the email sending functionality. The library also works without email sending. The alarms can optionally be sent via the [HVAC Automation Portal](https://support.powerio.com/hub/hvac-automation-portal/en/) ; no separate license is required for this.
{% endhint %}

{% hint style="info" %}
Alternative licenses\
\ <sup>\*2</sup> The HVAC Alarming Library is part of the HVAC Building Automation Package SL. If this license is active on the controller, no further license is required. Without the package, the library is available separately in the CODESYS Store as HVAC Alarming SL.
{% endhint %}

## Purchase license[​](https://support.powerio.com/docs-hvac/overview/library-licensing#lizenz-erwerben) <a href="#lizenz-erwerben" id="lizenz-erwerben"></a>

The licenses must be purchased via the [CODESYS Store](https://store.codesys.com/de/) . After successful ordering, you will receive a so-called ticket ID for activation and installation of the respective license(s). The installation of the license is described in the following section.

## Activate license

There are several ways to install a license on the controller. We recommend installation with the CODESYS License Manager. Further methods for installing CODESYS licenses can be found on the [CODESYS licensing website](https://de.codesys.com/das-system/lizenzierung.html).

{% stepper %}
{% step %}

### Open License Manager

Opening the **License Manager** under *Tools* -> *License Manager*

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FdGYGxNRMECtL3RuJ3MO7%2Flizenz%20aktivieren.png?alt=media&amp;token=70586746-526a-4131-992d-f8e9bd4100c4" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Select device

In the **License Manager** must **Device** be selected.

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FuxZ2PxN6u5laHn9hHUeT%2Flizenz%20manager.png?alt=media&amp;token=0c2bf85c-15ad-4756-a0d4-de9d36b916b8" alt="" width="243"><figcaption></figcaption></figure></div>

Selecting the desired controller

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FMX9TNymP8E3bxy6FktcP%2FGer%C3%A4te%20Ausw%C3%A4hlen.png?alt=media&amp;token=640ff9c0-d353-4923-bdad-71f83845a06d" alt="" width="550"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Install license

Select **Install license** from

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FxtdiDH9GRgZzCF9Hyt8u%2Flizenzmanager%20%C3%BCbersicht%202.png?alt=media&amp;token=ade95be3-3273-42fe-b9ba-9038bca6a00a" alt="" width="467"><figcaption></figcaption></figure></div>

Now select **Activate license** from

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FSsXZBca5kCASyc0SiEHR%2Flizenz%20instalieren%20operator.png?alt=media&amp;token=d33ca4ca-07c9-449f-a6e9-0ef471302ec5" alt="" width="360"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**No internet connection? - Alternatives:**\
\
Variant 1:\
Create an activation file on a workstation PC with an internet connection and then install it directly. For this, select **Install license** instead of activate license.\
\
Variant 2:\
If a CODESYS Key (dongle) is used, you can also plug it into a workstation PC. There you can then enter the **Activate license**.
{% endhint %}
{% endstep %}

{% step %}

### Activate license

ticket ID to **Activate license** enter

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FwPnrs5nv1dvbrFteb9Zp%2Flizenz%20instalieren%201.png?alt=media&amp;token=6d2dc2f1-8e70-4890-8d5c-5769a5d49741" alt="" width="362"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Ticket ID:** Which you received when purchasing the license from the CODESYS Store.

**License server:** Leave at the standard selection

**Container:** Selection of the license container to which the license is assigned. Usually the CODESYS Key (dongle)
{% endhint %}
{% endstep %}

{% step %}

### Check license

Activating the license may take a moment.

If the activation was successful, the license will be shown in green in the license view.

<div align="left"><figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FZAXk6ArsEcU7p4dhFLRt%2Fimage.png?alt=media&amp;token=9beb292e-3246-47f0-afb2-ba0051d540b6" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Move or delete license[​](https://support.powerio.com/docs-hvac/overview/library-licensing#lizenz-umziehen-oder-l%C3%B6schen)

If a license was installed on the wrong CODESYS Key or software license container, it can be removed with a deletion license and activated again.\
\
powerIO® GmbH cannot carry out this process. Whether deleting the license and transferring the license is possible, you must request via the [CODESYS Support](https://de.codesys.com/support-training/codesys-support.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/en/overview/licensing.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.
