drivers/gpu/drm/amd/display/dc/inc/hw/mpc.h

   1 /* Copyright 2012-15 Advanced Micro Devices, Inc.
   2  *
   3  * Permission is hereby granted, free of charge, to any person obtaining a
   4  * copy of this software and associated documentation files (the "Software"),
   5  * to deal in the Software without restriction, including without limitation
   6  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   7  * and/or sell copies of the Software, and to permit persons to whom the
   8  * Software is furnished to do so, subject to the following conditions:
   9  *
  10  * The above copyright notice and this permission notice shall be included in
  11  * all copies or substantial portions of the Software.
  12  *
  13  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  15  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  16  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  17  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  18  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  19  * OTHER DEALINGS IN THE SOFTWARE.
  20  *
  21  * Authors: AMD
  22  *
  23  */
  24
  25 #ifndef __DC_MPCC_H__
  26 #define __DC_MPCC_H__
  27
  28 #include "dc_hw_types.h"
  29 #include "hw_shared.h"
  30 #include "transform.h"
  31
  32 #define MAX_MPCC 6
  33 #define MAX_OPP 6
  34
  35 #define MAX_DWB         2
  36
  37 enum mpc_output_csc_mode {
  38         MPC_OUTPUT_CSC_DISABLE = 0,
  39         MPC_OUTPUT_CSC_COEF_A,
  40         MPC_OUTPUT_CSC_COEF_B
  41 };
  42
  43
  44 enum mpcc_blend_mode {
  45         MPCC_BLEND_MODE_BYPASS,
  46         MPCC_BLEND_MODE_TOP_LAYER_PASSTHROUGH,
  47         MPCC_BLEND_MODE_TOP_LAYER_ONLY,
  48         MPCC_BLEND_MODE_TOP_BOT_BLENDING
  49 };
  50
  51 enum mpcc_alpha_blend_mode {
  52         MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA,
  53         MPCC_ALPHA_BLEND_MODE_PER_PIXEL_ALPHA_COMBINED_GLOBAL_GAIN,
  54         MPCC_ALPHA_BLEND_MODE_GLOBAL_ALPHA
  55 };
  56
  57 /*
  58  * MPCC blending configuration
  59  */
  60 struct mpcc_blnd_cfg {
  61         struct tg_color black_color;    /* background color */
  62         enum mpcc_alpha_blend_mode alpha_mode;  /* alpha blend mode */
  63         bool pre_multiplied_alpha;      /* alpha pre-multiplied mode flag */
  64         int global_gain;
  65         int global_alpha;
  66         bool overlap_only;
  67
  68         /* MPCC top/bottom gain settings */
  69         int bottom_gain_mode;
  70         int background_color_bpc;
  71         int top_gain;
  72         int bottom_inside_gain;
  73         int bottom_outside_gain;
  74 };
  75
  76 struct mpc_grph_gamut_adjustment {
  77         struct fixed31_32 temperature_matrix[CSC_TEMPERATURE_MATRIX_SIZE];
  78         enum graphics_gamut_adjust_type gamut_adjust_type;
  79 };
  80
  81 struct mpcc_sm_cfg {
  82         bool enable;
  83         /* 0-single plane,2-row subsampling,4-column subsampling,6-checkboard subsampling */
  84         int sm_mode;
  85         /* 0- disable frame alternate, 1- enable frame alternate */
  86         bool frame_alt;
  87         /* 0- disable field alternate, 1- enable field alternate */
  88         bool field_alt;
  89         /* 0-no force,2-force frame polarity from top,3-force frame polarity from bottom */
  90         int force_next_frame_porlarity;
  91         /* 0-no force,2-force field polarity from top,3-force field polarity from bottom */
  92         int force_next_field_polarity;
  93 };
  94
  95 struct mpc_denorm_clamp {
  96         int clamp_max_r_cr;
  97         int clamp_min_r_cr;
  98         int clamp_max_g_y;
  99         int clamp_min_g_y;
 100         int clamp_max_b_cb;
 101         int clamp_min_b_cb;
 102 };
 103
 104 struct mpc_dwb_flow_control {
 105         int flow_ctrl_mode;
 106         int flow_ctrl_cnt0;
 107         int flow_ctrl_cnt1;
 108 };
 109
 110 /*
 111  * MPCC connection and blending configuration for a single MPCC instance.
 112  * This struct is used as a node in an MPC tree.
 113  */
 114 struct mpcc {
 115         int mpcc_id;                    /* MPCC physical instance */
 116         int dpp_id;                     /* DPP input to this MPCC */
 117         struct mpcc *mpcc_bot;          /* pointer to bottom layer MPCC.  NULL when not connected */
 118         struct mpcc_blnd_cfg blnd_cfg;  /* The blending configuration for this MPCC */
 119         struct mpcc_sm_cfg sm_cfg;      /* stereo mix setting for this MPCC */
 120         bool shared_bottom;             /* TRUE if MPCC output to both OPP and DWB endpoints, else FALSE */
 121 };
 122
 123 /*
 124  * MPC tree represents all MPCC connections for a pipe.
 125  */
 126 struct mpc_tree {
 127         int opp_id;                     /* The OPP instance that owns this MPC tree */
 128         struct mpcc *opp_list;          /* The top MPCC layer of the MPC tree that outputs to OPP endpoint */
 129 };
 130
 131 struct mpc {
 132         const struct mpc_funcs *funcs;
 133         struct dc_context *ctx;
 134
 135         struct mpcc mpcc_array[MAX_MPCC];
 136         struct pwl_params blender_params;
 137         bool cm_bypass_mode;
 138 };
 139
 140 struct mpcc_state {
 141         uint32_t opp_id;
 142         uint32_t dpp_id;
 143         uint32_t bot_mpcc_id;
 144         uint32_t mode;
 145         uint32_t alpha_mode;
 146         uint32_t pre_multiplied_alpha;
 147         uint32_t overlap_only;
 148         uint32_t idle;
 149         uint32_t busy;
 150 };
 151
 152 struct mpc_funcs {
 153         void (*read_mpcc_state)(
 154                         struct mpc *mpc,
 155                         int mpcc_inst,
 156                         struct mpcc_state *s);
 157
 158         /*
 159          * Insert DPP into MPC tree based on specified blending position.
 160          * Only used for planes that are part of blending chain for OPP output
 161          *
 162          * Parameters:
 163          * [in/out] mpc         - MPC context.
 164          * [in/out] tree        - MPC tree structure that plane will be added to.
 165          * [in] blnd_cfg        - MPCC blending configuration for the new blending layer.
 166          * [in] sm_cfg          - MPCC stereo mix configuration for the new blending layer.
 167          *                        stereo mix must disable for the very bottom layer of the tree config.
 168          * [in] insert_above_mpcc - Insert new plane above this MPCC.  If NULL, insert as bottom plane.
 169          * [in] dpp_id           - DPP instance for the plane to be added.
 170          * [in] mpcc_id          - The MPCC physical instance to use for blending.
 171          *
 172          * Return:  struct mpcc* - MPCC that was added.
 173          */
 174         struct mpcc* (*insert_plane)(
 175                         struct mpc *mpc,
 176                         struct mpc_tree *tree,
 177                         struct mpcc_blnd_cfg *blnd_cfg,
 178                         struct mpcc_sm_cfg *sm_cfg,
 179                         struct mpcc *insert_above_mpcc,
 180                         int dpp_id,
 181                         int mpcc_id);
 182
 183         /*
 184          * Remove a specified MPCC from the MPC tree.
 185          *
 186          * Parameters:
 187          * [in/out] mpc         - MPC context.
 188          * [in/out] tree        - MPC tree structure that plane will be removed from.
 189          * [in/out] mpcc        - MPCC to be removed from tree.
 190          *
 191          * Return:  void
 192          */
 193         void (*remove_mpcc)(
 194                         struct mpc *mpc,
 195                         struct mpc_tree *tree,
 196                         struct mpcc *mpcc);
 197
 198         /*
 199          * Reset the MPCC HW status by disconnecting all muxes.
 200          *
 201          * Parameters:
 202          * [in/out] mpc         - MPC context.
 203          *
 204          * Return:  void
 205          */
 206         void (*mpc_init)(struct mpc *mpc);
 207         void (*mpc_init_single_inst)(
 208                         struct mpc *mpc,
 209                         unsigned int mpcc_id);
 210
 211         /*
 212          * Update the blending configuration for a specified MPCC.
 213          *
 214          * Parameters:
 215          * [in/out] mpc         - MPC context.
 216          * [in]     blnd_cfg    - MPCC blending configuration.
 217          * [in]     mpcc_id     - The MPCC physical instance.
 218          *
 219          * Return:  void
 220          */
 221         void (*update_blending)(
 222                 struct mpc *mpc,
 223                 struct mpcc_blnd_cfg *blnd_cfg,
 224                 int mpcc_id);
 225
 226         /*
 227          * Lock cursor updates for the specified OPP.
 228          * OPP defines the set of MPCC that are locked together for cursor.
 229          *
 230          * Parameters:
 231          * [in]         mpc             - MPC context.
 232          * [in]     opp_id      - The OPP to lock cursor updates on
 233          * [in]         lock    - lock/unlock the OPP
 234          *
 235          * Return:  void
 236          */
 237         void (*cursor_lock)(
 238                         struct mpc *mpc,
 239                         int opp_id,
 240                         bool lock);
 241
 242         /*
 243          * Add DPP into 'secondary' MPC tree based on specified blending position.
 244          * Only used for planes that are part of blending chain for DWB output
 245          *
 246          * Parameters:
 247          * [in/out] mpc         - MPC context.
 248          * [in/out] tree                - MPC tree structure that plane will be added to.
 249          * [in] blnd_cfg        - MPCC blending configuration for the new blending layer.
 250          * [in] sm_cfg          - MPCC stereo mix configuration for the new blending layer.
 251          *                        stereo mix must disable for the very bottom layer of the tree config.
 252          * [in] insert_above_mpcc - Insert new plane above this MPCC.  If NULL, insert as bottom plane.
 253          * [in] dpp_id          - DPP instance for the plane to be added.
 254          * [in] mpcc_id         - The MPCC physical instance to use for blending.
 255          *
 256          * Return:  struct mpcc* - MPCC that was added.
 257          */
 258         struct mpcc* (*insert_plane_to_secondary)(
 259                         struct mpc *mpc,
 260                         struct mpc_tree *tree,
 261                         struct mpcc_blnd_cfg *blnd_cfg,
 262                         struct mpcc_sm_cfg *sm_cfg,
 263                         struct mpcc *insert_above_mpcc,
 264                         int dpp_id,
 265                         int mpcc_id);
 266
 267         /*
 268          * Remove a specified DPP from the 'secondary' MPC tree.
 269          *
 270          * Parameters:
 271          * [in/out] mpc         - MPC context.
 272          * [in/out] tree        - MPC tree structure that plane will be removed from.
 273          * [in]     mpcc        - MPCC to be removed from tree.
 274          * Return:  void
 275          */
 276         void (*remove_mpcc_from_secondary)(
 277                         struct mpc *mpc,
 278                         struct mpc_tree *tree,
 279                         struct mpcc *mpcc);
 280
 281         struct mpcc* (*get_mpcc_for_dpp_from_secondary)(
 282                         struct mpc_tree *tree,
 283                         int dpp_id);
 284         struct mpcc* (*get_mpcc_for_dpp)(
 285                         struct mpc_tree *tree,
 286                         int dpp_id);
 287
 288         void (*wait_for_idle)(struct mpc *mpc, int id);
 289
 290         void (*assert_mpcc_idle_before_connect)(struct mpc *mpc, int mpcc_id);
 291
 292         void (*init_mpcc_list_from_hw)(
 293                 struct mpc *mpc,
 294                 struct mpc_tree *tree);
 295
 296         void (*set_denorm)(struct mpc *mpc,
 297                         int opp_id,
 298                         enum dc_color_depth output_depth);
 299
 300         void (*set_denorm_clamp)(
 301                         struct mpc *mpc,
 302                         int opp_id,
 303                         struct mpc_denorm_clamp denorm_clamp);
 304
 305         void (*set_output_csc)(struct mpc *mpc,
 306                         int opp_id,
 307                         const uint16_t *regval,
 308                         enum mpc_output_csc_mode ocsc_mode);
 309
 310         void (*set_ocsc_default)(struct mpc *mpc,
 311                         int opp_id,
 312                         enum dc_color_space color_space,
 313                         enum mpc_output_csc_mode ocsc_mode);
 314
 315         void (*set_output_gamma)(
 316                         struct mpc *mpc,
 317                         int mpcc_id,
 318                         const struct pwl_params *params);
 319         void (*power_on_mpc_mem_pwr)(
 320                         struct mpc *mpc,
 321                         int mpcc_id,
 322                         bool power_on);
 323         void (*set_dwb_mux)(
 324                         struct mpc *mpc,
 325                         int dwb_id,
 326                         int mpcc_id);
 327
 328         void (*disable_dwb_mux)(
 329                 struct mpc *mpc,
 330                 int dwb_id);
 331
 332         bool (*is_dwb_idle)(
 333                 struct mpc *mpc,
 334                 int dwb_id);
 335
 336         void (*set_out_rate_control)(
 337                 struct mpc *mpc,
 338                 int opp_id,
 339                 bool enable,
 340                 bool rate_2x_mode,
 341                 struct mpc_dwb_flow_control *flow_control);
 342
 343         void (*set_gamut_remap)(
 344                         struct mpc *mpc,
 345                         int mpcc_id,
 346                         const struct mpc_grph_gamut_adjustment *adjust);
 347
 348         bool (*program_shaper)(
 349                         struct mpc *mpc,
 350                         const struct pwl_params *params,
 351                         uint32_t rmu_idx);
 352
 353         uint32_t (*acquire_rmu)(struct mpc *mpc, int mpcc_id, int rmu_idx);
 354
 355         bool (*program_3dlut)(
 356                         struct mpc *mpc,
 357                         const struct tetrahedral_params *params,
 358                         int rmu_idx);
 359
 360         int (*release_rmu)(struct mpc *mpc, int mpcc_id);
 361
 362         unsigned int (*get_mpc_out_mux)(
 363                         struct mpc *mpc,
 364                         int opp_id);
 365
 366 };
 367
 368 #endif