1 files changed, 78 insertions, 0 deletions
diff --git a/src/lib.rs b/src/lib.rs
new file mode 100644
index 0000000..d8b7fa1
--- /dev/null
+++ b/src/lib.rs
@@ -0,0 +1,78 @@
+//! Low level access to Cortex-M processors
+//!
+//! This crate provides access to:
+//!
+//! - Core peripherals like NVIC, SCB and SysTick.
+//! - Core registers like CONTROL, MSP and PSR.
+//! - Interrupt manipulation mechanisms
+//! - Data structures like the vector table
+//! - Miscellaneous assembly instructions like `bkpt`
+//!
+
+#![deny(missing_docs)]
+#![deny(warnings)]
+#![feature(asm)]
+#![no_std]
+
+extern crate volatile_register;
+
+pub mod asm;
+pub mod interrupt;
+pub mod peripheral;
+pub mod register;
+
+/// Vector Table
+///
+/// # References
+///
+/// - ARMv7-M Architecture Reference Manual (issue E.b) - Section B1.5 - ARMv7-M exception model
+#[repr(C)]
+pub struct VectorTable {
+    /// Reset value of the Main Stack Pointer (MSP)
+    pub sp_main: &'static (),
+    /// Reset
+    pub reset: extern "C" fn() -> !,
+    /// Non Maskable Interrupt
+    pub nmi: Option<Handler>,
+    /// Hard Fault
+    pub hard_fault: Option<Handler>,
+    /// Memory Management
+    pub mem_manage: Option<Handler>,
+    /// Bus Fault
+    pub bus_fault: Option<Handler>,
+    /// Usage Fault
+    pub usage_fault: Option<Handler>,
+    reserved0: [u32; 4],
+    /// Supervisor Call
+    pub svcall: Option<Handler>,
+    /// Debug Monitor
+    pub debug_monitor: Option<Handler>,
+    reserved1: u32,
+    /// PendSV
+    pub pendsv: Option<Handler>,
+    /// SysTick
+    pub sys_tick: Option<Handler>,
+    /// Interrupts. An IMPLEMENTATION DEFINED number of them.
+    pub interrupts: [Option<Handler>; 0],
+}
+
+/// Returns the vector table
+pub fn vector_table() -> &'static VectorTable {
+    unsafe { deref(peripheral::scb().vtor.read() as usize) }
+}
+
+/// Exception/Interrupt Handler
+pub type Handler = unsafe extern "C" fn();
+
+#[cfg(test)]
+fn address<T>(r: &T) -> usize {
+    r as *const T as usize
+}
+
+unsafe fn deref<T>(a: usize) -> &'static T {
+    &*(a as *const T)
+}
+
+unsafe fn deref_mut<T>(a: usize) -> &'static mut T {
+    &mut *(a as *mut T)
+}