| Customize Help
| Save Settings

MfpgaLoad


Function Map
Syntax
Description
Parameters
- MilSystemId
- FpgaDeviceNumber
Table: For specifying the rank of the Processing FPGA
- FirmwareFile
Table: For specifying the file name and path
- ControlFlag
Return value
Compilation information
Synopsis
Load a new FPGA configuration into a Processing FPGA on a target system.
Syntax
MIL_INT MfpgaLoad(
MIL_ID MilSystemId, //in
MIL_INT FpgaDeviceNumber, //in
MIL_CONST_TEXT_PTR FirmwareFile, //in
MIL_INT64 ControlFlag //in
)
Description

This function loads new configuration data into a Processing FPGA on the target system. This function allows you to avoid rebooting the Host and then using the MILConfig utility to specify and MsysAlloc() to load a different FPGA configuration into a Processing FPGA. Loading a new FPGA configuration can take longer to complete than other commands. It is recommended that MfpgaLoad() not be called during a time-critical section of your application. You must wait for all processing to finish executing before loading the new configuration into the Processing FPGA, otherwise data corruption might occur.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
MilSystemId

Specifies the identifier of the system that has the required Processing FPGA.

FpgaDeviceNumber

Specifies the rank of the Processing FPGA into which to load the new FPGA configuration. This parameter must be set to the following value:

function map For specifying the rank of the Processing FPGA
Click to summarizeValue Description MIL system-specific
tooltip (‡)
Click to summarize M_DEVn

Specifies the rank of the Processing FPGA on the board, where n can be a value between 0 and the total number of Processing FPGAs-1.

 ‡ j k
M10		 l m p r
U27		 y
U75		 aa
FirmwareFile

Specifies the name and path of the file from which to load the FPGA configuration.

function map For specifying the file name and path
Click to summarizeValue Description MIL system-specific
tooltip (‡)
Click to summarize MIL_TEXT("FileName") 1

Specifies the drive, directory, and name of the file from which to load the FPGA configuration (for example, "C:\mydirectory\myfile"). Typically, FPGA configuration files have an MBF file extension.

To retrieve the file on the remote computer (under Distributed MIL), prefix the specified file name string with "remote:///" (for example, "remote:///C:\mydirectory\myfile").

(summarize)
‡ j k
M10		 l m p r
U27		 y
U75		 aa

1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().

ControlFlag

Reserved for future expansion. Set this parameter to M_DEFAULT.

Return value
The returned value is M_VALID if successful. If the operation fails, M_NULL is returned.
Compilation information
Header Include mil.h; milfpga.h.
Library Use mil.lib; milfpga.lib.
DLL Requires mil.dll; milfpga.dll.
DEVn M_DEVn