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_i915_gem_object;
16 struct drm_i915_private;
17 struct drm_mode_fb_cmd2;
18 struct intel_fb_view;
19 struct intel_framebuffer;
20 struct intel_plane;
21 struct intel_plane_state;
22 
23 enum intel_plane_caps {
24 	PLANE_HAS_NO_CAPS = 0,
25 	PLANE_HAS_TILING = BIT(0),
26 	PLANE_HAS_CCS_RC = BIT(1),
27 	PLANE_HAS_CCS_MC = BIT(2),
28 };
29 
30 bool is_ccs_plane(const struct drm_framebuffer *fb, int plane);
31 bool is_gen12_ccs_plane(const struct drm_framebuffer *fb, int plane);
32 bool is_gen12_ccs_cc_plane(const struct drm_framebuffer *fb, int plane);
33 
34 int intel_fb_rc_ccs_cc_plane(const struct drm_framebuffer *fb);
35 
36 u64 *intel_fb_plane_get_modifiers(struct drm_i915_private *i915,
37 				  enum intel_plane_caps plane_caps);
38 bool intel_fb_plane_supports_modifier(struct intel_plane *plane, u64 modifier);
39 
40 const struct drm_format_info *
41 intel_fb_get_format_info(const struct drm_mode_fb_cmd2 *cmd);
42 
43 bool
44 intel_format_info_is_yuv_semiplanar(const struct drm_format_info *info,
45 				    u64 modifier);
46 
47 bool is_surface_linear(const struct drm_framebuffer *fb, int color_plane);
48 
49 int main_to_ccs_plane(const struct drm_framebuffer *fb, int main_plane);
50 int skl_ccs_to_main_plane(const struct drm_framebuffer *fb, int ccs_plane);
51 int skl_main_to_aux_plane(const struct drm_framebuffer *fb, int main_plane);
52 
53 unsigned int intel_tile_size(const struct drm_i915_private *i915);
54 unsigned int intel_tile_width_bytes(const struct drm_framebuffer *fb, int color_plane);
55 unsigned int intel_tile_height(const struct drm_framebuffer *fb, int color_plane);
56 unsigned int intel_tile_row_size(const struct drm_framebuffer *fb, int color_plane);
57 unsigned int intel_fb_align_height(const struct drm_framebuffer *fb,
58 				   int color_plane, unsigned int height);
59 unsigned int intel_cursor_alignment(const struct drm_i915_private *i915);
60 unsigned int intel_surf_alignment(const struct drm_framebuffer *fb,
61 				  int color_plane);
62 
63 void intel_fb_plane_get_subsampling(int *hsub, int *vsub,
64 				    const struct drm_framebuffer *fb,
65 				    int color_plane);
66 
67 u32 intel_plane_adjust_aligned_offset(int *x, int *y,
68 				      const struct intel_plane_state *state,
69 				      int color_plane,
70 				      u32 old_offset, u32 new_offset);
71 u32 intel_plane_compute_aligned_offset(int *x, int *y,
72 				       const struct intel_plane_state *state,
73 				       int color_plane);
74 
75 bool intel_fb_needs_pot_stride_remap(const struct intel_framebuffer *fb);
76 bool intel_fb_supports_90_270_rotation(const struct intel_framebuffer *fb);
77 
78 int intel_fill_fb_info(struct drm_i915_private *i915, struct intel_framebuffer *fb);
79 void intel_fb_fill_view(const struct intel_framebuffer *fb, unsigned int rotation,
80 			struct intel_fb_view *view);
81 int intel_plane_compute_gtt(struct intel_plane_state *plane_state);
82 
83 int intel_framebuffer_init(struct intel_framebuffer *ifb,
84 			   struct drm_i915_gem_object *obj,
85 			   struct drm_mode_fb_cmd2 *mode_cmd);
86 struct drm_framebuffer *
87 intel_user_framebuffer_create(struct drm_device *dev,
88 			      struct drm_file *filp,
89 			      const struct drm_mode_fb_cmd2 *user_mode_cmd);
90 
91 #endif /* __INTEL_FB_H__ */
92