driver-api/media/camera-sensor.rst

1 .. SPDX-License-Identifier: GPL-2.0
6 CSI-2 and parallel (BT.601 and BT.656) busses
7 ---------------------------------------------
9 Please see :ref:`transmitter-receiver`.
12 ---------------
14 Camera sensors have an internal clock tree including a PLL and a number of
15 divisors. The clock tree is generally configured by the driver based on a few
16 input parameters that are specific to the hardware:: the external clock frequency
20 The reason why the clock frequencies are so important is that the clock signals
23 elsewhere. Therefore only the pre-determined frequencies are configurable by the
29 Read the ``clock-frequency`` _DSD property to denote the frequency. The driver
35 The currently preferred way to achieve this is using ``assigned-clocks``,
36 ``assigned-clock-parents`` and ``assigned-clock-rates`` properties. See
37 ``Documentation/devicetree/bindings/clock/clock-bindings.txt`` for more
42 the board's clock tree to begin with. Changes to the Common Clock Framework API
46 ----------
54 Freely configurable camera sensor drivers expose the device's internal
55 processing pipeline as one or more sub-devices with different cropping and
68 format set on a source pad at the end of the device's internal pipeline.
74 ----------------------------
95 crop, use the full source image size, i.e. pixel array size.
101 sub-device. The unit of that control is pixels per second.
103 Register list based drivers need to implement read-only sub-device nodes for the
105 device's internal processing pipeline.
109 skipping, scaling or digital crop :ref:`v4l2-subdev-selections`.
115 level interface natively, generally use the concept of frame interval (or frame
121 ----------------
123 Always use runtime PM to manage the power states of your device. Camera sensor
130 struct v4l2_subdev_core_ops->s_power() callback for bridge or ISP drivers to
134 should not use s_power.
137 ``drivers/media/i2c/ccs/ccs-core.c``. The two drivers work in both ACPI
151 The function returns a non-zero value if it succeeded getting the power count or
156 ----------------------------------
161 <v4l2-camera-sensor-rotation>` control.
164 :ref:`V4L2_CID_CAMERA_SENSOR_ORIENTATION <v4l2-camera-sensor-orientation>`.
166 Use ``v4l2_fwnode_device_parse()`` to obtain rotation and orientation