RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
501
Ctrl Command load_fly_2d_table
Function Loads a 2D table from an ASCII text file for a set_fly_2d-
Processing-on-the-fly application
with 2D encoder compensation for xy positioning stages, see Section ”2D Encoder
Compensation for xy Positioning Stages”, page 249.
Call
NoOfDataPoints = load_fly_2d_table( Name, No )
Parameters
Name
Name of the text file or NULL. The text file may contain one or more tables.
As a pointer to a \0-terminated ANSI string.
No
Determines which table in the text file is to be loaded.
No
corresponds to the extension
<No>
of
[Fly2DTable<No>]
at the beginning of
the desired table.
As an unsigned 32-bit value.
Result A positive error code in case of an error. The negative number of found data points in case
of success. As a signed 32-bit value.
< 0 Success. The absolute value of the return value is equal to the number of valid
data points found in the table. Invalid entries are ignored, see Section ”For the
2D compensation tables, the following rules apply:”, page 250.
0 For
Name
= NULL (see comments).
1 No valid data points found (though Table
No
found).
2 Out of Memory (not enough Windows system memory).
3 File not found.
4 DSP memory error.
5 BUSY list execution status error, board is BUSY list execution status or
INTERNAL-BUSY list execution status, no download
(get_last_error return code
RTC6_BUSY
).
8 Board is locked by another user program
(get_last_error return code
RTC6_ACCESS_DENIED
).
11 PCI error (get_last_error return code
RTC6_SEND_ERROR
),
verify error (get_last_error return code
RTC6_VERIFY_ERROR
).
13 The specified table number could not be found in the file.
Comments •
No
=
<No>
loads table number 1;
No
=
<No>
+ 65.536 loads table number 2.
• The text file’s data format requirements for reference points of the 2D encoder
compensation table are described in Section ”For the 2D compensation tables, the
following rules apply:”, page 250. The largest of these reference points should not
exceed the range
–524,288…+524,287 (otherwise precision may be lost). During runtime, the current
encoder values (including reference values) must not exceed the largest values
specified in the table. Otherwise, clipping occurs.
• load_fly_2d_table overwrites a previously loaded table for 2D encoder compensation.
• If
Name
= NULL, then a 0-correction table for 2D encoder compensation is loaded and
the table is marked as invalid (see init_fly_2d).
To Next Page
Loading...