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_TRANSFORM_H__
27 #define __DAL_TRANSFORM_H__
28 
29 #include "hw_shared.h"
30 #include "dc_hw_types.h"
31 #include "fixed31_32.h"
32 
33 #define CSC_TEMPERATURE_MATRIX_SIZE 12
34 
35 struct bit_depth_reduction_params;
36 
37 struct transform {
38 	const struct transform_funcs *funcs;
39 	struct dc_context *ctx;
40 	int inst;
41 	struct dpp_caps *caps;
42 	struct pwl_params regamma_params;
43 };
44 
45 /* Colorimetry */
46 enum colorimetry {
47 	COLORIMETRY_NO_DATA = 0,
48 	COLORIMETRY_ITU601 = 1,
49 	COLORIMETRY_ITU709 = 2,
50 	COLORIMETRY_EXTENDED = 3
51 };
52 
53 enum colorimetry_ext {
54 	COLORIMETRYEX_XVYCC601 = 0,
55 	COLORIMETRYEX_XVYCC709 = 1,
56 	COLORIMETRYEX_SYCC601 = 2,
57 	COLORIMETRYEX_ADOBEYCC601 = 3,
58 	COLORIMETRYEX_ADOBERGB = 4,
59 	COLORIMETRYEX_BT2020YCC = 5,
60 	COLORIMETRYEX_BT2020RGBYCBCR = 6,
61 	COLORIMETRYEX_RESERVED = 7
62 };
63 
64 enum active_format_info {
65 	ACTIVE_FORMAT_NO_DATA = 0,
66 	ACTIVE_FORMAT_VALID = 1
67 };
68 
69 /* Active format aspect ratio */
70 enum active_format_aspect_ratio {
71 	ACTIVE_FORMAT_ASPECT_RATIO_SAME_AS_PICTURE = 8,
72 	ACTIVE_FORMAT_ASPECT_RATIO_4_3 = 9,
73 	ACTIVE_FORMAT_ASPECT_RATIO_16_9 = 0XA,
74 	ACTIVE_FORMAT_ASPECT_RATIO_14_9 = 0XB
75 };
76 
77 enum bar_info {
78 	BAR_INFO_NOT_VALID = 0,
79 	BAR_INFO_VERTICAL_VALID = 1,
80 	BAR_INFO_HORIZONTAL_VALID = 2,
81 	BAR_INFO_BOTH_VALID = 3
82 };
83 
84 enum picture_scaling {
85 	PICTURE_SCALING_UNIFORM = 0,
86 	PICTURE_SCALING_HORIZONTAL = 1,
87 	PICTURE_SCALING_VERTICAL = 2,
88 	PICTURE_SCALING_BOTH = 3
89 };
90 
91 /* RGB quantization range */
92 enum rgb_quantization_range {
93 	RGB_QUANTIZATION_DEFAULT_RANGE = 0,
94 	RGB_QUANTIZATION_LIMITED_RANGE = 1,
95 	RGB_QUANTIZATION_FULL_RANGE = 2,
96 	RGB_QUANTIZATION_RESERVED = 3
97 };
98 
99 /* YYC quantization range */
100 enum yyc_quantization_range {
101 	YYC_QUANTIZATION_LIMITED_RANGE = 0,
102 	YYC_QUANTIZATION_FULL_RANGE = 1,
103 	YYC_QUANTIZATION_RESERVED2 = 2,
104 	YYC_QUANTIZATION_RESERVED3 = 3
105 };
106 
107 enum graphics_gamut_adjust_type {
108 	GRAPHICS_GAMUT_ADJUST_TYPE_BYPASS = 0,
109 	GRAPHICS_GAMUT_ADJUST_TYPE_HW, /* without adjustments */
110 	GRAPHICS_GAMUT_ADJUST_TYPE_SW /* use adjustments */
111 };
112 
113 enum lb_memory_config {
114 	/* Enable all 3 pieces of memory */
115 	LB_MEMORY_CONFIG_0 = 0,
116 
117 	/* Enable only the first piece of memory */
118 	LB_MEMORY_CONFIG_1 = 1,
119 
120 	/* Enable only the second piece of memory */
121 	LB_MEMORY_CONFIG_2 = 2,
122 
123 	/* Only applicable in 4:2:0 mode, enable all 3 pieces of memory and the
124 	 * last piece of chroma memory used for the luma storage
125 	 */
126 	LB_MEMORY_CONFIG_3 = 3
127 };
128 
129 struct xfm_grph_csc_adjustment {
130 	struct fixed31_32 temperature_matrix[CSC_TEMPERATURE_MATRIX_SIZE];
131 	enum graphics_gamut_adjust_type gamut_adjust_type;
132 };
133 
134 struct overscan_info {
135 	int left;
136 	int right;
137 	int top;
138 	int bottom;
139 };
140 
141 struct scaling_ratios {
142 	struct fixed31_32 horz;
143 	struct fixed31_32 vert;
144 	struct fixed31_32 horz_c;
145 	struct fixed31_32 vert_c;
146 };
147 
148 struct sharpness_adj {
149 	int horz;
150 	int vert;
151 };
152 
153 struct line_buffer_params {
154 	bool alpha_en;
155 	bool pixel_expan_mode;
156 	bool interleave_en;
157 	int dynamic_pixel_depth;
158 	enum lb_pixel_depth depth;
159 };
160 
161 struct scl_inits {
162 	struct fixed31_32 h;
163 	struct fixed31_32 h_c;
164 	struct fixed31_32 v;
165 	struct fixed31_32 v_bot;
166 	struct fixed31_32 v_c;
167 	struct fixed31_32 v_c_bot;
168 };
169 
170 struct scaler_data {
171 	int h_active;
172 	int v_active;
173 	struct scaling_taps taps;
174 	struct rect viewport;
175 	struct rect viewport_c;
176 	struct rect recout;
177 	struct scaling_ratios ratios;
178 	struct scl_inits inits;
179 	struct sharpness_adj sharpness;
180 	enum pixel_format format;
181 	struct line_buffer_params lb_params;
182 };
183 
184 struct transform_funcs {
185 	void (*transform_reset)(struct transform *xfm);
186 
187 	void (*transform_set_scaler)(struct transform *xfm,
188 			const struct scaler_data *scl_data);
189 
190 	void (*transform_set_pixel_storage_depth)(
191 			struct transform *xfm,
192 			enum lb_pixel_depth depth,
193 			const struct bit_depth_reduction_params *bit_depth_params);
194 
195 	bool (*transform_get_optimal_number_of_taps)(
196 			struct transform *xfm,
197 			struct scaler_data *scl_data,
198 			const struct scaling_taps *in_taps);
199 
200 	void (*transform_set_gamut_remap)(
201 			struct transform *xfm,
202 			const struct xfm_grph_csc_adjustment *adjust);
203 
204 	void (*opp_set_csc_default)(
205 		struct transform *xfm,
206 		const struct default_adjustment *default_adjust);
207 
208 	void (*opp_set_csc_adjustment)(
209 		struct transform *xfm,
210 		const struct out_csc_color_matrix *tbl_entry);
211 
212 	void (*opp_power_on_regamma_lut)(
213 		struct transform *xfm,
214 		bool power_on);
215 
216 	void (*opp_program_regamma_lut)(
217 			struct transform *xfm,
218 			const struct pwl_result_data *rgb,
219 			uint32_t num);
220 
221 	void (*opp_configure_regamma_lut)(
222 			struct transform *xfm,
223 			bool is_ram_a);
224 
225 	void (*opp_program_regamma_lutb_settings)(
226 			struct transform *xfm,
227 			const struct pwl_params *params);
228 
229 	void (*opp_program_regamma_luta_settings)(
230 			struct transform *xfm,
231 			const struct pwl_params *params);
232 
233 	void (*opp_program_regamma_pwl)(
234 		struct transform *xfm, const struct pwl_params *params);
235 
236 	void (*opp_set_regamma_mode)(
237 			struct transform *xfm_base,
238 			enum opp_regamma mode);
239 
240 	void (*ipp_set_degamma)(
241 			struct transform *xfm_base,
242 			enum ipp_degamma_mode mode);
243 
244 	void (*ipp_program_input_lut)(
245 			struct transform *xfm_base,
246 			const struct dc_gamma *gamma);
247 
248 	void (*ipp_program_degamma_pwl)(struct transform *xfm_base,
249 									 const struct pwl_params *params);
250 
251 	void (*ipp_setup)(
252 			struct transform *xfm_base,
253 			enum surface_pixel_format format,
254 			enum expansion_mode mode,
255 			struct dc_csc_transform input_csc_color_matrix,
256 			enum dc_color_space input_color_space);
257 
258 	void (*ipp_full_bypass)(struct transform *xfm_base);
259 
260 	void (*set_cursor_attributes)(
261 			struct transform *xfm_base,
262 			const struct dc_cursor_attributes *attr);
263 
264 };
265 
266 const uint16_t *get_filter_2tap_16p(void);
267 const uint16_t *get_filter_2tap_64p(void);
268 const uint16_t *get_filter_3tap_16p(struct fixed31_32 ratio);
269 const uint16_t *get_filter_3tap_64p(struct fixed31_32 ratio);
270 const uint16_t *get_filter_4tap_16p(struct fixed31_32 ratio);
271 const uint16_t *get_filter_4tap_64p(struct fixed31_32 ratio);
272 const uint16_t *get_filter_5tap_64p(struct fixed31_32 ratio);
273 const uint16_t *get_filter_6tap_64p(struct fixed31_32 ratio);
274 const uint16_t *get_filter_7tap_64p(struct fixed31_32 ratio);
275 const uint16_t *get_filter_8tap_64p(struct fixed31_32 ratio);
276 
277 
278 /* Defines the pixel processing capability of the DSCL */
279 enum dscl_data_processing_format {
280 	DSCL_DATA_PRCESSING_FIXED_FORMAT,	/* The DSCL processes pixel data in fixed format */
281 	DSCL_DATA_PRCESSING_FLOAT_FORMAT,	/* The DSCL processes pixel data in float format */
282 };
283 
284 /*
285  * The DPP capabilities structure contains enumerations to specify the
286  * HW processing features and an associated function pointers to
287  * provide the function interface that can be overloaded for implementations
288  * based on different capabilities
289  */
290 struct dpp_caps {
291 	/* DSCL processing pixel data in fixed or float format */
292 	enum dscl_data_processing_format dscl_data_proc_format;
293 
294 	/* Calculates the number of partitions in the line buffer.
295 	 * The implementation of this function is overloaded for
296 	 * different versions of DSCL LB.
297 	 */
298 	void (*dscl_calc_lb_num_partitions)(
299 			const struct scaler_data *scl_data,
300 			enum lb_memory_config lb_config,
301 			int *num_part_y,
302 			int *num_part_c);
303 };
304 
305 
306 #endif
307