Product Licensing

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

Introduction

All HVAC by powerIO® libraries and also the CODESYS runtime license can be run for 30 minutes in demo mode. All function blocks and example applications can be tested in full. After 30 minutes the program execution is aborted. By restarting the controller, the demo mode can be run again.

The HVAC by powerIO® libraries must be licensed per controller. This licensing variant is shown in the CODESYS Store and in the product names with the abbreviation SL marked. 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 software license containers and/or the CODESYS key (dongle) can be checked on the target device using a free application from CODESYS. For this purpose please use the Device Reader, which you can CODESYS Store download from.

For detailed information about licensing please visit the CODESYS licensing website. Among other things, this contains 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 store.

When purchasing an H1.M100 controller, the CODESYS key is already included in the scope of delivery and you do not need to purchase a CODESYS key (dongle).

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

	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 must be reconnected
Disadvantage	- If the controller fails, the license is lost - When exchanging 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)

Licensed libraries

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

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*1
HVAC ModbusIO2 Library	License-free
POWERIOHW Library	License-free
HVAC CSV Library	HVAC Building Automation Package SL
MySQL Library	MySQL Library SL

Optional licenses ^*1 For the functionality of sending mail. The library also works without mail sending. Alarms can optionally be sent via the HVAC Automation Portal , no separate license is required for this.

Purchase license​

Licenses must be purchased via the CODESYS Store After a successful order you will receive a so-called ticket ID to activate and install 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 variants for installing CODESYS licenses can be found on the CODESYS licensing website.

1

Open License Manager

Opening the License Manager under Tools -> License Manager

2

Select device

In the License Manager must device be selected.

Selecting the desired controller

3

Install license

Select Install license from

Now select Activate license from

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 enter the Activate license.

4

Activate license

Ticket ID for Activate license enter

Ticket ID: Which you received when purchasing the license from the CODESYS Store.

License server: Leave on default selection

Container: Selection of the license container on which the license will be stored. Usually the CODESYS key (dongle)

5

Check license

The activation of the license may take a short moment.

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

Move or delete license​

If a license was installed on the wrong CODESYS key or software license container, it can be removed with a deletion license and reactivated. powerIO® GmbH cannot perform this process. Whether a deletion of the license and a transfer of the license is possible must be requested from the CODESYS Support \