- Industrial controls - I4.0
- Setup and support
- 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:
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:
- ecomatDisplay 4.3" - software package.zip
- Extract the contents to a local folder on your computer
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:
- Open Library Manager inside CODESYS
- Download and install the following libraries: Ethernet/IP.lib and ModbusTCP.lib
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.