Learn more

Reference

Learn more

These docs stay focused on the supervision layer and link out for foundations. The pages below are the ones worth bookmarking.

Rust and async

• The Rust book - the language, from ownership onward.
• Asynchronous Programming in Rust
  • the futures model: state machines, wakers, executors.
• The Embedded Rust Book - no_std, HALs, cross-compiling, and the embedded-hal trait family.
• The Embedded Rust Discovery Book
  • hands-on, if you learn best from hardware.

Embassy

• The embassy book - tasks, executors, time, sync primitives, and HAL usage.
• embassy executor docs - what #[embassy_executor::task] really does, task pools, Spawner, and the interrupt-executor tiers this supervisor places tasks across.
• embassy time - timers, tickers, and the mock driver used in desktop tests.
• embassy sync - Signal, Watch, Channel, Mutex: the primitives the dataflow layer declares over.
• The embassy FAQ - async patterns, pitfalls, and why things are the way they are.

Ecosystem

• defmt - efficient logging for embedded, the usual log backend on target.
• probe-rs - flashing and debugging, including the RP2350 the reference firmware runs on.
• embedded-hal - the driver trait abstractions your workers consume.
• bytemuck - Zeroable, behind the state: zeroed Type clause.

This project

• GitHub repository - source, the reference firmware, the bootloader and the host tools.
• 0.4 to 0.5 migration table
  • what changed between the releases, row by row.
• embassy-supervisor on crates.io and on docs.rs - the API, item by item.
• Video walkthrough - the architecture in one sitting: the declaration, the guarantees, executor tiers, the lifecycle matrix.
• embassy-supervisor-observe
  • the facade a signal library implements in one line.
• embassy-supervisor-tools
  • supervisor-mermaid and supervisor-lint, installable with cargo install embassy-supervisor-tools.