Struct rp2040_hal::vector_table::VectorTable

#[repr(C, align(256))]
pub struct VectorTable { /* private fields */ }

Data type for a properly aligned interrupt vector table

The VTOR register can only point to a 256 byte offsets - see Cortex-M0+ Devices Generic User Guide - so that is our required alignment. The vector table length depends on the number of interrupts the system supports. The first 16 words are defined in the ARM Cortex-M spec. The M0+ cores on RP2040 have 32 interrupts, of which only 26 are wired to external interrupt signals - but the last 6 can be used for software interrupts so leave room for them

Implementations

impl VectorTable

pub const fn new() -> VectorTable

Create a new vector table. All entries will point to 0 - you must call init() on this to copy the current vector table before setting it as active

pub fn init(&mut self, ppb: &mut PPB)

Initialise our vector table by copying the current table on top of it

pub fn register_handler( &mut self, interrupt_idx: usize, interrupt_fn: extern "C" fn() )

Dynamically register a function as being an interrupt handler

pub unsafe fn set_sp(&mut self, stack_pointer_address: usize)

Set the stack pointer address in a VectorTable. This will be used on Reset

Safety

There is no checking whether this is a valid stack pointer address

pub unsafe fn set_entry(&mut self, entry_address: usize)

Set the entry-point address in a VectorTable. This will be used on Reset

Safety

There is no checking whether this is a valid entry point

pub unsafe fn activate(&mut self, ppb: &mut PPB)

Switch the current core to use this Interrupt Vector Table

Safety

Until the vector table has valid entries, activating it will cause an unhandled hardfault! You must call init() first.

Trait Implementations

impl Default for VectorTable

fn default() -> Self

Returns the “default value” for a type.