No description
Find a file
2023-04-05 22:05:38 -04:00
.cargo improved(build): Purged Bash and Make with new build system 2021-01-20 20:56:31 -06:00
.reuse Merge IDL code (#8) 2022-11-06 10:20:56 -05:00
.vscode feat(collections): Add HashMap, DoublyLinkedList, and LruCache impls 2023-01-29 16:05:08 -05:00
assets fix(README.md): Correct some changes, update screenshot 2021-04-09 21:27:06 -04:00
LICENSES chore(everything): yay license stuff 2021-04-08 20:28:42 -04:00
src feat(vanadinite): Add the ability to delete caps and overhaul some memory related stuff 2023-04-05 22:05:38 -04:00
submodules Merge IDL code (#8) 2022-11-06 10:20:56 -05:00
xtask Scheduler refactor (#9) 2022-11-27 10:11:09 -05:00
.gitignore feat(collections): Add HashMap, DoublyLinkedList, and LruCache impls 2023-01-29 16:05:08 -05:00
.gitmodules feat(vanadinite, xtask): Add support for running vanadinite with spike! 2021-04-05 21:33:11 -04:00
LICENSE chore(license): change license to MPL 2.0 2020-11-11 17:31:39 -05:00
README.md fix(README.md): Correct some changes, update screenshot 2021-04-09 21:27:06 -04:00
rust-toolchain.toml chore: Update syn version 2023-03-30 20:41:25 -04:00
rustfmt.toml Merge IDL code (#8) 2022-11-06 10:20:56 -05:00

vanadinite

A RISC-V (RV64GC) microkernel written in Rust

License

The source code in this project is licensed under the Mozilla Public License 2.0

Building

Vanadinite and Userspace

The Rust riscv64gc-unknown-none-elf toolchain must be installed, then run cargo xtask build vanadinite to build the kernel ELF, or cargo xtask build userspace to build the userspace executables and package them in a tar file in the root directory. Note: building the kernel will automatically build and package the userspace binaries.

OpenSBI

Building the OpenSBI firmware image requires you to have the riscv64-unknown-elf- binutils package installed. For Arch users, you can install the following packages: riscv64-unknown-elf-gdb, riscv64-unknown-elf-binutils, riscv64-unknown-elf-newlib. If the tools are installed, run cargo xtask build opensbi to build the SBI firmare image and place it in the root directory for use by QEMU.

Running

Requirements

You will need to have the qemu-system-riscv64 QEMU executable installed and in your path.

Running

To run, execute cargo xtask run. By default, this will run vanadinite on the QEMU virt machine, if you would like to run for a different platform (e.g. sifive_u) or change the machine properties, see cargo xtask run --help for a full list of available options. If QEMU is not installed, the spike simulator can be built and used as an alternative, however it does not support all the same functionality as running with QMEU. You will also want to pass in console=sbi as a kernel arg to get output.

Default settings are:

        Platform: virt
          # CPUs: 4
             RAM: 512M
Kernel Arguments: ""
       Simulator: QEMU

To exit QEMU press: Ctrl+A + x

Screenshots!

Running the shell