DS1M12_ProgramDevice

This function allows the DS1M12 FPGA to be programmed with a specified raw binary file (RBF).

DS_STATUS

DS1M12_ProgramDevice

(DS_HANDLE dsHandle, LPSTR lpFileName)

Parameters

dsHandle	Handle of a DS1M12.
lpFileName	Pointer to a NULL terminated string that contains the full path name of the FPGA configuration data file. The FPGA configuration data file must have a .RBF extension.

Return Value
Returns DS_SUCCESS if successful, otherwise the return value will be one of the following error codes:

   DS_INVALID_HANDLE
   DS_DEVICE_NOT_FOUND
   DS_DEVICE_PROGRAM_CHANNEL_IN_USE
   DS_INVALID_FPGA_FILE_NAME
   DS_INVALID_FPGA_FILE_EXTENSION
   DS_FPGA_FILE_NOT_FOUND
   DS_FPGA_FILE_CORRUPT
   DS_FAILED_TO_OPEN_FPGA_FILE
   DS_FPGA_FILE_READ_ERROR
   DS_FAILED_TO_CLEAR_DEVICE
   DS_FAILED_TO_PROGRAM_DEVICE
   DS_FAILED_TO_SYNCHRONIZE_DEVICE_MPSSE
   DS_FAILED_TO_COMPLETE_COMMAND
   DS_IO_ERROR


Remarks
This function allows any comptible RBF file to be loaded into the FPGA. However, the DS1M12.RBF file is required to use the other functions available in DS1M12.DLL as the DS1M12 will not understand the commands sent by other functions in the DS1M12 DLL if the RBF file is different.