[igt-dev] [i-g-t V4 80/82] tests/kms_writeback: Document each subtest for testplan

[Sharma, Swati2]

On 29-May-23 10:58 AM, 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>
> ---
>   tests/kms_writeback.c | 42 ++++++++++++++++++++++++++++++++++++++++++
>   1 file changed, 42 insertions(+)
> 
> diff --git a/tests/kms_writeback.c b/tests/kms_writeback.c
> index c4808b02c..ee3c5dba1 100644
> --- a/tests/kms_writeback.c
> +++ b/tests/kms_writeback.c
> @@ -32,6 +32,48 @@
>   #include "igt_core.h"
>   #include "igt_fb.h"
>   #include "sw_sync.h"
> +/**
> + * TEST: kms writeback
> + * Category: Display
> + * Description: This test validates the expected behavior of the writeback
> + *              connectors feature by checking if the target device support
> + *              writeback; it validates bad and good combination, check color
> + *              format, and check the output result by using CRC.
> + *
> + * SUBTEST: writeback-check-output
> + * Description: Check writeback output with CRC validation
> + * Driver requirement: any

i915 driver doesn't support WB feature.
Should we still add this test to kms testplan?

> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: writeback-fb-id
> + * Description: Validate WRITEBACK_FB_ID with valid and invalid options
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: writeback-invalid-parameters
> + * Description: Writeback has a couple of parameters linked together(output
> + *              framebuffer and fence); this test goes throughthe combination
> + *              of possible bad options
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: writeback-pixel-formats
> + * Description: Check the writeback format
> + * Driver requirement: any
> + * Functionality: kms_core
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + */
>   
>   IGT_TEST_DESCRIPTION(
>      "This test validates the expected behavior of the writeback connectors "