From: Benjamin Mugnier <benjamin.mugnier@foss.st.com>
Date: Tue, 11 Oct 2022 12:30:29 +0000 (+0200)
Subject: media: Documentation: Add ST VGXY61 driver documentation
X-Git-Tag: v6.2-rc1~125^2~251^2~31
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2378be892b6ff53659a81b703c9c3fe4ead5a6d7;p=thirdparty%2Fkernel%2Flinux.git

media: Documentation: Add ST VGXY61 driver documentation

Document V4L2_CID_HDR_MODE possible values for this sensor.

Signed-off-by: Benjamin Mugnier <benjamin.mugnier@foss.st.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
---

diff --git a/Documentation/userspace-api/media/drivers/st-vgxy61.rst b/Documentation/userspace-api/media/drivers/st-vgxy61.rst
new file mode 100644
index 0000000000000..213b884dcfa65
--- /dev/null
+++ b/Documentation/userspace-api/media/drivers/st-vgxy61.rst
@@ -0,0 +1,23 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+ST VGXY61 camera sensor driver
+==============================
+
+The ST VGXY61 driver implements the following controls:
+
+``V4L2_CID_HDR_SENSOR_MODE``
+-------------------------------
+    Change the sensor HDR mode. A HDR picture is obtained by merging two captures of the same scene
+    using two different exposure periods.
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 4
+
+    * - HDR linearize
+      - The merger outputs a long exposure capture as long as it is not saturated.
+    * - HDR substraction
+      - This involves subtracting the short exposure frame from the long exposure frame.
+    * - "No HDR"
+      - This mode is used for standard dynamic range (SDR) exposures.