RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
491
Ctrl Command load_auto_laser_control
Function Loads a table with data points from an ASCII text file. Determines – by linear interpolation
– the nonlinearity curve (see Section ”Loading and Determining the Nonlinearity Curve”,
page 204) for “Automatic Laser Control“ (except Vector-Defined Laser Control), see
Chapter 7.4.9 ”“Automatic Laser Control“”, page 197.
Call
NoOfDataPoints = load_auto_laser_control( 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. The parameter
corresponds to the extension
<No>
of
[AutoLaserCtrlTable<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.
Value Description
–1…– 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, see also Section
”Loading and Determining the Nonlinearity Curve”, page 204.
–1024 For
Name
= NULL (see also comments).
1 No valid data points found (though Table
No
found).
3 File not found.
4 DSP memory error.
5 BUSY list execution status error, board has been 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 been found in the file.
Comments • The format requirements for the text file’s table entries with data points for the
nonlinearity curve are described in Section ”Loading and Determining the Nonlinearity
Curve”, page 204. When loading the table, the RTC6 determines suitable values for the
entire range of percent values.
• load_auto_laser_control overwrites any previously loaded nonlinearity curve.
• For
Name
= NULL (as during initialization by load_program_file), the function
Scale(Percent)
=1.0
is loaded for the complete percent range (no nonlinearity).
To Next Page
Loading...