Background

• Supported TMC boards: TMCM-1461-CoE
• Supported communication interface and interface driver: CANopen-over-etherCAT (SOEM)
• Supported ROS and OS distro: Humble (Ubuntu 22.04)
• Supported platform: Intel x86 64-bit (amd64)
• Supported setup: Single/Multiple TMC in Single ECAT interface (namespace-managed)

:memo: Note: Although officially supported TMC boards are only the abovementioned, all market-ready TMCs with YAMLs in this repository are also expected to work and can be tried and tested by the users. Contact the Developers for any issues encountered.

Hardware

For the tested TMCM-1461-CoE setup, the following are used:

• 1 x TMCM-1461-CoE
• 1 x External 24V power supply
• 1 x USB to LAN ethernet adapter

Also the following:

• 1 x 4pin female M8-RJ45 etherCAT cable
• 1 x 4 pin male M8 power supply cable

The image below shows the connection diagram of the setup (with labels):

The image below shows the actual setup used (for reference):

Software

Software Architecture

Software Dependencies

Assumptions before building this package:

• Installed ROS Humble. If not, follow these steps.
• Setup workspace (with workspace folder named as “ros2_ws”). If not, follow these steps.

Clone

In the website:

1. Make sure that the branch dropdown is set to “humble”.
2. Click the “Clone” or “Code” button, then copy the SSH or HTTPS link (eg, “*.git”).

In a terminal, do the following:

$ cd ~/ros2_ws/src
$ git clone <copied SSH o HTTPS link here> adi_tmc_coe #clones repo to "adi_tmc_coe" directory name

Build

Do proper exports first:

# $ source /opt/ros/<ROS version>/setup.bash
$ source /opt/ros/humble/setup.bash

Where:

• “ROS version” is the user’s actual ROS version

Then, install all required dependencies (See SoftwareDependencies) using rosdep:

$ cd ~/ros2_ws
$ rosdep init
$ rosdep update
$ rosdep install --from-paths src -y --ignore-src

Then:

$ cd ~/ros2_ws
$ colcon build
## To clean first before building, you may run the following instead:
## $ colcon build --cmake-clean-first

:memo: Note: It is recommended that 1 terminal is dedicated to building the package/workspace to avoid complex issues as mentioned in ROS2 Source the overlay

Pre-Launch (One-time per setup)

Not all Trinamic modules are on TMCL_IDE specially CoE due to different interface used. Check module first for other communication protocol than CoE (UART, USB or CAN). Proceed to next steps if module is available in TMCL_IDE.

:memo: Note: Different communication protocol might need different cable to communicate with TMCL_IDE (e.g. UART - USB to TTL adapter, USB - TypeC/TypeB/Micro, CAN - PCAN-USB adapter).

If it’s the first time to use the set of motors for the TMC, it is required to calibrate and tune the PID settings of the motors first.

Do the calibrations/tuning by downloading and using TMCL-IDE.

BLDC Motors

Calibrate the motors

For a run-through/tutorial of how the calibration is done in the TMCL-IDE via its Wizard Pool feature, check this link.

Tune the PI settings of the motors

For a run-through/tutorial of how the PI tuning is done in the TMCL-IDE via its PI Tuning feature, check this link.

:memo: Note: For all the calibration and tuning done, store all the parameters set from TMCL_IDE on the board’s EEPROM. Do this by doing any of the following:

File truncated at 100 lines see the full file

Changelog for package adi_tmc_coe_core

1.0.0 (2025-03-06)

• Adding 1.0.0 of adi_tmc_coe, ROS2 Humble
• Contributors: Jamila Macagba