mirror of
https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials.git
synced 2024-11-11 07:10:59 +00:00
32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# Tutorial 01 - Wait Forever
|
|
|
|
## tl;dr
|
|
|
|
Project skeleton is set up; Code just halts all CPU cores.
|
|
|
|
- Toolchain: `cargo xbuild` tools (`xrustc`, `xclippy`) and the
|
|
`aarch64-unknown-none` target are used for building `AArch64` bare-metal code.
|
|
- `Makefile` targets:
|
|
- `doc`: Generate documentation.
|
|
- `qemu`: Run the `kernel` in QEMU
|
|
- `clippy`
|
|
- `clean`
|
|
- `readelf`: Inspect the `ELF` output.
|
|
- `objdump`: Inspect the assembly.
|
|
- `nm`: Inspect the symbols.
|
|
- Code is organized into `kernel` and `BSP` (Board Support Package) parts.
|
|
- Conditional compilation includes a `BSP` according to user-supplied
|
|
arguments.
|
|
- Custom `link.ld` linker script.
|
|
- Load address at `0x80_000`
|
|
- Only `.text` section.
|
|
- `main.rs`: Important [inner attributes]:
|
|
- `#![no_std]`, `#![no_main]`
|
|
- Assembly `_start()` function that executes `wfe` (Wait For Event), halting all
|
|
cores that are executing `_start()`.
|
|
- We (have to) define a `#[panic_handler]` function.
|
|
- Done in `BSP` code.
|
|
- Just executes `wfe`.
|
|
|
|
[inner attributes]: https://doc.rust-lang.org/reference/attributes.html
|