lokey 0.0.1

An extensible keyboard firmware
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use alloc::collections::VecDeque;
use core::cell::RefCell;
use core::future::poll_fn;
use core::pin::Pin;
use core::task::{Context, Poll};
use embassy_sync::blocking_mutex::{Mutex, raw::RawMutex};
use embassy_sync::waitqueue::WakerRegistration;
use futures_util::Stream;

struct State<T> {
    queue: VecDeque<T>,
    receiver_waker: WakerRegistration,
}

impl<T> State<T> {
    fn send(&mut self, message: T) {
        self.queue.push_back(message);
        self.receiver_waker.wake();
    }

    fn poll_receive(&mut self, cx: &Context) -> Poll<T> {
        match self.queue.pop_front() {
            Some(message) => Poll::Ready(message),
            None => {
                self.receiver_waker.register(cx.waker());
                Poll::Pending
            }
        }
    }
}

pub struct Channel<M, T> {
    inner: Mutex<M, RefCell<State<T>>>,
}

impl<M: RawMutex, T> Channel<M, T> {
    pub const fn new() -> Self {
        let state = State {
            queue: VecDeque::new(),
            receiver_waker: WakerRegistration::new(),
        };
        Self {
            inner: Mutex::new(RefCell::new(state)),
        }
    }

    pub fn send(&self, message: T) {
        self.inner.lock(|state| {
            state.borrow_mut().send(message);
        })
    }

    pub fn sender(&self) -> Sender<'_, M, T> {
        Sender { channel: self }
    }

    pub fn poll_receive(&self, cx: &Context) -> Poll<T> {
        self.inner.lock(|state| state.borrow_mut().poll_receive(cx))
    }

    pub async fn receive(&self) -> T {
        poll_fn(|cx| self.inner.lock(|state| state.borrow_mut().poll_receive(cx))).await
    }

    pub fn receiver(&self) -> Receiver<'_, M, T> {
        Receiver { channel: self }
    }
}

impl<M: RawMutex, T> Default for Channel<M, T> {
    fn default() -> Self {
        Self::new()
    }
}

pub struct Sender<'a, M, T> {
    channel: &'a Channel<M, T>,
}

impl<'a, M: RawMutex, T> Sender<'a, M, T> {
    pub fn send(&self, message: T) {
        self.channel.send(message);
    }
}

impl<'a, M: RawMutex, T> Copy for Sender<'a, M, T> {}

impl<'a, M: RawMutex, T> Clone for Sender<'a, M, T> {
    fn clone(&self) -> Self {
        *self
    }
}

pub struct Receiver<'a, M, T> {
    channel: &'a Channel<M, T>,
}

impl<'a, M: RawMutex, T> Receiver<'a, M, T> {
    pub async fn receive(&self) -> T {
        self.channel.receive().await
    }
}

impl<'a, M: RawMutex, T> Stream for Receiver<'a, M, T> {
    type Item = T;

    fn poll_next(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Option<Self::Item>> {
        self.channel.poll_receive(cx).map(Some)
    }
}

impl<'a, M: RawMutex, T> Copy for Receiver<'a, M, T> {}

impl<'a, M: RawMutex, T> Clone for Receiver<'a, M, T> {
    fn clone(&self) -> Self {
        *self
    }
}