fpgaconf

SYNOPSIS

fpgaconf [-hvn] [-b <bus>] [-d <device>] [-f <function>] [-s <socket>] <gbs>

DESCRIPTION

fpgaconf writes accelerator configuration bitstreams (also referred to as “green bitstreams” to an FPGA device recognized by OPAE. In the process, it also checks the green bitstream file for compatibility with the targeted FPGA and its current infrastructure bitstream (the “blue bistream”). fpgaconf takes the following arguments:

-h, --help

Print usage information

-v, --verbose

Print more verbose messages while enumerating and configuring. Can be given more than once

-n, --dry-run

Perform enumeration, but skip any operations with side-effects (like the actual configuration of the bitstream

-b, --bus

PCI bus number of the FPGA to target

-d, --device

PCI device number of the FPGA to target

-f, --function

PCI function number of the FPGA to target

-s, --socket

Socket number of the FPGA to target

fpgaconf will enumerate available FPGA devices in the system and select compatible FPGAs for configuration. If there are more than one candidate FPGAs that are compatible with the given green bitstream, fpgaconf will exit and ask you to be more specific in selecting the target FPGAs (e.g. by specifying a socket number, or a PCIe bus/device/function).

EXAMPLES

fpgaconf my_green_bitstream.gbs

Program “my_green_bitstream.gbs” to a compatible FPGA

fpgaconf -v -s 0 my_green_bitstream.gbs

Program “my_green_bitstream.gbs” to the FPGA in socket 0, if compatible, while printing out slightly more verbose information