RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
326
Ctrl Command load_auto_laser_control
Function loads a table with data points from an ASCII text file and determines – via linear
interpolation – the non-linearity curve for position- and/or speed-dependent laser control
(see page 144).
Call
NoOfDataPoints = load_auto_laser_control( Name, No )
Parameters
Name
name of the text file as a pointer to a null-terminated ANSI string
(the text file may contain one or more tables).
No
This parameter (an unsigned 32-bit value) specifies which table in the text file
shall be loaded (the parameter corresponds to the extension
<No>
of the
instruction
[AutoLaserCtrlTable<No>]
at the beginning of the desired table).
Result signed 32-bit value (a positive error code in case of an error, the negative number of found
data points in case of success):
Value Description
– 1 to – 50 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 (also see page 144).
–1024 for
Name
= 0 (also see comments)
1 No valid data points found (though Table
No
found).
3 File not found.
4 DSP memory error
5 BUSY error, board was BUSY or INTERNAL-BUSY, no download (get_last_error return code
RTC5_BUSY
).
8 Board is locked by another application (get_last_error return code
RTC5_ACCESS_DENIED
).
11 PCI error (get_last_error return code
RTC5_SEND_ERROR
),
verify error (get_last_error return code
RTC5_VERIFY_ERROR
)
13 The specified table number was not found in the file.
Comments • The format requirements for the text file’s table entries with data points for the nonlin-
earity curve are described in "Notes on Loading and Determining Nonlinearity Curves"
on page 144. When loading the table, the RTC
®
5 determines suitable values for the
entire range of percent values.
•The load_auto_laser_control overwrites any previously loaded nonlinearity curve.
•For
Name
= 0 (as during initialization via load_program_file), the function
Scale(Percent)
=1.0
is loaded for the complete percent range (no nonlinearity).
•The load_auto_laser_control command will not be executed (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).
• During execution of load_auto_laser_control, external starts will be suppressed.
• Before loading a table, load_auto_laser_control performs a DSP memory check. In
case of an error, error code 4 is returned.
RTC
®
4
RTC
®
5 new command
References set_auto_laser_control
To Next Page
Loading...
