RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
505
Ctrl Command load_list
Function Opens the RTC6 List Memory for writing with list commands and sets the input pointer to
the specified relative position within the desired list (“List 1” or “List 2”), but only if the list
is not currently being processed (BUSY list status is not set) or has already been processed
(USED list status is set).
Call
NoOfOpenedList = load_list( ListNo, Pos )
Parameters
ListNo
Number of the list in which the input pointer should be set.
As an unsigned 32-bit value.
Allowed values: [0…3]. Only the two least significant bits are evaluated.
= 0: The list is opened for which the BUSY list status is not currently set.
“List 1” is opened, if the BUSY list status is not set for either list.
= 1: “List 1” is opened, if the BUSY list status for it is not set
(BUSY1 not set).
= 2: “List 2” is opened if the BUSY list status for it is not set
(BUSY2 not set).
= 3: The list is opened for which the BUSY list status is not currently set but
the USED list status.
If for both lists the BUSY list status is not set but the USED list status:
that list is opened, which would be executed by a following
automatic list change.
For
Mem2
= 0 (see config_list) “List 1” is opened, if:
• the BUSY list status for it is not set (
ListNo
= 0…2)
• the BUSY list status for it is not set but the USED list status (
ListNo
= 3)
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)].
Result Number of the opened list [1 or 2] if successful, otherwise 0.
As an unsigned 32-bit value.
Comments • If load_list has been successful, the next list command is stored at the specified
address and all subsequent list commands at the following addresses in the selected
list.
• If load_list has not been successful (return code 0), then no list is opened and the
input pointer is set to an invalid position. Then no further list commands can be input
until the input pointer is correctly set (for example, by repeating load_list with a
positive result or by the set_start_list_pos command etc.). It is the responsibility of the
user to react to a return code of 0. load_list produces no wait loop and does not block
execution of subsequent control commands.
To Next Page
Loading...