RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
326
innovators for industry
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
).
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
–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 (
return code
RTC5_BUSY
).
8
Board is locked by another application (
return code
RTC5_ACCESS_DENIED
).
11
PCI error (
return code
RTC5_SEND_ERROR
),
verify 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"
. 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
), 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 (
code
:
RTC5_BUSY
) if the board’s BUSY status is currently set (list is being processed or
has been halted via
) or 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).
• 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