[libcamera-devel] [PATCH v6 1/7] libcamera: properties: Add model property

[Niklas Söderlund]

The model name must to the extent possible describe the sensor. For most
devices this is the model name of the sensor. While for some devices the
sensor model is unavailable as the sensor or the entire camera is part
of a larger unit and exposed as a black-box to the system. In such cases
the model name of the smallest component closest to the sensor must be
used.

Signed-off-by: Niklas Söderlund <niklas.soderlund at ragnatech.se>
---
* Changes since v5
- Expand description.
- Changes so much by now I reluctantly have to drop Kieran's R-b :-(

* Changes since v4
- Expand description.

* Changes since v3
- s/as ASCII/in ASCII/
---
 src/libcamera/property_ids.yaml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/libcamera/property_ids.yaml b/src/libcamera/property_ids.yaml
index 74ad0195d6310367..3f634503a7f201e3 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -387,6 +387,29 @@ controls:
                               |                    |
                               +--------------------+
 
+  - Model:
+      type: string
+      description: |
+        The model name must to the extent possible describe the sensor. For most
+        devices this is the model name of the sensor. While for some devices the
+        sensor model is unavailable as the sensor or the entire camera is part
+        of a larger unit and exposed as a black-box to the system. In such cases
+        the model name of the smallest component closest to the sensor must be
+        used.
+
+        The model name is not meant to be a camera name displayed to the
+        end-user, but may be combined with other camera information to create a
+        camera name.
+
+        The model name is not guaranteed to be unique in the system nor is
+        it guaranteed to be stable or have any other properties required to make
+        it a good candidate to be used as a permanent identifier of a camera.
+
+        The model name shall describe the camera in a human readable format and
+        shall be encoded in ASCII.
+
+        Example model names are 'ov5670', 'imx219' or 'Logitech Webcam C930e'.
+
   - UnitCellSize:
       type: Size
       description: |
-- 
2.28.0