https://github.com/sh4d1/rustberry
Small OS for RaspberryPi 3 written in Rust
https://github.com/sh4d1/rustberry
aarch64 armv8 bare-metal kernel os raspberry raspberry-pi-3 rpi3 rust
Last synced: about 1 month ago
JSON representation
Small OS for RaspberryPi 3 written in Rust
- Host: GitHub
- URL: https://github.com/sh4d1/rustberry
- Owner: Sh4d1
- License: mit
- Created: 2018-07-09T10:11:27.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-18T11:46:33.000Z (almost 7 years ago)
- Last Synced: 2025-04-15T10:15:24.991Z (about 1 month ago)
- Topics: aarch64, armv8, bare-metal, kernel, os, raspberry, raspberry-pi-3, rpi3, rust
- Language: Rust
- Homepage:
- Size: 38.1 KB
- Stars: 16
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Rustberry OS
This is a WIP kernel for RaspberryPi 3 written in Rust.
Some code is taken from this [Stanford class](https://web.stanford.edu/class/cs140e).
## Requirements
You will nedd a nightly Rust installation. The fastest way is to use [rustup](https://rustup.rs/).
You will also need some tools, you can install the whole toolchain with:
```shell
$ curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly
$ rustup component add rust-src llvm-tools-preview
$ cargo install cargo-xbuild cargo-binutils
```
## Building
* To build a debug kernel: `DEBUG=1 make`
* To build a release kernel: `make`
## Running
### QEMU
To run the kernel in QEMU you can either run (you will need QEMU):
* `make run`
* `qemu-system-aarch64 -kernel build/kernel8.img -M raspi3 -serial null -serial mon:stdio`
## Testing (WIP)
`make test`