This repository houses a set of RISC-V simulators, compilers, and other tools, including the following projects:

• Spike, the ISA simulator
• riscv-tests, a battery of ISA-level tests
• riscv-opcodes, the enumeration of all RISC-V opcodes executable by the simulator
• riscv-pk, which contains bbl, a boot loader for Linux and similar OS kernels, and pk, a proxy kernel that services system calls for a target-machine application by forwarding them to the host machine
• riscv-fesvr, the host side of a simulation tether that services system calls on behalf of a target machine

Several RISC-V tools that were previously maintained through this repository have since been upstreamed to their parent projects. Although this repository continues to contain versions of the following tools, they are now primarily supported and maintained via their parent projects:

• Binutils
• GCC, the GNU C Compiler
• GDB, the GNU Debugger
• glibc, the GNU C Library
• QEMU, an emulator
• Newlib, a C library
• OpenOCD

Your favorite software distribution should already have packages for these upstream tools, but if it doesn't then the RISC-V Port of OpenEmbedded is a great place to start!

$ git submodule update --init --recursive
$ export RISCV=/path/to/install/riscv/toolchain
$ ./build.sh

Ubuntu packages needed:

$ sudo apt-get install autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev libusb-1.0-0-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev device-tree-compiler pkg-config libexpat-dev

Fedora packages needed:

$ sudo dnf install autoconf automake @development-tools curl dtc libmpc-devel mpfr-devel gmp-devel libusb-devel gawk gcc-c++ bison flex texinfo gperf libtool patchutils bc zlib-devel expat-devel

Note: This requires a compiler with C++11 support (e.g. GCC >= 4.8). To use a compiler different than the default, use:

$ CC=gcc-5 CXX=g++-5 ./build.sh

Note for OS X: We recommend using Homebrew to install the dependencies (libusb dtc gawk gnu-sed gmp mpfr libmpc isl wget automake md5sha1sum) or even to install the tools directly. This repo will build with Apple's command-line developer tools (clang) in addition to gcc.