RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
268
innovators for industry
Ctrl Command get_hi_pos
Function
returns the Home-In positions, last determined (via
) of the scan system attached
to the specified scan head connector.
Call
get_hi_pos( HeadNo, &X1, &X2, &Y1, &Y2 )
Parameter
HeadNo
Number of the scan head connector as an unsigned 32-bit value,
valid values:
= 1:
primary scan head connector
= 2:
secondary scan head connector (activation required)
Returned para-
meter values
X1, X2,
Y1, Y2
coordinates of the currently stored (last determined) Home-In positions in
bits
as a pointers to signed 32-bit values
Comments
• For information on using this command, see
• It is up to the user to ensure, that the scan system currently attached to the specified
scan head connector is the same scan system which was used to determine the returned
Home-In positions. For determination of Home-In position values, this scan system
should be equipped with an internal sensor system for automatic self-calibration
(Home-In sensors).
• The returned values are 0 if no scan system equipped with automatic self-calibration
(Home-In sensors) is attached to the specified scan head connector or if an error has
occurred during determination of the Home-In values for such a system. For
HeadNo
=2,
the returned values are also 0, if the “second scan head control” option has not been
enabled.
• Directly after initialization (
), particularly prior to a first call of the
command
(
Command
= 0, 1 or 3), the returned values are the Home-In refer-
ence values stored in the im EEPROM of the RTC
®
5 board. If such reference values have
not been successfully determined at least once via
(
Command
= 0),
get_hi_pos
returns 0.
• The command
get_hi_pos
is also available without explicit access rights to a specific
RTC
®
5 board.
• If parameter values are invalid, then all returned coordinates will be 0 (
return code:
RTC5_PARAM_ERROR
).
RTC
®
4
RTC
®
5 new command
References
