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

[Naushir Patuck]

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 at raspberrypi.com>
---
 src/libcamera/control_ids.yaml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

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]
 ...
-- 
2.25.1