Scanlab RTC6 PCIe Board - Set_Start_List_Pos

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
747
innovators for industry
Ctrl Command set_start_list_pos
Function Opens the RTC6 List Memory for writing of list commands and sets the input pointer to
the specified relative position in the specified list (“List 1” or “List 2”).
Call set_start_list_pos( ListNo, Pos )
Parameters ListNo Number of the list for which the input pointer should be set.
As an unsigned 32-bit value.
Allowed values: [uneven: “List 1“, even: “List 2“].
Pos Position of the input pointer (offset relative to the start of the respective list).
As an unsigned 32-bit value.
Allowed value range: [0…(2
23
–1)].
Comments • The next list command is stored at the specified address and all further list commands
at the subsequent addresses in the selected list.
• The specified list is unconditionally opened for loading. There is no checking of
whether the list is currently being processed, see also Chapter 6.4.1 ”Loading Lists”,
page 105 and load_list.
• The input pointer cannot be set to the protected RTC6 List Memory area “List 3”. If the
protected area is to be written to (at the full risk of users) with set_start_list_pos, then
this area can be temporarily allocated to “List 2” by config_list( Mem1, –1 ) .
After writing, configuration of the area’s protection should be restored:
config_list( Mem1, Mem2 ) .
• For uneven ListNo values, “List 1“ is opened, otherwise “List 2“. This facilitates
continuous automatic list changing though incrementing counts.
• If “List 2” has not been assigned memory ( Mem2 = 0, see config_list) then “List 1“ is
opened.
• If Pos is specified as being larger than the memory area of the respective list ( Pos > Mem1
or Pos > Mem2 ), then Pos is set to 0.
• The status values of the selected list (see also read_status) are set as follows:
LOAD list status set, READY list status reset, USED list status reset. The LOAD list status
of the other corresponding list is reset.
• set_start_list_pos triggers a flush of the buffered list input, see Chapter 6.4.1
”Loading Lists”, page 105.
• set_start_list_pos also covers the specialized variants set_start_list_1,
set_start_list_2, set_start_list and set_input_pointer.
• Caution! If the end of the respective RT
C6 List Memory area is reached,
the list
input pointer is automatically reset to the start of the same RTC6 List Memory area.
Make sure not to overwrite any commands still needed by your user program.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References execute_list_pos, read_status