embassy/embassy-stm32/src/low_power.rs

use core::arch::asm;
use core::marker::PhantomData;

use cortex_m::peripheral::SCB;
use embassy_executor::*;

use crate::interrupt;
use crate::interrupt::typelevel::Interrupt;
use crate::rcc::low_power_ready;
use crate::time_driver::{get_driver, RtcDriver};

const THREAD_PENDER: usize = usize::MAX;

use crate::rtc::Rtc;

static mut EXECUTOR: Option<Executor> = None;

foreach_interrupt! {
    (RTC, rtc, $block:ident, WKUP, $irq:ident) => {
        #[interrupt]
        unsafe fn $irq() {
            unsafe { EXECUTOR.as_mut().unwrap() }.on_wakeup_irq();
        }
    };
}

// pub fn timer_driver_pause_time() {
//     pause_time();
// }

pub fn stop_with_rtc(rtc: &'static Rtc) {
    unsafe { EXECUTOR.as_mut().unwrap() }.stop_with_rtc(rtc)
}

// pub fn start_wakeup_alarm(requested_duration: embassy_time::Duration) {
//     let rtc_instant = unsafe { EXECUTOR.as_mut().unwrap() }
//         .rtc
//         .unwrap()
//         .start_wakeup_alarm(requested_duration);
//
//     unsafe { EXECUTOR.as_mut().unwrap() }.last_stop = Some(rtc_instant);
// }
//
// pub fn set_sleepdeep() {
//     unsafe { EXECUTOR.as_mut().unwrap() }.scb.set_sleepdeep();
// }
//
// pub fn stop_wakeup_alarm() -> RtcInstant {
//     unsafe { EXECUTOR.as_mut().unwrap() }.rtc.unwrap().stop_wakeup_alarm()
// }

/// Thread mode executor, using WFE/SEV.
///
/// This is the simplest and most common kind of executor. It runs on
/// thread mode (at the lowest priority level), and uses the `WFE` ARM instruction
/// to sleep when it has no more work to do. When a task is woken, a `SEV` instruction
/// is executed, to make the `WFE` exit from sleep and poll the task.
///
/// This executor allows for ultra low power consumption for chips where `WFE`
/// triggers low-power sleep without extra steps. If your chip requires extra steps,
/// you may use [`raw::Executor`] directly to program custom behavior.
pub struct Executor {
    inner: raw::Executor,
    not_send: PhantomData<*mut ()>,
    scb: SCB,
    time_driver: &'static RtcDriver,
}

impl Executor {
    /// Create a new Executor.
    pub fn take() -> &'static mut Self {
        unsafe {
            assert!(EXECUTOR.is_none());

            EXECUTOR = Some(Self {
                inner: raw::Executor::new(THREAD_PENDER as *mut ()),
                not_send: PhantomData,
                scb: cortex_m::Peripherals::steal().SCB,
                time_driver: get_driver(),
            });

            EXECUTOR.as_mut().unwrap()
        }
    }

    unsafe fn on_wakeup_irq(&mut self) {
        trace!("low power: on wakeup irq");

        self.time_driver.resume_time();
        trace!("low power: resume time");
    }

    pub(self) fn stop_with_rtc(&mut self, rtc: &'static Rtc) {
        trace!("low power: stop with rtc configured");

        self.time_driver.set_rtc(rtc);

        #[cfg(not(stm32l0))]
        crate::interrupt::typelevel::RTC_WKUP::unpend();

        #[cfg(not(stm32l0))]
        unsafe {
            crate::interrupt::typelevel::RTC_WKUP::enable()
        };

        #[cfg(stm32l0)]
        crate::interrupt::typelevel::RTC::unpend();

        #[cfg(stm32l0)]
        unsafe {
            crate::interrupt::typelevel::RTC::enable()
        };

        rtc.enable_wakeup_line();
    }

    fn configure_pwr(&mut self) {
        trace!("low power: configure_pwr");

        self.scb.clear_sleepdeep();
        if !low_power_ready() {
            trace!("low power: configure_pwr: low power not ready");
            return;
        }

        if self.time_driver.pause_time().is_err() {
            trace!("low power: configure_pwr: time driver failed to pause");
            return;
        }

        trace!("low power: enter stop...");
        self.scb.set_sleepdeep();
    }

    /// Run the executor.
    ///
    /// The `init` closure is called with a [`Spawner`] that spawns tasks on
    /// this executor. Use it to spawn the initial task(s). After `init` returns,
    /// the executor starts running the tasks.
    ///
    /// To spawn more tasks later, you may keep copies of the [`Spawner`] (it is `Copy`),
    /// for example by passing it as an argument to the initial tasks.
    ///
    /// This function requires `&'static mut self`. This means you have to store the
    /// Executor instance in a place where it'll live forever and grants you mutable
    /// access. There's a few ways to do this:
    ///
    /// - a [StaticCell](https://docs.rs/static_cell/latest/static_cell/) (safe)
    /// - a `static mut` (unsafe)
    /// - a local variable in a function you know never returns (like `fn main() -> !`), upgrading its lifetime with `transmute`. (unsafe)
    ///
    /// This function never returns.
    pub fn run(&'static mut self, init: impl FnOnce(Spawner)) -> ! {
        init(unsafe { EXECUTOR.as_mut().unwrap() }.inner.spawner());

        loop {
            unsafe {
                EXECUTOR.as_mut().unwrap().inner.poll();
                self.configure_pwr();
                asm!("wfe");
            };
        }
    }
}