From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3E9B5C433ED for ; Tue, 11 May 2021 15:55:23 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 74A2061376 for ; Tue, 11 May 2021 15:55:22 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 74A2061376 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=cerno.tech Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 9F6456E56A; Tue, 11 May 2021 15:55:21 +0000 (UTC) Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) by gabe.freedesktop.org (Postfix) with ESMTPS id 22A8D6E56A for ; Tue, 11 May 2021 15:55:20 +0000 (UTC) Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 975995C006E; Tue, 11 May 2021 11:55:18 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Tue, 11 May 2021 11:55:18 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cerno.tech; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=fm2; bh=r6WLtHdZwihxqsEzJImmL1kbKZ vOkaLCou5DDgJ2SpI=; b=ANjNM09ZYCIOrwkmh62CNgjrr65m1uzH7ig8QFBOxw 8joNXb8Vyp6tQLQ5Ajjo/R/vv53ZephaJhHaln/6U5kBUyqYN2s1cS0o2xYYfdcH IKGxuGP2pupwA8eSLH+2a8o/56/e5UjeRkPjDKs3BibXLxZPb1QPANAggilSNw80 dUj4MVBDwi9FYz/TVwpwUkgh4HDaPKuo7tx5BnfvFxUdNP52cuLzm5fNrreUr72W Dg6GJeksIEE23a3NTz80fNZfdDskRnlvnZHFQxoLEv8tqFg22iKcgfARYsSlTFO9 GgREZyFY5Tap2HPK3fVfiuDMDDBub29eP7vBQ/YWW11A== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=r6WLtHdZwihxqsEzJ ImmL1kbKZvOkaLCou5DDgJ2SpI=; b=nDHNgIbLOHmGysLeylsy8fCO3pHW6YGXh AmkumIGw3ATkiEMg9a4g+NU/J/8ysnMV4JQWHESk5l8nzIVnN9Aa53WOemxZUg0u szm6ZHXMLc9zjMdX4V7Fx5I2yjXRQVubTOmJqj2b0ACJa1QP7y+kXWXqWM+JNxRR SyWbN83YYd5H2HHzBAUpszPDE1GDL+AZPDnEBqLiEjgNqA2J4WHtOoynlbm0ogjb tvxtCJIRvjy+5ITz2DiehNInwrF29k9VhCVieGN/Fbvlx9yvLPY5hDhKnEVxsHd5 UxomN6rkmol9fIoVtRQeH+MlQtgcl9QB3QMg0nUdAGj9TNhkbO0Yw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduledrvdehtddgleeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffoggfgsedtkeertdertddtnecuhfhrohhmpeforgigihhmvgcu tfhiphgrrhguuceomhgrgihimhgvsegtvghrnhhordhtvggthheqnecuggftrfgrthhtvg hrnhepjeffheduvddvvdelhfegleelfffgieejvdehgfeijedtieeuteejteefueekjeeg necukfhppeeltddrkeelrdeikedrjeeinecuvehluhhsthgvrhfuihiivgeptdenucfrrg hrrghmpehmrghilhhfrhhomhepmhgrgihimhgvsegtvghrnhhordhtvggthh X-ME-Proxy: Received: from localhost (lfbn-tou-1-1502-76.w90-89.abo.wanadoo.fr [90.89.68.76]) by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 11 May 2021 11:55:15 -0400 (EDT) From: Maxime Ripard To: dri-devel@lists.freedesktop.org, Daniel Vetter , David Airlie , Maarten Lankhorst , Thomas Zimmermann , Maxime Ripard Subject: [PATCH] Documentation: gpu: Mention the requirements for new properties Date: Tue, 11 May 2021 17:55:12 +0200 Message-Id: <20210511155512.582798-1-maxime@cerno.tech> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" New KMS properties come with a bunch of requirements to avoid each driver from running their own, inconsistent, set of properties, eventually leading to issues like property conflicts, inconsistencies between drivers and semantics, etc. Let's document what we expect. Signed-off-by: Maxime Ripard --- Documentation/gpu/drm-kms.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Documentation/gpu/drm-kms.rst b/Documentation/gpu/drm-kms.rst index 87e5023e3f55..30f4c376f419 100644 --- a/Documentation/gpu/drm-kms.rst +++ b/Documentation/gpu/drm-kms.rst @@ -463,6 +463,24 @@ KMS Properties This section of the documentation is primarily aimed at user-space developers. For the driver APIs, see the other sections. +Requirements +------------ + +KMS drivers might need to add extra properties to support new features. +Each new property introduced in a driver need to meet a few +requirements, in addition to the one mentioned above.: + +- It must be standardized, with some documentation to describe the + property can be used. + +- It must provide a generic helper in the core code to register that + property on the object it attaches to. + +- Its content must be decoded by the core and provided in the object + associated state structure. + +- An IGT test must be submitted. + Property Types and Blob Property Support ---------------------------------------- -- 2.31.1