This is an automated email from the ASF dual-hosted git repository.
acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
The following commit(s) were added to refs/heads/master by this push:
new 9fe1ce133f2 Documentation: document lm75 temperature command.
9fe1ce133f2 is described below
commit 9fe1ce133f2e8f8f0050b011c6a58954f2cc12df
Author: hanzhijian <[email protected]>
AuthorDate: Wed May 27 19:44:39 2026 +0800
Documentation: document lm75 temperature command.
Fill the blank documentation page for the lm75 (LM75 Temperature)
system command. The command reads temperature data from an LM75
I2C sensor and supports sample count and unit configuration.
Refs #11081
Signed-off-by: hanzhijian <[email protected]>
---
Documentation/applications/system/lm75/index.rst | 73 ++++++++++++++++++++++++
1 file changed, 73 insertions(+)
diff --git a/Documentation/applications/system/lm75/index.rst
b/Documentation/applications/system/lm75/index.rst
index 62bae02818f..9a2ce8d1483 100644
--- a/Documentation/applications/system/lm75/index.rst
+++ b/Documentation/applications/system/lm75/index.rst
@@ -1,3 +1,76 @@
=========================
``lm75`` LM75 Temperature
=========================
+
+The ``lm75`` command reads temperature data from an LM75 (or compatible)
+I2C temperature sensor and prints the result to standard output. The
+sensor must be enabled via ``CONFIG_LM75_I2C``.
+
+Configuration
+=============
+
+Enable the command with ``CONFIG_SYSTEM_LM75``. This option depends on
+``CONFIG_LM75_I2C``.
+
+The following configuration options are available:
+
+``CONFIG_SYSTEM_LM75_DEVNAME``
+ Sensor device path. Default: ``/dev/temp``.
+
+``CONFIG_SYSTEM_LM75_FAHRENHEIT``
+ Display temperature in degrees Fahrenheit. This is the default.
+
+``CONFIG_SYSTEM_LM75_CELSIUS``
+ Display temperature in degrees Celsius.
+
+``CONFIG_SYSTEM_LM75_STACKSIZE``
+ Stack size in bytes. Default: 1024.
+
+``CONFIG_SYSTEM_LM75_PRIORITY``
+ Command task priority. Default: 100.
+
+Usage
+=====
+
+.. code-block:: text
+
+ temp [OPTIONS]
+
+Options
+=======
+
+``-n <count>``
+ Number of temperature samples to collect. Each sample is read with a
+ 500 ms interval. Default: 1.
+
+``-h``
+ Show help message and exit.
+
+Examples
+========
+
+Read a single temperature sample:
+
+.. code-block:: text
+
+ nsh> temp
+ 72.50 degrees Fahrenheit
+
+Read five consecutive samples:
+
+.. code-block:: text
+
+ nsh> temp -n 5
+ 72.50 degrees Fahrenheit
+ 72.54 degrees Fahrenheit
+ 72.60 degrees Fahrenheit
+ 72.58 degrees Fahrenheit
+ 72.52 degrees Fahrenheit
+
+If ``CONFIG_SYSTEM_LM75_CELSIUS`` is selected instead of Fahrenheit,
+the output displays degrees Celsius:
+
+.. code-block:: text
+
+ nsh> temp
+ 22.50 degrees Celsius
