No Description

Zhouqi Jiang 4821073b56 spec: binary: optimize `count`, `last`, `min`, `max` and `is_sorted` to O(1) for iterator `HartIds` 6 days ago
.github b47ef25c9b feat(ci): split github workflow files into Rust, DCO and Changelog 1 month ago
examples 2753980672 tests: add missing default trait function overrides 11 months ago
macros be334934d5 macros: prepare for release version 0.0.2 7 months ago
sbi-rt 0837da8fc3 spec: prepare to release `sbi-spec` version 0.0.8 1 month ago
sbi-spec 4821073b56 spec: binary: optimize `count`, `last`, `min`, `max` and `is_sorted` to O(1) for iterator `HartIds` 6 days ago
sbi-testing 0837da8fc3 spec: prepare to release `sbi-spec` version 0.0.8 1 month ago
src aae21f2f79 rt: re-export CounterMask for `sbi-rt` and `rustsbi` 1 month ago
tests 7811ca99c5 fix(pmu): add missing `pmu_snapshot_set_shmem` function. 1 month ago
.gitignore cf5af1439c gitignore: change file according to alternation of project structure 2 years ago
CHANGELOG.md aae21f2f79 rt: re-export CounterMask for `sbi-rt` and `rustsbi` 1 month ago
Cargo.toml 0837da8fc3 spec: prepare to release `sbi-spec` version 0.0.8 1 month ago
LICENSE-MIT b8e0e3f641 readme: modify project description 2 years ago
LICENSE-MULAN c28a7738f6 Update LICENSE-MULAN 1 year ago
README.md 9acff1a98b lib: RustSBI supports RISC-V SBI 2.0 ratified 10 months ago
rustfmt.toml e4f841ce72 Use Rustfmt to reformat code 3 years ago

README.md

RustSBI

RISC-V Supervisor Binary Interface (SBI) library in Rust; runs on M-mode or HS mode.

crates.io Documentation License

Binary downloads

Most users would get RustSBI binary download from the RustSBI Prototyping System. Check out the link here to download binary package for your platform.

Boards, SoC vendors and research groups would provide dedicated RustSBI package for supported platforms. There are packages exists on awesome-rustsbi: it is a curated list of awesome things related to RustSBI, which includes some implementation projects maintained by individuals or the community.

Users on commercial boards may visit implementation specific distribution links depending on the platforms they need, or consult vendors if they provide discrete RustSBI package support.

Minimum supported Rust version

To compile RustSBI library, you need at least stable Rust version of rustc 1.65.0.

Build this project

RustSBI is usually used as a library or dependency. If you wish to, you may build RustSBI library itself using the following command:

cargo build

The build should finish without any errors.

Building under native platform will allow development of hypervisors and emulators. To cross-build for a RISC-V platform environment, you may install the target and build onto it instead:

# If you don't have the cross compile target installed, install it first
rustup target add riscv64imac-unknown-none-elf
# Build this project as library
cargo build --target riscv64imac-unknown-none-elf

The target platform of RISC-V platform firmware is usually a bare metal target. Under normal circumstances these targets in Rust would start with riscv??- and end with -none-elf.

Features

  • Feature rich and extensible operating system runtime
  • Empower support, compatibility for machines, hypervisors and emulators
  • Support to and develop with RISC-V SBI specification v2.0 ratified
  • Written in Rust, builds under stable Rust
  • Capable to develop with other firmware ecosystem projects
  • Adapted for operating system kernel models on your choice

Frequently asked questions

  1. How would I build a RustSBI implementation?

RustSBI have extensive documents on such purposes! No matter what you are building with it, you will find some documents about RustSBI on bare-metal environments, hypervisors and emulators.

Check it out at RustSBI document main page.

  1. 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, usually it will support RustSBI in the same way.

Talks and documents

This project is originally a part of rCore Summer of Code 2020 activities, inspired by MeowSBI and other similar projects. Now it is capable of running rCore-Tutorial and other OS kernels on wide supported RISC-V devices.

There are multiple talks related to RustSBI dated back to Aug 2020. These talks discuss from design and abstraction of RustSBI modules, to actual production and research usage scenario related to RustSBI and RISC-V bootloaders. Public slides and blog articles of these talks are available at RustSBI/slides page.

Notes on platform implementation

  1. RustSBI should be used as a library. Under normal circumstances, RustSBI platform can be implemented with embedded Rust's embedded-hal libraries.
  2. Contributions are welcomed! We welcome to implement and test RustSBI for both FPGA cores and real cores. Implementations for emulators are also welcomed. If you are ready, start your own binary project and use RustSBI in it!
  3. If there is a bug in RustSBI project itself, fire an issue or pull request to let us know!

License & Copyright

This project is licensed under either of

Documents from RISC-V SBI Specification are used in this project. These documents are (C) RISC-V Foundation under Creative Commons Attribution 4.0 International License (CC-BY 4.0). The full license text is available at https://creativecommons.org/licenses/by/4.0/.