RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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
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 restart_list for continuation, (BUSY not set and
PAUSED set) requires release_wait and (both BUSY and PAUSED not 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 get_last_error
return code
RTC5_BUSY
. With (INTERNAL-BUSY set), release_wait and execute_list_pos
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 pause_list and set_wait 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 get_out_pointer.
• The current input pointer position can be queried via get_input_pointer or
get_list_pointer.
• List status values for individual lists (see "List Status", page 72) can be queried via
read_status.
• The commands get_status, get_input_pointer and read_status 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 load_list command).
• As long as no program has been loaded (via load_program_file), get_status returns
undefined values.
•The command get_head_status (page 266) 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 read_status, get_input_pointer, get_list_pointer, get_out_pointer
To Next Page
Loading...
