RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
342
innovators for industry
Comments
• The
load_program_file
command does
not
load correction tables. Even 1-to-1 tables
therefore need to be explicitly requested – see
. Already-loaded
correction tables will remain loaded after
load_program_file
.
• During a RTC
®
5 reset, list memory contents will be erased and all parameters (e.g.
memory configuration, internal variables, matrices, offsets and table assignments)
previously set with
or
will be deleted or reset to their
default values. During a reset, a correction table is assigned as via
select_cor_table(1,0)
but no scanner motion to the corrected output position is
executed.
• The function will only return to the calling program, when DSP initialization has been
completed.
• The
load_program_file
command will not be executed (
return code
:
RTC5_BUSY
) if the board’s BUSY status is currently set (list is being processed or has been
) or the board’s INTERNAL-BUSY status is currently set. In contrast,
the command
will
be executed if a list has been previously terminated in an orderly
(
PAUSED status set),
or an external
Stop.
• The files
RTC5OUT.out
,
RTC5RBF.rbf
and
RTC5DAT.dat
are included in the RTC
®
5 soft-
ware package. For easy identifying and archiving of different software versions, the files
are also delivered zipped (the zip file names
RTC5<…>_<Version>.zip
include the version
numbers). Copy or unzip the three files (of desired version) to the harddisk of your PC.
• Assorted versions of the driver DLL and the files
RTC5OUT.out
,
RTC5RBF.rbf
and
RTC5DAT.dat
cannot be arbitrarily combined with another (each zip file in the RTC
®
5
software includes a text file with corresponding version information). The command
load_program_file
performs a version compatibility check. If there is a version error,
then the loaded programs will remain in RTC
®
5 memory, but the board will be released
via
directly after the version check and therefore will not be available for
further commands other than those not requiring access rights (
return
code
:
RTC5_ACCESS_DENIED | RTC5_VERSION_MISMATCH
). To then load a correct program
version, only the multi-board command
n_load_program_file
can be called. Hereby,
temporary access rights will be requested and released after the download (if the board
hasn’t been reserved by another application;
n_load_program_file
does not perform
command). In this case, the single-board command
load_program_file
does not get access rights for the board. Alternatively, the board can be made current-
less to unload the program software (afterward also
load_program_file
can be used
again).
• The filename extension for RTC
®
5 program files is no longer
*.hex
(as with the RTC
®
4,
RTC
®
3 and RTC
®
2), but instead
*.out
. As before, the version number can be queried
via the command
.
• The
dsp_start
command doesn’t exist for the RTC
®
). The DSP is auto-
matically started via
load_program_file
.
RTC
®
4
RTC
®
5
• This command parameters specifies a directory name with RTC
®
5 (in contrast a file
name with the RTC
®
4).
• The command loads three files, with fixed formats and names (
RTC5OUT.out
,
RTC5RBF.rbf
,
RTC5DAT.dat
) (see above).
• After execution of the command, the laser control is
deactivated
.
Version info
Last change with version DLL 537
Ctrl Command load_program_file