riscv-rust

riscv-rust is a RISC-V processor emulator project written in Rust.

Demo

You can run Linux or xv6 on the emulator in your browser. Online demo is here

Features

Emulate RISC-V processor and peripheral devices
Stable as Linux and xv6-riscv run on it
Runnable locally
Also runnable in browser with WebAssembly

Screenshots

animation

Instructions/Features support status

[x] RV32/64I
[x] RV32/64M
[x] RV32/64F (partially)
[x] RV32/64D (partially)
[ ] RV32/64Q
[x] RV32/64A (partially)
[x] RV64C/32C (partially)
[x] RV32/64Zifencei (partially)
[x] RV32/64Zicsr (partially)
[x] CSR (partially)
[x] SV32/39
[ ] SV48
[x] Privileged instructions (partially)
[ ] PMP

etc...

How to build riscv-rust and run Linux or xv6

Build core library

sh $ git clone https://github.com/takahirox/riscv-rust.git $ cd riscv-rust $ cargo build --release

Run CLI application

```sh $ cd riscv-rust/cli

Run Linux

$ cargo run --release ../resources/linux/bbl -f ../resources/linux/busybear.bin -d ../resources/linux/dtb.dtb

Run xv6

$ cargo run --release ../resources/xv6/kernel -f ../resources/xv6/fs.img ```

Build WebAssembly and run in the browser

Prerequirements - Install wasm-bindgen client

```sh $ cd riscv-rust/wasm $ bash build_wasm.sh

boot local server and access riscv-rust/wasm/public/index.html

```

How to build and run riscv-tests

Prerequirements - Install riscv-gnu-toolchain - Install riscv-tests

sh $ cd riscv-rust/cli $ cargo run $path_to_riscv_tets/isa/rv32ui-p-add -n

Links

Linux RISC-V port

Linux RISC-V port

xv6-riscv

xv6-riscv is the RISC-V port of xv6 which is UNIX V6 rewritten by MIT for x86 in the current C language.

Specifications