{"id":3703,"url":"https://patchwork.libcamera.org/api/patches/3703/?format=json","web_url":"https://patchwork.libcamera.org/patch/3703/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/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":"<20200507151253.2951492-2-jacopo@jmondi.org>","date":"2020-05-07T15:12:48","name":"[libcamera-devel,v7,1/6] Documentation: media: Update sub-device API intro","commit_ref":null,"pull_url":null,"state":"not-applicable","archived":false,"hash":"0e277b2ce2c35819104fbcd59d6a222d5fdf68cb","submitter":{"id":3,"url":"https://patchwork.libcamera.org/api/people/3/?format=json","name":"Jacopo Mondi","email":"jacopo@jmondi.org"},"delegate":{"id":15,"url":"https://patchwork.libcamera.org/api/users/15/?format=json","username":"jmondi","first_name":"Jacopo","last_name":"Mondi","email":"jacopo@jmondi.org"},"mbox":"https://patchwork.libcamera.org/patch/3703/mbox/","series":[{"id":885,"url":"https://patchwork.libcamera.org/api/series/885/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=885","date":"2020-05-07T15:12:47","name":"media: Register read-only sub-dev devnode","version":7,"mbox":"https://patchwork.libcamera.org/series/885/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/3703/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/3703/checks/","tags":{},"headers":{"Return-Path":"","Received":["from relay12.mail.gandi.net (relay12.mail.gandi.net\n\t[217.70.178.232])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 76EF7616AF\n\tfor ;\n\tThu, 7 May 2020 17:09:49 +0200 (CEST)","from localhost.localdomain (2-224-242-101.ip172.fastwebnet.it\n\t[2.224.242.101]) (Authenticated sender: jacopo@jmondi.org)\n\tby relay12.mail.gandi.net (Postfix) with ESMTPSA id D87EF200009;\n\tThu, 7 May 2020 15:09:47 +0000 (UTC)"],"From":"Jacopo Mondi ","To":"linux-media@vger.kernel.org,\n\tlibcamera-devel@lists.libcamera.org","Cc":"Jacopo Mondi , mchehab@kernel.org,\n\thverkuil-cisco@xs4all.nl, sakari.ailus@linux.intel.com,\n\tandrey.konovalov@linaro.org, laurent.pinchart@ideasonboard.com","Date":"Thu, 7 May 2020 17:12:48 +0200","Message-Id":"<20200507151253.2951492-2-jacopo@jmondi.org>","X-Mailer":"git-send-email 2.26.1","In-Reply-To":"<20200507151253.2951492-1-jacopo@jmondi.org>","References":"<20200507151253.2951492-1-jacopo@jmondi.org>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v7 1/6] Documentation: media: Update\n\tsub-device API intro","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","X-List-Received-Date":"Thu, 07 May 2020 15:09:50 -0000"},"content":"Update the V4L2 sub-device userspace API introduction to provide more\ndetails on why complex devices might want to register devnodes for the\nconnected subdevices.\n\nAcked-by: Sakari Ailus \nSuggested-by: Laurent Pinchart \nSigned-off-by: Jacopo Mondi \n---\n Documentation/driver-api/media/v4l2-subdev.rst | 9 +++++++--\n 1 file changed, 7 insertions(+), 2 deletions(-)","diff":"diff --git a/Documentation/driver-api/media/v4l2-subdev.rst b/Documentation/driver-api/media/v4l2-subdev.rst\nindex 29e07e23f8885..41ccb3e5c7075 100644\n--- a/Documentation/driver-api/media/v4l2-subdev.rst\n+++ b/Documentation/driver-api/media/v4l2-subdev.rst\n@@ -275,8 +275,13 @@ system the .unbind() method is called. All three callbacks are optional.\n V4L2 sub-device userspace API\n -----------------------------\n \n-Beside exposing a kernel API through the :c:type:`v4l2_subdev_ops` structure,\n-V4L2 sub-devices can also be controlled directly by userspace applications.\n+Bridge drivers traditionally expose one or multiple video nodes to userspace,\n+and control subdevices through the :c:type:`v4l2_subdev_ops` operations in\n+response to video node operations. This hides the complexity of the underlying\n+hardware from applications. For complex devices, finer-grained control of the\n+device than what the video nodes offer may be required. In those cases, bridge\n+drivers that implement :ref:`the media controller API ` may\n+opt for making the subdevice operations directly accessible from userpace.\n \n Device nodes named ``v4l-subdev``\\ *X* can be created in ``/dev`` to access\n sub-devices directly. If a sub-device supports direct userspace configuration\n","prefixes":["libcamera-devel","v7","1/6"]}