xref: /linux/drivers/gpu/drm/i915/display/intel_plane.h (revision 570f7e331f5febb30f1384817463c7e42b65ca7d)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2019 Intel Corporation
4  */
5 
6 #ifndef __INTEL_PLANE_H__
7 #define __INTEL_PLANE_H__
8 
9 #include <linux/types.h>
10 
11 struct drm_format_info;
12 struct drm_plane;
13 struct drm_property;
14 struct drm_rect;
15 struct intel_atomic_state;
16 struct intel_crtc;
17 struct intel_crtc_state;
18 struct intel_display;
19 struct intel_dsb;
20 struct intel_plane;
21 struct intel_plane_state;
22 enum plane_id;
23 
24 struct intel_plane *
25 intel_crtc_get_plane(struct intel_crtc *crtc, enum plane_id plane_id);
26 bool intel_plane_can_async_flip(struct intel_plane *plane,
27 				const struct drm_format_info *info,
28 				u64 modifier);
29 unsigned int intel_adjusted_rate(const struct drm_rect *src,
30 				 const struct drm_rect *dst,
31 				 unsigned int rate);
32 unsigned int intel_adjusted_rate_cdclk(const struct drm_rect *src,
33 				       const struct drm_rect *dst,
34 				       unsigned int rate, unsigned int ppc);
35 unsigned int intel_plane_pixel_rate(const struct intel_crtc_state *crtc_state,
36 				    const struct intel_plane_state *plane_state);
37 unsigned int intel_plane_pixel_rate_cdclk(const struct intel_crtc_state *crtc_state,
38 					  const struct intel_plane_state *plane_state);
39 
40 unsigned int intel_plane_data_rate(const struct intel_crtc_state *crtc_state,
41 				   const struct intel_plane_state *plane_state,
42 				   int color_plane);
43 void intel_plane_copy_uapi_to_hw_state(struct intel_atomic_state *state,
44 				       struct intel_plane_state *plane_state,
45 				       const struct intel_plane_state *from_plane_state,
46 				       struct intel_crtc *crtc);
47 void intel_plane_async_flip(struct intel_dsb *dsb,
48 			    struct intel_plane *plane,
49 			    const struct intel_crtc_state *crtc_state,
50 			    const struct intel_plane_state *plane_state,
51 			    bool async_flip);
52 void intel_plane_update_noarm(struct intel_dsb *dsb,
53 			      struct intel_plane *plane,
54 			      const struct intel_crtc_state *crtc_state,
55 			      const struct intel_plane_state *plane_state);
56 void intel_plane_update_arm(struct intel_dsb *dsb,
57 			    struct intel_plane *plane,
58 			    const struct intel_crtc_state *crtc_state,
59 			    const struct intel_plane_state *plane_state);
60 void intel_plane_disable_arm(struct intel_dsb *dsb,
61 			     struct intel_plane *plane,
62 			     const struct intel_crtc_state *crtc_state);
63 struct intel_plane *intel_plane_alloc(void);
64 void intel_plane_free(struct intel_plane *plane);
65 void intel_plane_destroy(struct drm_plane *plane);
66 struct drm_plane_state *intel_plane_duplicate_state(struct drm_plane *plane);
67 void intel_plane_destroy_state(struct drm_plane *plane,
68 			       struct drm_plane_state *state);
69 void intel_crtc_planes_update_noarm(struct intel_dsb *dsb,
70 				    struct intel_atomic_state *state,
71 				    struct intel_crtc *crtc);
72 void intel_crtc_planes_update_arm(struct intel_dsb *dsbx,
73 				  struct intel_atomic_state *state,
74 				  struct intel_crtc *crtc);
75 int intel_plane_atomic_check_with_state(const struct intel_crtc_state *old_crtc_state,
76 					struct intel_crtc_state *crtc_state,
77 					const struct intel_plane_state *old_plane_state,
78 					struct intel_plane_state *intel_state);
79 int intel_plane_check_clipping(struct intel_plane_state *plane_state,
80 			       struct intel_crtc_state *crtc_state,
81 			       int min_scale, int max_scale,
82 			       bool can_position);
83 int intel_plane_check_src_coordinates(struct intel_plane_state *plane_state);
84 void intel_plane_set_invisible(struct intel_crtc_state *crtc_state,
85 			       struct intel_plane_state *plane_state);
86 void intel_plane_helper_add(struct intel_plane *plane);
87 bool intel_plane_needs_low_address(struct intel_display *display);
88 bool intel_plane_needs_physical(struct intel_plane *plane);
89 bool intel_plane_needs_fence(struct intel_display *display);
90 void intel_plane_init_cursor_vblank_work(struct intel_plane_state *old_plane_state,
91 					 struct intel_plane_state *new_plane_state);
92 int intel_plane_add_affected(struct intel_atomic_state *state,
93 			     struct intel_crtc *crtc);
94 int intel_plane_atomic_check(struct intel_atomic_state *state);
95 
96 bool intel_plane_format_mod_supported_async(struct drm_plane *plane,
97 					    u32 format,
98 					    u64 modifier);
99 int intel_plane_pin_fb(struct intel_plane_state *new_plane_state,
100 		       const struct intel_plane_state *old_plane_state);
101 void intel_plane_unpin_fb(struct intel_plane_state *old_plane_state);
102 
103 #endif /* __INTEL_PLANE_H__ */
104