RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
269
Ctrl Command get_input_pointer
Function returns the present (absolute) position of the input pointer.
Call
InputPointer = get_input_pointer()
Result position of the input pointer [0 … (2
20
–1)] as an unsigned 32-bit value.
Comments • The position of the input pointer corresponds to the position in RTC
®
5 list buffer (also
in the protected “List 3” area), where the next list command will be stored. The number
of still-available storage positions there can be queried via get_list_space.
• get_input_pointer returns the absolute list memory address (offset relative to the start
of “List 1”). The relative position referenced to the start of the respective list area can
be queried via get_list_pointer.
• Before loading a non-indexed subroutine or character set, you should use
get_input_pointer to obtain the start address if subsequent referencing is to be
performed via set_sub_pointer or set_char_pointer.
• The absolute position of the output pointer can be queried via get_status or
get_out_pointer.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by get_input_pointer.
RTC
®
4
RTC
®
5 unchanged functionality
References get_list_pointer, set_input_pointer, get_list_space, get_status, get_out_pointer
Ctrl Command get_io_status
Function returns the current state of the 16-bit digital output port on the EXTENSION 1 connector
Call
IOStatus = get_io_status()
Result 16-bit value (DIGITAL OUT0 … DIGITAL OUT15) as an unsigned 32-bit value
Comments • This command is conceived of for use in combination with the commands
set_io_cond_list and clear_io_cond_list (also see "Programming Examples", page 214).
• Also see section "16-Bit Digital Input and Output", page 49.
RTC
®
4
RTC
®
5 unchanged functionality
References write_io_port, write_io_port_mask, set_io_cond_list, clear_io_cond_list