Collaboration diagram for ARMv7-M Specific Implementation:

Detailed Description

ARMv7-M specific port code, structures and macros.

Data Structures
struct	context
	Platform dependent part of the `Thread` structure. More...
Functions
	CH_IRQ_HANDLER (SysTickVector)
	System Timer vector.
void	SVCallVector (void)
	SVC vector.
void	PendSVVector (void)
	PendSV vector.
void	_port_init (void)
	Port-related initialization code.
void	_port_irq_epilogue (void)
	Exception exit redirection to _port_switch_from_isr().
void	port_halt (void)
	Halts the system.
void	_port_switch_from_isr (void)
	Post-IRQ switch code.
void	_port_switch (Thread ntp, Thread otp)
	Performs a context switch between two threads.
void	_port_thread_start (void)
	Start a thread by invoking its work function.
Defines
#define	CORTEX_BASEPRI_DISABLED 0
	Disabled value for BASEPRI register.
#define	PORT_IDLE_THREAD_STACK_SIZE 16
	Stack size for the system idle thread.
#define	PORT_INT_REQUIRED_STACK 32
	Per-thread stack overhead for interrupts servicing.
#define	CORTEX_ENABLE_WFI_IDLE FALSE
	Enables the use of the WFI instruction in the idle thread loop.
#define	CORTEX_PRIORITY_SYSTICK (CORTEX_PRIORITY_LEVELS >> 1)
	SYSTICK handler priority.
#define	CORTEX_USE_FPU CORTEX_HAS_FPU
	FPU support in context switch.
#define	CORTEX_SIMPLIFIED_PRIORITY FALSE
	Simplified priority handling flag.
#define	CORTEX_PRIORITY_SVCALL (CORTEX_MAXIMUM_PRIORITY + 1)
	SVCALL handler priority.
#define	CORTEX_VTOR_INIT 0x00000000
	NVIC VTOR initialization expression.
#define	CORTEX_PRIGROUP_INIT (7 - CORTEX_PRIORITY_BITS)
	NVIC PRIGROUP initialization expression.
#define	CORTEX_MAX_KERNEL_PRIORITY (CORTEX_PRIORITY_SVCALL + 1)
	Maximum usable priority for normal ISRs.
#define	CORTEX_BASEPRI_KERNEL CORTEX_PRIORITY_MASK(CORTEX_MAX_KERNEL_PRIORITY)
	BASEPRI level within kernel lock.
#define	CORTEX_PRIORITY_PENDSV CORTEX_BASEPRI_KERNEL
	PendSV priority level.
#define	CH_ARCHITECTURE_ARM_v7M
	Macro defining the specific ARM architecture.
#define	CH_ARCHITECTURE_NAME "ARMv7-M"
	Name of the implemented architecture.
#define	CH_CORE_VARIANT_NAME "Cortex-M3"
	Name of the architecture variant.
#define	CH_PORT_INFO "Advanced kernel mode"
	Port-specific information string.
#define	SETUP_CONTEXT(workspace, wsize, pf, arg)
	Platform dependent part of the `chThdCreateI()` API.
#define	STACK_ALIGN(n) ((((n) - 1) \| (sizeof(stkalign_t) - 1)) + 1)
	Enforces a correct alignment for a stack area size value.
#define	THD_WA_SIZE(n)
	Computes the thread working area global size.
#define	WORKING_AREA(s, n) stkalign_t s[THD_WA_SIZE(n) / sizeof(stkalign_t)]
	Static working area allocation.
#define	PORT_IRQ_PROLOGUE()
	IRQ prologue code.
#define	PORT_IRQ_EPILOGUE() _port_irq_epilogue()
	IRQ epilogue code.
#define	PORT_IRQ_HANDLER(id) void id(void)
	IRQ handler function declaration.
#define	PORT_FAST_IRQ_HANDLER(id) void id(void)
	Fast IRQ handler function declaration.
#define	port_init() _port_init()
	Port-related initialization code.
#define	port_lock() __set_BASEPRI(CORTEX_BASEPRI_KERNEL)
	Kernel-lock action.
#define	port_unlock() __set_BASEPRI(CORTEX_BASEPRI_DISABLED)
	Kernel-unlock action.
#define	port_lock_from_isr() port_lock()
	Kernel-lock action from an interrupt handler.
#define	port_unlock_from_isr() port_unlock()
	Kernel-unlock action from an interrupt handler.
#define	port_disable() __disable_interrupt()
	Disables all the interrupt sources.
#define	port_suspend()
	Disables the interrupt sources below kernel-level priority.
#define	port_enable()
	Enables all the interrupt sources.
#define	port_wait_for_interrupt() asm ("wfi")
	Enters an architecture-dependent IRQ-waiting mode.
#define	port_switch(ntp, otp) _port_switch(ntp, otp)
	Performs a context switch between two threads.
Typedefs
typedef void *	regarm_t
	Generic ARM register.
typedef uint64_t	stkalign_t
	Stack and memory alignment enforcement.

Function Documentation

CH_IRQ_HANDLER ( SysTickVector )

System Timer vector.

This interrupt is used as system tick.

Note:: The timer must be initialized in the startup code.

Definition at line 47 of file IAR/ARMCMx/chcore_v7m.c.

References CH_IRQ_EPILOGUE, CH_IRQ_PROLOGUE, chSysLockFromIsr, chSysTimerHandlerI(), and chSysUnlockFromIsr.

Here is the call graph for this function:

void SVCallVector ( void )

SVC vector.

The SVC vector is used for exception mode re-entering after a context switch.

Note:: The PendSV vector is only used in advanced kernel mode.

Definition at line 65 of file IAR/ARMCMx/chcore_v7m.c.

References port_unlock_from_isr().

Here is the call graph for this function:

void PendSVVector ( void )

PendSV vector.

The PendSV vector is used for exception mode re-entering after a context switch.

Note:: The PendSV vector is only used in compact kernel mode.

Definition at line 92 of file IAR/ARMCMx/chcore_v7m.c.

void _port_init ( void )

Port-related initialization code.

Definition at line 118 of file IAR/ARMCMx/chcore_v7m.c.

References CORTEX_PRIGROUP_INIT, CORTEX_PRIORITY_MASK, CORTEX_PRIORITY_PENDSV, CORTEX_PRIORITY_SVCALL, CORTEX_PRIORITY_SYSTICK, CORTEX_VTOR_INIT, HANDLER_PENDSV, HANDLER_SVCALL, HANDLER_SYSTICK, and nvicSetSystemHandlerPriority().

Here is the call graph for this function:

void _port_irq_epilogue ( void )

Exception exit redirection to _port_switch_from_isr().

Definition at line 153 of file IAR/ARMCMx/chcore_v7m.c.

References chSchIsPreemptionRequired(), port_lock_from_isr(), and port_unlock_from_isr().

Here is the call graph for this function:

void port_halt ( void )

Halts the system.

This function is invoked by the operating system when an unrecoverable error is detected (for example because a programming error in the application code that triggers an assertion while in debug mode).

Note:: The function is declared as a weak symbol, it is possible to redefine it in your application code.

This function is invoked by the operating system when an unrecoverable error is detected (for example because a programming error in the application code that triggers an assertion while in debug mode).

Note:: The function is declared as a weak symbol, it is possible to redefine it in your application code.

Definition at line 121 of file kernel/templates/chcore.c.

void _port_switch_from_isr ( void )

Post-IRQ switch code.

The switch is performed in thread context then an NMI exception is enforced in order to return to the exact point before the preemption.

Exception handlers return here for context switching.

Definition at line 141 of file GCC/ARMCMx/chcore_v6m.c.

void _port_switch	(	Thread *	ntp,
		Thread *	otp
	)

Performs a context switch between two threads.

This is the most critical code in any port, this function is responsible for the context switch between 2 threads.

Note:: The implementation of this code affects directly the context switch performance so optimize here as much as you can.

Parameters:

[in]	ntp	the thread to be switched in
[in]	otp	the thread to be switched out

Definition at line 172 of file GCC/ARMCMx/chcore_v6m.c.

void _port_thread_start ( void )

Start a thread by invoking its work function.

If the work function returns chThdExit() is automatically invoked.

Definition at line 198 of file GCC/ARMCMx/chcore_v6m.c.

Define Documentation

#define CORTEX_BASEPRI_DISABLED 0

Disabled value for BASEPRI register.

Definition at line 46 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_IDLE_THREAD_STACK_SIZE 16

Stack size for the system idle thread.

This size depends on the idle thread implementation, usually the idle thread should take no more space than those reserved by PORT_INT_REQUIRED_STACK.

Note:: In this port it is set to 16 because the idle thread does have a stack frame when compiling without optimizations. You may reduce this value to zero when compiling with optimizations.

Definition at line 66 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_INT_REQUIRED_STACK 32

Per-thread stack overhead for interrupts servicing.

This constant is used in the calculation of the correct working area size.

Note:: In this port this value is conservatively set to 32 because the function chSchDoReschedule() can have a stack frame, especially with compiler optimizations disabled. The value can be reduced when compiler optimizations are enabled.

Definition at line 79 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_ENABLE_WFI_IDLE FALSE

Enables the use of the WFI instruction in the idle thread loop.

Definition at line 86 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_PRIORITY_SYSTICK (CORTEX_PRIORITY_LEVELS >> 1)

SYSTICK handler priority.

Note:: The default SYSTICK handler priority is calculated as the priority level in the middle of the numeric priorities range.

Definition at line 95 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_USE_FPU CORTEX_HAS_FPU

FPU support in context switch.

Activating this option activates the FPU support in the kernel.

Definition at line 106 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_SIMPLIFIED_PRIORITY FALSE

Simplified priority handling flag.

Activating this option makes the Kernel work in compact mode.

Definition at line 118 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_PRIORITY_SVCALL (CORTEX_MAXIMUM_PRIORITY + 1)

SVCALL handler priority.

Note:: The default SVCALL handler priority is defaulted to CORTEX_MAXIMUM_PRIORITY+1, this reserves the CORTEX_MAXIMUM_PRIORITY priority level as fast interrupts priority level.

Definition at line 129 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_VTOR_INIT 0x00000000

NVIC VTOR initialization expression.

Definition at line 139 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_PRIGROUP_INIT (7 - CORTEX_PRIORITY_BITS)

NVIC PRIGROUP initialization expression.

The default assigns all available priority bits as preemption priority with no sub-priority.

Definition at line 148 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_MAX_KERNEL_PRIORITY (CORTEX_PRIORITY_SVCALL + 1)

Maximum usable priority for normal ISRs.

Definition at line 159 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_BASEPRI_KERNEL CORTEX_PRIORITY_MASK(CORTEX_MAX_KERNEL_PRIORITY)

BASEPRI level within kernel lock.

Note:: In compact kernel mode this constant value is enforced to zero.

Definition at line 165 of file IAR/ARMCMx/chcore_v7m.h.

#define CORTEX_PRIORITY_PENDSV CORTEX_BASEPRI_KERNEL

PendSV priority level.

Note:: This priority is enforced to be equal to CORTEX_BASEPRI_KERNEL, this handler always have the highest priority that cannot preempt the kernel.

Definition at line 179 of file IAR/ARMCMx/chcore_v7m.h.

#define CH_ARCHITECTURE_ARM_v7M

Macro defining the specific ARM architecture.

Definition at line 189 of file IAR/ARMCMx/chcore_v7m.h.

#define CH_ARCHITECTURE_NAME "ARMv7-M"

Name of the implemented architecture.

Definition at line 194 of file IAR/ARMCMx/chcore_v7m.h.

#define CH_CORE_VARIANT_NAME "Cortex-M3"

Name of the architecture variant.

Definition at line 199 of file IAR/ARMCMx/chcore_v7m.h.

#define CH_PORT_INFO "Advanced kernel mode"

Port-specific information string.

Definition at line 215 of file IAR/ARMCMx/chcore_v7m.h.

#define SETUP_CONTEXT	(	workspace,
		wsize,
		pf,
		arg
	)

Value:

{                          \
  tp->p_ctx.r13 = (struct intctx *)((uint8_t *)workspace +                  \
                                     wsize -                                \
                                     sizeof(struct intctx));                \
  tp->p_ctx.r13->r4 = (regarm_t)pf;                                         \
  tp->p_ctx.r13->r5 = (regarm_t)arg;                                        \
  tp->p_ctx.r13->lr = (regarm_t)_port_thread_start;                         \
}

Platform dependent part of the chThdCreateI() API.

This code usually setup the context switching frame represented by an intctx structure.

Definition at line 320 of file IAR/ARMCMx/chcore_v7m.h.

#define STACK_ALIGN ( n ) ((((n) - 1) | (sizeof(stkalign_t) - 1)) + 1)

Enforces a correct alignment for a stack area size value.

Definition at line 332 of file IAR/ARMCMx/chcore_v7m.h.

#define THD_WA_SIZE ( n )

Value:

STACK_ALIGN(sizeof(Thread) +                         \
                                   sizeof(struct intctx) +                  \
                                   sizeof(struct extctx) +                  \
                                   (n) + (PORT_INT_REQUIRED_STACK))

Computes the thread working area global size.

Definition at line 337 of file IAR/ARMCMx/chcore_v7m.h.

#define WORKING_AREA	(	s,
		n
	)	stkalign_t s[THD_WA_SIZE(n) / sizeof(stkalign_t)]

Static working area allocation.

This macro is used to allocate a static thread working area aligned as both position and size.

Definition at line 347 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_IRQ_PROLOGUE ( )

IRQ prologue code.

This macro must be inserted at the start of all IRQ handlers enabled to invoke system APIs.

Definition at line 354 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_IRQ_EPILOGUE ( ) _port_irq_epilogue()

IRQ epilogue code.

This macro must be inserted at the end of all IRQ handlers enabled to invoke system APIs.

Definition at line 361 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_IRQ_HANDLER ( id ) void id(void)

IRQ handler function declaration.

Note:: id can be a function name or a vector number depending on the port implementation.

Definition at line 368 of file IAR/ARMCMx/chcore_v7m.h.

#define PORT_FAST_IRQ_HANDLER ( id ) void id(void)

Fast IRQ handler function declaration.

Note:: id can be a function name or a vector number depending on the port implementation.

Definition at line 375 of file IAR/ARMCMx/chcore_v7m.h.

#define port_init ( void ) _port_init()

Port-related initialization code.

Definition at line 380 of file IAR/ARMCMx/chcore_v7m.h.

#define port_lock ( void ) __set_BASEPRI(CORTEX_BASEPRI_KERNEL)

Kernel-lock action.

Usually this function just disables interrupts but may perform more actions.

Note:: In this port this it raises the base priority to kernel level.

Definition at line 389 of file IAR/ARMCMx/chcore_v7m.h.

#define port_unlock ( void ) __set_BASEPRI(CORTEX_BASEPRI_DISABLED)

Kernel-unlock action.

Usually this function just enables interrupts but may perform more actions.

Note:: In this port this it lowers the base priority to user level.

Definition at line 401 of file IAR/ARMCMx/chcore_v7m.h.

#define port_lock_from_isr ( void ) port_lock()

Kernel-lock action from an interrupt handler.

This function is invoked before invoking I-class APIs from interrupt handlers. The implementation is architecture dependent, in its simplest form it is void.

Note:: Same as port_lock() in this port.

Definition at line 413 of file IAR/ARMCMx/chcore_v7m.h.

#define port_unlock_from_isr ( void ) port_unlock()

Kernel-unlock action from an interrupt handler.

This function is invoked after invoking I-class APIs from interrupt handlers. The implementation is architecture dependent, in its simplest form it is void.

Note:: Same as port_unlock() in this port.

Definition at line 422 of file IAR/ARMCMx/chcore_v7m.h.

#define port_disable ( void ) __disable_interrupt()

Disables all the interrupt sources.

Note:: Of course non-maskable interrupt sources are not included.; In this port it disables all the interrupt sources by raising the priority mask to level 0.

Definition at line 430 of file IAR/ARMCMx/chcore_v7m.h.

#define port_suspend ( void )

Value:

{                                                    \
  __set_BASEPRI(CORTEX_BASEPRI_KERNEL);                                     \
  __enable_interrupt();                                                     \
}

Disables the interrupt sources below kernel-level priority.

Note:: Interrupt sources above kernel level remains enabled.; In this port it raises/lowers the base priority to kernel level.

Definition at line 438 of file IAR/ARMCMx/chcore_v7m.h.

#define port_enable ( void )

Value:

{                                                     \
  __set_BASEPRI(CORTEX_BASEPRI_DISABLED);                                   \
  __enable_interrupt();                                                     \
}

Enables all the interrupt sources.

Note:: In this port it lowers the base priority to user level.

Definition at line 451 of file IAR/ARMCMx/chcore_v7m.h.

#define port_wait_for_interrupt ( void ) asm ("wfi")

Enters an architecture-dependent IRQ-waiting mode.

The function is meant to return when an interrupt becomes pending. The simplest implementation is an empty function or macro but this would not take advantage of architecture-specific power saving modes.

Note:: Implemented as an inlined WFI instruction.

Definition at line 468 of file IAR/ARMCMx/chcore_v7m.h.

#define port_switch	(	ntp,
		otp
	)	_port_switch(ntp, otp)

Performs a context switch between two threads.

This is the most critical code in any port, this function is responsible for the context switch between 2 threads.

Note:: The implementation of this code affects directly the context switch performance so optimize here as much as you can.

Parameters:

[in]	ntp	the thread to be switched in
[in]	otp	the thread to be switched out

Definition at line 484 of file IAR/ARMCMx/chcore_v7m.h.

Typedef Documentation

typedef void* regarm_t

Generic ARM register.

Definition at line 229 of file IAR/ARMCMx/chcore_v7m.h.

typedef uint64_t stkalign_t

Stack and memory alignment enforcement.

Note:: In this architecture the stack alignment is enforced to 64 bits, 32 bits alignment is supported by hardware but deprecated by ARM, the implementation choice is to not offer the option.

Definition at line 237 of file IAR/ARMCMx/chcore_v7m.h.

Detailed Description

Data Structures

Functions

Defines

Typedefs

Function Documentation

Define Documentation

Typedef Documentation