RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
490
Ctrl Command set_start_list_pos
Function opens the list buffer for writing of list commands and sets the input pointer to the
specified (relative) position in the desired list (“List 1” or “List 2”). The next list command
will be stored at this address and all further list commands at the subsequent addresses in
the selected list.
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
permissible 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; permissible range: [0 … (2
20
–1)]
Comments • The selected list will be unconditionally opened for loading. There is no checking of
whether the list is currently being processed (also see "Loading Lists", page 71 and
load_list).
•The input pointer cannot be set to the protected area (“List 3”). If the protected area is
to be written to (at the full risk of the user) with set_start_list_pos, then this area can
be temporarily allocated to “List 2” via
ConfigList
(
Mem1
, –1 ). After writing, configu-
ration of the area’s protection should be restored:
ConfigList
(
Mem1
,
Mem2
).
• For uneven
ListNo
values, “List 1“ is opened, otherwise “List 2“. This facilitates contin-
uous automatic list changing though incrementing counts.
• If “List 2” has not been assigned memory (
Mem2
= 0, see config_list) then “List 1“ will
be opened.
•If
Pos
is specified as being larger than the memory area of the respective list (
Pos
>
Mem1
or
Pos
>
Mem2
), then
Pos
will be set to 0.
• The status values of the selected list (also see read_status) will be set as follows: LOAD
set, READY reset, USED reset. The LOAD status of the other corresponding list will be
reset.
•The set_start_list_pos command triggers a flush of the list input buffer (see page 71).
• 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 list buffer area is reached, the list input pointer is
automatically reset to the start of the same list buffer area. Make sure not to overwrite
any commands still needed by your application.
RTC
®
4
RTC
®
5 new command
References execute_list_pos, read_status
To Next Page
Loading...
