# CODESYS Licenses

Most of the CrossControl's display computers are delivered with preinstalled CODESYS licenses. Sample units are available with an evaluation version of CODESYS preinstalled, if your display does not come with a CODESYS license and you would like to test the platform reach out to technical support team at [CrossControl | Support](support@crosscontrol.com) for support in obtaining an evaluation copy!

## Installing a CODESYS license

### Preparations

1. To be able to install the new license, there must be a Qt-5 runtime version present on the CCpilot display.
If Qt has already been installed, jump to step **Installing license**.
If the unit does not have any installed software navigate to the product page for the display and follow:

DOWNLOADS <span style="font-size: 24px;">&rarr;</span> DEVICE DOWNLOADS <span style="font-size: 24px;">&rarr;</span> QT <span style="font-size: 24px;">&rarr;</span> CC LINUX X.X

![Qt runtime download](screenshots/Qt-runtime-download.png)

Copy the file to the display using a USB-drive or SSH.

Then log into the display and run the following command to install the file:

    $ sudo opkg install [fileName]

Change **[fileName]** to the actual name of the file.

![Observe](screenshots/observe-icon.png)
**Note!**
There should be a **Qt-5.x.x** folder available in **/opt** directory after installation!

### Installing license

Unpack the ZIP-file containing the new license onto a PC.
The following files should be included in the ZIP-file.

    autorun
    cc-auto.sh
    CCKEY-20210517.key
    KeyReader_iMX5
    KeyReader_iMX6
    KeyReader_iMX8
    KeyReader_x86
    KeyReader_x86_64

![Observe](screenshots/observe-icon.png)
**Note!** The date on the **CCKEY** file will be the date when the license key was generated.

#### Autoinstall from USB-drive

1. Copy all the files (from the ZIP) to the root-folder on an empty USB-drive.
This is important! If the files are not found on the root-folder, the installation will fail!
2. Insert the USB-drive into the device.
3. The installation will start automatically and should indicate the progress status.
Note, this method requires Qt to already be installed
4. When installation is done, the unit will reboot automatically after 10 sec.
5. Remove the USB during restart (otherwise it will try to install the license once more).

#### Check the installed license

To check the installed license, type the following command in a terminal window:

    $ cat /dev/serial-eeprom | grep CODESYS

One of the following lines will be displayed, depending on the selected runtime version:

| License      | Meaning                                                     |
| ----------------------- | --------------------------------------------------------------- |
| **CODESYS_LICENSE:0**           | The Novisu license installed                        |
| **CODESYS_LICENSE:1**                 | The Visu license installed                                         |
| **CODESYS_LICENSE:2**                  |  The Webvisu license installed                                                     |
| **CODESYS_LICENSE:3**                  | The VisuWebvisu license installed                                    |
| **CODESYS_LICENSE:4**                  | No valid license available|