Scanlab RTC 5 PC Interface Board - auto_cal

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
236
innovators for industry
Ctrl Command auto_cal
Function controls the functions for (automatic self-) calibration of the scan system attached to the
specified scan head connector.
Call
ErrorCode = auto_cal( HeadNo, Command )
Parameters HeadNo Number of the scan head connector as an unsigned 32-bit value,
allowed values:
= 1: primary scan head connector
= 2: secondary scan head connector (activation required)
Command Control parameter (as an unsigned 32-bit value,
allowed value range: [0 … 4]):
=0: The RTC
®
5 detects the current Home-In positions, stores them in the
DLL and in the RTC
®
5 EEPROM as Home-In reference values and
initializes the gain and offset values (Gain = 1.0, Offset = 0).
= 1: The RTC
®
5 detects the current Home-In positions,
calculates and sets the new gain and offset values and thereby
activates drift compensation.
=2: The RTC
®
5 deactivates drift compensation by initializing the gain and
offset values (Gain = 1.0, Offset = 0).
= 3: The RTC
®
5 detects the current Home-In positions
(but – in comparison to
Command = 1 – leaves the gain and offset
values unchanged and i.e. does not activate drift compensation
= 4: The RTC
®
5 checks the ASC hardware (i.e. checks whether a scan
system attached to the specified scan head connector is equipped
with an internal sensor system for automatic self-calibration – Home-
In sensors) and returns the type and status of the detected sensor
system. The detected type is also stored in the RTC
®
5 EEPROM.
Result error code or type of sensor system as an unsigned 32-bit value:
3 The command cannot be executed because the board is currently BUSY or INTERNAL-BUSY
6 Parameter error.
the following error codes are only returned after Command = 0 … 3:
0 No error.
1, 10, 11 Home-In sensor not found (this could also mean a Home-In sensor is defective)
(1: for X axis (galvanometer scanner 2)
10: for Y axis (galvanometer scanner 1)
11: for both axes).
2, 20, 22 The spread in measured values during a measurement cycle is too high
(2: for X axis / 20: for Y axis / 22: for both axes).
4, 40, 44 Reference data not found (only for
Command = 1 and 3)
(4: for X axis / 40: for Y axis / 44: for both axes).
5, 50, 55 Calibration error (Error during calibration or error in reference data)
(5: for X axis / 50: for Y axis / 55: for both axes);
(for DLL version 519 or lower) this return value could also mean the scan system contains no Home-
In sensor(s).
7 Error: automatic laser control activated in Mode 2
the following error code is only returned after Command = 0 or 4, and even then only if no
other errors occurred:
8 EEPROM write error (for this error, the get_last_error return code RTC5_EEPROM_ERROR is always
generated)