1
0
mirror of https://github.com/rcore-os/rCore.git synced 2024-11-22 08:06:17 +04:00
rCore/README.md
2019-01-10 23:44:07 +08:00

61 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# rCore Plus
[![Build Status](https://travis-ci.org/wangrunji0408/RustOS.svg?branch=master)](https://travis-ci.org/oscourse-tsinghua/RustOS)
Rust version of THU [uCore OS Plus](https://github.com/chyyuu/ucore_os_plus).
Its former repo name is https://github.com/oscourse-tsinghua/RustOS .
Going to be the next generation teaching operating system.
Supported architectures: x86_64, RISCV32/64, AArch64 MIPS(future)
Tested boards: QEMU, labeled-RISCV, K210, Raspberry Pi 3B+
[Dev docs](https://rucore.gitbook.io/rust-os-docs/) (in Chinese)
![demo](./docs/2_OSLab/os2atc/demo.png)
## Building
### Environment
* [Rust](https://www.rust-lang.org) toolchain at nightly-2019-01-01
* Cargo tools: [cargo-xbuild](https://github.com/rust-osdev/cargo-xbuild)
* [QEMU](https://www.qemu.org) >= 3.1.0
* [bootimage](https://github.com/rust-osdev/bootimage) (for x86_64)
* [RISCV64 GNU toolchain](https://www.sifive.com/boards) (for riscv32/64)
* [AArch64 GNU toolchain](https://web.stanford.edu/class/cs140e/assignments/0-blinky/) (for aarch64)
### How to run
```bash
rustup component add rust-src
cargo install cargo-xbuild bootimage
```
```bash
git clone https://github.com//oscourse-tsinghua/rcore_plus.git --recursive
cd rcore_plus/kernel
rustup override set nightly-2019-01-01
make run arch={riscv32,riscv64,x86_64,aarch64}
```
## History
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](http://os.cs.tsinghua.edu.cn/oscourse/OS2018spring/projects/g11), [CECS](http://os.cs.tsinghua.edu.cn/oscourse/csproject2018/group05), [OST](http://os.cs.tsinghua.edu.cn/oscourse/OsTrain2018)
Reports (in Chinese): [docs](./docs)
It's based on [BlogOS](https://github.com/phil-opp/blog_os) , a demo project in the excellent tutorial [Writing an OS in Rust (First Edition)](https://os.phil-opp.com/first-edition/).
## License
The source code is dual-licensed under MIT or the Apache License (Version 2.0).