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
), 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
+
B
l
+
C
l
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
).
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
). 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 (
return code
:
RTC5_BUSY
) if the board’s
BUSY status is currently set (list is being processed or has been halted via
the board’s INTERNAL-BUSY status is currently set. In contrast, the command is
executed when a list has been paused via
(
PAUSED status set).
• This command should always be used
after
the command
, since
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
. 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
(and from the currently assigned 3D correction table via
).
