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 98DEA10E255 for ; Tue, 15 Aug 2023 16:56:34 +0000 (UTC) From: Bhanuprakash Modem To: igt-dev@lists.freedesktop.org Date: Tue, 15 Aug 2023 22:17:20 +0530 Message-Id: <20230815164815.320904-27-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 26/81] tests/i915/kms_psr: Document each subtest for testplan List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Kunal Joshi 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: - Add missing "Driver requirement" field V3: - Driver requirement: s/any/i915, xe/ - Fix run type Signed-off-by: Bhanuprakash Modem Reviewed-by: Kunal Joshi --- tests/i915/kms_psr.c | 219 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 215 insertions(+), 4 deletions(-) diff --git a/tests/i915/kms_psr.c b/tests/i915/kms_psr.c index 57a749ffb..9e0e5c4a0 100644 --- a/tests/i915/kms_psr.c +++ b/tests/i915/kms_psr.c @@ -23,8 +23,9 @@ */ /** - * TEST: Tests behaviour of PSR & PSR2 + * TEST: kms psr * Category: Display + * Description: Tests behaviour of PSR & PSR2 */ #include "igt.h" @@ -37,6 +38,213 @@ #include "xe/xe_ioctl.h" #include "xe/xe_query.h" +/** + * SUBTEST: basic + * Description: Basic check for psr if it is detecting changes made in planes + * Driver requirement: i915, xe + * Functionality: psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: %s_%s + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on %arg[1] + * Driver requirement: i915 + * Functionality: kms_core, plane, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @cursor: Cursor plane + * @primary: Primary plane + * @sprite: Sprite plane + * + * arg[2]: + * + * @mmap_cpu: MMAP CPU + * @mmap_gtt: MMAP GTT + */ + +/** + * SUBTEST: sprite_plane_move + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on sprite planes + * Driver requirement: i915, xe + * Functionality: plane, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: %s_%s + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on %arg[1] planes + * Driver requirement: i915, xe + * Functionality: kms_core, plane, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @cursor: Cursor plane + * @sprite: Sprite plane + * + * arg[2]: + * + * @blt: Blitter + * @render: Render + * @plane_onoff: Plane On off + */ + +/** + * SUBTEST: primary_%s + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on %arg[1] planes + * Driver requirement: i915, xe + * Functionality: kms_core, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @blt: Blitter + * @render: Render + */ + +/** + * SUBTEST: dpms + * Description: Check if psr is detecting changes when rendering operation is + * performed with dpms enabled or disabled + * Driver requirement: i915, xe + * Functionality: dpms, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: no_drrs + * Description: Check if psr is detecting changes when drrs is disabled + * Driver requirement: i915, xe + * Functionality: drrs, psr + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: suspend + * Description: Check if psr is detecting changes when plane operation + * is performed with suspend resume cycles + * Driver requirement: i915, xe + * Functionality: psr, suspend + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_dpms + * Description: Check if psr is detecting changes when rendering operation + * is performed with dpms enabled or disabled + * Driver requirement: i915, xe + * Functionality: dpms, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_no_drrs + * Description: Check if psr is detecting changes when drrs is disabled + * Driver requirement: i915, xe + * Functionality: drrs, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_suspend + * Description: Check if psr is detecting changes when plane operation is + * performed with suspend resume cycles + * Driver requirement: i915, xe + * Functionality: psr, psr2, suspend + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_basic + * Description: Basic check for psr if it is detecting changes made in planes + * Driver requirement: i915, xe + * Functionality: psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_%s_%s + * Description: Check if psr2 is detecting memory mapping, rendering and plane + * operations performed on %arg[1] planes + * Driver requirement: i915 + * Functionality: kms_core, plane, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @cursor: Cursor plane + * @primary: Primary plane + * @sprite: Sprite plane + * + * arg[2]: + * + * @mmap_cpu: MMAP CPU + * @mmap_gtt: MMAP GTT + */ + +/** + * SUBTEST: psr2_primary_page_flip + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on primary planes + * Driver requirement: i915, xe + * Functionality: plane, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: psr2_primary_%s + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on primary planes + * Driver requirement: i915, xe + * Functionality: kms_core, plane, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @blt: Blitter + * @render: Render + */ + +/** + * SUBTEST: psr2_%s_%s + * Description: Check if psr is detecting memory mapping, rendering and plane + * operations performed on %arg[1] planes + * Driver requirement: i915, xe + * Functionality: kms_core, plane, psr, psr2 + * Mega feature: PSR + * Run type: FULL + * Test category: functionality test + * + * arg[1]: + * + * @cursor: Cursor plane + * @sprite: Sprite plane + * + * arg[2]: + * + * @blt: Blitter + * @render: Render + * @plane_onoff: Plane On off + * @plane_move: Move plane position + */ + enum operations { PAGE_FLIP, MMAP_GTT, @@ -313,24 +521,27 @@ static void fb_dirty_fb_ioctl(data_t *data, struct igt_fb *fb) * SUBTEST: cursor_plane_move * Description: Check if psr is detecting the plane operations performed on * cursor planes + * Driver requirement: i915, xe * Test category: functionality test - * Run type: BAT + * Run type: BAT, FULL * Functionality: psr * Mega feature: PSR * * SUBTEST: primary_page_flip * Description: Check if psr is detecting page-flipping operations performed * on primary planes + * Driver requirement: i915, xe * Test category: functionality test - * Run type: BAT + * Run type: BAT, FULL * Functionality: psr * Mega feature: PSR * * SUBTEST: sprite_plane_onoff * Description: Check if psr is detecting the plane operations performed on * sprite planes + * Driver requirement: i915, xe * Test category: functionality test - * Run type: BAT + * Run type: BAT, FULL * Functionality: psr * Mega feature: PSR */ -- 2.40.0