crate | ||
docs | ||
kernel | ||
riscv-pk | ||
user | ||
.gitignore | ||
.gitmodules | ||
.travis.yml | ||
README.md | ||
status.md |
RustOS
Rust port for uCore OS, supporting x86_64 and riscv32i.
Dev docs (in Chinese)
Summary
This is a project of THU Operating System (2018 Spring) && Comprehensive Experiment of Computer System (2018 Summer).
Project wiki (internal access only): OS, CECS
Reports (in Chinese): MidReport, FinalReport, RISCV port note
The initial goal is to write a mini OS in Rust with multi-core support. More specifically, it would start from the post of the Writing an OS in Rust series, then reimplement xv6-x86_64 in Rust style.
In fact, it's more complicated than we expected to write an OS starting from scratch. So by the end of OS course, we only finished rewriting ucore_os_lab, without multi-core support. Then as a part of CECS project, we ported it from x86_64 to RISCV32I, and made it work on our FPGA CPU.
Building
Environment
- Rust toolchain at nightly-2018-09-18
- Cargo tools: cargo-xbuild, bootimage
- QEMU >= 2.12.0
- RISCV64 GNU toolchain (for riscv32)
How to run
rustup component add rust-src
cargo install cargo-xbuild bootimage
git clone https://github.com/wangrunji0408/RustOS.git --recursive
cd RustOS/kernel
rustup override set nightly-2018-09-18
make run arch=riscv32|x86_64
# For FPGA:
# make run arch=riscv32 board=1
License
The source code is dual-licensed under MIT or the Apache License (Version 2.0).