embassy/embassy-nrf/src/interrupt.rs

//! Interrupt management
//!
//! This module implements an API for managing interrupts compatible with
//! nrf_softdevice::interrupt. Intended for switching between the two at compile-time.

use core::sync::atomic::{compiler_fence, Ordering};

use crate::pac::NVIC_PRIO_BITS;

// Re-exports
pub use crate::pac::Interrupt;
pub use crate::pac::Interrupt::*; // needed for cortex-m-rt #[interrupt]
pub use cortex_m::interrupt::{CriticalSection, Mutex};
pub use embassy::interrupt::{declare, take, OwnedInterrupt};

#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd)]
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
#[repr(u8)]
pub enum Priority {
    Level0 = 0,
    Level1 = 1,
    Level2 = 2,
    Level3 = 3,
    Level4 = 4,
    Level5 = 5,
    Level6 = 6,
    Level7 = 7,
}

impl From<u8> for Priority {
    fn from(priority: u8) -> Self {
        match priority >> (8 - NVIC_PRIO_BITS) {
            0 => Self::Level0,
            1 => Self::Level1,
            2 => Self::Level2,
            3 => Self::Level3,
            4 => Self::Level4,
            5 => Self::Level5,
            6 => Self::Level6,
            7 => Self::Level7,
            _ => unreachable!(),
        }
    }
}

impl From<Priority> for u8 {
    fn from(p: Priority) -> Self {
        (p as u8) << (8 - NVIC_PRIO_BITS)
    }
}

#[inline]
pub fn free<F, R>(f: F) -> R
where
    F: FnOnce(&CriticalSection) -> R,
{
    unsafe {
        // TODO: assert that we're in privileged level
        // Needed because disabling irqs in non-privileged level is a noop, which would break safety.

        let primask: u32;
        asm!("mrs {}, PRIMASK", out(reg) primask);

        asm!("cpsid i");

        // Prevent compiler from reordering operations inside/outside the critical section.
        compiler_fence(Ordering::SeqCst);

        let r = f(&CriticalSection::new());

        compiler_fence(Ordering::SeqCst);

        if primask & 1 == 0 {
            asm!("cpsie i");
        }

        r
    }
}

#[cfg(feature = "52810")]
mod irqs {
    use super::*;
    declare!(POWER_CLOCK);
    declare!(RADIO);
    declare!(UARTE0_UART0);
    declare!(TWIM0_TWIS0_TWI0);
    declare!(SPIM0_SPIS0_SPI0);
    declare!(GPIOTE);
    declare!(SAADC);
    declare!(TIMER0);
    declare!(TIMER1);
    declare!(TIMER2);
    declare!(RTC0);
    declare!(TEMP);
    declare!(RNG);
    declare!(ECB);
    declare!(CCM_AAR);
    declare!(WDT);
    declare!(RTC1);
    declare!(QDEC);
    declare!(COMP);
    declare!(SWI0_EGU0);
    declare!(SWI1_EGU1);
    declare!(SWI2);
    declare!(SWI3);
    declare!(SWI4);
    declare!(SWI5);
    declare!(PWM0);
    declare!(PDM);
}

#[cfg(feature = "52811")]
mod irqs {
    use super::*;
    declare!(POWER_CLOCK);
    declare!(RADIO);
    declare!(UARTE0_UART0);
    declare!(TWIM0_TWIS0_TWI0_SPIM1_SPIS1_SPI1);
    declare!(SPIM0_SPIS0_SPI0);
    declare!(GPIOTE);
    declare!(SAADC);
    declare!(TIMER0);
    declare!(TIMER1);
    declare!(TIMER2);
    declare!(RTC0);
    declare!(TEMP);
    declare!(RNG);
    declare!(ECB);
    declare!(CCM_AAR);
    declare!(WDT);
    declare!(RTC1);
    declare!(QDEC);
    declare!(COMP);
    declare!(SWI0_EGU0);
    declare!(SWI1_EGU1);
    declare!(SWI2);
    declare!(SWI3);
    declare!(SWI4);
    declare!(SWI5);
    declare!(PWM0);
    declare!(PDM);
}

#[cfg(feature = "52832")]
mod irqs {
    use super::*;
    declare!(POWER_CLOCK);
    declare!(RADIO);
    declare!(UARTE0_UART0);
    declare!(SPIM0_SPIS0_TWIM0_TWIS0_SPI0_TWI0);
    declare!(SPIM1_SPIS1_TWIM1_TWIS1_SPI1_TWI1);
    declare!(NFCT);
    declare!(GPIOTE);
    declare!(SAADC);
    declare!(TIMER0);
    declare!(TIMER1);
    declare!(TIMER2);
    declare!(RTC0);
    declare!(TEMP);
    declare!(RNG);
    declare!(ECB);
    declare!(CCM_AAR);
    declare!(WDT);
    declare!(RTC1);
    declare!(QDEC);
    declare!(COMP_LPCOMP);
    declare!(SWI0_EGU0);
    declare!(SWI1_EGU1);
    declare!(SWI2_EGU2);
    declare!(SWI3_EGU3);
    declare!(SWI4_EGU4);
    declare!(SWI5_EGU5);
    declare!(TIMER3);
    declare!(TIMER4);
    declare!(PWM0);
    declare!(PDM);
    declare!(MWU);
    declare!(PWM1);
    declare!(PWM2);
    declare!(SPIM2_SPIS2_SPI2);
    declare!(RTC2);
    declare!(I2S);
    declare!(FPU);
}

#[cfg(feature = "52833")]
mod irqs {
    use super::*;
    declare!(POWER_CLOCK);
    declare!(RADIO);
    declare!(UARTE0_UART0);
    declare!(SPIM0_SPIS0_TWIM0_TWIS0_SPI0_TWI0);
    declare!(SPIM1_SPIS1_TWIM1_TWIS1_SPI1_TWI1);
    declare!(NFCT);
    declare!(GPIOTE);
    declare!(SAADC);
    declare!(TIMER0);
    declare!(TIMER1);
    declare!(TIMER2);
    declare!(RTC0);
    declare!(TEMP);
    declare!(RNG);
    declare!(ECB);
    declare!(CCM_AAR);
    declare!(WDT);
    declare!(RTC1);
    declare!(QDEC);
    declare!(COMP_LPCOMP);
    declare!(SWI0_EGU0);
    declare!(SWI1_EGU1);
    declare!(SWI2_EGU2);
    declare!(SWI3_EGU3);
    declare!(SWI4_EGU4);
    declare!(SWI5_EGU5);
    declare!(TIMER3);
    declare!(TIMER4);
    declare!(PWM0);
    declare!(PDM);
    declare!(MWU);
    declare!(PWM1);
    declare!(PWM2);
    declare!(SPIM2_SPIS2_SPI2);
    declare!(RTC2);
    declare!(I2S);
    declare!(FPU);
    declare!(USBD);
    declare!(UARTE1);
    declare!(PWM3);
    declare!(SPIM3);
}

#[cfg(feature = "52840")]
mod irqs {
    use super::*;
    declare!(POWER_CLOCK);
    declare!(RADIO);
    declare!(UARTE0_UART0);
    declare!(SPIM0_SPIS0_TWIM0_TWIS0_SPI0_TWI0);
    declare!(SPIM1_SPIS1_TWIM1_TWIS1_SPI1_TWI1);
    declare!(NFCT);
    declare!(GPIOTE);
    declare!(SAADC);
    declare!(TIMER0);
    declare!(TIMER1);
    declare!(TIMER2);
    declare!(RTC0);
    declare!(TEMP);
    declare!(RNG);
    declare!(ECB);
    declare!(CCM_AAR);
    declare!(WDT);
    declare!(RTC1);
    declare!(QDEC);
    declare!(COMP_LPCOMP);
    declare!(SWI0_EGU0);
    declare!(SWI1_EGU1);
    declare!(SWI2_EGU2);
    declare!(SWI3_EGU3);
    declare!(SWI4_EGU4);
    declare!(SWI5_EGU5);
    declare!(TIMER3);
    declare!(TIMER4);
    declare!(PWM0);
    declare!(PDM);
    declare!(MWU);
    declare!(PWM1);
    declare!(PWM2);
    declare!(SPIM2_SPIS2_SPI2);
    declare!(RTC2);
    declare!(I2S);
    declare!(FPU);
    declare!(USBD);
    declare!(UARTE1);
    declare!(QSPI);
    declare!(CRYPTOCELL);
    declare!(PWM3);
    declare!(SPIM3);
}

pub use irqs::*;