Setting up the Gateway.cfg File

The Codesys IDE communicates to the hardware through the Gateway server as defined in the gateway.cfg file. This file must be modified to match the type of hardware you are connecting to. At present the Gateway file only needs to be modified for the uControl line of controllers, the OpenView displays connect through USB with no modifications needed to the Gateway file. You can find the .cfg file template needed under the software downloads section for each product. uControl Software Downloads

Step 1 - Locate Gateway.cfg File

The location of the gateway.cfg file will vary depending on which versions of Codesys you have installed. It is important to modify the correct ones.

• Gateway.cfg file location - Single version installed

• Gateway.cfg file location - Multiple versions installed

Step 2 - Update the Gateway.cfg File

This is only needed if using the uControl hardware

• Perform this step for each version of Codesys that will be used.
• Delete or rename the Gateway.cfg file from the folder.
• Copy the Gateway.cfg file provided in the software downloads section for uControl into the folder.
• Plug in your RS232 adapter and launch the Windows device Manager to obtain the name of the adapter.

• Edit he gateway.cfg file and change the name of the adapter to match the name in the device manager then save the file.

Step 3- Select Which Gateway File Will be Used by the Gateway Server

At run time, Codesys may use the .cfg file from any of the installed versions of Codesys. Use the process below to force Codesys to use a specific Gateway file which will be located in that versions installation folder.

• Launch the Codesys Installer app from the Start Menu

• Select the three dots for the version you wish to use
• Select the "Set Gateway Service" option, a admin login is required.
• From the system tray stop then restart the Gateway Server

Running uControl and OpenView Displays Simultaneously

The connection to the OpenView display is a direct connection through the USB port so no special directives are needed in the Gateway configuration file to make this connection. This allows you to connect to a MCx controller as well as a OpenView display at the same time if ever needed during code development.