summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDetlev Zundel <dzu@member.fsf.org>2025-02-06 16:45:25 +0100
committerDamien George <damien@micropython.org>2025-04-29 23:00:37 +1000
commitcd3eaad05cf94cd86e9762c854c68a4d4b5c2fab (patch)
tree27d8222d19a1c732c1d19d5f7fe50f47db822243 /docs
parentcd71db0172c9f0905fd3d3438b1f2cf70da11dfa (diff)
zephyr: Fix call to thread_analyzer_print for v4.0.
Commit 1b6e0f64796dfd6f86a8679ea6d24e1fca1e63a8 for Zephyr v4.0.0 changed the function "thread_analyzer_print" to require a cpu argument and allow thread analysis on each cpu separately. The argument is ignored when THREAD_ANALYZER_AUTO_SEPARATE_CORES=n which is the default on single core machines. Promote this change to the MicroPython zephyr module. Signed-off-by: Detlev Zundel <dzu@member.fsf.org> Signed-off-by: Maureen Helm <maureen.helm@analog.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/library/zephyr.rst8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/library/zephyr.rst b/docs/library/zephyr.rst
index 10676d908..1a106d50e 100644
--- a/docs/library/zephyr.rst
+++ b/docs/library/zephyr.rst
@@ -22,9 +22,10 @@ Functions
Returns the thread id of the current thread, which is used to reference the thread.
-.. function:: thread_analyze()
+.. function:: thread_analyze(cpu)
- Runs the Zephyr debug thread analyzer on the current thread and prints stack size statistics in the format:
+ Runs the Zephyr debug thread analyzer on the current thread on the given cpu
+ and prints stack size statistics in the format:
"``thread_name``-20s: STACK: unused ``available_stack_space`` usage ``stack_space_used``
/ ``stack_size`` (``percent_stack_space_used`` %); CPU: ``cpu_utilization`` %"
@@ -35,6 +36,9 @@ Functions
For more information, see documentation for Zephyr `thread analyzer
<https://docs.zephyrproject.org/latest/guides/debug_tools/thread-analyzer.html#thread-analyzer>`_.
+ Note that the ``cpu`` argument is only used in Zephyr v4.0.0 and
+ newer and ignored otherwise.
+
.. function:: shell_exec(cmd_in)
Executes the given command on an UART backend. This function can only be accessed if ``CONFIG_SHELL_BACKEND_SERIAL``