michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: update for new stack macros

Browse source 
__stack is now deprecated.

Signed-off-by: Andrew Boie <andrew.p.boie@intel.com>
This commit is contained in:
Andrew Boie 2017-06-13 08:51:46 -07:00 • committed by Anas Nashif
commit ea310faa3a
2 changed files with 17 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/kernel/threads/lifecycle.rst
View file

@ -20,7 +20,8 @@ A thread has the following key properties:
* A **stack area**, which is a region of memory used for the thread's stack. * A **stack area**, which is a region of memory used for the thread's stack.
The **size** of the stack area can be tailored to conform to the actual needs The **size** of the stack area can be tailored to conform to the actual needs
of the thread's processing. of the thread's processing. Special macros exist to create and work with
stack memory regions.
* A **thread control block** for private kernel bookkeeping of the thread's * A **thread control block** for private kernel bookkeeping of the thread's
metadata. This is an instance of type :c:type:`struct k_thread`. metadata. This is an instance of type :c:type:`struct k_thread`.
@ -149,7 +150,8 @@ Spawning a Thread
A thread is spawned by defining its stack area and its thread control block, A thread is spawned by defining its stack area and its thread control block,
and then calling :cpp:func:`k_thread_create()`. The stack area must be defined and then calling :cpp:func:`k_thread_create()`. The stack area must be defined
using the :c:macro:`__stack` attribute to ensure it is properly aligned. using :c:macro:`K_THREAD_STACK_DEFINE` to ensure it is properly set up in
memory.
The thread spawning function returns its thread id, which can be used The thread spawning function returns its thread id, which can be used
to reference the thread. to reference the thread.
@ -163,11 +165,12 @@ The following code spawns a thread that starts immediately.
extern void my_entry_point(void *, void *, void *); extern void my_entry_point(void *, void *, void *);
char __noinit __stack my_stack_area[MY_STACK_SIZE]; K_THREAD_STACK_DEFINE(my_stack_area, MY_STACK_SIZE);
struct k_thread my_thread_data; struct k_thread my_thread_data;
k_tid_t my_tid = k_thread_create(&my_thread_data, my_stack_area, k_tid_t my_tid = k_thread_create(&my_thread_data, my_stack_area,
MY_STACK_SIZE, my_entry_point, K_THREAD_STACK_SIZEOF(my_stack_area),
my_entry_point,
NULL, NULL, NULL, NULL, NULL, NULL,
MY_PRIORITY, 0, K_NO_WAIT); MY_PRIORITY, 0, K_NO_WAIT);
@ -237,3 +240,8 @@ The following thread APIs are provided by :file:`kernel.h`:
* :cpp:func:`k_thread_abort()` * :cpp:func:`k_thread_abort()`
* :cpp:func:`k_thread_suspend()` * :cpp:func:`k_thread_suspend()`
* :cpp:func:`k_thread_resume()` * :cpp:func:`k_thread_resume()`
* :c:macro:`K_THREAD_STACK_DEFINE`
* :c:macro:`K_THREAD_STACK_ARRAY_DEFINE`
* :c:macro:`K_THREAD_STACK_MEMBER`
* :c:macro:`K_THREAD_STACK_SIZEOF`
* :c:macro:`K_THREAD_STACK_BUFFER`

8
doc/kernel/threads/workqueues.rst
View file

@ -150,7 +150,8 @@ Defining a Workqueue
A workqueue is defined using a variable of type :c:type:`struct k_work_q`. A workqueue is defined using a variable of type :c:type:`struct k_work_q`.
The workqueue is initialized by defining the stack area used by its thread The workqueue is initialized by defining the stack area used by its thread
and then calling :cpp:func:`k_work_q_start()`. The stack area must be defined and then calling :cpp:func:`k_work_q_start()`. The stack area must be defined
using the :c:macro:`__stack` attribute to ensure it is properly aligned. using :c:macro:`K_THREAD_STACK_DEFINE` to ensure it is properly set up in
memory.
The following code defines and initializes a workqueue. The following code defines and initializes a workqueue.
@ -159,11 +160,12 @@ The following code defines and initializes a workqueue.
#define MY_STACK_SIZE 512 #define MY_STACK_SIZE 512
#define MY_PRIORITY 5 #define MY_PRIORITY 5
char __noinit __stack my_stack_area[MY_STACK_SIZE]; K_THREAD_STACK_DEFINE(my_stack_area, MY_STACK_SIZE);
struct k_work_q my_work_q; struct k_work_q my_work_q;
k_work_q_start(&my_work_q, my_stack_area, MY_STACK_SIZE, MY_PRIORITY); k_work_q_start(&my_work_q, my_stack_area,
K_THREAD_STACK_SIZEOF(my_stack_area), MY_PRIORITY);
Submitting a Work Item Submitting a Work Item
====================== ======================