Skip to main content

Python API for interacting with National Instrument's LabVIEW FPGA Devices

Project description

FPGA Interface Python API

The National Instruments FPGA Interface Python API is used for communication between processor and FPGA within NI reconfigurable I/O (RIO) hardware such as NI CompactRIO, NI Single-Board RIO, NI FlexRIO, and NI R Series multifunction RIO.

With the FPGA Interface Python API, developers can use LabVIEW FPGA to program the FPGA within NI hardware and communicate to it from Python running on a host computer. This gives engineers and scientists with Python expertise the ability to take advantage of compiled LabVIEW FPGA bitfiles, also the option to reuse existing Python code.

NiFpga can be installed by cloning the master branch and then in a command
line in the directory of run:

pip install --pre .

Or by installing from PyPI using:

pip install nifpga


The FPGA Interface Python API is session based. LabVIEW FPGA will generate
bitfiles (.lvbitx) that can be used to program the hardware. For additional
information on sessions view our Read the docs documentation

Example usage of FPGA configuration functions:

with Session(bitfile="BitfilePath.lvbitx", resource="RIO0") as session:
except FpgaAlreadyRunningWarning:

NOTE: It is always recommended that you use a Session with 'with'.
Opening a Session without 'with' could cause you to leak it if close is not

Controls and indicators are used to transmit small amounts of data to and from
the FPGA. The controls and indicators accessible by the FPGA Interface Python
API are from the front panel of the top level VI from the LabVIEW FPGA code that
was built into the bitfile. Accessing a control or indicator is done via its
unique name from Sessions's register property.

my_control = session.registers["MyControl"]
data =

FIFOs are used for streaming data to and from the FPGA. A FIFO is accessible by
the FPGA Interface Python API via the top level VI from LabVIEW FPGA code.

myHostToFpgaFifo = session.fifos["MyHostToFpgaFifo"]
actual_depth = myHostToFpgaFifo.configure(requested_depth=4096)
empty_elements_remaining = myHostToFpgaFifo.write(data=[1, 2, 3, 4], timeout_ms=2)

myFpgaToHostFifo = session.fifos["MyHostToFpgaFifo"]
read_values =, timeout_ms=0)

See our readthedocs documentation for more detailed examples.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nifpga, version 17.0.0
Filename, size File type Python version Upload date Hashes
Filename, size nifpga-17.0.0-py2.py3-none-any.whl (24.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page