[PATCH i-g-t v5 1/2] lib/igt_chamelium: Add connector_test() macro

[Mohammed Bilal <mohammed.bilal@intel.com>]

v5:
- Iterate and test all matching connected ports (Kunal)

v4:
- Rename helper to igt_chamelium_get_port (Jeevan)
- Add documentation for helper and macro (Jeevan)
- Use lowercase name for test macro (Sebastien)

Update connector handling to iterate over all matching connected ports and
execute tests accordingly, while fixing unintended fixture execution and
skipping cleanly when no matching connector is present.

Signed-off-by: Mohammed Bilal <mohammed.bilal@intel.com>
---
 lib/igt_chamelium.h | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/lib/igt_chamelium.h b/lib/igt_chamelium.h
index b5d13ddc8..cf530d6cd 100644
--- a/lib/igt_chamelium.h
+++ b/lib/igt_chamelium.h
@@ -274,4 +274,35 @@ bool chamelium_plug_all(struct chamelium *chamelium);
 bool chamelium_wait_all_configured_ports_connected(struct chamelium *chamelium,
 						   int drm_fd);
 
+/**
+ * connector_test() - Run a subtest for all ports of a given connector type
+ *
+ * Defines a subtest that iterates over all available Chamelium ports and
+ * executes the provided test function for each port matching the requested
+ * connector type. If no matching port is found, the subtest is skipped
+ * cleanly.
+ *
+ * This helper avoids repeated connector-iteration logic and provides a
+ * consistent pattern for running connector-specific tests.
+ */
+
+#define connector_test(name, connector_type, test_fn, ...)		\
+	{								\
+		int p;							\
+		struct chamelium_port *port;                            \
+		igt_subtest(name) {					\
+			bool found = false;				\
+			for_each_port(p, port) {			\
+				if (chamelium_port_get_type(port) !=	\
+					DRM_MODE_CONNECTOR_##connector_type)	\
+					continue;			\
+				found = true;				\
+				test_fn(&data, port, ##__VA_ARGS__);	\
+			}						\
+			if (!found)					\
+				igt_skip(#connector_type		\
+					 " connector not available\n"); \
+			}						\
+	}
+
 #endif /* IGT_CHAMELIUM_H */
-- 
2.48.1