Scanlab RTC 5 PC Interface Board - load_program_file

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
340
innovators for industry
Ctrl Command load_program_file
Function executes a board reset, performs a DSP memory check, loads into RTC
®
5 memory the
program file
RTC5OUT.out along with the files RTC5RBF.rbf and RTC5DAT.dat from the
specified directory, performs a version check and starts the signal processor (DSP).
Call ErrorNo = load_program_file( pPath )
Parameter
pPath Path name of the directory, where the files RTC5OUT.out , RTC5RBF.rbf and
RTC5DAT.dat are stored (as a pointer to a null-terminated string)
Result error code as an unsigned 32-bit value:
Value Description
0 Success.
1 Reset error: the board could not be reset.
2 Unreset error: the board won’t restart.
3 File error: file not found or can’t be opened.
4 Format error: RTC5OUT.out has incorrect format.
PCI error: driver reported an error during PCI transfer because driver isn’t compatible with DLL. This
occurs particularly when DLL 533 or earlier is used with driver 6.1.7600.16385, or if PCI
communication is in any way impaired. Up to DLL 536, error code 4 indicates a PCI error, too. As of
DLL 537, PCI errors are indicated by error code 16, see the description there.
5 System error: not enough WINDOWS memory.
6 Access error: board reserved for another application
7 Version error: DLL version (driver DLL), RTC version (firmware file) and HEX version (DSP program file)
not compatible
8 System driver not found (get_last_error return code: RTC5_ACCESS_DENIED)
9 DriverCall error: loading of RTC5OUT.out file failed.
10 Configuration error: DSP register initialization failed.
11 Firmware error: loading of RTC5RBF.rbf file failed.
12 PCI download error: loading of RTC5DAT.dat file failed.
13 Busy error: Download locked, board is BUSY or INTERNAL-BUSY (get_last_error return code:
RTC5_BUSY)
14 DSP memory error
15 Verify error (only applicable for download verification)
16 PCI error: as of DLL 537. Or a possible driver/DLL conflict, see note on page 26: “Older RTC
®
5 DLL files
(version DLL 533 and lower) are not compatible with the new WDF drivers.”