Forum | Documentation | Website | Blog

Skip to content
Snippets Groups Projects

BVF Bitstream Builder

Introduction

The BVF bitstream builder is a Python script that builds both the PolarFire SoC HSS bootloader and Libero FPGA project into a single programming bitstream. It uses a list of repositories/branches specifying the configuration of the BVF to build.

Prerequisites

Python libraries

The following Python libraries are used:

  • GitPython
  • PyYAML
pip3 install gitpython
pip3 install pyyaml

Microchip Tools

The SoftConsole and Libero tools from Microchip are required by the bitstream builder.

The following environment variables are required for the bitstream builder to use the Microchip tools:

  • SC_INSTALL_DIR
  • FPGENPROG
  • LIBERO_INSTALL_DIR
  • LM_LICENSE_FILE

An example script for setting up the environment is available here.

Usage

python3 bvf-bitstream-builder.py <YAML Configuration File>

YAML Configuration Files

Configuration File Description
default.yaml Default gateware including default cape and M.2 interface.
minimal.yaml Minimal Linux system including Ethernet. No FPGA gateware.
full_io_stub.yaml Test configuration using all FPGA I/Os

Supported Platforms

The BVF bitstream builder has been tested on Ubuntu 20.04.