80972f1e0e
This is a `core` patch to make wakers 1 word (the task pointer) instead of 2 (task pointer + vtable). It allows having the "waker optimization" we had a while back on `WakerRegistration/AtomicWaker`, but EVERYWHERE, without patching all crates. Advantages: - Less memory usage. - Faster. - `AtomicWaker` can actually use atomics to load/store the waker, No critical section needed. - No `dyn` call, which means `cargo-call-stack` can now see through wakes. Disadvantages: - You have to patch `core`... - Breaks all executors and other things that create wakers, unless they opt in to using the new `from_ptr` API. How to use: - Run this shell script to patch `core`. https://gist.github.com/Dirbaio/c67da7cf318515181539122c9d32b395 - Enable `build-std` - Enable `build-std-features = core/turbowakers` - Enable feature `turbowakers` in `embassy-executor`, `embassy-sync`. - Make sure you have no other crate creating wakers other than `embassy-executor`. These will panic at runtime. Note that the patched `core` is equivalent to the unpached one when the `turbowakers` feature is not enabled, so it should be fine to leave it there.
48 lines
1.3 KiB
TOML
48 lines
1.3 KiB
TOML
[package]
|
|
name = "embassy-sync"
|
|
version = "0.1.0"
|
|
edition = "2021"
|
|
description = "no-std, no-alloc synchronization primitives with async support"
|
|
repository = "https://github.com/embassy-rs/embassy"
|
|
readme = "README.md"
|
|
license = "MIT OR Apache-2.0"
|
|
categories = [
|
|
"embedded",
|
|
"no-std",
|
|
"concurrency",
|
|
"asynchronous",
|
|
]
|
|
|
|
[package.metadata.embassy_docs]
|
|
src_base = "https://github.com/embassy-rs/embassy/blob/embassy-sync-v$VERSION/embassy-sync/src/"
|
|
src_base_git = "https://github.com/embassy-rs/embassy/blob/$COMMIT/embassy-sync/src/"
|
|
features = ["nightly"]
|
|
target = "thumbv7em-none-eabi"
|
|
|
|
[package.metadata.docs.rs]
|
|
features = ["nightly"]
|
|
|
|
[features]
|
|
nightly = ["embedded-io/async"]
|
|
std = []
|
|
turbowakers = []
|
|
|
|
[dependencies]
|
|
defmt = { version = "0.3", optional = true }
|
|
log = { version = "0.4.14", optional = true }
|
|
|
|
futures-util = { version = "0.3.17", default-features = false }
|
|
critical-section = "1.1"
|
|
heapless = "0.7.5"
|
|
cfg-if = "1.0.0"
|
|
embedded-io = "0.4.0"
|
|
|
|
[dev-dependencies]
|
|
futures-executor = { version = "0.3.17", features = [ "thread-pool" ] }
|
|
futures-test = "0.3.17"
|
|
futures-timer = "3.0.2"
|
|
futures-util = { version = "0.3.17", features = [ "channel" ] }
|
|
|
|
# Enable critical-section implementation for std, for tests
|
|
critical-section = { version = "1.1", features = ["std"] }
|
|
static_cell = "1.0"
|