[igt-dev] [V5 i-g-t 65/81] tests/kms_prime: Document each subtest for testplan

[Karthik B S]

On 6/29/2023 8:18 PM, Bhanuprakash Modem wrote:
> Add documentation for all kms tests which is used by IGT testplan
> documentation.
>
> Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
Reviewed-by: Karthik B S <karthik.b.s at intel.com>
> ---
>   tests/kms_prime.c | 35 +++++++++++++++++++++++++++++++++++
>   1 file changed, 35 insertions(+)
>
> diff --git a/tests/kms_prime.c b/tests/kms_prime.c
> index 52f587961..3e46aafb9 100644
> --- a/tests/kms_prime.c
> +++ b/tests/kms_prime.c
> @@ -30,6 +30,41 @@
>   #include <sys/ioctl.h>
>   #include <sys/poll.h>
>   #include <time.h>
> +/**
> + * TEST: kms prime
> + * Category: Display
> + * Description: Prime tests, focusing on KMS side
> + *
> + * SUBTEST: D3hot
> + * Description: Validate pci state of dGPU when dGPU is idle and  scanout is on iGPU
> + * Driver requirement: any
> + * Functionality: kms_gem_interop
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: basic-modeset-hybrid
> + * Description: Basic modeset on the one device when the other device is active
> + * Driver requirement: any
> + * Functionality: kms_gem_interop
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: basic-crc-%s
> + * Description: Make a dumb color buffer, export to another device and compare
> + *              the CRCs with a buffer native to that device
> + * Driver requirement: any
> + * Functionality: kms_gem_interop
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @hybrid:
> + * @vgem:
> + */
>   
>   #define KMS_HELPER "/sys/module/drm_kms_helper/parameters/"
>   #define KMS_POLL_DISABLE 0