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_i915_gem_object;
16struct drm_i915_private;
17struct drm_mode_fb_cmd2;
18struct intel_fb_view;
19struct intel_framebuffer;
20struct intel_plane;
21struct intel_plane_state;
22
23#define INTEL_PLANE_CAP_NONE		0
24#define INTEL_PLANE_CAP_CCS_RC		BIT(0)
25#define INTEL_PLANE_CAP_CCS_RC_CC	BIT(1)
26#define INTEL_PLANE_CAP_CCS_MC		BIT(2)
27#define INTEL_PLANE_CAP_TILING_X	BIT(3)
28#define INTEL_PLANE_CAP_TILING_Y	BIT(4)
29#define INTEL_PLANE_CAP_TILING_Yf	BIT(5)
30#define INTEL_PLANE_CAP_TILING_4	BIT(6)
31
32bool intel_fb_is_tiled_modifier(u64 modifier);
33bool intel_fb_is_ccs_modifier(u64 modifier);
34bool intel_fb_is_rc_ccs_cc_modifier(u64 modifier);
35bool intel_fb_is_mc_ccs_modifier(u64 modifier);
36
37bool intel_fb_is_ccs_aux_plane(const struct drm_framebuffer *fb, int color_plane);
38int intel_fb_rc_ccs_cc_plane(const struct drm_framebuffer *fb);
39
40u64 *intel_fb_plane_get_modifiers(struct drm_i915_private *i915,
41				  u8 plane_caps);
42bool intel_fb_plane_supports_modifier(struct intel_plane *plane, u64 modifier);
43
44const struct drm_format_info *
45intel_fb_get_format_info(const struct drm_mode_fb_cmd2 *cmd);
46
47bool
48intel_format_info_is_yuv_semiplanar(const struct drm_format_info *info,
49				    u64 modifier);
50
51bool is_surface_linear(const struct drm_framebuffer *fb, int color_plane);
52
53int main_to_ccs_plane(const struct drm_framebuffer *fb, int main_plane);
54int skl_ccs_to_main_plane(const struct drm_framebuffer *fb, int ccs_plane);
55int skl_main_to_aux_plane(const struct drm_framebuffer *fb, int main_plane);
56
57unsigned int intel_tile_size(const struct drm_i915_private *i915);
58unsigned int intel_tile_width_bytes(const struct drm_framebuffer *fb, int color_plane);
59unsigned int intel_tile_height(const struct drm_framebuffer *fb, int color_plane);
60unsigned int intel_tile_row_size(const struct drm_framebuffer *fb, int color_plane);
61unsigned int intel_fb_align_height(const struct drm_framebuffer *fb,
62				   int color_plane, unsigned int height);
63unsigned int intel_cursor_alignment(const struct drm_i915_private *i915);
64unsigned int intel_surf_alignment(const struct drm_framebuffer *fb,
65				  int color_plane);
66
67void intel_fb_plane_get_subsampling(int *hsub, int *vsub,
68				    const struct drm_framebuffer *fb,
69				    int color_plane);
70
71u32 intel_plane_adjust_aligned_offset(int *x, int *y,
72				      const struct intel_plane_state *state,
73				      int color_plane,
74				      u32 old_offset, u32 new_offset);
75u32 intel_plane_compute_aligned_offset(int *x, int *y,
76				       const struct intel_plane_state *state,
77				       int color_plane);
78
79bool intel_fb_needs_pot_stride_remap(const struct intel_framebuffer *fb);
80bool intel_fb_supports_90_270_rotation(const struct intel_framebuffer *fb);
81
82int intel_fill_fb_info(struct drm_i915_private *i915, struct intel_framebuffer *fb);
83void intel_fb_fill_view(const struct intel_framebuffer *fb, unsigned int rotation,
84			struct intel_fb_view *view);
85int intel_plane_compute_gtt(struct intel_plane_state *plane_state);
86
87int intel_framebuffer_init(struct intel_framebuffer *ifb,
88			   struct drm_i915_gem_object *obj,
89			   struct drm_mode_fb_cmd2 *mode_cmd);
90struct drm_framebuffer *
91intel_user_framebuffer_create(struct drm_device *dev,
92			      struct drm_file *filp,
93			      const struct drm_mode_fb_cmd2 *user_mode_cmd);
94
95bool intel_fb_modifier_uses_dpt(struct drm_i915_private *i915, u64 modifier);
96bool intel_fb_uses_dpt(const struct drm_framebuffer *fb);
97
98unsigned int intel_fb_modifier_to_tiling(u64 fb_modifier);
99
100#endif /* __INTEL_FB_H__ */
101