# Product Licensing

## Introduction

{% hint style="info" %}
All HVAC by powerIO® libraries and the CODESYS runtime license can be run in demo mode for 30 minutes.\
All function blocks and example applications can be tested in full during this time. After 30 minutes, program execution stops.\
Restarting the controller allows demo mode to be run again.
{% endhint %}

The HVAC by powerIO® libraries must be licensed per controller.\
This licensing option is identified in the [CODESYS Store](https://store.codesys.com/) and in the product names with the suffix *SL* . The abbreviation *SL* stands 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 referred to as SoftContainer) *or* with a CODESYS Key (dongle).

Whether the controller supports the software license container and/or the CODESYS Key (dongle) can be checked with a free application from CODESYS 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, this provides a decision aid regarding the licensing options 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 package contents and you do not have to buy **a** CODESYS Key (dongle).
{% endhint %}

From our perspective, the following practical advantages and disadvantages exist 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 is defective, the license is lost<br><br>- When replacing the controller, it must be checked which licenses were previously activated (additional effort)</td><td>- Additional costs due to 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 requiring the same license are used on one controller, the license is only required once on the controller. It can be used by multiple libraries.

<table><thead><tr><th width="273.772705078125">Library</th><th>Required license</th></tr></thead><tbody><tr><td><i class="fa-book">:book:</i> <a href="/pages/12c84a494c7f6b2747157d67c58eed9846646a01">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="/pages/0b73a16d0bb89a1115b2d9399b9f6863253dc0a3">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="/pages/cef7399caa4236f2658da69b0d626ea46a29e811">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="/pages/d68bfefabd12676ee3efd1ddaf759ee9e6e066f0">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="/pages/d11da76011af62e0d1cb7097c17c17bcd55f7184">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="/pages/3c000c2e1c5802f3cddb686a7f2386cfb40367a5">HVAC ModbusIO2 Library</a></td><td>License-free</td></tr><tr><td><i class="fa-book">:book:</i> <a href="/pages/ff94d80b26fc1d4ac7dbe1ef14a978f1678ba62f">POWERIOHW Library</a></td><td>License-free</td></tr><tr><td><i class="fa-book">:book:</i> <a href="/pages/920d9a8081fce73e9c0982637381189b2b407219">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="/pages/87897848a1af03c9b6c8c3da5ddb0fd1707956e5">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></tbody></table>

{% hint style="info" %}
Optional licenses \
\ <sup>\*1</sup> For the functionality of sending mail. The library also works without sending mail. The alarms can optionally be sent via the [HVAC Automation Portal](/hub/hvac-automation-portal/en/readme.md) , for which no separate license is required.
{% 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 activating and installing 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 installing it with the CODESYS License Manager. You can find further ways to install CODESYS licenses on the [CODESYS licensing website](https://de.codesys.com/das-system/lizenzierung.html).

{% stepper %}
{% step %}

### Open License Manager

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

<div align="left"><figure><img src="/files/8a625606f25bee616d857563810c91f26e90f0f3" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Select device

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

<div align="left"><figure><img src="/files/00523119cd5c292e0479c66ba8119dee4191ea48" alt="" width="243"><figcaption></figcaption></figure></div>

Selecting the desired controller

<div align="left"><figure><img src="/files/f242f8436249390072a6f4b53b10af79444e5bb5" alt="" width="550"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Install license

Select **Install license** from

<div align="left"><figure><img src="/files/71f023a64afa9737b07f70ff88e686aee9896ae7" alt="" width="467"><figcaption></figcaption></figure></div>

Now select **Activate license** from

<div align="left"><figure><img src="/files/2a7e0227bffb7628c8c402c7641265e148208d62" alt="" width="360"><figcaption></figcaption></figure></div>

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

{% step %}

### Activate license

enter the ticket ID to **Activate license** the

<div align="left"><figure><img src="/files/78d109b11a034c59a442b6f3c739182ed1aa3a23" alt="" width="362"><figcaption></figcaption></figure></div>

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

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

**Container:** Selection of the license container in which the license will be stored. Usually the CODESYS Key (dongle)
{% endhint %}
{% endstep %}

{% step %}

### Check license

Activating the license may take a short moment.&#x20;

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

<div align="left"><figure><img src="/files/ed79457d44280214a613a2c72f2dbd06865629c2" 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 delete license and activated again.\
\
powerIO® GmbH cannot perform this process. Whether deleting the license and transferring the license is possible must be clarified via the [CODESYS Support](https://de.codesys.com/support-training/codesys-support.html) \n


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.powerio.com/hub/codesys-hvac/en/overview/licensing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
