RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
283
innovators for industry
Ctrl Command get_sub_pointer
Function
returns the absolute start address of an indexed subroutine.
Call
SubPointer = get_sub_pointer( Index )
Parameter
Index
Index of the indexed subroutine as an unsigned 32-bit value;
allowed range: [0 … 1023]
Result
Absolute start address as an unsigned 32-bit value
Comments
• The
get_sub_pointer
command reads from the internal management table the start
address of the indexed subroutine with the specified index. Whether the read address
resides in a protected or the unprotected memory area depends on whether the
subroutine was loaded into the protected memory area or an unprotected subroutine
was only subsequently referenced.
• If
Index
> 1023 or if no subroutine was referenced with the specified index, then the
command will return the value “–1” (e.g. 2
32
–1).
• This command is useful for checking if a subroutine has already been defined or for
calling an indexed subroutine via an absolute memory address as if it were a non-
indexed subroutine. Be aware, though, that a subsequent
/
might
alter the absolute memory address.
RTC
®
4
RTC
®
5 new command
References
