RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
511
Comments
(cont’d)
• load_program_file automatically executes stop_execution, if:
– the BUSY list execution status is set
– the INTERNAL-BUSY list execution status is set
• The files
RTC6OUT.out
,
RTC6ETH.out, RTC6RBF.rbf
and
RTC6DAT.dat
are included in the
RTC6 software package. For easy identifying and archiving of different software
versions, the files are also delivered zipped (the
zip
file names
RTC6<…>_<Version>.zip
include the version numbers). Copy or unzip the three files (of desired version) to the
hard drive of your PC.
• Assorted versions of the RTC6 DLL and the files
RTC6OUT.out
,
RTC6ETH.out, RTC6RBF.rbf
and
RTC6DAT.dat
cannot be arbitrarily combined with another (each
zip
file in the RTC6
software includes a text file with version information). load_program_file performs a
version compatibility check. If there is a version error, then the loaded programs remain
in RTC6 memory, but the board is released by release_rtc directly after the version
check and therefore is not available for further commands other than those not
requiring access rights (get_last_error return code
RTC6_ACCESS_DENIED |
RTC6_VERSION_MISMATCH
). To then load a correct program version, load_program_file
can be called. Hereby, temporary access rights are requested and released after the
download (if the board has not been acquired by another user program;
load_program_file does not perform an acquire_rtc).
RTC4RTC6 • The command parameter specifies a directory name with RTC6 (in contrast a file name
with the RTC4).
• load_program_file loads three files, with fixed formats and names (
RTC6OUT.out
,
RTC6RBF.rbf
,
RTC6DAT.dat
) (see above).
• After execution of the command, the laser control is deactivated.
RTC5RTC6 Changed functionality.
• Notes on migrating the source code of RTC5 user programs, etc.: load_program_file
is downward compatible with the RTC5 and can continue to be used without
modification. Though you do not need to change your user program, keep in mind the
following:
– There is no checking of the BUSY list execution status (hence error code 13 is never
be outputted).
– Data transfer by the McBSP interface is deactivated without warning.
– A running list is terminated without warning, similarly to the control command
stop_execution. Observe notes there about mirror positions etc.
– Other used error codes are provided as listed in the table above.
Version info Available as of DLL 600, OUT 600, RBF 600.
References –
Ctrl Command load_program_file