/* * Copyright (c) 2014 Wind River Systems, Inc. * * SPDX-License-Identifier: Apache-2.0 */ /** * @file * @brief ARC specific kernel interface header * * This header contains the ARC specific kernel interface. It is * included by the kernel interface architecture-abstraction header * include/arch/cpu.h) */ #ifndef ZEPHYR_INCLUDE_ARCH_ARC_ARCH_H_ #define ZEPHYR_INCLUDE_ARCH_ARC_ARCH_H_ #include #include #ifdef CONFIG_CPU_ARCV2 #include #include #include #include #include #include #include #include #include #endif #ifdef __cplusplus extern "C" { #endif #if defined(CONFIG_MPU_STACK_GUARD) || defined(CONFIG_USERSPACE) #if defined(CONFIG_ARC_CORE_MPU) #if CONFIG_ARC_MPU_VER == 2 /* * The minimum MPU region of MPU v2 is 2048 bytes. The * start address of MPU region should be aligned to the * region size */ /* The STACK_GUARD_SIZE is the size of stack guard region */ #define STACK_ALIGN 2048 #elif CONFIG_ARC_MPU_VER == 3 #define STACK_ALIGN 32 #else #error "Unsupported MPU version" #endif /* CONFIG_ARC_MPU_VER */ #else /* CONFIG_ARC_CORE_MPU */ #error "Requires to enable MPU" #endif #else /* CONFIG_MPU_STACK_GUARD || CONFIG_USERSPACE */ #define STACK_ALIGN 4 #endif #if defined(CONFIG_MPU_STACK_GUARD) #if CONFIG_ARC_MPU_VER == 2 #define STACK_GUARD_SIZE 2048 #elif CONFIG_ARC_MPU_VER == 3 #define STACK_GUARD_SIZE 32 #endif #else /* CONFIG_MPU_STACK_GUARD */ #define STACK_GUARD_SIZE 0 #endif /* CONFIG_MPU_STACK_GUARD */ #define STACK_SIZE_ALIGN(x) MAX(STACK_ALIGN, x) /** * @brief Calculate power of two ceiling for a buffer size input * */ #define POW2_CEIL(x) ((1 << (31 - __builtin_clz(x))) < x ? \ 1 << (31 - __builtin_clz(x) + 1) : \ 1 << (31 - __builtin_clz(x))) #if defined(CONFIG_USERSPACE) #define Z_ARCH_THREAD_STACK_RESERVED \ (STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE) #if CONFIG_ARC_MPU_VER == 2 #define Z_ARCH_THREAD_STACK_DEFINE(sym, size) \ struct _k_thread_stack_element __noinit \ __aligned(POW2_CEIL(STACK_SIZE_ALIGN(size))) \ sym[POW2_CEIL(STACK_SIZE_ALIGN(size)) + \ + STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE] #define Z_ARCH_THREAD_STACK_LEN(size) \ (POW2_CEIL(STACK_SIZE_ALIGN(size)) + \ MAX(POW2_CEIL(STACK_SIZE_ALIGN(size)), \ POW2_CEIL(STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE))) #define Z_ARCH_THREAD_STACK_ARRAY_DEFINE(sym, nmemb, size) \ struct _k_thread_stack_element __noinit \ __aligned(POW2_CEIL(STACK_SIZE_ALIGN(size))) \ sym[nmemb][Z_ARCH_THREAD_STACK_LEN(size)] #define Z_ARCH_THREAD_STACK_MEMBER(sym, size) \ struct _k_thread_stack_element \ __aligned(POW2_CEIL(STACK_SIZE_ALIGN(size))) \ sym[POW2_CEIL(STACK_SIZE_ALIGN(size)) + \ + STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE] #elif CONFIG_ARC_MPU_VER == 3 #define Z_ARCH_THREAD_STACK_DEFINE(sym, size) \ struct _k_thread_stack_element __noinit __aligned(STACK_ALIGN) \ sym[size + \ + STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE] #define Z_ARCH_THREAD_STACK_LEN(size) \ ((size) + STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE) #define Z_ARCH_THREAD_STACK_ARRAY_DEFINE(sym, nmemb, size) \ struct _k_thread_stack_element __noinit __aligned(STACK_ALIGN) \ sym[nmemb][Z_ARCH_THREAD_STACK_LEN(size)] #define Z_ARCH_THREAD_STACK_MEMBER(sym, size) \ struct _k_thread_stack_element __aligned(STACK_ALIGN) \ sym[size + \ + STACK_GUARD_SIZE + CONFIG_PRIVILEGED_STACK_SIZE] #endif /* CONFIG_ARC_MPU_VER */ #define Z_ARCH_THREAD_STACK_SIZEOF(sym) \ (sizeof(sym) - CONFIG_PRIVILEGED_STACK_SIZE - STACK_GUARD_SIZE) #define Z_ARCH_THREAD_STACK_BUFFER(sym) \ ((char *)(sym)) #else /* CONFIG_USERSPACE */ #define Z_ARCH_THREAD_STACK_RESERVED STACK_GUARD_SIZE #define Z_ARCH_THREAD_STACK_DEFINE(sym, size) \ struct _k_thread_stack_element __noinit __aligned(STACK_ALIGN) \ sym[size + STACK_GUARD_SIZE] #define Z_ARCH_THREAD_STACK_LEN(size) ((size) + STACK_GUARD_SIZE) #define Z_ARCH_THREAD_STACK_ARRAY_DEFINE(sym, nmemb, size) \ struct _k_thread_stack_element __noinit __aligned(STACK_ALIGN) \ sym[nmemb][Z_ARCH_THREAD_STACK_LEN(size)] #define Z_ARCH_THREAD_STACK_MEMBER(sym, size) \ struct _k_thread_stack_element __aligned(STACK_ALIGN) \ sym[size + STACK_GUARD_SIZE] #define Z_ARCH_THREAD_STACK_SIZEOF(sym) (sizeof(sym) - STACK_GUARD_SIZE) #define Z_ARCH_THREAD_STACK_BUFFER(sym) ((char *)(sym + STACK_GUARD_SIZE)) #endif /* CONFIG_USERSPACE */ #ifdef CONFIG_ARC_MPU #ifndef _ASMLANGUAGE #include #define K_MEM_PARTITION_P_NA_U_NA AUX_MPU_ATTR_N #define K_MEM_PARTITION_P_RW_U_RW (AUX_MPU_ATTR_UW | AUX_MPU_ATTR_UR | \ AUX_MPU_ATTR_KW | AUX_MPU_ATTR_KR) #define K_MEM_PARTITION_P_RW_U_RO (AUX_MPU_ATTR_UR | \ AUX_MPU_ATTR_KW | AUX_MPU_ATTR_KR) #define K_MEM_PARTITION_P_RW_U_NA (AUX_MPU_ATTR_KW | AUX_MPU_ATTR_KR) #define K_MEM_PARTITION_P_RO_U_RO (AUX_MPU_ATTR_UR | AUX_MPU_ATTR_KR) #define K_MEM_PARTITION_P_RO_U_NA (AUX_MPU_ATTR_KR) /* Execution-allowed attributes */ #define K_MEM_PARTITION_P_RWX_U_RWX (AUX_MPU_ATTR_UW | AUX_MPU_ATTR_UR | \ AUX_MPU_ATTR_KW | AUX_MPU_ATTR_KR | \ AUX_MPU_ATTR_KE | AUX_MPU_ATTR_UE) #define K_MEM_PARTITION_P_RWX_U_RX (AUX_MPU_ATTR_UR | \ AUX_MPU_ATTR_KW | AUX_MPU_ATTR_KR | \ AUX_MPU_ATTR_KE | AUX_MPU_ATTR_UE) #define K_MEM_PARTITION_P_RX_U_RX (AUX_MPU_ATTR_UR | \ AUX_MPU_ATTR_KR | \ AUX_MPU_ATTR_KE | AUX_MPU_ATTR_UE) #define K_MEM_PARTITION_IS_WRITABLE(attr) \ ({ \ int __is_writable__; \ attr &= (AUX_MPU_ATTR_UW | AUX_MPU_ATTR_KW); \ switch (attr) { \ case (AUX_MPU_ATTR_UW | AUX_MPU_ATTR_KW): \ case AUX_MPU_ATTR_UW: \ case AUX_MPU_ATTR_KW: \ __is_writable__ = 1; \ break; \ default: \ __is_writable__ = 0; \ break; \ } \ __is_writable__; \ }) #define K_MEM_PARTITION_IS_EXECUTABLE(attr) \ ((attr) & (AUX_MPU_ATTR_KE | AUX_MPU_ATTR_UE)) #endif /* _ASMLANGUAGE */ #if CONFIG_ARC_MPU_VER == 2 #define _ARCH_MEM_PARTITION_ALIGN_CHECK(start, size) \ BUILD_ASSERT_MSG(!(((size) & ((size) - 1))) && (size) >= STACK_ALIGN \ && !((u32_t)(start) & ((size) - 1)), \ "the size of the partition must be power of 2" \ " and greater than or equal to the mpu adddress alignment." \ "start address of the partition must align with size.") #elif CONFIG_ARC_MPU_VER == 3 #define _ARCH_MEM_PARTITION_ALIGN_CHECK(start, size) \ BUILD_ASSERT_MSG((size) % STACK_ALIGN == 0 && (size) >= STACK_ALIGN \ && (u32_t)(start) % STACK_ALIGN == 0, \ "the size of the partition must align with 32" \ " and greater than or equal to 32." \ "start address of the partition must align with 32.") #endif #endif /* CONFIG_ARC_MPU*/ #ifndef _ASMLANGUAGE /* Typedef for the k_mem_partition attribute*/ typedef u32_t k_mem_partition_attr_t; /** * @brief Explicitly nop operation. */ static ALWAYS_INLINE void arch_nop(void) { __asm__ volatile("nop"); } #endif /* _ASMLANGUAGE */ #ifdef __cplusplus } #endif #endif /* ZEPHYR_INCLUDE_ARCH_ARC_ARCH_H_ */