Skip to main content

MfpgaControl

BoardSupported
Host SystemNo
V4L2No
Clarity UHDNo
Concord PoENo
GenTLNo
GevIQNo
GigE VisionNo
IndioNo
Iris GTXNo
Radient eV-CLNo
Rapixo CLYes
Rapixo CoFYes
Rapixo CXPYes
USB3 VisionNo

Controls a global setting of a specified Processing FPGA.

Syntax

AIL_INT MfpgaControl(
AIL_ID AilSystemId, //in
AIL_INT FpgaDeviceNumber, //in
AIL_INT64 ControlType, //in
const void * ControlValuePtr //in
)

Description

This function controls global settings of a specified Processing FPGA. See MfpgaCommandControl to retrieve information about a specific command context.

Note: Note that the FPGA module is not supported with Distributed Aurora Imaging Library.

Note: Note that the FPGA module is only supported on boards that support FPGA processing (Pro boards).

Parameters

AilSystemId (in, AIL_ID)

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

FpgaDeviceNumber (in, AIL_INT)

Specifies the Processing FPGA on the system to control. This parameter must be set to the following value:

For specifying the rank of the Processing FPGA

ValueDescription
M_DEVnSpecifies the rank of the Processing FPGA to control, where n can be a value between 0 and the total number of Processing FPGAs-1.

ControlType (in, AIL_INT64)

Specifies the Processing FPGA setting to control.

ControlValuePtr *(in, void)

Specifies the value to assign to the Processing FPGA setting.

Parameter Associations

For controlling Processing FPGA settings


M_ERROR

Sets whether basic parameter checking occurs. Note that, if enabled, this will also report errors when attempting to associate a command context to a PU not in the FPGA configuration, and when attempting to use an invalid interrupt.

ValueDescription
M_DEFAULT
M_PRINT_DISABLEDisables printing of error messages.
M_PRINT_ENABLE (default)Enables printing of error messages.

Return Value

Type: AIL_INT

The returned value is M_VALID if successful. If the operation fails, M_NULL is returned.

Copyright © 2026 Zebra Technologies.