TAP on Trinamic's Technology!

Trinamic products offer easy access to comprehensive motion and motor control features. To close the gap between digital and physical layers, engineers need to create custom hardware and software.

Technology Access Package

 

To start development, several supporting data is needed. A PCB design requires schematic symbols and footprints for the layout in the CAE tool format. Software development needs libraries and code examples in a common programming language, or as a project file for the used IDE.

The Trinamic Technology Access Package (TTAP) is a comprehensive collection of technical support information and tools for Trinamic’s chip and module solutions. The intention of TTAP is to simplify (physical) design-in and bring-up, and to speed-up firmware development.

For each of the Trinamic products, you can find the specific data such as CAE files, code examples, TMCL™ scripts, and data sheets. These documents are offered on the product pages themselves.

Description of Content

 

The TTAP is split into two sections - hardware and software. The hardware part is specific for each product and can be found on the detail pages at the product section. The software package is identical to all products and is described below.

Hardware

The hardware section includes detailed descriptions of the evaluation boards and reference designs. Both are typically available as design files for the EAGLE PCB CAD tool. An overview of materials and minimum circuits is provided. To help with the integration of Trinamic chips into own board designs, each chip product comes with free libraries for the following PCB CAD tools: Altium Designer™, Mentor PADS™, Pulsonix™, and CadSoft EAGLE™.

Software

Software is provided in terms of complete Eclipse™ projects for Trinamic’s evaluation board system as well as code snippets to support own firmware development and integration of Trinamic chip components. The software is written in C.

TMC-API Structure

 

The API is designed for C applications and can be used for different CPU types. For example, the API is used for Trinamic’s modular evaluation system boards called Landungsbrücke (Freescale MK20 cortex M4 processor) and Startrampe (STM-F205 cortex M3 processor).

Folder description:

 

  • tmc/helpers contains general definitions for data types and bit handling, regardless of the processor used.

  • tmc/ic contains a folder for each Trinamic chip, e.g. tmc/ic/TMC4670. Each of these folders contains a header file with the chip’s register address list (e.g. TMC4670_Register.h). Another .h and .c file (e.g. TMC4670.h/.c) provide low-level, mid-level, and high-level functions for the specific chip. Low-level functions are necessary for SPI read and write access. Mid-level functions like setTargetVelocity(. . . ) or getActualPosition() demonstrate the typical register access for different application scenarios, e.g. for velocity or position mode. For some chips, there are also functions available for encoder initialization and real-world current scaling.

Evaluation Board Project Structure

 

The evaluation board project demonstrates the usage of the TMC-API and can be used as a starting point for your own firmware development. It should be an example for you to simplify and speed-up firmware development based on hardware with TRINAMIC motion control IC’s.

Requirements and Installation

 

These are the software packages you need in order to use the TMC-API in your project:

  • Eclipse: An open-source integrated development environment (IDE)
  • GNU ARM Embedded Toolchain: Pre-built GNU toolchain for ARM Cortex-M processors
  • TMCL-IDE: The visual software to control and update Trinamic modules and evaluation boards

Downloads

File
Type
Size
Date
AN038_Using_TRINAMICs_IC_Software_API_and_Examples.pdf 540 KBMay 16, 2017, 8:11 AM
TMC-API_Release_v3.05.zip 410 KBOct 16, 2018, 2:25 PM
TMC-API_Release_v3.04.zip 420 KBSep 13, 2018, 12:32 PM
TMC-API_Release_v3.03.zip 2.4 MBJul 10, 2018, 8:21 AM
TMC-API_Release_v3.02.zip 400 KBDec 12, 2017, 10:48 AM
TMC-API_Release_v3.01.zip 150 KBAug 7, 2017, 12:59 PM
TMC-EvalSystem_Release_v3.05.zip 1.2 MBOct 16, 2018, 2:25 PM
TMC-EvalSystem_Release_v3.04.zip 1.2 MBSep 13, 2018, 12:32 PM
TMC-EvalSystem_Release_v3.03.zip 3.7 MBJul 10, 2018, 8:21 AM
TMC-EvalSystem_Release_v3.02.zip 1.3 MBDec 12, 2017, 10:48 AM
TMC-EvalSystem_Release_v3.01.zip 1.2 MBAug 7, 2017, 12:59 PM

 

Visit our GitHub for nightly snapshots.