DMC-18x6 Command Reference
201
TR
FUNCTION: Trace
DESCRIPTION:
The TR command causes each instruction in a program to be sent out the communications port
prior to execution. TR1 enables this function and TR0 disables it. The trace command is
useful in debugging programs.
ARGUMENTS: TR n, m
where
n = 0 Disables the trace function
n = 1 Enables the trace function
m is an integer between 0 and 255 and designates which threads to trace. A binary weighted bit is
set per thread. Thread 0=1, Thread 1=2, Thread 2=4 ... Thread 7 =128. The default is 255 (all
threads)
The least significant bit represents thread 0 and the most significant bit represents thread 7. The
decimal value can be calculated by the following formula.
n = n
0
+ 2*n
1
+ 4*n
2
+ 8*n
3
+16* n
4
+32* n
5
+64* n
6
+128* n
7
where n
x
represents the thread. To turn tracing on for a thread, substitute a one into that n
x
in the
formula. If the n
x
value is a zero, then tracing will be off for that thread. For example, if
threads 3 and 4 are to be traced, TR24 is issued.
USAGE: DEFAULTS:
While Moving
Yes
Default Value
TR0,255
In a Program
Yes
Default Format
--
Command Line
Yes
Controller Usage
ALL CONTROLLERS
RELATED COMMANDS:
Set/clear most significant bit
EXAMPLES:
:ED ;'define a small looping program
0 #L
1 WT1000
2 JP#L
3
<control>q
:XQ ;'run the program
:TR1 ;'turn the trace on
:2 JP#L
0 #L
1 WT1000
2 JP#L
0 #L
1 WT1000
TR0 ;'turn the trace off
