Skip to main content

Installing the runtime on the controller

Requirement:

  • The ToolsDeploy Control SL command has been executed and the connection to the device has been established. If this is not the case, then follow the steps in the Establishing a Connection chapter.

  • The add-on for the desired controller (example: CODESYS Control for Linux ARM64) is installed in the CODESYS Development System.

The following instructions describe how to install the runtime system on the Linux device.

  1. Open the Deployment tab.

  2. In the Product list box, select the desired product.

  3. In the Version list box, select the desired version.

  4. Click the Install button.

    The selected runtime system is installed on the device. The controller is restarted automatically. A manual restart is not required.

To uninstall a package, proceed as follows:

  1. In the Installed Packages section, select the corresponding entry.

  2. Stop the controller if it is running and click on _cds_icon_delete_from_list.png button.

  3. In the next dialog, click Yes.

    The package is uninstalled.

Tip

Verify the installation by testing the sample project which is included in the CODESYS package.

The following steps show you how to manage images and instances.

Managing images

For the configuration of a virtual product (for example, a runtime instance or a gateway instance), a corresponding image has to exist on the target device.

When installing CODESYS Virtual Control for Linux SL, images are copied to the C:\Users\<user>\CODESYS Virtual Control for Linux SL\Delivery\ directory as an archive with the extension .tar.gz.

Procedure. Installing an image
  1. Open the Deployment tab.

  2. In the Product list box, select the desired virtual product.

  3. In the Version list box, select the desired version.

  4. Click the Install button.

    The image is transferred to the target system and listed in the Installed Images section.

Caution

In contrast to non-virtual products, there is no automatic start. For virtual products, an instance must first be created on the Operation tab.

Procedure. Deleting an image from the target system
  • On the Deployment tab, in the Manage images area, select the corresponding image and click the _cds_icon_delete_from_list.png button and then select the Delete command.

Important

When an image is used by an instance, it cannot be deleted.

Managing virtual instances

The instances on the target system are managed on the Operation tab.

Some values of the configuration cannot be changed.

Important

The configuration cannot be changed for running instances.

Procedure. Creating and configuring a new instance
  1. Click the _rtsl_icon_add.png button.

    The Add New Instance dialog opens.

  2. In Name, specify a unique name. The name may consist only of alphanumeric characters and the characters .-_. However, the characters .-_ must not be at the beginning.

  3. Optional: In the Filter list box, select the type of image (example: Runtime System or Gateway).

    The list of available images is reduced to images of the selected type.

  4. Then select the corresponding Image. Then click OK.

    The new instance is displayed in the VPLCs section.

  5. Select the instance to configure the newly created instance. The settings for the selected instance appear on the right in the Settings section.

    In this section, you can view and edit all settings of this instance.

    For more information, see: Configuration: CODESYS Virtual Control for Linux SL

Procedure. Deleting an instance

Note: Started instances cannot be deleted.

  1. On the Operation tab, select the instance.

  2. Click the _cds_icon_delete_from_list.png button and select the Delete Selected command.

    The selected instance, the configuration, and the boot project of the instance are deleted.

Tip

The Purge command stops and deletes all instances, configurations, and any CODESYS images which exist on the target device.