Crate embassy_sync

embassy-sync

An Embassy project.

Synchronization primitives and data structures with async support:

• Channel - A Multiple Producer Multiple Consumer (MPMC) channel. Each message is only received by a single consumer.
• PriorityChannel - A Multiple Producer Multiple Consumer (MPMC) channel. Each message is only received by a single consumer. Higher priority items are sifted to the front of the channel.
• PubSubChannel - A broadcast channel (publish-subscribe) channel. Each message is received by all consumers.
• Signal - Signalling latest value to a single consumer.
• Mutex - Mutex for synchronizing state between asynchronous tasks.
• Pipe - Byte stream implementing embedded_io traits.
• WakerRegistration - Utility to register and wake a Waker.
• AtomicWaker - A variant of WakerRegistration accessible using a non-mut API.
• MultiWakerRegistration - Utility registering and waking multiple Waker’s.

Interoperability

Futures from this crate can run on any executor.

Minimum supported Rust version (MSRV)

Embassy is guaranteed to compile on the latest stable Rust version at the time of release. It might compile with older versions but that may change in any new patch release.

License

This work is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Modules

• blocking_mutex
  Blocking mutex.
• channel
  A queue for sending values between asynchronous tasks.
• mutex
  Async mutex.
• pipe
  Async byte stream pipe.
• priority_channel
  A queue for sending values between asynchronous tasks.
• pubsub
  Implementation of PubSubChannel, a queue where published messages get received by all subscribers.
• signal
  A synchronization primitive for passing the latest value to a task.
• waitqueue
  Async low-level wait queues
• zerocopy_channel
  A zero-copy queue for sending values between asynchronous tasks.