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