Scanlab RTC6 PCIe Board - Config_List

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
344
innovators for industry
Ctrl Command config_list
Function Configures the RTC6 List Memory, that is, assigns specific memory locations to the
RTC6 List Memory areas.
Call config_list( Mem1, Mem2 )
Parameters Mem1 Storage positions for RTC6 List Memory area “List 1”.
As an unsigned 32-bit value.
Mem2 Storage positions for RTC6 List Memory area “List 2”.
As an unsigned 32-bit value.
Comments • The RTC6 List Memory features 8,388,608 (= 2
23
) storage positions in total.
They can be divided into three areas (“lists”) by config_list. The sizes of “List 1” and
“List 2” are specified by the parameters Mem1 and Mem2 . All remaining storage positions
not assigned to “List 1” or “List 2” are automatically assigned by config_list to the
protected RTC6 List Memory area “List 3”.
• The following rules apply to the parameters Mem1 and Mem2 (invalid values
are automatically corrected in the specified order):
– Mem1 > 0 (“List 1” must not be empty).
Mem1 = 0 is corrected to Mem1 = 1.
– Mem1  2
23
(“List 1” can contain a maximum of 2
23
storage positions).
Mem1 > 2
23
is corrected to Mem1 = 2
23
.
– Mem1 = ”–1” is interpreted as Mem1 = (2
32
–1) and corrected to Mem1 = 2
23
.
Example: With config_list( –1, x ) where x is any value (also x = –1), “List 1” is
automatically assigned the entire RTC6 List Memory ( Mem1 = 2
23
, Mem2 = 0, no
memory for “List 3”).
– Mem2  2
23
– Mem1 (“List 2” can maximally receive the “rest” of RTC6 List Memory).
Mem2 = 0 is allowed.
Mem2 > 2
23
– Mem1 is corrected to Mem2 = 2
23
– Mem1 .
– Mem2 = ”–1” is interpreted as Mem2 = (2
32
–1) and corrected to
Mem2 = 2
23
– Mem1 .
Example: With config_list( Mem1, –1 ) , “List 2” is automatically
assigned with the “rest” of RTC6 List Memory ( Mem2 = 2
23
– Mem1 , no memory for
“List 3”).
– Storage positions for “List 3”: 2
23
– Mem1 – Mem2 .
• The RTC6 List Memory features 8,388,608 (= 2
23
) storage positions in total.
By default, it is preconfigured so that “List 1” and “List 2” can each accept 4,194,304
(= 2
22
) list commands ( Mem1 = Mem2 = 4,194,304). The protected RTC6 List Memory
area “List 3” owns no storage positions, because 2
23
– Mem1 – Mem2 = 0.
• config_list is not executed (get_last_error return code RTC6_BUSY ), if:
– the BUSY list execution status is set
– a list has been paused by set_wait (PAUSED list execution status set)