1 /* Copyright 2012-15 Advanced Micro Devices, Inc.
2  *
3  * Permission is hereby granted, free of charge, to any person obtaining a
4  * copy of this software and associated documentation files (the "Software"),
5  * to deal in the Software without restriction, including without limitation
6  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
7  * and/or sell copies of the Software, and to permit persons to whom the
8  * Software is furnished to do so, subject to the following conditions:
9  *
10  * The above copyright notice and this permission notice shall be included in
11  * all copies or substantial portions of the Software.
12  *
13  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
16  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
17  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
18  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
19  * OTHER DEALINGS IN THE SOFTWARE.
20  *
21  * Authors: AMD
22  *
23  */
24 
25 /**
26  * DOC: mpc-overview
27  *
28  * Multiple Pipe/Plane Combined (MPC) is a component in the hardware pipeline
29  * that performs blending of multiple planes, using global and per-pixel alpha.
30  * It also performs post-blending color correction operations according to the
31  * hardware capabilities, such as color transformation matrix and gamma 1D and
32  * 3D LUT.
33  */
34 
35 #ifndef __DC_MPCC_H__
36 #define __DC_MPCC_H__
37 
38 #include "dc_hw_types.h"
39 #include "hw_shared.h"
40 #include "transform.h"
41 
42 #define MAX_MPCC 6
43 #define MAX_OPP 6
44 
45 #define MAX_DWB		2
46 
47 enum mpc_output_csc_mode {
48 	MPC_OUTPUT_CSC_DISABLE = 0,
49 	MPC_OUTPUT_CSC_COEF_A,
50 	MPC_OUTPUT_CSC_COEF_B
51 };
52 
53 
54 enum mpcc_blend_mode {
55 	MPCC_BLEND_MODE_BYPASS,
56 	MPCC_BLEND_MODE_TOP_LAYER_PASSTHROUGH,
57 	MPCC_BLEND_MODE_TOP_LAYER_ONLY,
58 	MPCC_BLEND_MODE_TOP_BOT_BLENDING
59 };
60 
61 /**
62  * enum mpcc_alpha_blend_mode - define the alpha blend mode regarding pixel
63  * alpha and plane alpha values
64  */
65 enum mpcc_alpha_blend_mode {
66 	/**
67 	 * @MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA: per pixel alpha using DPP
68 	 * alpha value
69 	 */
70 	MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA,
71 	/**
72 	 * @MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA_COMBINED_GLOBAL_GAIN: per
73 	 * pixel alpha using DPP alpha value multiplied by a global gain (plane
74 	 * alpha)
75 	 */
76 	MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA_COMBINED_GLOBAL_GAIN,
77 	/**
78 	 * @MPCC_ALPHA_BLEND_MODE_GLOBAL_ALPHA: global alpha value, ignores
79 	 * pixel alpha and consider only plane alpha
80 	 */
81 	MPCC_ALPHA_BLEND_MODE_GLOBAL_ALPHA
82 };
83 
84 /**
85  * struct mpcc_blnd_cfg - MPCC blending configuration
86  *
87  * @black_color: background color
88  * @alpha_mode: alpha blend mode (MPCC_ALPHA_BLND_MODE)
89  * @pre_multiplied_alpha: whether pixel color values were pre-multiplied by the
90  * alpha channel (MPCC_ALPHA_MULTIPLIED_MODE)
91  * @global_gain: used when blend mode considers both pixel alpha and plane
92  * alpha value and assumes the global alpha value.
93  * @global_alpha: plane alpha value
94  */
95 struct mpcc_blnd_cfg {
96 	struct tg_color black_color;	/* background color */
97 	enum mpcc_alpha_blend_mode alpha_mode;	/* alpha blend mode */
98 	bool pre_multiplied_alpha;	/* alpha pre-multiplied mode flag */
99 	int global_gain;
100 	int global_alpha;
101 	bool overlap_only;
102 
103 	/* MPCC top/bottom gain settings */
104 	int bottom_gain_mode;
105 	int background_color_bpc;
106 	int top_gain;
107 	int bottom_inside_gain;
108 	int bottom_outside_gain;
109 };
110 
111 struct mpc_grph_gamut_adjustment {
112 	struct fixed31_32 temperature_matrix[CSC_TEMPERATURE_MATRIX_SIZE];
113 	enum graphics_gamut_adjust_type gamut_adjust_type;
114 };
115 
116 struct mpcc_sm_cfg {
117 	bool enable;
118 	/* 0-single plane,2-row subsampling,4-column subsampling,6-checkboard subsampling */
119 	int sm_mode;
120 	/* 0- disable frame alternate, 1- enable frame alternate */
121 	bool frame_alt;
122 	/* 0- disable field alternate, 1- enable field alternate */
123 	bool field_alt;
124 	/* 0-no force,2-force frame polarity from top,3-force frame polarity from bottom */
125 	int force_next_frame_porlarity;
126 	/* 0-no force,2-force field polarity from top,3-force field polarity from bottom */
127 	int force_next_field_polarity;
128 };
129 
130 struct mpc_denorm_clamp {
131 	int clamp_max_r_cr;
132 	int clamp_min_r_cr;
133 	int clamp_max_g_y;
134 	int clamp_min_g_y;
135 	int clamp_max_b_cb;
136 	int clamp_min_b_cb;
137 };
138 
139 struct mpc_dwb_flow_control {
140 	int flow_ctrl_mode;
141 	int flow_ctrl_cnt0;
142 	int flow_ctrl_cnt1;
143 };
144 
145 /**
146  * struct mpcc - MPCC connection and blending configuration for a single MPCC instance.
147  * @mpcc_id: MPCC physical instance
148  * @dpp_id: DPP input to this MPCC
149  * @mpcc_bot: pointer to bottom layer MPCC. NULL when not connected.
150  * @blnd_cfg: the blending configuration for this MPCC
151  * @sm_cfg: stereo mix setting for this MPCC
152  * @shared_bottom: if MPCC output to both OPP and DWB endpoints, true. Otherwise, false.
153  *
154  * This struct is used as a node in an MPC tree.
155  */
156 struct mpcc {
157 	int mpcc_id;			/* MPCC physical instance */
158 	int dpp_id;			/* DPP input to this MPCC */
159 	struct mpcc *mpcc_bot;		/* pointer to bottom layer MPCC.  NULL when not connected */
160 	struct mpcc_blnd_cfg blnd_cfg;	/* The blending configuration for this MPCC */
161 	struct mpcc_sm_cfg sm_cfg;	/* stereo mix setting for this MPCC */
162 	bool shared_bottom;		/* TRUE if MPCC output to both OPP and DWB endpoints, else FALSE */
163 };
164 
165 /**
166  * struct mpc_tree - MPC tree represents all MPCC connections for a pipe.
167  *
168  * @opp_id: the OPP instance that owns this MPC tree
169  * @opp_list: the top MPCC layer of the MPC tree that outputs to OPP endpoint
170  *
171  */
172 struct mpc_tree {
173 	int opp_id;			/* The OPP instance that owns this MPC tree */
174 	struct mpcc *opp_list;		/* The top MPCC layer of the MPC tree that outputs to OPP endpoint */
175 };
176 
177 struct mpc {
178 	const struct mpc_funcs *funcs;
179 	struct dc_context *ctx;
180 
181 	struct mpcc mpcc_array[MAX_MPCC];
182 	struct pwl_params blender_params;
183 	bool cm_bypass_mode;
184 };
185 
186 struct mpcc_state {
187 	uint32_t opp_id;
188 	uint32_t dpp_id;
189 	uint32_t bot_mpcc_id;
190 	uint32_t mode;
191 	uint32_t alpha_mode;
192 	uint32_t pre_multiplied_alpha;
193 	uint32_t overlap_only;
194 	uint32_t idle;
195 	uint32_t busy;
196 };
197 
198 /**
199  * struct mpc_funcs - funcs
200  */
201 struct mpc_funcs {
202 	void (*read_mpcc_state)(
203 			struct mpc *mpc,
204 			int mpcc_inst,
205 			struct mpcc_state *s);
206 
207 	/**
208 	 * @insert_plane:
209 	 *
210 	 * Insert DPP into MPC tree based on specified blending position.
211 	 * Only used for planes that are part of blending chain for OPP output
212 	 *
213 	 * Parameters:
214 	 * [in/out] mpc		- MPC context.
215 	 * [in/out] tree	- MPC tree structure that plane will be added to.
216 	 * [in]	blnd_cfg	- MPCC blending configuration for the new blending layer.
217 	 * [in]	sm_cfg		- MPCC stereo mix configuration for the new blending layer.
218 	 *			  stereo mix must disable for the very bottom layer of the tree config.
219 	 * [in]	insert_above_mpcc - Insert new plane above this MPCC.  If NULL, insert as bottom plane.
220 	 * [in]	dpp_id		 - DPP instance for the plane to be added.
221 	 * [in]	mpcc_id		 - The MPCC physical instance to use for blending.
222 	 *
223 	 * Return:  struct mpcc* - MPCC that was added.
224 	 */
225 	struct mpcc* (*insert_plane)(
226 			struct mpc *mpc,
227 			struct mpc_tree *tree,
228 			struct mpcc_blnd_cfg *blnd_cfg,
229 			struct mpcc_sm_cfg *sm_cfg,
230 			struct mpcc *insert_above_mpcc,
231 			int dpp_id,
232 			int mpcc_id);
233 
234 	/**
235 	 * @remove_mpcc:
236 	 *
237 	 * Remove a specified MPCC from the MPC tree.
238 	 *
239 	 * Parameters:
240 	 * [in/out] mpc		- MPC context.
241 	 * [in/out] tree	- MPC tree structure that plane will be removed from.
242 	 * [in/out] mpcc	- MPCC to be removed from tree.
243 	 *
244 	 * Return:  void
245 	 */
246 	void (*remove_mpcc)(
247 			struct mpc *mpc,
248 			struct mpc_tree *tree,
249 			struct mpcc *mpcc);
250 
251 	/**
252 	 * @mpc_init:
253 	 *
254 	 * Reset the MPCC HW status by disconnecting all muxes.
255 	 *
256 	 * Parameters:
257 	 * [in/out] mpc		- MPC context.
258 	 *
259 	 * Return:  void
260 	 */
261 	void (*mpc_init)(struct mpc *mpc);
262 	void (*mpc_init_single_inst)(
263 			struct mpc *mpc,
264 			unsigned int mpcc_id);
265 
266 	/**
267 	 * @update_blending:
268 	 *
269 	 * Update the blending configuration for a specified MPCC.
270 	 *
271 	 * Parameters:
272 	 * [in/out] mpc		- MPC context.
273 	 * [in]     blnd_cfg	- MPCC blending configuration.
274 	 * [in]     mpcc_id	- The MPCC physical instance.
275 	 *
276 	 * Return:  void
277 	 */
278 	void (*update_blending)(
279 		struct mpc *mpc,
280 		struct mpcc_blnd_cfg *blnd_cfg,
281 		int mpcc_id);
282 
283 	/**
284 	 * @cursor_lock:
285 	 *
286 	 * Lock cursor updates for the specified OPP.
287 	 * OPP defines the set of MPCC that are locked together for cursor.
288 	 *
289 	 * Parameters:
290 	 * [in] 	mpc		- MPC context.
291 	 * [in]     opp_id	- The OPP to lock cursor updates on
292 	 * [in]		lock	- lock/unlock the OPP
293 	 *
294 	 * Return:  void
295 	 */
296 	void (*cursor_lock)(
297 			struct mpc *mpc,
298 			int opp_id,
299 			bool lock);
300 
301 	/**
302 	 * @insert_plane_to_secondary:
303 	 *
304 	 * Add DPP into secondary MPC tree based on specified blending position.
305 	 * Only used for planes that are part of blending chain for DWB output
306 	 *
307 	 * Parameters:
308 	 * [in/out] mpc		- MPC context.
309 	 * [in/out] tree		- MPC tree structure that plane will be added to.
310 	 * [in]	blnd_cfg	- MPCC blending configuration for the new blending layer.
311 	 * [in]	sm_cfg		- MPCC stereo mix configuration for the new blending layer.
312 	 *			  stereo mix must disable for the very bottom layer of the tree config.
313 	 * [in]	insert_above_mpcc - Insert new plane above this MPCC.  If NULL, insert as bottom plane.
314 	 * [in]	dpp_id		- DPP instance for the plane to be added.
315 	 * [in]	mpcc_id		- The MPCC physical instance to use for blending.
316 	 *
317 	 * Return:  struct mpcc* - MPCC that was added.
318 	 */
319 	struct mpcc* (*insert_plane_to_secondary)(
320 			struct mpc *mpc,
321 			struct mpc_tree *tree,
322 			struct mpcc_blnd_cfg *blnd_cfg,
323 			struct mpcc_sm_cfg *sm_cfg,
324 			struct mpcc *insert_above_mpcc,
325 			int dpp_id,
326 			int mpcc_id);
327 
328 	/**
329 	 * @remove_mpcc_from_secondary:
330 	 *
331 	 * Remove a specified DPP from the 'secondary' MPC tree.
332 	 *
333 	 * Parameters:
334 	 * [in/out] mpc		- MPC context.
335 	 * [in/out] tree	- MPC tree structure that plane will be removed from.
336 	 * [in]     mpcc	- MPCC to be removed from tree.
337 	 * Return:  void
338 	 */
339 	void (*remove_mpcc_from_secondary)(
340 			struct mpc *mpc,
341 			struct mpc_tree *tree,
342 			struct mpcc *mpcc);
343 
344 	struct mpcc* (*get_mpcc_for_dpp_from_secondary)(
345 			struct mpc_tree *tree,
346 			int dpp_id);
347 
348 	struct mpcc* (*get_mpcc_for_dpp)(
349 			struct mpc_tree *tree,
350 			int dpp_id);
351 
352 	void (*wait_for_idle)(struct mpc *mpc, int id);
353 
354 	void (*assert_mpcc_idle_before_connect)(struct mpc *mpc, int mpcc_id);
355 
356 	void (*init_mpcc_list_from_hw)(
357 		struct mpc *mpc,
358 		struct mpc_tree *tree);
359 
360 	void (*set_denorm)(struct mpc *mpc,
361 			int opp_id,
362 			enum dc_color_depth output_depth);
363 
364 	void (*set_denorm_clamp)(
365 			struct mpc *mpc,
366 			int opp_id,
367 			struct mpc_denorm_clamp denorm_clamp);
368 
369 	void (*set_output_csc)(struct mpc *mpc,
370 			int opp_id,
371 			const uint16_t *regval,
372 			enum mpc_output_csc_mode ocsc_mode);
373 
374 	void (*set_ocsc_default)(struct mpc *mpc,
375 			int opp_id,
376 			enum dc_color_space color_space,
377 			enum mpc_output_csc_mode ocsc_mode);
378 
379 	void (*set_output_gamma)(
380 			struct mpc *mpc,
381 			int mpcc_id,
382 			const struct pwl_params *params);
383 	void (*power_on_mpc_mem_pwr)(
384 			struct mpc *mpc,
385 			int mpcc_id,
386 			bool power_on);
387 	void (*set_dwb_mux)(
388 			struct mpc *mpc,
389 			int dwb_id,
390 			int mpcc_id);
391 
392 	void (*disable_dwb_mux)(
393 		struct mpc *mpc,
394 		int dwb_id);
395 
396 	bool (*is_dwb_idle)(
397 		struct mpc *mpc,
398 		int dwb_id);
399 
400 	void (*set_out_rate_control)(
401 		struct mpc *mpc,
402 		int opp_id,
403 		bool enable,
404 		bool rate_2x_mode,
405 		struct mpc_dwb_flow_control *flow_control);
406 
407 	void (*set_gamut_remap)(
408 			struct mpc *mpc,
409 			int mpcc_id,
410 			const struct mpc_grph_gamut_adjustment *adjust);
411 
412 	bool (*program_1dlut)(
413 			struct mpc *mpc,
414 			const struct pwl_params *params,
415 			uint32_t rmu_idx);
416 
417 	bool (*program_shaper)(
418 			struct mpc *mpc,
419 			const struct pwl_params *params,
420 			uint32_t rmu_idx);
421 
422 	uint32_t (*acquire_rmu)(struct mpc *mpc, int mpcc_id, int rmu_idx);
423 
424 	bool (*program_3dlut)(
425 			struct mpc *mpc,
426 			const struct tetrahedral_params *params,
427 			int rmu_idx);
428 
429 	int (*release_rmu)(struct mpc *mpc, int mpcc_id);
430 
431 	unsigned int (*get_mpc_out_mux)(
432 			struct mpc *mpc,
433 			int opp_id);
434 
435 	void (*set_bg_color)(struct mpc *mpc,
436 			struct tg_color *bg_color,
437 			int mpcc_id);
438 	void (*set_mpc_mem_lp_mode)(struct mpc *mpc);
439 };
440 
441 #endif
442