FireSim Repo Setup
Next, we’ll clone FireSim on your Manager Machine and run a few final setup steps using scripts in the repo.
Setting up the FireSim Repo
Machine: From this point forward, run everything on your Manager Machine, unless otherwise instructed.
We’re finally ready to fetch FireSim’s sources. This should be done on your Manager Machine. Run:
git clone https://github.com/firesim/firesim
# checkout latest official firesim release
# note: this may not be the latest release if the documentation version != "stable"
git checkout 1.17.1
Next, we will bootstrap the machine by installing Miniforge Conda, our software package manager, and set up a default software environment using Conda.
You should select a location where you want Conda to be installed. This can be an existing Miniforge Conda install, or a directory (that does not exist) where you would like Conda to be installed.
REPLACE_ME_USER_CONDA_LOCATION in the command below with your chosen path and run it:
./scripts/machine-launch-script.sh --prefix REPLACE_ME_USER_CONDA_LOCATION
Among other setup steps, the script will install Miniforge Conda (https://github.com/conda-forge/miniforge) and create a default environment called
When prompted, you should allow the Conda installer to modify your
~/.bashrc to automatically place you in the Conda environment when opening a new shell.
machine-launch-script.sh completes, ensure that you log out of the
machine / exit out of the terminal so that the
.bashrc modifications can apply.
After re-logging back into the machine, you should be in the
firesim Conda environment.
Verify this by running:
conda env list
If you are not in the
firesim environment and the environment exists, you can run the following to “activate” or enter the environment:
conda activate firesim
Next, return to your clone of the FireSim repo and run:
build-setup.sh script will validate that you are on a tagged branch,
otherwise it will prompt for confirmation. Then, it will automatically
initialize submodules and install the RISC-V tools and other dependencies.
build-setup.sh completes, run:
source sourceme-manager.sh --skip-ssh-setup
This will perform various environment setup steps, such as adding the RISC-V tools to your path. Sourcing this the first time will take some time – however each subsequent sourcing should be instantaneous.
Every time you want to use FireSim, you should
your FireSim directory and source
sourceme-manager.sh again with the arguments shown above.
Initializing FireSim Config Files
The FireSim manager contains a command that will automatically provide a fresh set of configuration files for a given platform.
To run it, do the following:
firesim managerinit --platform xilinx_alveo_u250
This will produce several initial configuration files, which we will edit in the next section.
Configuring the FireSim manager to understand your Run Farm Machine setup
As our final setup step, we will edit FireSim’s configuration files so that the manager understands our Run Farm machine setup and the set of FPGAs attached to each Run Farm machine.
Inside the cloned FireSim repo, open up the
deploy/config_runtime.yaml file and set the following keys to the indicated values:
default_simulation_dirshould point to a temporary simulation directory of your choice on your Run Farm Machines. This is the directory that simulations will run out of.
run_farm_hosts_to_useshould be a list of
- IP-address: machine_specpairs, one pair for each of your Run Farm Machines.
IP-addressshould be the IP address or hostname of the system (that the Manager Machine can use to ssh into the Run Farm Machine) and the
machine_specshould be a value from
run_farm_host_specsin deploy/run-farm-recipes/externally_provisioned.yaml. Each spec describes the number of FPGAs attached to a system and other properties about the system.
Here are two examples of how this could be configured:
Example 1: Your Run Farm has a single machine with one FPGA attached and this machine is also your Manager Machine:
- localhost: one_fpgas_spec
Example 2: You have two Run Farm Machines (separate from your Manager Machine). The Run Farm Machines are accessible from your manager machine with the hostnames
firesim-runner2.berkeley.edu, each with eight FPGAs attached.
- firesim-runner1.berkeley.edu: eight_fpgas_spec
- firesim-runner2.berkeley.edu: eight_fpgas_spec
Then, run the following command so that FireSim can generate a mapping from the FPGA ID used for JTAG programming to the PCIe ID used to run simulations. If you ever change the physical layout of the machine (e.g., which PCIe slot the FPGAs are attached to), you will need to re-run this command.
This will generate a database file in
/opt/firesim-db.json on each Run Farm Machine that has this mapping.
Now you’re ready to run your first FireSim simulation! Hit Next to continue with the guide.