cyclic: Add documentation

Add documentation for the cyclic function infrastructure, including the
cyclic command.

Signed-off-by: Stefan Roese <sr@denx.de>
Reviewed-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Stefan Roese
2022-09-02 13:57:53 +02:00
committed by Tom Rini
parent 5ee0fa722c
commit 00275f5ead
4 changed files with 97 additions and 0 deletions

45
doc/usage/cmd/cyclic.rst Normal file
View File

@@ -0,0 +1,45 @@
.. SPDX-License-Identifier: GPL-2.0+
cyclic command
==============
Synopsis
--------
::
cyclic list
Description
-----------
The cyclic list command provides a list of the currently registered
cyclic functions.
This shows the following information:
Function
Function name
cpu-time
Total time spent in this cyclic function.
Frequency
Frequency of execution of this function, e.g. 100 times/s for a
pediod of 10ms.
See :doc:`../../develop/cyclic` for more information on cyclic functions.
Example
-------
::
=> cyclic list
function: cyclic_demo, cpu-time: 52906 us, frequency: 99.20 times/s
Configuration
-------------
The cyclic command is only available if CONFIG_CMD_CYCLIC=y.