Show a cover letter.

GET /api/covers/9855/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 9855,
    "url": "https://patchwork.libcamera.org/api/covers/9855/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/9855/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20200929144648.429397-1-niklas.soderlund@ragnatech.se>",
    "date": "2020-09-29T14:46:41",
    "name": "[libcamera-devel,v6,0/7] libcamera: Allow for user-friendly names in",
    "submitter": {
        "id": 5,
        "url": "https://patchwork.libcamera.org/api/people/5/?format=api",
        "name": "Niklas Söderlund",
        "email": "niklas.soderlund@ragnatech.se"
    },
    "mbox": "https://patchwork.libcamera.org/cover/9855/mbox/",
    "series": [
        {
            "id": 1336,
            "url": "https://patchwork.libcamera.org/api/series/1336/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=1336",
            "date": "2020-09-29T14:46:41",
            "name": "libcamera: Allow for user-friendly names in",
            "version": 6,
            "mbox": "https://patchwork.libcamera.org/series/1336/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/9855/comments/",
    "headers": {
        "Return-Path": "<libcamera-devel-bounces@lists.libcamera.org>",
        "X-Original-To": "parsemail@patchwork.libcamera.org",
        "Delivered-To": "parsemail@patchwork.libcamera.org",
        "Received": [
            "from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id DCC8EC3B5C\n\tfor <parsemail@patchwork.libcamera.org>;\n\tTue, 29 Sep 2020 14:46:59 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 3CC7C621CD;\n\tTue, 29 Sep 2020 16:46:59 +0200 (CEST)",
            "from vsp-unauthed02.binero.net (vsp-unauthed02.binero.net\n\t[195.74.38.227])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 8544860365\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tTue, 29 Sep 2020 16:46:57 +0200 (CEST)",
            "from bismarck.berto.se (p54ac52a8.dip0.t-ipconnect.de\n\t[84.172.82.168]) by bin-vsp-out-02.atm.binero.net (Halon) with ESMTPA\n\tid 9c282872-0262-11eb-9823-005056917f90;\n\tTue, 29 Sep 2020 16:46:55 +0200 (CEST)"
        ],
        "X-Halon-ID": "9c282872-0262-11eb-9823-005056917f90",
        "Authorized-sender": "niklas.soderlund@fsdn.se",
        "From": "=?utf-8?q?Niklas_S=C3=B6derlund?= <niklas.soderlund@ragnatech.se>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Tue, 29 Sep 2020 16:46:41 +0200",
        "Message-Id": "<20200929144648.429397-1-niklas.soderlund@ragnatech.se>",
        "X-Mailer": "git-send-email 2.28.0",
        "MIME-Version": "1.0",
        "Subject": "[libcamera-devel] [PATCH v6 0/7] libcamera: Allow for user-friendly\n\tnames in",
        "X-BeenThere": "libcamera-devel@lists.libcamera.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "<libcamera-devel.lists.libcamera.org>",
        "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>",
        "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>",
        "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>",
        "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>",
        "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "base64",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "Hello,\n\nThis series trues to advance the topic of user-friendly names in\napplications.\n\nPatch 1/7 adds a new camera property 'Model' that may be used to record\na cameras model. Patch 2/7, 3/7, 4/7 and 5/7 then implements this new\nproperty for all pipeline handlers.\n\nPatch 6/7 introduce user-friendly names to the cam utility.\n\nThe final patch 7/7 records the model information in the DNG files\ncreated by qcam. More work is needed on top of this series to create\nuser-friendly names for qcam. My intention is to do this in a follow up\nseries once this is merged as I fear some bikeshedding on the style of\nthe user-friendly name so lets battle that out in cam first :-)\n\nExample of listing cameras with and without this series,\n\nWithout:\n    $ cam -l\n    Available cameras:\n    1: \\_SB_.PCI0.RP05.PXSX-2.4:1.0-046d:0843\n    2: platform/vimc.0 Sensor B\n\n    $ cam -l\n    Available cameras:\n    1: /base/i2c@ff160000/camera@36\n    2: /base/i2c@ff160000/camera@3c\n\n    $ cam -l\n    Available cameras:\n    1: /base/soc/i2c0mux/i2c@1/imx219@10\n\n    $ cam -l\n    Available cameras:\n    1: \\_SB_.PCI0.I2C2.CAM0\n    2: \\_SB_.PCI0.I2C4.CAM1\n\n\nWith:\n    $ cam -l\n    Available cameras:\n    1: External camera 'Logitech Webcam C930e' (\\_SB_.PCI0.RP05.PXSX-2.4:1.0-046d:0843)\n    2: Internal front camera (platform/vimc.0 Sensor B)\n\n    $ cam -l\n    Available cameras:\n    1: Internal front camera (/base/i2c@ff160000/camera@36)\n    2: Internal front camera (/base/i2c@ff160000/camera@3c)\n\n    $ cam -l\n    Available cameras:\n    1: Internal front camera (/base/soc/i2c0mux/i2c@1/imx219@10)\n\n    $ cam -l\n    Available cameras:\n    1: Internal front camera (\\_SB_.PCI0.I2C2.CAM0)\n    2: Internal front camera (\\_SB_.PCI0.I2C4.CAM1)\n\nIt can be observed above that all Cameras that report an internal \nlocation do so by stating they face the front. We know this is not true \nfor some cameras. This is however not a fault of this series as it only \nprints what is reported by the Camera. Once we teach the Camera to \nreport true values for these properties cam will print the correct \ninformation.\n\nNiklas Söderlund (7):\n  libcamera: properties: Add model property\n  libcamera: utils: Add method to remove non-ASCII characters\n  libcamera: camera_sensor: Set sensor model property\n  libcamera: pipeline: uvcvideo: Initialize CameraData from MediaDevice\n  libcamera: pipeline: uvcvideo: Set sensor model property\n  cam: Print user-friendly camera names\n  qcam: dng_writer: Record camera model\n\n include/libcamera/internal/utils.h           |  2 ++\n src/cam/main.cpp                             | 28 +++++++++++++++++-\n src/libcamera/camera_sensor.cpp              |  2 ++\n src/libcamera/pipeline/uvcvideo/uvcvideo.cpp | 31 ++++++++++----------\n src/libcamera/property_ids.yaml              | 23 +++++++++++++++\n src/libcamera/utils.cpp                      | 17 +++++++++++\n src/qcam/dng_writer.cpp                      | 13 ++++++--\n 7 files changed, 97 insertions(+), 19 deletions(-)\n\n--\n2.28.0"
}