Bootstrap

The LiteX Build Environment provides a bootstrap script to download and set up the environment automatically.

Run the bootstrap script to build an environment required for building the firmware:

curl -fsS https://raw.githubusercontent.com/timvideos/litex-buildenv/master/scripts/bootstrap.sh | bash

If you are not building from timvideos or the master branch set GITHUB_USER and GIT_BRANCH before running a bootstrap command like below;

export GIT_BRANCH=my-cool-branch
export GITHUB_USER=mithro
curl -fsS https://raw.githubusercontent.com/$GITHUB_USER/litex-buildenv/$GIT_BRANCH/scripts/bootstrap.sh | bash

Check that the final line of output is:

Bootstrap: Set up complete, you're good to go!

This;

• clones the litex-buildenv repository,
• adds the timvideos fpga-support PPA,
• installs packages required, then
• downloads litex and its dependencies.

Depending on your connection speed this could take a while to download.

This script will object if you already have cloned the litex-buildenv repo into the same directory before, remove or rename the existing repo if you want to run the script again.

NOTE: This script requires sudo access (and will ask for your sudo password) to install required software and dependencies. See scripts/download-env-root.sh to see what is installed.