/* * Copyright (c) 2015-2019 Cadence Design Systems, Inc. * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /* * Configuration-specific information for Xtensa build. This file must be * included in FreeRTOSConfig.h to properly set up the config-dependent * parameters correctly. * * NOTE: To enable thread-safe C library support, XT_USE_THREAD_SAFE_CLIB must * be defined to be > 0 somewhere above or on the command line. */ #ifndef XTENSA_CONFIG_H #define XTENSA_CONFIG_H #ifdef __cplusplus extern "C" { #endif #include #include #include /* required for XSHAL_CLIB */ #include "xtensa_context.h" /*----------------------------------------------------------------------------- * STACK REQUIREMENTS * * This section defines the minimum stack size, and the extra space required to * be allocated for saving coprocessor state and/or C library state information * (if thread safety is enabled for the C library). The sizes are in bytes. * * Stack sizes for individual tasks should be derived from these minima based on * the maximum call depth of the task and the maximum level of interrupt nesting. * A minimum stack size is defined by XT_STACK_MIN_SIZE. This minimum is based * on the requirement for a task that calls nothing else but can be interrupted. * This assumes that interrupt handlers do not call more than a few levels deep. * If this is not true, i.e. one or more interrupt handlers make deep calls then * the minimum must be increased. * * If the Xtensa processor configuration includes coprocessors, then space is * allocated to save the coprocessor state on the stack. * * If thread safety is enabled for the C runtime library, (XT_USE_THREAD_SAFE_CLIB * is defined) then space is allocated to save the C library context in the TCB. * * Allocating insufficient stack space is a common source of hard-to-find errors. * During development, it is best to enable the FreeRTOS stack checking features. * * Usage: * * XT_USE_THREAD_SAFE_CLIB -- Define this to a nonzero value to enable thread-safe * use of the C library. This will require extra stack * space to be allocated for tasks that use the C library * reentrant functions. See below for more information. * * NOTE: The Xtensa toolchain supports multiple C libraries and not all of them * support thread safety. Check your core configuration to see which C library * was chosen for your system. * * XT_STACK_MIN_SIZE -- The minimum stack size for any task. It is recommended * that you do not use a stack smaller than this for any * task. In case you want to use stacks smaller than this * size, you must verify that the smaller size(s) will work * under all operating conditions. * * XT_STACK_EXTRA -- The amount of extra stack space to allocate for a task * that does not make C library reentrant calls. Add this * to the amount of stack space required by the task itself. * * XT_STACK_EXTRA_CLIB -- The amount of space to allocate for C library state. * -----------------------------------------------------------------------------*/ /* Extra space required for interrupt/exception hooks. */ #ifdef XT_INTEXC_HOOKS #ifdef __XTENSA_CALL0_ABI__ #define STK_INTEXC_EXTRA 0x200 #else #define STK_INTEXC_EXTRA 0x180 #endif #else #define STK_INTEXC_EXTRA 0 #endif /* Check C library thread safety support and compute size of C library save area. For the supported libraries, we enable thread safety by default, and this can be overridden from the compiler/make command line. */ #if (XSHAL_CLIB == XTHAL_CLIB_NEWLIB) || (XSHAL_CLIB == XTHAL_CLIB_XCLIB) #ifndef XT_USE_THREAD_SAFE_CLIB #define XT_USE_THREAD_SAFE_CLIB 1 #endif #else #define XT_USE_THREAD_SAFE_CLIB 0 #endif #if XT_USE_THREAD_SAFE_CLIB > 0u #if XSHAL_CLIB == XTHAL_CLIB_XCLIB #define XT_HAVE_THREAD_SAFE_CLIB 1 #if !defined __ASSEMBLER__ #include #define XT_CLIB_CONTEXT_AREA_SIZE ((sizeof(struct _reent) + 15) + (-16)) #define XT_CLIB_GLOBAL_PTR _reent_ptr #define _REENT_INIT_PTR _init_reent #define _impure_ptr _reent_ptr void _reclaim_reent(void * ptr); #endif #elif XSHAL_CLIB == XTHAL_CLIB_NEWLIB #define XT_HAVE_THREAD_SAFE_CLIB 1 #if !defined __ASSEMBLER__ #include #define XT_CLIB_CONTEXT_AREA_SIZE ((sizeof(struct _reent) + 15) + (-16)) #define XT_CLIB_GLOBAL_PTR _impure_ptr #endif #else #define XT_HAVE_THREAD_SAFE_CLIB 0 #error The selected C runtime library is not thread safe. #endif #else #define XT_CLIB_CONTEXT_AREA_SIZE 0 #endif /*------------------------------------------------------------------------------ Extra size -- interrupt frame plus coprocessor save area plus hook space. NOTE: Make sure XT_INTEXC_HOOKS is undefined unless you really need the hooks. ------------------------------------------------------------------------------*/ #ifdef __XTENSA_CALL0_ABI__ #define XT_XTRA_SIZE (XT_STK_FRMSZ + STK_INTEXC_EXTRA + 0x10 + XT_CP_SIZE) #else #define XT_XTRA_SIZE (XT_STK_FRMSZ + STK_INTEXC_EXTRA + 0x20 + XT_CP_SIZE) #endif /*------------------------------------------------------------------------------ Space allocated for user code -- function calls and local variables. NOTE: This number can be adjusted to suit your needs. You must verify that the amount of space you reserve is adequate for the worst-case conditions in your application. NOTE: The windowed ABI requires more stack, since space has to be reserved for spilling register windows. ------------------------------------------------------------------------------*/ #ifdef __XTENSA_CALL0_ABI__ #define XT_USER_SIZE 0x200 #else #define XT_USER_SIZE 0x400 #endif /* Minimum recommended stack size. */ #define XT_STACK_MIN_SIZE ((XT_XTRA_SIZE + XT_USER_SIZE) / sizeof(unsigned char)) /* OS overhead with and without C library thread context. */ #define XT_STACK_EXTRA (XT_XTRA_SIZE) #define XT_STACK_EXTRA_CLIB (XT_XTRA_SIZE + XT_CLIB_CONTEXT_AREA_SIZE) #ifdef __cplusplus } #endif #endif /* XTENSA_CONFIG_H */