User manual

PD-1141 TMCL Firmware V1.19 Manual (Rev. 1.01 / 2012-JUL-27) 61
www.trinamic.com
3.6.38 TMCL Control Functions
The following functions are for host control purposes only and are not allowed for standalone mode.
In most cases, there is no need for the customer to use one of those functions (except command 139).
TMCL control commands have no mnemonics, as they cannot be used in TMCL programs. These Functions
are to be used only by the TMCL-IDE (e.g. to download a TMCL application into the module).
CONTROL COMMANDS THAT COULD BE USEFUL FOR A USER HOST APPLICATION ARE:
- get firmware revision (command 136, please note the special reply format of this command,
described at the end of this section)
- run application (command 129)
All other functions can be achieved by using the appropriate functions of the TMCL-IDE!
Instruction
Description
Type
Mot/Bank
Value
128 – stop application
a running TMCL standalone
application is stopped
(don't care)
(don't care)
(don't care)
129 – run application
TMCL execution is started (or
continued)
0 - run from
current address
1 - run from
specified address
(don't care)
(don't care)
starting address
130 – step application
only the next command of a
TMCL application is executed
(don't care)
(don't care)
(don't care)
131 – reset application
the program counter is set to
zero, and the standalone
application is stopped (when
running or stepped)
(don't care)
(don't care)
(don't care)
132 – start download
mode
target command execution is
stopped and all following
commands are transferred to
the TMCL memory
(don't care)
(don't care)
starting address
of the
application
133 – quit download
mode
target command execution is
resumed
(don't care)
(don't care)
(don't care)
134 – read TMCL
memory
the specified program memory
location is read
(don't care)
(don't care)
<memory
address>
135 – get application
status
one of these values is
returned:
0 – stop
1 – run
2 – step
3 – reset
(don't care)
(don't care)
(don't care)
136 – get firmware
version
return the module type and
firmware revision either as a
string or in binary format
0 – string
1 – binary
(don’t care)
(don’t care)
137 – restore factory
settings
reset all settings stored in the
EEPROM to their factory
defaults
This command does not send
back a reply.
(don’t care)
(don’t care)
must be 1234