xref: /openbmc/linux/drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h (revision 9a8f3203)
1 /*
2  * Copyright 2012-15 Advanced Micro Devices, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  * Authors: AMD
23  *
24  */
25 
26 #ifndef __DAL_HUBP_H__
27 #define __DAL_HUBP_H__
28 
29 #include "mem_input.h"
30 
31 
32 enum cursor_pitch {
33 	CURSOR_PITCH_64_PIXELS = 0,
34 	CURSOR_PITCH_128_PIXELS,
35 	CURSOR_PITCH_256_PIXELS
36 };
37 
38 enum cursor_lines_per_chunk {
39 	CURSOR_LINE_PER_CHUNK_2 = 1,
40 	CURSOR_LINE_PER_CHUNK_4,
41 	CURSOR_LINE_PER_CHUNK_8,
42 	CURSOR_LINE_PER_CHUNK_16
43 };
44 
45 struct hubp {
46 	const struct hubp_funcs *funcs;
47 	struct dc_context *ctx;
48 	struct dc_plane_address request_address;
49 	int inst;
50 
51 	/* run time states */
52 	int opp_id;
53 	int mpcc_id;
54 	struct dc_cursor_attributes curs_attr;
55 	bool power_gated;
56 };
57 
58 struct hubp_funcs {
59 	void (*hubp_setup)(
60 			struct hubp *hubp,
61 			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
62 			struct _vcs_dpi_display_ttu_regs_st *ttu_regs,
63 			struct _vcs_dpi_display_rq_regs_st *rq_regs,
64 			struct _vcs_dpi_display_pipe_dest_params_st *pipe_dest);
65 
66 	void (*hubp_setup_interdependent)(
67 			struct hubp *hubp,
68 			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
69 			struct _vcs_dpi_display_ttu_regs_st *ttu_regs);
70 
71 	void (*dcc_control)(struct hubp *hubp, bool enable,
72 			bool independent_64b_blks);
73 	void (*mem_program_viewport)(
74 			struct hubp *hubp,
75 			const struct rect *viewport,
76 			const struct rect *viewport_c);
77 
78 	bool (*hubp_program_surface_flip_and_addr)(
79 		struct hubp *hubp,
80 		const struct dc_plane_address *address,
81 		bool flip_immediate,
82 		uint8_t vmid);
83 
84 	void (*hubp_program_pte_vm)(
85 		struct hubp *hubp,
86 		enum surface_pixel_format format,
87 		union dc_tiling_info *tiling_info,
88 		enum dc_rotation_angle rotation);
89 
90 	void (*hubp_set_vm_system_aperture_settings)(
91 			struct hubp *hubp,
92 			struct vm_system_aperture_param *apt);
93 
94 	void (*hubp_set_vm_context0_settings)(
95 			struct hubp *hubp,
96 			const struct vm_context0_param *vm0);
97 
98 	void (*hubp_program_surface_config)(
99 		struct hubp *hubp,
100 		enum surface_pixel_format format,
101 		union dc_tiling_info *tiling_info,
102 		union plane_size *plane_size,
103 		enum dc_rotation_angle rotation,
104 		struct dc_plane_dcc_param *dcc,
105 		bool horizontal_mirror,
106 		unsigned int compa_level);
107 
108 	bool (*hubp_is_flip_pending)(struct hubp *hubp);
109 
110 	void (*hubp_update_dchub)(struct hubp *hubp,
111 				struct dchub_init_data *dh_data);
112 
113 	void (*set_blank)(struct hubp *hubp, bool blank);
114 	void (*set_hubp_blank_en)(struct hubp *hubp, bool blank);
115 
116 	void (*set_cursor_attributes)(
117 			struct hubp *hubp,
118 			const struct dc_cursor_attributes *attr);
119 
120 	void (*set_cursor_position)(
121 			struct hubp *hubp,
122 			const struct dc_cursor_position *pos,
123 			const struct dc_cursor_mi_param *param);
124 
125 	void (*hubp_disconnect)(struct hubp *hubp);
126 
127 	void (*hubp_clk_cntl)(struct hubp *hubp, bool enable);
128 	void (*hubp_vtg_sel)(struct hubp *hubp, uint32_t otg_inst);
129 	void (*hubp_read_state)(struct hubp *hubp);
130 	void (*hubp_clear_underflow)(struct hubp *hubp);
131 	void (*hubp_disable_control)(struct hubp *hubp, bool disable_hubp);
132 	unsigned int (*hubp_get_underflow_status)(struct hubp *hubp);
133 
134 };
135 
136 #endif
137