Overview

This guide explains how to install the CODESYS Control runtime on a Robustel EG series gateway (such as the EG5120 or EG5200). By installing this runtime, you can transform your Robustel gateway into a powerful, industrial-grade PLC (Programmable Logic Controller). This allows you to develop and execute complex automation logic, written in the standard CODESYS Development System, directly on your edge device.

This article will walk you through preparing your PC's software, connecting to the gateway, deploying the runtime, and verifying that the installation was successful.

What You'll Need

• Hardware:
  • 1 x Robustel EG series gateway (e.g., EG5120)
  • 1 x PC running Windows 10 or higher.
• Software/Firmware:
  • CODESYS Development System: The main IDE (e.g., V3.5.21.30).
  • CODESYS Control for Linux ARM64 SL: The .package file for the runtime.
  • An SSH client (e.g., PuTTY, Windows Terminal).
• Other:
  • A registered account at the CODESYS Store (for downloads).
  • SSH Access: You need a sudo (administrator) user account to install software. The default admin user for the web UI does not have the correct permissions.
    ✔ If you already have SSH access, proceed to the next section
    ❓ Need help setting up SSH? See: How to create a sudo user with SSH access on an EG series device

Step-by-Step Configuration Guide

The process is divided into key stages: preparing the CODESYS installer on your PC, connecting to the gateway, and then deploying the runtime.

Step 1: Prepare CODESYS Installer on Your PC

First, you must install the downloaded runtime package into your local CODESYS Development System.

1. Ensure you have already installed the CODESYS Development System on your Windows PC.
2. Find and run the CODESYS Installer as an administrator.
3. Click the Install File(s) button.
4. Browse your computer and select the CODESYS Control for Linux ARM64 SL file you downloaded from the CODESYS store.
5. Wait for the installer to load the package. It may also download additional required components. Once complete, the package is "Installed" and ready to be deployed.
   

Step 2: Connect to the Gateway

Now you will use the CODESYS tool to connect to your Robustel gateway.

1. Open your main CODESYS Development System software(e.g., CODESYS V3.5 SP21 Patch 3).
2. From the top menu, navigate to Tool -> Deploy Control SL.

3. A Deploy Control SL window will open.
4. In the IP address field, enter the gateway's LAN IP address, which defaults to 192.168.0.1 (or select the gateway by clicking the Scan button).
5. In the User name and Password fields, you must enter the credentials for the sudo user you created on the gateway (not the admin user).
6. Click the Connect button. You may be prompted to enter the sudo password a second time for authentication.

Step 3: Install the Runtime

With the connection established, you can now deploy the runtime package.

1. Once connected, click the Deployment tab.
2. From the Product dropdown menu, select CODESYS Control for Linux ARM SL.
3. From the Version dropdown, select the version you just prepared in Stage 1 (e.g., 4.17.0.0 (arm64)).
4. Click the Install button.

5. A confirmation window titled Install or update Edge Gateway will appear. Click Yes.
6. The installer will now deploy and install the runtime on the Robustel gateway. Wait until 'Successfully installed codesyscontrol' appears in the message bar below, and the error count shows 0. This will take several seconds.

7. When complete, you can click the refresh icon under the Installed Packages list to confirm the two new packages are installed on the target.

Verification & Testing

After installation, it's important to verify that the runtime is operating correctly. Here are three methods to do so.

Method 1: Check via SSH

1. Open an SSH client (like PuTTY or Terminal) and connect to your gateway's IP address.
2. Log in using your gateway credentials.
3. Run the following command:

ps -aux | grep codesys

• Success: You should see two processes running, similar to codesyscontrol.bin and codesysedge.bin. This confirms the runtime and its communication hub are active.

Method 2: Check in the Deployment Tool

1. Go back to the Deploy Control SL window you used in Step 3.
2. Click the Operation tab.
3. Success: You should see two services listed (e.g., codesysplchub and codesyscontrol) and their status should show as running.

Method 3: Connect from a CODESYS Project (Recommended)

This is the best test, as it confirms you can program the device.

1. In the main CODESYS Development System, create a new Standard Project.

2. In the project tree on the left, double-click on Device.
3. In the new window, click Scan Network.
4. Your gateway should appear in the list. Select it and click OK.

5. Now, to finalize the connection, go to the menu: Online -> Login.
6. A security prompt will appear. Click Yes to proceed.
7. Because this is the first login, an Add Device User window will pop up. You must create a new administrator user for the CODESYS runtime. This is separate from your gateway's sudo user.
8. Create a new username and password and click OK.

9. A login window will now appear. Enter the CODESYS management credentials you just created and click OK.
10. Success: The gateway will log in. You will see a green circle next to Device in your project tree, and the gateway status in the bottom-right corner will show "[Connected]".

You have successfully deployed the CODESYS Control runtime to your Robustel EG series gateway. The device is now a fully functional PLC, ready for your automation logic.

For more tutorials on CODESYS programming, please visit the official CODESYS help website: https://www.helpme-codesys.com/

Troubleshooting / FAQ