1 CODESYS License Activation and Restoration

If the user has purchased an authorized CODESYS License, refer to the following for activation, backup and restoring.

TIP:

Only PLC devices running Raspberry Pi OS are supported.

1.1 Activating a license

TIP:

License activation locks the license to your Raspberry Pi device. Activation and reactivation are possible only on the same device.

Preparation:

  • The CODESYS IDE software has been downloaded and installed on your Windows PC.
  • The PLC device has been started normally and connected to the Ethernet.
  • Make sure that the Windows PC is connected to the network and is in the same LAN as the PLC device.
  • The IP address and login username/password of the PLC device have been obtained.
  • A license has been obtained.

Steps:

  1. Open CODESYS IDE software.

  2. (Optional) Install the runtime of PLC device.

    TIP:

    If the runtime is already installed, you can skip this step.

    a) Select “Tools → CODESYS Installer…” in the menu to open the CODESYS Installer page.

    image-20240614154818085

    b) Select "Browse" in the CODESYS Installer page, input "Raspberry" in the search box to search; select the corresponding version of the runtime based on the search results, and then click "Install" to install.

    6-new

    c) Follow the prompts to complete the installation.

    d) After the installation is complete, select "Tools → Update Raspberry Pi" in the menu to open Raspberry Pi page.

    image-20240614155138201

    e) Input the login user name and password of PLC device, fill in the device IP address, select the version, and click "Install".

    image-20240614155713380

    f) Follow the prompts to complete the installation.

  3. Create a standard project.

    image-20240614164813585
  4. Double-click "Device" on the left side, select the "Scan Network" tab on the right. Select the PLC device in the "Select Device" tab that pops up, and then click "OK".

    image-20240614165122175

    TIP:

    If the device is not scanned, the possible reasons are as follows:

    ● The PC and PLC device are not in the same network segment. You need to reconfigure the PC and device to the same network segment.

    ● The runtime is not installed or is corrupted and needs to be reinstalled.

  5. In the "Device User Logon" tab that pops up, input your user name and password, then click"OK" to log in to the device.

    image-20240614165803565
  6. After the device is logged in normally, select "Tools → License Manager..." in the menu to open the License Manager page.

    image-20240614170228456
  7. In the “Select Target” page, select “Device”,then click “Next”.

    image-20240614171045366
  8. In the “Select Container” page, select “Soft container”,then click “Next”.

    image-20240614171515762
  9. In the “Select Device” page, select the device,then click “OK”.

    image-20240614171744138
  10. In the “License Manager” page, click “Install Licenses...”.

    image-20240614172020796
  11. In the “Install Licenses” page, select "Activate license", then click “Next”.

    image-20240614172316050
  12. In the “Install Licenses” page, input "Ticket ID" (License number) and select container, then click “Next”.

    image-20240614172617211
  13. Click “Finish” to complete the activation.

1.2 Backing Up a License

During use, the user can back up the license file, the authorization can be restored through the file later.

TIP:

Automatic backup of the license in CODESYS V3.5 SP13 and later. It will Generate an authorization file with the suffix ".WibuCmRaU" in the root directory of the PLC device.

Preparation:

The PLC device has been connected in the CODESYS IDE software and the license has been activated.

Steps:

  1. Double-click "Device" on the left side, select the "Files" tab on the right pane. Click in the Runtime area, it will display the files in the root directory of PLC device.

    image-20240614142636752

  2. Select the license file and click image-20240614142806810 to save the file to a local PC.

    image-20240614143025255

1.3 Restoring a license

If the user reinstalls the operating system on the PLC device, it is necessary to restore the device authorization. Restoring authorization supports two different operation methods: reinstalling license and restoring through the backup license file. Please refer to the following for operation.

TIP:

License activation locks the license to your Raspberry Pi device. Activation and reactivation are possible only on the same device.

Preparation:

The PLC device has been connected in the CODESYS IDE software.

Steps:

◆ Restoring the license in the License Manager

  1. After the device is logged in normally, select "Tools → License Manager..." in the menu to open the License Manager page.

    image-20240614170228456
  2. In the “Select Target” page, select “Device”,then click “Next”.

    image-20240614171045366
  3. In the “Select Container” page, select “Soft container”,then click “Next”.

    image-20240614171515762
  4. In the “Select Device” page, select the device,then click “OK”.

    image-20240614171744138
  5. In the “License Manager” page, click “Additional Functions” and select "Restore license".

    image-20240614175217159
  6. In the “Restore Licenses” page, input "Ticket ID" (License number) , then click “Restore”.

    image-20240614175600768

◆ Restoring a license from the explicitly created license update file"xxxx.WibuCmRaU"

  1. After the device is logged in normally, select "Tools → License Manager..." in the menu to open the License Manager page.

    image-20240614170228456
  2. In the “Select Target” page, select “Device”,then click “Next”.

    image-20240614171045366
  3. In the “Select Container” page, select “Soft container”,then click “Next”.

    image-20240614171515762
  4. In the “Select Device” page, select the device,then click “OK”.

    image-20240614171744138
  5. In the “License Manager” page, click “Install Licenses...”.

    image-20240614172020796
  6. In the “Install Licenses” page, select "Install license", then click “Next”.

    image-20240614180121892
  7. Select Container,import the license file, then click "Finish".

    image-20240614180357668