FFP Control Software

The control software for FFP runs on your computer and uses the FFP hardware to program an FPGA or SPI flash. It is written in Rust.

Pre-built Binaries

Pre-built binaries are available for Windows and Linux on the [Releases] page. You must have [libusb] installed or available on your system.

Build Requirements

You must have a working Rust compiler installed. Visit rustup.rs to install Rust.
You'll need to set up drivers or permissions to access the USB device, see the drivers page for more details.

Building

cargo build --release

You can either run the ffp executable directly from target/release/ffp, or install it for your user using cargo install --path ..

Installing

FFP software can be installed directly using Cargo:

cargo install ffp

Usage

Run ffp help for detailed usage. Commonly used commands:

ffp fpga program bitstream.bin
ffp fpga reset
ffp fpga power on
ffp flash id
ffp flash program bitstream.bin

Python Alternative

The prototype for this software was written as a Python script which is also available (prog.py).

Cross-Compiling for Windows from Linux

From a stock Ubuntu 18.04 image, the following commands generate an ffp.exe suitable for 64-bit Windows:

```sh $ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

(accept defaults)

$ source $HOME/.cargo/env $ cd /tmp $ rustup target add x8664-pc-windows-gnu $ apt install -y p7zip-full build-essential gcc-mingw-w64-x86-64 libusb-1.0 pkg-config $ wget https://github.com/libusb/libusb/releases/download/v1.0.23/libusb-1.0.23.7z $ 7z x libusb-1.0.23.7z $ git clone https://github.com/adamgreig/ffp $ cd ffp/software $ mkdir .cargo $ echo -e '[target.x8664-pc-windows-gnu]\nlinker = "x8664-w64-mingw32-gcc"\nrustflags = [ "-L", "/tmp/MinGW64/dll/"]' > .cargo/config $ env PKGCONFIGALLOWCROSS=1 cargo build --release --target x86_64-pc-windows-gnu ```

The resulting binary is target/x86_64-pc-windows-gnu/release/ffp.exe. It needs the libusb-1.0.dll file from /tmp/MinGW64/dll/ available on the Windows system, either in the same directory as ffp.exe or installed system-wide.