summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJacopo Mondi <jacopo.mondi@ideasonboard.com>2022-11-24 13:12:20 +0100
committerJacopo Mondi <jacopo.mondi@ideasonboard.com>2023-01-30 12:04:17 +0100
commitbb35ac92e4e0f8304b81c659f434e8bf4d10ddec (patch)
tree2eecef0668849e96f6a8a8285d7e43e7e932ad80
parent517017c49aac9b6841bf490a01c650c29afeb665 (diff)
documentation: sensor_drivers: Document H/V flip
Briefly document the optional requirement support for H/V flip controls. Signed-off-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com> Reviewed-by: David Plowman <david.plowman@raspberrypi.com>
-rw-r--r--Documentation/sensor_driver_requirements.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/Documentation/sensor_driver_requirements.rst b/Documentation/sensor_driver_requirements.rst
index 3abc8f35..0e516b34 100644
--- a/Documentation/sensor_driver_requirements.rst
+++ b/Documentation/sensor_driver_requirements.rst
@@ -62,6 +62,18 @@ The sensor driver should support the following V4L2 controls:
The controls are used to register the camera location and rotation.
+In order to support rotating the image the sensor driver should support
+
+* `V4L2_CID_HFLIP`_
+* `V4L2_CID_VFLIP`_
+
+.. _V4L2_CID_HFLIP: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/control.html
+.. _V4L2_CID_VFLIP: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/control.html
+
+The controls must be writable from userspace. In case of a RAW Bayer sensors,
+drivers should correctly report if vertical/horizontal flips modify the Bayer
+pattern ordering by reporting the `V4L2_CTRL_FLAG_MODIFY_LAYOUT` control flag.
+
The sensor driver should implement support for the V4L2 Selection API,
specifically it should implement support for the
`VIDIOC_SUBDEV_G_SELECTION`_ ioctl with support for the following selection