|
|
|
|
@@ -21,15 +21,17 @@
|
|
|
|
|
#ifndef LIBOPENCM3_CM3_SCS_H
|
|
|
|
|
#define LIBOPENCM3_CM3_SCS_H
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
/*
|
|
|
|
|
* All the definition hereafter are generic for CortexMx ARMv7-M
|
|
|
|
|
* See ARM document "ARMv7-M Architecture Reference Manual" for more details.
|
|
|
|
|
* See also ARM document "ARM Compiler toolchain Developing Software for ARM Processors" for details on System Timer/SysTick.
|
|
|
|
|
* See also ARM document "ARM Compiler toolchain Developing Software for ARM
|
|
|
|
|
* Processors" for details on System Timer/SysTick.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* The System Control Space (SCS) is a memory-mapped 4KB address space that provides 32-bit registers for
|
|
|
|
|
* configuration, status reporting and control. The SCS registers divide into the following groups:
|
|
|
|
|
* The System Control Space (SCS) is a memory-mapped 4KB address space that
|
|
|
|
|
* provides 32-bit registers for configuration, status reporting and control.
|
|
|
|
|
* The SCS registers divide into the following groups:
|
|
|
|
|
* - system control and identification
|
|
|
|
|
* - the CPUID processor identification space
|
|
|
|
|
* - system configuration and status
|
|
|
|
|
@@ -46,25 +48,27 @@
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Debug Halting Control and Status Register (DHCSR).
|
|
|
|
|
*
|
|
|
|
|
*
|
|
|
|
|
* Purpose Controls halting debug.
|
|
|
|
|
* Usage constraints: The effect of modifying the C_STEP or C_MASKINTS bit when the system
|
|
|
|
|
* is running with halting debug enabled is UNPREDICTABLE.
|
|
|
|
|
* Halting debug is enabled when C_DEBUGEN is set to 1. The system is running when S_HALT is set to 0.
|
|
|
|
|
* - When C_DEBUGEN is set to 0, the processor ignores the values of all other bits in this register.
|
|
|
|
|
* - For more information about the use of DHCSR see Debug stepping on
|
|
|
|
|
* page C1-824.
|
|
|
|
|
* Usage constraints: The effect of modifying the C_STEP or C_MASKINTS bit when
|
|
|
|
|
* the system is running with halting debug enabled is UNPREDICTABLE.
|
|
|
|
|
* Halting debug is enabled when C_DEBUGEN is set to 1. The system is running
|
|
|
|
|
* when S_HALT is set to 0.
|
|
|
|
|
* - When C_DEBUGEN is set to 0, the processor ignores the values of all other
|
|
|
|
|
* bits in this register.
|
|
|
|
|
* - For more information about the use of DHCSR see Debug stepping on page
|
|
|
|
|
* C1-824.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
*/
|
|
|
|
|
/* SCS_DHCSR register */
|
|
|
|
|
#define SCS_DHCSR MMIO32(SCS_BASE + 0xDF0)
|
|
|
|
|
/*
|
|
|
|
|
* Debug Core Register Selector Register (DCRSR).
|
|
|
|
|
*
|
|
|
|
|
* Purpose With the DCRDR, the DCRSR provides debug access to the ARM core registers,
|
|
|
|
|
* special-purpose registers, and Floating-point extension registers. A write to DCRSR
|
|
|
|
|
* specifies the register to transfer, whether the transfer is a read or a write, and starts
|
|
|
|
|
* the transfer.
|
|
|
|
|
*
|
|
|
|
|
* Purpose With the DCRDR, the DCRSR provides debug access to the ARM core
|
|
|
|
|
* registers, special-purpose registers, and Floating-point extension
|
|
|
|
|
* registers. A write to DCRSR specifies the register to transfer, whether the
|
|
|
|
|
* transfer is a read or a write, and starts the transfer.
|
|
|
|
|
* Usage constraints: Only accessible in Debug state.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
*
|
|
|
|
|
@@ -73,15 +77,16 @@
|
|
|
|
|
#define SCS_DCRSR MMIO32(SCS_BASE + 0xDF4)
|
|
|
|
|
/*
|
|
|
|
|
* Debug Core Register Data Register (DCRDR)
|
|
|
|
|
*
|
|
|
|
|
* Purpose With the DCRSR, see Debug Core Register Selector Register,
|
|
|
|
|
* the DCRDR provides debug access to the ARM core registers,
|
|
|
|
|
* special-purpose registers, and Floating-point extension registers. The
|
|
|
|
|
* DCRDR is the data register for these accesses.
|
|
|
|
|
* - Used on its own, the DCRDR provides a message passing resource between
|
|
|
|
|
* an external debugger and a debug agent running on the processor.
|
|
|
|
|
*
|
|
|
|
|
* Purpose With the DCRSR, see Debug Core Register Selector Register, the DCRDR
|
|
|
|
|
* provides debug access to the ARM core registers, special-purpose registers,
|
|
|
|
|
* and Floating-point extension registers. The DCRDR is the data register for
|
|
|
|
|
* these accesses.
|
|
|
|
|
* - Used on its own, the DCRDR provides a message passing resource between an
|
|
|
|
|
* external debugger and a debug agent running on the processor.
|
|
|
|
|
* Note:
|
|
|
|
|
* The architecture does not define any handshaking mechanism for this use of DCRDR.
|
|
|
|
|
* The architecture does not define any handshaking mechanism for this use of
|
|
|
|
|
* DCRDR.
|
|
|
|
|
* Usage constraints: See Use of DCRSR and DCRDR for constraints that apply to
|
|
|
|
|
* particular transfers using the DCRSR and DCRDR.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
@@ -92,12 +97,13 @@
|
|
|
|
|
/*
|
|
|
|
|
* Debug Exception and Monitor Control Register (DEMCR).
|
|
|
|
|
*
|
|
|
|
|
* Purpose Manages vector catch behavior and DebugMonitor handling when debugging.
|
|
|
|
|
* Purpose Manages vector catch behavior and DebugMonitor handling when
|
|
|
|
|
* debugging.
|
|
|
|
|
* Usage constraints:
|
|
|
|
|
* - Bits [23:16] provide DebugMonitor exception control.
|
|
|
|
|
* - Bits [15:0] provide Debug state, halting debug, control.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
*
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
/* SCS_DEMCR register */
|
|
|
|
|
#define SCS_DEMCR MMIO32(SCS_BASE + 0xDFC)
|
|
|
|
|
@@ -143,20 +149,22 @@
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* System Control Space (SCS) => System timer register support in the SCS.
|
|
|
|
|
* To configure SysTick, load the interval required between SysTick events to the SysTick Reload
|
|
|
|
|
* Value register. The timer interrupt, or COUNTFLAG bit in the SysTick Control and Status
|
|
|
|
|
* register, is activated on the transition from 1 to 0, therefore it activates every n+1 clock ticks.
|
|
|
|
|
* If you require a period of 100, write 99 to the SysTick Reload Value register. The SysTick Reload
|
|
|
|
|
* Value register supports values between 0x1 and 0x00FFFFFF.
|
|
|
|
|
* To configure SysTick, load the interval required between SysTick events to
|
|
|
|
|
* the SysTick Reload Value register. The timer interrupt, or COUNTFLAG bit in
|
|
|
|
|
* the SysTick Control and Status register, is activated on the transition from
|
|
|
|
|
* 1 to 0, therefore it activates every n+1 clock ticks. If you require a
|
|
|
|
|
* period of 100, write 99 to the SysTick Reload Value register. The SysTick
|
|
|
|
|
* Reload Value register supports values between 0x1 and 0x00FFFFFF.
|
|
|
|
|
*
|
|
|
|
|
* If you want to use SysTick to generate an event at a timed interval, for example 1ms, you can
|
|
|
|
|
* use the SysTick Calibration Value Register to scale your value for the Reload register. The
|
|
|
|
|
* SysTick Calibration Value Register is a read-only register that contains the number of pulses for
|
|
|
|
|
* a period of 10ms, in the TENMS field, bits[23:0].
|
|
|
|
|
* If you want to use SysTick to generate an event at a timed interval, for
|
|
|
|
|
* example 1ms, you can use the SysTick Calibration Value Register to scale
|
|
|
|
|
* your value for the Reload register. The SysTick Calibration Value Register
|
|
|
|
|
* is a read-only register that contains the number of pulses for a period of
|
|
|
|
|
* 10ms, in the TENMS field, bits[23:0].
|
|
|
|
|
*
|
|
|
|
|
* This register also has a SKEW bit. Bit[30] == 1 indicates that the calibration for 10ms in the
|
|
|
|
|
* TENMS section is not exactly 10ms due to clock frequency. Bit[31] == 1 indicates that the
|
|
|
|
|
* reference clock is not provided.
|
|
|
|
|
* This register also has a SKEW bit. Bit[30] == 1 indicates that the
|
|
|
|
|
* calibration for 10ms in the TENMS section is not exactly 10ms due to clock
|
|
|
|
|
* frequency. Bit[31] == 1 indicates that the reference clock is not provided.
|
|
|
|
|
*/
|
|
|
|
|
/*
|
|
|
|
|
* SysTick Control and Status Register (CSR).
|
|
|
|
|
@@ -176,14 +184,14 @@
|
|
|
|
|
*/
|
|
|
|
|
#define CM_SCS_SYST_RVR MMIO32(SCS_BASE + 0x14)
|
|
|
|
|
|
|
|
|
|
/* SysTick Current Value Register (RVR).
|
|
|
|
|
/* SysTick Current Value Register (RVR).
|
|
|
|
|
* Purpose Holds the reload value of the SYST_CVR.
|
|
|
|
|
* Usage constraints There are no usage constraints.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
*/
|
|
|
|
|
#define CM_SCS_SYST_CVR MMIO32(SCS_BASE + 0x18)
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
/*
|
|
|
|
|
* SysTick Calibration value Register(Read Only) (CALIB)
|
|
|
|
|
* Purpose Reads the calibration value and parameters for SysTick.
|
|
|
|
|
* Usage constraints: There are no usage constraints.
|
|
|
|
|
@@ -198,72 +206,86 @@
|
|
|
|
|
#define SCS_SYST_CSR_TICKINT (BIT1)
|
|
|
|
|
/* SysTick uses the processor clock. */
|
|
|
|
|
#define SCS_SYST_CSR_CLKSOURCE (BIT2)
|
|
|
|
|
/*
|
|
|
|
|
* Indicates whether the counter has counted to 0 since the last read of this register:
|
|
|
|
|
/*
|
|
|
|
|
* Indicates whether the counter has counted to 0 since the last read of this
|
|
|
|
|
* register:
|
|
|
|
|
* 0 = Timer has not counted to 0
|
|
|
|
|
* 1 = Timer has counted to 0.
|
|
|
|
|
* 1 = Timer has counted to 0.
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_SYST_CSR_COUNTFLAG (BIT16)
|
|
|
|
|
|
|
|
|
|
/* --- CM_SCS_SYST_RVR values ----------------------------------------------- */
|
|
|
|
|
/* Bit 0 to 23 => RELOAD The value to load into the SYST_CVR when the counter reaches 0. */
|
|
|
|
|
/* --- CM_SCS_SYST_RVR values ---------------------------------------------- */
|
|
|
|
|
/* Bit 0 to 23 => RELOAD The value to load into the SYST_CVR when the counter
|
|
|
|
|
* reaches 0.
|
|
|
|
|
*/
|
|
|
|
|
/* Bit 24 to 31 are Reserved */
|
|
|
|
|
|
|
|
|
|
/* --- CM_SCS_SYST_CVR values ----------------------------------------------- */
|
|
|
|
|
/* --- CM_SCS_SYST_CVR values ---------------------------------------------- */
|
|
|
|
|
/* Bit0 to 31 => Reads or clears the current counter value. */
|
|
|
|
|
|
|
|
|
|
/* --- CM_SCS_SYST_CALIB values ----------------------------------------------- */
|
|
|
|
|
/*
|
|
|
|
|
* Bit0 to 23 => TENMS Optionally, holds a reload value to be used for 10ms (100Hz) timing, subject to system clock
|
|
|
|
|
* skew errors. If this field is zero, the calibration value is not known.
|
|
|
|
|
/* --- CM_SCS_SYST_CALIB values -------------------------------------------- */
|
|
|
|
|
/*
|
|
|
|
|
* Bit0 to 23 => TENMS Optionally, holds a reload value to be used for 10ms
|
|
|
|
|
* (100Hz) timing, subject to system clock skew errors. If this field is zero,
|
|
|
|
|
* the calibration value is not known.
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_SYST_SYST_CALIB_TENMS_MASK (BIT24-1)
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
/*
|
|
|
|
|
* Bit30 => SKEW Indicates whether the 10ms calibration value is exact:
|
|
|
|
|
* 0 = 10ms calibration value is exact.
|
|
|
|
|
* 1 = 10ms calibration value is inexact, because of the clock frequency
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_SYST_SYST_CALIB_VALUE_INEXACT (BIT30)
|
|
|
|
|
/*
|
|
|
|
|
* Bit31 => NOREF Indicates whether the IMPLEMENTATION DEFINED reference clock is implemented:
|
|
|
|
|
/*
|
|
|
|
|
* Bit31 => NOREF Indicates whether the IMPLEMENTATION DEFINED reference clock
|
|
|
|
|
* is implemented:
|
|
|
|
|
* 0 = The reference clock is implemented.
|
|
|
|
|
* 1 = The reference clock is not implemented.
|
|
|
|
|
* When this bit is 1, the CLKSOURCE bit of the SYST_CSR register is forced to 1 and cannot
|
|
|
|
|
* be cleared to 0.
|
|
|
|
|
* When this bit is 1, the CLKSOURCE bit of the SYST_CSR register is forced to
|
|
|
|
|
* 1 and cannot be cleared to 0.
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_SYST_SYST_CALIB_REF_NOT_IMPLEMENTED (BIT31)
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
/*
|
|
|
|
|
* System Control Space (SCS) => Data Watchpoint and Trace (DWT).
|
|
|
|
|
* See http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0403c/index.html (ARMv7-M Architecture Reference Manual)
|
|
|
|
|
* The DWT is an optional debug unit that provides watchpoints, data tracing, and system profiling
|
|
|
|
|
* for the processor.
|
|
|
|
|
* See http://goo.gl/mZm30 (ARMv7-M Architecture Reference Manual)
|
|
|
|
|
* The DWT is an optional debug unit that provides watchpoints, data tracing,
|
|
|
|
|
* and system profiling for the processor.
|
|
|
|
|
*/
|
|
|
|
|
/*
|
|
|
|
|
* DWT Control register
|
|
|
|
|
* Purpose Provides configuration and status information for the DWT block, and used to control features of the block
|
|
|
|
|
/*
|
|
|
|
|
* DWT Control register
|
|
|
|
|
* Purpose Provides configuration and status information for the DWT block, and
|
|
|
|
|
* used to control features of the block
|
|
|
|
|
* Usage constraints: There are no usage constraints.
|
|
|
|
|
* Configurations Always implemented.
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_DWT_CTRL MMIO32(DWT_BASE + 0x00)
|
|
|
|
|
/*
|
|
|
|
|
* DWT_CYCCNT register
|
|
|
|
|
* Cycle Count Register (Shows or sets the value of the processor cycle counter, CYCCNT)
|
|
|
|
|
* When enabled, CYCCNT increments on each processor clock cycle. On overflow, CYCCNT wraps to zero.
|
|
|
|
|
* Cycle Count Register (Shows or sets the value of the processor cycle
|
|
|
|
|
* counter, CYCCNT)
|
|
|
|
|
* When enabled, CYCCNT increments on each processor clock cycle. On overflow,
|
|
|
|
|
* CYCCNT wraps to zero.
|
|
|
|
|
*
|
|
|
|
|
* Purpose Shows or sets the value of the processor cycle counter, CYCCNT.
|
|
|
|
|
* Usage constraints: The DWT unit suspends CYCCNT counting when the processor is in Debug state.
|
|
|
|
|
* Configurations Implemented: only when DWT_CTRL.NOCYCCNT is RAZ, see Control register, DWT_CTRL.
|
|
|
|
|
* When DWT_CTRL.NOCYCCNT is RAO no cycle counter is implemented and this register is UNK/SBZP.
|
|
|
|
|
* Usage constraints: The DWT unit suspends CYCCNT counting when the processor
|
|
|
|
|
* is in Debug state.
|
|
|
|
|
* Configurations Implemented: only when DWT_CTRL.NOCYCCNT is RAZ, see Control
|
|
|
|
|
* register, DWT_CTRL.
|
|
|
|
|
* When DWT_CTRL.NOCYCCNT is RAO no cycle counter is implemented and this
|
|
|
|
|
* register is UNK/SBZP.
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_DWT_CYCCNT MMIO32(DWT_BASE + 0x04)
|
|
|
|
|
|
|
|
|
|
/* DWT_CPICNT register
|
|
|
|
|
* Purpose Counts additional cycles required to execute multi-cycle instructions and instruction fetch stalls.
|
|
|
|
|
* Usage constraints: The counter initializes to 0 when software enables its counter overflow event by
|
|
|
|
|
/* DWT_CPICNT register
|
|
|
|
|
* Purpose Counts additional cycles required to execute multi-cycle
|
|
|
|
|
* instructions and instruction fetch stalls.
|
|
|
|
|
* Usage constraints: The counter initializes to 0 when software enables its
|
|
|
|
|
* counter overflow event by
|
|
|
|
|
* setting the DWT_CTRL.CPIEVTENA bit to 1.
|
|
|
|
|
* Configurations Implemented: only when DWT_CTRL.NOPRFCNT is RAZ, see Control register, DWT_CTRL.
|
|
|
|
|
* Configurations Implemented: only when DWT_CTRL.NOPRFCNT is RAZ, see Control
|
|
|
|
|
* register, DWT_CTRL.
|
|
|
|
|
* If DWT_CTRL.NOPRFCNT is RAO, indicating that the implementation does not
|
|
|
|
|
* include the profiling counters, this register is UNK/SBZP.
|
|
|
|
|
*/
|
|
|
|
|
@@ -284,8 +306,8 @@
|
|
|
|
|
/* DWT_PCSR register */
|
|
|
|
|
#define SCS_DWT_PCSR MMIO32(DWT_BASE + 0x18)
|
|
|
|
|
|
|
|
|
|
/* --- SCS_DWT_CTRL values ----------------------------------------------- */
|
|
|
|
|
/*
|
|
|
|
|
/* --- SCS_DWT_CTRL values ------------------------------------------------- */
|
|
|
|
|
/*
|
|
|
|
|
* Enables CYCCNT:
|
|
|
|
|
* 0 = Disabled, 1 = Enabled
|
|
|
|
|
* This bit is UNK/SBZP if the NOCYCCNT bit is RAO.
|
|
|
|
|
@@ -295,15 +317,20 @@
|
|
|
|
|
/* TODO bit definition values for other DWT_XXX register */
|
|
|
|
|
|
|
|
|
|
/* Macro to be called at startup to enable SCS & Cycle Counter */
|
|
|
|
|
#define SCS_DWT_CYCLE_COUNTER_ENABLED() ( (SCS_DEMCR |= SCS_DEMCR_TRCENA)\
|
|
|
|
|
(SCS_DWT_CTRL |= SCS_DWT_CTRL_CYCCNTENA) )
|
|
|
|
|
#define SCS_DWT_CYCLE_COUNTER_ENABLED() ((SCS_DEMCR |= SCS_DEMCR_TRCENA)\
|
|
|
|
|
(SCS_DWT_CTRL |= SCS_DWT_CTRL_CYCCNTENA))
|
|
|
|
|
|
|
|
|
|
#define SCS_SYSTICK_DISABLED() (SCS_SYST_CSR=0)
|
|
|
|
|
#define SCS_SYSTICK_DISABLED() (SCS_SYST_CSR = 0)
|
|
|
|
|
|
|
|
|
|
/* Macro to be called at startup to Enable CortexMx SysTick (but IRQ not enabled) */
|
|
|
|
|
#define SCS_SYSTICK_ENABLED() (SCS_SYST_CSR=(SCS_SYST_CSR_ENABLE | SCS_SYST_CSR_CLKSOURCE))
|
|
|
|
|
/* Macro to be called at startup to Enable CortexMx SysTick (but IRQ not
|
|
|
|
|
* enabled)
|
|
|
|
|
*/
|
|
|
|
|
#define SCS_SYSTICK_ENABLED() (SCS_SYST_CSR = (SCS_SYST_CSR_ENABLE | \
|
|
|
|
|
SCS_SYST_CSR_CLKSOURCE))
|
|
|
|
|
|
|
|
|
|
/* Macro to be called at startup to Enable CortexMx SysTick and IRQ */
|
|
|
|
|
#define SCS_SYSTICK_AND_IRQ_ENABLED() (SCS_SYST_CSR=(SCS_SYST_CSR_ENABLE | SCS_SYST_CSR_CLKSOURCE | SCS_SYST_CSR_TICKINT))
|
|
|
|
|
#define SCS_SYSTICK_AND_IRQ_ENABLED() (SCS_SYST_CSR = (SCS_SYST_CSR_ENABLE | \
|
|
|
|
|
SCS_SYST_CSR_CLKSOURCE | \
|
|
|
|
|
SCS_SYST_CSR_TICKINT))
|
|
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|
|