diff options
author | Bhanuprakash Modem <bhanuprakash.modem@intel.com> | 2023-08-16 18:07:12 +0530 |
---|---|---|
committer | Bhanuprakash Modem <bhanuprakash.modem@intel.com> | 2023-08-16 21:29:23 +0530 |
commit | d85a723f22e3a2137a6bbba8f02e06bd36024cc3 (patch) | |
tree | a3ee3d8fd742edc3426535a9da8107938a127dd7 | |
parent | fe2dabdbca2c4cb33baf68c142f786ab749cd338 (diff) |
tests/kms_vblank: Document each subtest for testplan
Add documentation for all kms tests which is used by IGT testplan
documentation.
V2: - Fix test documentation
V3: - Driver requirement: s/any/i915, xe/
V4: - Fix test documentation
Cc: Karthik B S <karthik.b.s@intel.com>
Cc: Swati Sharma <swati2.sharma@intel.com>
Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem@intel.com>
Reviewed-by: Swati Sharma <swati2.sharma@intel.com>
-rw-r--r-- | tests/kms_vblank.c | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/tests/kms_vblank.c b/tests/kms_vblank.c index 1aa8c1083..0cc21bb5f 100644 --- a/tests/kms_vblank.c +++ b/tests/kms_vblank.c @@ -40,6 +40,166 @@ #include <sys/wait.h> #include <drm.h> +/** + * 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: i915, xe + * Functionality: vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: invalid + * Description: Negative test for vblank request + * Driver requirement: i915, xe + * Functionality: vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + */ + +/** + * SUBTEST: pipe-%s-ts-continuation-dpms-rpm + * Description: Test TS continuty with DPMS & RPM while hanging by introducing + * NOHANG flag on %arg[1] + * Driver requirement: i915, xe + * 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: Test TS continuty with DPMS & Suspend while hanging by introducing + * NOHANG flag on %arg[1] + * Driver requirement: i915, xe + * 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: Test TS continuty with Suspend while hanging by introducing NOHANG + * flag on %arg[1] + * Driver requirement: i915, xe + * 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: Test TS continuty during Modeset with Suspend while hanging by + * introducing NOHANG flag on %arg[1] + * Driver requirement: i915, xe + * 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-accuracy-idle + * Description: Test Accuracy of vblank events while hanging by introducing NOHANG + * flag on %arg[1] + * Driver requirement: i915, xe + * Functionality: hang, vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: pipe-%s-%s + * Description: Test %arg[2] while hanging by introducing NOHANG flag on %arg[1] + * Driver requirement: i915, xe + * Functionality: hang, vblank + * Mega feature: General Display Features + * Run type: FULL + * Test category: functionality test + * + * SUBTEST: pipe-%s-%s-hang + * Description: Test %arg[2] with injected hang is working properly on %arg[1] + * Driver requirement: i915, xe + * 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: Time taken to Query vblank counters + * @query-forked: Time taken to Query vblank counters (multithreaded) + * @query-busy: Time taken to Query vblank counters (during V-active) + * @query-forked-busy: Time taken to Query vblank counters (during V-active mutithreaded) + * @wait-idle: Time taken to wait for vblanks + * @wait-forked: Time taken to wait for vblanks (multithreaded) + * @wait-busy: Time taken to wait for vblanks (during V-active) + * @wait-forked-busy: Time taken to wait for vblanks (during V-active mutithreaded) + * @ts-continuation-idle: TS continuty + * @ts-continuation-modeset: TS continuty during modeset + */ IGT_TEST_DESCRIPTION("Test speed of WaitVblank."); |