diff --git a/README.rst b/README.rst index f81d6e2e7..05ebcec4c 100644 --- a/README.rst +++ b/README.rst @@ -101,6 +101,21 @@ for android: [optional] for lc-compliance: [optional] libevent-dev +Basic testing with cam utility +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The ``cam`` utility can be used for basic testing. You can list the cameras +detected on the system with ``cam -l``, and capture ten frames from the first +camera and save them to disk with ``cam -c 1 --capture=10 --file``. See +``cam -h`` for more information about the ``cam`` tool. + +In case of problems, a detailed debug log can be obtained from libcamera by +setting the ``LIBCAMERA_LOG_LEVELS`` environment variable: + +.. code:: + + :~$ LIBCAMERA_LOG_LEVELS=*:DEBUG cam -l + Using GStreamer plugin ~~~~~~~~~~~~~~~~~~~~~~