riscv-tools
This repository houses a set of RISC-V simulators 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, andpk
, a proxy kernel that
services system calls for a target-machine application by forwarding them to
the host machine
Several RISC-V tools that were previously maintained through this
repository have since been upstreamed to their parent projects and are
no longer included here. Your favorite software distribution should
already have packages for these upstream tools, but if it doesn’t then
here are a handful of my favorites:
-
Your favorite software distribution may already have packages that
include a RISC-V cross compiler, which is probably the fastest way to
get started. As of writing this README (March, 2019) I can trivially
find packages for ALT Linux, Arch Linux, Debian, Fedora, FreeBSD,
Mageia, OpenMandriva, openSUSE, and Ubuntu.
pkgs.org appears to be a good place to find an up
to date list, just search for “riscv”. -
crosstool-ng can build RISC-V
cross compilers of various flavors. -
The RISC-V Port of
OpenEmbedded
builds a cross compiler, Linux kernel, and enough of userspace to do
many interesting things. -
buildroot is a lighter
weight cross compiled Linux distribution.
This repository uses crosstool-ng to configure a riscv64-unknown-elf
toolchain.
Quickstart
$ 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.