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_c; 166 }; 167 168 struct 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 182 struct 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 264 const uint16_t *get_filter_2tap_16p(void); 265 const uint16_t *get_filter_2tap_64p(void); 266 const uint16_t *get_filter_3tap_16p(struct fixed31_32 ratio); 267 const uint16_t *get_filter_3tap_64p(struct fixed31_32 ratio); 268 const uint16_t *get_filter_4tap_16p(struct fixed31_32 ratio); 269 const uint16_t *get_filter_4tap_64p(struct fixed31_32 ratio); 270 const uint16_t *get_filter_5tap_64p(struct fixed31_32 ratio); 271 const uint16_t *get_filter_6tap_64p(struct fixed31_32 ratio); 272 const uint16_t *get_filter_7tap_64p(struct fixed31_32 ratio); 273 const uint16_t *get_filter_8tap_64p(struct fixed31_32 ratio); 274 275 276 /* Defines the pixel processing capability of the DSCL */ 277 enum 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 */ 288 struct 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 308