From patchwork Sun Jan 30 23:58:18 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Scally X-Patchwork-Id: 15300 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 18780BDCBF for ; Sun, 30 Jan 2022 23:59:13 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id F2D63609EA; Mon, 31 Jan 2022 00:59:11 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="GSmf0mux"; dkim-atps=neutral Received: from mail-wm1-x333.google.com (mail-wm1-x333.google.com [IPv6:2a00:1450:4864:20::333]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 0F85B60986 for ; Mon, 31 Jan 2022 00:59:09 +0100 (CET) Received: by mail-wm1-x333.google.com with SMTP id j5-20020a05600c1c0500b0034d2e956aadso8190591wms.4 for ; Sun, 30 Jan 2022 15:59:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=; b=GSmf0muxy9deZ2hL+lVMfPRZ9wWaJDwAM7NcmHet2TImu1Y0ImdwB2qX6il+G6+C0c PpRMV1do1RnOhkTF3hrOv9nIButtvsI8m1zzvHOV7RBrF82gobVzP54IJZhozx+jicfn hI0TBoNdxjGJJqwWXaXzcfQqDgtCprqNho6Ji5tq5os2OSnuJRN8L0Uwfmcz3L6c5Ual 5xZiRSTt5N2tY70ns5rHK2rfWUPusuQQZsV6di6c2gsx+gd9k6w0hfALtw+VshGFm4NJ KixHFg5VUCGrHDO9nAClNuLrjzvkVlCxJPhBcimYS8i6FT6ZCSHghFWMtw9hMBrbEGlO ayEQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=; b=rzq50ih+KYutwnuLrvfQNDKnA0ZPqF74xxnP1uIFQCqCHJlMWMQKf6pfD6Lom/PR5l XV2OV4/qW/3+QhH58DKl7x0d1H/dx5mYkVVhdnACnSU3hSdKs6cdrvg2iXss4VqHJL4x oj6e6TMSDoGnX10jH8ILaFSj9xSQzGFb6QuFY5AxvjnMwO8ypcaeahxTZXi6s314EeW4 /saf+NqUfFgAzHsuHM09GXXaZyb4oKAn2jkXhIPMOyQjOqlk4NLnO4v/ddr6foy//OgV sYVu4CsJV6krSM4sCSn3V8nHb97/QiPAN2a1qz6myLDYAin/ZwGolZsdzQVADPwKfU+E iw/A== X-Gm-Message-State: AOAM531FbDcpCp6eWZLjb0C6/wmIbg5Z0lWH5mLBarctIglcGR92/BBA Wsu5HiI5wK8vpN64hQ+u21I= X-Google-Smtp-Source: ABdhPJzSV5eAjHoUiE6Tb04AF1J4I8wvc/pfMPqepm8Ru1a3nU6DkeuKalY3PAG2cPf8E1daEETexA== X-Received: by 2002:a7b:cbda:: with SMTP id n26mr25225403wmi.76.1643587148829; Sun, 30 Jan 2022 15:59:08 -0800 (PST) Received: from localhost.localdomain (cpc141996-chfd3-2-0-cust928.12-3.cable.virginm.net. [86.13.91.161]) by smtp.gmail.com with ESMTPSA id 11sm11993663wrb.30.2022.01.30.15.59.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 30 Jan 2022 15:59:08 -0800 (PST) From: Daniel Scally To: linux-media@vger.kernel.org, libcamera-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 Subject: [libcamera-devel] [PATCH v2 3/6] media: docs: Add entries documenting ancillary links X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: sakari.ailus@linux.intel.com Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" Add some elements to the uAPI documentation to explain the new link type, their purpose and some aspects of their current implementation. Signed-off-by: Daniel Scally --- Changes since v1: - New patch .../media/mediactl/media-controller-model.rst | 6 ++++++ .../userspace-api/media/mediactl/media-types.rst | 9 ++++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/Documentation/userspace-api/media/mediactl/media-controller-model.rst b/Documentation/userspace-api/media/mediactl/media-controller-model.rst index 222cb99debb5..f77cb9d952e5 100644 --- a/Documentation/userspace-api/media/mediactl/media-controller-model.rst +++ b/Documentation/userspace-api/media/mediactl/media-controller-model.rst @@ -33,3 +33,9 @@ are: - An **interface link** is a point-to-point bidirectional control connection between a Linux Kernel interface and an entity. + +- An **ancillary link** is a point-to-point connection describing a physical + relationship between two entities. For example this could represent the + fact that a particular camera sensor and lens controller form a single + physical module, meaning this lens controller drives the lens for this + camera sensor. \ No newline at end of file diff --git a/Documentation/userspace-api/media/mediactl/media-types.rst b/Documentation/userspace-api/media/mediactl/media-types.rst index 0a26397bd01d..d69bae359e5b 100644 --- a/Documentation/userspace-api/media/mediactl/media-types.rst +++ b/Documentation/userspace-api/media/mediactl/media-types.rst @@ -413,7 +413,7 @@ must be set for every pad. * - ``MEDIA_LNK_FL_LINK_TYPE`` - This is a bitmask that defines the type of the link. Currently, - two types of links are supported: + three types of links are supported: .. _MEDIA-LNK-FL-DATA-LINK: @@ -423,3 +423,10 @@ must be set for every pad. ``MEDIA_LNK_FL_INTERFACE_LINK`` if the link is between an interface and an entity + + .. _MEDIA-LNK-FL-ANCILLARY-LINK: + + ``MEDIA_LNK_FL_ANCILLARY_LINK`` if the link is between two + different entities. This at present implies both MEDIA_LNK_FL_ENABLED + and MEDIA_LNK_FL_IMMUTABLE, however applications should not rely on + that being the case in the future.