{"id":3695,"url":"https://patchwork.libcamera.org/api/patches/3695/?format=json","web_url":"https://patchwork.libcamera.org/patch/3695/","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":"<20200507143537.2945672-2-jacopo@jmondi.org>","date":"2020-05-07T14:35:32","name":"[libcamera-devel,v6,1/6] Documentation: media: Update sub-device API intro","commit_ref":null,"pull_url":null,"state":"superseded","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":null,"mbox":"https://patchwork.libcamera.org/patch/3695/mbox/","series":[{"id":883,"url":"https://patchwork.libcamera.org/api/series/883/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=883","date":"2020-05-07T14:35:31","name":"media: Register read-only sub-dev devnode","version":6,"mbox":"https://patchwork.libcamera.org/series/883/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/3695/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/3695/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 EC600603EA\n\tfor ;\n\tThu, 7 May 2020 16:32:41 +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 C047820002A;\n\tThu, 7 May 2020 14:32:39 +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 16:35:32 +0200","Message-Id":"<20200507143537.2945672-2-jacopo@jmondi.org>","X-Mailer":"git-send-email 2.26.1","In-Reply-To":"<20200507143537.2945672-1-jacopo@jmondi.org>","References":"<20200507143537.2945672-1-jacopo@jmondi.org>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v6 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 14:32:42 -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","v6","1/6"]}