RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
338
innovators for industry
Ctrl Command load_position_control
Function
loads a table with data points from an ASCII text file and determines – via linear
interpolation – the scaling function for position-dependent laser control (radial correction,
see
).
Call
NoOfDataPoints = load_position_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
[PositionCtrlTable<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
–256
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 position-
dependent laser control are described in
"Notes on Loading a Scaling Function" on
. When loading the table, the RTC
®
5 determines suitable values for the entire
range of control values.
• The command
load_position_control
overwrites any previously loaded scaling func-
tion for position-dependent laser control.
• For
Name
= 0 (as during initialization via
), the scaling function
Scale
(
Position
)=1.0 is loaded for the complete position range so that no position-
dependent correction takes place.
• Position-dependent laser control only takes effect during subsequent mark or arc
commands if it was initialized via
. Position-dependent laser
control is deactivated via
Ctrl
= 0) or by loading
Scale
(
Position
)=1.0. Also see
"Position-Dependent Laser Control", page 141
• The
load_position_control
command will
not
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_position_control
, external starts will be suppressed.
• Before loading a table,
load_position_control
performs a DSP memory check. In case
of an error, error code 4 is returned.
RTC
®
4
RTC
®
5 new command