Archives
/
rust-raspberrypi-OS-tutorials
mirror of https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
📚 Learn to write an embedded OS in Rust 🦀
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
264 Commits
1 Branch
1 Tag
28 MiB
Rust 82.3%
Makefile 8.4%
Ruby 5.9%
Assembly 3.2%
Dockerfile 0.1%
 
 
 
 
 
master
original_version
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '29d992615d'
${ noResults }
Go to file
Andre Richter 29d992615d
Adapt tooling settings 		5 years ago
.githooks Initial preparations for rewrite 5 years ago
01_wait_forever Adapt tooling settings 5 years ago
02_runtime_init Adapt tooling settings 5 years ago
03_hacky_hello_world Adapt tooling settings 5 years ago
04_zero_overhead_abstraction Adapt tooling settings 5 years ago
05_safe_globals Adapt tooling settings 5 years ago
06_drivers_gpio_uart Adapt tooling settings 5 years ago
07_uart_chainloader Adapt tooling settings 5 years ago
doc Initial preparations for rewrite 5 years ago
docker Change some more license headers to SPDX 5 years ago
utils Adapt tooling settings 5 years ago
.gitignore Ignore cargo built files 5 years ago
.rubocop.yml Adapt tooling settings 5 years ago
.rustfmt.toml Adapt tooling settings 5 years ago
LICENSE Initial preparations for rewrite 5 years ago
README.md Rustup 1.20 searches for components itself 🎉 5 years ago
contributor_setup.sh Add a pre-commit hook 5 years ago

README.md

Operating System development tutorials in Rust on the Raspberry Pi 3

Notice

This is a work-in-progress rewrite, started on September 2019. I will first add code and minimal READMEs, and later write accompanying full-fledged tutorial text.

  • Check out the make doc command to browse the code with HTML goodness.
  • Note that the branch is subject to frequent force pushing. If updates happened since you last visited, make sure to clone a clean copy to be safe.
  • For editing, I recommend Visual Studio Code with the Rust Language Server extension.
  • For practical purposes, the kernel will be a classic monolith.

Cheers, Andre

Prerequisites

Before you can start, you'll need a suitable Rust toolchain.

curl https://sh.rustup.rs -sSf  \
    |                           \
    sh -s --                    \
    --default-toolchain nightly \
    --component rust-src llvm-tools-preview clippy rustfmt rls rust-analysis

cargo install cargo-xbuild cargo-binutils

USB Serial

I'd also recommend to get an USB serial debug cable. You connect it to the GPIO pins 14/15.

Tutorial 6 is the first where you can use it. Earlier tutorials will work solely with QEMU.

UART wiring diagram

License

Licensed under the MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT).