TMCM-1638-TMCL Firmware Manual fw1.09 Rev1.01

Module for Stepper MODULE
TMCM-1638 TMCL™ Firmware Manual

Firmware Version V1.09 | Document Revision V1.01 • 2021-FEB-05
The TMCM-1638 is a single axis field oriented motor controller/driver module for single phase DC
motors, two phase stepper motors and three phase BLDC motors. The TMCM-1638 TMCL firmware
allows to control the module using TMCL™ commands, supporting standalone operation as well as
direct mode control, making use of the Trinamic TMC4671 field oriented motor controller.
Features
• Single axis field oriented motor con-
trol
• Supply voltage 48V DC
• TMCL™
• Host interfaces: RS485, CAN
• Step/Direction inputs
• Additional inputs and outputs
• ABN encoder interface
• Hall sensor interface
Applications
• Laboratory Automation • Robotics • Life Science

• Manufacturing • Factory Automation • Biotechnology
• Semiconductor Handling • Test & Measurement • Liquid Handling
Simplified Block Diagram
©2021 TRINAMIC Motion Control GmbH & Co. KG, Hamburg, Germany
Terms of delivery and rights to technical change reserved.
Download newest version at: www.trinamic.com
Read entire documentation.

TMCM-1638 TMCL™ Firmware Manual • Firmware Version V1.09 | Document Revision V1.01 • 2021-FEB-05 2 / 111
Contents
1 Features 5
2 First Steps with TMCL 6

2.1 Basic Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2 Using the TMCL Direct Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.3 Testing with a simple TMCL Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 TMCL and the TMCL-IDE — An Introduction 8

3.1 Binary Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.1.1 Checksum Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Reply Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.2.1 Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.3 Standalone Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.4 TMCL Command Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.5 TMCL Commands by Subject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.5.1 Motion Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.5.2 Parameter Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.5.3 Branch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.5.4 I/O Port Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.5.5 Calculation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.5.6 Interrupt Processing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.5.7 New TMCL Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.6 Detailed TMCL Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.6.1 ROR (Rotate Right) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.6.2 ROL (Rotate Left) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.6.3 MST (Motor Stop) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.6.4 MVP (Move to Position) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.6.5 SAP (Set Axis Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.6.6 GAP (Get Axis Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.6.7 STAP (Store Axis Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.6.8 RSAP (Restore Axis Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.6.9 SGP (Set Global Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.6.10 GGP (Get Global Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.6.11 STGP (Store Global Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.6.12 RSGP (Restore Global Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.6.13 SIO (Set Output) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.6.14 GIO (Get Input) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.6.15 CALC (Calculate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.6.16 COMP (Compare) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.6.17 JC (Jump conditional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.6.18 JA (Jump always) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.6.19 CSUB (Call Subroutine) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.6.20 RSUB (Return from Subroutine) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.6.21 WAIT (Wait for an Event to occur) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.6.22 STOP (Stop TMCL Program Execution – End of TMCL Program) . . . . . . . . . . . . . 47
3.6.23 CALCX (Calculate using the X Register) . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.6.24 AAP (Accu to Axis Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.6.25 AGP (Accu to Global Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.6.26 CLE (Clear Error Flags) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.6.27 EI (Enable Interrupt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.6.28 DI (Disable Interrupt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
3.6.29 VECT (Define Interrupt Vector) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Download newest version at www.trinamic.com
3.6.30 RETI (Return from Interrupt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

3.6.31 CALCVV (Calculate using two User Variables) . . . . . . . . . . . . . . . . . . . . . . . . 59
3.6.32 CALCVA (Calculate using a User Variable and the Accumulator Register) . . . . . . . 61
3.6.33 CALCAV (Calculate using the Accumulator Register and a User Variable) . . . . . . . 63
3.6.34 CALCVX (Calculate using a User Variable and the X Register) . . . . . . . . . . . . . . 65
3.6.35 CALCXV (Calculate using the X Register and a User Variable) . . . . . . . . . . . . . . 67
3.6.36 CALCV (Calculate using a User Variable and a Direct Value) . . . . . . . . . . . . . . . 69
3.6.37 RST (Restart) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
3.6.38 DJNZ (Decrement and Jump if not Zero) . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3.6.39 CALL (Conditional Subroutine Call) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
3.6.40 MVPA (Move to Position specified by Accumulator Register) . . . . . . . . . . . . . . . 75
3.6.41 ROLA (Rotate Left using the Accumulator Register) . . . . . . . . . . . . . . . . . . . . 77
3.6.42 RORA (Rotate Right using the Accumulator Register) . . . . . . . . . . . . . . . . . . . 78
3.6.43 SIV (Set Indexed Variable) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3.6.44 GIV (Get Indexed Variable) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
3.6.45 AIV (Accumulator to Indexed Variable) . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.6.46 Customer specific Command Extensions (UF0. . . UF7 – User Functions) . . . . . . . . 82
3.6.47 TMCL Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
4 Axis Parameters 85
5 Global Parameters 92
5.1 Bank 0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
5.2 Bank 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
5.3 Bank 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6 Motor Regulation 97
6.1 Structure of Cascaded Motor Regulation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.2 Current Regulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.2.1 Timing Control Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
6.2.2 Structure of the Current Regulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
6.3 Velocity Regulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
6.3.2 Structure of the Velocity Regulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.4 Velocity Ramp Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.5 Position Regulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.5.2 Structure of the Position Regulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
6.5.3 Correlation of Axis Parameters 10 and 7, the Target Position and the Position End
Flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
7 TMCL Programming Techniques and Structure 103

7.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
7.2 Main Loop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
7.3 Using Symbolic Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
7.4 Using Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
7.5 Using Subroutines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
7.6 Combining Direct Mode and Standalone Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
7.7 Make the TMCL Program start automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
8 Figures Index 107
9 Tables Index 108
10 Supplemental Directives 109
10.1 Producer Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

10.2 Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.3 Trademark Designations and Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.4 Target User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.5 Disclaimer: Life Support Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.6 Disclaimer: Intended Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.7 Collateral Documents & Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
11 Revision History 111

11.1 Firmware Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
11.2 Document Revision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
1 Features
The TMCM-1638 is a single axis field oriented controller/driver module for single phase DC motors, two
phase bipolar stepper motors and three phase BLDC motors with state of the art feature set. It is highly
integrated, offers a convenient handling and can be used in many applications that use a base board.
The module is equipped with a plug that can be plugged into a mating slot. As a mating slot, 98 pin PCIe
sockets can be used. Either Trinamic base boards can be used, or base boards can be designed by the
user. The module can drive stepper motors with up to 7A RMS coil current. The supply voltage can be
up to 48V. With its high energy efficiency using field oriented control cost for power consumption is kept
down. The TMCL firmware allows for standalone operation and direct mode control.
Main characteristics
• Motion controller & stepper motor driver:
– Ramp generation in real time (trapezoid ramp profile).
– On the fly alteration of motion parameters (e.g. position, velocity, acceleration).
– High performance microcontroller for overall system control and communication protocol han-
dling.
– High-efficient operation, low power dissipation.
– Field oriented control.
– Integrated protection.
– Open loop, hall sensor or encoder commutation.
• Encoder
– Standard ABN encoder interface.
– Usable for encoder based commutation and position control.
• Interfaces
– RS485 bus.
– CAN bus.
– Single ended ABN encoder input.
– Hall sensor inputs.
– Step/Direction inputs.
– Two general-purpose digital inputs.
– One dedicated analog input.
– Two stop switch inputs.
– One home switch input.
– One general purpose digital output.
Software
TMCL remote controlled operation via RS485 or CAN interface and/or stand-alone operation via TMCL
programming. PC-based application development software TMCL-IDE available for free.
Electrical data
• Supply voltage: +24V or +48V DC nominal (10. . . 52V DC supply range).
• Motor current: up to 7A RMS / 10A peak (programmable).
Please see also the separate Hardware Manual.
2 First Steps with TMCL

In this chapter you can find some hints for your first steps with the TMCM-1638 and TMCL. You may skip
this chapter if you are already familiar with TMCL and the TMCL-IDE.
Things that you will need

• Your TMCM-1638 module.
• A suitable base board (either Trinamic base board or self designed).
• An RS485 interface or a CAN interface for your PC.
• A power supply (24V DC) for your TMCM-1638 module.
• The TMCL-IDE 3.x already installed on your PC.
• A two-phase bipolar stepper motor.
2.1 Basic Setup

First of all, you will need a PC with Windows (at least Windows 7) and the TMCL-IDE 3.x installed on it. If
you do not have the TMCL-IDE installed on your PC then please download it from the TMCL-IDE product
page of Trinamic’s website (http://www.trinamic.com) and install it on your PC.
Please also ensure that your TMCM-1638 is properly connected to your power supply and that the stepper
motor is properly connected to the module. Please see the TMCM-1638 hardware manual for instructions
on how to do this. Do not connect or disconnect a stepper motor to or from the module while the
module is powered!
Then, please start up the TMCL-IDE. After that you can switch on the power supply for your module and
connect your TMCM-1638 via RS485 or CAN. The module will be recognized by the TMCL-IDE, so that it
can be controlled using the IDE then.
2.2 Using the TMCL Direct Mode

At first try to use some TMCL commands in direct mode. In the TMCL-IDE a tree view showing the TMCM-
1638 and all tools available for it is displayed. Click on the Direct Mode entry of the tool tree. Now, the
Direct Mode tool will pop up.
In the Direct Mode tool you can choose a TMCL command, enter the necessary parameters and execute
the command. For example, choose the command ROL (rotate left). Then choose the appropriate motor
(motor 0 if your motor is connected to the motor 0 connector). Now, enter the desired speed. Try entering
500 rpm as the value and then click the Execute button. The motor will now run. Choose the MST (motor
stop) command and click Execute again to stop the motor.
Next you can try changing some settings (also called axis parameters) using the SAP command in direct
mode. Choose the SAP command. Then choose the parameter type and the motor number. Last, enter
the desired value and click execute to execute the command which then changes the desired parameter.
Please see chapter 4 for a complete list of all axis parameters.
2.3 Testing with a simple TMCL Program

Now, test the TMCL stand alone mode with a simple TMCL program. To type in, assemble and download
the program, you will need the TMCL creator. This is also a tool that can be found in the tool tree of
the TMCL-IDE. Click the TMCL creator entry to open the TMCL creator. In the TMCL creator, type in the
following little TMCL program:
1 SAP 5 , 0 , 33911 // set ADC offsets

SAP 6 , 0 , 32514
3
SAP 53 , 0, 1000 // set position reached distance

5 SAP 54 , 0, 500 // set position reached velocity [ rpm ]
SAP 74 , 0, 500 // set position P
7 SAP 44 , 0, 10000 // set acceleration [ rpm / s ]
9 SAP 15 , 0 , 2 // switch to encoder mode
11 ROR 0 , 200 // rotate motor

WAIT TICKS , 0 , 300
13
// clear position counter on next encoder -N - Channel event

15 SAP 67 , 0 , 1 // set clear on null
SAP 68 , 0 , 1 // set clear once
17 WAIT TICKS , 0 , 300
19 PositionTest :
MVP ABS , 0 , 0
21 WAIT POS , 0 , 0
MVP ABS , 0 , 655360
23 WAIT POS , 0 , 0
JA PositionTest
After you have done that, take the following steps:
1. Click the Assemble icon (or choose Assemble from the TMCL menu) in the TMCL creator to assemble
the program.
2. Click the Download icon (or choose Download from the TMCL menu) in the TMCL creator to don-
wload the program to the module.
3. Click the Run icon (or choose Run from the TMCL menu) in the TMCL creator to run the program on
the module.
Also try out the debugging functions in the TMCL creator:
1. Click on the Bug icon to start the debugger.
2. Click the Animate button to see the single steps of the program.
3. You can at any time pause the program, set or reset breakpoints and resume program execution.
4. To end the debug mode click the Bug icon again.
3 TMCL and the TMCL-IDE — An Introduction

As with most TRINAMIC modules the software running on the microprocessor of the TMCM-1638 consists
of two parts, a boot loader and the firmware itself. Whereas the boot loader is installed during produc-
tion and testing at TRINAMIC and remains untouched throughout the whole lifetime, the firmware can
be updated by the user. New versions can be downloaded free of charge from the TRINAMIC website
(http://www.trinamic.com).
The TMCM-1638 supports TMCL direct mode (binary commands). It also implements standalone TMCL
program execution. This makes it possible to write TMCL programs using the TMCL-IDE and store them
in the memory of the module.
In direct mode the TMCL communication over RS-232, RS-485, CAN, and USB follows a strict master/slave
relationship. That is, a host computer (e.g. PC/PLC) acting as the interface bus master will send a com-
mand to the TMCM-1638. The TMCL interpreter on the module will then interpret this command, do the
initialization of the motion controller, read inputs and write outputs or whatever is necessary according
to the specified command. As soon as this step has been done, the module will send a reply back over
the interface to the bus master. Only then should the master transfer the next command.
Normally, the module will just switch to transmission and occupy the bus for a reply, otherwise it will stay
in receive mode. It will not send any data over the interface without receiving a command first. This way,
any collision on the bus will be avoided when there are more than two nodes connected to a single bus.
The Trinamic Motion Control Language [TMCL] provides a set of structured motion control commands.
Every motion control command can be given by a host computer or can be stored in an EEPROM on the
TMCM module to form programs that run standalone on the module. For this purpose there are not only
motion control commands but also commands to control the program structure (like conditional jumps,
compare and calculating).
Every command has a binary representation and a mnemonic. The binary format is used to send com-
mands from the host to a module in direct mode, whereas the mnemonic format is used for easy usage
of the commands when developing standalone TMCL applications using the TMCL-IDE (IDE means Inte-
grated Development Environment).
There is also a set of configuration variables for the axis and for global parameters which allow individual
configuration of nearly every function of a module. This manual gives a detailed description of all TMCL
commands and their usage.
3.1 Binary Command Format

Every command has a mnemonic and a binary representation. When commands are sent from a host
to a module, the binary format has to be used. Every command consists of a one-byte command field, a
one-byte type field, a one-byte motor/bank field and a four-byte value field. So the binary representation
of a command always has seven bytes. When a command is to be sent via RS-232, RS-485, RS-422 or USB
interface, it has to be enclosed by an address byte at the beginning and a checksum byte at the end. In
these cases it consists of nine bytes.
The binary command format with RS-232, RS-485, RS-422 and USB is as follows:
TMCL Command Format

Bytes Meaning
1 Module address
1 Command number
1 Type number
1 Motor or Bank number
4 Value (MSB first!)
1 Checksum
Table 1: TMCL Command Format
Info The checksum is calculated by accumulating all the other bytes using an 8-bit
addition.
Note When using the CAN interface, leave out the address byte and the checksum
byte. With CAN, the CAN-ID is used as the module address and the checksum is
not needed because CAN bus uses hardware CRC checking.
3.1.1 Checksum Calculation
As mentioned above, the checksum is calculated by adding up all bytes (including the module address
byte) using 8-bit addition. Here are two examples which show how to do this:
Checksum calculation in C:
unsigned char i , Checksum ;
2 unsigned char Command [9];
4 // Set the Command array to the desired command

Checksum = Command [0];
6 for ( i =1; i <8; i ++)
Checksum += Command [ i ];
8
Command [8]= Checksum ; // insert checksum as last byte of the command

10 // Now , send it to the module
Checksum calculation in Delphi:

var
2 i , Checksum : byte ;
Command : array [0..8] of byte ;
4
// Set the Command array to the desired command

6
// Calculate the Checksum :

8 Checksum := Command [0];
for i :=1 to 7 do Checksum := Checksum + Command [ i ];
10 Command [8]:= Checksum ;
// Now , send the Command array (9 bytes ) to the module
3.2 Reply Format

Every time a command has been sent to a module, the module sends a reply. The reply format with RS-
232, RS-485, RS-422 and USB is as follows:
TMCL Reply Format

Bytes Meaning
1 Reply address
1 Module address
1 Status (e.g. 100 means no error)
1 Command number
4 Value (MSB first!)
1 Checksum
Table 2: TMCL Reply Format
Info The checksum is also calculated by adding up all the other bytes using an 8-bit
addition. Do not send the next command before having received the reply!
Note When using CAN interface, the reply does not contain an address byte and a
checksum byte. With CAN, the CAN-ID is used as the reply address and the check-
sum is not needed because the CAN bus uses hardware CRC checking.
3.2.1 Status Codes
The reply contains a status code. The status code can have one of the following values:
TMCL Status Codes

Code Meaning
100 Successfully executed, no error
101 Command loaded into TMCL program EEPROM
1 Wrong checksum
2 Invalid command
3 Wrong type
4 Invalid value
5 Configuration EEPROM locked
6 Command not available
Table 3: TMCL Status Codes
3.3 Standalone Applications

The module is equipped with a TMCL memory for storing TMCL applications. You can use the TMCL-
IDE for developing standalone TMCL applications. You can download a program into the EEPROM and
afterwards it will run on the module. The TMCL-IDE contains an editor and the TMCL assembler where
the commands can be entered using their mnemonic format. They will be assembled automatically into
their binary representations. Afterwards this code can be downloaded into the module to be executed
there.
3.4 TMCL Command Overview

This section gives a short overview of all TMCL commands.
Overview of all TMCL Commands

Command Number Parameter Description
ROR 1 <motor number>, <velocity> Rotate right with specified velocity
ROL 2 <motor number>, <velocity> Rotate left with specified velocity
MST 3 <motor number> Stop motor movement
MVP 4 ABS|REL, <motor number>, <posi- Move to position (absolute or rela-
tion|offset> tive)
SAP 5 <parameter>, <motor number>, Set axis parameter (motion control
<value> specific settings)
GAP 6 <parameter>, <motor number> Get axis parameter (read out motion
control specific settings)
STAP 7 <parameter>, <motor number>, Store axis parameter (store motion
<value> control specific settings)
RSAP 8 <parameter>, <motor number> Restore axis parameter (restore mo-
tion control specific settings)
SGP 9 <parameter>, <bank number>, Set global parameter (module spe-
<value> cific settings e.g. communication set-
tings or TMCL user variables)
GGP 10 <parameter>, <bank number> Get global parameter (read out mod-
ule specific settings e.g. communica-
tion settings or TMCL user variables)
STGP 11 <parameter>, <bank number> Store global parameter (TMCL user
variables only)
RSGP 12 <parameter>, <bank number> Restore global parameter (TMCL user
variables only)
SIO 14 <port number>, <bank number>, Set digital output to specified value
<value>
GIO 15 <port number>, <bank number> Get value of analog/digital input
CALC 19 <operation>, <value> Aithmetical operation between accu-
mulator and direct value
COMP 20 <value> Compare accumulator with value
JC 21 <condition>, <jump address> Jump conditional
JA 22 <jump address> Jump absolute
CSUB 23 <subroutine address> Call subroutine
RSUB 24 Return from subroutine
EI 25 <interrupt number> Enable interrupt
DI 26 <interrupt number> Disable interrupt
Command Number Parameter Description

WAIT 27 <condition>, <motor number>, Wait with further program execution
<ticks>
STOP 28 Stop program execution
CALCX 33 <operation> Arithmetical operation between accu-
mulator and X-register
AAP 34 <parameter>, <motor number> Accumulator to axis parameter
AGP 35 <parameter>, <bank number> Accumulator to global parameter
CLE 36 <flag> Clear an error flag
VECT 37 <interrupt number>, <address> Define interrupt vector
RETI 38 Return from interrupt
CALCVV 40 <operation>, <user variable 1>, <user Arithmetical operation between two
variable 2> user variables
CALCVA 41 <operation>, <user variable> Arithmetical operation between user
variable and accumulator
CALCAV 42 <operation>, <user variable> Arithmetical operation between accu-
mulator and user variable
CALCVX 43 <operation>, <user variable> Arithmetical operation between user
variable and X register
CALCXV 44 <operation>, <user variable> Arithmetical operation between X
register and user variable
CALCV 45 <operation>, <value> Arithmetical operation between user
variable and direct value
MVPA 46 ABS|REL|COORD, <motor number> Move to position specified by accu-
mulator
RST 48 <jump address> Restart the program from the given
address
DJNZ 49 <user variable>, <jump address> Decrement and jump if not zero
ROLA 50 <motor number> Rotate left, velocity specified by accu-
mulator
RORA 51 <motor number> Rotate right, velocity specified by ac-
cumulator
SIV 55 <value> Set indexed variable
GIV 56 Get indexed variable
AIV 57 Accumulator to indexed variable
Table 4: Overview of all TMCL Commands
3.5 TMCL Commands by Subject
3.5.1 Motion Commands
These commands control the motion of the motor. They are the most important commands and can be
used in direct mode or in standalone mode.
Motion Commands
Mnemonic Command number Meaning
ROL 2 Rotate left
ROR 1 Rotate right
MVP 4 Move to position
MST 3 Motor stop
Table 5: Motion Commands
3.5.2 Parameter Commands
These commands are used to set, read and store axis parameters or global parameters. Axis parameters
can be set independently for each axis, whereas global parameters control the behavior of the module
itself. These commands can also be used in direct mode and in standalone mode.
Parameter Commands
SAP 5 Set axis parameter
GAP 6 Get axis parameter
STAP 7 Store axis parameter
RSAP 8 Restore axis parameter
SGP 9 Set global parameter
GGP 10 Get global parameter
STGP 11 Store global parameter
RSGP 12 Restore global parameter
Table 6: Parameter Commands
3.5.3 Branch Commands
These commands are used to control the program flow (loops, conditions, jumps etc.). Using them in
direct mode does not make sense. They are intended for standalone mode only.
Branch Commands
JA 22 Jump always
JC 21 Jump conditional
COMP 20 Compare accumulator with constant value
CSUB 23 Call subroutine
RSUB 24 Return from subroutine
WAIT 27 Wait for a specified event
STOP 28 End of a TMCL program
Table 7: Branch Commands
3.5.4 I/O Port Commands
These commands control the external I/O ports and can be used in direct mode as well as in standalone
mode.
I/O Port Commands

SIO 14 Set output
GIO 15 Get input
Table 8: I/O Port Commands
3.5.5 Calculation Commands
These commands are intended to be used for calculations within TMCL applications. Although they could
also be used in direct mode it does not make much sense to do so.
Calculation Commands
CALC 19 Calculate using the accumulator and a constant value
CALCX 33 Calculate using the accumulator and the X register
AAP 34 Copy accumulator to an axis parameter
AGP 35 Copy accumulator to a global parameter
Table 9: Calculation Commands
For calculating purposes there is an accumulator (also called accu or A register) and an X register. When
executed in a TMCL program (in standalone mode), all TMCL commands that read a value store the result
in the accumulator. The X register can be used as an additional memory when doing calculations. It can
be loaded from the accumulator.
When a command that reads a value is executed in direct mode the accumulator will not be affected. This
means that while a TMCL program is running on the module (standalone mode), a host can still send com-
mands like GAP and GGP to the module (e.g. to query the actual position of the motor) without affecting
the flow of the TMCL program running on the module.
Please see also chapter 3.5.7 for more calculation commands.
3.5.6 Interrupt Processing Commands
TMCL also contains functions for a simple way of interrupt processing. Using interrupts, many tasks can
be programmed in an easier way.
The following commands are use to define and handle interrupts:
Interrupt Processing Commands

EI 25 Enable interrupt
DI 26 Disable interrupt
VECT 37 Set interrupt vector
RETI 38 Return from interrupt
Table 10: Interrupt Processing Commands
3.5.6.1 Interrupt Types

There are many different interrupts in TMCL, like timer interrupts, stop switch interrupts, position reached
interrupts, and input pin change interrupts. Each of these interrupts has its own interrupt vector. Each
interrupt vector is identified by its interrupt number. Please use the TMCL include file Interrupts.inc in
order to have symbolic constants for the interrupt numbers. Table 11 show all interrupts that are available
on the TMCM-1638.
Interrupt Vectors
Interrupt number Interrupt type
0 Timer 0
1 Timer 1
2 Timer 2
3 Target position reached 0
27 Left stop switch 0
28 Right stop switch 0
39 Input change ADIN0 (digital mode)
41 Input change GPI0
42 Input change GPI1
255 Global interrupts
Interrupt number Interrupt type
Table 11: Interrupt Vectors
3.5.6.2 Interrupt Processing

When an interrupt occurs and this interrupt is enabled and a valid interrupt vector has been defined
for that interrupt, the normal TMCL program flow will be interrupted and the interrupt handling routine
will be called. Before an interrupt handling routine gets called, the context of the normal program (i.e.
accumulator register, X register, flags) will be saved automatically.
There is no interrupt nesting, i.e. all other interrupts are disabled while an interrupt handling routine is
being executed.
On return from an interrupt handling routine (RETI command), the context of the normal program will
automatically be restored and the execution of the normal program will be continued.
3.5.6.3 Further Configuration of Interrupts

Some interrupts need further configuration (e.g. the timer interval of a timer interrupt). This can be done
using SGP commands with parameter bank 3 (SGP <type> , 3, <value>). Please refer to the SGP command
(chapter 3.6.9) for further information about that.
3.5.6.4 Using Interrupts in TMCL

To use an interrupt the following things have to be done:
• Define an interrupt handling routine using the VECT command.

• If necessary, configure the interrupt using an SGP <type>, 3, <value> command.
• Enable the interrupt using an EI <interrupt> command.
• Globally enable interrupts using an EI 255 command.
• An interrupt handling routine must always end with a RETI command.
• Do not allow the normal program flow to run into an interrupt handling routine.
The following example shows the use of a timer interrupt:

1 VECT 0 , Timer0Irq // define the interrupt vector
SGP 0 , 3 , 1000 // configure the interrupt : set its period to 1000 ms
3 EI 0 // enable this interrupt
EI 255 // globally switch on interrupt processing
5
// Main program : toggles output 3 , using a WAIT command for the delay
7 Loop :
SIO 3 , 2 , 1
9 WAIT TICKS , 0 , 50
SIO 3 , 2 , 0
JA Loop
13
// Here is the interrupt handling routine

15 Timer0Irq :
GIO 0 , 2 // check if OUT0 is high
17 JC NZ , Out0Off // jump if not
SIO 0 , 2 , 1 // switch OUT0 high
19 RETI // end of interrupt
Out0Off :
21 SIO 0 , 2 , 0 // switch OUT0 low
RETI // end of interrupt
In the example above, the interrupt numbers are being used directly. To make the program better read-
able use the provided include file Interrupts.inc. This file defines symbolic constants for all interrupt
numbers which can be used in all interrupt commands. The beginning of the program above then looks
as follows:
# include Interrupts . inc
2 VECT TI_TIMER0 , Timer0Irq
SGP TI_TIMER0 , 3 , 1000
4 EI TI_TIMER0
EI TI_GLOBAL
3.5.7 New TMCL Commands
In order to make several operations easier, the following new commands have been introduced from
firmware version 1.09 on. Using these new commands many taks can be programmed in an easier way.
This can save some code, thus making a TMCL program shorter, faster and easier to understand.
Please note that these commands are not available on TMCM-1638 modules with firmware versions be-
fore 1.09. So please make sure that at least firmware version 1.09 is installed before using them.
New TMCL Commands

CALCVV 40 Calculate using two user variables
CALCVA 41 Calculate using a user variable and the accumulator
CALCAV 42 Calculate using the accumulator and a user variable
CALCVX 43 Calculate using a user variable and the X register
CALCXV 44 Calculate using the X register and a user variable
CALCV 45 Calculate using a user variable and a direct value
MVPA 46 Move to position specified by accumulator
RST 48 Restart the program
DJNZ 49 Decrement and jump if not zero
CALL 80 Conditional subroutine call
ROLA 50 Rotate left using the accumulator
RORA 51 Rotate right using the accumulator
SIV 55 Set indexed variable
GIV 56 Get indexed variable
AIV 57 Accu to indexed variable
Table 12: New TMCL Commands
3.6 Detailed TMCL Command Descriptions

The module specific commands are explained in more detail on the following pages. They are listed
according to their command number.
3.6.1 ROR (Rotate Right)
The motor is instructed to rotate with a specified velocity in right direction (increasing the position counter).
The velocity is given in microsteps per second (pulse per second [pps]).
Internal function:
• First, velocity mode is selected.
• Then, the velocity value is transferred to axis parameter #2 (target velocity).
Related commands: ROL, MST, SAP, GAP.
Mnemonic: ROR <axis>, <velocity>
Binary Representation
Instruction Type Motor/Bank Value
1 0 0 -2147483648. . . 2147583647
Reply in Direct Mode

Status Value
100 - OK don’t care
Example
Rotate right motor 0, velocity 500.
Mnemonic: ROR 0, 500.
Binary Form of ROR 0, 51200

Field Value
Target address 01h
Instruction number 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) C8h
Value (Byte 0) 00h
Checksum CAh
3.6.2 ROL (Rotate Left)
The motor is instructed to rotate with a specified velocity in left direction (decreasing the position counter).
The velocity is given in microsteps per second (pulse per second [pps]).
Internal function:

• Then, the velocity value is transferred to axis parameter #2 (target velocity).
Related commands: ROR, MST, SAP, GAP.
Mnemonic: ROL <axis>, <velocity>
2 0 0 -2147483648. . . 2147583647

Status Value
Example
Rotate left motor 0, velocity 500.
Mnemonic: ROL 0, 500.
Binary Form of ROL 0, 51200

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) C8h
Value (Byte 0) 00h
Checksum CBh
3.6.3 MST (Motor Stop)
The motor is instructed to stop with a soft stop.
Internal function: The velocity mode is selected. Then, the target speed (axis parameter #0) is set to
zero.
Related commands: ROR, ROL, SAP, GAP.
Mnemonic: MST <axis>
3 0 0 0

Status Value
Example
Stop motor 0.
Mnemonic: MST 0.
Binary Form of MST 0

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 04h
3.6.4 MVP (Move to Position)
With this command the motor will be instructed to move to a specified relative or absolute position. It
will use the acceleration/deceleration ramp and the positioning speed programmed into the unit. This
command is non-blocking - that is, a reply will be sent immediately after command interpretation and ini-
tialization of the motion controller. Further commands may follow without waiting for the motor reaching
its end position. The maximum velocity and acceleration as well as other ramp parameters are defined
by the appropriate axis parameters. For a list of these parameters please refer to section 4.
The range of the MVP command is 32 bit signed (-2147483648. . . 2147483647). Positioning can be inter-
rupted using MST, ROL or ROR commands.
Three operation types are available:
• Moving to an absolute position in the range from -2147483648. . . 2147483647 (−231 ...231 − 1).
• Starting a relative movement by means of an offset to the actual position. In this case, the new
resulting position value must not exceed the above mentioned limits, too.
Note The distance between the actual position and the new position must not be more
than 2147483647 (231 − 1) position steps . Otherwise the motor will run in the op-
posite direction in order to take the shorter distance (caused by 32 bit overflow).
Internal function: A new position value is transferred to the axis parameter #0 (target position).
Related commands: SAP, GAP, MST.
Mnemonic: MVP <ABS|REL>, <axis>, <position|offset>
0 – ABS – absolute 0 <position>
4
1 – REL – relative 0 <offset>

Status Value
Example
Move motor 0 to position 90000.
Mnemonic: MVP ABS, 0, 90000
Binary Form of MVP ABS, 0, 90000

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 01h
Value (Byte 1) 5Fh
Value (Byte 0) 90h
Checksum F5h
Example
Move motor 0 from current position 10000 steps backward.
Mnemonic: MVP REL, 0, -10000
Binary Form of MVP REL, 0, -10000

Field Value
Target address 01h
Type 01h
Motor/Bank 00h
Value (Byte 3) FFh
Value (Byte 2) FFh
Value (Byte 1) D8h
Value (Byte 0) F0h
Checksum CCh
3.6.5 SAP (Set Axis Parameter)
With this command most of the motion control parameters of the module can be specified. The settings
will be stored in SRAM and therefore are volatile. That is, information will be lost after power off.
Info For a table with parameters and values which can be used together with this
command please refer to section 4.
Internal function: The specified value is written to the axis parameter specified by the parameter num-
ber.
Related commands: GAP, AAP.
Mnemonic: SAP <parameter number>, <axis>, <value>
Binary representation
5 see chapter 4 0 <value>

Status Value
Example Set the maximum positioning speed for motor 0 to 51200 pps.
Mnemonic: SAP 4, 0, 51200.
Binary Form of SAP 4, 0, 51200

Field Value
Target address 01h
Type 04h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) C8h
Value (Byte 0) 00h
Checksum D2h
3.6.6 GAP (Get Axis Parameter)
Most motion / driver related parameters of the TMCM-1638 can be adjusted using e.g. the SAP command.
With the GAP parameter they can be read out. In standalone mode the requested value is also transferred
to the accumulator register for further processing purposes (such as conditional jumps). In direct mode
the value read is only output in the value field of the reply, without affecting the accumulator.
Info For a table with parameters and values that can be used together with this com-
mand please refer to section 4.
Internal function: The specified value gets copied to the accumulator.

Related commands: SAP, AAP.
Mnemonic: GAP <parameter number>, <axis>

Status Value
100 - OK value read by this command
Example
Get the actual position of motor 0.
Mnemonic: GAP 1, 0.
Binary Form of GAP 1, 0

Field Value
Target address 01h
Type 01h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 08h
3.6.7 STAP (Store Axis Parameter)
This command is used to store TMCL axis parameters permanently in the EEPROM of the module. This
command is mainly needed to store the default configuration of the module. The contents of the user
variables can either be automatically or manually restored at power on.
command please refer to dection 4.
Internal function: The axis parameter specified by the type and bank number will be stored in the EEP-
ROM.
Related commands: SAP, AAP, GAP, RSAP.
Mnemonic: STAP <parameter number>, <bank>
7 see chapter 4 0 0 (don’t care)

Status Value
100 - OK 0 (don’t care)
Example
Store axis parameter #6.
Mnemonic: STAP 7, 6.
Binary Form of STAP 6, 12

Field Value
Target address 01h
Type 06h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 0Eh
3.6.8 RSAP (Restore Axis Parameter)
With this command the contents of an axis parameter can be restored from the EEPROM. By default, all
axis parameters are automatically restored after power up. An axis parameter that has been changed
before can be reset to the stored value by this instruction.
Internal function: The axis parameter specified by the type and bank number will be restored from the
EEPROM.
Related commands: SAP, AAP, GAP, RSAP.
Mnemonic: RSAP <parameter number>, <bank>
8 see chapter 4 0 0 (don’t care)

Status Value
Example
Restore axis parameter #6.
Mnemonic: RSAP 8, 6.
Binary Form of RSAP 8, 6

Field Value
Target address 01h
Type 06h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 0Ah
3.6.9 SGP (Set Global Parameter)
With this command most of the module specific parameters not directly related to motion control can be
specified and the TMCL user variables can be changed. Global parameters are related to the host interface,
peripherals or application specific variables. The different groups of these parameters are organized in
banks to allow a larger total number for future products. Currently, bank 0 is used for global parameters,
and bank 2 is used for user variables. Bank 3 is used for interrupt configuration.
All module settings in bank 0 will automatically be stored in non-volatile memory (EEPROM).
Internal function: The specified value will be copied to the global parameter specified by the type and
bank number. Most parameters of bank 0 will automatically be stored in non-volatile memory.
Related commands: GGP, AGP.
Mnemonic: SGP <parameter number>, <bank>, <value>
9 see chapter 5 0/2/3 <value>

Status Value
Example
Set the serial address of the device to 3.
Mnemonic: SGP 66, 0, 3.
Binary Form of SGP 66, 0, 3

Field Value
Target address 01h
Type 42h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 03h
Checksum 4Fh
3.6.10 GGP (Get Global Parameter)
All global parameters can be read with this function. Global parameters are related to the host interface,
peripherals or application specific variables. The different groups of these parameters are organized in
banks to allow a larger total number for future products. Currently, bank 0 is used for global parameters,
and bank 2 is used for user variables. Bank 3 is used for interrupt configuration.
Internal function: The global parameter specified by the type and bank number will be copied to the
accumulator register.
Related commands: SGP, AGP.
Mnemonic: GGP <parameter number>, <bank>
10 see chapter 5 0/2/3 0 (don’t care)

Status Value
100 - OK value read by this command
Example
Get the serial address of the device.
Mnemonic: GGP 66, 0.
Binary Form of GGP 66, 0

Field Value
Target address 01h
Instruction number 0Ah
Type 42h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 4Dh
3.6.11 STGP (Store Global Parameter)
This command is used to store TMCL global parameters permanently in the EEPROM of the module. This
command is mainly needed to store the TMCL user variables (located in bank 2) in the EEPROM of the mod-
ule, as most other global parameters (located in bank 0) are stored automatically when being modified.
The contents of the user variables can either be automatically or manually restored at power on.
command please refer to dection 5.2.
Internal function: The global parameter specified by the type and bank number will be stored in the
EEPROM.
Related commands: SGP, AGP, GGP, RSGP.
Mnemonic: STGP <parameter number>, <bank>
11 see chapter 5.2 2 0 (don’t care)

Status Value
Example
Store user variable #42.
Mnemonic: STGP 42, 2.
Binary Form of STGP 42, 2

Field Value
Target address 01h
Instruction number 0Bh
Type 2Ah
Motor/Bank 02h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 38h
3.6.12 RSGP (Restore Global Parameter)
With this command the contents of a TMCL user variable can be restored from the EEPROM. By default, all
user variables are automatically restored after power up. A user variable that has been changed before
can be reset to the stored value by this instruction.
command please refer to section 5.2.
Internal function: The global parameter specified by the type and bank number will be restored from
the EEPROM.
Related commands: SGP, AGP, GGP, STGP.
Mnemonic: RSGP <parameter number>, <bank>
12 see chapter 5.2 2 0 (don’t care)

Status Value
Example
Restore user variable #42.
Mnemonic: RSGP 42, 2.
Binary Form of RSGP 42, 2

Field Value
Target address 01h
Instruction number 0Ch
Type 2Ah
Motor/Bank 02h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 39h
3.6.13 SIO (Set Output)
This command sets the states of the general purpose digital outputs.
Internal function: The state of the output line specified by the type parameter is set according to the
value passed to this command.
Related commands: GIO.
Mnemonic: SIO <port number>, <bank number>, <value>
14 <port number> <bank number> (2) 0/1

Status Value
Example
Set output 0 (bank 2) to high.
Mnemonic: SIO 0, 2, 1.
Binary Form of SIO 0, 2, 1

Field Value
Target address 01h
Instruction number 0Eh
Type 00h
Motor/Bank 02h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 01h
Checksum 12h
Bank 2 – Digital Outputs

The following output lines can be set by the SIO commands) using bank 2.
Digital Outputs in Bank 2

Port Command Range
GPO0 SIO 0, 2, <value> 0/1
3.6.14 GIO (Get Input)
With this command the status of the available general purpose outputs of the module can be read. The
function reads a digital or an analog input port. Digital lines will read as 0 or 1, while the ADC channels
deliver their 12 bit result in the range of 0. . . 4095. In standalone mode the requested value is copied to
the accumulator register for further processing purposes such as conditional jumps. In direct mode the
value is only output in the value field of the reply, without affecting the accumulator. The actual status of
a digital output line can also be read.
Internal function: The state of the i/o line specified by the type parameter and the bank parameter is
read.
Related commands: SIO.
Mnemonic: GIO <port number>, <bank number>
15 <port number> <bank number> (0/1/2) 0 (don’t care)

Status Value
100 - OK status of the port
Example
Get the value of ADC channel 0.
Mnemonic: GIO 0, 1.
Binary Form of GIO 0, 1

Field Value
Target address 01h
Instruction number 0Fh
Type 00h
Motor/Bank 01h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 11h
Reply (Status=no error, Value=302)

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 0Fh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 01h
Value (Byte 0) 2Eh
Checksum A5h
Bank 0 – Digital Inputs

The analog input lines can be read as digital or analog inputs at the same time. The digital input states
can be accessed in bank 0.
Digital Inputs in Bank 0

Port Command Range
ADIN0 GIO 0, 0 0/1
GPI0 GIO 2, 0 0/1

GPI1 GIO 3, 0 0/1
Special case: GIO 255, 0 reads all general purpose inputs simulataneously and puts the result into the
lower eight bits of the accumulator register.
Bank 1 – Analog Inputs

The analog input lines can be read back as digital or analog inputs at the same time. The analog values
can be accessed in bank 1.
Analog Inputs in Bank 1

Port Command Range / Units
ADIN0 GIO 0, 1 0. . . 4095
Voltage GIO 8, 1 [1/10V]
Temperature GIO 9, 1 [°C]
Bank 2 – States of the Digital Outputs

The states of the output lines (that have been set by SIO commands) can be read back using bank 2.
Digital Outputs in Bank 2

Port Command Range
GPO0 GIO 0, 2 0/1
3.6.15 CALC (Calculate)
A value in the accumulator variable, previously read by a function such as GAP (get axis parameter) can
be modified with this instruction. Nine different arithmetic functions can be chosen and one constant
operand value must be specified. The result is written back to the accumulator, for further processing
like comparisons or data transfer. This command is mainly intended for use in standalone mode.
Related commands: CALCX, COMP, AAP, AGP, GAP, GGP, GIO.
Mnemonic: CALC <operation>, <operand>
19 0 ADD – add to accumulator 0 (don’t care) <operand>
1 SUB – subtract from accumulator
2 MUL – multiply accumulator by
3 DIV – divide accumulator by
4 MOD – modulo divide accumulator by
5 AND – logical and accumulator with
6 OR – logical or accumulator with
7 XOR – logical exor accumulator with
8 NOT – logical invert accumulator
9 LOAD – load operand into accumulator

Status Value
100 - OK the operand (don’t care)
Example
Multiply accumulator by -5000.
Mnemonic: CALC MUL, -5000
Binary Form of CALC MUL, -5000

Field Value
Target address 01h
Type 02h
Motor/Bank 00h
Value (Byte 3) FFh
Value (Byte 2) FFh
Value (Byte 1) ECh
Value (Byte 0) 78h
Checksum 78h
Reply (Status=no error, value=-5000:

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 13h
Value (Byte 3) FFh
Value (Byte 2) FFh
Value (Byte 1) ECh
Value (Byte 0) 78h
Checksum DCh
3.6.16 COMP (Compare)
The specified number is compared to the value in the accumulator register. The result of the comparison
can for example be used by the conditional jump (JC) instruction. This command is intended for use in stan-
dalone operation only.
Internal function: The accumulator register is compared with the sepcified value. The internal arithmetic
status flags are set according to the result of the comparison. These can then control e.g. a conditional
jump.
Related commands: JC, GAP, GGP, GIO, CALC, CALCX.
Mnemonic: COMP <operand>
20 0 (don’t care) 0 (don’t care) <operand>
Example
Jump to the address given by the label when the position of motor #0 is greater than or equal to 1000.
1 GAP 1 , 0 // get actual position of motor 0
COMP 1000 // compare actual value with 1000
3 JC GE , Label // jump to Lable if greter or equal to 1000
Binary Form of COMP 1000

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 03h
Value (Byte 0) E8h
Checksum 00h
3.6.17 JC (Jump conditional)
The JC instruction enables a conditional jump to a fixed address in the TMCL program memory, if the
specified condition is met. The conditions refer to the result of a preceding comparison. Please refer to
COMP instruction for examples. This command is intended for standalone operation only.
Internal function: The TMCL program counter is set to the value passed to this command if the status
flags are in the appropriate states.
Related commands: JA, COMP, WAIT, CLE.
Mnemonic: JC <condition>, <label>
21 0 ZE - zero 0 (don’t care) <jump address>
1 NZ - not zero
2 EQ - equal
3 NE - not equal
4 GT - greater
5 GE - greater/equal
6 LT - lower
7 LE - lower/equal
8 ETO - time out error
9 EAL - external alarm
10 EDV - deviation error
11 EPO - position error
Example
Jump to the address given by the label when the position of motor #0 is greater than or equal to 1000.
1 GAP 1 , 0 // get actual position of motor 0
COMP 1000 // compare actual value with 1000
3 JC GE , Label // jump to Lable if greter or equal to 1000
...
5 Label : ROL 0 , 1000
Binary form of JC GE, Label as-

suming Label at address 10
Field Value
Target address 01h
Type 05h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 0Ah
Checksum 25h
3.6.18 JA (Jump always)
Jump to a fixed address in the TMCL program memory. This command is intended for standalone operation
only.
Internal function: The TMCL program counter is set to the value passed to this command.
Related commands: JC, WAIT, CSUB.
Mnemonic: JA <label>
22 0 (don’t care) 0 (don’t care) <jump address>
Example
An infinite loop in TMCL:
1 Loop :
MVP ABS , 0 , 51200
3 WAIT POS , 0 , 0
MVP ABS , 0 , 0
5 WAIT POS , 0 , 0
JA Loop
Binary form of the JA Loop command when the label Loop is at address 10:
Binary Form of JA Loop (assum-

ing Loop at address 10)
Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 0Ah
Checksum 21h
3.6.19 CSUB (Call Subroutine)
This function calls a subroutine in the TMCL program memory. It is intended for standalone operation only.
Internal function: the actual TMCL program counter value is saved to an internal stack, afterwards over-
written with the passed value. The number of entries in the internal stack is limited to 8. This also limits
nesting of subroutine calls to 8. The command will be ignored if there is no more stack space left.
Related commands: RSUB, JA.
Mnemonic: CSUB <label>
23 0 (don’t care) 0 (don’t care) <subroutine address>
Example
Call a subroutine:
Loop :
2 MVP ABS , 0 , 10000
CSUB SubW // Save program counter and jump to label SubW
4 MVP ABS , 0 , 0
CSUB SubW // Save program counter and jump to label SubW
6 JA Loop
8 SubW :
WAIT POS , 0 , 0
RSUB // Continue with the command following the CSUB command
Binary form of CSUB SubW

(assuming SubW at address
100)
Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 64h
Checksum 7Ch
3.6.20 RSUB (Return from Subroutine)
Return from a subroutine to the command after the CSUB command. This command is intended for use in
standalone mode only.
Internal function: the TMCL program counter is set to the last value saved on the stack. The command
will be ignored if the stack is empty.
Related commands: CSUB.
Mnemonic: RSUB
24 0 (don’t care) 0 (don’t care) 0 (don’t care)
Example
Please see the CSUB example (section 3.6.19).
Binary form:
Binary Form of RSUB

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 19h
3.6.21 WAIT (Wait for an Event to occur)
This instruction interrupts the execution of the TMCL program until the specified condition is met. This
command is intended for standalone operation only.
There are five different wait conditions that can be used:
• TICKS: Wait until the number of timer ticks specified by the <ticks> parameter has been reached.
• POS: Wait until the target position of the motor specified by the <motor> parameter has been
reached. An optional timeout value (0 for no timeout) must be specified by the <ticks> parameter.
• REFSW: Wait until the reference switch of the motor specified by the <motor> parameter has been
triggered. An optional timeout value (0 for no timeout) must be specified by the <ticks> parameter.
• LIMSW: Wait until a limit switch of the motor specified by the <motor> parameter has been triggered.
An optional timeout value (0 for no timeout) must be specified by the <ticks> parameter.
Special case for the <ticks> parameter: When this parameter is set to -1 the contents of the accumula-
tor register will be taken for this value. So for example WAIT TICKS, 0, -1 will wait as long as specified by
the value store in the accumulator. The accumulator must not contain a negative value when using this option.
The timeout flag (ETO) will be set after a timeout limit has been reached. You can then use a JC ETO com-
mand to check for such errors or clear the error using the CLE command.
Internal function: the TMCL program counter will be held at the address of this WAIT command until
the condition is met or the timeout has expired.
Related commands: JC, CLE.
Mnemonic: WAIT <condition>, <motor number>, <ticks>
0 TICKS – timer ticks 0 (don’t care) <no. of ticks to wait1 >
1 POS – target position reached <motor number> <no. of ticks for timeout1 >
0 for no timeout
2 REFSW – reference switch <motor number> <no. of ticks for timeout1 >
27 0 for no timeout
3 LIMSW – limit switch <motor number> <no. of ticks for timeout1 >
0 for no timeout
Example
Wait for motor 0 to reach its target position, without timeout.
Mnemonic: WAIT POS, 0, 0
1 one tick is 10 milliseconds
Binary Form of WAIT POS, 0, 0

Field Value
Target address 01h
Type 01h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 1Dh
3.6.22 STOP (Stop TMCL Program Execution – End of TMCL Program)
This command stops the execution of a TMCL program. It is intended for use in standalone operation only.
Internal function: Execution of a TMCL program in standalone mode will be stopped.
Related commands: none.
Mnemonic: STOP
Example
Mnemonic: STOP
Binary Form of STOP

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 1Dh
3.6.23 CALCX (Calculate using the X Register)
This instruction is very similar to CALC, but the second operand comes from the X register. The X register
can be loaded with the LOAD or the SWAP type of this instruction. The result is written back to the accu-
mulator for further processing like comparisons or data transfer. This command is mainly intended for use
in standalone mode.
Related commands: CALC, COMP, JC, AAP, AGP, GAP, GGP, GIO.
Mnemonic: CALCX <operation>
33 0 ADD – add X register to accumulator 0 (don’t care) 0 (don’t care)
1 SUB – subtract X register from accumulator
2 MUL – multiply accumulator by X register
3 DIV – divide accumulator by X register
4 MOD – modulo divide accumulator by X register
5 AND – logical and accumulator with X register
6 OR – logical or accumulator with X register
7 XOR – logical exor accumulator with X register
8 NOT – logical invert X register
9 LOAD – copy accumulator to X register
10 SWAP – swap accumulator and X register

Status Value
Example
Multiply accumulator and X register.
Mnemonic: CALCX MUL
Binary Form of CALCX MUL

Field Value
Target address 01h
Type 02h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 24h
3.6.24 AAP (Accu to Axis Parameter)
The content of the accumulator register is transferred to the specified axis parameter. For practical usage,
the accumulator has to be loaded e.g. by a preceding GAP instruction. The accumulator may have been
modified by the CALC or CALCX (calculate) instruction. This command is mainly intended for use in standalone
mode.
Related commands: AGP, SAP, GAP, SGP, GGP, GIO, GCO, CALC, CALCX.
Mnemonic: AAP <parameter number>, <motor number>

Status Value
Example
Position motor #0 by a potentiometer connected to analog input #0:
1 Start :
GIO 0 ,1 // get value of analog input line 0
3 CALC MUL , 4 // multiply by 4
AAP 0 ,0 // transfer result to target position of motor 0
5 JA Start // jump back to start
Binary Form of AAP 0, 0

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 23h
3.6.25 AGP (Accu to Global Parameter)
The content of the accumulator register is transferred to the specified global parameter. For practical
usage, the accumulator has to be loaded e.g. by a preceding GAP instruction. The accumulator may have
been modified by the CALC or CALCX (calculate) instruction. This command is mainly intended for use in
standalone mode.
Info For an overview of parameter and bank indices that can be used with this com-
mand please see section 5.
Related commands: AAP, SGP, GGP, SAP, GAP, GIO.
Mnemonic: AGP <parameter number>, <bank number>
35 <parameter number> 0/2/3 <bank number> 0 (don’t care)

Status Value
Example
Copy accumulator to user variable #42:
Mnemonic: AGP 42, 2
Binary Form of AGP 42, 2

Field Value
Target address 01h
Type 2Ah
Motor/Bank 02h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 50h
3.6.26 CLE (Clear Error Flags)
This command clears the internal error flags. It is mainly intended for use in standalone mode.
The following error flags can be cleared by this command (determined by the <flag> parameter):
• ALL: clear all error flags.
• ETO: clear the timeout flag.
• EAL: clear the external alarm flag.

• EDV: clear the deviation flag.
• EPO: clear the position error flag.
Related commands: JC, WAIT.
Mnemonic: CLE <flags>
36 0 ALL – all flags 0 (don’t care) 0 (don’t care)
1 – (ETO) timeout flag
2 – (EAL) alarm flag
3 – (EDV) deviation flag
4 – (EPO) position flag
5 – (ESD) shutdown flag

Status Value
Example
Reset the timeout flag.
Mnemonic: CLE ETO
Binary Form of CLE ETO

Field Value
Target address 01h
Type 01h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 26h
3.6.27 EI (Enable Interrupt)
The EI command enables an interrupt. It needs the interrupt number as parameter. Interrupt number
255 globally enables interrupt processing. This command is mainly intended for use in standalone mode.
Info Please see table 11 for a list of interrupts that can be used on the TMCM-1638
module.
Related commands: DI, VECT, RETI.
Mnemonic: EI <interrupt number>
25 <interrupt number> 0 (don’t care) 0 (don’t care)

Status Value
Example
Globally enable interrupt processing:
Mnemonic: EI 255
Binary form of EI 255

Field Value
Target address 01h
Type FFh
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 19h
3.6.28 DI (Disable Interrupt)
The DI command disables an interrupt. It needs the interrupt number as parameter. Interrupt number
255 globally disables interrupt processing. This command is mainly intended for use in standalone mode.
module.
Related commands: EI, VECT, RETI.
Mnemonic: DI <interrupt number>

Status Value
Example
Globally disable interrupt processing:
Mnemonic: DI 255
Binary Form of DI 255

Field Value
Target address 01h
Type FFh
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 1Ah
3.6.29 VECT (Define Interrupt Vector)
The VECT command defines an interrupt vector. It takes an interrupt number and a label (just like with
JA, JC and CSUB commands) as parameters. The label must be the entry point of the interrupt handling
routine for this interrupts. Interrupt vectors can also be re-defined. This command is intended for use in
standalone mode only.
module.
Related commands: EI, DI, RETI.
Mnemonic: VECT <interrupt number>, <label>
37 <interrupt number> 0 (don’t care) <label>

Status Value
Example
Define interrupt vector for timer #0 interrupt:
1 VECT 0 , Timer0Irq
...
3 Loop :
...
5 JA Loop
...
7 Timer0Irq :
SIO 0 , 2 , 1
9 RETI
Binary form of VECT (assuming

label is at 50)
Field Value
Target address 01h
Type FFh
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 32h
Checksum 58h
3.6.30 RETI (Return from Interrupt)
This command terminates an interrupt handling routine. Normal program flow will be continued then.
This command is intended for use in standalone mode only.
An interrupt routine must always end with a RETI command. Do not allow the normal program flow to
run into an interrupt routine.
Internal function: The saved registers (accumulator, X registers, flags and program counter) are copied
back so that normal program flow will continue.
Related commands: EI, DI, VECT.
Mnemonic: RETI

Status Value
Example
Return from an interrup handling routine.
Mnemonic: RETI
Binary Form of RETI

Field Value
Target address 01h
Type FFh
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 27h
3.6.31 CALCVV (Calculate using two User Variables)
The CALCVV instruction directly uses the contents of two user variables for an arithmetic operation, stor-
ing the result in the first user variable. This eliminates the need for using the accumulator register and/or
X register for such purposes. The parameters of this command are the arithmetic function, the index of
the first user variable (0. . . 255) and the index of the second user variable (0. . . 255). This command is mainly
intended for use in standalone mode.
Related commands: CALCVA, CALCAV, CALCVX, CALCXV, CALCV.
Mnemonic: CALCVV <operation>, <var1>, <var2>
40 0 ADD – add <var2> to <var1> 0 <var1> (0. . . 255) <var2> (0. . . 255)
1 SUB – subtract <var2> from <var1>
2 MUL – multiply <var2> with <var1>
3 DIV – divide <var2> by <var1>
4 MOD – modulo divide <var2> by <var1>
5 AND – logical and <var2> with <var1>
6 OR – logical or <var2> with <var1>
7 XOR – logical exor <var2> with <var1>
8 NOT – copy logical inverted <var2> to <var1>
9 LOAD – copy <var2> to <var1>
10 SWAP – swap contents of <var1> and <var2>
11 COMP – compare <var1> with <var2>

Status Value
Example
Subtract user variable #42 from user variable #65.
Mnemonic: CALCVV SUB, 65, 42
Binary Form of CALCVV SUB, 65, 42

Field Value
Target address 01h
Type 01h
Motor/Bank 41h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 2Ah
Checksum 95h
Reply (Status=no error, value=0:

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 28h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 8Fh
3.6.32 CALCVA (Calculate using a User Variable and the Accumulator Register)
The CALCVA instruction directly modifies a user variable using an arithmetical operation and the contents
of the accumulator register. The parameters of this command are the arithmetic function and the index
of a user variable (0. . . 255). This command is mainly intended for use in standalone mode.
Related commands: CALCV, CALCAV, CALCVX, CALCXV, CALCVV.
Mnemonic: CALCVA <operation>, <var>
41 0 ADD – add accumulator to <var> 0 <var> (0. . . 255) 0 (don’t care)
1 SUB – subtract accumulator from <var>
2 MUL – multiply <var> with accumulator
3 DIV – divide <var> by accumulator
4 MOD – modulo divide <var> by accumulator
5 AND – logical and <var> with accumulator
6 OR – logical or <var> with accumulator
7 XOR – logical exor <var> with accumulator
8 NOT – copy logical inverted accumulator to <var>
9 LOAD – copy accumulator to <var>
10 SWAP – swap contents of <var> and accumulator
11 COMP – compare <var> with accumulator

Status Value
Example
Subtract accumulator from user variable #27.
Mnemonic: CALCVA SUB, 27
Binary Form of CALCVA SUB, 27

Field Value
Target address 01h
Type 01h
Motor/Bank 1Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 46h

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 29h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 90h
3.6.33 CALCAV (Calculate using the Accumulator Register and a User Variable)
The CALCAV instruction modifies the accumulator register using an arithmetical operation and the con-
tents of a user variable. The parameters of this command are the arithmetic function and the index of a
user variable (0. . . 255). This command is mainly intended for use in standalone mode.
Related commands: CALCV, CALCAV, CALCVX, CALCXV, CALCVV.
Mnemonic: CALCAV <operation>, <var>
42 0 ADD – add <var> to accumulator 0 <var> (0. . . 255) 0 (don’t care)
1 SUB – subtract <var> from accumulator
2 MUL – multiply accumulator with <var>
3 DIV – divide accumulator by <var>
4 MOD – modulo divide accumulator by <var>
5 AND – logical and accumulator with <var>
6 OR – logical or accumulator with <var>
7 XOR – logical exor accumulator with <var>
8 NOT – copy logical inverted <var> to accumulator
9 LOAD – copy <var> to accumulator
10 SWAP – swap contents of <var> and accumulator
11 COMP – compare accumulator with <var>

Status Value
Example
Subtract user variable #27 from accumulator.
Mnemonic: CALCXV SUB, 27
Binary Form of CALCXV SUB, 27

Field Value
Target address 01h
Type 01h
Motor/Bank 1Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 47h

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 2Ah
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 91h
3.6.34 CALCVX (Calculate using a User Variable and the X Register)
The CALCVX instruction directly modifies a user variable using an arithmetical operation and the contents
of the X register. The parameters of this command are the arithmetic function and the index of a user
variable (0. . . 255). This command is mainly intended for use in standalone mode.
Related commands: CALCV, CALCAV, CALCVA, CALCXV, CALCVV.
Mnemonic: CALCVX <operation>, <var>
43 0 ADD – add X register to <var> 0 <var> (0. . . 255) 0 (don’t care)
1 SUB – subtract X register from <var>
2 MUL – multiply <var> with X register
3 DIV – divide <var> by X register
4 MOD – modulo divide <var> by X register
5 AND – logical and <var> with X register
6 OR – logical or <var> with X register
7 XOR – logical exor <var> with X register
8 NOT – copy logical inverted X register to <var>
9 LOAD – copy X register to <var>
10 SWAP – swap contents of <var> and X register
11 COMP – compare <var> with X register

Status Value
Example
Subtract X register from user variable #27.
Mnemonic: CALCVX SUB, 27
Binary Form of CALCVX SUB, 27

Field Value
Target address 01h
Type 01h
Motor/Bank 1Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 48h

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 2Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 92h
3.6.35 CALCXV (Calculate using the X Register and a User Variable)
The CALCXV instruction modifies the X register using an arithmetical operation and the contents of a user
variable. The parameters of this command are the arithmetic function and the index of a user variable
(0. . . 255). This command is mainly intended for use in standalone mode.
Related commands: CALCV, CALCAV, CALCVA, CALCVX, CALCVV.
Mnemonic: CALCXV <operation>, <var>
44 0 ADD – add <var> to X register 0 <var> (0. . . 255) 0 (don’t care)
1 SUB – subtract <var> from X register
2 MUL – multiply X register with <var>
3 DIV – divide X register by <var>
4 MOD – modulo divide X register by <var>
5 AND – logical and X register with <var>
6 OR – logical or X register with <var>
7 XOR – logical exor X register with <var>
8 NOT – copy logical inverted <var> to X register
9 LOAD – copy <var> to X register
10 SWAP – swap contents of <var> and X register
11 COMP – compare X register with <var>

Status Value
Example
Subtract user variable #27 from X register.
Mnemonic: CALCXV SUB, 27
Binary Form of CALCXV SUB, 27

Field Value
Target address 01h
Type 01h
Motor/Bank 1Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 49h

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 2Ch
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 93h
3.6.36 CALCV (Calculate using a User Variable and a Direct Value)
The CALCV directly modifies a user variable using an arithmetical operation and a direct value. This elim-
inates the need of using the accumulator register for such a purpose and thus can make the program
shorter and faster. The parameters of this command are the arithmetic function, the index of a user vari-
able (0. . . 255) and a direct value. This command is mainly intended for use in standalone mode.
Related commands: CALCVA, CALCAV, CALCVX, CALCXV, CALCVV.
Mnemonic: CALCV <operation>, <var>, <value>
45 0 ADD – add <value> to <var> 0 <var> (0. . . 255) <value>
1 SUB – subtract <value> from <var>
2 MUL – multiply <var> with <value>
3 DIV – divide <var> by <value>
4 MOD – modulo divide <var> by <value>
5 AND – logical and <var> with <value>
6 OR – logical or <var> with <value>
7 XOR – logical exor <var> with <value>
8 NOT – logical invert <var> (<value> ignored)
9 LOAD – copy <value> to <var>
11 COMP – compare <var> with <value>

Status Value
Example
Subtract 5000 from user variable #27.
Mnemonic: CALCV SUB, 27, 5000
Binary Form of CALCV SUB, 27, 5000

Field Value
Target address 01h
Instruction number 2Dh
Type 01h
Motor/Bank 1Bh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 13h
Value (Byte 0) 88h
Checksum E5h

Field Value
Host address 02h
Target address 01h
Status 64h
Instruction 2Dh
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 13h
Value (Byte 0) 88h
Checksum 2Fh
3.6.37 RST (Restart)
Stop the program, reset the TMCL interpreter and then re-start the program at the given label. This com-
mand can be used to re-start the TMCL program from anywhere in the program, also out of subroutines
or interrupt rotuines. This command is intended for standalone operation only.
Internal function: The TMCL interpreter is reset (the subroutine stack, the interrupt stack and the regis-
ters are cleared) and then the program counter is set to the value passed to this command.
Related commands: JA, CSUB, STOP.
Mnemonic: RST <label>
48 0 (don’t care) 0 (don’t care) <restart address>
Example
Restart the program from a label, out of a subroutine:
1 Entry :
MVP ABS , 0 , 51200
3 CSUB Subroutine
...
5 ...
Subroutine :
7 RST Entry
RSUB
Binary form of the RST Entry command when the label Entry is at address 10:
Binary Form of RST Entry (as-

suming Entry at address 10)
Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 0Ah
Checksum 3Ah
3.6.38 DJNZ (Decrement and Jump if not Zero)
Decrement a given user variable and jump to the given address if the user variable is greater than zero.
This command can for example be used to easily program a counting loop, using any user variable as the
loop counter. This command is intended for standalone operation only.
Internal function: The user variable passed to this command is decremented. If it is not zero then the
TMCL program counter is set to the value passed to this command.
Related commands: JC, WAIT, CSUB.
Mnemonic: DJNZ <var>, <label>
49 <user variable> (0. . . 255) 0 (don’t care) <jump address>
Example
A counting loop in TMCL, using user variable #42:
SGP 42 , 2 , 100
2 Loop :
MVP ABS , REL , 51200
4 WAIT POS , 0 , 0
6 DJNZ 42 , Loop
Binary form of the DJNZ 42, Loop command when the label Loop is at address 1:
Binary Form of DJNZ Loop (as-

suming Loop at address 1)
Field Value
Target address 01h
Type 64h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 01h
Checksum 97h
3.6.39 CALL (Conditional Subroutine Call)
The CALL command calls a subroutine in the TMCL program, but only if the specifed condition is met. Oth-
erwise the program execution will be continued with the next command following the CALL command.
The conditions refer to the result of a preceding comparison or assignment. This command is intended for
standalone operation only.
Internal function: When the condition is met the actual TMCL program counter value will be saved to
an internal stack. Afterwards the program counter will be overwritten with the address supplied to this
command. The number of entries in the internal stack is limited to 8. This also limits nesting of subroutine
calls to 8. The command will be ignored if there is no more stack space left.
Related commands: RSUB, JC.
Mnemonic: CALL <condition>, <label>
21 0 ZE - zero 0 (don’t care) <jump address>
1 NZ - not zero
2 EQ - equal
3 NE - not equal
4 GT - greater
5 GE - greater/equal
6 LT - lower
7 LE - lower/equal
8 ETO - time out error
9 EAL - external alarm
10 EDV - deviation error
11 EPO - position error
Example
Call a subroutine if a condition is met:
Loop :
2 GIO 0 , 1 // read analog value
CALC SUB , 512 // subtract 512
4 COMP 0 // compare with zero
CALL LT , RunLeft // Call routine " RunLeft " if accu <0
6 CALL ZE , MotorStop // Call routine " MotosStop " if accu =0
CALL GT , RunRight // Call routine " RunRight " if accu >0
8 JA Loop
10 RunLeft :
CALC MUL , -1
12 ROLA 0
RSUB
14
RunRight :
16 RORA 0
RSUB
18
MotorStop :
20 GAP 2 , 0
JC ZE , MotorIsStopped
22 MST 0
MotorIsStopped :
24 RSUB
Binary form of CALL LT, Run-

Left
(assuming RunLeft at address
100)
Field Value
Target address 01h
Type 06h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 64h
Checksum BBh
3.6.40 MVPA (Move to Position specified by Accumulator Register)
With this command the motor will be instructed to move to a specified relative or absolute position. The
contents of the accumulator register will be used as the target position. This command is non-blocking
which means that a reply will be sent immediately after command interpretation and initialization of the
motion controller. Further commands may follow without waiting for the motor reaching its end position.
The maximum velocity and acceleration as well as other ramp parameters are defined by the appropriate
axis parameters. For a list of these parameters please refer to section 4.
Positioning can be interrupted using MST, ROL or ROR commands.
Three operation types are available:

• Moving to an absolute position specified by the accumulator register contents.
• Starting a relative movement by means of an offset to the actual position.

• Moving the motor to a (previously stored) coordinate (refer to SCO for details).
Note The distance between the actual position and the new position must not be more
than 2147483647 (231 − 1) microsteps. Otherwise the motor will run in the oppo-
site direction in order to take the shorter distance (caused by 32 bit overflow).
Internal function: The value stored in the accumulator register is copied to the axis parameter #0 (target
position).
Related commands: MVPXA, SAP, GAP, SCO, GCO, CCO, ACO, MST.
Mnemonic: MVPA <ABS|REL|COORD>, <axis>
0 – ABS – absolute 0 0 (don’t care)
46 1 – REL – relative 0 0 (don’t care)
2 – COORD – coordinate 0. . . 255 0 (don’t care)

Status Value
Example
Move motor 0 to position specified by accumulator.
Mnemonic: MVPA ABS, 0
Binary Form of MVPA ABS, 0

Field Value
Target address 01h
Instruction number 2Eh
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 2Fh
3.6.41 ROLA (Rotate Left using the Accumulator Register)
Rotate in left direction (decreasing the position counter) using the velocity specified by the contents of
the accumulator register. The velocity is given in microsteps per second (pulse per second [pps]).
Internal function:

• Then, the content of the accumulator is copied to axis parameter #2 (target velocity).
Related commands: RORA, MST, SAP, GAP.
Mnemonic: ROLA <axis>

Status Value
Example
Rotate left motor 0, velocity specified by accumulator.
Mnemonic: ROLA 0.
Binary Form of ROLA 0

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 33h
3.6.42 RORA (Rotate Right using the Accumulator Register)
Rotate in right direction (increasing the position counter) using the velocity specified by the contents of
the accumulator register. The velocity is given in microsteps per second (pulse per second [pps]).
Internal function:

• Then, the content of the accumulator is copied to axis parameter #2 (target velocity).
Related commands: ROLA, MST, SAP, GAP.
Mnemonic: ROLA <axis>

Status Value
Example
Rotate right motor 0, velocity specified by accumulator.
Mnemonic: RORA 0.
Binary Form of RORA 0

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 33h
3.6.43 SIV (Set Indexed Variable)
This command copies a direct value to a TMCL user variable. The index of the user variable (0. . . 255) is
specified by the content of the X register. Therefore the value in the X register must not be lower than
zero or greater than 255. Otherwise this command will be ignored. This command is mainly intended for
use in standalone mode.
Internal function: The direct value supplied to this command will be copied to the user variable specified
by the X register.
Related commands: AIV, GIV.
Mnemonic: SIV
55 0 (don’t care) 0 (don’t care) <value>

Status Value
Example
Copy the value 3 to the user variable indexed by the X register.
Mnemonic: SIV 3.
Binary Form of SIV 3

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 03h
Checksum 3Bh
3.6.44 GIV (Get Indexed Variable)
This command reads a TMCL user variable and copies its content to the accumulator register. The index
of the user variable (0. . . 255) is specified by the X register. Therefore the content of the X register must
not be lower than zero or greater than 255. Otherwise this command will be ignored. This command is
mainly intended for use in standalone mode.
Internal function: The user variable specified by the x register will be copied to the accumulator register.
Related commands: SIV, AIV.
Mnemonic: GIV

Status Value
Example
Read the user variable indexed by the X register.
Mnemonic: GIV.
Binary Form of GIV

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 03h
Checksum 39h
3.6.45 AIV (Accumulator to Indexed Variable)
This command copies the content of the accumulator to a TMCL user variable. The index of the user vari-
able (0. . . 255) is specified by the content of the X register. Therefore the value in the X register must not
be lower than zero or greater than 255. Otherwise this command will be ignored. This command is mainly
intended for use in standalone mode.
Internal function: The accumulator will be copied to the user variable specified by the X register.
Related commands: SIV, GIV.
Mnemonic: AIV
55 0 (don’t care) 0 (don’t care) <value>

Status Value
Example
Copy the accumulator to the user variable indexed by the X register.
Mnemonic: AIV.
Binary Form of AIV

Field Value
Target address 01h
Type 00h
Motor/Bank 00h
Value (Byte 3) 00h
Value (Byte 2) 00h
Value (Byte 1) 00h
Value (Byte 0) 00h
Checksum 3Ah
3.6.46 Customer specific Command Extensions (UF0. . . UF7 – User Functions)
These commands are used for customer specific extensions of TMCL. They will be implemented in C by
Trinamic. Please contact the sales department of Trinamic Motion Control GmbH & Co KG if you need a
customized TMCL firmware.
Related commands: none.
Mnemonic: UF0. . . UF7
64. . . 71 <user defined> 0 <user defined> 0 <user defined>

Status Value
100 - OK user defined
3.6.47 TMCL Control Commands
There is a set of TMCL commands which are called TMCL control commands. These commands can only
be used in direct mode and not in a standalone program. For this reason they only have opcodes, but
no mnemonics. Most of these commands are only used by the TMCL-IDE (in order to implement e.g. the
debugging functions in the TMCL creator). Some of them are also interesting for use in custom host appli-
cations, for example to start a TMCL routine on a module, when combining direct mode and standalone
mode (please see also section 7.6. The following table lists all TMCL control commands.
The motor/bank parameter is not used by any of these functions and thus is not listed in the table. It
should always be set to 0 with these commands.
TMCL Control Commands

Instruction Description Type Value
128 – stop application stop a running TMCL 0 (don’t care) 0 (don’t care)
application
129 – run application start or continue 0 – from current 0 (don’t care)
TMCL program address
execution
1 – from specific starting ad-
address dress
130 – step application execute only the next 0 (don’t care) 0 (don’t care)
TMCL command
131 – reset application Stop a running TMCL 0 (don’t care) 0 (don’t care)
program.
Reset program
counter and stack
pointer to zero.
Reset accumulator
and X register to
zero.
Reset all flags.
132 – enter download mode All following 0 (don’t care) start address
commands (except for download
control commands)
are not executed but
stored in the TMCL
memory.
133 – exit download mode End the download 0 (don’t care) 0 (don’t care)
mode. All following
commands are
executed normally
again.
134 – read program memory Return contents of 0 (don’t care) address of
the specified memory loca-
program memory tion
location (special
reply format).
Instruction Description Type Value

135 – get application status Return information 0 - return mode, 0 (don’t care)
about the current wait flag, memory
status, depending on pointer
the type field. 1 - return mode,
wait flag, program
counter
2 - return
accumulator
3 - return X
register
136 – get firmware version Return firmware 0 - string format 0 (don’t care)
version in string 1 - binary format
format (special reply)
or binary format).
137 – restore factory settings Reset all settings in 0 (don’t care) set to 1234
the EEPROM to their
factory defaults.
This command does
not send a reply.
255 – software reset Restart the CPU of 0 (don’t care) set to 1234
the module (like a
power cycle).
The reply of this
command might not
always get through.
Table 13: TMCL Control Commands
Especially the commands 128, 129, 131, 136 and 255 are interesting for use in custom host applications.
The other control commands are mainly being used by the TMCL-IDE.
4 Axis Parameters
Most motor controller features of the TMCM-1638 module are controlled by axis parameters. Axis param-
eters can be modified or read using SAP, GAP and AAP commands. Some axis parameters can also be
stored to or restored from the EEPROM using STAP and RSAP commands. This chapter describes all axis
parameters that can be used on the TMCM-1638 module.
Axis 0 Parameters of the TMCM-1638 Module

Number Axis Parameter Description Range [Units] Default Access
0 adc_I0_raw Raw adc measurement of the 0 . . . 65535 32767 R
phase_A shunt
1 adc_I1_raw Raw adc measurement of the 0 . . . 65535 32767 R
phase_B shunt
2 adc_I0 Calculated current measurement the −32768 . . . 32767 0 R
phase_A shunt and the used offset
3 adc_I1 Calculated current measurement the −32768 . . . 32767 0 R
phase_B shunt and the used offset
4 adc_I2 Calculated current of phase_C from −32768 . . . 32767 0 R
the phase_A and phase_B measure-
ments
5 adc_I0_offset Manually set/get the dual-shunt 0 . . . 65535 32767 RWEX
phase_A offset.
6 adc_I1_offset Manually set/get the dual-shunt 0 . . . 65535 32767 RWEX
phase_B offset.
7 dual shunt Manually adjust the dual shunt cur- 1 . . . 65535 256 RWEX
factor rent measurement factor.
10 motor pole Number of motor poles. 1 . . . 255 4 RWEX
pairs
11 max current Max. allowed absolute motor cur- 0 . . . 60000 [mA] 2000 RWEX
rent. *This value can be temporarily
exceeded marginal due to the opera-
tion of the current regulator.
12 open loop Motor current for controlled commu- 0 . . . 60000 [mA] 2000 RWEX
current tation. This parameter is used in com-
mutation mode 1.
14 motor type Select a commutation mode that fits 0 ...3 0 RWEX
best to your motor’s sensors.
0 - No motor
1 - Single phase DC
2 - Two phase stepper
3 - Three phase BLDC

15 commutation Select a commutation mode that fits 0 ...4 0 RWEX
mode best to your motor’s sensors.
0 - disabled
1 - open loop
2 - digital hall
3 - ABN encoder
16 open loop Actual controlled angle value. −32768 . . . 32767 0 R

commutation
angle
17 encoder Actual encoder angle value. −32768 . . . 32767 0 R
commutation
angle
18 digital hall Actual digital hall angle value. −32768 . . . 32767 0 R
commutation
angle
19 absolute Actual absolute encoder angle value. −32768 . . . 32767 0 R
encoder
commutation
angle
25 commutation Select a commutation mode that fits 0 ...2 0 RWEX
mode position best to your motor’s sensors.
0 - same as foc
1 - ABN encoder
30 target torque Get desired target current or set tar- −60000 . . . 60000 0 RW
get current to activate current regu- [mA]
lation mode. (+= turn motor in right
direction; -= turn motor in left direc-
tion)
31 actual torque The actual motor current. −2147483648 0 R
. . . 2147483647
[mA]
32 target flux Get desired target flux or set tar- −60000 . . . 60000 0 RW
get flux to activate current regulation [mA]
mode.
33 actual flux The actual motor flux. −2147483648 0 R
. . . 2147483647
[mA]
40 target velocity The desired target velocity. −200000 0 RW
. . . 200000 [rpm]
41 ramp velocity The actual velocity of the velocity −2147483648 0 R
ramp used for positioning and veloc- . . . 2147483647
ity mode. [rpm]

42 actual velocity The actual velocity of the motor. −2147483648 0 R
. . . 2147483647
[rpm]
43 max velocity Max. absolute velocity for velocity 0 . . . 200000 4000 RWEX
and positioning mode. [rpm]
44 acceleration Acceleration parameter for ROL, ROR, 0 . . . 100000 2000 RWEX
and the velocity ramp of MVP. [rpm/s]
45 enable velocity An activated ramp allows a defined 0 ...1 1 RWEX
ramp acceleration for velocity and position
mode.
0 - Deactivate velocity ramp genera-
tor.
1 - Activate velocity ramp generator.
50 target position The target position of a currently ex- −2147483648 0 RW
ecuted ramp. . . . 2147483647
51 ramp position The actual position of the position −2147483648 0 R
ramp used for positioning mode. . . . 2147483647
52 actual position The actual position counter. −2147483648 0 RW
. . . 2147483647
53 position Maximum distance at which the posi- 0 . . . 100000 5 RWEX
reached tion end flag is set.
distance
54 position Max. velocity at which end position 0 . . . 200000 500 RWEX
reached flag can be set. Prevents issuing of [rpm]
velocity end position flag when the target is
passed at high velocity.
55 position This flag is set when actual positon 0 ...1 0 R
reached flag and velocity matches target position
window.
0 - Position window not reached
1 - Position window reached
70 torque P P parameter for current PID regula- 0 . . . 32767 0 RWEX
tor
71 torque I I parameter for current PID regulator 0 . . . 32767 0 RWEX
72 velocity P P parameter for velocity PID regula- 0 . . . 32767 0 RWEX
tor
73 velocity I I parameter for velocity PID regulator 0 . . . 32767 0 RWEX
74 position P P parameter for position PID regula- 0 . . . 32767 0 RWEX
tor
75 torque PI error Sum of errors of current PI regulator. −2147483648 0 R
sum . . . 2147483647
76 flux PI error Sum of errors of flux PI regulator. −2147483648 0 R
sum . . . 2147483647

77 velocity PI Sum of errors of velocity PI regulator. −2147483648 0 R
error sum . . . 2147483647
78 torque PI error Error of torque PI regulator. −2147483648 0 R
. . . 2147483647
79 flux PI error Error of flux PI regulator. −2147483648 0 R
. . . 2147483647
80 velocity PI Error of velocity PI regulator. −2147483648 0 R
error . . . 2147483647
81 position PI Error of position PI regulator. −2147483648 0 R
error . . . 2147483647
90 hall polarity Hall sensor polarity. 0 ...1 0 RWEX
0 - standard
1 - inverted
91 hall direction Hall sensor direction. 0 ...1 0 RWEX
0 - standard
1 - inverted
92 hall Hall sensor interpolation. 0 ...1 0 RWEX
interpolation 0 - off
1 - on
93 hall phi_e Offset for electrical angle hall_phi_e −32768 . . . 32767 0 RWEX
offset of hall sensor.
100 encoder steps Encoder steps per full motor rota- 0 . . . 16777215 8192 RWEX
tion.
101 encoder Set the encoder direction in a way, 0 ...1 0 RWEX
direction that ROR increases position counter.
0 - standard
1 - inverted
102 encoder init Select an encoder init mode that fits 0 ...2 1 RWEX
mode best to your motor’s sensors.
0 - estimate offset
2 - use hall
103 encoder init 0 ...3 0 R
state 0 - nothing to do
1 - start_init
2 - wait_init_time
3 - estimate_offset
104 encoder init Duration for encodersine initial- 0 . . . 10000 [ms] 1000 RWEX
delay ization sequence. This parameter
should be set in a way, that the motor
has stopped mechanical oscillations
after the specified time.
105 encoder init Init velocity for encoder initialization −200000 100 RWEX
velocity with encoder N-channel. . . . 200000 [rpm]

106 encoder offset This value represents the internal 0 . . . 65535 0 RWE
commutation offset. (0...max. en-
coder steps per rotation).
107 clear on null Clear the position counter on en- 0 ...1 0 RWEX
coder N channel.
0 - do not clear position counter at
next N channel event
1 - set position counter to zero at next
N channel event
108 clear once Clear the position counter on en- 0 ...1 0 RWEX
coder N channel.
0 - clear position counter always at an
N channel event
1 - set position counter to zero only
once
110 Motor PWM Sets the frequency of the motor 25000 . . . 100000 25000 RWEX
frequency PWM. [Hz]
120 Release brake Controls the external brake of the 0 ...1 0 RW
module.
0 - Brake PWM deactivated.
1 - Brake PWM activated.
121 Brake Controls the duty cycle of the first 0 . . . 100 [%] 75 RWEX
releasing duty PWM phase for releasing the brake.
cycle
122 Brake holding Controls the duty cycle of the second 0 . . . 100 [%] 11 RWEX
duty cycle PWM phase to hold the brake.
123 Brake Controls the duration the brake PWM 0 . . . 65535 [ms] 80 RWEX
releasing uses the first duty cycle.
duration
124 Enable brake Enables the brake functionality 0 ...1 0 RWEX
output 0 - Brake functionality enabled
1 - Brake functionality disabled
125 Invert brake Inverts the brake output 0 ...1 0 RWEX
output 0 - Brake output inverted
1 - Brake output normal
140 enable brake Enable brake chopper functionality. 0 ...1 0 RWE
chopper 0 - Deactivate brake chopper.
1 - Activate brake chopper.
141 brake chopper If the brake chopper is enabled and 50 . . . 600 [0.1V] 260 RWE
voltage limit supply voltage exceeds this value, the
brake chopper output will be acti-
vated.

142 brake chopper An activated brake chopper will be 0 . . . 50 [0.1V] 5 RWE
hysteresis disabled if the actual supply volt-
age is lower than (limit voltage-
hysteresis).
144 brake chopper A value unequal to zero indicates an 0 . . . 600 255 R
active active brake chopper.
156 status flags Actual status flags. 0 ...0 0 R
160 absolute Select the used absolute encoder 0 ...2 0 RWEX
encoder type 0 - disabled
1 - AMT20
2 - AMT23
161 absolute Select the used absolute encoder init 0 ...1 0 RWEX
encoder init mode
0 - estimate offset
1 - use offset
162 absolute Set the absolute encoder direction in 0 ...1 0 RWEX
encoder a way, that ROR increases position
direction counter.
0 - standard
1 - inverted
163 absolute This value represents the internal 0 . . . 65535 0 RWE
encoder offset commutation offset. (0...max. en-
coder steps per rotation).
209 reference REF_L = Bit_1, REF_R = Bit_0 0 ...3 0 RWX
switch enable Bit_x = 1 - Reference switch function-
ality is enabled.
Bit_x = 0 - Reference switch function-
ality is disabled.
210 reference REF_H = Bit_2, REF_L = Bit_1, REF_R = 0 ...7 0 RWX
switch polarity Bit_0
Bit_x = 1 - Reference switch is high ac-
tive.
Bit_x = 0 - Reference switch is low ac-
tive.
211 right reference 0 - Right reference switch deacti- 0 ...1 0 R
switch active vated.
1 - Right reference switch activated.
212 left reference 0 - Left reference switch deactivated. 0 ...1 0 R
switch active 1 - Left reference switch activated.
213 home 0 - Home reference switch deacti- 0 ...1 0 R
reference vated.
switch active 1 - Home reference switch activated.
220 supply voltage The actual supply voltage. 0 . . . 1000 480 R
[100mV]

221 driver The actual temperature of the motor −20 . . . 150 [°C] 0 R
temperature driver.
230 Main loops Main loops per second. 0 . . . 4294967295 0 R
[1/s]
231 Torque loops Torque loops per second. 0 . . . 4294967295 0 R
[1/s]
232 Velocity loops Velocity loops per second. 0 . . . 4294967295 0 R
[1/s]
240 debug value 0 Free used debugging value. −2147483648 0 RW
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
. . . 2147483647
255 enable driver Enables the motor driver (enabled by 0 ...1 0 RW
default)
0 - driver disabled
1 - driver enabled
Table 14: All TMCM-1638 Axis 0 Parameters
5 Global Parameters
The following sections describe all global parameters that can be used with the SGP, GGP, AGP, STGP and
RSGP commands. Global parameters are grouped into banks:
• Bank 0: Global configuration of the module.

• Bank 2: TMCL user variables.
• Bank 3: TMCL interrupt configuration.
5.1 Bank 0
Parameters with numbers from 64 on configure all settings that affect the overall behaviour of a module.
These are things like the serial address, the RS485 baud rate or the CAN bit rate (where appropriate).
Change these parameters to meet your needs. The best and easiest way to do this is to use the appropriate
functions of the TMCL-IDE. The parameters with numbers between 64 and 128 are automatically stored
in the EEPROM.
Note • An SGP command on such a parameter will always store it permanently and
no extra STGP command is needed.
• Take care when changing these parameters, and use the appropriate func-
tions of the TMCL-IDE to do it in an interactive way.
• Some configurations of the interface (for example baud rates that are not
supported by the PC) may leed to the fact that the module cannot be
reached any more. In such a case please see the TMCM-1638 Hardware
Manual on how to reset all parameters to factory default settings.
• Some settings (especially interface bit rate settings) do not take effect im-
mediately. For those settings, power cycle the module after changing them
to make the changes take effect.
There are different parameter access types, like read only or read/write. Table 15 shows the different
parameter access types used in the global parameter tables.
Meaning of the Letters in the Access Column

Access type Command Description
R GGP Parameter readable
W SGP, AGP Parameter writable
E STGP, RSGP Parameter can be stored in the EEPROM
A SGP Automatically stored in the EEPROM
Table 15: Meaning of the Letters in the Access Column
All Global Parameters of the TMCM-1638 Module in Bank 0

Number Global Parameter Description Range [Units] Access
0 9600
1 14400
2 19200
3 28800
65 RS485 baud rate 0. . . 7 RWA
4 38400
5 57600
6 76800
7 115200 Default
66 Serial address Module (target) address for RS485. 1. . . 255 RWA
68 Serial heartbeat Serial heartbeat for RS485 interface and 0. . . 65535 [ms] RWA
USB interface. If this time limit is up and no
further command is received by the mod-
ule the motor will be stopped. Setting this
parameter to 0 (default) turns off the serial
heartbeat function.
2 20kBit/s
3 50kBit/s
4 100kBit/s
69 CAN bit rate 5 125kBit/s 2. . . 8 RWA
6 250kBit/s
7 500kBit/s
8 1000kBit/s (Default)
70 CAN reply ID The CAN ID for replies from the board (de- 0. . . 2047 RWA
fault: 2).
71 CAN ID The module (target) address for CAN (de- 0. . . 2047 RWA
fault: 1).
75 Telegram pause Pause time before the reply via RS485 is 0. . . 255 RWA
time sent. For use with older RS485 interfaces it
is often necessary to set this parameter to
15 or more (e.g. RS485 adapters controlled
by the RTS pin). For CAN interface this pa-
rameter has no effect!
76 Serial host Host address used in the reply telegrams 0. . . 255 RWA
address sent back via RS485.
77 Auto start mode 0 - Do not start TMCL application after 0/1 RWA
power up (default).
1 - Start TMCL application automatically af-
ter power up.

81 TMCL code Protect a TMCL program against disassem- 0/1/2/3 RWA
protection bling or overwriting.
0 - no protection
1 - protection against disassembling
2 - protection against overwriting
3 - protection against disassembling and
overwriting
When switching off the protection
against disassembling (changing this
parameter from 1 or 3 to 0 or 2, the
program will be erased first!
82 CAN heartbeat Heartbeat for CAN interface. If this time 0. . . 65535 [ms] RWA
limit is up and no further command is re-
ceived the motor will be stopped. Setting
this parameter to 0 (default) turns off the
CAN heartbeat function.
83 CAN secondary Second CAN ID for the module. Switched 0. . . 2047 RWA
address off when set to zero.
84 Coordinate 0 - coordinates are stored in RAM only (but 0/1 RWA
storage can be copied explicitly between RAM and
EEPROM)
1 - coordinates are always also stored in the
EEPROM
85 Do not restore Determines if TMCL user variables are to be 0/1 RWA
user variables restored from the EEPROM automatically
on startup.
0 - user variables are restored (default)
1 - user variables are not restored
87 Serial secondary Second module (target) address for RS485. 0. . . 255 RWA
address Setting this parameter to 0 switches off the
seconndary address.
128 TMCL application 0 - stop 0. . . 3 R
status 1 - run
2 - step
3 - reset
129 Download mode 0 - normal mode 0/1 R
1 - download mode
130 TMCL program Contains the address of the currently exe- R
counter cuted TMCL command.
132 TMCL tick timer A 32 bit counter that gets incremented by 0. . . 2147483647 RW
one every millisecond. It can also be reset
to any start value.
133 Random number Returns a random number. The seed value 0. . . 2147483647 RW
can be set by writing to this parameter.

255 Suppress reply The reply in direct mode will be suppressed 0/1 RW
when this parameter is set to 1. This param-
eter cannot be stored to EEPROM and will
be reset to 0 on startup. The reply will not
be suppressed for GAP, GGP and GIO com-
mands.
Table 16: All Global Parameters of the TMCM-1638 Module in Bank 0
5.2 Bank 2
Bank 2 contains general purpose 32 bit variables for use in TMCL applications. They are located in RAM
and the first 56 variables can also be stored permanently in the EEPROM. After booting, their values are
automatically restored to the RAM. Up to 256 user variables are available. Please see table 15 for an
explanation of the different parameter access types.
User Variables in Bank 2

0. . . 55 user variables TMCL user variables -2147483648 . . . RWE
#0. . . #55 2147483647
56. . . 255 user variables TMCL user variables -2147483648 . . . RW
#56. . . #255 2147483647
Table 17: User Variables in Bank 2
5.3 Bank 3
Bank 3 contains interrupt parameters. Some interrupts need configuration (e.g. the timer interval of
a timer interrupt). This can be done using the SGP commands with parameter bank 3 (SGP <type>, 3,
<value>). The priority of an interrupt depends on its number. Interrupts with a lower number have
a higher priority.
Table 18 shows all interrupt parameters that can be set. Please see table 15 for an explanation of the
parameter access types.
Interrupt Parameters in Bank 3

0 Timer 0 period Time between two interrupts 0. . . 4294967295 RW
(ms) [ms]
(ms) [ms]
(ms) [ms]
27 Stop left 0 trigger 0=off, 1=low-high, 2=high-low, 3=both 0. . . 3 RW
transition
28 Stop right 0 0=off, 1=low-high, 2=high-low, 3=both 0. . . 3 RW
trigger transition

39 ADIN0 trigger 0=off, 1=low-high, 2=high-low, 3=both 0. . . 3 RW
transition
41 GPI0 trigger 0=off, 1=low-high, 2=high-low, 3=both 0. . . 3 RW
transition
42 GPI1 trigger 0=off, 1=low-high, 2=high-low, 3=both 0. . . 3 RW
transition
Table 18: Interrupt Parameters in Bank 3
6 Motor Regulation
6.1 Structure of Cascaded Motor Regulation Modes
The TMCM-1638 supports a current, velocity, and position PID regulation mode for motor control in dif-
ferent application areas. These regulation modes are cascaded as shown in Figure 1. Individual modes
are explained in the following subsections.
Figure 1: Cascaded Regulation
6.2 Current Regulation

The current regulation mode uses a FOC current and flux regulator to adjust a desired motor current. The
target current can be set by axis parameter 155. The maximal target current is limited by axis parameter
6. The current regulation uses three basic parameters: The P and I value as well as the timing control
value.
6.2.1 Timing Control Value
The timing control value (current regulation loop multiplier, axis parameter 134) determines how often
the current regulation is invoked. The value is given in multiple of 50µs, following the next formula:
tP IDDELAY = xP IDRLD · 50µs

tP IDDELAY = resulting delay between two current regulation loops
xP IDRLD = current regulation loop multiplier parameter
For most applications it is recommended to leave this parameter unchanged at its default of 1 × 50µs.
Higher values may be necessary for very slow and less dynamic drives.
Figure 2: Current Regulation (See parameter descriptions in Table 19)
6.2.2 Structure of the Current Regulator
Current Regulation Parameters

Parameter Description
IACT U AL Actual motor current (GAP 150)
IT ARGET Target motor current (SAP 155)
IM ax Max. motor current (SAP 6)
eSU M Error sum for integral calculation (GAP 201)
PP ARAM Current P parameter (SAP 172)
IP ARAM Current I parameter (SAP 173)
Table 19: Current Regulation Parameters
6.2.2.1 Parametrizing the Current Regulator Set

In order to parameterize properly the current regulator set, do as follows:
1. Set the P parameter and the I parameter to zero.
2. Start the motor by using a low target current (e.g. 1000mA).
3. Modify the current P parameter. Start from a low value and go to a higher value, until the actual
current nearly reaches 50% of the desired target current.
4. Do the same with the current I parameter.
For all tests, set the motor current limitation to a realistic value, so that your power supply does not
become overloaded during acceleration phases. If your power supply reaches current limitation, the unit
may reset or undetermined regulation results may occur.
6.3 Velocity Regulation

Based on the current regulation the motor velocity can be controlled by the velocity PI regulator.
The velocity PI regulator uses a timing control value (velocity regulation loop multiplier, axis parameter
133) which determines how often the PID regulator is invoked. The value is given in multiple of 50µs,
following the next formula:

tP IDDELAY = resulting delay between two P ID calculations
xP IDRLD = P ID regulation loop delay parameter
For most applications it is recommended to leave this parameter unchanged at its default of 1 × 50µs.
Higher values may be necessary for very slow and less dynamic drives.
6.3.2 Structure of the Velocity Regulator
Figure 3: Velocity Regulation (See parameter descriptions in Table 20)
Velocity Regulation Parameters

VACT U AL Actual motor velocity (GAP 3)
VRAM P GEN Target velocity of ramp generator (SAP 2, GAP 13)
VM ax Max. target velocity (SAP 4)
eSU M Error sum for integral calculation (GAP 229)
PP ARAM Velocity P parameter (SAP 234)
IP ARAM Velocity I parameter (SAP 235)
IM ax Max. target current (SAP 6)
IT ARGET Target current for current PID regulator (GAP 155)
Table 20: Velocity Regulation Parameters
6.3.2.1 Parametrizing the Velocity Regulator Set

In order to parameterize properly the velocity regulator set, do as follows:
1. Set the velocity I parameter to zero.

2. Start the motor by using a medium target velocity (e.g. 2000 rpm).
3. Modify the current P parameter.
(a) Start from a low value and go to a higher value, until the actual motor speed reaches 80 or 90%
of the target velocity.
(b) The lasting 10 or 20% speed difference can be reduced by slowly increasing the velocity I pa-
rameter.
6.4 Velocity Ramp Generator

For a controlled startup of the motor’s velocity, a velocity ramp generator can be activated/deactivated
by axis parameter 146. The ramp generator uses the maximal allowed motor velocity (axis parameter 4),
the acceleration (axis parameter 11) and the desired target velocity (axis parameter 2) to calculate a ramp
generator velocity for the following velocity PI regulator.
6.5 Position Regulation

Based on current and velocity regulators, the TMCM-1638 supports a positioning mode based on encoder
or hall sensor position. During positioning the velocity ramp generator can be activated to enable motor
positioning with controlled acceleration or it can be disabled to support motor positioning with max al-
lowed speed.
The PID regulation uses two basic parameters: the P regulation parameter and a timing control value.
The timing control value PID regulation loop parameter (axis parameter 133) determines how often the
PID regulator is invoked. The value is given in multiple of 50µs, following the next formula:

tP IDDELAY = resulting delay between two position regulation loops
xP IDRLD = P ID regulation loop multiplier parameter
For most applications it is recommended to leave the timing control value unchanged at its default of 1
× 50µs. Higher values may be necessary for very slow and less dynamic drives.
Figure 4: Positioning Regulation (See parameter descriptions in Table 21)
6.5.2 Structure of the Position Regulator
Position Regulation Parameters

nACT U AL Actual motor position (GAP 1)
nT ARGET Target motor position (SAP 0)
PP ARAM Position P parameter (SAP 230)
VM AX Max. allowed velocity (SAP 4)
VT ARGET New target velocity for the ramp generator (GAP 13)
Table 21: Position Regulation Parameters
6.5.2.1 Parametrizing the Position Regulation

Based on the velocity regulator, only the position regulator P has to be parameterized.
In order to parameterize the position regulator, do as follows:
1. Disable the velocity ramp generator and set position P parameter to zero.
2. Choose a target position and increase the position P parameter until the motor reaches the target
position approximately.
3. Switch on the velocity ramp generator. Based on the max. positioning velocity (axis parameter 4)
and the acceleration value (axis parameter 11) the ramp generator automatically calculates the slow
down point, i.e. the point at which the velocity has to be reduced in order to stop at the desired
target position.
4. Reaching the target position is signaled by setting the position end flag.
In order to minimize the time until this flag becomes set, the positioning tolerance MVP target reached
distance can be chosen with axis parameter 10.
Since the motor typically is assumed not to signal target reached when the target was just passed in a
short moment at a high velocity, additionally the maximum target reached velocity (MVP target reached
velocity) can be defined by axis parameter 7.
A value of zero for axis parameter 7 is the most universal, since it implies that the motor stands still at the
target. But when a fast rising of the position end flag is desired, a higher value for the MVP target reached
velocity parameter will save a lot of time. The best value should be tried out in the actual application.
Figure 5: Positioning Algorithm
6.5.3 Correlation of Axis Parameters 10 and 7, the Target Position and the Position End Flag
Depending on motor and mechanics, a low oscillation is normal. This can be reduced to at least +/-1 steps.
Without oscillation the regulation cannot keep the position!
7 TMCL Programming Techniques and Structure

7.1 Initialization
The first task in a TMCL program (like in other programs also) is to initialize all parameters where different
values than the default values are necessary. For this purpose, SAP and SGP commands are used.
7.2 Main Loop

Embedded systems normally use a main loop that runs infinitely. This is also the case in a TMCL appli-
cation that is running stand alone. Normally the auto start mode of the module should be turned on.
After power up, the module then starts the TMCL program, which first does all necessary initializations
and then enters the main loop, which does all necessary tasks end never ends (only when the module is
powered off or reset).
There are exceptions to this, e.g. when TMCL routines are called from a host in direct mode.
So most (but not all) stand alone TMCL programs look like this:
// Initialization
2 SAP 4 , 0 , 50000 // define maximum positioning speed
SAP 5 , 0 , 10000 // define maximum acceleration
4
MainLoop :
6 // do something , in this example just running between two positions
MVP ABS , 0 , 5000
8 WAIT POS , 0 , 0
MVP ABS , 0 , 0
10 WAIT POS , 0 , 0
JA MainLoop // end of the main loop = > run infinitely
7.3 Using Symbolic Constants

To make your program better readable and understandable, symbolic constants should be taken for all
important numerical values that are used in the program. The TMCL-IDE provides an include file with
symbolic names for all important axis parameters and global parameters. Please consider the following
example:
1 // Define some constants

# include TMCLParam . tmc
3 MaxSpeed = 50000
MaxAcc = 10000
5 Position0 = 0
Position1 = 500000
7
// Initialization
9 SAP APMaxPositioningSpeed , Motor0 , MaxSpeed
SAP APMaxAcceleration , Motor0 , MaxAcc
11
MainLoop :
13 MVP ABS , Motor0 , Position1
WAIT POS , Motor0 , 0
15 MVP ABS , Motor0 , Position0
WAIT POS , Motor0 , 0

17 JA MainLoop
Have a look at the file TMCLParam.tmc provided with the TMCL-IDE. It contains symbolic constants that
define all important parameter numbers.
Using constants for other values makes it easier to change them when they are used more than once in
a program. You can change the definition of the constant and do not have to change all occurrences of it
in your program.
7.4 Using Variables

The user variables can be used if variables are needed in your program. They can store temporary values.
The commands SGP, GGP and AGP as well as STGP and RSGP are used to work with user variables:
• SGP is used to set a variable to a constant value (e.g. during initialization phase).
• GGP is used to read the contents of a user variable and to copy it to the accumulator register for
further usage.
• AGP can be used to copy the contents of the accumulator register to a user variable, e.g. to store
the result of a calculation.
• The STGP command stores the contents of a user varaible in the EEPROM.
• The RSGP command copies the value stored in the EEPROM back to the user variable.
• Global parameter 85 controls if user variables will be restored from the EEPROM automatically on
startup (default setting) or not (user variables will then be initialized with 0 instead).
Please see the following example:

1 MyVariable = 42
// Use a symbolic name for the user variable
3 // ( This makes the program better readable and understandable .)
5 SGP MyVariable , 2 , 1234 // Initialize the variable with the value 1234
...
7 ...
GGP MyVariable , 2 // Copy contents of variable to accumulator register
9 CALC MUL , 2 // Multiply accumulator register with two
AGP MyVariable , 2 // Store contents of accumulator register to variable
11 ...
...
Furthermore, these variables can provide a powerful way of communication between a TMCL program
running on a module and a host. The host can change a variable by issuing a direct mode SGP command
(remember that while a TMCL program is running direct mode commands can still be executed, without
interfering with the running program). If the TMCL program polls this variable regularly it can react on
such changes of its contents.
The host can also poll a variable using GGP in direct mode and see if it has been changed by the TMCL
program.
7.5 Using Subroutines

The CSUB and RSUB commands provide a mechanism for using subroutines. The CSUB command branches
to the given label. When an RSUB command is executed the control goes back to the command that fol-
lows the CSUB command that called the subroutine.
This mechanism can also be nested. From a subroutine called by a CSUB command other subroutines
can be called. In the current version of TMCL eight levels of nested subroutine calls are allowed.
7.6 Combining Direct Mode and Standalone Mode

Direct mode and standalone mode can also be combined. When a TMCL program is being executed in
standalone mode, direct mode commands are also processed (and they do not disturb the flow of the
program running in standalone mode). So, it is also possible to query e.g. the actual position of the motor
in direct mode while a TMCL program is running.
Communication between a program running in standalone mode and a host can be done using the TMCL
user variables. The host can then change the value of a user variable (using a direct mode SGP command)
which is regularly polled by the TMCL program (e.g. in its main loop) and so the TMCL program can react
on such changes. Vice versa, a TMCL program can change a user variable that is polled by the host (using
a direct mode GGP command).
A TMCL program can be started by the host using the run command in direct mode. This way, also a
set of TMCL routines can be defined that are called by a host. In this case it is recommended to place JA
commands at the beginning of the TMCL program that jump to the specific routines. This assures that
the entry addresses of the routines will not change even when the TMCL routines are changed (so when
changing the TMCL routines the host program does not have to be changed).
Example:
// Jump commands to the TMCL routines
2 Func1 : JA Func1Start
Func2 : JA Func2Start
4 Func3 : JA Func3Start
6 Func1Start :
MVP ABS , 0 , 1000
8 WAIT POS , 0 , 0
MVP ABS , 0 , 0
10 WAIT POS , 0 , 0
STOP
12
Func2Start :
14 ROL 0 , 500
16 MST 0
STOP
18
Func3Start :
20 ROR 0 , 1000
22 MST 0
STOP
This example provides three very simple TMCL routines. They can be called from a host by issuing a run
command with address 0 to call the first function, or a run command with address 1 to call the second
function, or a run command with address 2 to call the third function. You can see the addresses of the
TMCL labels (that are needed for the run commands) by using the ”Generate symbol file function” of the
TMCL-IDE.
7.7 Make the TMCL Program start automatically

For stand-alone operation the module has to start the TMCL program in its memory automatically after
power-on. In order to achieve this, switch on the Autostart option of the module. This is controlled by
global parameter #77. There are different ways to switch on the Autostart option:
• Execute the command SGP 77, 0, 1 in direct mode (using the Direct Mode tool in the TMCL-IDE).
• Use the Global Parameters tool in the TMCL-IDE to set global parameter #77 to 1.
• Use the Autostart entry in the TMCL menu of the TMCL Creator in the TMCL-IDE. Go to the Autostart
entry in the TMCL menu and select "’On"’.
8 Figures Index
1 Cascaded Regulation . . . . . . . . . . 97 4 Positioning Regulation . . . . . . . . . 101
2 Current Regulation . . . . . . . . . . . 98 5 Positioning Algorithm . . . . . . . . . 102
3 Velocity Regulation . . . . . . . . . . . 99
9 Tables Index
1 TMCL Command Format . . . . . . . . 9 14 All TMCM-1638 Axis 0 Parameters . . 91
2 TMCL Reply Format . . . . . . . . . . . 10 15 Meaning of the Letters in the Access
3 TMCL Status Codes . . . . . . . . . . . 10 Column . . . . . . . . . . . . . . . . . . 92
4 Overview of all TMCL Commands . . . 13 16 All Global Parameters of the TMCM-
5 Motion Commands . . . . . . . . . . . 14 1638 Module in Bank 0 . . . . . . . . . 95
6 Parameter Commands . . . . . . . . . 14 17 User Variables in Bank 2 . . . . . . . . 95
7 Branch Commands . . . . . . . . . . . 15
18 Interrupt Parameters in Bank 3 . . . . 96
8 I/O Port Commands . . . . . . . . . . 15
19 Current Regulation Parameters . . . . 98
9 Calculation Commands . . . . . . . . 15
10 Interrupt Processing Commands . . . 16 20 Velocity Regulation Parameters . . . . 99
11 Interrupt Vectors . . . . . . . . . . . . 17 21 Position Regulation Parameters . . . 101
12 New TMCL Commands . . . . . . . . . 18 22 Firmware Revision . . . . . . . . . . . 111
13 TMCL Control Commands . . . . . . . 84 23 Document Revision . . . . . . . . . . . 111
10 Supplemental Directives
10.1 Producer Information
10.2 Copyright
TRINAMIC owns the content of this user manual in its entirety, including but not limited to pictures, logos,
trademarks, and resources. © Copyright 2021 TRINAMIC. All rights reserved. Electronically published by
TRINAMIC, Germany.
Redistributions of source or derived format (for example, Portable Document Format or Hypertext Markup
Language) must retain the above copyright notice, and the complete Datasheet User Manual documen-
tation of this product including associated Application Notes; and a reference to other available product-
related documentation.
10.3 Trademark Designations and Symbols

Trademark designations and symbols used in this documentation indicate that a product or feature is
owned and registered as trademark and/or patent either by TRINAMIC or by other manufacturers, whose
products are used or referred to in combination with TRINAMIC’s products and TRINAMIC’s product doc-
umentation.
This TMCL™ Firmware Manual is a non-commercial publication that seeks to provide concise scientific
and technical user information to the target user. Thus, trademark designations and symbols are only
entered in the Short Spec of this document that introduces the product at a quick glance. The trademark
designation /symbol is also entered when the product or feature name occurs for the first time in the
document. All trademarks and brand names used are property of their respective owners.
10.4 Target User

The documentation provided here, is for programmers and engineers only, who are equipped with the
necessary skills and have been trained to work with this type of product.
The Target User knows how to responsibly make use of this product without causing harm to himself or
others, and without causing damage to systems or devices, in which the user incorporates the product.
10.5 Disclaimer: Life Support Systems

TRINAMIC Motion Control GmbH & Co. KG does not authorize or warrant any of its products for use in
life support systems, without the specific written consent of TRINAMIC Motion Control GmbH & Co. KG.
Life support systems are equipment intended to support or sustain life, and whose failure to perform,
when properly used in accordance with instructions provided, can be reasonably expected to result in
personal injury or death.
Information given in this document is believed to be accurate and reliable. However, no responsibility
is assumed for the consequences of its use nor for any infringement of patents or other rights of third
parties which may result from its use. Specifications are subject to change without notice.
10.6 Disclaimer: Intended Use

The data specified in this user manual is intended solely for the purpose of product description. No rep-
resentations or warranties, either express or implied, of merchantability, fitness for a particular purpose
or of any other nature are made hereunder with respect to information/specification or the products to
which information refers and no guarantee with respect to compliance to the intended use is given.
In particular, this also applies to the stated possible applications or areas of applications of the product.
TRINAMIC products are not designed for and must not be used in connection with any applications where
the failure of such products would reasonably be expected to result in significant personal injury or death
(safety-Critical Applications) without TRINAMIC’s specific written consent.
TRINAMIC products are not designed nor intended for use in military or aerospace applications or environ-
ments or in automotive applications unless specifically designated for such use by TRINAMIC. TRINAMIC
conveys no patent, copyright, mask work right or other trade mark right to this product. TRINAMIC as-
sumes no liability for any patent and/or other trade mark rights of a third party resulting from processing
or handling of the product and/or any other use of the product.
10.7 Collateral Documents & Tools

This product documentation is related and/or associated with additional tool kits, firmware and other
items, as provided on the product page at: www.trinamic.com.
11 Revision History
11.1 Firmware Revision
Version Date Author Description

V1.09 2020-JUL-23 ED First release.
Table 22: Firmware Revision
11.2 Document Revision
Version Date Author Description

V1.00 2020-JUL-23 OK First release.
V1.01 05-FEB-2021 OK Removed superfluous RFS option in WAIT command description.
Table 23: Document Revision

TMCM-1638-TMCL Firmware Manual fw1.09 Rev1.01

Uploaded by

Copyright:

Available Formats

TMCM-1638-TMCL Firmware Manual fw1.09 Rev1.01

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

TMCM-1638-TMCL Firmware Manual fw1.09 Rev1.01

Uploaded by

Copyright:

Available Formats

Module for Stepper MODULE

TMCM-1638 TMCL™ Firmware Manual

• Laboratory Automation • Robotics • Life Science

Simpliﬁed Block Diagram

Read entire documentation.

2 First Steps with TMCL 6

3 TMCL and the TMCL-IDE — An Introduction 8

3.6.30 RETI (Return from Interrupt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

7 TMCL Programming Techniques and Structure 103

8 Figures Index 107

9 Tables Index 108

10 Supplemental Directives 109

10.1 Producer Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

11 Revision History 111

2 First Steps with TMCL

Things that you will need

2.1 Basic Setup

2.2 Using the TMCL Direct Mode

2.3 Testing with a simple TMCL Program

1 SAP 5 , 0 , 33911 // set ADC offsets

SAP 53 , 0, 1000 // set position reached distance

9 SAP 15 , 0 , 2 // switch to encoder mode

11 ROR 0 , 200 // rotate motor

// clear position counter on next encoder -N - Channel event

3 TMCL and the TMCL-IDE — An Introduction

3.1 Binary Command Format

TMCL Command Format

Table 1: TMCL Command Format

3.1.1 Checksum Calculation

4 // Set the Command array to the desired command

Command [8]= Checksum ; // insert checksum as last byte of the command

Checksum calculation in Delphi:

// Set the Command array to the desired command

// Calculate the Checksum :

3.2 Reply Format

TMCL Reply Format

Table 2: TMCL Reply Format

3.2.1 Status Codes

TMCL Status Codes

Table 3: TMCL Status Codes

3.3 Standalone Applications

3.4 TMCL Command Overview

Overview of all TMCL Commands

Command Number Parameter Description

Table 4: Overview of all TMCL Commands

3.5 TMCL Commands by Subject

3.5.1 Motion Commands

Table 5: Motion Commands

3.5.2 Parameter Commands

Table 6: Parameter Commands

3.5.3 Branch Commands

Table 7: Branch Commands

3.5.4 I/O Port Commands

I/O Port Commands

Table 8: I/O Port Commands

3.5.5 Calculation Commands

Table 9: Calculation Commands

be loaded from the accumulator.

Please see also chapter 3.5.7 for more calculation commands.