User Manual
Table Of Contents
- 1 Features
- 2 First Steps with TMCL
- 3 TMCL and the TMCL-IDE — An Introduction
- 3.1 Binary Command Format
- 3.2 Reply Format
- 3.3 Standalone Applications
- 3.4 TMCL Command Overview
- 3.5 TMCL Commands by Subject
- 3.6 Detailed TMCL Command Descriptions
- 3.6.1 ROR (Rotate Right)
- 3.6.2 ROL (Rotate Left)
- 3.6.3 MST (Motor Stop)
- 3.6.4 MVP (Move to Position)
- 3.6.5 SAP (Set Axis Parameter)
- 3.6.6 GAP (Get Axis Parameter)
- 3.6.7 SGP (Set Global Parameter)
- 3.6.8 GGP (Get Global Parameter)
- 3.6.9 STGP (Store Global Parameter)
- 3.6.10 RSGP (Restore Global Parameter)
- 3.6.11 RFS (Reference Search)
- 3.6.12 SIO (Set Output)
- 3.6.13 GIO (Get Input)
- 3.6.14 CALC (Calculate)
- 3.6.15 COMP (Compare)
- 3.6.16 JC (Jump conditional)
- 3.6.17 JA (Jump always)
- 3.6.18 CSUB (Call Subroutine)
- 3.6.19 RSUB (Return from Subroutine)
- 3.6.20 WAIT (Wait for an Event to occur)
- 3.6.21 STOP (Stop TMCL Program Execution – End of TMCL Program)
- 3.6.22 SCO (Set Coordinate)
- 3.6.23 GCO (Get Coordinate)
- 3.6.24 CCO (Capture Coordinate)
- 3.6.25 ACO (Accu to Coordinate)
- 3.6.26 CALCX (Calculate using the X Register)
- 3.6.27 AAP (Accu to Axis Parameter)
- 3.6.28 AGP (Accu to Global Parameter)
- 3.6.29 CLE (Clear Error Flags)
- 3.6.30 EI (Enable Interrupt)
- 3.6.31 DI (Disable Interrupt)
- 3.6.32 VECT (Define Interrupt Vector)
- 3.6.33 RETI (Return from Interrupt)
- 3.6.34 Customer specific Command Extensions (UF0…UF7 – User Functions)
- 3.6.35 Request Target Position reached Event
- 3.6.36 TMCL Control Commands
- 4 Axis Parameters
- 5 Global Parameters
- 6 Hints and Tips
- 7 TMCL Programming Techniques and Structure
- 8 Figures Index
- 9 Tables Index
- 10 Supplemental Directives
- 11 Revision History

TMCM-3212 TMCL
™
Firmware Manual • Firmware Version V1.07 | Document Revision V1.04 • 2017-JUN-08
76 / 103
Number Axis Parameter Description Range [Units] Access
168 smartEnergy
current
minimum
(SEIMIN)
Sets the lower motor current limit for coolStep
operation by scaling the maximum current (see
axis parameter 6) value.
Minimum motor current:
0 -
1
2
of CS
1 -
1
4
of CS
0/1 RW
169 smartEnergy
current down
step
Sets the number of stallGuard2 readings above
the upper threshold necessary for each current
decrement of the motor current. Number of
stallGuard2 measurements per decrement:
Scaling: 0. . . 3: 32, 8, 2, 1
0: slow decrement
3: fast decrement
0. . . 3 RW
170 smartEnergy
hysteresis
Sets the distance between the lower and the
upper threshold for stallGuard2 reading. Above
the upper threshold the motor current becomes
decreased. Hysteresis: ([AP 172] + 1) ∗ 32
Upper stallGuard threshold: ([
AP
172]+[
AP
170]+
1) ∗ 32
0. . . 15 RW
171 smart Energy
current up step
Sets the current increment step. The current
becomes incremented for each measured stall-
Guard2 value below the lower threshold see
smartEnergy hysteresis start). Current incre-
ment step size:
Scaling: 0. . . 3: 1, 2, 4, 8
0: slow increment
3: fast increment / fast reaction to rising load
0. . . 3 RW
172 smart Energy
hysteresis start
The lower threshold for the stallGuard2 value
(see smart Energy current up step).
0..15 RW
173 stallGuard2
filter enable
Enables the stallGuard2 filter for more precision
of the measurement. If set, reduces the mea-
surement frequency to one measurement per
four fullsteps. In most cases it is expedient to
set the filtered mode before using coolStep. Use
the standard mode for step loss detection.
0 - standard mode
1 - filtered mode
0/1 RW
174 stallGuard2
threshold
This signed value controls stallGuard2 threshold
level for stall output and sets the optimum mea-
surement range for readout. A lower value gives
a higher sensitivity. Zero is the starting value.
A higher value makes stallGuard2 less sensitive
and requires more torque to indicate a stall.
-64. . . +63 RW
©2017 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.