libcamera: Add debug control space

Add a new 'debug' controls namespace for the upcoming implementation of
debug metadata. While at it, sort the entries alphabetically.

Signed-off-by: Stefan Klug <stefan.klug@ideasonboard.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

include/libcamera/control_ids.h.in

@@ -30,11 +30,13 @@ namespace {{vendor}} {
 #define LIBCAMERA_HAS_{{vendor|upper}}_VENDOR_{{mode|upper}}
 {%- endif %}
 
+{% if ctrls %}
 enum {
 {%- for ctrl in ctrls %}
 	{{ctrl.name|snake_case|upper}} = {{ctrl.id}},
 {%- endfor %}
 };
+{% endif %}
 
 {% for ctrl in ctrls -%}
 {% if ctrl.is_enum -%}

include/libcamera/meson.build

@@ -34,8 +34,9 @@ libcamera_headers_install_dir = get_option('includedir') / libcamera_include_dir
 
 controls_map = {
     'controls': {
-        'draft': 'control_ids_draft.yaml',
         'core': 'control_ids_core.yaml',
+        'debug': 'control_ids_debug.yaml',
+        'draft': 'control_ids_draft.yaml',
         'rpi/vc4': 'control_ids_rpi.yaml',
     },
 
@@ -55,7 +56,7 @@ foreach mode, entry : controls_map
     files_list = []
     input_files = []
     foreach vendor, header : entry
-        if vendor != 'core' and vendor != 'draft'
+        if vendor not in ['core', 'debug', 'draft']
             if vendor not in pipelines
                 continue
             endif

src/libcamera/control_ids_debug.yaml

@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: LGPL-2.1-or-later
+#
+%YAML 1.1
+---
+vendor: debug
+controls: []

src/libcamera/control_ranges.yaml

@@ -13,6 +13,8 @@ ranges:
   draft: 10000
   # Raspberry Pi vendor controls
   rpi: 20000
-  # Next range starts at 30000
+  # Controls for debug metadata
+  debug: 30000
+  # Next range starts at 40000
 
 ...