# Installation

## CODESYS device runtime for CCpilot display computers

There is a specific CODESYS device runtime available for each CCpilot display, navigate to the product page to get the package for your device.

[CrossControl Display Computers](https://crosscontrol.com/displays-computers/)

DEVICE DOWNLOADS <span style="font-size: 24px;">&rarr;</span> CODESYS <span style="font-size: 24px;">&rarr;</span> DEVICE RUNTIME

![CODESYS Downloads](screenshots/codesys-downloads.png)

Make sure to download the correct runtime version based on the CODESYS license installed on the display, in the previous section we mentioned the different licenses.

## CODESYS video training

This section of the website provides helpful videos that can help/guide you through different stages of CODESYS. From general stuff on how to setup CODESYS to more advanced tasks like PLC programming.

Link: [Video Training | CODESYS](https://crosscontrol.com/support/video-training/)

Screenshot of the Video Trainig page:

![Video Training](screenshots/video-training.png)

![Observe](screenshots/observe-icon.png)
**Note!**
These video trainings are older than the versions presented in this documentation, observe that there may be some differences in some steps, packaging, version numbers etc.

## Install CODESYS IDE

### Download CODESYS IDE

Download the CODESYS IDE from CODESYS store website directly from their page: [CODESYS Store](https://store.codesys.com/en/)

Or head to our website and proceed from there: [CODESYS | CrossControl](https://crosscontrol.com/software-solutions/linx-software-suite/codesys/)

![CODESYS Store](screenshots/codesys-store.png)

In this link [CODESYS Development System V3](https://store.codesys.com/en/codesys.html) you will find the latest CODESYS IDE version that is connected to the runtime of our displays and controller units.

![CODESYS Download Version](screenshots/codesys-download-versions.png)

![Observe](screenshots/observe-icon.png)
**Observe!**
Read about the System Requirements before you proceed to download the specific version. A user account on CODESYS website is needed to be able to download the IDE!

### Install IDE

After downloading the IDE .exe file on your PC, click on it and run the installation by following the instructions.

![CODEYS exe](screenshots/codesys-exe.png)

The installed CODESYS IDE can be found on the desktop or in the Windows Start-menu as shown in the image on the right:

![Observe](screenshots/observe-icon.png)
**Note!**
There is a video showing how to perform the installation (select the video “Installation” after using the link in CODESYS video trainings section).

![Information](screenshots/info.png)
For more information on installation and startup, see the following document from CODESYS: [CODESYS Getting Started](https://content.helpme-codesys.com/en/CODESYS%20Control/_rtsl_first_steps.html)

### Basic setup

This chapter describes the additional installation and configuration steps needed to be able to develop CODESYS applications and download them to the CrossControl products.  
This initial setup is only required for the first time or when you change to another IDE.  

#### Download plugins project archive

CODESYS development environment plugins
Device descriptions files, library files for example:

![Plugins](screenshots/plugins.png)

CCAUX- API (that can access and configure HW related features), CCSAP – API
(which is used to access Data Engine as well as other required libraries), components and plugins are all made in a project archive that can be downloaded and extracted to the CODESYS IDE in order to run and deploy the built application on a CCpilot display computer.
Download:
“crosscontrol_development_environment_plugins.projectarchive” as shown in the image above.

More detailed information about CCAux and CCSAP can be found on CODESYS IDE once you have extracted the archive in your IDE tool.

Also visit CCAux or CCSap sections to learn more about these resources and how to use them in your CODESYS projects.

#### Steps to Install/extract project archive in CODESYS IDE

1. Open the installed CODESYS IDE and select:
File <span style="font-size: 24px;">&rarr;</span> Project Archive <span style="font-size: 24px;">&rarr;</span> Extract Archive…

    ![CODESYS extract](screenshots/codesys-extract.png)

2. Browse to the folder containing the downloaded project archives.

3. Select the folder you want to use as the development folder for your project(s) and check all the items shown in the contents list. Press “Extract”.

    ![CODESYS extract archive](screenshots/codesys-extract-archive.png)

4. When the task is finished, the tool will show a list of components that could be updated to a newer version. The recommendation is to choose action “Do not update” for all the tabs (Library, Device, Compiler Visu etc)!
Then press “OK”.

The CODESYS tool will now have the following look:

![CODESYS window tool](screenshots/codesys-window-tool.png)

![Observe](screenshots/observe-icon.png)
**Note!**
There is a video showing how-to perform the basic setup (select the video “Initial setup” after first using the link in CODESYS video training section).
