unified: Rework K_THREAD_DEFINE()
K_THREAD_DEFINE() can no longer specify a thread group. However, it now accepts a 'delay' parameter just as k_thread_spawn() does. To create a statically defined thread that may belong to one or more thread groups the new internal _MDEF_THREAD_DEFINE() macro is used. It is only used for legacy purposes. Threads can not both have a delayed start AND belong to a thread group. Jira: ZEP-916 Change-Id: Ia6e59ddcb4fc68f1f60f9c6b0f4f227f161ad1bb Signed-off-by: Peter Mitsis <peter.mitsis@windriver.com>
This commit is contained in:
parent
41a4caadfc
commit
b2fd5be4dc
4 changed files with 104 additions and 29 deletions
105
include/kernel.h
105
include/kernel.h
|
@ -166,38 +166,89 @@ struct _static_thread_data {
|
|||
struct k_thread *thread;
|
||||
};
|
||||
unsigned int init_stack_size;
|
||||
int32_t init_delay;
|
||||
};
|
||||
|
||||
#define K_THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, groups) \
|
||||
{ \
|
||||
.init_groups = (groups), \
|
||||
.init_prio = (prio), \
|
||||
.init_entry = (void (*)(void *, void *, void *))entry, \
|
||||
.init_p1 = (void *)p1, \
|
||||
.init_p2 = (void *)p2, \
|
||||
.init_p3 = (void *)p3, \
|
||||
.init_abort = abort, \
|
||||
.init_stack = (stack), \
|
||||
.init_stack_size = (stack_size), \
|
||||
/*
|
||||
* Common macro used by both K_THREAD_INITIALIZER()
|
||||
* and _MDEF_THREAD_INITIALIZER().
|
||||
*/
|
||||
#define _THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio) \
|
||||
.init_prio = (prio), \
|
||||
.init_entry = (void (*)(void *, void *, void *))entry, \
|
||||
.init_p1 = (void *)p1, \
|
||||
.init_p2 = (void *)p2, \
|
||||
.init_p3 = (void *)p3, \
|
||||
.init_abort = abort, \
|
||||
.init_stack = (stack), \
|
||||
.init_stack_size = (stack_size),
|
||||
|
||||
/**
|
||||
* @brief Thread initializer macro
|
||||
*
|
||||
* This macro is to only be used with statically defined threads that were not
|
||||
* defined in the MDEF file. As such the associated threads can not belong to
|
||||
* any thread group.
|
||||
*/
|
||||
#define K_THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, delay) \
|
||||
{ \
|
||||
_THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio) \
|
||||
.init_groups = 0, \
|
||||
.init_delay = (delay), \
|
||||
}
|
||||
|
||||
/*
|
||||
* Define thread initializer object and initialize it
|
||||
* NOTE: For thread group functions thread initializers must be organized
|
||||
* in array and thus should not have gaps between them.
|
||||
* On x86 by default compiler aligns them by 32 byte boundary. To prevent
|
||||
* this 32-bit alignment in specified here.
|
||||
* _static_thread_data structure sise needs to be kept 32-bit aligned as well
|
||||
/**
|
||||
* @brief Thread initializer macro
|
||||
*
|
||||
* This macro is to only be used with statically defined threads that were
|
||||
* defined with legacy APIs (including the MDEF file). As such the associated
|
||||
* threads may belong to one or more thread groups.
|
||||
*/
|
||||
#define K_THREAD_DEFINE(name, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, groups) \
|
||||
char __noinit __stack _k_thread_obj_##name[stack_size]; \
|
||||
struct _static_thread_data _k_thread_data_##name __aligned(4) \
|
||||
__in_section(_k_task_list, private, task) = \
|
||||
K_THREAD_INITIALIZER(_k_thread_obj_##name, stack_size, \
|
||||
#define _MDEF_THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, groups) \
|
||||
{ \
|
||||
_THREAD_INITIALIZER(stack, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio) \
|
||||
.init_groups = (groups), \
|
||||
.init_delay = K_FOREVER, \
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Define thread initializer and initialize it.
|
||||
*
|
||||
* @internal It has been observed that the x86 compiler by default aligns
|
||||
* these _static_thread_data structures to 32-byte boundaries, thereby
|
||||
* wasting space. To work around this, force a 4-byte alignment.
|
||||
*/
|
||||
#define K_THREAD_DEFINE(name, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, delay) \
|
||||
char __noinit __stack _k_thread_obj_##name[stack_size]; \
|
||||
struct _static_thread_data _k_thread_data_##name __aligned(4) \
|
||||
__in_section(_k_task_list, private, task) = \
|
||||
K_THREAD_INITIALIZER(_k_thread_obj_##name, stack_size, \
|
||||
entry, p1, p2, p3, abort, prio, delay)
|
||||
|
||||
/**
|
||||
* @brief Define thread initializer for MDEF defined thread and initialize it.
|
||||
*
|
||||
* @ref K_THREAD_DEFINE
|
||||
*/
|
||||
#define _MDEF_THREAD_DEFINE(name, stack_size, \
|
||||
entry, p1, p2, p3, \
|
||||
abort, prio, groups) \
|
||||
char __noinit __stack _k_thread_obj_##name[stack_size]; \
|
||||
struct _static_thread_data _k_thread_data_##name __aligned(4) \
|
||||
__in_section(_k_task_list, private, task) = \
|
||||
_MDEF_THREAD_INITIALIZER(_k_thread_obj_##name, stack_size, \
|
||||
entry, p1, p2, p3, abort, prio, groups)
|
||||
|
||||
extern int k_thread_priority_get(k_tid_t thread);
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue