[igt-dev] [v4 2/4] tests/kms_feature_discovery: add testplan documentation

[Swati Sharma <swati2.sharma@intel.com>]

Add testplan documentation for the subtests.

v2: -remove run type and change mega feature to PSR

Signed-off-by: Swati Sharma <swati2.sharma@intel.com>
Acked-by: Kamil Konieczny <kamil.konieczny@linux.intel.com>
---
 tests/kms_feature_discovery.c | 48 ++++++++++++++++++++++++++++++++++-
 1 file changed, 47 insertions(+), 1 deletion(-)

diff --git a/tests/kms_feature_discovery.c b/tests/kms_feature_discovery.c
index d1f4b1633..5ee481c4b 100644
--- a/tests/kms_feature_discovery.c
+++ b/tests/kms_feature_discovery.c
@@ -22,6 +22,53 @@
  *
  */
 
+/**
+ * TEST: kms feature discovery
+ * Category: Display
+ * Description: A metatest that checks for \"features\" presence.
+ *		The subtests here should only skip or pass,
+ *		anything else means we have a serious problem.
+ *
+ * SUBTEST: display
+ * Description: Make sure that we have display support with
+ * 		some outputs connected.
+ * Driver requirement: i915, xe
+ * Functionality: feature_discovery
+ * Mega feature: General Display Features
+ * Test category: functionality test
+ *
+ * SUBTEST: display-%dx
+ * Description: Make sure that we have display support with %arg[1]
+ * 		outputs connected.
+ * Driver requirement: i915, xe
+ * Functionality: feature_discovery
+ * Mega feature: General Display Features
+ * Test category: functionality test
+ *
+ * SUBTEST: chamelium
+ * Description: Make sure that Chamelium is configured and reachable.
+ * Driver requirement: i915, xe
+ * Functionality: feature_discovery, chamelium
+ * Mega feature: General Display Features
+ * Test category: functionality test
+ *
+ * SUBTEST: psr1
+ * Description: Make sure that we have eDP panel with PSR1 support.
+ * Driver requirement: i915, xe
+ * Functionality: feature_discovery, psr1, eDP
+ * Mega feature: PSR
+ * Test category: functionality test
+ *
+ * SUBTEST: psr2
+ * Description: Make sure that we have eDP panel with PSR2 support.
+ * Driver requirement: i915, xe
+ * Functionality: feature_discovery, psr2, eDP
+ * Mega feature: PSR
+ * Test category: functionality test
+ *
+ * arg[1].values: 2, 3, 4
+ */
+
 #include "igt.h"
 #ifdef HAVE_CHAMELIUM
 #include "igt_chamelium.h"
@@ -46,7 +93,6 @@ igt_main {
 	}
 
 	igt_subtest_group {
-
 		igt_fixture {
 			igt_display_require(&display, fd);
 		}
-- 
2.25.1