xref: /linux/include/drm/drm_gem_framebuffer_helper.h (revision 220994d61cebfc04f071d69049127657c7e8191b)
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_format_info *info,
29 			       const struct drm_mode_fb_cmd2 *mode_cmd,
30 			       const struct drm_framebuffer_funcs *funcs);
31 struct drm_framebuffer *
32 drm_gem_fb_create_with_funcs(struct drm_device *dev, struct drm_file *file,
33 			     const struct drm_format_info *info,
34 			     const struct drm_mode_fb_cmd2 *mode_cmd,
35 			     const struct drm_framebuffer_funcs *funcs);
36 struct drm_framebuffer *
37 drm_gem_fb_create(struct drm_device *dev, struct drm_file *file,
38 		  const struct drm_format_info *info,
39 		  const struct drm_mode_fb_cmd2 *mode_cmd);
40 struct drm_framebuffer *
41 drm_gem_fb_create_with_dirty(struct drm_device *dev, struct drm_file *file,
42 			     const struct drm_format_info *info,
43 			     const struct drm_mode_fb_cmd2 *mode_cmd);
44 
45 int drm_gem_fb_vmap(struct drm_framebuffer *fb, struct iosys_map *map,
46 		    struct iosys_map *data);
47 void drm_gem_fb_vunmap(struct drm_framebuffer *fb, struct iosys_map *map);
48 int drm_gem_fb_begin_cpu_access(struct drm_framebuffer *fb, enum dma_data_direction dir);
49 void drm_gem_fb_end_cpu_access(struct drm_framebuffer *fb, enum dma_data_direction dir);
50 
51 #define drm_is_afbc(modifier) \
52 	(((modifier) & AFBC_VENDOR_AND_TYPE_MASK) == DRM_FORMAT_MOD_ARM_AFBC(0))
53 
54 int drm_gem_fb_afbc_init(struct drm_device *dev,
55 			 const struct drm_format_info *info,
56 			 const struct drm_mode_fb_cmd2 *mode_cmd,
57 			 struct drm_afbc_framebuffer *afbc_fb);
58 
59 #endif
60