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 (
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 (
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
: “Older RTC
®
5 DLL files
(version DLL 533 and lower) are not compatible with the new WDF drivers.”