Beckhoff SSC

Beckhoff SSC Library Creation

To create the licensed version of the Beckhoff Slave Stack Code (SSC) library for AM263Px, follow the instructions at Steps to patch and rebuild Beckhoff SSC library for ethercat_subdevice_demo examples.

Prerequisites

To create licensed Beckhoff SSC library, the following tools are required on your development host.

1. Dos2Unix/Unix2Dos utility : Download Dos2Unix/Unix2Dos text file format converters from gnuwin32 sourceforge.
   

   ‍⚠️ This is not a TI tool. See licensing information page for more details.

2. Patch utility : Download patch utility from gnuwin32 sourceforge.
   

   ‍⚠️ This is not a TI tool. See licensing information page for more details.

‍💡 On Windows, patch.exe and unix2dos.exe utility can be found in their respective bin folders.

Steps to patch and rebuild Beckhoff SSC library for ethercat_subdevice_demo examples

1. Obtain Slave Sample Code (SSC) from ETG/Beckhoff (Vendor ID and ETG membership required, free of charge in that case). Current version support: 5i13.
2. Unzip the SSC_V5i13.zip package.
3. Copy SlaveFiles.zip from that package to your development host.
4. Navigate to patch folder, ind_comms_sdk_am263px_2025_00_XX/source/industrial_comms/ethercat_subdevice/stack/patch/.
5. Unzip SlaveFiles.zip to SlaveFiles subfolder.
6. Use Code Composer contained gmake to build full version library.
   

   ‍~/ti/ccs2030/ccs/utils/bin/gmake -s -f makefile.custom-ssc ssc

7. The licensed version of Beckhoff SSC library is generated and copied into ind_comms_sdk_am263px_2025_00_XX/source/industrial_comms/ethercat_subdevice/stack/lib/ folder.

Build EtherCAT SubDevice Demo Example with Beckhoff SSC Library

Prerequisites

Tools required to build the EtherCAT SubDevice project:

• Code Composer Studio 20.3.0
• TI CLang 4.0.3.LTS
• Industrial Communications SDK for the AM263Px (ind_comms_sdk_am263px_2025_00_XX)
• SysConfig 1.25.0

Build Steps

Import the EtherCAT SubDevice demo example project from ind_comms_sdk_am263px_2025_00_XX into the CCS and rebuild.

Changes on Bechoff SSC definitions

The Beckhoff SSC library is parametrized via macro definitions. These predefined macros are available in the ind_comms_sdk_am263px_2025_00_XX/source/industrial_comms/ethercat_subdevice/stack/patch/SlaveFiles/src/ecat_def.h file. If your application requires a different configuration then you can modify the defines accordingly, and rebuild the Beckhoff SSC library.
For example,

1. The default MAX_MBX_SIZE is set to 0x0400 but your application demands this macro to set to 0x800.
2. Rebuild the Beckhoff SSC library.
   

   ‍~/ti/ccs2030/ccs/utils/bin/gmake -s -f makefile.custom-ssc rebuild-ssc

   
   

Note

Steps to patch and rebuild Beckhoff SSC library are also available in the readme.md file available at ind_comms_sdk_am263px_2025_00_XX/source/industrial_comms/ethercat_subdevice/stack/patch/SlaveFiles/src/.