From nobody Mon Feb 9 02:51:09 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8725625C6FE; Thu, 6 Mar 2025 17:17:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741281452; cv=none; b=pcyrnHRosa89bM1HLdn3nY0+xL7r+BRL/NwEGbT6OrALn3f3RG6DMJCgAxyhGKluJk5MN5XummHISGrVy/Wednb/Lh8BdFpR89hCX7aIGsqb8oGgHrPtzo5TCuvmzED6wGy3ciPMHC40HXfVC5p1AXDDCqrJTKcLTayGw/xm++Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741281452; c=relaxed/simple; bh=9fO76bprPjWuuL9pZdTAwx8iTUWcSZCDN3mx1NcNL5E=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=ujbOL+c8Wrx0Ito8tHtvWji7bI8cZMOg2nM6df6SS4PC4cOoHZpouSymvQtIntgU/rDdiLjCg2WWdWWGuNuF6EuliUQk4INkH5gb/p60yqZKA+/Gd4ULRjRFSvhLJE1UeyBD3YWajMIxtJbTOcgG77XTxwm6GUjRmREfhIS0NMw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=SBfuHdzU; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="SBfuHdzU" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9FAF7C4CEE9; Thu, 6 Mar 2025 17:17:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741281452; bh=9fO76bprPjWuuL9pZdTAwx8iTUWcSZCDN3mx1NcNL5E=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=SBfuHdzUdYUucdQq7c27ee46MEDjJyDC3Fe8rSiAvuBKtomZrH4yO6KdHupbItUo7 LQAz8BMp52y/FalT9UKZAW51gNpJHKofTUaMZeEwf2AxLgsRFkeFfgLAUF9XbFANqN Oa1rGvSyMvKA4s2qfsbJ5ZNAQNxyfOShXrjc7OwBScx+7wYN0eNuIe62UHuZZGot0L uWmFdz449BxQ9VbfGcFkXejkO96I9OpMVBRJHjdSR+6C9FfR21cPbzEZptFigqtjTe 498jl68B45L1/DeCkoIKjb3YMNYisDFLvVDkvR74KUwprN9TpKxGAEJtIfo2YlH8Bh WftsJ5H+CcH8A== From: Maxime Ripard Date: Thu, 06 Mar 2025 18:17:23 +0100 Subject: [PATCH 1/2] drm/display: hdmi: Create documentation section Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250306-drm-hdmi-state-docs-v1-1-56a19d3805a1@kernel.org> References: <20250306-drm-hdmi-state-docs-v1-0-56a19d3805a1@kernel.org> In-Reply-To: <20250306-drm-hdmi-state-docs-v1-0-56a19d3805a1@kernel.org> To: David Airlie , Simona Vetter , Maarten Lankhorst , Thomas Zimmermann , Jonathan Corbet Cc: dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Maxime Ripard X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2555; i=mripard@kernel.org; h=from:subject:message-id; bh=9fO76bprPjWuuL9pZdTAwx8iTUWcSZCDN3mx1NcNL5E=; b=owGbwMvMwCX2+D1vfrpE4FHG02pJDOknbyzln+7At1nMN7OzzMGi79SNqN6Zs95ckP9q/uHiT 5+MBb87O0pZGMS4GGTFFFlihM2XxJ2a9bqTjW8ezBxWJpAhDFycAjCRBacYGU7ddzlXz6xt3V16 VnPG6v4unqpSPaMT+6ZcS1yt/kpW5ikjw5s2X9XI08YuM1ZUXI5OO9See+/h0z9rOD5r51pM+7k ogR0A X-Developer-Key: i=mripard@kernel.org; a=openpgp; fpr=BE5675C37E818C8B5764241C254BCFC56BF6CE8D We have had documentation for the public functions in the HDMI helpers, but those were never referenced anywhere and thus not compiled as part of the doc. Let's add a section. Signed-off-by: Maxime Ripard --- Documentation/gpu/drm-kms-helpers.rst | 15 +++++++++++++++ drivers/gpu/drm/display/drm_hdmi_state_helper.c | 21 +++++++++++++++++++++ 2 files changed, 36 insertions(+) diff --git a/Documentation/gpu/drm-kms-helpers.rst b/Documentation/gpu/drm-= kms-helpers.rst index b4ee25af1702b0019e0de5f9ee66d2dbdac2c664..5139705089f200b189876a5a61b= f2a935cec433a 100644 --- a/Documentation/gpu/drm-kms-helpers.rst +++ b/Documentation/gpu/drm-kms-helpers.rst @@ -231,10 +231,25 @@ Panel Self Refresh Helper Reference :doc: overview =20 .. kernel-doc:: drivers/gpu/drm/drm_self_refresh_helper.c :export: =20 +HDMI Atomic State Helpers +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D + +Overview +-------- + +.. kernel-doc:: drivers/gpu/drm/display/drm_hdmi_state_helper.c + :doc: hdmi helpers + +Functions Reference +------------------- + +.. kernel-doc:: drivers/gpu/drm/display/drm_hdmi_state_helper.c + :export: + HDCP Helper Functions Reference =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D =20 .. kernel-doc:: drivers/gpu/drm/display/drm_hdcp_helper.c :export: diff --git a/drivers/gpu/drm/display/drm_hdmi_state_helper.c b/drivers/gpu/= drm/display/drm_hdmi_state_helper.c index 9b2ee2385634303ab84bdd3a457770cfe32647cf..24bfc82bf9b02bf3201d97432e3= c239ccc8714b4 100644 --- a/drivers/gpu/drm/display/drm_hdmi_state_helper.c +++ b/drivers/gpu/drm/display/drm_hdmi_state_helper.c @@ -7,10 +7,31 @@ =20 #include #include #include =20 +/** + * DOC: hdmi helpers + * + * These functions contain an implementation of the HDMI specification + * in the form of KMS helpers. + * + * It contains TMDS character rate computation, automatic selection of + * output formats, infoframes generation, etc. + * + * Testing + * ~~~~~~~ + * + * The helpers have unit testing and can be tested using kunit with: + * + * .. code-block:: bash + * + * $ ./tools/testing/kunit/kunit.py run \ + * --kunitconfig=3Ddrivers/gpu/drm/tests \ + * drm_atomic_helper_connector_hdmi_* + */ + /** * __drm_atomic_helper_connector_hdmi_reset() - Initializes all HDMI @drm_= connector_state resources * @connector: DRM connector * @new_conn_state: connector state to reset * --=20 2.48.1