michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: tracing: include API docs into documentation

Browse source 
Group tracing documentation in header file and include them into
documentation.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif 2019-09-15 23:05:11 -04:00
commit d53c87a3ca
2 changed files with 14 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

9
doc/guides/tracing/index.rst
View file

@ -10,9 +10,12 @@ The tracing feature provides hooks that permits you to collect data from
your application and allows enabled backends to visualize the inner-working of
the kernel and various subsystems.
Applications and supported tools can define empty macros declared in
:zephyr_file:`include/tracing.h` that are called across the kernel in key spots.
Applications and tracing tools can create a backend that redefines the
macros declared in :zephyr_file:`include/debug/tracing.h` that are called
across the kernel in key spots.
.. doxygengroup:: tracing_apis
:project: Zephyr
SEGGER SystemView Support
*************************
@ -23,7 +26,7 @@ any application for platforms that have the required hardware support.
To enable tracing support with `SEGGER SystemView`_ add the configuration option
:option:`CONFIG_SEGGER_SYSTEMVIEW` to your project configuration file and set
it to *y*. For example, this can be added to the
:ref:`synchronization_sample` to visualize fast switching between threads:
:ref:`synchronization_sample` to visualize fast switching between threads::
CONFIG_STDOUT_CONSOLE=y
# enable to use thread names

8
include/debug/tracing.h
View file

@ -38,6 +38,11 @@ void z_sys_trace_thread_switched_out(void);
#else
/**
* @brief Tracing APIs
* @defgroup tracing_apis Tracing APIs
* @{
*/
/**
* @brief Called before a thread has been selected to run
*/
@ -133,6 +138,9 @@ void z_sys_trace_thread_switched_out(void);
#define z_sys_trace_thread_switched_in()
#define z_sys_trace_thread_switched_out()
/**
* @}
*/
#endif
#endif