Struct cortex_m::peripheral::NVIC
source · pub struct NVIC { /* private fields */ }Expand description
Nested Vector Interrupt Controller
Implementations§
source§impl NVIC
impl NVIC
sourcepub fn request<I>(&mut self, interrupt: I)where
I: InterruptNumber,
pub fn request<I>(&mut self, interrupt: I)where
I: InterruptNumber,
Request an IRQ in software
Writing a value to the INTID field is the same as manually pending an interrupt by setting
the corresponding interrupt bit in an Interrupt Set Pending Register. This is similar to
NVIC::pend.
This method is not available on ARMv6-M chips.
sourcepub fn mask<I>(interrupt: I)where
I: InterruptNumber,
pub fn mask<I>(interrupt: I)where
I: InterruptNumber,
Disables interrupt
sourcepub unsafe fn unmask<I>(interrupt: I)where
I: InterruptNumber,
pub unsafe fn unmask<I>(interrupt: I)where
I: InterruptNumber,
Enables interrupt
This function is unsafe because it can break mask-based critical sections
sourcepub fn get_priority<I>(interrupt: I) -> u8where
I: InterruptNumber,
pub fn get_priority<I>(interrupt: I) -> u8where
I: InterruptNumber,
Returns the NVIC priority of interrupt
NOTE NVIC encodes priority in the highest bits of a byte so values like 1 and 2 map
to the same priority. Also for NVIC priorities, a lower value (e.g. 16) has higher
priority (urgency) than a larger value (e.g. 32).
sourcepub fn is_active<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
pub fn is_active<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
Is interrupt active or pre-empted and stacked
sourcepub fn is_enabled<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
pub fn is_enabled<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
Checks if interrupt is enabled
sourcepub fn is_pending<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
pub fn is_pending<I>(interrupt: I) -> boolwhere
I: InterruptNumber,
Checks if interrupt is pending
sourcepub fn pend<I>(interrupt: I)where
I: InterruptNumber,
pub fn pend<I>(interrupt: I)where
I: InterruptNumber,
Forces interrupt into pending state
sourcepub unsafe fn set_priority<I>(&mut self, interrupt: I, prio: u8)where
I: InterruptNumber,
pub unsafe fn set_priority<I>(&mut self, interrupt: I, prio: u8)where
I: InterruptNumber,
Sets the “priority” of interrupt to prio
NOTE See get_priority method for an explanation
of how NVIC priorities work.
On ARMv6-M, updating an interrupt priority requires a read-modify-write operation. On ARMv7-M, the operation is performed in a single atomic write operation.
Unsafety
Changing priority levels can break priority-based critical sections (see
register::basepri) and compromise memory safety.
sourcepub fn unpend<I>(interrupt: I)where
I: InterruptNumber,
pub fn unpend<I>(interrupt: I)where
I: InterruptNumber,
Clears interrupt’s pending state