• Products
  • Markets
  • IIoT & Solutions
  • Company
  • Resources
  • Supply Chain Software
  • my ifm
  1. Industrial controls - I4.0
  2. Setup and support
  3. CODESYS Setup guide

CODESYS setup guide

This guide walks you through installing CODESYS, configuring your environment, and setting up the ecomatDisplay software package so you can begin developing projects successfully.

Step-by-step guide

Step 1: Install the CODESYS Installer

Download the latest version of the CODESYS Installer:
CODESYS Installer download page

 

Step 2: Download the configuration file

Download the configuration file:

ecomatDisplay CODESYS SP19P7

 

Step 3: Run the Installer as Administrator

Once the installer file has downloaded, run the ‘CODESYS Installer’ as an administrator.

This helps prevent issues with missing components or restricted access later.

 

Step 4: Choose the express installation option

When the installer launches:

  • Select the ‘Express’ installation option
  • Click ‘Next’

 

The express option automatically selects the most common components required, simplifying the setup process for first-time users.

 

Step 5: Add the configuration file

To ensure your environment is setup correctly:

  • Click on the 3 dots and select the downloaded .config file from step 2.

 

Once it is opened, you can click ‘Next’ and begin the installation process.  

 

Step 6: Configure installation options

In this step:

  • Optionally assign a custom name to this installation (helpful if you manage multiple versions)
  • Enable ‘Create separate repositories’

Creating separate repositories ensures this environment remains isolated and stable, especially when working with specific device packages.

  • Leave the default add-ons selected
  • Click ‘Install’ to begin the process
 

Step 7: Download the ecomatDisplay software package

Download the required device package:

Make sure you remember the extraction location—you’ll need it in the next step.

 

Step 8: Install the ecomatDisplay package in CODESYS

After installing the base environment:

  • Open CODESYS Installer again
  • Click “Change” on your installed version
  • Select “Install”
  • Browse to the extracted folder
  • Choose the file:
    ifm_ecomatDisplay4.3inch_V1.4.1.0.package

This step installs device-specific support required to program and communicate with the ecomatDisplay.

 

Step 9: Launch CODESYS

To finalize setup:

  • Click the “Start” button from the installer

This launches the CODESYS development environment, where you’ll complete the remaining configuration steps.

 

Step 10: Install required communication libraries

To enable communication protocols:

These libraries are required if your project will communicate over industrial networks using Ethernet/IP or Modbus TCP.

 

Step 11: Freeze the CODESYS version and start your project

Before beginning development, freeze the CODESYS version.

 

Freezing prevents updates or changes that could break compatibility with your installed packages and libraries.

Once frozen this is how the installation will look and now you can click on the ‘Start’ button and start working on your project.

NOTE: If you want to download any other external packages or libraries, please make sure to install another Codesys installation.