Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 281

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
Status
parameter
values
Pos
Comments • For a description of when the BUSY, INTERNAL-BUSY or PAUSED status values are set or
not set, see
• (BUSY and PAUSED set) requires
PAUSED set) requires
execute_list_pos. "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 list_call). The commands
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 get_out_pointer.
• The current input pointer position can be queried via
get_list_pointer.
• List status values for individual lists (see
read_status.
• The commands get_status,
loading of a list to ensure that no list will be overwritten that has still not been
processed (also see the
• As long as no program has been loaded (via load_program_file), get_status returns
undefined values.
• The command
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
References read_status, get_input_pointer, get_list_pointer,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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
current (or most recent) position of the output pointer (absolute memory
address) as a pointer to an unsigned 32-bit value
"List Execution Status", page
restart_list
release_wait and (both BUSY and PAUSED not set) requires
get_input_pointer
load_list command).
get_head_status (page 266)
73.
for continuation, (BUSY not set and
release_wait and
pause_list and set_wait
get_input_pointer
"List Status", page 72) can be queried via
and read_status can be used during
is available for querying the status signals
®
4.
get_out_pointer
get_last_error
execute_list_pos
leave Pos
or
281