{"id":15300,"url":"https://patchwork.libcamera.org/api/patches/15300/?format=json","web_url":"https://patchwork.libcamera.org/patch/15300/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","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=json","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=json","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":"","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 ;\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 ;\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 ;\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 ","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":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Cc":"sakari.ailus@linux.intel.com","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"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 \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"]}