Loading...
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
35struct bit_depth_reduction_params;
36
37struct 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 */
46enum colorimetry {
47 COLORIMETRY_NO_DATA = 0,
48 COLORIMETRY_ITU601 = 1,
49 COLORIMETRY_ITU709 = 2,
50 COLORIMETRY_EXTENDED = 3
51};
52
53enum 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
64enum active_format_info {
65 ACTIVE_FORMAT_NO_DATA = 0,
66 ACTIVE_FORMAT_VALID = 1
67};
68
69/* Active format aspect ratio */
70enum 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
77enum 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
84enum 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 */
92enum 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 */
100enum 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
107enum 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
113enum 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
129struct 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
134struct overscan_info {
135 int left;
136 int right;
137 int top;
138 int bottom;
139};
140
141struct 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
148struct sharpness_adj {
149 int horz;
150 int vert;
151};
152
153struct 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
161struct scl_inits {
162 struct fixed31_32 h;
163 struct fixed31_32 h_c;
164 struct fixed31_32 v;
165 struct fixed31_32 v_c;
166};
167
168struct scaler_data {
169 int h_active;
170 int v_active;
171 struct scaling_taps taps;
172 struct rect viewport;
173 struct rect viewport_c;
174 struct rect recout;
175 struct scaling_ratios ratios;
176 struct scl_inits inits;
177 struct sharpness_adj sharpness;
178 enum pixel_format format;
179 struct line_buffer_params lb_params;
180};
181
182struct transform_funcs {
183 void (*transform_reset)(struct transform *xfm);
184
185 void (*transform_set_scaler)(struct transform *xfm,
186 const struct scaler_data *scl_data);
187
188 void (*transform_set_pixel_storage_depth)(
189 struct transform *xfm,
190 enum lb_pixel_depth depth,
191 const struct bit_depth_reduction_params *bit_depth_params);
192
193 bool (*transform_get_optimal_number_of_taps)(
194 struct transform *xfm,
195 struct scaler_data *scl_data,
196 const struct scaling_taps *in_taps);
197
198 void (*transform_set_gamut_remap)(
199 struct transform *xfm,
200 const struct xfm_grph_csc_adjustment *adjust);
201
202 void (*opp_set_csc_default)(
203 struct transform *xfm,
204 const struct default_adjustment *default_adjust);
205
206 void (*opp_set_csc_adjustment)(
207 struct transform *xfm,
208 const struct out_csc_color_matrix *tbl_entry);
209
210 void (*opp_power_on_regamma_lut)(
211 struct transform *xfm,
212 bool power_on);
213
214 void (*opp_program_regamma_lut)(
215 struct transform *xfm,
216 const struct pwl_result_data *rgb,
217 uint32_t num);
218
219 void (*opp_configure_regamma_lut)(
220 struct transform *xfm,
221 bool is_ram_a);
222
223 void (*opp_program_regamma_lutb_settings)(
224 struct transform *xfm,
225 const struct pwl_params *params);
226
227 void (*opp_program_regamma_luta_settings)(
228 struct transform *xfm,
229 const struct pwl_params *params);
230
231 void (*opp_program_regamma_pwl)(
232 struct transform *xfm, const struct pwl_params *params);
233
234 void (*opp_set_regamma_mode)(
235 struct transform *xfm_base,
236 enum opp_regamma mode);
237
238 void (*ipp_set_degamma)(
239 struct transform *xfm_base,
240 enum ipp_degamma_mode mode);
241
242 void (*ipp_program_input_lut)(
243 struct transform *xfm_base,
244 const struct dc_gamma *gamma);
245
246 void (*ipp_program_degamma_pwl)(struct transform *xfm_base,
247 const struct pwl_params *params);
248
249 void (*ipp_setup)(
250 struct transform *xfm_base,
251 enum surface_pixel_format format,
252 enum expansion_mode mode,
253 struct dc_csc_transform input_csc_color_matrix,
254 enum dc_color_space input_color_space);
255
256 void (*ipp_full_bypass)(struct transform *xfm_base);
257
258 void (*set_cursor_attributes)(
259 struct transform *xfm_base,
260 const struct dc_cursor_attributes *attr);
261
262};
263
264const uint16_t *get_filter_2tap_16p(void);
265const uint16_t *get_filter_2tap_64p(void);
266const uint16_t *get_filter_3tap_16p(struct fixed31_32 ratio);
267const uint16_t *get_filter_3tap_64p(struct fixed31_32 ratio);
268const uint16_t *get_filter_4tap_16p(struct fixed31_32 ratio);
269const uint16_t *get_filter_4tap_64p(struct fixed31_32 ratio);
270const uint16_t *get_filter_5tap_64p(struct fixed31_32 ratio);
271const uint16_t *get_filter_6tap_64p(struct fixed31_32 ratio);
272const uint16_t *get_filter_7tap_64p(struct fixed31_32 ratio);
273const uint16_t *get_filter_8tap_64p(struct fixed31_32 ratio);
274
275
276/* Defines the pixel processing capability of the DSCL */
277enum dscl_data_processing_format {
278 DSCL_DATA_PRCESSING_FIXED_FORMAT, /* The DSCL processes pixel data in fixed format */
279 DSCL_DATA_PRCESSING_FLOAT_FORMAT, /* The DSCL processes pixel data in float format */
280};
281
282/*
283 * The DPP capabilities structure contains enumerations to specify the
284 * HW processing features and an associated function pointers to
285 * provide the function interface that can be overloaded for implementations
286 * based on different capabilities
287 */
288struct dpp_caps {
289 /* DSCL processing pixel data in fixed or float format */
290 enum dscl_data_processing_format dscl_data_proc_format;
291
292 /* max LB partitions */
293 unsigned int max_lb_partitions;
294
295 /* Calculates the number of partitions in the line buffer.
296 * The implementation of this function is overloaded for
297 * different versions of DSCL LB.
298 */
299 void (*dscl_calc_lb_num_partitions)(
300 const struct scaler_data *scl_data,
301 enum lb_memory_config lb_config,
302 int *num_part_y,
303 int *num_part_c);
304};
305
306
307#endif
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
35struct bit_depth_reduction_params;
36
37struct 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 */
46enum colorimetry {
47 COLORIMETRY_NO_DATA = 0,
48 COLORIMETRY_ITU601 = 1,
49 COLORIMETRY_ITU709 = 2,
50 COLORIMETRY_EXTENDED = 3
51};
52
53enum 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
64enum active_format_info {
65 ACTIVE_FORMAT_NO_DATA = 0,
66 ACTIVE_FORMAT_VALID = 1
67};
68
69/* Active format aspect ratio */
70enum 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
77enum 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
84enum 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 */
92enum 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 */
100enum 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
107enum 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
113enum 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
129struct 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
134struct overscan_info {
135 int left;
136 int right;
137 int top;
138 int bottom;
139};
140
141struct 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
148struct sharpness_adj {
149 int horz;
150 int vert;
151};
152
153struct 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
161struct 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
170struct 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 viewport_unadjusted;
177 struct rect viewport_c_unadjusted;
178 struct rect recout;
179 struct scaling_ratios ratios;
180 struct scl_inits inits;
181 struct sharpness_adj sharpness;
182 enum pixel_format format;
183 struct line_buffer_params lb_params;
184};
185
186struct transform_funcs {
187 void (*transform_reset)(struct transform *xfm);
188
189 void (*transform_set_scaler)(struct transform *xfm,
190 const struct scaler_data *scl_data);
191
192 void (*transform_set_pixel_storage_depth)(
193 struct transform *xfm,
194 enum lb_pixel_depth depth,
195 const struct bit_depth_reduction_params *bit_depth_params);
196
197 bool (*transform_get_optimal_number_of_taps)(
198 struct transform *xfm,
199 struct scaler_data *scl_data,
200 const struct scaling_taps *in_taps);
201
202 void (*transform_set_gamut_remap)(
203 struct transform *xfm,
204 const struct xfm_grph_csc_adjustment *adjust);
205
206 void (*opp_set_csc_default)(
207 struct transform *xfm,
208 const struct default_adjustment *default_adjust);
209
210 void (*opp_set_csc_adjustment)(
211 struct transform *xfm,
212 const struct out_csc_color_matrix *tbl_entry);
213
214 void (*opp_power_on_regamma_lut)(
215 struct transform *xfm,
216 bool power_on);
217
218 void (*opp_program_regamma_lut)(
219 struct transform *xfm,
220 const struct pwl_result_data *rgb,
221 uint32_t num);
222
223 void (*opp_configure_regamma_lut)(
224 struct transform *xfm,
225 bool is_ram_a);
226
227 void (*opp_program_regamma_lutb_settings)(
228 struct transform *xfm,
229 const struct pwl_params *params);
230
231 void (*opp_program_regamma_luta_settings)(
232 struct transform *xfm,
233 const struct pwl_params *params);
234
235 void (*opp_program_regamma_pwl)(
236 struct transform *xfm, const struct pwl_params *params);
237
238 void (*opp_set_regamma_mode)(
239 struct transform *xfm_base,
240 enum opp_regamma mode);
241
242 void (*ipp_set_degamma)(
243 struct transform *xfm_base,
244 enum ipp_degamma_mode mode);
245
246 void (*ipp_program_input_lut)(
247 struct transform *xfm_base,
248 const struct dc_gamma *gamma);
249
250 void (*ipp_program_degamma_pwl)(struct transform *xfm_base,
251 const struct pwl_params *params);
252
253 void (*ipp_setup)(
254 struct transform *xfm_base,
255 enum surface_pixel_format format,
256 enum expansion_mode mode,
257 struct dc_csc_transform input_csc_color_matrix,
258 enum dc_color_space input_color_space);
259
260 void (*ipp_full_bypass)(struct transform *xfm_base);
261
262 void (*set_cursor_attributes)(
263 struct transform *xfm_base,
264 const struct dc_cursor_attributes *attr);
265
266};
267
268const uint16_t *get_filter_2tap_16p(void);
269const uint16_t *get_filter_2tap_64p(void);
270const uint16_t *get_filter_3tap_16p(struct fixed31_32 ratio);
271const uint16_t *get_filter_3tap_64p(struct fixed31_32 ratio);
272const uint16_t *get_filter_4tap_16p(struct fixed31_32 ratio);
273const uint16_t *get_filter_4tap_64p(struct fixed31_32 ratio);
274const uint16_t *get_filter_5tap_64p(struct fixed31_32 ratio);
275const uint16_t *get_filter_6tap_64p(struct fixed31_32 ratio);
276const uint16_t *get_filter_7tap_64p(struct fixed31_32 ratio);
277const uint16_t *get_filter_8tap_64p(struct fixed31_32 ratio);
278
279
280/* Defines the pixel processing capability of the DSCL */
281enum dscl_data_processing_format {
282 DSCL_DATA_PRCESSING_FIXED_FORMAT, /* The DSCL processes pixel data in fixed format */
283 DSCL_DATA_PRCESSING_FLOAT_FORMAT, /* The DSCL processes pixel data in float format */
284};
285
286/*
287 * The DPP capabilities structure contains enumerations to specify the
288 * HW processing features and an associated function pointers to
289 * provide the function interface that can be overloaded for implementations
290 * based on different capabilities
291 */
292struct dpp_caps {
293 /* DSCL processing pixel data in fixed or float format */
294 enum dscl_data_processing_format dscl_data_proc_format;
295
296 /* Calculates the number of partitions in the line buffer.
297 * The implementation of this function is overloaded for
298 * different versions of DSCL LB.
299 */
300 void (*dscl_calc_lb_num_partitions)(
301 const struct scaler_data *scl_data,
302 enum lb_memory_config lb_config,
303 int *num_part_y,
304 int *num_part_c);
305};
306
307
308#endif