NaxdyOrg/embassy
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Modern embedded framework, using Rust and async.
1282 commits 3 branches 0 tags 16 MiB
Rust 98.8%
Shell 0.9%
Python 0.2%
Find a file
Timo Kröger f141b98741 bxcan: Cleanup 
Older families like F1 and F4 have a consistent naming for the CAN
peripherals: CAN when there is only one instance, CAN1/CAN2/CAN2 if
there are multiple instances.
Newer families like L4 and F7 use the name CAN1 even if there is only
one instance. The number of filter banks is incorrect for those.

Affected chips:
* STM32F722
* STM32F723
* STM32F730
* STM32F732
* STM32F733
* STM32L4P5
* STM32L4Q5
* STM32L4R5
* STM32L4R7
* STM32L4R9
* STM32L4S5
* STM32L4S7
* STM32L4S9
* STM32L431
* STM32L432
* STM32L433
* STM32L442
* STM32L443
* STM32L451
* STM32L452
* STM32L462
* STM32L471
* STM32L475
* STM32L476
* STM32L485
* STM32L486
2021-08-18 21:58:50 +02:00
.github/workflows Add STM32WL55 examples to CI (#361) 2021-08-18 09:35:08 +02:00
.vscode Update vscode settings. 2021-07-16 14:41:20 -04:00
embassy embassy-macros: Use defmt::unwrap! when spawning embassy::main 2021-08-05 22:40:12 +02:00
embassy-hal-common Add IRQ-driven buffered USART implementation for STM32 v2 usart (#356) 2021-08-16 17:16:49 +02:00
embassy-macros embassy-macros: Use defmt::unwrap! when spawning embassy::main 2021-08-05 22:40:12 +02:00
embassy-net net: Make the user pass in the StackResources in init 2021-06-20 17:15:18 -03:00
embassy-nrf nrf: add WDT driver 2021-08-07 14:26:28 +02:00
embassy-rp time: replace dyn clock/alarm with a global Driver trait 2021-08-05 19:14:09 +02:00
embassy-std time: replace dyn clock/alarm with a global Driver trait 2021-08-05 19:14:09 +02:00
embassy-stm32 bxcan: Cleanup 2021-08-18 21:58:50 +02:00
embassy-traits Update nightly, remove removed features. 2021-08-04 19:48:14 +02:00
examples bxcan: Fix the flaky CAN example 2021-08-18 21:58:50 +02:00
stm32-data@bfd4797d12 Add example for STM32WL55 2021-08-17 16:22:47 +02:00
stm32-metapac Use an em bikeshed instead of an underscore bikeshed. 2021-08-02 13:29:06 -04:00
stm32-metapac-gen Add per-core EXTI support 2021-08-17 16:22:47 +02:00
xtask xtask runner for CI types of things and other utilities. 2021-08-17 15:23:08 -04:00
.gitignore Merge remote-tracking branch 'embassy-net/main' 2021-05-28 23:07:27 +02:00
.gitmodules Add stm32-metapac crate, with codegen in rust 2021-05-31 02:40:58 +02:00
Cargo.example.toml Rename embassy-extras to embassy-hal-common 2021-07-29 13:44:51 +02:00
LICENSE-APACHE First commit 2020-09-22 18:03:43 +02:00
LICENSE-MIT First commit 2020-09-22 18:03:43 +02:00
README.md Trivial to trigger checks from CI. 2021-07-28 09:09:19 -04:00
rust-toolchain.toml Update nightly 2021-08-18 21:51:22 +02:00

README.md

Embassy

Embassy is a project to make async/await a first-class option for embedded development. For more information and instructions to get started, click here.

Traits and types

embassy provides a set of traits and types specifically designed for async usage.

  • embassy::io: AsyncBufRead, AsyncWrite. Traits for byte-stream IO, essentially no_std compatible versions of futures::io.
  • embassy::traits::flash: Flash device trait.
  • embassy::time: Clock and Alarm traits. Std-like Duration and Instant.
  • More traits for SPI, I2C, UART async HAL coming soon.

Executor

The embassy::executor module provides an async/await executor designed for embedded usage.

  • No alloc, no heap needed. Task futures are statically allocated.
  • No "fixed capacity" data structures, executor works with 1 or 1000 tasks without needing config/tuning.
  • Integrated timer queue: sleeping is easy, just do Timer::after(Duration::from_secs(1)).await;.
  • No busy-loop polling: CPU sleeps when there's no work to do, using interrupts or WFE/SEV.
  • Efficient polling: a wake will only poll the woken task, not all of them.
  • Fair: a task can't monopolize CPU time even if it's constantly being woken. All other tasks get a chance to run before a given task gets polled for the second time.
  • Creating multiple executor instances is supported, to run tasks with multiple priority levels. This allows higher-priority tasks to preempt lower-priority tasks.

Utils

embassy::util contains some lightweight async/await utilities, mainly helpful for async driver development (signaling a task that an interrupt has occured, for example).

embassy-nrf

The embassy-nrf crate contains implementations for nRF 52 series SoCs.

  • uarte: UARTE driver implementing AsyncBufRead and AsyncWrite.
  • qspi: QSPI driver implementing Flash.
  • gpiote: GPIOTE driver. Allows awaiting GPIO pin changes. Great for reading buttons or receiving interrupts from external chips.
  • rtc: RTC driver implementing Clock and Alarm, for use with embassy::executor.

Examples

Examples are found in the examples/ folder seperated by the chip manufacturer they are designed to run on:

  • examples/nrf are designed to run on the nrf52840-dk board (PCA10056) but should be easily adaptable to other nRF52 chips and boards.
  • examples/rp are for the RP2040 chip.
  • examples/stm32 are designed for the STM32F429ZI chip but should be easily adaptable to other STM32F4xx chips.
  • examples/std are designed to run locally on your pc.

Running examples

  • Setup git submodules (needed for STM32 examples)
git submodule init
git submodule update
  • Install probe-run with defmt support.
cargo install probe-run
  • Run the example
cargo run --bin rtc_async

Minimum supported Rust version (MSRV)

Required nightly version is specified in the rust-toolchain.toml file. Nightly is required for:

  • generic_associated_types: for trait funcs returning futures.
  • type_alias_impl_trait: for trait funcs returning futures implemented with async{} blocks, and for static-executor.

Stable support is a non-goal until these features get stabilized.

Why the name?

EMBedded ASYnc! :)

License

This work is licensed under either of

at your option.