RustOS

Rust version of THU uCore OS.

Going to be the next generation teaching operating system.

Supported architectures: x86_64, RISCV32IMA(S/M), AArch64

Tested boards: QEMU, Raspberry Pi 3B+

Dev docs (in Chinese)

Summary

This is a project of THU courses:

• Operating System (2018 Spring)
• Comprehensive Experiment of Computer System (2018 Summer)
• Operating System Train (2018 Autumn)

Project wiki (internal access only): OS, CECS, OST

Reports (in Chinese): docs

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
• Cargo tools: cargo-xbuild, bootimage
• QEMU >= 2.12.0
• RISCV64 GNU toolchain (for riscv32)
• AArch64 GNU toolchain (for aarch64)

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
make run arch=riscv32|x86_64|aarch64

License

The source code is dual-licensed under MIT or the Apache License (Version 2.0).