[libcamera-devel] [PATCH v3 1/2] libcamera: Add a SensorSensitivity property

[Naushir Patuck]

The SensorSensitivity property is a scaling factor that describes how sensitive
the selected sensor mode is compared to other readout modes of the same sensor.
For example, a binned mode might have twice the sensitivity of the full
resolution mode, meaning you would get double the signal level for the same
exposure and gains.

Signed-off-by: David Plowman <david.plowman at raspberrypi.com>
Signed-off-by: Naushir Patuck <naush at raspberrypi.com>
---
 src/libcamera/property_ids.yaml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/libcamera/property_ids.yaml b/src/libcamera/property_ids.yaml
index 12ecbce5eed4..11b7ebdc3105 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -678,6 +678,18 @@ controls:
         \todo Turn this property into a "maximum control value" for the
         ScalerCrop control once "dynamic" controls have been implemented.
 
+  - SensorSensitivity:
+      type: float
+      description: |
+        The relative sensitivity of the chosen sensor mode.
+
+        Some sensors have readout modes with different sensitivities. For example,
+        a binned camera mode might, with the same exposure and gains, produce
+        twice the signal level of the full resolution readout. This would be
+        signalled by the binned mode, when it is chosen, indicating a value here
+        that is twice that of the full resolution mode. This value will be valid
+        after the configure method has returned successfully.
+
   # ----------------------------------------------------------------------------
   # Draft properties section
 
-- 
2.25.1