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 */ 24 25 #ifndef _DML2_UTILS_H_ 26 #define _DML2_UTILS_H_ 27 28 #include "os_types.h" 29 #include "dml2_dc_types.h" 30 31 struct dc; 32 struct dml_timing_cfg_st; 33 struct dml2_dcn_clocks; 34 struct dc_state; 35 36 void dml2_util_copy_dml_timing(struct dml_timing_cfg_st *dml_timing_array, unsigned int dst_index, unsigned int src_index); 37 void dml2_util_copy_dml_plane(struct dml_plane_cfg_st *dml_plane_array, unsigned int dst_index, unsigned int src_index); 38 void dml2_util_copy_dml_surface(struct dml_surface_cfg_st *dml_surface_array, unsigned int dst_index, unsigned int src_index); 39 void dml2_util_copy_dml_output(struct dml_output_cfg_st *dml_output_array, unsigned int dst_index, unsigned int src_index); 40 unsigned int dml2_util_get_maximum_odm_combine_for_output(bool force_odm_4to1, enum dml_output_encoder_class encoder, bool dsc_enabled); 41 void dml2_copy_clocks_to_dc_state(struct dml2_dcn_clocks *out_clks, struct dc_state *context); 42 void dml2_extract_watermark_set(struct dcn_watermarks *watermark, struct display_mode_lib_st *dml_core_ctx); 43 int dml2_helper_find_dml_pipe_idx_by_stream_id(struct dml2_context *ctx, unsigned int stream_id); 44 bool is_dtbclk_required(const struct dc *dc, struct dc_state *context); 45 bool dml2_is_stereo_timing(struct dc_stream_state *stream); 46 47 /* 48 * dml2_dc_construct_pipes - This function will determine if we need additional pipes based 49 * on the DML calculated outputs for MPC, ODM and allocate them as necessary. This function 50 * could be called after in dml_validate_build_resource after dml_mode_pragramming like : 51 * { 52 * ... 53 * map_hw_resources(&s->cur_display_config, &s->mode_support_info); 54 * result = dml_mode_programming(&in_ctx->dml_core_ctx, s->mode_support_params.out_lowest_state_idx, &s->cur_display_config, true); 55 * dml2_dc_construct_pipes(in_display_state, s->mode_support_info, out_hw_context); 56 * ... 57 * } 58 * 59 * @context: To obtain res_ctx and read other information like stream ID etc. 60 * @dml_mode_support_st : To get the ODM, MPC outputs as determined by the DML. 61 * @out_hw_context : Handle to the new hardware context. 62 * 63 * 64 * Return: None. 65 */ 66 void dml2_dc_construct_pipes(struct dc_state *context, struct dml_mode_support_info_st *dml_mode_support_st, 67 struct resource_context *out_hw_context); 68 69 /* 70 * dml2_predict_pipe_split - This function is the dml2 version of predict split pipe. It predicts a 71 * if pipe split is required or not and returns the output as a bool. 72 * @context : dc_state. 73 * @pipe : old_index is the index of the pipe as derived from pipe_idx. 74 * @index : index of the pipe 75 * 76 * 77 * Return: Returns the result in boolean. 78 */ 79 bool dml2_predict_pipe_split(struct dc_state *context, display_pipe_params_st pipe, int index); 80 81 /* 82 * dml2_build_mapped_resource - This function is the dml2 version of build_mapped_resource. 83 * In case of ODM, we need to build pipe hardware params again as done in dcn20_build_mapped_resource. 84 * @dc : struct dc 85 * @context : struct dc_state. 86 * @stream : stream whoose corresponding pipe params need to be modified. 87 * 88 * 89 * Return: Returns DC_OK if successful. 90 */ 91 enum dc_status dml2_build_mapped_resource(const struct dc *dc, struct dc_state *context, struct dc_stream_state *stream); 92 93 /* 94 * dml2_extract_rq_regs - This function will extract information needed for struct _vcs_dpi_display_rq_regs_st 95 * and populate it. 96 * @context: To obtain and populate the res_ctx->pipe_ctx->rq_regs with DML outputs. 97 * @support : This structure has the DML intermediate outputs required to populate rq_regs. 98 * 99 * 100 * Return: None. 101 */ 102 103 /* 104 * dml2_calculate_rq_and_dlg_params - This function will call into DML2 functions needed 105 * for populating rq, ttu and dlg param structures and populate it. 106 * @dc : struct dc 107 * @context : dc_state provides a handle to selectively populate pipe_ctx 108 * @out_new_hw_state: To obtain and populate the rq, dlg and ttu regs in 109 * out_new_hw_state->pipe_ctx with DML outputs. 110 * @in_ctx : This structure has the pointer to display_mode_lib_st. 111 * @pipe_cnt : DML functions to obtain RQ, TTu and DLG params need a pipe_index. 112 * This helps provide pipe_index in the pipe_cnt loop. 113 * 114 * 115 * Return: None. 116 */ 117 void dml2_calculate_rq_and_dlg_params(const struct dc *dc, struct dc_state *context, struct resource_context *out_new_hw_state, struct dml2_context *in_ctx, unsigned int pipe_cnt); 118 119 /* 120 * dml2_apply_det_buffer_allocation_policy - This function will determine the DET Buffer size 121 * and return the number of streams. 122 * @dml2 : Handle for dml2 context 123 * @dml_dispcfg : dml_dispcfg is the DML2 struct representing the current display config 124 * Return : None. 125 */ 126 void dml2_apply_det_buffer_allocation_policy(struct dml2_context *in_ctx, struct dml_display_cfg_st *dml_dispcfg); 127 128 /* 129 * dml2_verify_det_buffer_configuration - This function will verify if the allocated DET buffer exceeds 130 * the total available DET size available and outputs a boolean to indicate if recalulation is needed. 131 * @dml2 : Handle for dml2 context 132 * @dml_dispcfg : dml_dispcfg is the DML2 struct representing the current display config 133 * @struct dml2_helper_det_policy_scratch : Pointer to DET helper scratch 134 * Return : returns true if recalculation is required, false otherwise. 135 */ 136 bool dml2_verify_det_buffer_configuration(struct dml2_context *in_ctx, struct dc_state *display_state, struct dml2_helper_det_policy_scratch *det_scratch); 137 138 /* 139 * dml2_initialize_det_scratch - This function will initialize the DET scratch space as per requirements. 140 * @dml2 : Handle for dml2 context 141 * Return : None 142 */ 143 void dml2_initialize_det_scratch(struct dml2_context *in_ctx); 144 #endif 145