riscv-emu

Linux Userspace emulator for RV64I ELF binaries.

• Written in modern C++23.
• Standard-Compliant RV64I instruction set
• Tested using the official RISCV test suite.
• Support for GDB Remote Debugging via GDB RSP
• Interactive REPL

Build Instructions

Requirements

• C++23 Toolchain (tested on gcc/clang)
• CMake
• Ninja (optional, for faster builds)
• Just (optional, for more convenient running of builds/tests)
• Python (optional, for testing with RISCOF)

Build

cmake -B build && cmake --build build

Faster builds with Ninja

cmake -B build -GNinja && cmake --build build

Running the Test Suite

ctest --test-dir ./build

With Just:

just build
just test

Running The Official Test Suite

cd test/
python -m venv venv
. ./venv/bin/activate
pip install riscof
./run.sh

Developer Resources

• Online Decoder
• RISCV Cheat Sheet
• RISCV Cheat Sheet 2
• RISCV Instruction Documentation
• RISCV Instruction Documentation 2
• RISCV Linux Syscalls
• RISCV Overview Slides
• RISCV Official ISA Documentation
• GDB RSP Docs

Building a Crosscompiler for RV64I

git clone --depth 1 https://github.com/riscv-collab/riscv-gnu-toolchain.git
./configure --prefix=<your_prefix> --with-arch=rv64i --with-abi=lp64
make -j$(nproc)