RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
281
innovators for industry
Ctrl Command get_status
Function
returns the current list execution status (BUSY, INTERNAL-BUSY and PAUSED) and the
current (or most recent) position of the output pointer.
Call
get_status( &Status, &Pos )
Returned
parameter
values
Status
status value as a pointer to an unsigned 32-bit value
Bit #0 (LSB)
= 1:
BUSY status set
Bit #1 … Bit #6
Reserved
Bit #7
= 1:
INTERNAL-BUSY status set
Bit #8 … Bit #14
Reserved
Bit #15 = 1:
PAUSED
status
set
Bit #16 … Bit #31
0
Pos
current (or most recent) position of the output pointer (absolute memory
address) as a pointer to an unsigned 32-bit value
Comments
• For a description of when the BUSY, INTERNAL-BUSY or PAUSED status values are set or
not set, see
"List Execution Status", page 73
.
• (BUSY and PAUSED set) requires
for continuation, (BUSY not set and
PAUSED set) requires
and (both BUSY and PAUSED not set) requires
. “Continuation” is not allowed with (BUSY set and PAUSED not set)
and a currently running list. An improper continuation will generate the
return code
RTC5_BUSY
. With (INTERNAL-BUSY set),
are only executed with a delay (after INTERNAL-BUSY has been reset again).
• The output pointer points to the command (in “List 1” or “List 2”) currently being
executed or most recently executed. If, during processing of a subroutine in the
protected buffer area (“List 3”), the output pointer’s position
Pos
is queried, then the
position will be returned of
the
list command in the list area (“List 1” or “List 2”) in
which the output pointer most recently resided (typically from where the subroutine
was called (e.g. with
). The commands
leave
Pos
unchanged.
•
get_status
returns the output pointer’s position as an absolute memory address (offset
relative to the start of “List 1”). The relative position referenced to the start of the
respective list area can be queried via
• The current input pointer position can be queried via
• List status values for individual lists (see
) can be queried via
.
• The commands
get_status
,
and
can be used during
loading of a list to ensure that no list will be overwritten that has still not been
processed (also see the
command).
• As long as no program has been loaded (via
get_status
returns
undefined values.
• The command
is available for querying the status signals
of the
scan heads
.
RTC
®
4
RTC
®
5 essentially unchanged functionality, however:
The Parameter
Status
returns the BUSY, INTERNAL-BUSY
and
PAUSED status with an
RTC
®
5, whereas only the BUSY status with an RTC
®
4.
References