[libcamera-devel,v5,04/17] libcamera: controls: Destage 'SensorTimestamp'
diff mbox series

Message ID 20210503104152.34048-5-jacopo@jmondi.org
State Accepted
Headers show
Series
  • Support SensorTimestamp metadata
Related show

Commit Message

Jacopo Mondi May 3, 2021, 10:41 a.m. UTC
Destage the 'SensorTimestamp' control, which is used by pipeline
handlers to report the time when the first active line of the sensor's
pixel array is exposed.

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Reviewed-by: Hirokazu Honda <hiroh@chromium.org>
Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>
---
 src/libcamera/control_ids.yaml | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

Patch
diff mbox series

diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index b4771f9def89..88d81ac4cccc 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -360,6 +360,20 @@  controls:
 
       size: [2]
 
+  - SensorTimestamp:
+      type: int64_t
+      description: |
+        The time when the first row of the image sensor active array is exposed.
+
+        The timestamp, expressed in nanoseconds, represents a monotonically
+        increasing counter since the system boot time, as defined by the
+        Linux-specific CLOCK_BOOTTIME clock id.
+
+        The SensorTimestamp control can only be returned in metadata.
+
+        \todo Define how the sensor timestamp has to be used in the reprocessing
+        use case.
+
   # ----------------------------------------------------------------------------
   # Draft controls section
 
@@ -547,13 +561,6 @@  controls:
           value: 3
           description: The AWB algorithm is locked.
 
-  - SensorTimestamp:
-      type: int64_t
-      draft: true
-      description: |
-       Control to report the start of exposure of the first row of the captured
-       image. Currently identical to ANDROID_SENSOR_TIMESTAMP.
-
   - SensorRollingShutterSkew:
       type: int64_t
       draft: true