rCore-Tutorial version 3.5. See the Documentation in Chinese.
This project aims to show how to write an Unix-like OS running on RISC-V platforms from scratch in Rust for beginners without any background knowledge about computer architectures, assembly languages or operating systems.
- Platform supported:
qemu-system-riscv64
simulator or dev boards based on Kendryte K210 SoC such as Maix Dock - OS
- concurrency of multiple processes
- preemptive scheduling(Round-Robin algorithm)
- dynamic memory management in kernel
- virtual memory
- a simple file system with a block cache
- an interactive shell in the userspace
- only 4K+ LoC
- A detailed documentation in Chinese in spite of the lack of comments in the code(English version is not available at present)
TODO:
Now we are still updating our project, you can find latest changes on branches chX-dev
such as ch1-dev
. We are intended to publish first release 3.5.0 after completing most of the tasks mentioned below.
- automatically clean up and rebuild before running our project on a different platform
- fix
power
series application in early chapters, now you can find modulus in the output - use
UPSafeCell
instead ofRefCell
orspin::Mutex
in order to access static data structures(now ch4 completed) - move
TaskContext
intoTaskControlBlock
instead of restoring it in place on kernel stack(since ch3), eliminating annoyingtask_cx_ptr2
- replace
llvm_asm!
withasm!
(now ch4 completed)
- adjust API of
UPSafeCell
so that it cannot be borrowed twice at a time - bug fix: we should call
find_pte
rather thanfind_pte_create
inPageTable::unmap
- add a new chapter about synchronization & mutual exclusion(uniprocessor only)
- give every non-zero process exit code an unique and clear error type
- effective error handling of mm module
- rewrite practice doc and remove some inproper questions
- provide smooth debug experience at a Rust source code level
- format the code using official tools
- support Allwinner's RISC-V D1 chip
-
rustc: 1.55.0-nightly (2f391da2e 2021-07-14)
-
qemu: 5.0.0
-
rustsbi-lib: 0.2.0-alpha.4
rustsbi-qemu: d4968dd2
rustsbi-k210: b689314e
We will add them later.