CODESYS IDE Setup for uControl™ Series Controllers

  • Updated

Software Downloads

  • CODESYS Bundle (Download Here - v3.5 SP5 Patch 4)
    Includes the CODESYS installer and a gateway configuration file to live-debug a CODESYS project.
    NOTE: The uController firmware is tested and approved only for use with this version of Codesys, other versions may not work properly.
  • Application Service Tool (Download Here - v1.0.0)
    Utility software used for application downloads, firmware updates, and symbol files. 
    See Instructions on installing firmware or applications using the uControl Application Service Tool
  • EDIS Display Tool (Download Here - v4.0.4.17)Utility software used for application and firmware downloads with some additional hardware and revision information. Use Password 5ZIP-5UJ4-KD53-COTM 
  • CODESYS Device Descriptors
    • Download  - v1.1.0.17 (use with firmware 1.1.32 and 1.34)

  • Controller Firmware
  • ECOM CAN to USB interface device driver (Download Here - v3.5)

Click Here for Archived Versions

 

Software Description

The uControl series of controllers come from the factory with firmware ready to run Codesys applications. If needed the firmware in the controller can be updated using the Service Tool and an E-COM USB to CAN converter available from Enovation Controls. See Instructions.  There is a separate firmware file for each model of controller. Version 1.1.32 or newer must be used.

Additional files that are necessary in order to use the unit with CODESYS are as follows:

  • A CODESYS device descriptor XML file unique to the individual controller variant, e.g. MC4-26-20.devdesc.xml. This is required for setting up the controller in CODESYS and must be installed prior to attempting to program the unit using the IDE.
  • A PNG Icon image file for the controller that is displayed in the IDE e.g. MC4-26-20.png
  • A CODESYS gateway.cfg file for connecting to the controller via the RS232 serial port.

 

Communication Link Needed for Codesys

The Codesys IDE connects to the uController via a serial RS232 connection. The serial interface must be connected to controller pins as follows; J2A2 (RS232 TX ) connects to the dongle RS232 RX (pin 2), J2A8 (RS232 RX) connects to the dongle RS232 TX (pin 3) and J2A13 (RS232 GND) connects to the dongle RS232 ground(pin 5). Any RS232 adapter may be used. The RS232 port is shared with CAN Port 2.
WARNING: If CAN Port 2 is enabled in your application you will loose RS232 connectivity. The only way to reconnect with Codesys is to reflash the unit using the E-Com cable and either EDIS or the Application Service Tool linked in the previous section. 

Codesys Software Installation

Step Action
1 Install CODESYS
1.1

Install CODESYS V3.5 SP5 Patch 4(3.5.5.4) (CODESYS_3.5SP5_Release.zip) using all the default settings. Reboot your Computer when finished installing.

NOTE: The uController firmware is tested and approved only for use with this version of Codesys, other versions may not work properly.
2 Install the CODESYS gateway file for the mobile controller
2.1

Copy the included gateway.cfg file over the one that exists at C:\Program Files (x86)\3S CODESYS\GatewayPLC. This file configures the serial port and baud rate that will be used by CODESYS when connecting to the mobile controller. 
2.2

Edit The Gateway.cfg File - You must edit the name of the RS232 serial device to match the name of the device you are using, See further instructions below. If your browser does not show file extensions be careful not to name the file Gateway.cfg.cfg.

3

Restart gateway 

3.1

In order for the gateway changes to take effect, you must stop and restart the CODESYS gateway.  This can be done by right-clicking on the gateway icon in your system tray bar next to the clock.

mceclip0.png

4

Install the target definition files for the mobile controller variants

4.1

Launch CODESYS and select Tools->Device Repository.

4.2

Click the "Install..." button.

4.3

Highlight all of the attached ".devdesc.xml" files and select open.

4.4

Click Close.

5

Create your first project

5.1

Click File->New Project.

5.2

Select "Standard Project". Click "OK".

5.3

Select the appropriate Mobile Controller device and I/O count for the controller you will be using for your project. Click OK.

6

Connect and program your controller

6.1

Connect the mobile controller to your serial port via the 20 – pin Deutsch connector A.  

6.2

Ensure that the unit is powered-up properly by verifying that LED A is illuminated.

6.3

In the CODESYS "Devices" tree view, double click on the "Device".

6.4

Click on the "Communication Settings" tab. If tabs are not active verify "Simulation" is not selected in the "Online" menu.

6.5

Click on the "Gateway-1" and then click "Scan Network".

6.6

One mobile controller device should appear. Click on it and select "Set active Path". If you have problems with this step, please see the troubleshooting steps in Appendix A of the developers manual. The firmware may need to be updated if a connection is not found using the Service Tool and latest firmware found under software downloads.

6.7

Select "Online->Login" and then acknowledge any prompts that are displayed.

6.8

Click "Debug->Start".

 

Editing the Gateway Configuration File

The name of the RS232 Serial Port Device must be edited in the gateway.cfg file to match the name of your specific device as found in your computers device manager.

The gateway.cfg file included with codesys must be replaced with the file included in the bundle in the software downloads section. The file to be replaced is found in C:\Program Files (x86)\3S Codesys\GatewayPLC , the new file can then be edited with the correct RS232 device name using Notepad.

Multiple Codesys Installations - If there is more than one version of Codesys installed then you will need to update the gateway.cfg file in those sub-folders as well. These will be located in c:\program Files.

mceclip0.png

Software Archive

  • October 27, 2020 - CODESYS System Tools Bundle (v1.1.9)
    • CODESYS Bundle v3.5 SP5 Patch 4
    • EDIS display Tool v4.0.4.6
    • CODESYS Device Descriptor (MC4-26-20 only) v1.1.0.16
    • Device Firmware (MC4-26-20 only) v1.1.9
    • ECOM Driver v3.5

Note: All product names, pictures, companies or other brands used on our pages are the property of the respective rights owners.  CODESYS™ is the property of the 3S – Smart Software Solutions GmbH, Germany

Return to top

Related articles