xref: /linux/include/drm/drm_gem_framebuffer_helper.h (revision 81112eaac559ccd451b3dce3bbb64d6b69083961)
1 #ifndef __DRM_GEM_FB_HELPER_H__
2 #define __DRM_GEM_FB_HELPER_H__
3 
4 #include <linux/dma-buf.h>
5 #include <linux/iosys-map.h>
6 
7 struct drm_afbc_framebuffer;
8 struct drm_device;
9 struct drm_fb_helper_surface_size;
10 struct drm_file;
11 struct drm_format_info;
12 struct drm_framebuffer;
13 struct drm_framebuffer_funcs;
14 struct drm_gem_object;
15 struct drm_mode_fb_cmd2;
16 
17 #define AFBC_VENDOR_AND_TYPE_MASK	GENMASK_ULL(63, 52)
18 
19 struct drm_gem_object *drm_gem_fb_get_obj(struct drm_framebuffer *fb,
20 					  unsigned int plane);
21 void drm_gem_fb_destroy(struct drm_framebuffer *fb);
22 int drm_gem_fb_create_handle(struct drm_framebuffer *fb, struct drm_file *file,
23 			     unsigned int *handle);
24 
25 int drm_gem_fb_init_with_funcs(struct drm_device *dev,
26 			       struct drm_framebuffer *fb,
27 			       struct drm_file *file,
28 			       const struct drm_mode_fb_cmd2 *mode_cmd,
29 			       const struct drm_framebuffer_funcs *funcs);
30 struct drm_framebuffer *
31 drm_gem_fb_create_with_funcs(struct drm_device *dev, struct drm_file *file,
32 			     const struct drm_mode_fb_cmd2 *mode_cmd,
33 			     const struct drm_framebuffer_funcs *funcs);
34 struct drm_framebuffer *
35 drm_gem_fb_create(struct drm_device *dev, struct drm_file *file,
36 		  const struct drm_format_info *info,
37 		  const struct drm_mode_fb_cmd2 *mode_cmd);
38 struct drm_framebuffer *
39 drm_gem_fb_create_with_dirty(struct drm_device *dev, struct drm_file *file,
40 			     const struct drm_format_info *info,
41 			     const struct drm_mode_fb_cmd2 *mode_cmd);
42 
43 int drm_gem_fb_vmap(struct drm_framebuffer *fb, struct iosys_map *map,
44 		    struct iosys_map *data);
45 void drm_gem_fb_vunmap(struct drm_framebuffer *fb, struct iosys_map *map);
46 int drm_gem_fb_begin_cpu_access(struct drm_framebuffer *fb, enum dma_data_direction dir);
47 void drm_gem_fb_end_cpu_access(struct drm_framebuffer *fb, enum dma_data_direction dir);
48 
49 #define drm_is_afbc(modifier) \
50 	(((modifier) & AFBC_VENDOR_AND_TYPE_MASK) == DRM_FORMAT_MOD_ARM_AFBC(0))
51 
52 int drm_gem_fb_afbc_init(struct drm_device *dev,
53 			 const struct drm_mode_fb_cmd2 *mode_cmd,
54 			 struct drm_afbc_framebuffer *afbc_fb);
55 
56 #endif
57