> 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 the licensing of CODESYS Runtime licenses for use with HVAC by powerIO® products ## 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 sample applications can be tested in full. After 30 minutes, program execution stops.\ By restarting the controller, demo mode can be run again. {% endhint %} The HVAC by powerIO® libraries must be licensed per controller.\ This licensing variant is marked in the [CODESYS Store](https://store.codesys.com/) and in the product names with the abbreviation *SL* identified. The abbreviation *SL* stands for *Single license*. > When HVAC by powerIO® libraries are updated, the license remains valid. ## Requirements for using Single License products 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 [CODESYS Store](https://store.codesys.com/de/device-reader.html) download in the. For detailed information on licensing, please visit the [CODESYS licensing website](https://de.codesys.com/das-system/lizenzierung.html). Here, among other things, a decision aid regarding the licensing variants CODESYS Key (dongle) and software license container is provided. The CODESYS Key (dongle) can be [CODESYS Store](https://store.codesys.com/de/codesys-key.html) purchased in the. {% hint style="success" %} When purchasing an H1.M100 controller, the CODESYS Key is already included in the scope of delivery and you must **not** purchase a CODESYS Key (dongle). {% endhint %} From our side, the practical advantages and disadvantages between a CODESYS Key (dongle) and software license container are as follows.

	Software license container	CODESYS Key (dongle)
Advantage	Cost-effective, as no additional hardware is required	- Can be used independently of the controller - When replacing the controller, only the CODESYS Key needs to be unplugged and moved
Disadvantage	- If the controller is defective, the license is lost - When replacing the controller, it must be checked which licenses were previously activated (additional effort)	- Additional costs due to the CODESYS Key - Connection to the controller's USB port (must be protected against theft)

### Libraries requiring a license If multiple libraries are used on one controller that require the same license, the license is only required once on the controller. It can be used by multiple libraries.

powerIO library	Required license
HVAC Library	HVAC Building Automation Package SL
HVAC Modbus Library	HVAC Building Automation Package SL
HVAC KNX Library	HVAC KNX SL
HVAC BACnet2 Library	HVAC Building Automation Package SL + BACnet SL from CODESYS
HVACFAM Alarm Email Library	HVAC Building Automation Package SL + IIoT Library from CODESYS*¹
HVAC ModbusIO2 Library	License-free
POWERIOHW Library	License-free
HVAC CSV Library	HVAC Building Automation Package SL
MySQL Library	MySQL Library SL

{% hint style="info" %} Optional licenses \ \ ^\*1 For the functionality of email sending. The library also works without email sending. The alarms can optionally be sent via the [HVAC Automation Portal](/hub/hvac-automation-portal/en/readme.md) be sent; no separate license is required for this. {% endhint %} ## Purchase license[](https://support.powerio.com/docs-hvac/overview/library-licensing#lizenz-erwerben) The licenses must be purchased through the [CODESYS Store](https://store.codesys.com/de/) be purchased. After a successful order, 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. Further ways to install 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*

{% endstep %} {% step %} ### Select device In the **License Manager** must **device** be selected.

Selecting the desired controller

{% endstep %} {% step %} ### Install license Select **Install license** from

Now select **Activate license** from

{% 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. For 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. There you can then **Activate license**. {% endhint %} {% endstep %} {% step %} ### Activate license the ticket ID to **Activate license** enter

{% hint style="info" %} **Ticket ID:** Which you received when purchasing the license from the CODESYS Store. **License server:** Leave at default selection **Container:** Selection of the license container on which the license is stored. Usually the CODESYS Key (dongle) {% endhint %} {% endstep %} {% step %} ### Verify license Activating the license may take a moment. If activation was successful, the license will be displayed in green in the license view.

{% 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 perform this process. Whether deletion of the license and a transfer of the license is possible must be checked via the [CODESYS Support](https://de.codesys.com/support-training/codesys-support.html) inquire about it.\\\\ --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://support.powerio.com/hub/codesys-hvac/en/overview/licensing.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.