[libcamera-devel,v3,1/3] libcamera: controls: Add frame duration control

Message ID 20200608133639.533230-2-naush@raspberrypi.com
State Superseded
Headers show
Series
  • raspberrypi: FPS control
Related show

Commit Message

Naushir Patuck June 8, 2020, 1:36 p.m. UTC
Add a float array control (controls::FrameDurations) to specify the
minimum and maximum (in that order) frame duration to be used by the
camera sensor.

Signed-off-by: Naushir Patuck <naush@raspberrypi.com>
---
 src/libcamera/control_ids.yaml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

Patch

diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index 77ebc3f9..e161464b 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -239,4 +239,22 @@  controls:
         pixel range (as if pixels ranged from 0 to 65535). The SensorBlackLevels
         control can only be returned in metadata.
       size: [4]
+
+  - FrameDurationLimits:
+      type: float
+      description: |
+        Specifies the minimum and maximum (in that order) allowable frame
+        duration, in micro-seconds, for the sensor to use. This could also limit
+        the largest exposure times the sensor can use. For example, if a maximum
+        frame duration of 33ms is requested (corresponding to 30 frames per
+        second), the sensor will not be able raise the exposure time above 33ms.
+        FrameDurationLimits is only applied if AE is enabled.
+
+        Note that the sensor may not always be able to provide the requested
+        frame duration limits depending on its mode configuration. In such
+        situations, the user requested minimum and maximum frame durations will
+        be clipped to what the sensor supports.
+
+        \sa ExposureTime AeEnable
+      size: [2]
 ...