kernel: add macros to allow declaring extern stack arrays (25fd1760) · Commits · Wenxi XU / zephyr

include/kernel/thread_stack.h

+45 −0

Original line number	Diff line number	Diff line
		@@ -122,6 +122,36 @@ static inline char z_stack_ptr_align(char ptr)
		* @{
		*/

		/**
		* @def K_KERNEL_STACK_ARRAY_EXTERN
		* @brief Obtain an extern reference to a stack array
		*
		* This macro properly brings the symbol of a stack array declared
		* elsewhere into scope.
		*
		* @param sym Thread stack symbol name
		* @param nmemb Number of stacks to declare
		* @param size Size of the stack memory region
		*/
		#define K_KERNEL_STACK_ARRAY_EXTERN(sym, nmemb, size) \
		extern struct z_thread_stack_element \
		sym[nmemb][Z_KERNEL_STACK_LEN(size)]

		/**
		* @def K_KERNEL_PINNED_STACK_ARRAY_EXTERN
		* @brief Obtain an extern reference to a pinned stack array
		*
		* This macro properly brings the symbol of a pinned stack array
		* declared elsewhere into scope.
		*
		* @param sym Thread stack symbol name
		* @param nmemb Number of stacks to declare
		* @param size Size of the stack memory region
		*/
		#define K_KERNEL_PINNED_STACK_ARRAY_EXTERN(sym, nmemb, size) \
		extern struct z_thread_stack_element \
		sym[nmemb][Z_KERNEL_STACK_LEN(size)]

		/**
		* @def Z_KERNEL_STACK_DEFINE_IN
		* @brief Define a toplevel kernel stack memory region in specified section
		@@ -272,6 +302,7 @@ static inline char Z_KERNEL_STACK_BUFFER(k_thread_stack_t sym)
		#define K_THREAD_STACK_MEMBER K_KERNEL_STACK_MEMBER
		#define Z_THREAD_STACK_BUFFER Z_KERNEL_STACK_BUFFER
		#define K_THREAD_STACK_EXTERN K_KERNEL_STACK_EXTERN
		#define K_THREAD_STACK_ARRAY_EXTERN K_KERNEL_STACK_ARRAY_EXTERN
		#else
		/**
		* @def K_THREAD_STACK_RESERVED
		@@ -371,6 +402,20 @@ static inline char Z_KERNEL_STACK_BUFFER(k_thread_stack_t sym)
		*/
		#define K_THREAD_STACK_EXTERN(sym) extern k_thread_stack_t sym[]

		/**
		* @brief Obtain an extern reference to a thread stack array
		*
		* This macro properly brings the symbol of a stack array declared
		* elsewhere into scope.
		*
		* @param sym Thread stack symbol name
		* @param nmemb Number of stacks to declare
		* @param size Size of the stack memory region
		*/
		#define K_THREAD_STACK_ARRAY_EXTERN(sym, nmemb, size) \
		extern struct z_thread_stack_element \
		sym[nmemb][K_THREAD_STACK_LEN(size)]

		/**
		* @addtogroup thread_stack_api
		* @{

Admin message