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
12struct drm_device;
13struct drm_file;
14struct drm_framebuffer;
15struct drm_gem_object;
16struct drm_mode_fb_cmd2;
17struct intel_display;
18struct intel_fb_view;
19struct intel_framebuffer;
20struct intel_plane;
21struct intel_plane_state;
22struct intel_remapped_info;
23struct 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
35bool intel_fb_is_tiled_modifier(u64 modifier);
36bool intel_fb_is_ccs_modifier(u64 modifier);
37bool intel_fb_is_rc_ccs_cc_modifier(u64 modifier);
38bool intel_fb_is_mc_ccs_modifier(u64 modifier);
39bool intel_fb_needs_64k_phys(u64 modifier);
40bool intel_fb_is_tile4_modifier(u64 modifier);
41
42bool intel_fb_is_ccs_aux_plane(const struct drm_framebuffer *fb, int color_plane);
43int intel_fb_rc_ccs_cc_plane(const struct drm_framebuffer *fb);
44
45u64 *intel_fb_plane_get_modifiers(struct intel_display *display,
46 u8 plane_caps);
47bool intel_fb_plane_supports_modifier(struct intel_plane *plane, u64 modifier);
48
49const struct drm_format_info *
50intel_fb_get_format_info(u32 pixel_format, u64 modifier);
51
52bool
53intel_format_info_is_yuv_semiplanar(const struct drm_format_info *info,
54 u64 modifier);
55
56bool is_surface_linear(const struct drm_framebuffer *fb, int color_plane);
57
58int main_to_ccs_plane(const struct drm_framebuffer *fb, int main_plane);
59int skl_ccs_to_main_plane(const struct drm_framebuffer *fb, int ccs_plane);
60int skl_main_to_aux_plane(const struct drm_framebuffer *fb, int main_plane);
61
62unsigned int intel_tile_size(struct intel_display *display);
63unsigned int intel_tile_width_bytes(const struct drm_framebuffer *fb, int color_plane);
64unsigned int intel_tile_height(const struct drm_framebuffer *fb, int color_plane);
65unsigned int intel_tile_row_size(const struct drm_framebuffer *fb, int color_plane);
66unsigned int intel_fb_align_height(const struct drm_framebuffer *fb,
67 int color_plane, unsigned int height);
68
69void intel_fb_plane_get_subsampling(int *hsub, int *vsub,
70 const struct drm_framebuffer *fb,
71 int color_plane);
72
73u32 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);
77u32 intel_plane_compute_aligned_offset(int *x, int *y,
78 const struct intel_plane_state *plane_state,
79 int color_plane);
80
81bool intel_fb_needs_pot_stride_remap(const struct intel_framebuffer *fb);
82bool intel_plane_uses_fence(const struct intel_plane_state *plane_state);
83bool intel_fb_supports_90_270_rotation(const struct intel_framebuffer *fb);
84
85unsigned int intel_rotation_info_size(const struct intel_rotation_info *rot_info);
86unsigned int intel_remapped_info_size(const struct intel_remapped_info *rem_info);
87
88int intel_fill_fb_info(struct intel_display *display, struct intel_framebuffer *fb);
89void intel_fb_fill_view(const struct intel_framebuffer *fb, unsigned int rotation,
90 struct intel_fb_view *view);
91unsigned int intel_fb_view_vtd_guard(const struct drm_framebuffer *fb,
92 const struct intel_fb_view *view,
93 unsigned int rotation);
94int intel_plane_compute_gtt(struct intel_plane_state *plane_state);
95
96unsigned int intel_fb_xy_to_linear(int x, int y,
97 const struct intel_plane_state *plane_state,
98 int color_plane);
99void intel_add_fb_offsets(int *x, int *y,
100 const struct intel_plane_state *plane_state,
101 int color_plane);
102
103int intel_framebuffer_init(struct intel_framebuffer *ifb,
104 struct drm_gem_object *obj,
105 const struct drm_format_info *info,
106 struct drm_mode_fb_cmd2 *mode_cmd);
107
108struct intel_framebuffer *intel_framebuffer_alloc(void);
109
110struct drm_framebuffer *
111intel_framebuffer_create(struct drm_gem_object *obj,
112 const struct drm_format_info *info,
113 struct drm_mode_fb_cmd2 *mode_cmd);
114struct drm_framebuffer *
115intel_user_framebuffer_create(struct drm_device *dev,
116 struct drm_file *filp,
117 const struct drm_format_info *info,
118 const struct drm_mode_fb_cmd2 *user_mode_cmd);
119
120bool intel_fb_modifier_uses_dpt(struct intel_display *display, u64 modifier);
121bool intel_fb_uses_dpt(const struct drm_framebuffer *fb);
122
123unsigned int intel_fb_modifier_to_tiling(u64 fb_modifier);
124
125struct drm_gem_object *intel_fb_bo(const struct drm_framebuffer *fb);
126
127#endif /* __INTEL_FB_H__ */
128