RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
344
innovators for industry
Ctrl Command load_sub
Function
assigns a desired index to a subroutine defined by subsequent list commands and loads
the subroutine into the protected buffer area (“List 3”)
Call
load_sub( Index )
Parameter
Index
Index of the indexed subroutine as an unsigned 32-bit value,
permissible range [0 … 1023]
Comments
• Up to 1024 indexed subroutines can be stored. If
Index
> 1023 then the
load_sub
command will be ignored (
return code
RTC5_PARAM_ERROR
).
• The address in the protected buffer area where the subroutine should be stored is auto-
matically determined and internally managed.
• Indexed subroutines must be terminated with a
command. This is a prereq-
uisite for actual storage of the commands, entry of the start address and other infor-
mation (e.g., the number of commands) into the internal management table, and
initiating a flush of the list input buffer (see
). Otherwise (the input pointer will
be altered without a preceding
command) the subroutine with this index
will not be available.
• An indexed subroutine will not be stored if the protected buffer area (“List 3”) was not
previously configured for a sufficient size beyond “List 1” and “List 2”.
is the next command after
load_sub
, then the corresponding subroutine
will be deleted from the internal management table.
• Indexed subroutines can be called via the
command along with the corre-
sponding index (see
"Calling Subroutines", page 77
).
• Observe all notes in the section
"Indexed Subroutines", page 76
.
RTC
®
4
RTC
®
5 new command
References
Ctrl Command load_text_table
Function
assigns a desired index to a text string defined by subsequent list commands and loads the
text string into the protected buffer area (“List 3”)
Call
load_text_table( Index )
Parameter
Index
Index of the indexed text string as an unsigned 32-bit value,
permissible range [0 … 41]
