How to build the BeagleV-Fire Gateware on Windows#
Introduction#
The BeagleV Fire gateware 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 BeagleV Fire to build.
Prerequisites#
Tools#
To be able to use the bitstream builder on Windows, you will need to install the following tools:
Msys2-Mingw
Make
wsl
Please follow the installation instructions for Msys2 available at https://www.msys2.org/wiki/MSYS2-installation/
When installing make in your mysys2 terminal you’re recommended to use the default command
pacman -S make
For those requiring a specific version of make, refer to the porting guide at https://www.msys2.org/wiki/Porting/
pacman -S <target>-make
Ensure that the Msys2 bin path (e.g., C:msys64usrbin) is added to your system’s environment variable PATH.
To enable and install WSL, follow these steps:
Search for “Turn Windows features on or off” in the Windows start menu.
Select “Windows Subsystem for Linux” and click OK.
Open a command prompt as an administrator and execute:
wsl.exe --install
After installing the necessary tools, proceed to the repository and follow the instructions in the README to build the bitstream on Windows
Repository#
Access the BeagleV-Fire gateware builder repository at https://openbeagle.org/cyril-jean/gateware-maintenance/
Note
If you encounter an end-of-line error (CRLF/LF) during the build process, change the local Git configuration core.autocrlf to false and clone the repository again
git config --global core.autocrlf false
Note
Should the build fail due to an unrecognized Python package, despite the package being installed, it may be due to multiple Python/pip versions. Reinstall the package using.
python -m pip install <package-name>
Verify that the LM_LICENSE_FILE environment variable includes licenses for all required programs to avoid silent errors during the build process