3b6707f140
The mpu headers moved in order to support the Cortex-R mpu in later commits. Use the new locations. Signed-off-by: Bradley Bolen <bbolen@lexmark.com>
199 lines
6.3 KiB
C
199 lines
6.3 KiB
C
/*
|
|
* Copyright (c) 2013-2014 Wind River Systems, Inc.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @brief ARM AArch32 specific kernel interface header
|
|
*
|
|
* This header contains the ARM AArch32 specific kernel interface. It is
|
|
* included by the kernel interface architecture-abstraction header
|
|
* (include/arm/cpu.h)
|
|
*/
|
|
|
|
#ifndef ZEPHYR_INCLUDE_ARCH_ARM_AARCH32_ARCH_H_
|
|
#define ZEPHYR_INCLUDE_ARCH_ARM_AARCH32_ARCH_H_
|
|
|
|
/* Add include for DTS generated information */
|
|
#include <devicetree.h>
|
|
|
|
/* ARM GPRs are often designated by two different names */
|
|
#define sys_define_gpr_with_alias(name1, name2) union { uint32_t name1, name2; }
|
|
|
|
#include <arch/arm/aarch32/thread.h>
|
|
#include <arch/arm/aarch32/exc.h>
|
|
#include <arch/arm/aarch32/irq.h>
|
|
#include <arch/arm/aarch32/error.h>
|
|
#include <arch/arm/aarch32/misc.h>
|
|
#include <arch/common/addr_types.h>
|
|
#include <arch/common/ffs.h>
|
|
#include <arch/arm/aarch32/nmi.h>
|
|
#include <arch/arm/aarch32/asm_inline.h>
|
|
#include <arch/common/sys_bitops.h>
|
|
|
|
#ifdef CONFIG_CPU_CORTEX_M
|
|
#include <arch/arm/aarch32/cortex_m/cpu.h>
|
|
#include <arch/arm/aarch32/cortex_m/memory_map.h>
|
|
#include <arch/common/sys_io.h>
|
|
#elif defined(CONFIG_CPU_CORTEX_R)
|
|
#include <arch/arm/aarch32/cortex_a_r/cpu.h>
|
|
#include <arch/arm/aarch32/cortex_a_r/sys_io.h>
|
|
#include <arch/arm/aarch32/cortex_a_r/timer.h>
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Declare the ARCH_STACK_PTR_ALIGN
|
|
*
|
|
* Denotes the required alignment of the stack pointer on public API
|
|
* boundaries
|
|
*
|
|
*/
|
|
#ifdef CONFIG_STACK_ALIGN_DOUBLE_WORD
|
|
#define ARCH_STACK_PTR_ALIGN 8
|
|
#else
|
|
#define ARCH_STACK_PTR_ALIGN 4
|
|
#endif
|
|
|
|
/**
|
|
* @brief Declare the minimum alignment for a thread stack
|
|
*
|
|
* Denotes the minimum required alignment of a thread stack.
|
|
*
|
|
* Note:
|
|
* User thread stacks must respect the minimum MPU region
|
|
* alignment requirement.
|
|
*/
|
|
#if defined(CONFIG_USERSPACE)
|
|
#define Z_THREAD_MIN_STACK_ALIGN CONFIG_ARM_MPU_REGION_MIN_ALIGN_AND_SIZE
|
|
#else
|
|
#define Z_THREAD_MIN_STACK_ALIGN ARCH_STACK_PTR_ALIGN
|
|
#endif
|
|
|
|
/**
|
|
* @brief Declare a minimum MPU guard alignment and size
|
|
*
|
|
* This specifies the minimum MPU guard alignment/size for the MPU. This
|
|
* will be used to denote the guard section of the stack, if it exists.
|
|
*
|
|
* One key note is that this guard results in extra bytes being added to
|
|
* the stack. APIs which give the stack ptr and stack size will take this
|
|
* guard size into account.
|
|
*
|
|
* Stack is allocated, but initial stack pointer is at the end
|
|
* (highest address). Stack grows down to the actual allocation
|
|
* address (lowest address). Stack guard, if present, will comprise
|
|
* the lowest MPU_GUARD_ALIGN_AND_SIZE bytes of the stack.
|
|
*
|
|
* As the stack grows down, it will reach the end of the stack when it
|
|
* encounters either the stack guard region, or the stack allocation
|
|
* address.
|
|
*
|
|
* ----------------------- <---- Stack allocation address + stack size +
|
|
* | | MPU_GUARD_ALIGN_AND_SIZE
|
|
* | Some thread data | <---- Defined when thread is created
|
|
* | ... |
|
|
* |---------------------| <---- Actual initial stack ptr
|
|
* | Initial Stack Ptr | aligned to ARCH_STACK_PTR_ALIGN
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | ... |
|
|
* | Stack Ends |
|
|
* |---------------------- <---- Stack Buffer Ptr from API
|
|
* | MPU Guard, |
|
|
* | if present |
|
|
* ----------------------- <---- Stack Allocation address
|
|
*
|
|
*/
|
|
#if defined(CONFIG_MPU_STACK_GUARD)
|
|
#define MPU_GUARD_ALIGN_AND_SIZE CONFIG_ARM_MPU_REGION_MIN_ALIGN_AND_SIZE
|
|
#else
|
|
#define MPU_GUARD_ALIGN_AND_SIZE 0
|
|
#endif
|
|
|
|
/**
|
|
* @brief Declare the MPU guard alignment and size for a thread stack
|
|
* that is using the Floating Point services.
|
|
*
|
|
* For threads that are using the Floating Point services under Shared
|
|
* Registers (CONFIG_FPU_SHARING=y) mode, the exception stack frame may
|
|
* contain both the basic stack frame and the FP caller-saved context,
|
|
* upon exception entry. Therefore, a wide guard region is required to
|
|
* guarantee that stack-overflow detection will always be successful.
|
|
*/
|
|
#if defined(CONFIG_FPU) && defined(CONFIG_FPU_SHARING) \
|
|
&& defined(CONFIG_MPU_STACK_GUARD)
|
|
#define MPU_GUARD_ALIGN_AND_SIZE_FLOAT CONFIG_MPU_STACK_GUARD_MIN_SIZE_FLOAT
|
|
#else
|
|
#define MPU_GUARD_ALIGN_AND_SIZE_FLOAT 0
|
|
#endif
|
|
|
|
/**
|
|
* @brief Define alignment of an MPU guard
|
|
*
|
|
* Minimum alignment of the start address of an MPU guard, depending on
|
|
* whether the MPU architecture enforces a size (and power-of-two) alignment
|
|
* requirement.
|
|
*/
|
|
#if defined(CONFIG_MPU_REQUIRES_POWER_OF_TWO_ALIGNMENT)
|
|
#define Z_MPU_GUARD_ALIGN (MAX(MPU_GUARD_ALIGN_AND_SIZE, \
|
|
MPU_GUARD_ALIGN_AND_SIZE_FLOAT))
|
|
#else
|
|
#define Z_MPU_GUARD_ALIGN MPU_GUARD_ALIGN_AND_SIZE
|
|
#endif
|
|
|
|
#if defined(CONFIG_USERSPACE) && \
|
|
defined(CONFIG_MPU_REQUIRES_POWER_OF_TWO_ALIGNMENT)
|
|
/* This MPU requires regions to be sized to a power of two, and aligned to
|
|
* their own size. Since an MPU region must be able to cover the entire
|
|
* user-accessible stack buffer, we size/align to match. The privilege
|
|
* mode stack is generated elsewhere in memory.
|
|
*/
|
|
#define ARCH_THREAD_STACK_OBJ_ALIGN(size) Z_POW2_CEIL(size)
|
|
#define ARCH_THREAD_STACK_SIZE_ADJUST(size) Z_POW2_CEIL(size)
|
|
#else
|
|
#define ARCH_THREAD_STACK_OBJ_ALIGN(size) MAX(Z_THREAD_MIN_STACK_ALIGN, \
|
|
Z_MPU_GUARD_ALIGN)
|
|
#ifdef CONFIG_USERSPACE
|
|
#define ARCH_THREAD_STACK_SIZE_ADJUST(size) \
|
|
ROUND_UP(size, CONFIG_ARM_MPU_REGION_MIN_ALIGN_AND_SIZE)
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef CONFIG_MPU_STACK_GUARD
|
|
/* Kernel-only stacks need an MPU guard region programmed at the beginning of
|
|
* the stack object, so align the object appropriately.
|
|
*/
|
|
#define ARCH_KERNEL_STACK_RESERVED MPU_GUARD_ALIGN_AND_SIZE
|
|
#define ARCH_KERNEL_STACK_OBJ_ALIGN Z_MPU_GUARD_ALIGN
|
|
#endif
|
|
|
|
/* On arm, all MPU guards are carve-outs. */
|
|
#define ARCH_THREAD_STACK_RESERVED 0
|
|
|
|
/* Legacy case: retain containing extern "C" with C++ */
|
|
#ifdef CONFIG_ARM_MPU
|
|
#ifdef CONFIG_CPU_HAS_ARM_MPU
|
|
#include <arch/arm/aarch32/mpu/arm_mpu.h>
|
|
#endif /* CONFIG_CPU_HAS_ARM_MPU */
|
|
#ifdef CONFIG_CPU_HAS_NXP_MPU
|
|
#include <arch/arm/aarch32/mpu/nxp_mpu.h>
|
|
#endif /* CONFIG_CPU_HAS_NXP_MPU */
|
|
#endif /* CONFIG_ARM_MPU */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* ZEPHYR_INCLUDE_ARCH_ARM_AARCH32_ARCH_H_ */
|