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