From 218e0ca6ee88698d5d9b91331954baead16a6c1b Mon Sep 17 00:00:00 2001 From: Marti Bolivar Date: Fri, 13 Jul 2012 03:09:57 -0400 Subject: Update page. No resolution on the necessary F2 changes, so that's a TODO. Otherwise, the changes are purely stylistic or made for increasing clarity; the API itself hasn't changed. Signed-off-by: Marti Bolivar --- source/libmaple/api/scb.rst | 277 +++++++++++++++++++++----------------------- 1 file changed, 134 insertions(+), 143 deletions(-) (limited to 'source/libmaple/api/scb.rst') diff --git a/source/libmaple/api/scb.rst b/source/libmaple/api/scb.rst index 0c844b1..96d464f 100644 --- a/source/libmaple/api/scb.rst +++ b/source/libmaple/api/scb.rst @@ -1,17 +1,21 @@ .. highlight:: c .. _libmaple-scb: -``scb.h`` -========= +```` +==================== -System Control Block (SCB) support. +.. TODO [0.0.13] check for any F2 modifications + +System Control Block (SCB) support. This is currently limited to a +register map and bit definitions. .. warning:: At time of writing, ST PM0056 (which specifies the system control - block) appears to be buggy (some registers required by ARM are not - mentioned). This file is the result of combining material from ARM - and ST, and is subject to change. + block on STM32F1) appears to be buggy (some registers required or + specified as implementation-defined by ARM are not mentioned). + This file is the result of combining material from ARM and ST, and + is subject to change. See the source code for more details. If you notice a problem or have any other input on this, please `contact`_ us! @@ -19,147 +23,134 @@ System Control Block (SCB) support. .. contents:: Contents :local: -Types ------ - -.. doxygenstruct:: scb_reg_map - -Devices -------- +Register Maps +------------- -None. - -Register Map Base Pointers --------------------------- +The SCB has the following register map. Its base pointer is ``SCB_BASE``. +.. doxygenstruct:: scb_reg_map .. doxygendefine:: SCB_BASE Register Bit Definitions ------------------------ -CPUID base register (SCB_CPUID) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_CPUID_IMPLEMENTER -.. doxygendefine:: SCB_CPUID_VARIANT -.. doxygendefine:: SCB_CPUID_CONSTANT -.. doxygendefine:: SCB_CPUID_PARTNO -.. doxygendefine:: SCB_CPUID_REVISION - -Interrupt control state register (SCB_ICSR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_ICSR_NMIPENDSET -.. doxygendefine:: SCB_ICSR_PENDSVSET -.. doxygendefine:: SCB_ICSR_PENDSVCLR -.. doxygendefine:: SCB_ICSR_PENDSTSET -.. doxygendefine:: SCB_ICSR_PENDSTCLR -.. doxygendefine:: SCB_ICSR_ISRPENDING -.. doxygendefine:: SCB_ICSR_VECTPENDING -.. doxygendefine:: SCB_ICSR_RETOBASE -.. doxygendefine:: SCB_ICSR_VECTACTIVE - -Vector table offset register (SCB_VTOR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_VTOR_TBLOFF - -Application interrupt and reset control register (SCB_AIRCR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_AIRCR_VECTKEYSTAT -.. doxygendefine:: SCB_AIRCR_VECTKEY -.. doxygendefine:: SCB_AIRCR_ENDIANNESS -.. doxygendefine:: SCB_AIRCR_PRIGROUP -.. doxygendefine:: SCB_AIRCR_SYSRESETREQ -.. doxygendefine:: SCB_AIRCR_VECTCLRACTIVE -.. doxygendefine:: SCB_AIRCR_VECTRESET - -System control register (SCB_SCR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_SCR_SEVONPEND -.. doxygendefine:: SCB_SCR_SLEEPDEEP -.. doxygendefine:: SCB_SCR_SLEEPONEXIT - -Configuration and Control Register (SCB_CCR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_CCR_STKALIGN -.. doxygendefine:: SCB_CCR_BFHFNMIGN -.. doxygendefine:: SCB_CCR_DIV_0_TRP -.. doxygendefine:: SCB_CCR_UNALIGN_TRP -.. doxygendefine:: SCB_CCR_USERSETMPEND -.. doxygendefine:: SCB_CCR_NONBASETHRDENA - -System handler priority registers (SCB_SHPRx) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_SHPR1_PRI6 -.. doxygendefine:: SCB_SHPR1_PRI5 -.. doxygendefine:: SCB_SHPR1_PRI4 - -.. doxygendefine:: SCB_SHPR2_PRI11 - -.. doxygendefine:: SCB_SHPR3_PRI15 -.. doxygendefine:: SCB_SHPR3_PRI14 - -System Handler Control and state register (SCB_SHCSR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_SHCSR_USGFAULTENA -.. doxygendefine:: SCB_SHCSR_BUSFAULTENA -.. doxygendefine:: SCB_SHCSR_MEMFAULTENA -.. doxygendefine:: SCB_SHCSR_SVCALLPENDED -.. doxygendefine:: SCB_SHCSR_BUSFAULTPENDED -.. doxygendefine:: SCB_SHCSR_MEMFAULTPENDED -.. doxygendefine:: SCB_SHCSR_USGFAULTPENDED -.. doxygendefine:: SCB_SHCSR_SYSTICKACT -.. doxygendefine:: SCB_SHCSR_PENDSVACT -.. doxygendefine:: SCB_SHCSR_MONITORACT -.. doxygendefine:: SCB_SHCSR_SVCALLACT -.. doxygendefine:: SCB_SHCSR_USGFAULTACT -.. doxygendefine:: SCB_SHCSR_BUSFAULTACT -.. doxygendefine:: SCB_SHCSR_MEMFAULTACT - -Configurable fault status register (SCB_CFSR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_CFSR_DIVBYZERO -.. doxygendefine:: SCB_CFSR_UNALIGNED -.. doxygendefine:: SCB_CFSR_NOCP -.. doxygendefine:: SCB_CFSR_INVPC -.. doxygendefine:: SCB_CFSR_INVSTATE -.. doxygendefine:: SCB_CFSR_UNDEFINSTR -.. doxygendefine:: SCB_CFSR_BFARVALID -.. doxygendefine:: SCB_CFSR_STKERR -.. doxygendefine:: SCB_CFSR_UNSTKERR -.. doxygendefine:: SCB_CFSR_IMPRECISERR -.. doxygendefine:: SCB_CFSR_PRECISERR -.. doxygendefine:: SCB_CFSR_IBUSERR -.. doxygendefine:: SCB_CFSR_MMARVALID -.. doxygendefine:: SCB_CFSR_MSTKERR -.. doxygendefine:: SCB_CFSR_MUNSTKERR -.. doxygendefine:: SCB_CFSR_DACCVIOL -.. doxygendefine:: SCB_CFSR_IACCVIOL - -Hard Fault Status Register (SCB_HFSR) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. doxygendefine:: SCB_HFSR_DEBUG_VT -.. doxygendefine:: SCB_CFSR_FORCED -.. doxygendefine:: SCB_CFSR_VECTTBL - -Debug Fault Status Register -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. note:: This register is not specified in PM0056, but it is required - by ARM. The bit definitions here are based on the names given in - the ARM v7-M ARM. - -.. doxygendefine:: SCB_DFSR_EXTERNAL -.. doxygendefine:: SCB_DFSR_VCATCH -.. doxygendefine:: SCB_DFSR_DWTTRAP -.. doxygendefine:: SCB_DFSR_BKPT -.. doxygendefine:: SCB_DFSR_HALTED - +These are given as source code. + +:: + + /* No SCB_REG_FIELD_BIT macros as the relevant addresses are not in a + * bit-band region. */ + + /* CPUID base register (SCB_CPUID) */ + + #define SCB_CPUID_IMPLEMENTER (0xFF << 24) + #define SCB_CPUID_VARIANT (0xF << 20) + #define SCB_CPUID_CONSTANT (0xF << 16) + #define SCB_CPUID_PARTNO (0xFFF << 4) + #define SCB_CPUID_REVISION 0xF + + /* Interrupt control state register (SCB_ICSR) */ + + #define SCB_ICSR_NMIPENDSET (1U << 31) + #define SCB_ICSR_PENDSVSET (1U << 28) + #define SCB_ICSR_PENDSVCLR (1U << 27) + #define SCB_ICSR_PENDSTSET (1U << 26) + #define SCB_ICSR_PENDSTCLR (1U << 25) + #define SCB_ICSR_ISRPENDING (1U << 22) + #define SCB_ICSR_VECTPENDING (0x3FF << 12) + #define SCB_ICSR_RETOBASE (1U << 11) + #define SCB_ICSR_VECTACTIVE 0xFF + + /* Vector table offset register (SCB_VTOR) */ + + #define SCB_VTOR_TBLOFF (0x1FFFFF << 9) + + /* Application interrupt and reset control register (SCB_AIRCR) */ + + #define SCB_AIRCR_VECTKEYSTAT (0x5FA << 16) + #define SCB_AIRCR_VECTKEY (0x5FA << 16) + #define SCB_AIRCR_ENDIANNESS (1U << 15) + #define SCB_AIRCR_PRIGROUP (0x3 << 8) + #define SCB_AIRCR_SYSRESETREQ (1U << 2) + #define SCB_AIRCR_VECTCLRACTIVE (1U << 1) + #define SCB_AIRCR_VECTRESET (1U << 0) + + /* System control register (SCB_SCR) */ + + #define SCB_SCR_SEVONPEND (1U << 4) + #define SCB_SCR_SLEEPDEEP (1U << 2) + #define SCB_SCR_SLEEPONEXIT (1U << 1) + + /* Configuration and Control Register (SCB_CCR) */ + + #define SCB_CCR_STKALIGN (1U << 9) + #define SCB_CCR_BFHFNMIGN (1U << 8) + #define SCB_CCR_DIV_0_TRP (1U << 4) + #define SCB_CCR_UNALIGN_TRP (1U << 3) + #define SCB_CCR_USERSETMPEND (1U << 1) + #define SCB_CCR_NONBASETHRDENA (1U << 0) + + /* System handler priority registers (SCB_SHPRx) */ + + #define SCB_SHPR1_PRI6 (0xFF << 16) + #define SCB_SHPR1_PRI5 (0xFF << 8) + #define SCB_SHPR1_PRI4 0xFF + + #define SCB_SHPR2_PRI11 (0xFF << 24) + + #define SCB_SHPR3_PRI15 (0xFF << 24) + #define SCB_SHPR3_PRI14 (0xFF << 16) + + /* System Handler Control and state register (SCB_SHCSR) */ + + #define SCB_SHCSR_USGFAULTENA (1U << 18) + #define SCB_SHCSR_BUSFAULTENA (1U << 17) + #define SCB_SHCSR_MEMFAULTENA (1U << 16) + #define SCB_SHCSR_SVCALLPENDED (1U << 15) + #define SCB_SHCSR_BUSFAULTPENDED (1U << 14) + #define SCB_SHCSR_MEMFAULTPENDED (1U << 13) + #define SCB_SHCSR_USGFAULTPENDED (1U << 12) + #define SCB_SHCSR_SYSTICKACT (1U << 11) + #define SCB_SHCSR_PENDSVACT (1U << 10) + #define SCB_SHCSR_MONITORACT (1U << 8) + #define SCB_SHCSR_SVCALLACT (1U << 7) + #define SCB_SHCSR_USGFAULTACT (1U << 3) + #define SCB_SHCSR_BUSFAULTACT (1U << 1) + #define SCB_SHCSR_MEMFAULTACT (1U << 0) + + /* Configurable fault status register (SCB_CFSR) */ + + #define SCB_CFSR_DIVBYZERO (1U << 25) + #define SCB_CFSR_UNALIGNED (1U << 24) + #define SCB_CFSR_NOCP (1U << 19) + #define SCB_CFSR_INVPC (1U << 18) + #define SCB_CFSR_INVSTATE (1U << 17) + #define SCB_CFSR_UNDEFINSTR (1U << 16) + #define SCB_CFSR_BFARVALID (1U << 15) + #define SCB_CFSR_STKERR (1U << 12) + #define SCB_CFSR_UNSTKERR (1U << 11) + #define SCB_CFSR_IMPRECISERR (1U << 10) + #define SCB_CFSR_PRECISERR (1U << 9) + #define SCB_CFSR_IBUSERR (1U << 8) + #define SCB_CFSR_MMARVALID (1U << 7) + #define SCB_CFSR_MSTKERR (1U << 4) + #define SCB_CFSR_MUNSTKERR (1U << 3) + #define SCB_CFSR_DACCVIOL (1U << 1) + #define SCB_CFSR_IACCVIOL (1U << 0) + + /* Hard Fault Status Register (SCB_HFSR) */ + + #define SCB_HFSR_DEBUG_VT (1U << 31) + #define SCB_CFSR_FORCED (1U << 30) + #define SCB_CFSR_VECTTBL (1U << 1) + + /* Debug Fault Status Register */ + + /* Not specified by PM0056, but required by ARM. The bit definitions + * here are based on the names given in the ARM v7-M ARM. */ + + #define SCB_DFSR_EXTERNAL (1U << 4) + #define SCB_DFSR_VCATCH (1U << 3) + #define SCB_DFSR_DWTTRAP (1U << 2) + #define SCB_DFSR_BKPT (1U << 1) + #define SCB_DFSR_HALTED (1U << 0) -- cgit v1.2.3