From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.115]) by gabe.freedesktop.org (Postfix) with ESMTPS id C405510E257 for ; Tue, 15 Aug 2023 16:57:58 +0000 (UTC) From: Bhanuprakash Modem To: igt-dev@lists.freedesktop.org Date: Tue, 15 Aug 2023 22:18:10 +0530 Message-Id: <20230815164815.320904-77-bhanuprakash.modem@intel.com> In-Reply-To: <20230815164815.320904-1-bhanuprakash.modem@intel.com> References: <20230815164815.320904-1-bhanuprakash.modem@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [igt-dev] [i-g-t V7 76/81] tests/kms_universal_plane: Document each subtest for testplan List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: igt-dev-bounces@lists.freedesktop.org Sender: "igt-dev" List-ID: Add documentation for all kms tests which is used by IGT testplan documentation. V2: - Fix test description V3: - Driver requirement: s/any/i915, xe/ Cc: Jeevan B Signed-off-by: Bhanuprakash Modem --- tests/kms_universal_plane.c | 68 +++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/tests/kms_universal_plane.c b/tests/kms_universal_plane.c index 957d600f1..09d7a7646 100644 --- a/tests/kms_universal_plane.c +++ b/tests/kms_universal_plane.c @@ -28,6 +28,74 @@ #include #include +/** + * TEST: kms universal plane + * Category: Display + * Description: Check pageflip & modeset on universal plane + * + * SUBTEST: cursor-fb-leak-pipe-%s + * Description: Check for cursor leaks after performing cursor operations on %arg[1] + * Driver requirement: i915, xe + * Functionality: cursor, plane + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: disable-primary-vs-flip-pipe-%s + * Description: Check pageflips while primary plane is disabled before IOCTL or + * between IOCTL and pageflip execution on %arg[1] + * Driver requirement: i915, xe + * Functionality: plane + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: universal-plane-pageflip-windowed-pipe-%s + * Description: Check if pageflip succeeds in windowed setting on %arg[1] + * Driver requirement: i915, xe + * Functionality: plane + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @A: pipe A + * @B: pipe B + * @C: pipe C + * @D: pipe D + * @E: pipe E + * @F: pipe F + * @G: pipe G + * @H: pipe H + */ + +/** + * SUBTEST: universal-plane-pipe-%s-%s + * Description: Check %arg[2] on %arg[1] + * Driver requirement: i915, xe + * Functionality: plane + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @A: pipe A + * @B: pipe B + * @C: pipe C + * @D: pipe D + * @E: pipe E + * @F: pipe F + * @G: pipe G + * @H: pipe H + * + * arg[2]: + * + * @functional: the switching between different primary plane fbs with CRTC off + * @sanity: for scale-up or scale-down using universal plane API without + * covering CRTC + */ typedef struct { int drm_fd; -- 2.40.0