182bdadd0f
Add a new .rst file referencing the documentation contents. This file is then included in each documentation page so that we can enhance the Documentation pages on the libcamera website using it. As we do not want the appearance of the libcamera in-tree Documentation to change just yet, disable the new class using the sphinx theme's CSS. To facilitate easier distinguishing between "normal" and documentation pages on the website we want to add a "documentation" class to the content of all such pages. Since this new file will be included on each documentation page it is convenient to add the new directive here - do so. As the website uses different CSS to libcamera, move the contents on docs.rst a little so that the directive at the end of the contents block applies correctly. Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Daniel Scally <dan.scally@ideasonboard.com> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
29 lines
1,020 B
ReStructuredText
29 lines
1,020 B
ReStructuredText
.. SPDX-License-Identifier: CC-BY-SA-4.0
|
|
|
|
.. include:: documentation-contents.rst
|
|
|
|
.. _lens-driver-requirements:
|
|
|
|
Lens Driver Requirements
|
|
========================
|
|
|
|
libcamera handles lens devices in the CameraLens class and defines
|
|
a consistent interface through its API towards other library components.
|
|
|
|
The CameraLens class uses the V4L2 subdev kernel API to interface with the
|
|
camera lens through a sub-device exposed to userspace by the lens driver.
|
|
|
|
In order for libcamera to be fully operational and provide all the required
|
|
information to interface with the camera lens to applications and pipeline
|
|
handlers, a set of mandatory features the driver has to support has been defined.
|
|
|
|
Mandatory Requirements
|
|
----------------------
|
|
|
|
The lens driver is assumed to be fully compliant with the V4L2 specification.
|
|
|
|
The lens driver shall support the following V4L2 controls:
|
|
|
|
* `V4L2_CID_FOCUS_ABSOLUTE`_
|
|
|
|
.. _V4L2_CID_FOCUS_ABSOLUTE: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/ext-ctrls-camera.html
|