|0.2.0-alpha.3||Apr 27, 2021|
|0.2.0-alpha.2||Mar 14, 2021|
|0.2.0-alpha.1||Feb 23, 2021|
|0.1.1||Feb 1, 2021|
|0.0.2||Oct 20, 2020|
#220 in Embedded development
51 downloads per month
RISC-V Supervisor Binary Interface (SBI) implementation in Rust; runs on M-mode.
Binaries are available for platforms which can be found on platform support page. This page includes an instruction to write your own RustSBI implementation on production use, and some reference implementations for experiments.
- Functional and extensible operating system runtime
- Fully support to RISC-V SBI specification v0.2
- Adapted for unix-like operating systems
- Written in Rust
- Competitive to OpenSBI with most of its function
- Bundled with a test framework for SBI implementations
- Supports QEMU emulator (priv. spec v1.11)
- Backward compatible to Kendryte K210 with spec v1.9, MMU and S-Mode
The RustSBI project contains three parts: the RustSBI library
rustsbi, reference implementation
platform, and a simple operating system kernel to test SBI implementations in
The test kernel is used to test SBI functions. Boot this kernel using your platform, it will call all SBI calls and run instructions to test if underlying SBI environment is okay. if this kernel reports 'SUCCESS' and exits normally, it means that your SBI implementation is correct.
- Can I use RustSBI on C based kernels?
Yes, you can! RustSBI strictly follows RISC-V SBI standard. All features are prepares for all programming languages, as long as they support RISC-V SBI defined calling convention.
If your kernel language supports other SBI implementations, typically it will support RustSBI in the same way.
This project is originally a part of rCore Summer of Code 2020 activities, now it is capable of running rCore-Tutorial and other OS kernels on wide supported RISC-V devices.
Blog article (Chinese):
- Design and Implementation of RustSBI, Dec 2020
- The Rust Embedded System Development, Dec 2020
- Operating Systems on Rust and RISC-V, Aug 2020
- RustSBI can be used as a library. Under normal circumstances, RustSBI platform can be implemented
with embedded Rust's
- On both QEMU and K210 platform, we supports CLINT and PLIC peripherals. Embedded Rust's community
still need more SoCs taped out to discuss on common libraries on RISC-V ecosystem. After these works
are done, we may use crates then to implement QEMU, without the
halmodule we have now.
- Contributions are welcomed! We welcome to implement RustSBI for both FPGA cores and real cores. Implementations for emulators are also welcomed. Fire a pull request if you are ready!
This project is licensed under either of
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
- Mulan PSL v2 (LICENSE-MULAN or https://opensource.org/licenses/MulanPSL-2.0)
This project contains documents from RISC-V SBI specification repository. These documents are (C) RISC-V community under CC-BY 4.0 license.
Reference implementaion K210 includes Kendryte K210 DTS file from Western Digital, this file is (C) Western Digital Corporation or its affiliates under BSD-2-Clause license.