如何用Embassy框架实现Rust嵌入式非阻塞编程：从入门到精通

在嵌入式开发领域，高效处理I/O操作一直是挑战。Embassy作为一款基于Rust的现代嵌入式框架，通过异步编程模型彻底改变了传统阻塞式I/O的局限。本文将带你探索如何利用Embassy的异步特性，轻松实现高效、响应迅速的嵌入式应用。## 🚀 什么是Embassy框架？Embassy是一个专为嵌入式系统设计的异步框架，它将Rust语言的安全性与异步编程的高效性完美结合。通过使用async

翁晔晨Jane

400人浏览 · 2026-03-18 03:49:51

翁晔晨Jane · 2026-03-18 03:49:51 发布

如何用Embassy框架实现Rust嵌入式非阻塞编程：从入门到精通

【免费下载链接】embassy Modern embedded framework, using Rust and async. 项目地址: https://gitcode.com/gh_mirrors/em/embassy

在嵌入式开发领域，高效处理I/O操作一直是挑战。Embassy作为一款基于Rust的现代嵌入式框架，通过异步编程模型彻底改变了传统阻塞式I/O的局限。本文将带你探索如何利用Embassy的异步特性，轻松实现高效、响应迅速的嵌入式应用。

🚀 什么是Embassy框架？

Embassy是一个专为嵌入式系统设计的异步框架，它将Rust语言的安全性与异步编程的高效性完美结合。通过使用async/await语法，开发者可以编写看似同步却能高效并发的代码，极大提升了嵌入式设备的资源利用率。

项目核心代码位于embassy-executor/目录，其中实现了高效的任务调度器，为异步操作提供了坚实基础。

🔄 理解Embassy的异步执行模型

Embassy的核心优势在于其高效的执行器（Executor）设计。与传统的多线程模型不同，Embassy采用单线程非抢占式调度，通过协作式多任务处理实现高并发。

图：Embassy执行器任务调度流程，展示了多个任务如何被高效管理和执行

执行器通过"轮询-挂起-唤醒"机制工作：

执行器轮询任务
遇到I/O等待时任务挂起（Pending）
执行器切换到其他就绪任务
I/O完成后任务被唤醒（Ready）
执行器重新调度该任务

这种模型避免了传统多线程的上下文切换开销，特别适合资源受限的嵌入式环境。

⚡ 中断处理与异步I/O的无缝集成

在嵌入式系统中，中断处理与异步编程的结合是提升性能的关键。Embassy通过巧妙的设计，将硬件中断与异步任务无缝衔接。

图：Embassy中断处理与任务唤醒流程，展示了外设中断如何通知执行器唤醒等待中的任务

工作流程如下：

执行器轮询任务
任务等待I/O操作
外设完成操作后触发中断
中断处理器唤醒等待中的任务
执行器收到通知并重新调度任务

这种机制确保了系统在等待I/O时不会浪费CPU周期，大大提高了整体效率。相关实现可在embassy-hal-internal/src/interrupt.rs中查看。

🛠️ 开始使用Embassy的简单步骤

1. 准备开发环境

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/em/embassy

2. 选择适合的硬件支持包

Embassy支持多种微控制器系列，包括：

embassy-stm32/ - STM32系列微控制器支持
embassy-nrf/ - Nordic nRF系列支持
embassy-rp/ - Raspberry Pi Pico支持

根据你的硬件选择相应的包，并在Cargo.toml中添加依赖。

3. 编写第一个异步程序

以下是一个简单的异步LED闪烁程序框架：

#[embassy_executor::main]
async fn main(spawner: embassy_executor::Spawner) {
    // 初始化硬件
    let peripherals = embassy_stm32::init(Default::default());
    
    // 生成任务
    spawner.spawn(blink(peripherals.PA5, Duration::from_millis(500))).unwrap();
    spawner.spawn(blink(peripherals.PA6, Duration::from_millis(1000))).unwrap();
    
    // 主任务可以继续执行其他操作
    loop {
        embassy_time::Timer::after(Duration::from_secs(10)).await;
        println!("Main task running");
    }
}

#[embassy_executor::task]
async fn blink(mut led: embassy_stm32::gpio::Output<'static>, interval: Duration) {
    loop {
        led.set_high();
        embassy_time::Timer::after(interval).await;
        led.set_low();
        embassy_time::Timer::after(interval).await;
    }
}

这个例子展示了如何同时运行两个不同频率的闪烁任务，而不需要复杂的线程管理。