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 KB | May 16, 2017, 8:11 AM | |
| TMC-API_Release_v3.05.zip | 410 KB | Oct 16, 2018, 2:25 PM | |
| TMC-API_Release_v3.04.zip | 420 KB | Sep 13, 2018, 12:32 PM | |
| TMC-API_Release_v3.03.zip | 2.4 MB | Jul 10, 2018, 8:21 AM | |
| TMC-API_Release_v3.02.zip | 400 KB | Dec 12, 2017, 10:48 AM | |
| TMC-API_Release_v3.01.zip | 150 KB | Aug 7, 2017, 12:59 PM | |
| TMC-EvalSystem_Release_v3.05.zip | 1.2 MB | Oct 16, 2018, 2:25 PM | |
| TMC-EvalSystem_Release_v3.04.zip | 1.2 MB | Sep 13, 2018, 12:32 PM | |
| TMC-EvalSystem_Release_v3.03.zip | 3.7 MB | Jul 10, 2018, 8:21 AM | |
| TMC-EvalSystem_Release_v3.02.zip | 1.3 MB | Dec 12, 2017, 10:48 AM | |
| TMC-EvalSystem_Release_v3.01.zip | 1.2 MB | Aug 7, 2017, 12:59 PM |
Visit our GitHub for nightly snapshots.