// SPDX-License-Identifier: GPL-2.0 AND MIT /* * Copyright © 2023 Intel Corporation */ #include #include #include #include #include #include "tests/xe_kunit_helpers.h" #include "tests/xe_pci_test.h" #include "xe_device.h" #include "xe_device_types.h" #include "xe_pm.h" /** * xe_kunit_helper_alloc_xe_device - Allocate a &xe_device for a KUnit test. * @test: the &kunit where this &xe_device will be used * @dev: The parent device object * * This function allocates xe_device using drm_kunit_helper_alloc_device(). * The xe_device allocation is managed by the test. * * @dev should be allocated using drm_kunit_helper_alloc_device(). * * This function uses KUNIT_ASSERT to detect any allocation failures. * * Return: A pointer to the new &xe_device. */ struct xe_device *xe_kunit_helper_alloc_xe_device(struct kunit *test, struct device *dev) { struct xe_device *xe; xe = drm_kunit_helper_alloc_drm_device(test, dev, struct xe_device, drm, DRIVER_GEM); KUNIT_ASSERT_NOT_ERR_OR_NULL(test, xe); return xe; } EXPORT_SYMBOL_IF_KUNIT(xe_kunit_helper_alloc_xe_device); static void kunit_action_restore_priv(void *priv) { struct kunit *test = kunit_get_current_test(); test->priv = priv; } /** * xe_kunit_helper_xe_device_test_init - Prepare a &xe_device for a KUnit test. * @test: the &kunit where this fake &xe_device will be used * * This function allocates and initializes a fake &xe_device and stores its * pointer as &kunit.priv to allow the test code to access it. * * This function can be directly used as custom implementation of * &kunit_suite.init. * * It is possible to prepare specific variant of the fake &xe_device by passing * in &kunit.priv pointer to the struct xe_pci_fake_data supplemented with * desired parameters prior to calling this function. * * This function uses KUNIT_ASSERT to detect any failures. * * Return: Always 0. */ int xe_kunit_helper_xe_device_test_init(struct kunit *test) { struct xe_device *xe; struct device *dev; int err; dev = drm_kunit_helper_alloc_device(test); KUNIT_ASSERT_NOT_ERR_OR_NULL(test, dev); xe = xe_kunit_helper_alloc_xe_device(test, dev); KUNIT_ASSERT_NOT_ERR_OR_NULL(test, xe); err = xe_pci_fake_device_init(xe); KUNIT_ASSERT_EQ(test, err, 0); err = kunit_add_action_or_reset(test, kunit_action_restore_priv, test->priv); KUNIT_ASSERT_EQ(test, err, 0); test->priv = xe; return 0; } EXPORT_SYMBOL_IF_KUNIT(xe_kunit_helper_xe_device_test_init); KUNIT_DEFINE_ACTION_WRAPPER(put_xe_pm_runtime, xe_pm_runtime_put, struct xe_device *); /** * xe_kunit_helper_xe_device_live_test_init - Prepare a &xe_device for * use in a live KUnit test. * @test: the &kunit where live &xe_device will be used * * This function expects pointer to the &xe_device in the &test.param_value, * like it is prepared by the &xe_pci_live_device_gen_param and stores that * pointer as &kunit.priv to allow the test code to access it. * * This function makes sure that device is not wedged and then resumes it * to avoid waking up the device inside the test. It uses deferred cleanup * action to release a runtime_pm reference. * * This function can be used as custom implementation of &kunit_suite.init. * * This function uses KUNIT_ASSERT to detect any failures. * * Return: Always 0. */ int xe_kunit_helper_xe_device_live_test_init(struct kunit *test) { struct xe_device *xe = xe_device_const_cast(test->param_value); KUNIT_ASSERT_NOT_ERR_OR_NULL(test, xe); kunit_info(test, "running on %s device\n", xe->info.platform_name); KUNIT_ASSERT_FALSE(test, xe_device_wedged(xe)); xe_pm_runtime_get(xe); KUNIT_ASSERT_EQ(test, 0, kunit_add_action_or_reset(test, put_xe_pm_runtime, xe)); test->priv = xe; return 0; } EXPORT_SYMBOL_IF_KUNIT(xe_kunit_helper_xe_device_live_test_init);