[PATCH v6 6/7] Documentation: media: Describe V4L2_CID_UNIT_CELL_SIZE

From: Ricardo Ribalda Delgado
Date: Fri Sep 20 2019 - 09:52:03 EST


From: Ricardo Ribalda Delgado <ribalda@xxxxxxxxxx>

New control to pass to userspace the width/height of a pixel. Which is
needed for calibration and lens selection.

Reviewed-by: Philipp Zabel <p.zabel@xxxxxxxxxxxxxx>
Signed-off-by: Ricardo Ribalda Delgado <ribalda@xxxxxxxxxx>
---
Documentation/media/uapi/v4l/ext-ctrls-image-source.rst | 9 +++++++++
1 file changed, 9 insertions(+)

diff --git a/Documentation/media/uapi/v4l/ext-ctrls-image-source.rst b/Documentation/media/uapi/v4l/ext-ctrls-image-source.rst
index 2c3ab5796d76..033672dcb43d 100644
--- a/Documentation/media/uapi/v4l/ext-ctrls-image-source.rst
+++ b/Documentation/media/uapi/v4l/ext-ctrls-image-source.rst
@@ -55,3 +55,12 @@ Image Source Control IDs

``V4L2_CID_TEST_PATTERN_GREENB (integer)``
Test pattern green (next to blue) colour component.
+
+``V4L2_CID_UNIT_CELL_SIZE (struct)``
+ This control returns the unit cell size in nanometres. The struct
+ :c:type:`v4l2_area` provides the width and the height in separated
+ fields to take into consideration asymmetric pixels and/or hardware
+ binning.
+ The unit cell consists of the whole area of the pixel, sensitive and
+ non-sensitive.
+ This control is required for automatic calibration sensors/cameras.
--
2.23.0