[igt-dev] [i-g-t V7 72/81] tests/kms_setmode: Document each subtest for testplan

[B, Jeevan]

> -----Original Message-----
> From: Modem, Bhanuprakash <bhanuprakash.modem at intel.com>
> Sent: Tuesday, August 15, 2023 10:18 PM
> To: igt-dev at lists.freedesktop.org
> Cc: Modem, Bhanuprakash <bhanuprakash.modem at intel.com>; B, Jeevan
> <jeevan.b at intel.com>; B S, Karthik <karthik.b.s at intel.com>
> Subject: [i-g-t V7 72/81] tests/kms_setmode: Document each subtest for
> testplan
> 
> 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 <jeevan.b at intel.com>
> Cc: Karthik B S <karthik.b.s at intel.com>
> Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
LGTM.
Reviewed-by: Jeevan B <jeevan.b at intel.com>
> ---
>  tests/kms_setmode.c | 60
> +++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 60 insertions(+)
> 
> diff --git a/tests/kms_setmode.c b/tests/kms_setmode.c index
> 035bbd0b0..e32c53480 100644
> --- a/tests/kms_setmode.c
> +++ b/tests/kms_setmode.c
> @@ -31,6 +31,66 @@
>  #include <sys/time.h>
>  #include <math.h>
>  #include "xe/xe_query.h"
> +/**
> + * TEST: kms setmode
> + * Category: Display
> + * Description: Tests the mode by iterating through all valid/invalid
> crtc/connector
> + *              combinations
> + *
> + * SUBTEST: basic
> + * Description: Tests the vblank timing by iterating through all valid
> crtc/connector
> + *              combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core, vblank
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: basic-clone-single-crtc
> + * Description: Tests the mode by cloning the single crtc by iterating through
> all
> + *              valid crtc/connector combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: clone-exclusive-crtc
> + * Description: Tests the mode by cloning the exclusive crtc by iterating
> through
> + *              all valid crtc/connector combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: invalid-clone-exclusive-crtc
> + * Description: Tests the mode by cloning the exclusive crtc by iterating
> through
> + *              all invalid crtc/connector combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: invalid-clone-single-crtc
> + * Description: Tests the mode by cloning the single crtc by iterating through
> all
> + *              invalid crtc/connector combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: invalid-clone-single-crtc-stealing
> + * Description: Tests the stealing mode by cloning the single crtc by iterating
> + *              through all invalid crtc/connector combinations
> + * Driver requirement: i915, xe
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + */
> 
>  #define MAX_CONNECTORS  10
>  #define MAX_CRTCS       6
> --
> 2.40.0