Product Licensing

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

Introduction

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.

The HVAC by powerIO® libraries must be licensed per controller. This licensing option is identified in the CODESYS Store 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

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, which you can download in the CODESYS Store .

For detailed information on licensing, please visit the CODESYS licensing website. 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 .

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).

From our perspective, the following practical advantages and disadvantages exist 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 needs to be 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 CODESYS Key - Connection to the controller's USB port (must be protected against theft)

License-required libraries

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.

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 sending mail. The alarms can optionally be sent via the HVAC Automation Portal , for which no separate license is required.

Purchase license​

The licenses must be purchased via the CODESYS Store . 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.

1

Open License Manager

Open the License Manager under Tools -> License Manager

2

Select device

In the License Manager device must 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. 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.

4

Activate license

enter the ticket ID to Activate license the

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)

5

Check license

Activating the license may take a short moment.

If activation was successful, the license will be shown 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 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 \n