embassy_blinky

Embassy Blinky

Embassy is an embedded runtime framework that supports async/await for simple and efficient multitasking in embedded systems.

Embassy 是一个支持 async/await 的嵌入式运行框架, 能够在嵌入式系统中实现简单高效的多任务处理。

This example is modified from blinky. If you are just starting out, I suggest you read blinky before continuing on.

这个例子是在 blinky 的基础上修改而来的。如果你是刚开始，我建议你先阅读 blinky 的内容，再继续往下阅读。

To turn on basic embassy support, we just need to add the following to Cargo.toml.

开启 embassy 基本的支持，我们只需要在 Cargo.toml 中添加以下内容:

[features]
default = [
    ...
    "embassy"
]

log = [
    ...
    "embassy-executor?/log",
]

defmt = [
    ...
    "esp-hal-embassy?/defmt",
    "embassy-executor?/defmt",
]

embassy = [
    "esp-hal-embassy",
    "embassy-executor",
    "embassy-time",
    "embassy-executor/task-arena-size-20480"
]

esp32c3 = [..., "esp-hal-embassy?/esp32c3"]
esp32c6 = [..., "esp-hal-embassy?/esp32c6"]

[dependencies]
esp-hal-embassy = { version = "0.3", features = ["integrated-timers"], optional = true  }
embassy-executor = { version = "0.6", package = "embassy-executor", features = ["arch-riscv32"], optional = true }
embassy-time = { version = "0.3", optional = true }

After initializing embassy, you can use multitasking, which is very different from traditional embedded development.

初始化 embassy 之后，你就可以使用多任务, 这与传统嵌入式开发是截然不同的。

#[embassy_executor::main(entry = "esp_hal::entry")]
async fn main(spawner: Spawner) {
    ...
    let timg0 = TimerGroup::new_async(peripherals.TIMG0, &clocks);
    embassy::init(&clocks, timg0);

    println!("embassy init!");

    spawner.spawn(run()).ok();
    spawner.spawn(toggle(led.into())).ok();

    loop {
        println!("main loop!");
        Timer::after(Duration::from_millis(5_000)).await;
    }
    ...
}

#[embassy_executor::task]
async fn run() {
    loop {
        println!("task loop!");
        Timer::after(Duration::from_millis(1_000)).await;
    }
}

#[embassy_executor::task]
async fn toggle(mut led: AnyPin<Output<PushPull>>) {
    loop {
        println!("toggle loop!");
        led.toggle();
        Timer::after_secs(1).await;
        led.toggle();
        Timer::after_secs(2).await;
    }
}