How to Use This Guide

This guide is organized as a progression of chapters that build on each other. It is recommended to go in order, since later chapters assume knowledge and setup from earlier ones. Each chapter includes explanations, code examples, and often an exercise or challenge for you to try. These exercises are typically short (a few minutes each) and give you hands-on practice – don’t skip them! You’ll learn more by doing. By the end of the guide, you’ll have two versions of a small project (one using a traditional HAL, one using async Embassy) that blink an LED and communicate over serial, plus familiarity with how to extend these to real-world tasks (like reading sensors or handling multiple tasks concurrently).

Throughout the text, we include citations to external sources and documentation for deeper reference.¹ If you’re reading this in a medium that supports it, you can click those to see the source. We also include occasional images or diagrams to illustrate points (with captions and attribution).

Alright, let’s dive in!

1. https://rust-lang.github.io/mdBook/format/markdown.html ↩