RTC
®
4 PC Interface Board
Rev. 1.3 e
10 Commands And Functions
84
innovators for industry
Ctrl Command get_io_status
Function returns the current state of the 16-bit digital output port on the “EXTENSION 1” connector
Result unsigned 16-bit value (DIGITAL_OUT0 … DIGITAL_OUT15)
Integration Pascal:
function get_io_status: word;
C:
unsigned short get_io_status(void);
Basic:
function get_io_status()%
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 46.
References set_io_cond_list, clear_io_cond_list
Ctrl Command get_list_space
Function returns the number of free list entries in circular queue mode
(see chapter 5.5 "Circular Queue Mode", page 44)
Result number of free list entries as unsigned 16-bit value
Integration Pascal:
function get_list_space: word;
C:
unsigned short get_list_space(void);
Basic:
function get_list_space()%
References set_list_mode
Ctrl Command get_rtc_version
Function returns the firmware version number of the RTC
®
4 board
Result RTC
®
4 version number as an unsigned 16-bit value:
Bit #0 (LSB) … Bit #7 Firmware version of the RTC
®
4 board
Bit #8 = 1: Processing-on-the-fly is enabled. See supplement manual "Processing-On-The-Fly
Software".
Bit #9 = 1: Second scan head connector is enabled. See page 54.
Bit #10 = 1: 3D control signals are enabled. See supplement manual "3D Software".
Bit #11 = 1: RTC
®
4 I/O Extension Board is installed.
Bits #12…#15 reserved
Integration Pascal:
function get_rtc_version: word;
C:
unsigned short get_rtc_version(void);
Basic:
function get_rtc_version()%
Comments • The RTC
®
4 firmware version numbers are in the range 128-255.
If an RTC
®
4’s version number is even, then it is equipped with an optical data interface
and data transfer is compliant with the XY2-100-O protocol. For RTC
®
4s with odd
version numbers, XY2-100 standard-compliant data transfer takes place electronically
via a 25-pin female or 26-pin male connector.
• The RTC
®
3 firmware version numbers are in the range 0-127.
References get_hex_version, get_dll_version