Scanlab RTC 5 PC Interface Board - config_list

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
243
innovators for industry
Ctrl Command config_list
Function Configures list memory, therefore allocates memory areas for lists
Call
config_list( Mem1, Mem2 )
Parameters Mem1 desired memory size for “List 1” (as an unsigned 32-bit value)
Mem2 desired memory size for “List 2” (as an unsigned 32-bit value)
Comments • The RTC
®
5’s list memory contains 2
20
storage positions that can be divided into three
areas (lists) via config_list. The sizes of “List 1” and “List 2” are specified through
parameters
Mem1 and Mem2 . config_list automatically assigns to the protected area
(“List 3”) all remaining memory not assigned to “List 1” or “List 2”.
• The following rules apply to the parameters
Mem1 and Mem2 (invalid values will be auto-
matically corrected in the specified order):
–
Mem1 > 0 (“List 1” cannot be empty)
Mem1 = 0 will be corrected to Mem1 = 1.
–
Mem1  2
20
(“List 1” can contain a maximum of 2
20
storage positions)
Mem1 > 2
20
will be corrected to Mem1 = 2
20
– Mem1 = ”–1” will be interpreted as Mem1 = (2
32
–1) and corrected to Mem1 = 2
20
.
Example: With
config_list( –1, x ) where x is any value (also x = –1), “List 1” will
be automatically assigned the entire list memory (
Mem1 = 2
20
, Mem2 = 0, no memory
for “List 3”).
–
Mem2  2
20
– Mem1 (“List 2” can maximally receive the “rest” of list memory)
Mem2 = 0 is allowed.
Mem2 > 2
20
– Mem1 will be corrected to Mem2 = 2
20
– Mem1 .
–
Mem2 = ”–1” will be interpreted as Mem2 = (2
32
–1) and corrected to Mem2 = 2
20
– Mem1 .
Example: With
config_list( Mem1, –1 ) , “List 2” will automatically be assigned the
“rest” of list memory (
Mem2 = 2
20
– Mem1 , no memory for “List 3”).
– Storage positions for “List 3”: 2
20
– Mem1 – Mem2
• By default, the RTC
®
5’s list buffer area is preconfigured so that “List 1” and “List 2” can
each accept 4000 list commands (
Mem1 = Mem2 = 4000). The protected “List 3” then
owns the remaining 1040576 of the 2
20
storage positions.
•The config_list command is ignored (get_error return value =
RTC5_BUSY ) if the
board’s BUSY status or PAUSED status is currently set (list is being processed or has been
halted via pause_list or set_wait).
• Configuration via config_list does not alter the contents of list memory. Repeating the
call with differing parameters is therefore nondestructive. However, after a configura-
tion change, previously loaded list commands will be processed in accordance with the
new configuration. Moreover, a configuration change could in some circumstances
affect the input pointer (if, prior to the reconfiguration, it pointed to a memory position
which was assigned to “List 3” by the configuration change, then it will be shifted to
the beginning of “List 1”) or affect a previously started automatic list change. This
should be taken into account when further loading or executing command lists. Read
the notes in the section "Configuring the List Memory", page 70.
• If you don’t know the current configuration data for list memory (
Mem1 and Mem2 ), you
can find out after
load_list( ListNo, 0 ) or set_start_list_pos( ListNo, 0 ) by
using the command get_list_space (page 272) (if the board changed “ownership”
previously call get_config_list).
RTC
®
4  RTC
®
5new command
References get_config_list