embassy-rs/embassy
Embassy
Embassy is an asynchronous framework for microcontrollers that provides a runtime for cooperative multitasking. It enables the execution of multiple concurrent tasks to maximize energy efficiency and CPU usage, utilizing an async executor that puts the processor to sleep when idle.
The framework includes a comprehensive set of embedded components, featuring a hardware abstraction layer for peripherals like GPIO, SPI, I2C, and UART, alongside a TCP/IP network stack and a USB device stack. It also provides a Bluetooth Low Energy host stack for wireless communication and a bootloader framework that supports external flash and power-fail-safe firmware updates with automatic rollbacks.
Additional capabilities cover task scheduling with priority-based preemption and deadline-based algorithms, direct memory access for high-throughput data transfer, and system health monitoring via watchdog timers. The system also integrates security and reliability features such as hardware random number generation and memory protection unit stack guards.
Features
- Embedded Async Executors - Provides an asynchronous runtime for cooperative multitasking that puts the processor to sleep when idle.
- Embedded Rust - Provides an asynchronous runtime for microcontrollers using Rust to manage multitasking and power efficiency.
- Cooperative Schedulers - Provides a cooperative async executor that allows tasks to yield control and maximizes energy efficiency.
- Bootloaders and Updates - Handles the process of updating and loading new software images onto a microcontroller.
- Embedded Async Multitasking - Executes multiple concurrent tasks on microcontrollers using asynchronous programming to optimize CPU and energy usage.
- Bluetooth Connectivity - Manages Bluetooth Low Energy hosts and controllers to enable wireless communication on microcontrollers.
- USB Class Implementations - Implements standard USB classes including Serial ports, Ethernet, HID, and MIDI for device communication.
- Microcontroller Abstraction Layers - Provides standardized abstraction layers for interacting with microcontroller peripherals like GPIO, SPI, and UART.
- USB Device Communication - Controls device-side USB stacks with support for common classes like CDC ACM and HID.
- USB Device Frameworks - Implements USB devices with asynchronous support for composite configurations, suspend, resume, and remote wakeup.
- Hardware Abstraction Layers - Implements hardware abstraction layers providing safe APIs to interact with microcontroller capabilities without raw register manipulation.
- TCP/IP Stacks - Implements an asynchronous TCP/IP stack providing Ethernet, IP, TCP, UDP, ICMP, and DHCP connectivity.
- Static Task Allocation - Prevents runtime memory exhaustion by using static allocation for asynchronous task management.
- Flash Storage Managers - Provides interfaces for reading and writing data to on-chip non-volatile flash memory.
- Deadline-Based Scheduling - Prioritizes tasks using an Earliest Deadline First algorithm to meet soft-realtime timing requirements.
- USB Device Descriptors - Provides a builder for creating USB device and interface descriptors.
- Custom Hardware Drivers - Implements trait-based drivers to enable support for a wide variety of Ethernet and WiFi chips.
- External Flash Booting - Executes large programs from QSPI flash chip families using a second-stage bootloader.
- Power-Fail-Safe Update Mechanisms - Manages firmware updates with power-fail-safe mechanisms, trial boots, and automatic rollbacks.
- BLE Host Stacks - Provides a Bluetooth Low Energy host stack for wireless communication between microcontroller hosts and controllers.
- Hardware Interfacing - Interfaces with Ethernet, WiFi, and USB-CDC NCM hardware peripherals to transmit and receive network packets.
- USB Device Stack Implementations - Implements a USB device stack with support for common classes like HID and Serial using asynchronous configurations.
- USB Device Stacks - Provides a framework for implementing USB device descriptors and classes like CDC and HID with asynchronous support.
- Async Task Timeouts - Executes futures and automatically cancels them if they fail to complete within a specified time limit.
- Embedded Network Driver Integration - Integrates IEEE 802.15.4 compatible hardware drivers to support embedded networking stacks.
- DMA Controllers - Provides direct memory access controllers for high-throughput data transfer between peripherals and memory.
- Interrupt Vector Handlers - Maps hardware interrupts to software handler functions using specialized macros for immediate event response.
- Multicore Synchronization Primitives - Provides hardware spinlock-based mutexes for coordinating tasks across multiple CPU cores.
- Overflow-Free Timing Types - Tracks instants and durations using global, overflow-free types to handle timing and timeouts reliably.
- Firmware Image Generators - Adds required image headers to firmware binaries to ensure compatibility with internal bootloaders.
- System Clock Utilities - Configures clock modules and signal outputs to control the timing and frequency of the microcontroller.
- Processor Sleep Controllers - Implements mechanisms to suspend the processor and minimize energy consumption when the async executor is idle.
- Task Priority Management - Supports multiple executor instances at different priority levels to allow high-priority task preemption.
- Asynchronous Timing Constraints - Provides asynchronous delays and periodic intervals that maintain timing accuracy without drifting.
- Hardware Timer Integration - Leverages hardware timers to drive precise system-wide timekeeping for delays and scheduled tasks.
- Health Monitoring - Implements system health monitoring using windowed or code watchdogs to recover from software hangs or crashes.
- Embedded Frameworks - Embedded async development tools
- Embedded Systems - Async/await framework for embedded Rust development.
- Hardware Abstraction Layers - Async-first HAL for MSPM0 and other microcontrollers.
