From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.88]) by gabe.freedesktop.org (Postfix) with ESMTPS id B223110E6F5 for ; Fri, 11 Aug 2023 18:56:42 +0000 (UTC) From: Bhanuprakash Modem To: igt-dev@lists.freedesktop.org Date: Sat, 12 Aug 2023 00:16:51 +0530 Message-Id: <20230811184655.157060-78-bhanuprakash.modem@intel.com> In-Reply-To: <20230811184655.157060-1-bhanuprakash.modem@intel.com> References: <20230811184655.157060-1-bhanuprakash.modem@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [igt-dev] [i-g-t V6 77/81] tests/kms_vblank: 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 documentation Cc: Karthik B S Cc: Swati Sharma Signed-off-by: Bhanuprakash Modem --- tests/kms_vblank.c | 174 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 174 insertions(+) diff --git a/tests/kms_vblank.c b/tests/kms_vblank.c index 1aa8c1083..c0cfdaa4f 100644 --- a/tests/kms_vblank.c +++ b/tests/kms_vblank.c @@ -40,6 +40,180 @@ #include #include +/** + * TEST: kms vblank + * Category: Display + * Description: Test speed of WaitVblank. + * + * SUBTEST: crtc-id + * Description: check the Vblank and flip events works with given crtc id + * Driver requirement: any + * Functionality: vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: invalid + * Description: Negative test for vblank request + * Driver requirement: any + * Functionality: vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + */ + +/** + * SUBTEST: pipe-%s-%s + * Description: Check if test run while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: any + * Functionality: hang, vblank + * 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]: + * + * @accuracy-idle: + * @query-idle: + * @query-forked: + * @query-busy: + * @query-forked-busy: + * @wait-idle: + * @wait-forked: + * @wait-busy: + * @wait-forked-busy: + * @ts-continuation-idle: + * @ts-continuation-modeset: + */ + +/** + * SUBTEST: pipe-%s-ts-continuation-dpms-rpm + * Description: Check if test run while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: any + * Functionality: dpms, hang, rpm, vblank + * 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: pipe-%s-ts-continuation-dpms-suspend + * Description: Check if test run while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: any + * Functionality: dpms, hang, suspend, vblank + * 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: pipe-%s-ts-continuation-suspend + * Description: Check if test run while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: any + * Functionality: hang, suspend, vblank + * 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: pipe-%s-ts-continuation-modeset-rpm + * Description: Check if test run while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: any + * Functionality: hang, rpm, vblank + * 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: pipe-%s-%s + * Description: Check if injected hang is working properly on %arg[1] + * Driver requirement: any + * Functionality: hang, vblank + * 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]: + * + * @query-idle-hang: + * @query-forked-hang: + * @query-busy-hang: + * @query-forked-busy-hang: + * @wait-idle-hang: + * @wait-forked-hang: + * @wait-busy-hang: + * @wait-forked-busy-hang: + * @ts-continuation-idle-hang: + * @ts-continuation-modeset-hang: + */ IGT_TEST_DESCRIPTION("Test speed of WaitVblank."); -- 2.40.0