linux-kernel - [RFC 2/2] Documentation: media: Describe exposure and gain controls for multiple captures

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20250710220544.89066-3-mirela.rabulea@nxp.com>
Date: Fri, 11 Jul 2025 01:05:44 +0300
From: Mirela Rabulea <mirela.rabulea@....com>
To: mchehab@...nel.org,
	sakari.ailus@...ux.intel.com,
	hverkuil-cisco@...all.nl,
	laurent.pinchart+renesas@...asonboard.com,
	ribalda@...omium.org,
	jai.luthra@...asonboard.com,
	laurentiu.palcu@....com
Cc: linux-media@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	LnxRevLi@....com,
	julien.vuillaumier@....com,
	celine.laurencin@....com
Subject: [RFC 2/2] Documentation: media: Describe exposure and gain controls for multiple captures

The standard controls for exposure and gains allow a
single value, for a single capture. For sensors with HDR
capabilities or context switching, this is not enough, so
add new controls that allow multiple values, one for each
capture.

Signed-off-by: Mirela Rabulea <mirela.rabulea@....com>
---
 .../media/v4l/ext-ctrls-image-source.rst             | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst
index 71f23f131f97..6efdb58dacf5 100644
--- a/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst
+++ b/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst
@@ -92,3 +92,15 @@ Image Source Control IDs
     representing a gain of exactly 1.0. For example, if this default value
     is reported as being (say) 128, then a value of 192 would represent
     a gain of exactly 1.5.
+
+``V4L2_CID_EXPOSURE_MULTI (__u32 array)``
+    Same as V4L2_CID_EXPOSURE, but for multiple exposure sensors. Each
+    element of the array holds the exposure value for one capture.
+
+``V4L2_CID_AGAIN_MULTI (__u32 array)``
+    Same as V4L2_CID_ANALOGUE_GAIN, but for multiple exposure sensors. Each
+    element of the array holds the analog gain value for one capture.
+
+``V4L2_CID_DGAIN_MULTI (__u32 array)``
+    Same as V4L2_CID_DIGITAL_GAIN, but for multiple exposure sensors. Each
+    element of the array holds the digital gain value for one capture.
-- 
2.43.0