RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
409
Ctrl Command get_hi_pos
Function Returns the Home-In positions, last determined (by auto_cal) of the scan system attached
to the specified scan head connector.
Call
get_hi_pos( HeadNo, &X1, &X2, &Y1, &Y2 )
Parameters
HeadNo
Number of the scan head connector. As an unsigned 32-bit value.
Allowed values.
= 1: First scan head connector.
= 2: Second scan head connector.
Returned
parameter
values
X1
x1 coordinate of the currently stored (most recently measured) Home-In
positions. In bits.
As a pointer to a signed 32-bit value.
X2
Like
X1
(analogously).
Y1
Like
X1
(analogously).
Y2
Like
X1
(analogously).
Comments • For information on using get_hi_pos, see Section ”Customer-Specific Calibration”,
page 278.
• Make sure that the scan system currently attached to the specified scan head
connector is the same scan system which has been 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
– an error has occurred during determination of the Home-In values for such a system
• Directly after initialization (init_rtc6_dll), particularly prior to a first call of
auto_cal(
Command
= 0, 1 or 3 ), the returned values are the Home-In reference values
stored in the Flash Memory. If such reference values have not been successfully
determined at least once by auto_cal(
Command
= 0 ), get_hi_pos returns 0.
• get_hi_pos is available even without (current) explicit access rights to a specific RTC6
board. However, the return values are 0 as long as no access to the addressed board
has been successful at least once before.
• If parameter values are invalid, then all returned coordinates are 0
(get_last_error return code
RTC6_PARAM_ERROR
).
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_hi_data, auto_cal, set_hi, write_hi_pos
To Next Page
Loading...