libcamera: Add 'required' property to controls

Add to the ControlId class a 'required' boolean flag that determine
if the control (or property) is mandatory to be supported by a Camera
in order to comply with the libcamera API specification.

Add support for a 'required' field to the controls and properties yaml
file definition and control generation scripts.

Also plumb support for the flag in the control serializer component
to allow pass the information across IPC borders.

Signed-off-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>

1 files changed, 7 insertions, 1 deletions

diff --git a/utils/gen-controls.py b/utils/gen-controls.py
index 6cd5e362..1e997708 100755
--- a/utils/gen-controls.py
+++ b/utils/gen-controls.py
@@ -112,6 +112,11 @@ class Control(object):
         else:
             return f"Span<const {typ}>"
 
+    @property
+    def required(self):
+        """Is the control required"""
+        return self.__data.get('required')
+
 
 def snake_case(s):
     return ''.join([c.isupper() and ('_' + c) or c for c in s]).strip('_')
@@ -133,7 +138,7 @@ ${description}''')
  * \\var ${name}
 ${description}
  */''')
-    def_template = string.Template('extern const Control<${type}> ${name}(${id_name}, "${name}");')
+    def_template = string.Template('extern const Control<${type}> ${name}(${id_name}, "${name}", ${required});')
     enum_values_doc = string.Template('''/**
  * \\var ${name}Values
  * \\brief List of all $name supported values
@@ -158,6 +163,7 @@ ${description}
             'type': ctrl.type,
             'description': format_description(ctrl.description),
             'id_name': id_name,
+            'required': "true" if ctrl.required else "false"
         }
 
         target_doc = ctrls_doc[vendor]