xref: /linux/drivers/gpu/drm/i915/display/intel_fb.h (revision c06b6cde2a1c3bcbb561bd57bb6f34eae9030921)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2020-2021 Intel Corporation
4  */
5 
6 #ifndef __INTEL_FB_H__
7 #define __INTEL_FB_H__
8 
9 #include <linux/bits.h>
10 #include <linux/types.h>
11 
12 struct drm_device;
13 struct drm_file;
14 struct drm_framebuffer;
15 struct drm_gem_object;
16 struct drm_mode_fb_cmd2;
17 struct intel_display;
18 struct intel_fb_view;
19 struct intel_framebuffer;
20 struct intel_plane;
21 struct intel_plane_state;
22 struct intel_remapped_info;
23 struct intel_rotation_info;
24 
25 #define INTEL_PLANE_CAP_NONE		0
26 #define INTEL_PLANE_CAP_CCS_RC		BIT(0)
27 #define INTEL_PLANE_CAP_CCS_RC_CC	BIT(1)
28 #define INTEL_PLANE_CAP_CCS_MC		BIT(2)
29 #define INTEL_PLANE_CAP_TILING_X	BIT(3)
30 #define INTEL_PLANE_CAP_TILING_Y	BIT(4)
31 #define INTEL_PLANE_CAP_TILING_Yf	BIT(5)
32 #define INTEL_PLANE_CAP_TILING_4	BIT(6)
33 #define INTEL_PLANE_CAP_NEED64K_PHYS	BIT(7)
34 
35 bool intel_fb_is_tiled_modifier(u64 modifier);
36 bool intel_fb_is_ccs_modifier(u64 modifier);
37 bool intel_fb_is_rc_ccs_cc_modifier(u64 modifier);
38 bool intel_fb_is_mc_ccs_modifier(u64 modifier);
39 bool intel_fb_needs_64k_phys(u64 modifier);
40 bool intel_fb_is_tile4_modifier(u64 modifier);
41 bool intel_fb_needs_cpu_access(const struct drm_framebuffer *fb);
42 
43 bool intel_fb_is_ccs_aux_plane(const struct drm_framebuffer *fb, int color_plane);
44 int intel_fb_rc_ccs_cc_plane(const struct drm_framebuffer *fb);
45 
46 u64 *intel_fb_plane_get_modifiers(struct intel_display *display,
47 				  u8 plane_caps);
48 bool intel_fb_plane_supports_modifier(struct intel_plane *plane, u64 modifier);
49 
50 const struct drm_format_info *
51 intel_fb_get_format_info(u32 pixel_format, u64 modifier);
52 
53 bool
54 intel_format_info_is_yuv_semiplanar(const struct drm_format_info *info,
55 				    u64 modifier);
56 
57 bool is_surface_linear(const struct drm_framebuffer *fb, int color_plane);
58 
59 int main_to_ccs_plane(const struct drm_framebuffer *fb, int main_plane);
60 int skl_ccs_to_main_plane(const struct drm_framebuffer *fb, int ccs_plane);
61 int skl_main_to_aux_plane(const struct drm_framebuffer *fb, int main_plane);
62 
63 unsigned int intel_tile_size(struct intel_display *display);
64 unsigned int intel_tile_width_bytes(const struct drm_framebuffer *fb, int color_plane);
65 unsigned int intel_tile_height(const struct drm_framebuffer *fb, int color_plane);
66 unsigned int intel_fb_align_height(const struct drm_framebuffer *fb,
67 				   int color_plane, unsigned int height);
68 
69 void intel_fb_plane_get_subsampling(int *hsub, int *vsub,
70 				    const struct drm_framebuffer *fb,
71 				    int color_plane);
72 
73 u32 intel_plane_adjust_aligned_offset(int *x, int *y,
74 				      const struct intel_plane_state *plane_state,
75 				      int color_plane,
76 				      u32 old_offset, u32 new_offset);
77 u32 intel_plane_compute_aligned_offset(int *x, int *y,
78 				       const struct intel_plane_state *plane_state,
79 				       int color_plane);
80 
81 bool intel_plane_uses_fence(const struct intel_plane_state *plane_state);
82 bool intel_fb_supports_90_270_rotation(const struct intel_framebuffer *fb);
83 
84 unsigned int intel_rotation_info_size(const struct intel_rotation_info *rot_info);
85 unsigned int intel_remapped_info_size(const struct intel_remapped_info *rem_info);
86 
87 int intel_fill_fb_info(struct intel_display *display, struct intel_framebuffer *fb);
88 void intel_fb_fill_view(const struct intel_framebuffer *fb, unsigned int rotation,
89 			struct intel_fb_view *view);
90 unsigned int intel_fb_view_vtd_guard(const struct drm_framebuffer *fb,
91 				     const struct intel_fb_view *view,
92 				     unsigned int rotation);
93 int intel_plane_compute_gtt(struct intel_plane_state *plane_state);
94 
95 unsigned int intel_fb_xy_to_linear(int x, int y,
96 				   const struct intel_plane_state *plane_state,
97 				   int color_plane);
98 void intel_add_fb_offsets(int *x, int *y,
99 			  const struct intel_plane_state *plane_state,
100 			  int color_plane);
101 
102 int intel_framebuffer_init(struct intel_framebuffer *ifb,
103 			   struct drm_gem_object *obj,
104 			   const struct drm_format_info *info,
105 			   struct drm_mode_fb_cmd2 *mode_cmd);
106 
107 struct intel_framebuffer *intel_framebuffer_alloc(void);
108 
109 struct drm_framebuffer *
110 intel_framebuffer_create(struct drm_gem_object *obj,
111 			 const struct drm_format_info *info,
112 			 struct drm_mode_fb_cmd2 *mode_cmd);
113 struct drm_framebuffer *
114 intel_user_framebuffer_create(struct drm_device *dev,
115 			      struct drm_file *filp,
116 			      const struct drm_format_info *info,
117 			      const struct drm_mode_fb_cmd2 *user_mode_cmd);
118 
119 bool intel_fb_modifier_uses_dpt(struct intel_display *display, u64 modifier);
120 bool intel_fb_uses_dpt(const struct drm_framebuffer *fb);
121 
122 unsigned int intel_fb_modifier_to_tiling(u64 fb_modifier);
123 
124 struct drm_gem_object *intel_fb_bo(const struct drm_framebuffer *fb);
125 
126 #endif /* __INTEL_FB_H__ */
127