embassy book

Welcome to the Embassy Handbook

Embassy is a modern asynchronous embedded framework for Rust, designed to make embedded development efficient, safe, and enjoyable. This handbook serves as your comprehensive guide to understanding and utilizing Embassy to its full potential.

What is Embassy?

Embassy is a game-changing framework that brings the power of async/await to embedded Rust development. It allows you to write concurrent, non-blocking embedded applications with ease, improving performance and reducing complexity.

What You'll Learn in this Handbook

This handbook will guide you through the essential aspects of Embassy, including:

  • Getting Started: Setting up your development environment and running your first Embassy application.
  • Core Concepts: Understanding the Embassy executor, tasks, and asynchronous programming model.
  • Hardware Abstraction Layer (HAL): Interacting with microcontrollers and peripherals using Embassy's HALs for STM32, nRF, and RP2040.
  • Key Features: Exploring Embassy's features such as time management, networking, USB, Bluetooth, and bootloading.
  • Best Practices: Learning recommended patterns and techniques for efficient and robust Embassy development.
  • Advanced Topics: Diving into more complex subjects like resource sharing, interrupt handling, and optimizing performance.
  • Real-world Examples: Discovering projects built with Embassy and how it's being used in practice.
  • Troubleshooting and FAQs: Addressing common issues and questions to help you overcome development hurdles.

Who is this Handbook For?

This handbook is for embedded developers of all levels who are interested in using Rust and the Embassy framework. Whether you are new to embedded programming or an experienced engineer, this guide will provide you with the knowledge and practical examples to start building powerful embedded applications with Embassy.

Embark on Your Embassy Journey

Embassy simplifies embedded Rust development, allowing you to focus on innovation rather than low-level complexities. Let's begin your journey into the world of asynchronous embedded programming with the Embassy Handbook!