doc: services: pm: document the "device list" command

Document the "device list" command in the context of device power
management.

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
This commit is contained in:
Fabio Baltieri 2024-04-26 00:03:18 +01:00 committed by Alberto Escolar
parent 4257fb6a3d
commit 4d51bea084

View file

@ -249,6 +249,22 @@ option and issue a ``pm`` command on a device from the shell, for example:
devices: devices:
- buttons (suspended) - buttons (suspended)
To print the power management state of a device, enable
:kconfig:option:`CONFIG_DEVICE_SHELL` and use the ``device list`` command, for
example:
.. code-block:: console
uart:~$ device list
devices:
- i2c@40003000 (active)
- buttons (active, usage=1)
- leds (READY)
In this case, ``leds`` does not support PM, ``i2c`` supports PM with manual
suspend and resume actions and it's currently active, ``buttons`` supports
runtime PM and it's currently active with one user.
.. _pm-device-busy: .. _pm-device-busy:
Busy Status Indication Busy Status Indication