Patch Detail
Show a patch.
GET /api/patches/15300/?format=api
{ "id": 15300, "url": "https://patchwork.libcamera.org/api/patches/15300/?format=api", "web_url": "https://patchwork.libcamera.org/patch/15300/", "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": "<20220130235821.48076-4-djrscally@gmail.com>", "date": "2022-01-30T23:58:18", "name": "[libcamera-devel,v2,3/6] media: docs: Add entries documenting ancillary links", "commit_ref": null, "pull_url": null, "state": "not-applicable", "archived": false, "hash": "2c43bea7c91d7e5cf383bcdc5dab434330cdafd6", "submitter": { "id": 90, "url": "https://patchwork.libcamera.org/api/people/90/?format=api", "name": "Daniel Scally", "email": "djrscally@gmail.com" }, "delegate": null, "mbox": "https://patchwork.libcamera.org/patch/15300/mbox/", "series": [ { "id": 2904, "url": "https://patchwork.libcamera.org/api/series/2904/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=2904", "date": "2022-01-30T23:58:15", "name": "Introduce ancillary links", "version": 2, "mbox": "https://patchwork.libcamera.org/series/2904/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/15300/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/15300/checks/", "tags": {}, "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 18780BDCBF\n\tfor <parsemail@patchwork.libcamera.org>;\n\tSun, 30 Jan 2022 23:59:13 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id F2D63609EA;\n\tMon, 31 Jan 2022 00:59:11 +0100 (CET)", "from mail-wm1-x333.google.com (mail-wm1-x333.google.com\n\t[IPv6:2a00:1450:4864:20::333])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 0F85B60986\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 31 Jan 2022 00:59:09 +0100 (CET)", "by mail-wm1-x333.google.com with SMTP id\n\tj5-20020a05600c1c0500b0034d2e956aadso8190591wms.4\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tSun, 30 Jan 2022 15:59:09 -0800 (PST)", "from localhost.localdomain\n\t(cpc141996-chfd3-2-0-cust928.12-3.cable.virginm.net. [86.13.91.161])\n\tby smtp.gmail.com with ESMTPSA id\n\t11sm11993663wrb.30.2022.01.30.15.59.08\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tSun, 30 Jan 2022 15:59:08 -0800 (PST)" ], "Authentication-Results": "lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=gmail.com header.i=@gmail.com\n\theader.b=\"GSmf0mux\"; dkim-atps=neutral", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=;\n\tb=GSmf0muxy9deZ2hL+lVMfPRZ9wWaJDwAM7NcmHet2TImu1Y0ImdwB2qX6il+G6+C0c\n\tPpRMV1do1RnOhkTF3hrOv9nIButtvsI8m1zzvHOV7RBrF82gobVzP54IJZhozx+jicfn\n\thI0TBoNdxjGJJqwWXaXzcfQqDgtCprqNho6Ji5tq5os2OSnuJRN8L0Uwfmcz3L6c5Ual\n\t5xZiRSTt5N2tY70ns5rHK2rfWUPusuQQZsV6di6c2gsx+gd9k6w0hfALtw+VshGFm4NJ\n\tKixHFg5VUCGrHDO9nAClNuLrjzvkVlCxJPhBcimYS8i6FT6ZCSHghFWMtw9hMBrbEGlO\n\tayEQ==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20210112;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:mime-version:content-transfer-encoding;\n\tbh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=;\n\tb=rzq50ih+KYutwnuLrvfQNDKnA0ZPqF74xxnP1uIFQCqCHJlMWMQKf6pfD6Lom/PR5l\n\tXV2OV4/qW/3+QhH58DKl7x0d1H/dx5mYkVVhdnACnSU3hSdKs6cdrvg2iXss4VqHJL4x\n\toj6e6TMSDoGnX10jH8ILaFSj9xSQzGFb6QuFY5AxvjnMwO8ypcaeahxTZXi6s314EeW4\n\t/saf+NqUfFgAzHsuHM09GXXaZyb4oKAn2jkXhIPMOyQjOqlk4NLnO4v/ddr6foy//OgV\n\tsYVu4CsJV6krSM4sCSn3V8nHb97/QiPAN2a1qz6myLDYAin/ZwGolZsdzQVADPwKfU+E\n\tiw/A==", "X-Gm-Message-State": "AOAM531FbDcpCp6eWZLjb0C6/wmIbg5Z0lWH5mLBarctIglcGR92/BBA\n\tWsu5HiI5wK8vpN64hQ+u21I=", "X-Google-Smtp-Source": "ABdhPJzSV5eAjHoUiE6Tb04AF1J4I8wvc/pfMPqepm8Ru1a3nU6DkeuKalY3PAG2cPf8E1daEETexA==", "X-Received": "by 2002:a7b:cbda:: with SMTP id\n\tn26mr25225403wmi.76.1643587148829; \n\tSun, 30 Jan 2022 15:59:08 -0800 (PST)", "From": "Daniel Scally <djrscally@gmail.com>", "To": "linux-media@vger.kernel.org,\n\tlibcamera-devel@lists.libcamera.org", "Date": "Sun, 30 Jan 2022 23:58:18 +0000", "Message-Id": "<20220130235821.48076-4-djrscally@gmail.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220130235821.48076-1-djrscally@gmail.com>", "References": "<20220130235821.48076-1-djrscally@gmail.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[libcamera-devel] [PATCH v2 3/6] media: docs: Add entries\n\tdocumenting ancillary links", "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>", "Cc": "sakari.ailus@linux.intel.com", "Errors-To": "libcamera-devel-bounces@lists.libcamera.org", "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>" }, "content": "Add some elements to the uAPI documentation to explain the new link\ntype, their purpose and some aspects of their current implementation.\n\nSigned-off-by: Daniel Scally <djrscally@gmail.com>\n---\nChanges since v1:\n\n\t- New patch\n\n .../media/mediactl/media-controller-model.rst | 6 ++++++\n .../userspace-api/media/mediactl/media-types.rst | 9 ++++++++-\n 2 files changed, 14 insertions(+), 1 deletion(-)", "diff": "diff --git a/Documentation/userspace-api/media/mediactl/media-controller-model.rst b/Documentation/userspace-api/media/mediactl/media-controller-model.rst\nindex 222cb99debb5..f77cb9d952e5 100644\n--- a/Documentation/userspace-api/media/mediactl/media-controller-model.rst\n+++ b/Documentation/userspace-api/media/mediactl/media-controller-model.rst\n@@ -33,3 +33,9 @@ are:\n \n - An **interface link** is a point-to-point bidirectional control\n connection between a Linux Kernel interface and an entity.\n+\n+- An **ancillary link** is a point-to-point connection describing a physical\n+ relationship between two entities. For example this could represent the\n+ fact that a particular camera sensor and lens controller form a single\n+ physical module, meaning this lens controller drives the lens for this\n+ camera sensor.\n\\ No newline at end of file\ndiff --git a/Documentation/userspace-api/media/mediactl/media-types.rst b/Documentation/userspace-api/media/mediactl/media-types.rst\nindex 0a26397bd01d..d69bae359e5b 100644\n--- a/Documentation/userspace-api/media/mediactl/media-types.rst\n+++ b/Documentation/userspace-api/media/mediactl/media-types.rst\n@@ -413,7 +413,7 @@ must be set for every pad.\n \n * - ``MEDIA_LNK_FL_LINK_TYPE``\n - This is a bitmask that defines the type of the link. Currently,\n-\t two types of links are supported:\n+\t three types of links are supported:\n \n \t .. _MEDIA-LNK-FL-DATA-LINK:\n \n@@ -423,3 +423,10 @@ must be set for every pad.\n \n \t ``MEDIA_LNK_FL_INTERFACE_LINK`` if the link is between an\n \t interface and an entity\n+\n+\t .. _MEDIA-LNK-FL-ANCILLARY-LINK:\n+\n+\t ``MEDIA_LNK_FL_ANCILLARY_LINK`` if the link is between two\n+\t different entities. This at present implies both MEDIA_LNK_FL_ENABLED\n+\t and MEDIA_LNK_FL_IMMUTABLE, however applications should not rely on\n+\t that being the case in the future.\n", "prefixes": [ "libcamera-devel", "v2", "3/6" ] }