PMD Atlas Compact, Complete Technical Reference

Page: 116 / 188

116
Atlas® Digital Amplifier Complete Technical Reference
6
GetTraceStatus BA h
Syntax
GetTraceStatus
Motor Types
Arguments
None
Returned data
Name Type
see below unsigned 16 bits
Packet
Structure
Description
GetTraceStatus returns the trace status. The definitions of the individual status bits are as follows:
The Data Wrap and Overrun bits are cleared when trace goes from being off (Activity 0) to on
(Activity 1), because of the detection of the programmed trace start condition.
Restrictions
see
Set/GetTraceMode ( p. 148 )
,
Set/Get Trace Start ( p. 150 )
,
Set/Get Trace Stop ( p. 151 )
DC Brush Brushless DC Microstepping
GetTraceStatus
checksum BA h
15 8 7 0
Data
read Trace Status
15 0
Name Bit Number Description
Roll 0 Set to 0 when trace is in one-time mode, 1 when in rolling mode.
Activity 1 Set to 1 when trace is active (currently tracing), 0 if trace is stopped
either because of a command or filling the trace buffer.
Data Wrap 2 Set to 1 when trace has filled the buffer; when in rolling mode trace
will then write at the beginning of the buffer, and data may be lost.
Overrun 3 Set to 1 when a trace buffer location has been written before the
previously written value was read from buffer 0. If all trace reads are
done using buffer 0 this bit indicates that data has been lost.
Not Empty 4 Set to 1 when a trace buffer location has been written but has not
been read from buffer 0. If all trace reads are done using buffer 0 this
bit indicates that new trace data is available.
Command 5 Set to 1 when trace has been turned on by the controlling processor.
In internal trigger mode this means that the last torque command
had the trace bit set; in external trigger mode it means that at least
one torque command had the trace bit set since trace activity was
cleared by SetTraceMode
6-7 (Reserved)
Trigger 8 Clear means internal trigger mode, a set of trace samples is taken
based on the Atlas internal clock and the Trace Period register. Set
means external trigger mode, exactly one set of trace samples is
taken whenever a torque command with the trace bit set is received
9-15 (Reserved)