use crate::{ linked_list::{ArrayLength, LinkedList, Min, Node}, time::{Clock, Instant}, Monotonic, }; use core::cmp::Ordering; #[inline(always)] fn unwrapper(val: Result) -> T { if let Ok(v) = val { v } else { unreachable!("Your monotonic is not infallible") } } pub struct TimerQueue(pub LinkedList, Min, N>) where Mono: Monotonic, N: ArrayLength>>, Task: Copy; impl TimerQueue where Mono: Monotonic, N: ArrayLength>>, Task: Copy, { pub fn new() -> Self { TimerQueue(LinkedList::new()) } /// # Safety /// /// Writing to memory with a transmute in order to enable /// interrupts of the SysTick timer /// /// Enqueue a task without checking if it is full #[inline] pub unsafe fn enqueue_unchecked( &mut self, nr: NotReady, enable_interrupt: F1, pend_handler: F2, mono: &mut Mono, ) where F1: FnOnce(), F2: FnOnce(), { // Check if the top contains a non-empty element and if that element is // greater than nr let if_heap_max_greater_than_nr = self .0 .peek() .map(|head| nr.instant < head.instant) .unwrap_or(true); if if_heap_max_greater_than_nr { if Mono::DISABLE_INTERRUPT_ON_EMPTY_QUEUE && self.0.is_empty() { mono.enable_timer(); enable_interrupt(); } pend_handler(); } self.0.push_unchecked(nr); } /// Check if the timer queue is empty. #[inline] pub fn is_empty(&self) -> bool { self.0.is_empty() } /// Cancel the marker value pub fn cancel_marker(&mut self, marker: u32) -> Option<(Task, u8)> { if let Some(val) = self.0.find_mut(|nr| nr.marker == marker) { let nr = val.pop(); Some((nr.task, nr.index)) } else { None } } /// Update the instant at an marker value to a new instant pub fn update_marker( &mut self, marker: u32, new_marker: u32, instant: Instant, pend_handler: F, ) -> Result<(), ()> { if let Some(mut val) = self.0.find_mut(|nr| nr.marker == marker) { val.instant = instant; val.marker = new_marker; // On update pend the handler to reconfigure the next compare match pend_handler(); Ok(()) } else { Err(()) } } /// Dequeue a task from the TimerQueue pub fn dequeue(&mut self, disable_interrupt: F, mono: &mut Mono) -> Option<(Task, u8)> where F: FnOnce(), { mono.clear_compare_flag(); if let Some(instant) = self.0.peek().map(|p| p.instant) { if instant <= unwrapper(Clock::try_now(mono)) { // task became ready let nr = unsafe { self.0.pop_unchecked() }; Some((nr.task, nr.index)) } else { // Set compare mono.set_compare(&instant); // Double check that the instant we set is really in the future, else // dequeue. If the monotonic is fast enough it can happen that from the // read of now to the set of the compare, the time can overflow. This is to // guard against this. if instant <= unwrapper(Clock::try_now(mono)) { let nr = unsafe { self.0.pop_unchecked() }; Some((nr.task, nr.index)) } else { None } } } else { // The queue is empty, disable the interrupt. if Mono::DISABLE_INTERRUPT_ON_EMPTY_QUEUE { disable_interrupt(); mono.disable_timer(); } None } } } pub struct NotReady where Task: Copy, Mono: Monotonic, { pub index: u8, pub instant: Instant, pub task: Task, pub marker: u32, } impl Eq for NotReady where Task: Copy, Mono: Monotonic, { } impl Ord for NotReady where Task: Copy, Mono: Monotonic, { fn cmp(&self, other: &Self) -> Ordering { self.instant.cmp(&other.instant) } } impl PartialEq for NotReady where Task: Copy, Mono: Monotonic, { fn eq(&self, other: &Self) -> bool { self.instant == other.instant } } impl PartialOrd for NotReady where Task: Copy, Mono: Monotonic, { fn partial_cmp(&self, other: &Self) -> Option { Some(self.cmp(&other)) } }