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_OPP_H__
27 #define __DAL_OPP_H__
28 
29 #include "hw_shared.h"
30 #include "dc_hw_types.h"
31 #include "transform.h"
32 #include "mpc.h"
33 
34 struct fixed31_32;
35 
36 /* TODO: Need cleanup */
37 enum clamping_range {
38 	CLAMPING_FULL_RANGE = 0,	   /* No Clamping */
39 	CLAMPING_LIMITED_RANGE_8BPC,   /* 8  bpc: Clamping 1  to FE */
40 	CLAMPING_LIMITED_RANGE_10BPC, /* 10 bpc: Clamping 4  to 3FB */
41 	CLAMPING_LIMITED_RANGE_12BPC, /* 12 bpc: Clamping 10 to FEF */
42 	/* Use programmable clampping value on FMT_CLAMP_COMPONENT_R/G/B. */
43 	CLAMPING_LIMITED_RANGE_PROGRAMMABLE
44 };
45 
46 struct clamping_and_pixel_encoding_params {
47 	enum dc_pixel_encoding pixel_encoding; /* Pixel Encoding */
48 	enum clamping_range clamping_level; /* Clamping identifier */
49 	enum dc_color_depth c_depth; /* Deep color use. */
50 };
51 
52 struct bit_depth_reduction_params {
53 	struct {
54 		/* truncate/round */
55 		/* trunc/round enabled*/
56 		uint32_t TRUNCATE_ENABLED:1;
57 		/* 2 bits: 0=6 bpc, 1=8 bpc, 2 = 10bpc*/
58 		uint32_t TRUNCATE_DEPTH:2;
59 		/* truncate or round*/
60 		uint32_t TRUNCATE_MODE:1;
61 
62 		/* spatial dither */
63 		/* Spatial Bit Depth Reduction enabled*/
64 		uint32_t SPATIAL_DITHER_ENABLED:1;
65 		/* 2 bits: 0=6 bpc, 1 = 8 bpc, 2 = 10bpc*/
66 		uint32_t SPATIAL_DITHER_DEPTH:2;
67 		/* 0-3 to select patterns*/
68 		uint32_t SPATIAL_DITHER_MODE:2;
69 		/* Enable RGB random dithering*/
70 		uint32_t RGB_RANDOM:1;
71 		/* Enable Frame random dithering*/
72 		uint32_t FRAME_RANDOM:1;
73 		/* Enable HighPass random dithering*/
74 		uint32_t HIGHPASS_RANDOM:1;
75 
76 		/* temporal dither*/
77 		 /* frame modulation enabled*/
78 		uint32_t FRAME_MODULATION_ENABLED:1;
79 		/* same as for trunc/spatial*/
80 		uint32_t FRAME_MODULATION_DEPTH:2;
81 		/* 2/4 gray levels*/
82 		uint32_t TEMPORAL_LEVEL:1;
83 		uint32_t FRC25:2;
84 		uint32_t FRC50:2;
85 		uint32_t FRC75:2;
86 	} flags;
87 
88 	uint32_t r_seed_value;
89 	uint32_t b_seed_value;
90 	uint32_t g_seed_value;
91 	enum dc_pixel_encoding pixel_encoding;
92 };
93 
94 enum wide_gamut_regamma_mode {
95 	/*  0x0  - BITS2:0 Bypass */
96 	WIDE_GAMUT_REGAMMA_MODE_GRAPHICS_BYPASS,
97 	/*  0x1  - Fixed curve sRGB 2.4 */
98 	WIDE_GAMUT_REGAMMA_MODE_GRAPHICS_SRGB24,
99 	/*  0x2  - Fixed curve xvYCC 2.22 */
100 	WIDE_GAMUT_REGAMMA_MODE_GRAPHICS_XYYCC22,
101 	/*  0x3  - Programmable control A */
102 	WIDE_GAMUT_REGAMMA_MODE_GRAPHICS_MATRIX_A,
103 	/*  0x4  - Programmable control B */
104 	WIDE_GAMUT_REGAMMA_MODE_GRAPHICS_MATRIX_B,
105 	/*  0x0  - BITS6:4 Bypass */
106 	WIDE_GAMUT_REGAMMA_MODE_OVL_BYPASS,
107 	/*  0x1  - Fixed curve sRGB 2.4 */
108 	WIDE_GAMUT_REGAMMA_MODE_OVL_SRGB24,
109 	/*  0x2  - Fixed curve xvYCC 2.22 */
110 	WIDE_GAMUT_REGAMMA_MODE_OVL_XYYCC22,
111 	/*  0x3  - Programmable control A */
112 	WIDE_GAMUT_REGAMMA_MODE_OVL_MATRIX_A,
113 	/*  0x4  - Programmable control B */
114 	WIDE_GAMUT_REGAMMA_MODE_OVL_MATRIX_B
115 };
116 
117 struct gamma_pixel {
118 	struct fixed31_32 r;
119 	struct fixed31_32 g;
120 	struct fixed31_32 b;
121 };
122 
123 enum channel_name {
124 	CHANNEL_NAME_RED,
125 	CHANNEL_NAME_GREEN,
126 	CHANNEL_NAME_BLUE
127 };
128 
129 struct custom_float_format {
130 	uint32_t mantissa_bits;
131 	uint32_t exponenta_bits;
132 	bool sign;
133 };
134 
135 struct custom_float_value {
136 	uint32_t mantissa;
137 	uint32_t exponenta;
138 	uint32_t value;
139 	bool negative;
140 };
141 
142 struct hw_x_point {
143 	uint32_t custom_float_x;
144 	struct fixed31_32 x;
145 	struct fixed31_32 regamma_y_red;
146 	struct fixed31_32 regamma_y_green;
147 	struct fixed31_32 regamma_y_blue;
148 
149 };
150 
151 struct pwl_float_data_ex {
152 	struct fixed31_32 r;
153 	struct fixed31_32 g;
154 	struct fixed31_32 b;
155 	struct fixed31_32 delta_r;
156 	struct fixed31_32 delta_g;
157 	struct fixed31_32 delta_b;
158 };
159 
160 enum hw_point_position {
161 	/* hw point sits between left and right sw points */
162 	HW_POINT_POSITION_MIDDLE,
163 	/* hw point lays left from left (smaller) sw point */
164 	HW_POINT_POSITION_LEFT,
165 	/* hw point lays stays from right (bigger) sw point */
166 	HW_POINT_POSITION_RIGHT
167 };
168 
169 struct gamma_point {
170 	int32_t left_index;
171 	int32_t right_index;
172 	enum hw_point_position pos;
173 	struct fixed31_32 coeff;
174 };
175 
176 struct pixel_gamma_point {
177 	struct gamma_point r;
178 	struct gamma_point g;
179 	struct gamma_point b;
180 };
181 
182 struct gamma_coefficients {
183 	struct fixed31_32 a0[3];
184 	struct fixed31_32 a1[3];
185 	struct fixed31_32 a2[3];
186 	struct fixed31_32 a3[3];
187 	struct fixed31_32 user_gamma[3];
188 	struct fixed31_32 user_contrast;
189 	struct fixed31_32 user_brightness;
190 };
191 
192 struct pwl_float_data {
193 	struct fixed31_32 r;
194 	struct fixed31_32 g;
195 	struct fixed31_32 b;
196 };
197 
198 struct mpc_tree_cfg {
199 	int num_pipes;
200 	int dpp[MAX_PIPES];
201 	int mpcc[MAX_PIPES];
202 };
203 
204 struct output_pixel_processor {
205 	struct dc_context *ctx;
206 	uint32_t inst;
207 	struct pwl_params regamma_params;
208 	struct mpc_tree mpc_tree_params;
209 	bool mpcc_disconnect_pending[MAX_PIPES];
210 	const struct opp_funcs *funcs;
211 	uint32_t dyn_expansion;
212 };
213 
214 enum fmt_stereo_action {
215 	FMT_STEREO_ACTION_ENABLE = 0,
216 	FMT_STEREO_ACTION_DISABLE,
217 	FMT_STEREO_ACTION_UPDATE_POLARITY
218 };
219 
220 struct opp_grph_csc_adjustment {
221 	//enum grph_color_adjust_option color_adjust_option;
222 	enum dc_color_space c_space;
223 	enum dc_color_depth color_depth; /* clean up to uint32_t */
224 	enum graphics_csc_adjust_type   csc_adjust_type;
225 	int32_t adjust_divider;
226 	int32_t grph_cont;
227 	int32_t grph_sat;
228 	int32_t grph_bright;
229 	int32_t grph_hue;
230 };
231 
232 /* Underlay related types */
233 
234 struct hw_adjustment_range {
235 	int32_t hw_default;
236 	int32_t min;
237 	int32_t max;
238 	int32_t step;
239 	uint32_t divider; /* (actually HW range is min/divider; divider !=0) */
240 };
241 
242 enum ovl_csc_adjust_item {
243 	OVERLAY_BRIGHTNESS = 0,
244 	OVERLAY_GAMMA,
245 	OVERLAY_CONTRAST,
246 	OVERLAY_SATURATION,
247 	OVERLAY_HUE,
248 	OVERLAY_ALPHA,
249 	OVERLAY_ALPHA_PER_PIX,
250 	OVERLAY_COLOR_TEMPERATURE
251 };
252 
253 enum oppbuf_display_segmentation {
254 	OPPBUF_DISPLAY_SEGMENTATION_1_SEGMENT = 0,
255 	OPPBUF_DISPLAY_SEGMENTATION_2_SEGMENT = 1,
256 	OPPBUF_DISPLAY_SEGMENTATION_4_SEGMENT = 2,
257 	OPPBUF_DISPLAY_SEGMENTATION_4_SEGMENT_SPLIT_LEFT = 3,
258 	OPPBUF_DISPLAY_SEGMENTATION_4_SEGMENT_SPLIT_RIGHT = 4
259 };
260 
261 struct oppbuf_params {
262 	uint32_t active_width;
263 	enum oppbuf_display_segmentation mso_segmentation;
264 	uint32_t mso_overlap_pixel_num;
265 	uint32_t pixel_repetition;
266 	uint32_t num_segment_padded_pixels;
267 };
268 
269 struct opp_funcs {
270 
271 
272 	/* FORMATTER RELATED */
273 
274 	void (*opp_program_fmt)(
275 			struct output_pixel_processor *opp,
276 			struct bit_depth_reduction_params *fmt_bit_depth,
277 			struct clamping_and_pixel_encoding_params *clamping);
278 
279 	void (*opp_set_dyn_expansion)(
280 		struct output_pixel_processor *opp,
281 		enum dc_color_space color_sp,
282 		enum dc_color_depth color_dpth,
283 		enum signal_type signal);
284 
285 	void (*opp_program_bit_depth_reduction)(
286 		struct output_pixel_processor *opp,
287 		const struct bit_depth_reduction_params *params);
288 
289 	/* underlay related */
290 	void (*opp_get_underlay_adjustment_range)(
291 			struct output_pixel_processor *opp,
292 			enum ovl_csc_adjust_item overlay_adjust_item,
293 			struct hw_adjustment_range *range);
294 
295 	void (*opp_destroy)(struct output_pixel_processor **opp);
296 
297 	void (*opp_program_stereo)(
298 		struct output_pixel_processor *opp,
299 		bool enable,
300 		const struct dc_crtc_timing *timing);
301 
302 	void (*opp_pipe_clock_control)(
303 			struct output_pixel_processor *opp,
304 			bool enable);
305 
306 	void (*opp_set_disp_pattern_generator)(
307 			struct output_pixel_processor *opp,
308 			enum controller_dp_test_pattern test_pattern,
309 			enum controller_dp_color_space color_space,
310 			enum dc_color_depth color_depth,
311 			const struct tg_color *solid_color,
312 			int width,
313 			int height,
314 			int offset);
315 
316 	void (*opp_program_dpg_dimensions)(
317 				struct output_pixel_processor *opp,
318 				int width,
319 				int height);
320 
321 	bool (*dpg_is_blanked)(
322 			struct output_pixel_processor *opp);
323 
324 	void (*opp_dpg_set_blank_color)(
325 			struct output_pixel_processor *opp,
326 			const struct tg_color *color);
327 
328 	void (*opp_program_left_edge_extra_pixel)(
329 			struct output_pixel_processor *opp,
330 			bool count);
331 
332 };
333 
334 #endif
335