/RVVM

The RISC-V Virtual Machine

Primary LanguageCGNU General Public License v3.0GPL-3.0

RVVM - The RISC-V Virtual Machine

Language grade: C/C++ version RISC-V Logo

RISC-V CPU & System software implementation written in С

What's working

  • Passes RISC-V compliance tests for both RV64 & RV32
  • OpenSBI, U-Boot, custom firmwares boot and execute properly
  • Linux, FreeBSD & other cool OSes fully work
  • Tracing JIT, multicore support, networking
  • Framebuffer graphics, working Xorg with mouse & keyboard, interactive shell through UART
  • Raw image mounted as rootfs

Tell me more...

  • Feature-complete RV64IMAFDC instruction set
  • Multicore support (SMP), SV32/SV39/SV48/SV57 MMU
  • Tracing RVJIT with x86_64, i386, ARM64, ARM, RISC-V backends (faster than QEMU, yay!)
  • Bootrom, kernel Image loading
  • DTB auto-generation, passing to firmware/kernel
  • RVVM Lib API for VM integration
  • UART 16550a-compatible text console
  • PLIC/CLIC, timers
  • PS2 Altera Controller, PS2 keyboard & mouse
  • Graphical framebuffer through X11/WinAPI
  • Generic PCI Bus
  • ATA hard drive (PIO / IDE UDMA over PCI)
  • OpenCores Ethernet through Linux TAP, WIP usernet
  • Poweroff/reset device

Building

Currently builds using GNU Make or CMake and tested on Linux, Windows, FreeBSD and MacOS systems. More build targets are going to be supported.

git clone https://github.com/LekKit/RVVM
cd RVVM
make
cd release.linux.x86_64

To cross-compile, pass CC=target-gcc and OS=target-os if the target OS differs from your host to make. You can configure the build with use flags

Examples:

make CC=aarch64-linux-gnu-gcc OS=linux ARCH=arm64 USE_FB=0 USE_NET=1 USE_JIT=1
make CC=aarch64-linux-android21-clang ARCH=arm64 OS=android USE_JIT=1
make CC=x86_64-w64-mingw32-gcc OS=windows ARCH=x86_64 USE_JIT=1
make ARCH=i386 CFLAGS=-m32

Alternatively, you can use CMake (hint, build binaries are not host arch suffixed):

git clone https://github.com/LekKit/RVVM
cd RVVM
mkdir build
cmake -S. -Bbuild
cmake --build build --target all
cd build

Running

./rvvm_x86_64 fw_jump.bin -kernel linux_Image -image rootfs.img -rv64 -mem 2G -smp 2 -res 1280x720

Argument explanation:

fw_jump.bin            Initial firmware, OpenSBI in this case
-kernel linux_Image    Kernel Image to be booted by SBI, etc
-image rootfs.img      Hard drive image to be mounted as rootfs
-rv64                  Enable RV64, RV32 is used by default
-mem 2G                Memory amount (may be suffixed by k/M/G), default 256M
-smp 2                 Amount of cores, single-core machine by default
-res 1280x720          Changes framebuffer & VM window resolution

Invoke "./rvvm_x86_64 -h" to see extended help.

Our team

  • LekKit: RVVM API, interpreter, RV64IMAFDC ISA, RISC-V Hart/MMU/Privileged/CSR, RVJIT Compiler, UART/RTC/FB/Syscon, codebase infrastructure
  • cerg2010cerg2010: Important fixes, initial RV64 work, PLIC/PS2/ATA/PCI/Ethernet/XCB window/FPU/FDT, ARM JIT backend
  • Mr0maks: Initial ideas, C/M extensions, VM debugger, CSR work, NS16550A UART, ARM mul intrinsics
  • 0xCatPKG: Userspace network, new argument parser, extended testing & fixes
  • Hoping to see more contributors here

TODO

  • Test FreeBSD, HaikuOS (FreeBSD generic kernel boots but i have no idea how to mount rootfs, too lazy to look at Haiku)
  • Improve RVVM Lib public API
  • Optimize RVJIT icache flush (zifence) (Requires MMU W^X tracking, perpage cache invalidation, other tricks)
  • SATA/SCSI/NVME (Most likely NVME)
  • Sparse HDD image format, compression/deduplication?
  • Userspace networking, sound?
  • Maybe virtio devices
  • Other peripherals
  • A lot more...
  • Userspace emulation?