embassy/embassy-sync/src/waitqueue/atomic_waker.rs
2024-11-22 09:21:44 +01:00

64 lines
1.6 KiB
Rust

use core::cell::Cell;
use core::task::Waker;
use crate::blocking_mutex::raw::{CriticalSectionRawMutex, RawMutex};
use crate::blocking_mutex::Mutex;
/// Utility struct to register and wake a waker.
pub struct GenericAtomicWaker<M: RawMutex> {
waker: Mutex<M, Cell<Option<Waker>>>,
}
impl<M: RawMutex> GenericAtomicWaker<M> {
/// Create a new `AtomicWaker`.
pub const fn new(mutex: M) -> Self {
Self {
waker: Mutex::const_new(mutex, Cell::new(None)),
}
}
/// Register a waker. Overwrites the previous waker, if any.
pub fn register(&self, w: &Waker) {
self.waker.lock(|cell| {
cell.set(match cell.replace(None) {
Some(w2) if (w2.will_wake(w)) => Some(w2),
_ => Some(w.clone()),
})
})
}
/// Wake the registered waker, if any.
pub fn wake(&self) {
self.waker.lock(|cell| {
if let Some(w) = cell.replace(None) {
w.wake_by_ref();
cell.set(Some(w));
}
})
}
}
/// Utility struct to register and wake a waker.
pub struct AtomicWaker {
waker: GenericAtomicWaker<CriticalSectionRawMutex>,
}
impl AtomicWaker {
/// Create a new `AtomicWaker`.
pub const fn new() -> Self {
Self {
waker: GenericAtomicWaker::new(CriticalSectionRawMutex::new()),
}
}
/// Register a waker. Overwrites the previous waker, if any.
pub fn register(&self, w: &Waker) {
self.waker.register(w);
}
/// Wake the registered waker, if any.
pub fn wake(&self) {
self.waker.wake();
}
}