CODESYS Tools for uControl™ Series Controllers

  • Updated

Download Tools

  • 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.
  • Service Tool (Download Here - v4.0.4.17)
    Installer that assists field support personnel with troubleshooting, application download, and firmware update. e.g. EDIS display tool.

  • CODESYS Device Descriptors (Download Here - v1.1.0.17)

  • Controller Firmware (Download Here - v1.1.32)

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

Click Here for Archived Versions

Software Description

The controller includes firmware installed from the factory. The mobile controller firmware consists of a model specific .MOT file (Motorola format). Note: There are 4 variants (4 unique .MOT files) and a single file is used that is specific to the controller variant.

The firmware can be updated (installed in the controller) using an ECOM USB to CAN dongle available from Enovation Controls. It is used in conjunction with the earlier mentioned firmware loading tool called EDIS. The password to reprogram a controller is:

5ZIP-5UJ4-KD53-COTM

Here is a screen shot of the program:

mceclip0.png

Please note that after selecting Reprogram Target, you will need to provide the tool the directory path to the location of the specific .MOT file for your controller variant and then start the download.

Additional files are necessary in order to use the unit with CODESYS. These include:

  • 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 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 serial port. The serial interface must be connected to the correct controller pins. J2A2 (RS232 TX) connects to the dongle RS232 RX, J2A8 (RS232 RX) connects to the dongle RS232 TX and J2A13 (RS232 GND) connects to the dongle RS232 ground. The interface dongles are available for between $10.00 & $20.00 at merchants such as Amazon.

    Please note that the highlighted text in the file as indicated below must be modified to reflect the actual name of your com port e.g. a USB to RS232 interface dongle. 
    [ComponentManager]
    ;--> Additional components for CmpBlkDrvCanClient
    Component.1=CmpBlkDrvCom
    ;<-- Additional components for CmpBlkDrvCanClient

    [CmpRouter]
    NumRouters=2
    EnableParallelRouting=1
    EnableLoopDetection=1
    0.MainNet=ether x
    0.NumSubNets=1
    0.SubNet.0.Interface=VCOM
    1.MainNet=BlkDrvTcp

    [CmpGwCommDrvTcp]
    ListenPort=1217

    [CmpBlkDrvCom]
    ;Example for a configuration of this block driver:
    ;Mainnet-Mainnet-Communication on serial line.
    Com.0.Port=300
    Com.0.Name=VCOM
    ;Com.0.Baudrate=1250000
    Com.0.Baudrate=230400

    [SysCom]
    Windows.PortToCheck.0=300
    Windows.CheckWithPortName.0=Prolific USB-to-Serial Comm Port
    ;Windows.PortToCheck.1=300
    ;Windows.CheckWithPortName.1=Silicon Labs Dual CP210x USB to UART Bridge: Enhanced COM Port

The name of your com port USB to RS232 dongle can be found in the Windows Device Manager. It is located here:

mceclip0.png

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 attached 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. Please note that this file will most likely need to be modified to include a reference to the specific serial port you are using on your computer.

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. Note detailed connection: The serial interface must be connected to the correct controller pins. J2A2 (RS232 TX) connects to the dongle RS232 RX, J2A8 (RS232 RX) connects to the dongle RS232 TX and J2A13 (RS232 GND) connects to the dongle RS232 ground

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.

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 at the top of this page.

6.7

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

6.8

Click "Debug->Start".

 

Software Archive

  • October 27, 2020 - CODESYS System Tools Bundle (v1.1.9)
    • CODESYS Bundle v3.5 SP5 Patch 4
    • Service 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