[PATCH i-g-t 2/2] tests/intel/kms_dark_screen_detection: Added IGT for validating dark screen detection

[Jani Nikula]

On Wed, 13 Dec 2023, Kunal Joshi <kunal1.joshi at intel.com> wrote:
> Added new IGT for validation of dark screen
> detection feature

There's threads and stuff, and *zero* explanation how this is supposed
to work. Nothing in the kernel patches, nothing in these patches,
nowhere.

All I'm asking for is a few well thought out paragraphs on *how* this is
all designed and supposed to work together, and then code to implement
that. With rationale why threads are required in igt.

I'm blocking the kernel part until I have that.


BR,
Jani.


>
> Cc: Juha-Pekka Heikkila <juhapekka.heikkila at gmail.com>
> Cc: Nemesa Garg <nemesa.garg at intel.com>
> Cc: Arun R Murthy <arun.r.murthy at intel.com>
> Cc: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
> Signed-off-by: Kunal Joshi <kunal1.joshi at intel.com>
> ---
>  tests/intel/kms_darkscreen_detection.c | 196 +++++++++++++++++++++++++
>  tests/meson.build                      |   1 +
>  2 files changed, 197 insertions(+)
>  create mode 100644 tests/intel/kms_darkscreen_detection.c
>
> diff --git a/tests/intel/kms_darkscreen_detection.c b/tests/intel/kms_darkscreen_detection.c
> new file mode 100644
> index 000000000..08d433305
> --- /dev/null
> +++ b/tests/intel/kms_darkscreen_detection.c
> @@ -0,0 +1,196 @@
> +/*
> + * Copyright © 2023 Intel Corporation
> +*/
> +
> +/**
> + * TEST: kms darkscreen detection
> + * Category: Display
> + * Description: Testing darkscreen detection works
> + *
> + * SUBTEST: basic
> + * Description: Check that we get uevent when dark screen
> + *              is detected
> + * Test category: functionality test
> + * Functionality: darkscreen
> + * Driver requirement: i915, xe
> + *
> + * SUBTEST: negative
> + * Description: Check dark screen detection doesn't report
> + *              false positives
> + * Test category: functionality test
> + * Functionality: darkscreen
> + * Driver requirement: i915, xe
> + */
> +#include "igt.h"
> +#include "igt_sysfs.h"
> +
> +typedef struct {
> +	int drm_fd;
> +	uint32_t devid;
> +	struct igt_fb fb;
> +	igt_display_t display;
> +} data_t;
> +
> +enum test {
> +	BASIC,
> +	NEGATIVE,
> +};
> +
> +struct flip_data {
> +	int drm_fd;
> +	enum pipe pipe;
> +	enum test test;
> +	igt_output_t *output;
> +};
> +
> +pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
> +pthread_cond_t condA = PTHREAD_COND_INITIALIZER;
> +bool flips_competed;
> +
> +static void enable_dark_screen_and_flip_black_frame(struct flip_data *flip_data)
> +{
> +	unsigned int fb_id;
> +	double r, g, b;
> +	struct igt_fb fb;
> +	drmModeModeInfo *mode;
> +
> +	mode = igt_output_get_mode(flip_data->output);
> +	switch (flip_data->test) {
> +	case BASIC:
> +		r = g = b = 0.0;
> +		break;
> +	case NEGATIVE:
> +		r = g = b = 1.0;
> +		break;
> +	default:
> +		igt_assert_f(false, "Unknown test case\n");
> +	}
> +	fb_id = igt_create_color_fb(flip_data->drm_fd, mode->hdisplay, mode->vdisplay,
> +				    DRM_FORMAT_XRGB8888,
> +				    DRM_FORMAT_MOD_LINEAR,
> +				    r, g, b, &fb);
> +	pthread_mutex_lock(&mutex);
> +	while (flips_competed != true)
> +		pthread_cond_wait(&condA, &mutex);
> +	pthread_mutex_unlock(&mutex);
> +	igt_set_dark_screen_detection(flip_data->drm_fd, flip_data->pipe, true);

This checks whether the screen is dark *right now*.

> +	drmModePageFlip(flip_data->drm_fd,
> +			flip_data->output->config.crtc->crtc_id,
> +			fb_id, DRM_MODE_PAGE_FLIP_EVENT,
> +			NULL);

It does not matter what this does. It's not checked, except perhaps by
accident in a subsequent call to this function.

> +	igt_remove_fb(flip_data->drm_fd, &fb);
> +}
> +
> +static void *flip_frames_untill_dark_screen_enabled(void *data)

*until

> +{
> +	int i;
> +	unsigned int fb_id1, fb_id2;
> +	unsigned int flip_fb;
> +	struct flip_data *args = data;
> +	struct igt_fb fb_1, fb_2;
> +	drmModeModeInfo *mode;
> +
> +	pthread_mutex_lock(&mutex);
> +	mode = igt_output_get_mode(args->output);
> +	fb_id1 = igt_create_color_fb(args->drm_fd, mode->hdisplay, mode->vdisplay,
> +				    DRM_FORMAT_XRGB8888,
> +				    DRM_FORMAT_MOD_LINEAR,
> +				    1.0, 0.0, 0.0, &fb_1);
> +	fb_id2 = igt_create_color_fb(args->drm_fd, mode->hdisplay, mode->vdisplay,
> +				    DRM_FORMAT_XRGB8888,
> +				    DRM_FORMAT_MOD_LINEAR,
> +				    0.0, 0.0, 1.0, &fb_2);
> +
> +	for (i = 1; i < 6; i++) {
> +		flip_fb = (((i) % 2) == 0) ? fb_id2 : fb_id1;
> +		drmModePageFlip(args->drm_fd,
> +				args->output->config.crtc->crtc_id,
> +				flip_fb, DRM_MODE_PAGE_FLIP_EVENT,
> +				NULL);
> +	}
> +	flips_competed = true;
> +	pthread_cond_broadcast(&condA);
> +	pthread_mutex_unlock(&mutex);
> +	pthread_exit(NULL);
> +	igt_remove_fb(args->drm_fd, &fb_1);
> +	igt_remove_fb(args->drm_fd, &fb_2);
> +}
> +
> +static void do_modeset(data_t *data, igt_display_t *display,
> +		       enum pipe pipe, igt_output_t *output,
> +		       enum test test)
> +{
> +	unsigned int fb_id;
> +	struct igt_fb fb;
> +	igt_plane_t *primary;
> +	drmModeModeInfo *mode;
> +
> +	mode = igt_output_get_mode(output);
> +	fb_id = igt_create_color_fb(data->drm_fd, mode->hdisplay, mode->vdisplay,
> +				    DRM_FORMAT_XRGB8888,
> +				    DRM_FORMAT_MOD_LINEAR,
> +				    0.0, 1.0, 0.0, &fb);
> +	igt_assert(fb_id);
> +	igt_output_set_pipe(output, pipe);
> +	primary = igt_output_get_plane_type(output, DRM_PLANE_TYPE_PRIMARY);
> +	igt_plane_set_fb(primary, &fb);
> +	igt_display_commit2(&data->display, COMMIT_ATOMIC);
> +	igt_remove_fb(data->drm_fd, &fb);
> +}
> +
> +static bool run_test_for_pipe_output(data_t *data, enum test test,
> +				     enum pipe pipe,
> +				     igt_output_t *output)
> +{
> +	struct flip_data flip_data;
> +	pthread_t threadA;
> +
> +	flip_data.drm_fd = data->drm_fd;
> +	flip_data.pipe = pipe;
> +	flip_data.output = output;
> +	flip_data.test = test;
> +
> +	igt_require_f(igt_is_dark_screen_supported(data->drm_fd, pipe),
> +		      "Dark screen not supported\n");
> +	igt_display_reset(&data->display);
> +
> +	do_modeset(data, &data->display,
> +		   pipe, output, test);
> +	pthread_create(&threadA, NULL, flip_frames_untill_dark_screen_enabled, &flip_data);
> +	enable_dark_screen_and_flip_black_frame(&flip_data);
> +	pthread_join(threadA, NULL);
> +	return true;
> +}
> +
> +data_t data = {};
> +
> +igt_main
> +{
> +	enum pipe pipe;
> +	igt_output_t *output;
> +
> +	igt_fixture {
> +		data.drm_fd = drm_open_driver_master(DRIVER_INTEL | DRIVER_XE);
> +		kmstest_set_vt_graphics_mode();
> +		igt_display_require(&data.display, data.drm_fd);
> +		igt_display_require_output(&data.display);
> +		igt_require(data.display.is_atomic);
> +	}
> +
> +	igt_describe("Check dark screen detection works");
> +	igt_subtest_with_dynamic("basic")
> +		for_each_pipe_with_valid_output(&data.display, pipe, output)
> +			igt_dynamic_f("pipe-%s-%s", kmstest_pipe_name(pipe), output->name)
> +				run_test_for_pipe_output(&data, BASIC, pipe, output);
> +
> +	igt_describe("Check dark screen detection doesn't report false positives");
> +	igt_subtest_with_dynamic("negative")
> +		for_each_pipe_with_valid_output(&data.display, pipe, output)
> +			igt_dynamic_f("pipe-%s-%s", kmstest_pipe_name(pipe), output->name)
> +				run_test_for_pipe_output(&data, NEGATIVE, pipe, output);
> +
> +	igt_fixture {
> +		igt_display_fini(&data.display);
> +		drm_close_driver(data.drm_fd);
> +	}
> +}
> diff --git a/tests/meson.build b/tests/meson.build
> index a5f5c143c..347b49821 100644
> --- a/tests/meson.build
> +++ b/tests/meson.build
> @@ -249,6 +249,7 @@ intel_kms_progs = [
>  	'kms_busy',
>  	'kms_ccs',
>  	'kms_cdclk',
> +        'kms_darkscreen_detection',
>  	'kms_dirtyfb',
>  	'kms_draw_crc',
>  	'kms_dsc',

-- 
Jani Nikula, Intel