Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 342

Ctrl Command load_program_file
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
memory configuration, internal variables, matrices, offsets and table assignments)
previously set with
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
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
Stop.
• The files RTC5OUT.out, RTC5RBF.rbf and RTC5DAT.dat are included in the RTC
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
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
via release_rtc
further commands other than those not requiring access rights
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
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
®
RTC 3 and RTC
via the command get_hex_version.
• The dsp_start command doesn't exist for the RTC
matically started via load_program_file.
® ®
RTC 4 RTC 5 • This command parameters specifies a directory name with RTC
name with the RTC
• 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
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
®
5 reset, list memory contents will be erased and all parameters (e.g.
config_list or select_cor_table
set_wait (PAUSED status set),
directly after the version check and therefore will not be available for
command). In this case, the single-board command load_program_file
®
5 program files is no longer *.hex (as with the RTC
®
2), but instead *.out. As before, the version number can be queried
®
4).
will be deleted or reset to their
(get_last_error
stop_execution or an external
®
5 memory, but the board will be released
(get_last_error
®
5 (see page 561). The DSP is auto-
®
5 (in contrast a file
return code:
®
5 soft-
®
5
return
®
4,
342