Loading...
1// SPDX-License-Identifier: GPL-2.0
2
3#ifndef DRM_KUNIT_HELPERS_H_
4#define DRM_KUNIT_HELPERS_H_
5
6#include <linux/device.h>
7
8#include <kunit/test.h>
9
10struct drm_device;
11struct kunit;
12
13struct device *drm_kunit_helper_alloc_device(struct kunit *test);
14void drm_kunit_helper_free_device(struct kunit *test, struct device *dev);
15
16struct drm_device *
17__drm_kunit_helper_alloc_drm_device_with_driver(struct kunit *test,
18 struct device *dev,
19 size_t size, size_t offset,
20 const struct drm_driver *driver);
21
22/**
23 * drm_kunit_helper_alloc_drm_device_with_driver - Allocates a mock DRM device for KUnit tests
24 * @_test: The test context object
25 * @_dev: The parent device object
26 * @_type: the type of the struct which contains struct &drm_device
27 * @_member: the name of the &drm_device within @_type.
28 * @_drv: Mocked DRM device driver features
29 *
30 * This function creates a struct &drm_device from @_dev and @_drv.
31 *
32 * @_dev should be allocated using drm_kunit_helper_alloc_device().
33 *
34 * The driver is tied to the @_test context and will get cleaned at the
35 * end of the test. The drm_device is allocated through
36 * devm_drm_dev_alloc() and will thus be freed through a device-managed
37 * resource.
38 *
39 * Returns:
40 * A pointer to the new drm_device, or an ERR_PTR() otherwise.
41 */
42#define drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, _type, _member, _drv) \
43 ((_type *)__drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, \
44 sizeof(_type), \
45 offsetof(_type, _member), \
46 _drv))
47
48static inline struct drm_device *
49__drm_kunit_helper_alloc_drm_device(struct kunit *test,
50 struct device *dev,
51 size_t size, size_t offset,
52 u32 features)
53{
54 struct drm_driver *driver;
55
56 driver = devm_kzalloc(dev, sizeof(*driver), GFP_KERNEL);
57 KUNIT_ASSERT_NOT_NULL(test, driver);
58
59 driver->driver_features = features;
60
61 return __drm_kunit_helper_alloc_drm_device_with_driver(test, dev,
62 size, offset,
63 driver);
64}
65
66/**
67 * drm_kunit_helper_alloc_drm_device - Allocates a mock DRM device for KUnit tests
68 * @_test: The test context object
69 * @_dev: The parent device object
70 * @_type: the type of the struct which contains struct &drm_device
71 * @_member: the name of the &drm_device within @_type.
72 * @_features: Mocked DRM device driver features
73 *
74 * This function creates a struct &drm_driver and will create a struct
75 * &drm_device from @_dev and that driver.
76 *
77 * @_dev should be allocated using drm_kunit_helper_alloc_device().
78 *
79 * The driver is tied to the @_test context and will get cleaned at the
80 * end of the test. The drm_device is allocated through
81 * devm_drm_dev_alloc() and will thus be freed through a device-managed
82 * resource.
83 *
84 * Returns:
85 * A pointer to the new drm_device, or an ERR_PTR() otherwise.
86 */
87#define drm_kunit_helper_alloc_drm_device(_test, _dev, _type, _member, _feat) \
88 ((_type *)__drm_kunit_helper_alloc_drm_device(_test, _dev, \
89 sizeof(_type), \
90 offsetof(_type, _member), \
91 _feat))
92struct drm_modeset_acquire_ctx *
93drm_kunit_helper_acquire_ctx_alloc(struct kunit *test);
94
95struct drm_atomic_state *
96drm_kunit_helper_atomic_state_alloc(struct kunit *test,
97 struct drm_device *drm,
98 struct drm_modeset_acquire_ctx *ctx);
99
100#endif // DRM_KUNIT_HELPERS_H_
1// SPDX-License-Identifier: GPL-2.0
2
3#ifndef DRM_KUNIT_HELPERS_H_
4#define DRM_KUNIT_HELPERS_H_
5
6#include <drm/drm_drv.h>
7
8#include <linux/device.h>
9
10#include <kunit/test.h>
11
12struct drm_crtc_funcs;
13struct drm_crtc_helper_funcs;
14struct drm_device;
15struct drm_plane_funcs;
16struct drm_plane_helper_funcs;
17struct kunit;
18
19struct device *drm_kunit_helper_alloc_device(struct kunit *test);
20void drm_kunit_helper_free_device(struct kunit *test, struct device *dev);
21
22struct drm_device *
23__drm_kunit_helper_alloc_drm_device_with_driver(struct kunit *test,
24 struct device *dev,
25 size_t size, size_t offset,
26 const struct drm_driver *driver);
27
28/**
29 * drm_kunit_helper_alloc_drm_device_with_driver - Allocates a mock DRM device for KUnit tests
30 * @_test: The test context object
31 * @_dev: The parent device object
32 * @_type: the type of the struct which contains struct &drm_device
33 * @_member: the name of the &drm_device within @_type.
34 * @_drv: Mocked DRM device driver features
35 *
36 * This function creates a struct &drm_device from @_dev and @_drv.
37 *
38 * @_dev should be allocated using drm_kunit_helper_alloc_device().
39 *
40 * The driver is tied to the @_test context and will get cleaned at the
41 * end of the test. The drm_device is allocated through
42 * devm_drm_dev_alloc() and will thus be freed through a device-managed
43 * resource.
44 *
45 * Returns:
46 * A pointer to the new drm_device, or an ERR_PTR() otherwise.
47 */
48#define drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, _type, _member, _drv) \
49 ((_type *)__drm_kunit_helper_alloc_drm_device_with_driver(_test, _dev, \
50 sizeof(_type), \
51 offsetof(_type, _member), \
52 _drv))
53
54static inline struct drm_device *
55__drm_kunit_helper_alloc_drm_device(struct kunit *test,
56 struct device *dev,
57 size_t size, size_t offset,
58 u32 features)
59{
60 struct drm_driver *driver;
61
62 driver = devm_kzalloc(dev, sizeof(*driver), GFP_KERNEL);
63 KUNIT_ASSERT_NOT_NULL(test, driver);
64
65 driver->driver_features = features;
66
67 return __drm_kunit_helper_alloc_drm_device_with_driver(test, dev,
68 size, offset,
69 driver);
70}
71
72/**
73 * drm_kunit_helper_alloc_drm_device - Allocates a mock DRM device for KUnit tests
74 * @_test: The test context object
75 * @_dev: The parent device object
76 * @_type: the type of the struct which contains struct &drm_device
77 * @_member: the name of the &drm_device within @_type.
78 * @_feat: Mocked DRM device driver features
79 *
80 * This function creates a struct &drm_driver and will create a struct
81 * &drm_device from @_dev and that driver.
82 *
83 * @_dev should be allocated using drm_kunit_helper_alloc_device().
84 *
85 * The driver is tied to the @_test context and will get cleaned at the
86 * end of the test. The drm_device is allocated through
87 * devm_drm_dev_alloc() and will thus be freed through a device-managed
88 * resource.
89 *
90 * Returns:
91 * A pointer to the new drm_device, or an ERR_PTR() otherwise.
92 */
93#define drm_kunit_helper_alloc_drm_device(_test, _dev, _type, _member, _feat) \
94 ((_type *)__drm_kunit_helper_alloc_drm_device(_test, _dev, \
95 sizeof(_type), \
96 offsetof(_type, _member), \
97 _feat))
98struct drm_modeset_acquire_ctx *
99drm_kunit_helper_acquire_ctx_alloc(struct kunit *test);
100
101struct drm_atomic_state *
102drm_kunit_helper_atomic_state_alloc(struct kunit *test,
103 struct drm_device *drm,
104 struct drm_modeset_acquire_ctx *ctx);
105
106struct drm_plane *
107drm_kunit_helper_create_primary_plane(struct kunit *test,
108 struct drm_device *drm,
109 const struct drm_plane_funcs *funcs,
110 const struct drm_plane_helper_funcs *helper_funcs,
111 const uint32_t *formats,
112 unsigned int num_formats,
113 const uint64_t *modifiers);
114
115struct drm_crtc *
116drm_kunit_helper_create_crtc(struct kunit *test,
117 struct drm_device *drm,
118 struct drm_plane *primary,
119 struct drm_plane *cursor,
120 const struct drm_crtc_funcs *funcs,
121 const struct drm_crtc_helper_funcs *helper_funcs);
122
123struct drm_display_mode *
124drm_kunit_display_mode_from_cea_vic(struct kunit *test, struct drm_device *dev,
125 u8 video_code);
126
127#endif // DRM_KUNIT_HELPERS_H_