{"id":14707,"url":"https://patchwork.libcamera.org/api/1.1/patches/14707/?format=json","web_url":"https://patchwork.libcamera.org/patch/14707/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/1.1/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20211123123751.3194696-4-hanlinchen@chromium.org>","date":"2021-11-23T12:37:50","name":"[libcamera-devel,v4,3/4] libcamera: camera_lens: Add a new class to model a camera lens","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"3c9bdba38b9c324d2175c6c0e7795f487b93bb2a","submitter":{"id":98,"url":"https://patchwork.libcamera.org/api/1.1/people/98/?format=json","name":"Hanlin Chen","email":"hanlinchen@chromium.org"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/14707/mbox/","series":[{"id":2743,"url":"https://patchwork.libcamera.org/api/1.1/series/2743/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=2743","date":"2021-11-23T12:37:47","name":"Introduce Lens class and apply auto focus on ipu3","version":4,"mbox":"https://patchwork.libcamera.org/series/2743/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/14707/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/14707/checks/","tags":{},"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 56D8BBF415\n\tfor ;\n\tTue, 23 Nov 2021 12:38:11 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id DB75960398;\n\tTue, 23 Nov 2021 13:38:10 +0100 (CET)","from mail-pf1-x42f.google.com (mail-pf1-x42f.google.com\n\t[IPv6:2607:f8b0:4864:20::42f])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 035BE60398\n\tfor ;\n\tTue, 23 Nov 2021 13:38:08 +0100 (CET)","by mail-pf1-x42f.google.com with SMTP id n26so19322886pff.3\n\tfor ;\n\tTue, 23 Nov 2021 04:38:07 -0800 (PST)","from localhost ([2401:fa00:1:10:8aa3:febd:fadf:4199])\n\tby smtp.gmail.com with UTF8SMTPSA id\n\tj6sm12860904pfu.205.2021.11.23.04.38.05\n\t(version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);\n\tTue, 23 Nov 2021 04:38:05 -0800 (PST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=chromium.org header.i=@chromium.org\n\theader.b=\"oD+AmyG6\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org;\n\ts=google; \n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=CD0u+dZO4p2XssMpLn5qa6N9zSQYWtS1JAmrhwOI/kU=;\n\tb=oD+AmyG639vMrJ65dyBlbasf2EXV2IMMmwFSCCqDpLrV4BBDiUd0VPWGM+838qnZTX\n\t95mkixYila7tnFZh7xJZ11xhv8saJK07Wa9qSV74uHNoufJ1hXkJL9KnG83QdicgUxlA\n\tf0tWD17dHj0vpp3xFiMIa/XbDAAGBDI4Ao/KE=","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20210112;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:mime-version:content-transfer-encoding;\n\tbh=CD0u+dZO4p2XssMpLn5qa6N9zSQYWtS1JAmrhwOI/kU=;\n\tb=kWVSzAC6pm6K/EVf9RDu0bIg2y0riTFPoXkSQ/0vLbQ325Rx4qU6poHejKujfIx26H\n\tSFHm1NpYMRCWpaiAADJiYHPR1qFOfymwmDeTcC1YOCwQJpbYdUdSnFx4FInlLh0D9TSr\n\tufABWUsHmCACTfqDFfECR9npZs7rq/tGf0dfgSz7qm+gTZOlb8+mj3t0tPc9R05btOhp\n\trLaPuUdfcxd/bFaU/BL6LWnuat1Avs4HBGb/Ao924my8sDGVg1YZ9VFJ7ePuTUOB1VzF\n\tXNv7/bHLWE9HU8osRHgL2i5ATatob3u9vAZlHHtzmxpRgyLRj0WB0fd5YLryoNWp0NbK\n\tGxkw==","X-Gm-Message-State":"AOAM533B1wW82d1+7G6IXCJzAq47Sxkbdw4XV6hpkB4L7KIZDBkxRTxB\n\tMsdaQXhNHKCK0L/zBU++OAgh81jrhpQ5KA==","X-Google-Smtp-Source":"ABdhPJzYiD+guD5Jb6PGZhtDZ+twcG1KMSdUSDx471tx4mFb5KDwHJGSyjWvfTInN9suNESS/gViBQ==","X-Received":"by 2002:a65:5ccb:: with SMTP id\n\tb11mr3616462pgt.408.1637671086228; \n\tTue, 23 Nov 2021 04:38:06 -0800 (PST)","From":"Han-Lin Chen ","To":"libcamera-devel@lists.libcamera.org","Date":"Tue, 23 Nov 2021 20:37:50 +0800","Message-Id":"<20211123123751.3194696-4-hanlinchen@chromium.org>","X-Mailer":"git-send-email 2.34.0.rc2.393.gf8c9666880-goog","In-Reply-To":"<20211123123751.3194696-1-hanlinchen@chromium.org>","References":"<20211123123751.3194696-1-hanlinchen@chromium.org>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v4 3/4] libcamera: camera_lens: Add a new\n\tclass to model a camera lens","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","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"The CameraLens class abstracts camera lens and provides helper\nfunctions to ease interactions with them.\n\nSigned-off-by: Han-Lin Chen \nReviewed-by: Kieran Bingham \n---\n Documentation/index.rst | 1 +\n Documentation/lens_driver_requirements.rst | 28 ++++\n Documentation/meson.build | 1 +\n include/libcamera/internal/camera_lens.h | 48 +++++++\n include/libcamera/internal/meson.build | 1 +\n src/libcamera/camera_lens.cpp | 150 +++++++++++++++++++++\n src/libcamera/meson.build | 1 +\n 7 files changed, 230 insertions(+)\n create mode 100644 Documentation/lens_driver_requirements.rst\n create mode 100644 include/libcamera/internal/camera_lens.h\n create mode 100644 src/libcamera/camera_lens.cpp","diff":"diff --git a/Documentation/index.rst b/Documentation/index.rst\nindex 1f4fc485..0ee10044 100644\n--- a/Documentation/index.rst\n+++ b/Documentation/index.rst\n@@ -21,3 +21,4 @@\n Tracing guide \n Environment variables \n Sensor driver requirements \n+ Lens driver requirements \ndiff --git a/Documentation/lens_driver_requirements.rst b/Documentation/lens_driver_requirements.rst\nnew file mode 100644\nindex 00000000..afc300cf\n--- /dev/null\n+++ b/Documentation/lens_driver_requirements.rst\n@@ -0,0 +1,28 @@\n+.. SPDX-License-Identifier: CC-BY-SA-4.0\n+\n+.. _lens-driver-requirements:\n+\n+Lens Driver Requirements\n+========================\n+\n+libcamera handles lens devices in the CameraLens class and defines\n+a consistent interface through its API towards other library components.\n+\n+The CameraLens class uses the V4L2 subdev kernel API to interface with the\n+camera lens through one or multiple sub-devices exposed in userspace by\n+the lens driver.\n+\n+In order for libcamera to be fully operational and provide all the required\n+information to interface with the camera lens to applications and pipeline\n+handlers, a set of mandatory features the driver has to support has been defined.\n+\n+Mandatory Requirements\n+----------------------\n+\n+The lens driver is assumed to be fully compliant with the V4L2 specification.\n+\n+The lens driver shall support the following V4L2 controls:\n+\n+* `V4L2_CID_FOCUS_ABSOLUTE`_\n+\n+.. _V4L2_CID_FOCUS_ABSOLUTE: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/ext-ctrls-camera.html\ndiff --git a/Documentation/meson.build b/Documentation/meson.build\nindex 4c972675..33af82aa 100644\n--- a/Documentation/meson.build\n+++ b/Documentation/meson.build\n@@ -66,6 +66,7 @@ if sphinx.found()\n 'guides/pipeline-handler.rst',\n 'guides/tracing.rst',\n 'index.rst',\n+ 'lens_driver_requirements.rst',\n 'sensor_driver_requirements.rst',\n '../README.rst',\n ]\ndiff --git a/include/libcamera/internal/camera_lens.h b/include/libcamera/internal/camera_lens.h\nnew file mode 100644\nindex 00000000..fe83d4ad\n--- /dev/null\n+++ b/include/libcamera/internal/camera_lens.h\n@@ -0,0 +1,48 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2021, Google Inc.\n+ *\n+ * camera_lens.h - A camera lens\n+ */\n+#ifndef __LIBCAMERA_INTERNAL_CAMERA_LENS_H__\n+#define __LIBCAMERA_INTERNAL_CAMERA_LENS_H__\n+\n+#include \n+#include \n+\n+#include \n+\n+#include \"libcamera/internal/v4l2_subdevice.h\"\n+\n+namespace libcamera {\n+\n+class MediaEntity;\n+\n+class CameraLens : protected Loggable\n+{\n+public:\n+\texplicit CameraLens(const MediaEntity *entity);\n+\t~CameraLens();\n+\n+\tint init();\n+\tint setFocusPostion(int32_t position);\n+\n+\tconst std::string &model() const { return model_; }\n+\n+protected:\n+\tstd::string logPrefix() const override;\n+\n+private:\n+\tLIBCAMERA_DISABLE_COPY_AND_MOVE(CameraLens)\n+\n+\tint validateLensDriver();\n+\n+\tconst MediaEntity *entity_;\n+\tstd::unique_ptr subdev_;\n+\n+\tstd::string model_;\n+};\n+\n+} /* namespace libcamera */\n+\n+#endif /* __LIBCAMERA_INTERNAL_CAMERA_LENS_H__ */\ndiff --git a/include/libcamera/internal/meson.build b/include/libcamera/internal/meson.build\nindex de8630fe..7e9b9998 100644\n--- a/include/libcamera/internal/meson.build\n+++ b/include/libcamera/internal/meson.build\n@@ -14,6 +14,7 @@ libcamera_internal_headers = files([\n 'byte_stream_buffer.h',\n 'camera.h',\n 'camera_controls.h',\n+ 'camera_lens.h',\n 'camera_sensor.h',\n 'camera_sensor_properties.h',\n 'camera_utils.h',\ndiff --git a/src/libcamera/camera_lens.cpp b/src/libcamera/camera_lens.cpp\nnew file mode 100644\nindex 00000000..cb7159fe\n--- /dev/null\n+++ b/src/libcamera/camera_lens.cpp\n@@ -0,0 +1,150 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2021, Google Inc.\n+ *\n+ * camera_lens.cpp - A camera lens\n+ */\n+\n+#include \"libcamera/internal/camera_lens.h\"\n+\n+#include \n+#include \n+\n+#include \"libcamera/internal/camera_utils.h\"\n+#include \"libcamera/internal/media_device.h\"\n+#include \"libcamera/internal/sysfs.h\"\n+\n+/**\n+ * \\file camera_lens.h\n+ * \\brief A camera lens\n+ */\n+\n+namespace libcamera {\n+\n+LOG_DEFINE_CATEGORY(CameraLens)\n+\n+/**\n+ * \\class CameraLens\n+ * \\brief A camera lens based on V4L2 subdevices\n+ *\n+ * The CameraLens class eases handling of lens for pipeline handlers by\n+ * hiding the details of the V4L2 subdevice kernel API and caching lens\n+ * information.\n+ *\n+ * The implementation is currently limited to lens that expose a single V4L2\n+ * subdevice. It will be extended to support more complex devices as the needs\n+ * arise.\n+ */\n+\n+/**\n+ * \\brief Construct a CameraLens\n+ * \\param[in] entity The media entity backing the camera lens\n+ *\n+ * Once constructed the instance must be initialized with init().\n+ */\n+CameraLens::CameraLens(const MediaEntity *entity)\n+\t: entity_(entity)\n+{\n+}\n+\n+/**\n+ * \\brief Destroy a CameraLens\n+ */\n+CameraLens::~CameraLens() = default;\n+\n+/**\n+ * \\brief Initialize the camera lens instance\n+ *\n+ * This function performs the initialisation steps of the CameraLens that may\n+ * fail. It shall be called once and only once after constructing the instance.\n+ *\n+ * \\return 0 on success or a negative error code otherwise\n+ */\n+int CameraLens::init()\n+{\n+\tif (entity_->function() != MEDIA_ENT_F_LENS) {\n+\t\tLOG(CameraLens, Error)\n+\t\t\t<< \"Invalid lens function \"\n+\t\t\t<< utils::hex(entity_->function());\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tmodel_ = extractModelFromEntityName(entity_->name());\n+\n+\t/* Create and open the subdev. */\n+\tsubdev_ = std::make_unique(entity_);\n+\tint ret = subdev_->open();\n+\tif (ret < 0)\n+\t\treturn ret;\n+\n+\tret = validateLensDriver();\n+\tif (ret)\n+\t\treturn ret;\n+\n+\treturn 0;\n+}\n+\n+/**\n+ * \\brief This function sets the focal point of the lens to a specific position.\n+ * \\param[in] position The focal point of the lens\n+ *\n+ * This function sets the value of focal point of the lens as in \\a position.\n+ *\n+ * \\return 0 on success or -EINVAL otherwise\n+ */\n+int CameraLens::setFocusPostion(int32_t position)\n+{\n+\tControlList lensCtrls(subdev_->controls());\n+\tlensCtrls.set(V4L2_CID_FOCUS_ABSOLUTE, static_cast(position));\n+\n+\tif (subdev_->setControls(&lensCtrls))\n+\t\treturn -EINVAL;\n+\n+\treturn 0;\n+}\n+\n+int CameraLens::validateLensDriver()\n+{\n+\tint err = 0;\n+\tstatic constexpr uint32_t mandatoryControls[] = {\n+\t\tV4L2_CID_FOCUS_ABSOLUTE\n+\t};\n+\n+\tconst ControlInfoMap &controls = subdev_->controls();\n+\tfor (uint32_t ctrl : mandatoryControls) {\n+\t\tif (!controls.count(ctrl)) {\n+\t\t\tLOG(CameraLens, Error)\n+\t\t\t\t<< \"Mandatory V4L2 control \" << utils::hex(ctrl)\n+\t\t\t\t<< \" not available\";\n+\t\t\terr = -EINVAL;\n+\t\t}\n+\t}\n+\n+\tif (err) {\n+\t\tLOG(CameraLens, Error)\n+\t\t\t<< \"The lens kernel driver needs to be fixed\";\n+\t\tLOG(CameraLens, Error)\n+\t\t\t<< \"See Documentation/lens_driver_requirements.rst in\"\n+\t\t\t<< \" the libcamera sources for more information\";\n+\t\treturn err;\n+\t}\n+\n+\treturn 0;\n+}\n+\n+/**\n+ * \\fn CameraLens::model()\n+ * \\brief Retrieve the lens model name\n+ *\n+ * The lens model name is a free-formed string that uniquely identifies the\n+ * lens model.\n+ *\n+ * \\return The lens model name\n+ */\n+\n+std::string CameraLens::logPrefix() const\n+{\n+\treturn \"'\" + entity_->name() + \"'\";\n+}\n+\n+} /* namespace libcamera */\ndiff --git a/src/libcamera/meson.build b/src/libcamera/meson.build\nindex 563ed861..2100805d 100644\n--- a/src/libcamera/meson.build\n+++ b/src/libcamera/meson.build\n@@ -5,6 +5,7 @@ libcamera_sources = files([\n 'byte_stream_buffer.cpp',\n 'camera.cpp',\n 'camera_controls.cpp',\n+ 'camera_lens.cpp',\n 'camera_manager.cpp',\n 'camera_sensor.cpp',\n 'camera_sensor_properties.cpp',\n","prefixes":["libcamera-devel","v4","3/4"]}