[libcamera-devel] [PATCH v1 1/3] libcamera: controls: Define a default lens position behaviour

[Naushir Patuck]

Update the LensPosition control description to explicitly define a
startup/default behaviour.

On startup, the IPA will move the lens to the position given by the
default value of the LensPosition control. Typically this would be the
hyperfocal position of the lens.

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

diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index adea5f90acc5..f6dbfd6c0bf0 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -610,6 +610,11 @@ controls:
         sharp). The minimum will often be zero (meaning infinity), and the
         maximum value defines the closest focus position.
 
+        On startup, the IPA will move the lens position to the default value of
+        this control. This can be overridden by the application providing an
+        alternative value though this control, or setting an appropriate AF mode
+        with controls::AfMode.
+
         \todo Define a property to report the Hyperfocal distance of calibrated
         lenses.
 
-- 
2.34.1