RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
267
Comments • Status signals can also be queried via get_value, get_values, set_trigger and
set_trigger4.
• Also see chapter 8.5, page 170 for information about using two scan heads.
RTC
®
4
RTC
®
5 essentially unchanged functionality, however:
• The RTC
®
5 allows (unlike the RTC
®
4) the simultaneous reading of both scan head
connectors’ status words, even (for iDRIVE
®
scan systems) independently of the signal
to be returned selected via control_command.
•Even for iDRIVE
®
scan systems, bits #0 and 1 (unlike with the RTC
®
4) do not return
information about the scan system’s operational readiness (see get_value).
References get_value, get_values, set_trigger, set_trigger4, get_waveform
Ctrl Command get_hex_version
Function returns the version number of the currently loaded RTC
®
5 software (DSP program file
RTC5OUT.out
)
Call
HexVersion = get_hex_version()
Result RTC
®
5 software version number as an unsigned 32-bit value
Comments • The version numbers of program files are in the range 500 … 599.
get_hex_version returns the following values:
– if the 3D option is not enabled:
values in the range 2500 … 2599 (version number + 2000)
– if the 3D option is enabled:
values in the range 3500 … 3599 (version number + 3000)
• The file name extension for RTC
®
5 program files is no longer
*.hex
(as with the RTC
®
4,
RTC
®
3 and RTC
®
2), but instead
*.out
(also see load_program_file, page 340).
• For DLL 535 and higher: The software version number can also be returned after an
RTC5_VERSION_MISMATCH
or
RTC5_ACCESS_DENIED
error. The return value is 0 if no
program has yet been loaded. Here, an
RTC5_TIMEOUT
error will not be generated.
RTC
®
4
RTC
®
5 unchanged functionality
Version info Last change with version DLL 535 (see comment)
References get_dll_version, get_rtc_version
Ctrl Command get_hi_data
Function returns the Home-In positions, last determined (via auto_cal) of the scan system attached
to the primary scan head connector.
Call get_hi_data( &X1, &X2, &Y1, &Y2)
Returned para-
meter values
X1, X2,
Y1, Y2
coordinates of the currently stored Home-In positions in bits as pointers to
signed 32-bit values
Comments • The command is synonymous with the get_hi_pos command with
HeadNo
= 1 (see
comments there).
RTC
®
4
RTC
®
5 unchanged functionality (except for the extended range of values).
The returned values are in the RTC
®
5’s 20-bit range.
References get_hi_pos
Ctrl Command get_head_status