From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga06.intel.com (mga06b.intel.com [134.134.136.31]) by gabe.freedesktop.org (Postfix) with ESMTPS id E541410E178 for ; Mon, 15 May 2023 08:22:47 +0000 (UTC) From: Bhanuprakash Modem To: igt-dev@lists.freedesktop.org Date: Mon, 15 May 2023 13:46:08 +0530 Message-Id: <20230515081720.3713293-8-bhanuprakash.modem@intel.com> In-Reply-To: <20230515081720.3713293-1-bhanuprakash.modem@intel.com> References: <20230515081720.3713293-1-bhanuprakash.modem@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [igt-dev] [i-g-t 07/79] tests/chamelium/kms_chamelium_edid: Document each subtest for testplan List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: igt-dev-bounces@lists.freedesktop.org Sender: "igt-dev" List-ID: Add documentation for all kms tests which is used by IGT testplan documentation. Signed-off-by: Bhanuprakash Modem --- tests/chamelium/kms_chamelium_edid.c | 90 +++++++++++++++++++++++++++- 1 file changed, 89 insertions(+), 1 deletion(-) diff --git a/tests/chamelium/kms_chamelium_edid.c b/tests/chamelium/kms_chamelium_edid.c index fc78d4a07..3eb413070 100644 --- a/tests/chamelium/kms_chamelium_edid.c +++ b/tests/chamelium/kms_chamelium_edid.c @@ -25,8 +25,9 @@ */ /** - * TEST: Tests behaviour of edid & timings using chamelium + * TEST: kms chamelium edid * Category: Display + * Description: Testing EDID with a Chamelium board */ #include @@ -151,6 +152,7 @@ static void check_mode(struct chamelium *chamelium, struct chamelium_port *port, * Run type: BAT * Functionality: dp * Mega feature: DP + * Driver requirement: any * * SUBTEST: hdmi-edid-read * Description: Make sure the EDID exposed by KMS is the same as the screen's @@ -158,6 +160,7 @@ static void check_mode(struct chamelium *chamelium, struct chamelium_port *port, * Run type: BAT * Functionality: hdmi * Mega feature: HDMI + * Driver requirement: any * * SUBTEST: vga-edid-read * Description: Make sure the EDID exposed by KMS is the same as the screen's @@ -165,6 +168,7 @@ static void check_mode(struct chamelium *chamelium, struct chamelium_port *port, * Run type: BAT * Functionality: vga * Mega feature: VGA + * Driver requirement: any */ static const char igt_custom_edid_type_read_desc[] = "Make sure the EDID exposed by KMS is the same as the screen's"; @@ -205,6 +209,32 @@ static void igt_custom_edid_type_read(chamelium_data_t *data, drmModeFreeConnector(connector); } +/** + * SUBTEST: dp-edid-stress-resolution-%s + * Description: Stress test the DUT by testing multiple EDIDs, one right after + * the other, and ensure their validity by check the real screen + * resolution vs the advertised mode (%arg[1]) resolution. + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + * + * SUBTEST: hdmi-edid-stress-resolution-%s + * Description: Stress test the DUT by testing multiple EDIDs, one right after + * the other, and ensure their validity by check the real screen + * resolution vs the advertised mode (%arg[1]) resolution. + * Test category: functionality test + * Run type: FULL + * Functionality: hdmi + * Mega feature: HDMI + * Driver requirement: any + * + * arg[1]: + * + * @4k: 4K + * @non-4k: Non 4K + */ static const char igt_edid_stress_resolution_desc[] = "Stress test the DUT by testing multiple EDIDs, one right after the other, " "and ensure their validity by check the real screen resolution vs the " @@ -274,6 +304,17 @@ static void edid_stress_resolution(chamelium_data_t *data, data->ports, data->port_count); } +/** + * SUBTEST: dp-edid-resolution-list + * Description: Get an EDID with many modes of different configurations, set + * them on the screen and check the screen resolution matches the + * mode resolution. + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + */ static const char igt_edid_resolution_list_desc[] = "Get an EDID with many modes of different configurations, set them on the screen and check the" " screen resolution matches the mode resolution."; @@ -337,6 +378,32 @@ static void edid_resolution_list(chamelium_data_t *data, drmModeFreeConnector(connector); } +/** + * SUBTEST: dp-edid-change-during-%s + * Description: Simulate a screen being unplugged and another screen being + * plugged during suspend, check that a uevent is sent and + * connector status is updated during %arg[1] + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + * + * SUBTEST: hdmi-edid-change-during-%s + * Description: Simulate a screen being unplugged and another screen being + * plugged during suspend, check that a uevent is sent and + * connector status is updated during %arg[1] + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + * + * arg[1]: + * + * @hibernate: hibernation + * @suspend: suspend + */ static const char test_suspend_resume_edid_change_desc[] = "Simulate a screen being unplugged and another screen being plugged " "during suspend, check that a uevent is sent and connector status is " @@ -389,6 +456,27 @@ static void test_suspend_resume_edid_change(chamelium_data_t *data, link_status_failed[1][p]); } +/** + * SUBTEST: dp-mode-timings + * Description: For each mode of the IGT base EDID, perform a modeset and check + * the mode detected by the Chamelium receiver matches the mode we + * set + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + * + * SUBTEST: hdmi-mode-timings + * Description: For each mode of the IGT base EDID, perform a modeset and check + * the mode detected by the Chamelium receiver matches the mode we + * set + * Test category: functionality test + * Run type: FULL + * Functionality: dp + * Mega feature: DP + * Driver requirement: any + */ static const char test_mode_timings_desc[] = "For each mode of the IGT base EDID, perform a modeset and check the " "mode detected by the Chamelium receiver matches the mode we set"; -- 2.40.0