xref: /openbmc/linux/drivers/gpu/drm/amd/display/dc/inc/hw/hubp.h (revision f17f06a0)
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 #define OPP_ID_INVALID 0xf
32 
33 
34 enum cursor_pitch {
35 	CURSOR_PITCH_64_PIXELS = 0,
36 	CURSOR_PITCH_128_PIXELS,
37 	CURSOR_PITCH_256_PIXELS
38 };
39 
40 enum cursor_lines_per_chunk {
41 	CURSOR_LINE_PER_CHUNK_1 = 0, /* new for DCN2 */
42 	CURSOR_LINE_PER_CHUNK_2 = 1,
43 	CURSOR_LINE_PER_CHUNK_4,
44 	CURSOR_LINE_PER_CHUNK_8,
45 	CURSOR_LINE_PER_CHUNK_16
46 };
47 
48 enum hubp_ind_block_size {
49 	hubp_ind_block_unconstrained = 0,
50 	hubp_ind_block_64b,
51 };
52 
53 struct hubp {
54 	const struct hubp_funcs *funcs;
55 	struct dc_context *ctx;
56 	struct dc_plane_address request_address;
57 	int inst;
58 
59 	/* run time states */
60 	int opp_id;
61 	int mpcc_id;
62 	struct dc_cursor_attributes curs_attr;
63 	bool power_gated;
64 };
65 
66 struct surface_flip_registers {
67 	uint32_t DCSURF_SURFACE_CONTROL;
68 	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_HIGH;
69 	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS;
70 	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_HIGH;
71 	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS;
72 	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_HIGH_C;
73 	uint32_t DCSURF_PRIMARY_META_SURFACE_ADDRESS_C;
74 	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_HIGH_C;
75 	uint32_t DCSURF_PRIMARY_SURFACE_ADDRESS_C;
76 	uint32_t DCSURF_SECONDARY_META_SURFACE_ADDRESS_HIGH;
77 	uint32_t DCSURF_SECONDARY_META_SURFACE_ADDRESS;
78 	uint32_t DCSURF_SECONDARY_SURFACE_ADDRESS_HIGH;
79 	uint32_t DCSURF_SECONDARY_SURFACE_ADDRESS;
80 	bool tmz_surface;
81 	bool immediate;
82 	uint8_t vmid;
83 	bool grph_stereo;
84 };
85 
86 struct hubp_funcs {
87 	void (*hubp_setup)(
88 			struct hubp *hubp,
89 			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
90 			struct _vcs_dpi_display_ttu_regs_st *ttu_regs,
91 			struct _vcs_dpi_display_rq_regs_st *rq_regs,
92 			struct _vcs_dpi_display_pipe_dest_params_st *pipe_dest);
93 
94 	void (*hubp_setup_interdependent)(
95 			struct hubp *hubp,
96 			struct _vcs_dpi_display_dlg_regs_st *dlg_regs,
97 			struct _vcs_dpi_display_ttu_regs_st *ttu_regs);
98 
99 	void (*dcc_control)(struct hubp *hubp, bool enable,
100 			enum hubp_ind_block_size blk_size);
101 
102 	void (*mem_program_viewport)(
103 			struct hubp *hubp,
104 			const struct rect *viewport,
105 			const struct rect *viewport_c);
106 
107 	void (*apply_PLAT_54186_wa)(struct hubp *hubp,
108 			const struct dc_plane_address *address);
109 
110 	bool (*hubp_program_surface_flip_and_addr)(
111 		struct hubp *hubp,
112 		const struct dc_plane_address *address,
113 		bool flip_immediate);
114 
115 	void (*hubp_program_pte_vm)(
116 		struct hubp *hubp,
117 		enum surface_pixel_format format,
118 		union dc_tiling_info *tiling_info,
119 		enum dc_rotation_angle rotation);
120 
121 	void (*hubp_set_vm_system_aperture_settings)(
122 			struct hubp *hubp,
123 			struct vm_system_aperture_param *apt);
124 
125 	void (*hubp_set_vm_context0_settings)(
126 			struct hubp *hubp,
127 			const struct vm_context0_param *vm0);
128 
129 	void (*hubp_program_surface_config)(
130 		struct hubp *hubp,
131 		enum surface_pixel_format format,
132 		union dc_tiling_info *tiling_info,
133 		struct plane_size *plane_size,
134 		enum dc_rotation_angle rotation,
135 		struct dc_plane_dcc_param *dcc,
136 		bool horizontal_mirror,
137 		unsigned int compa_level);
138 
139 	bool (*hubp_is_flip_pending)(struct hubp *hubp);
140 
141 	void (*set_blank)(struct hubp *hubp, bool blank);
142 	void (*set_hubp_blank_en)(struct hubp *hubp, bool blank);
143 
144 	void (*set_cursor_attributes)(
145 			struct hubp *hubp,
146 			const struct dc_cursor_attributes *attr);
147 
148 	void (*set_cursor_position)(
149 			struct hubp *hubp,
150 			const struct dc_cursor_position *pos,
151 			const struct dc_cursor_mi_param *param);
152 
153 	void (*hubp_disconnect)(struct hubp *hubp);
154 
155 	void (*hubp_clk_cntl)(struct hubp *hubp, bool enable);
156 	void (*hubp_vtg_sel)(struct hubp *hubp, uint32_t otg_inst);
157 	void (*hubp_read_state)(struct hubp *hubp);
158 	void (*hubp_clear_underflow)(struct hubp *hubp);
159 	void (*hubp_disable_control)(struct hubp *hubp, bool disable_hubp);
160 	unsigned int (*hubp_get_underflow_status)(struct hubp *hubp);
161 	void (*hubp_init)(struct hubp *hubp);
162 
163 	void (*dmdata_set_attributes)(
164 			struct hubp *hubp,
165 			const struct dc_dmdata_attributes *attr);
166 
167 	void (*dmdata_load)(
168 			struct hubp *hubp,
169 			uint32_t dmdata_sw_size,
170 			const uint32_t *dmdata_sw_data);
171 	bool (*dmdata_status_done)(struct hubp *hubp);
172 	void (*hubp_enable_tripleBuffer)(
173 		struct hubp *hubp,
174 		bool enable);
175 
176 	bool (*hubp_is_triplebuffer_enabled)(
177 		struct hubp *hubp);
178 
179 	void (*hubp_set_flip_control_surface_gsl)(
180 		struct hubp *hubp,
181 		bool enable);
182 
183 	void (*validate_dml_output)(
184 			struct hubp *hubp,
185 			struct dc_context *ctx,
186 			struct _vcs_dpi_display_rq_regs_st *dml_rq_regs,
187 			struct _vcs_dpi_display_dlg_regs_st *dml_dlg_attr,
188 			struct _vcs_dpi_display_ttu_regs_st *dml_ttu_attr);
189 
190 };
191 
192 #endif
193