RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
342
Comments • The load_program_file command does not load correction tables. Even 1-to-1 tables
therefore need to be explicitly requested – see load_correction_file. 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 config_list or select_cor_table 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 (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 will be executed if a list has been previously terminated in an orderly
manner or paused via set_wait (PAUSED status set), stop_execution 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 release_rtc directly after the version check and therefore will not be available for
further commands other than those not requiring access rights (get_last_error 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
an acquire_rtc 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 get_hex_version.
•The dsp_start command doesn’t exist for the RTC
®
5 (see page 561). 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