[PATCH v3 2/4] doc: cmd: temperature: add documentation
Robert Marko
robimarko at gmail.com
Tue Sep 6 13:30:34 CEST 2022
Add documentation for the temperature command.
Signed-off-by: Robert Marko <robert.marko at sartura.hr>
Reviewed-by: Simon Glass <sjg at chromium.org>
---
doc/usage/cmd/temperature.rst | 50 +++++++++++++++++++++++++++++++++++
doc/usage/index.rst | 1 +
2 files changed, 51 insertions(+)
create mode 100644 doc/usage/cmd/temperature.rst
diff --git a/doc/usage/cmd/temperature.rst b/doc/usage/cmd/temperature.rst
new file mode 100644
index 0000000000..a5144ec50f
--- /dev/null
+++ b/doc/usage/cmd/temperature.rst
@@ -0,0 +1,50 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+
+temperature command
+===================
+
+Synopsis
+--------
+
+::
+
+ temperature list
+ temperature get [thermal device name]
+
+Description
+-----------
+
+The *temperature* command is used to list thermal sensors and get their
+readings.
+
+The 'temperature list' command diplays the available thermal devices.
+
+The 'temperature get' command is used to get the reading in degrees C from
+the desired device which is selected by passing its device name.
+
+ thermal device name
+ device name of thermal sensor to select
+
+Example
+-------
+
+::
+
+
+ => temperature list
+ | Device | Driver | Parent
+ | tmon at 610508110 | sparx5-temp | axi at 600000000
+ =>
+ => temperature get tmon at 610508110
+ tmon at 610508110: 42 C
+
+Configuration
+-------------
+
+The *temperature* command is only available if CONFIG_CMD_TEMPERATURE=y.
+
+Return value
+------------
+
+The return value $? is set to 0 (true) if the command succeeded and to 1 (false)
+otherwise.
diff --git a/doc/usage/index.rst b/doc/usage/index.rst
index 28f9683a3e..92967efdd2 100644
--- a/doc/usage/index.rst
+++ b/doc/usage/index.rst
@@ -63,6 +63,7 @@ Shell commands
cmd/scp03
cmd/setexpr
cmd/size
+ cmd/temperature
cmd/true
cmd/ums
cmd/wdt
--
2.37.3
More information about the U-Boot
mailing list