Scanlab RTC 5 PC Interface Board - load_z_table

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
347
innovators for industry
Ctrl Command load_z_table
Function loads coefficients A, B and C into the currently assigned 3D correction table.
Restriction If the 3D option has not been enabled or a 3D correction table has not been assigned (see
select_cor_table), then the command returns the error code 12 or 13 and otherwise has
no effect.
Call
ErrorNo = load_z_table( A, B, C )
Parameters A, B, C coefficients (as 64-bit IEEE floating point values) of the parabolic function
z
out
= A + Bl +Cl
2
which is used for calculating the Z output values;
allowed range:
•for
A : [–67108864.0 … 67108864.0]
•for
B : [–2048.0 … 2048.0]
•for
C : [–16.0 … 16.0]
Out-of-range values will be edge-clipped.
Result error code as an unsigned 32-bit value:
Error bits with values 1 to 64 can also occur combined, but not in conjunction with error codes 11 to 14, which only
occur separately. Warnings 12 and 13 are only returned if no other errors exist.
Value Description
0 No error
1 A exceeded the maximum allowed value.
2 A undercut the minimum allowed value.
4 B exceeded the maximum allowed value.
8 B undercut the minimum allowed value.
16 C exceeded the maximum allowed value.
32 C undercut the minimum allowed value.
64 Execution denied (possibly a BUSY or INTERNAL BUSY error; for exact reason: see get_last_error).
11 Access denied.
12 3D Option not enabled.
13 No 3D table is currently assigned.
14 System driver not found.
Comments • This command is only needed for re-calibrating the Z-axis in a 3-axis scan system (for
adjusting corresponding coefficients see page 174). Both positive and negative coeffi-
cients can be specified. The coefficients should preferably be chosen so that all Z output
values lie within the range [ – 32768 … +32767].
• The command will be ignored (get_last_error return code:
RTC5_BUSY ) if the board’s
BUSY status is currently set (list is being processed or has been halted via pause_list) or
the board’s INTERNAL-BUSY status is currently set. In contrast, the command is
executed when a list has been paused via set_wait (PAUSED status set).
• This command should always be used after the command load_correction_file, since
load_correction_file sets the three coefficients to the default values of the loaded
correction table.
• Prior to the next list command that directly follows load_z_table, a smooth transition
from the last Z position to the changed position will be performed at
jump_speed . You
can also immediately force this via select_cor_table. This way, time delays can be
avoided during an external start.
• Coefficients A, B and C can be queried from the loaded 3D correction table via
get_table_para (and from the currently assigned 3D correction table via
get_head_para).