User manual

TMCM-1141 TMCL Firmware V1.19 Manual (Rev. 1.01 / 2012-JUL-27) 20
www.trinamic.com
3.5 The ASCII Interface
There is also an ASCII interface that can be used to communicate with the module and to send some
commands as text strings.
THE FOLLOWING COMMANDS CAN BE USED IN ASCII MODE:
ROL, ROR, MST, MVP, SAP, GAP, STAP, RSAP, SGP, GGP, STGP, RSGP, RFS, SIO, GIO, SCO, GCO, CCO, UF0, UF1,
UF2, UF3, UF4, UF5, UF6, and UF7.
Note:
Only direct mode commands can be entered in ASCII mode!
SPECIAL COMMANDS WHICH ARE ONLY AVAILABLE IN ASCII MODE:
- BIN: This command quits ASCII mode and returns to binary TMCL™ mode.
- RUN: This command can be used to start a TMCL™ program in memory.
- STOP: Stops a running TMCL™ application.
ENTERING AND LEAVING ASCII MODE:
1. The ASCII command line interface is entered by sending the binary command 139 (enter ASCII mode).
2. Afterwards the commands are entered as in the TMCL-IDE.
3. For leaving the ASCII mode and re-enter the binary mode enter the command BIN.
3.5.1 Format of the Command Line
As the first character, the address character has to be sent. The address character is A when the module
address is 1, B for modules with address 2 and so on. After the address character there may be spaces
(but this is not necessary). Then, send the command with its parameters. At the end of a command line a
<CR> character has to be sent.
EXAMPLES FOR VALID COMMAND LINES:
AMVP ABS, 1, 50000
A MVP ABS, 1, 50000
AROL 2, 500
A MST 1
ABIN
The command lines above address the module with address 1. To address e.g. module 3, use address
character C instead of A. The last command line shown above will make the module return to binary
mode.
3.5.2 Format of a Reply
After executing the command the module sends back a reply in ASCII format.
The reply consists of:
- the address character of the host (host address that can be set in the module)
- the address character of the module
- the status code as a decimal number
- the return value of the command as a decimal number
- a <CR> character
So, after sending AGAP 0, 1 the reply would be BA 100 –5000 if the actual position of axis 1 is –5000, the
host address is set to 2 and the module address is 1. The value 100 is the status code 100 that means
command successfully executed.