SSZT442 July 2019 TMS320F28388D
Part 1 of this blog series gave an overview of the market opportunities for EtherCAT slave stack support on C2000™ microcontrollers (MCUs) and an introduction to a three-phased solution to jump-start slave stack development. Part 2 detailed what’s different and compelling about the TI C2000 MCU EtherCAT implementation. Part 3 broke down the three phases of development for your own slave-node application using the EtherCAT slave and C2000 Delfino MCU controlCARD kit, and how the TI EtherCAT package in C2000 controlSUITE™ software supports each phase. In part 4 of this series, I will step through the development of your own EtherCAT slave controller using the latest C2000 TMS320F28388D real-time controller.
The C2000 F28388D MCU has the EtherCAT peripheral from Beckhoff integrated onto the chip. The EtherCAT peripheral ownership can be allocated to CPU1 or CM. To support this, a set of software solutions have been released into C2000Ware, the software package for C2000 MCUs. These F28388D EtherCAT software solutions will help you:
To get started evaluating and experimenting with EtherCAT on F28388D, you’ll need to download and install:
For F28388D EtherCAT example code and more detailed usage documentation beyond what is described here, navigate within C2000Ware to ~\C2000Ware_X_XX_XX_XX\libraries\communications\Ethercat\f2838x.
The F28388D EtherCAT software solution includes a set of hardware abstraction layer (HAL) test applications (one for CPU1 and one for CM) that exercise the ASYNC16 processor data interface (PDI) between the EtherCAT subsystem and device central processing unit in order to perform a series of reads and writes to EtherCAT registers and memory. The software stack for this application is detailed in Figure 1. Additionally, these applications include checks to confirm that the device’s electrically erasable programmable read-only memory (EEPROM) is programmed with the required minimum set of data that EtherCAT needs.
You don’t need the EtherCAT slave stack to perform this validation. Once you’ve loaded this application onto the device, an EtherCAT master will be able to identify the EtherCAT slave controller on the network, which will confirm that the physical interfaces are working. From here, you can program the EEPROM for the EtherCAT slave and then rerun the application to perform the PDI checks described earlier.
The F28388D EtherCAT software solution includes both an EtherCAT slave demo as well as a reference solution. Both include a variant for running from CPU1 or from CM.
The EtherCAT slave demo application is a simple “echoback” example, where data sent from the EtherCAT master is received by the EtherCAT slave controller and sent back to the master. The demo application software stack is depicted in Figure 2. Using the TwinCAT PC software for the EtherCAT master node, you can set up a multinode EtherCAT network in minutes on your bench.
The demo application is provided as a binary image and is configured for the F28388D controlCARD. The EtherCAT slave stack is integrated into the image; therefore, you don’t need to generate the slave stack code yourself. All you need to do is program the F28388D controlCARD with the application and connect a CAT5 cable from the controlCARD to the EtherCAT master (in this case, TwinCAT PC/PLC).
After evaluating using the EtherCAT slave demo application, the F28388D EtherCAT software includes a reference solution for creating your own slave-node application.
The EtherCAT slave reference solution is setup to perform the same echoback functionality as the demo. This solution, however, includes all of the necessary source code (except for the EtherCAT slave stack itself) for debugging the solution and developing it into your own application. Figure 3 details the software stack for the solution. You can obtain the EtherCAT slave stack code through the EtherCAT Technology Group’s (ETG) slave stack code (SSC) ET9300 tool.
To generate slave stack code for F28388D devices, a configuration file is provided within the F28388D EtherCAT software solution package that, once imported into the SSC tool, will make the F28388D stack configurations available via the tool’s drop-down menu. Upon selection of a configuration, the tool will generate the slave stack source code for integrating into the solution. The F28388D EtherCAT software usage documentation within C2000Ware provides further details.
Once the slave stack is generated and linked into the F28388D EtherCAT slave reference solution, you’re ready to start running the solution and developing it into your own EtherCAT slave application.
Download C2000Ware today and jump-start your development of an EtherCAT slave controller with the C2000 F28388D MCU.
Additional resources: