linux/drivers/gpu/drm/amd/display/dc/inc/hw/transform.h
<<
>>
Prefs
   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
 308