Scanlab RTC6 PCIe Board - Auto_Change_Pos

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
336
innovators for industry
Ctrl Command auto_change_pos
Function Activates a one-time automatic list change and simultaneously defines the list position at
which execution continues.
Call auto_change_pos( Pos )
Parameters Pos Start position (RTC6 List Memory address) as an offset referenced to the
beginning of the list to be started by the automatic list change.
As an unsigned 32-bit value.
Comments • auto_change_pos triggers a subsequent one-time-only list change or a list new start.
For further list changes or list new starts, auto_change_pos must be called again.
• auto_change_pos can be called at any time.
• If the automatic list change is activated during processing of a list, then upon reaching
set_end_of_list execution continues without delay at the supplied start position of the
other list. If there is only one list ( Mem2 = 0, see config_list), then upon reaching
set_end_of_list execution continues at the supplied start position of this list.
• During processing of a list, the other list (and also the current list) can be newly loaded,
see Chapter 6.4.6 ”Changing Lists Automatically”, page 110.
• So that auto_change_pos can function at all, any already active list must absolutely
be finalized by set_end_of_list; the new list should already be loaded and the
input pointer should be sufficiently ahead of the output pointer (otherwise, “old”
commands are executed). If, during list execution, the end of the list is reached without
encountering a set_end_of_list, then execution automatically continues at the
beginning of the current list.
• If an automatic list change is activated when no list is currently being processed, then
checking takes place as to whether a list has been already processed and the other list
has been started (at the supplied start position). If no list has been previously executed,
then “List 1” is regarded as already executed (initialization) and “List 2” is started.
• If a RTC6 List Memory address outside the corresponding list area is supplied
(depending on which list should be started: Pos  Mem1 or Pos  Mem2 ), then the start
position is set to the beginning of the list ( Pos = 0).
• If, during processing of a list, the auto_change_pos( Pos > 0 ) and start_loop are
called, then upon the next set_end_of_list the command auto_change_pos( Pos > 0 )
is executed; and at the next one the start_loop command is executed.