This page discusses how to set up your system in order to get riscv-atom up and running.
RISC-V Atom project has been developed and tested on ubuntu 20.04. However, It should work just fine on any other version of ubuntu with no or few additional packages.
Run apt update
This step is needed to make sure the apt package list is up to date.
$ sudo apt update
Install git, make, python3, gcc & other tools
GNU C/C++ compilers and Make and other essential build tools are conveniently packaged as
build-essential meta package.
$ sudo apt install git python3 build-essential
Verilator will be used By Atomsim to Verilate Verilog RTL into C++. We recommend installing latest stable verilator version using git quick install method
Install GTK Wave
GTKwave is a GUI tool to view waveforms stored as Value Change Dump (VCD) files.
$ sudo apt install gtkwave
Screen is a command line utility that can be used to connect to serial ports on linux. It will be used to estabilish a two-way serial communication with the AtomSim.
$ sudo apt install screen
Install RISC-V GNU Toolchain
We will be installing the RV64-Multilib toolchain
Further install instructions can be found here.
We recommend using the provided
install_toolchain.sh script to install the proper toolchain.
$ chmod +x install_toolchain.sh $ ./install_toolchain.sh
The following packages are optional and are only required for generating documentation using doxygen & sphinx
Doxygen a tool is used to generate C++ cource code documentation from =documentation comments= inside the C++ source files.
$ sudo apt install doxygen
Install sphinx & other python dependencies
Sphinx is used to generate the RISC-V Atom Documentation and User-Manual in PDF & HTML.
$ cd docs/ && pip install -r requirements.txt