[{"id":23516,"web_url":"https://patchwork.libcamera.org/comment/23516/","msgid":"<165585378235.1149771.12791572368194597911@Monstersaurus>","date":"2022-06-21T23:23:02","subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"content":"Quoting Laurent Pinchart via libcamera-devel (2022-06-22 00:08:26)\n> The README.rst file contains the getting started instructions, but lacks\n> a simple way to test libcamera. Add a short section about basic cam\n> usage.\n> \n> Suggested-by: Pavel Machek \n> Signed-off-by: Laurent Pinchart \n> ---\n> Documentation/environment_variables.rst | 2 ++\n> README.rst | 15 +++++++++++++++\n> 2 files changed, 17 insertions(+)\n> \n> diff --git a/Documentation/environment_variables.rst b/Documentation/environment_variables.rst\n> index f092cbbd29c5..dcfdb1a33a32 100644\n> --- a/Documentation/environment_variables.rst\n> +++ b/Documentation/environment_variables.rst\n> @@ -86,6 +86,8 @@ global environment:\n> :~$ export LIBCAMERA_LOG_LEVELS='Camera:DEBUG,V4L2:DEBUG'\n> :~$ cam --list\n> \n> +.. _log levels:\n> +\n> Log levels\n> ~~~~~~~~~~\n> \n> diff --git a/README.rst b/README.rst\n> index f81d6e2e7867..578aa19f0f54 100644\n> --- a/README.rst\n> +++ b/README.rst\n> @@ -101,6 +101,21 @@ for android: [optional]\n> for lc-compliance: [optional]\n> libevent-dev\n> \n> +Basic testing with cam utility\n> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n> +\n> +The ``cam`` utility can be used for basic testing. You can list the cameras\n> +detected on the system with ``cam -l``, and capture ten frames from the first\n> +camera and save them to disk with ``cam -c 1 --capture=10 --file``. See\n> +``cam -h`` for more information about the ``cam`` tool.\n> +\n> +In case of problems, a detailed debug log can be obtained from libcamera by\n> +setting the :ref:`LIBCAMERA_LOG_LEVELS ` environment variable:\n\nWill this try to hyperlink to a document that isn't currently available\non https://libcamera.org/getting-started.html ?\n\nOther than that\n\n\nReviewed-by: Kieran Bingham \n\n> +\n> +.. code::\n> +\n> + :~$ LIBCAMERA_LOG_LEVELS=*:DEBUG cam -l\n> +\n> Using GStreamer plugin\n> ~~~~~~~~~~~~~~~~~~~~~~\n> \n> -- \n> Regards,\n> \n> Laurent Pinchart\n>","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 8548BBD808\n\tfor ;\n\tTue, 21 Jun 2022 23:23:07 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id D15A665634;\n\tWed, 22 Jun 2022 01:23:06 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 6922260498\n\tfor ;\n\tWed, 22 Jun 2022 01:23:05 +0200 (CEST)","from pendragon.ideasonboard.com\n\t(cpc89244-aztw30-2-0-cust3082.18-1.cable.virginm.net [86.31.172.11])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id DF92631A;\n\tWed, 22 Jun 2022 01:23:04 +0200 (CEST)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1655853786;\n\tbh=sPaWMDlPLEs8LeOu6tqRlQqYWJmh0XNx9GbBkM+lXqA=;\n\th=In-Reply-To:References:To:Date:Subject:List-Id:List-Unsubscribe:\n\tList-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc:\n\tFrom;\n\tb=u39FFjhJGpKM7is3cTDNoOBMaV0rOQRqK0H09Un00Pt9gMUdeo3KbfJikhTTrZWXB\n\tzGa16/1+8ZHTN7DYAIcDHkA9vFY/r4gOmtsAeoDlwSNS+Lf7/VzgGzmZf83PsUol2z\n\tERz9jg7zdwSV6LB5eqmglojXtF9CM3DTGjfJZJR4c4IRGFHv+oU8dVipquI8mInYEW\n\tkgAcF48w8XCrbvp0m23lFNb3eSgyJ9ndD0ZdlHvkhpvthVSJ53RkxhmMz0wDNea/ER\n\t4OVHe57duXcPXNij8b/b773xss7tcThhcwCY/VY3QqzaYV61+LWS5ZMnCZvrLC/e8z\n\ts0BCU5yX6rB0A==","v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1655853785;\n\tbh=sPaWMDlPLEs8LeOu6tqRlQqYWJmh0XNx9GbBkM+lXqA=;\n\th=In-Reply-To:References:Subject:From:Cc:To:Date:From;\n\tb=jDXYgEgpnCoPbkvZyHdfH2rMh/X/xFwHncONau+7SmLIHXcxk/oewwRBMQIkPXAFh\n\togNz159vTGlUz+sn9Fs976aKFd5bLpWc0FC6X5k1F9DZXpJ6hQWaeLvU/q0xIOAhfY\n\tq96W03kPTmp39phZGblgPbQQz8fQxLkk6PqrWGLk="],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"jDXYgEgp\"; dkim-atps=neutral","Content-Type":"text/plain; charset=\"utf-8\"","MIME-Version":"1.0","Content-Transfer-Encoding":"quoted-printable","In-Reply-To":"<20220621230826.23906-2-laurent.pinchart@ideasonboard.com>","References":"<20220621230826.23906-1-laurent.pinchart@ideasonboard.com>\n\t<20220621230826.23906-2-laurent.pinchart@ideasonboard.com>","To":"Laurent Pinchart ,\n\tlibcamera-devel@lists.libcamera.org","Date":"Wed, 22 Jun 2022 00:23:02 +0100","Message-ID":"<165585378235.1149771.12791572368194597911@Monstersaurus>","User-Agent":"alot/0.10","Subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","From":"Kieran Bingham via libcamera-devel\n\t","Reply-To":"Kieran Bingham ","Cc":"Pavel Machek ","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}},{"id":23518,"web_url":"https://patchwork.libcamera.org/comment/23518/","msgid":"<20220622072016.wug5kqdhdj2jzqea@uno.localdomain>","date":"2022-06-22T07:20:16","subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","submitter":{"id":3,"url":"https://patchwork.libcamera.org/api/people/3/","name":"Jacopo Mondi","email":"jacopo@jmondi.org"},"content":"Hi Kieran,\n\nOn Wed, Jun 22, 2022 at 12:23:02AM +0100, Kieran Bingham via libcamera-devel wrote:\n> Quoting Laurent Pinchart via libcamera-devel (2022-06-22 00:08:26)\n> > The README.rst file contains the getting started instructions, but lacks\n> > a simple way to test libcamera. Add a short section about basic cam\n> > usage.\n> >\n> > Suggested-by: Pavel Machek \n> > Signed-off-by: Laurent Pinchart \n> > ---\n> > Documentation/environment_variables.rst | 2 ++\n> > README.rst | 15 +++++++++++++++\n> > 2 files changed, 17 insertions(+)\n> >\n> > diff --git a/Documentation/environment_variables.rst b/Documentation/environment_variables.rst\n> > index f092cbbd29c5..dcfdb1a33a32 100644\n> > --- a/Documentation/environment_variables.rst\n> > +++ b/Documentation/environment_variables.rst\n> > @@ -86,6 +86,8 @@ global environment:\n> > :~$ export LIBCAMERA_LOG_LEVELS='Camera:DEBUG,V4L2:DEBUG'\n> > :~$ cam --list\n> >\n> > +.. _log levels:\n> > +\n> > Log levels\n> > ~~~~~~~~~~\n> >\n> > diff --git a/README.rst b/README.rst\n> > index f81d6e2e7867..578aa19f0f54 100644\n> > --- a/README.rst\n> > +++ b/README.rst\n> > @@ -101,6 +101,21 @@ for android: [optional]\n> > for lc-compliance: [optional]\n> > libevent-dev\n> >\n> > +Basic testing with cam utility\n> > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n> > +\n> > +The ``cam`` utility can be used for basic testing. You can list the cameras\n> > +detected on the system with ``cam -l``, and capture ten frames from the first\n> > +camera and save them to disk with ``cam -c 1 --capture=10 --file``. See\n> > +``cam -h`` for more information about the ``cam`` tool.\n> > +\n> > +In case of problems, a detailed debug log can be obtained from libcamera by\n> > +setting the :ref:`LIBCAMERA_LOG_LEVELS ` environment variable:\n>\n> Will this try to hyperlink to a document that isn't currently available\n> on https://libcamera.org/getting-started.html ?\n\nWon't this link to the \"Log levels\" section ?\n\nJust compiled and checked, it does :)\nLooks good to me\nReviewed-by: Jacopo Mondi \n\nThanks\n j\n\n>\n> Other than that\n>\n>\n> Reviewed-by: Kieran Bingham \n>\n> > +\n> > +.. code::\n> > +\n> > + :~$ LIBCAMERA_LOG_LEVELS=*:DEBUG cam -l\n> > +\n> > Using GStreamer plugin\n> > ~~~~~~~~~~~~~~~~~~~~~~\n> >\n> > --\n> > Regards,\n> >\n> > Laurent Pinchart\n> >","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 7C2F1BD808\n\tfor ;\n\tWed, 22 Jun 2022 07:20:22 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id C5D8F65635;\n\tWed, 22 Jun 2022 09:20:21 +0200 (CEST)","from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net\n\t[217.70.183.199])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 89EAB6559A\n\tfor ;\n\tWed, 22 Jun 2022 09:20:19 +0200 (CEST)","(Authenticated sender: jacopo@jmondi.org)\n\tby mail.gandi.net (Postfix) with ESMTPSA id 6C340FF816;\n\tWed, 22 Jun 2022 07:20:18 +0000 (UTC)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1655882421;\n\tbh=m/J30T6AB+BCQv7ep2htUmYpYQKKN6NaXWunjVB9Fos=;\n\th=Date:To:References:In-Reply-To:Subject:List-Id:List-Unsubscribe:\n\tList-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc:\n\tFrom;\n\tb=p8ksnoibepM20od/f8TKBdhIVJQ+b/Yq5hEqR7TLkXyOvlx/dZVYRy4eRV1oIwUox\n\tQqzTeLO2nRTp86YpxzkUbdKmFLn0tZLg0uL7TzJD8+HVqVvWMENj6AiC9iG2jItFav\n\t5SO2WstvwrVKe4DrjC641YM1ORCrqynye+pM6MATqvjxLc54326zL3yQDz2VMfuAmm\n\tBNbRQICbmI2+knpg2vSNukCw70pKiMzaHso0qSvtlGTRO4E/R7WxHi+R3Ko8mFM8/T\n\t/9fk6/wQyUDwEer/4g0kOVictuYdSbkqo3sZda2MBMvq7La513fCIkPJ8p7ul6w1cr\n\tSFZNOrfLUeVXA==","Date":"Wed, 22 Jun 2022 09:20:16 +0200","To":"Kieran Bingham ","Message-ID":"<20220622072016.wug5kqdhdj2jzqea@uno.localdomain>","References":"<20220621230826.23906-1-laurent.pinchart@ideasonboard.com>\n\t<20220621230826.23906-2-laurent.pinchart@ideasonboard.com>\n\t<165585378235.1149771.12791572368194597911@Monstersaurus>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<165585378235.1149771.12791572368194597911@Monstersaurus>","Subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","From":"Jacopo Mondi via libcamera-devel ","Reply-To":"Jacopo Mondi ","Cc":"libcamera-devel@lists.libcamera.org, Pavel Machek ","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}},{"id":23519,"web_url":"https://patchwork.libcamera.org/comment/23519/","msgid":"","date":"2022-06-22T07:39:24","subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"On Wed, Jun 22, 2022 at 09:20:16AM +0200, Jacopo Mondi wrote:\n> On Wed, Jun 22, 2022 at 12:23:02AM +0100, Kieran Bingham via libcamera-devel wrote:\n> > Quoting Laurent Pinchart via libcamera-devel (2022-06-22 00:08:26)\n> > > The README.rst file contains the getting started instructions, but lacks\n> > > a simple way to test libcamera. Add a short section about basic cam\n> > > usage.\n> > >\n> > > Suggested-by: Pavel Machek \n> > > Signed-off-by: Laurent Pinchart \n> > > ---\n> > > Documentation/environment_variables.rst | 2 ++\n> > > README.rst | 15 +++++++++++++++\n> > > 2 files changed, 17 insertions(+)\n> > >\n> > > diff --git a/Documentation/environment_variables.rst b/Documentation/environment_variables.rst\n> > > index f092cbbd29c5..dcfdb1a33a32 100644\n> > > --- a/Documentation/environment_variables.rst\n> > > +++ b/Documentation/environment_variables.rst\n> > > @@ -86,6 +86,8 @@ global environment:\n> > > :~$ export LIBCAMERA_LOG_LEVELS='Camera:DEBUG,V4L2:DEBUG'\n> > > :~$ cam --list\n> > >\n> > > +.. _log levels:\n> > > +\n> > > Log levels\n> > > ~~~~~~~~~~\n> > >\n> > > diff --git a/README.rst b/README.rst\n> > > index f81d6e2e7867..578aa19f0f54 100644\n> > > --- a/README.rst\n> > > +++ b/README.rst\n> > > @@ -101,6 +101,21 @@ for android: [optional]\n> > > for lc-compliance: [optional]\n> > > libevent-dev\n> > >\n> > > +Basic testing with cam utility\n> > > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n> > > +\n> > > +The ``cam`` utility can be used for basic testing. You can list the cameras\n> > > +detected on the system with ``cam -l``, and capture ten frames from the first\n> > > +camera and save them to disk with ``cam -c 1 --capture=10 --file``. See\n> > > +``cam -h`` for more information about the ``cam`` tool.\n> > > +\n> > > +In case of problems, a detailed debug log can be obtained from libcamera by\n> > > +setting the :ref:`LIBCAMERA_LOG_LEVELS ` environment variable:\n> >\n> > Will this try to hyperlink to a document that isn't currently available\n> > on https://libcamera.org/getting-started.html ?\n> \n> Won't this link to the \"Log levels\" section ?\n> \n> Just compiled and checked, it does :)\n\nIt does, but only on local builds, not on the website. I'll drop the\nlink for now.\n\n> Looks good to me\n> Reviewed-by: Jacopo Mondi \n> \n> > Other than that\n> >\n> > Reviewed-by: Kieran Bingham \n> >\n> > > +\n> > > +.. code::\n> > > +\n> > > + :~$ LIBCAMERA_LOG_LEVELS=*:DEBUG cam -l\n> > > +\n> > > Using GStreamer plugin\n> > > ~~~~~~~~~~~~~~~~~~~~~~\n> > >","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 78AEDBE173\n\tfor ;\n\tWed, 22 Jun 2022 07:39:42 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id D6B836559A;\n\tWed, 22 Jun 2022 09:39:41 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 880516559A\n\tfor ;\n\tWed, 22 Jun 2022 09:39:40 +0200 (CEST)","from pendragon.ideasonboard.com (62-78-145-57.bb.dnainternet.fi\n\t[62.78.145.57])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id E3297DD;\n\tWed, 22 Jun 2022 09:39:39 +0200 (CEST)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1655883581;\n\tbh=2khrCkVtgxvc9WGUfIiys02o+nD1T40tsszDkzWsIIs=;\n\th=Date:To:References:In-Reply-To:Subject:List-Id:List-Unsubscribe:\n\tList-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc:\n\tFrom;\n\tb=t31wGUtK0QEc0aObT31jI+59/Ob/YmljZwAeARS3aWQdQ0eFwlZgQWQ7RFYdeZKSA\n\twkF0KloeOlhFafhe9CCCPsaPLOB835WNeYx62iuzLVYolByNzeC755EN/r4BvgUMS6\n\twIlQTyaLPSMXRRYE6fWb3x96d5MStY6EPI5VisZlhVkmb8PBDYx/dgJ6Ua4A9xXcVH\n\tbb5P2R8U9itps9/UYdkvVv4l1Y8nCBzJYoiRN4MLebjd5aVXlHgSPsaWRrsLbYra9h\n\t8pPrfsTmnwFZ1GcnaXVpuSVD4zQBoum70j1/vwtZtDXodZn921NmLeOwQsWU21xxU8\n\tqHz2VqsQ2U74w==","v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1655883580;\n\tbh=2khrCkVtgxvc9WGUfIiys02o+nD1T40tsszDkzWsIIs=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=n2AWQE167gFlz68eolfqZ05XgU8T4stRCUrO/M5AFAq4JSQ6B08c1Dids59///H70\n\txcbXjfCS52wmIJAxd0lwDHDGbTL+lkQApJGVt2Hd6ABUVlRwWo/XSuXyuNouxuaX7D\n\tldTEdNsUJeraIqct48rnnQYePyGMDPypLcscCrvw="],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"n2AWQE16\"; dkim-atps=neutral","Date":"Wed, 22 Jun 2022 10:39:24 +0300","To":"Jacopo Mondi ","Message-ID":"","References":"<20220621230826.23906-1-laurent.pinchart@ideasonboard.com>\n\t<20220621230826.23906-2-laurent.pinchart@ideasonboard.com>\n\t<165585378235.1149771.12791572368194597911@Monstersaurus>\n\t<20220622072016.wug5kqdhdj2jzqea@uno.localdomain>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20220622072016.wug5kqdhdj2jzqea@uno.localdomain>","Subject":"Re: [libcamera-devel] [PATCH 2/2] README: Add short testing\n\tinstructions with cam","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","From":"Laurent Pinchart via libcamera-devel\n\t","Reply-To":"Laurent Pinchart ","Cc":"libcamera-devel@lists.libcamera.org, Pavel Machek ","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}}]