drivers/gpu/drm/amd/display/dc/dml2/dml2_wrapper.h

   1 /* SPDX-License-Identifier: MIT */
   2 /*
   3  * Copyright 2023 Advanced Micro Devices, Inc.
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
  19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  21  * OTHER DEALINGS IN THE SOFTWARE.
  22  *
  23  * Authors: AMD
  24  *
  25  */
  26
  27 #ifndef _DML2_WRAPPER_H_
  28 #define _DML2_WRAPPER_H_
  29
  30 #include "os_types.h"
  31
  32 #define DML2_MAX_NUM_DPM_LVL 30
  33
  34 struct dml2_context;
  35 struct display_mode_lib_st;
  36 struct dc;
  37 struct pipe_ctx;
  38 struct dc_plane_state;
  39 struct dc_sink;
  40 struct dc_stream_state;
  41 struct resource_context;
  42 struct display_stream_compressor;
  43
  44 // Configuration of the MALL on the SoC
  45 struct dml2_soc_mall_info {
  46         // Cache line size of 0 means MALL is not enabled/present
  47         unsigned int cache_line_size_bytes;
  48         unsigned int cache_num_ways;
  49         unsigned int max_cab_allocation_bytes;
  50
  51         unsigned int mblk_width_pixels;
  52         unsigned int mblk_size_bytes;
  53         unsigned int mblk_height_4bpe_pixels;
  54         unsigned int mblk_height_8bpe_pixels;
  55 };
  56
  57 // Output of DML2 for clock requirements
  58 struct dml2_dcn_clocks {
  59         unsigned int dispclk_khz;
  60         unsigned int dcfclk_khz;
  61         unsigned int fclk_khz;
  62         unsigned int uclk_mts;
  63         unsigned int phyclk_khz;
  64         unsigned int socclk_khz;
  65         unsigned int ref_dtbclk_khz;
  66         bool p_state_supported;
  67         unsigned int cab_num_ways_required;
  68         unsigned int dcfclk_khz_ds;
  69 };
  70
  71 struct dml2_dc_callbacks {
  72         struct dc *dc;
  73         bool (*build_scaling_params)(struct pipe_ctx *pipe_ctx);
  74         bool (*can_support_mclk_switch_using_fw_based_vblank_stretch)(struct dc *dc, struct dc_state *context);
  75         bool (*acquire_secondary_pipe_for_mpc_odm)(const struct dc *dc, struct dc_state *state, struct pipe_ctx *pri_pipe, struct pipe_ctx *sec_pipe, bool odm);
  76         bool (*update_pipes_for_stream_with_slice_count)(
  77                         struct dc_state *new_ctx,
  78                         const struct dc_state *cur_ctx,
  79                         const struct resource_pool *pool,
  80                         const struct dc_stream_state *stream,
  81                         int new_slice_count);
  82         bool (*update_pipes_for_plane_with_slice_count)(
  83                         struct dc_state *new_ctx,
  84                         const struct dc_state *cur_ctx,
  85                         const struct resource_pool *pool,
  86                         const struct dc_plane_state *plane,
  87                         int slice_count);
  88         int (*get_odm_slice_index)(const struct pipe_ctx *opp_head);
  89         int (*get_mpc_slice_index)(const struct pipe_ctx *dpp_pipe);
  90         struct pipe_ctx *(*get_opp_head)(const struct pipe_ctx *pipe_ctx);
  91 };
  92
  93 struct dml2_dc_svp_callbacks {
  94         struct dc *dc;
  95         bool (*build_scaling_params)(struct pipe_ctx *pipe_ctx);
  96         struct dc_stream_state* (*create_stream_for_sink)(struct dc_sink *dc_sink_data);
  97         struct dc_plane_state* (*create_plane)(struct dc *dc);
  98         enum dc_status (*add_stream_to_ctx)(struct dc *dc, struct dc_state *new_ctx, struct dc_stream_state *dc_stream);
  99         bool (*add_plane_to_context)(const struct dc *dc, struct dc_stream_state *stream, struct dc_plane_state *plane_state, struct dc_state *context);
 100         bool (*remove_plane_from_context)(const struct dc *dc, struct dc_stream_state *stream, struct dc_plane_state *plane_state, struct dc_state *context);
 101         enum dc_status (*remove_stream_from_ctx)(struct dc *dc, struct dc_state *new_ctx, struct dc_stream_state *stream);
 102         void (*plane_state_release)(struct dc_plane_state *plane_state);
 103         void (*stream_release)(struct dc_stream_state *stream);
 104         void (*release_dsc)(struct resource_context *res_ctx, const struct resource_pool *pool, struct display_stream_compressor **dsc);
 105 };
 106
 107 struct dml2_clks_table_entry {
 108         unsigned int dcfclk_mhz;
 109         unsigned int fclk_mhz;
 110         unsigned int memclk_mhz;
 111         unsigned int socclk_mhz;
 112         unsigned int dtbclk_mhz;
 113         unsigned int dispclk_mhz;
 114         unsigned int dppclk_mhz;
 115 };
 116
 117 struct dml2_clks_num_entries {
 118         unsigned int num_dcfclk_levels;
 119         unsigned int num_fclk_levels;
 120         unsigned int num_memclk_levels;
 121         unsigned int num_socclk_levels;
 122         unsigned int num_dtbclk_levels;
 123         unsigned int num_dispclk_levels;
 124         unsigned int num_dppclk_levels;
 125 };
 126
 127 struct dml2_clks_limit_table {
 128         struct dml2_clks_table_entry clk_entries[DML2_MAX_NUM_DPM_LVL];
 129         struct dml2_clks_num_entries num_entries_per_clk;
 130         unsigned int num_states;
 131 };
 132
 133 // Various overrides, per ASIC or per SKU specific, or for debugging purpose when/if available
 134 struct dml2_soc_bbox_overrides {
 135         double xtalclk_mhz;
 136         double dchub_refclk_mhz;
 137         double dprefclk_mhz;
 138         double disp_pll_vco_speed_mhz;
 139         double urgent_latency_us;
 140         double sr_exit_latency_us;
 141         double sr_enter_plus_exit_latency_us;
 142         double sr_exit_z8_time_us;
 143         double sr_enter_plus_exit_z8_time_us;
 144         double dram_clock_change_latency_us;
 145         double fclk_change_latency_us;
 146         unsigned int dram_num_chan;
 147         unsigned int dram_chanel_width_bytes;
 148         struct dml2_clks_limit_table clks_table;
 149 };
 150
 151 struct dml2_configuration_options {
 152         int dcn_pipe_count;
 153         bool use_native_pstate_optimization;
 154         bool enable_windowed_mpo_odm;
 155         bool use_native_soc_bb_construction;
 156         bool skip_hw_state_mapping;
 157         bool optimize_odm_4to1;
 158         bool minimize_dispclk_using_odm;
 159         bool override_det_buffer_size_kbytes;
 160         struct dml2_dc_callbacks callbacks;
 161         struct {
 162                 bool force_disable_subvp;
 163                 bool force_enable_subvp;
 164                 unsigned int subvp_fw_processing_delay_us;
 165                 unsigned int subvp_pstate_allow_width_us;
 166                 unsigned int subvp_prefetch_end_to_mall_start_us;
 167                 unsigned int subvp_swath_height_margin_lines;
 168                 struct dml2_dc_svp_callbacks callbacks;
 169         } svp_pstate;
 170         struct dml2_soc_mall_info mall_cfg;
 171         struct dml2_soc_bbox_overrides bbox_overrides;
 172         unsigned int max_segments_per_hubp;
 173         unsigned int det_segment_size;
 174         bool map_dc_pipes_with_callbacks;
 175 };
 176
 177 /*
 178  * dml2_create - Creates dml2_context.
 179  * @in_dc: dc.
 180  * @config: dml2 configuration options.
 181  * @dml2: Created dml2 context.
 182  *
 183  * Create and destroy of DML2 is done as part of dc_state creation
 184  * and dc_state_free. DML2 IP, SOC and STATES are initialized at
 185  * creation time.
 186  *
 187  * Return: True if dml2 is successfully created, false otherwise.
 188  */
 189 bool dml2_create(const struct dc *in_dc,
 190                                  const struct dml2_configuration_options *config,
 191                                  struct dml2_context **dml2);
 192
 193 void dml2_destroy(struct dml2_context *dml2);
 194
 195 /*
 196  * dml2_validate - Determines if a display configuration is supported or not.
 197  * @in_dc: dc.
 198  * @context: dc_state to be validated.
 199  * @fast_validate: Fast validate will not populate context.res_ctx.
 200  *
 201  * DML1.0 compatible interface for validation.
 202  *
 203  * Based on fast_validate option internally would call:
 204  *
 205  * -dml2_validate_and_build_resource - for non fast_validate option
 206  * Calculates if dc_state can be supported on the SOC, and attempts to
 207  * optimize the power management feature supports versus minimum clocks.
 208  * If supported, also builds out_new_hw_state to represent the hw programming
 209  * for the new dc state.
 210  *
 211  * -dml2_validate_only - for fast_validate option
 212  * Calculates if dc_state can be supported on the SOC (i.e. at maximum
 213  * clocks) with all mandatory power features enabled.
 214
 215  * Context: Two threads may not invoke this function concurrently unless they reference
 216  *          separate dc_states for validation.
 217  * Return: True if mode is supported, false otherwise.
 218  */
 219 bool dml2_validate(const struct dc *in_dc,
 220                                    struct dc_state *context,
 221                                    bool fast_validate);
 222
 223 /*
 224  * dml2_extract_dram_and_fclk_change_support - Extracts the FCLK and UCLK change support info.
 225  * @dml2: input dml2 context pointer.
 226  * @fclk_change_support: output pointer holding the fclk change support info (vactive, vblank, unsupported).
 227  * @dram_clk_change_support: output pointer holding the uclk change support info (vactive, vblank, unsupported).
 228  */
 229 void dml2_extract_dram_and_fclk_change_support(struct dml2_context *dml2,
 230         unsigned int *fclk_change_support, unsigned int *dram_clk_change_support);
 231
 232 #endif //_DML2_WRAPPER_H_