1 /* 2 * Copyright 2022 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 __DISPLAY_MODE_CORE_H__ 27 #define __DISPLAY_MODE_CORE_H__ 28 29 #include "display_mode_core_structs.h" 30 31 struct display_mode_lib_st; 32 33 dml_bool_t dml_core_mode_support(struct display_mode_lib_st *mode_lib); 34 void dml_core_mode_support_partial(struct display_mode_lib_st *mode_lib); 35 void dml_core_mode_programming(struct display_mode_lib_st *mode_lib, const struct dml_clk_cfg_st *clk_cfg); 36 37 void dml_core_get_row_heights( 38 dml_uint_t *dpte_row_height, 39 dml_uint_t *meta_row_height, 40 const struct display_mode_lib_st *mode_lib, 41 dml_bool_t is_plane1, 42 enum dml_source_format_class SourcePixelFormat, 43 enum dml_swizzle_mode SurfaceTiling, 44 enum dml_rotation_angle ScanDirection, 45 dml_uint_t pitch, 46 dml_uint_t GPUVMMinPageSizeKBytes); 47 48 dml_float_t dml_get_return_bw_mbps_vm_only( 49 const struct soc_bounding_box_st *soc, 50 dml_bool_t use_ideal_dram_bw_strobe, 51 dml_bool_t HostVMEnable, 52 dml_float_t DCFCLK, 53 dml_float_t FabricClock, 54 dml_float_t DRAMSpeed); 55 56 dml_float_t dml_get_return_bw_mbps( 57 const struct soc_bounding_box_st *soc, 58 dml_bool_t use_ideal_dram_bw_strobe, 59 dml_bool_t HostVMEnable, 60 dml_float_t DCFCLK, 61 dml_float_t FabricClock, 62 dml_float_t DRAMSpeed); 63 64 dml_bool_t dml_mode_support( 65 struct display_mode_lib_st *mode_lib, 66 dml_uint_t state_idx, 67 const struct dml_display_cfg_st *display_cfg); 68 69 dml_bool_t dml_mode_programming( 70 struct display_mode_lib_st *mode_lib, 71 dml_uint_t state_idx, 72 const struct dml_display_cfg_st *display_cfg, 73 bool call_standalone); 74 75 dml_uint_t dml_mode_support_ex( 76 struct dml_mode_support_ex_params_st *in_out_params); 77 78 dml_bool_t dml_get_is_phantom_pipe(struct display_mode_lib_st *mode_lib, dml_uint_t pipe_idx); 79 80 #define dml_get_per_surface_var_decl(variable, type) type dml_get_##variable(struct display_mode_lib_st *mode_lib, dml_uint_t surface_idx) 81 #define dml_get_var_decl(var, type) type dml_get_##var(struct display_mode_lib_st *mode_lib) 82 83 dml_get_var_decl(wm_urgent, dml_float_t); 84 dml_get_var_decl(wm_stutter_exit, dml_float_t); 85 dml_get_var_decl(wm_stutter_enter_exit, dml_float_t); 86 dml_get_var_decl(wm_memory_trip, dml_float_t); 87 dml_get_var_decl(wm_dram_clock_change, dml_float_t); 88 dml_get_var_decl(wm_z8_stutter_enter_exit, dml_float_t); 89 dml_get_var_decl(wm_z8_stutter, dml_float_t); 90 dml_get_var_decl(urgent_latency, dml_float_t); 91 dml_get_var_decl(clk_dcf_deepsleep, dml_float_t); 92 dml_get_var_decl(wm_fclk_change, dml_float_t); 93 dml_get_var_decl(wm_usr_retraining, dml_float_t); 94 dml_get_var_decl(urgent_latency, dml_float_t); 95 96 dml_get_var_decl(wm_writeback_dram_clock_change, dml_float_t); 97 dml_get_var_decl(wm_writeback_urgent, dml_float_t); 98 dml_get_var_decl(stutter_efficiency_no_vblank, dml_float_t); 99 dml_get_var_decl(stutter_efficiency, dml_float_t); 100 dml_get_var_decl(stutter_efficiency_z8, dml_float_t); 101 dml_get_var_decl(stutter_num_bursts_z8, dml_float_t); 102 dml_get_var_decl(stutter_period, dml_float_t); 103 dml_get_var_decl(stutter_efficiency_z8_bestcase, dml_float_t); 104 dml_get_var_decl(stutter_num_bursts_z8_bestcase, dml_float_t); 105 dml_get_var_decl(stutter_period_bestcase, dml_float_t); 106 dml_get_var_decl(urgent_latency, dml_float_t); 107 dml_get_var_decl(urgent_extra_latency, dml_float_t); 108 dml_get_var_decl(fclk_change_latency, dml_float_t); 109 dml_get_var_decl(nonurgent_latency, dml_float_t); 110 dml_get_var_decl(dispclk_calculated, dml_float_t); 111 dml_get_var_decl(total_data_read_bw, dml_float_t); 112 dml_get_var_decl(return_bw, dml_float_t); 113 dml_get_var_decl(return_dram_bw, dml_float_t); 114 dml_get_var_decl(tcalc, dml_float_t); 115 dml_get_var_decl(fraction_of_urgent_bandwidth, dml_float_t); 116 dml_get_var_decl(fraction_of_urgent_bandwidth_imm_flip, dml_float_t); 117 dml_get_var_decl(comp_buffer_size_kbytes, dml_uint_t); 118 dml_get_var_decl(pixel_chunk_size_in_kbyte, dml_uint_t); 119 dml_get_var_decl(alpha_pixel_chunk_size_in_kbyte, dml_uint_t); 120 dml_get_var_decl(meta_chunk_size_in_kbyte, dml_uint_t); 121 dml_get_var_decl(min_pixel_chunk_size_in_byte, dml_uint_t); 122 dml_get_var_decl(min_meta_chunk_size_in_byte, dml_uint_t); 123 dml_get_var_decl(total_immediate_flip_bytes, dml_uint_t); 124 125 dml_get_per_surface_var_decl(dsc_delay, dml_uint_t); 126 dml_get_per_surface_var_decl(dppclk_calculated, dml_float_t); 127 dml_get_per_surface_var_decl(dscclk_calculated, dml_float_t); 128 dml_get_per_surface_var_decl(min_ttu_vblank_in_us, dml_float_t); 129 dml_get_per_surface_var_decl(vratio_prefetch_l, dml_float_t); 130 dml_get_per_surface_var_decl(vratio_prefetch_c, dml_float_t); 131 dml_get_per_surface_var_decl(dst_x_after_scaler, dml_uint_t); 132 dml_get_per_surface_var_decl(dst_y_after_scaler, dml_uint_t); 133 dml_get_per_surface_var_decl(dst_y_per_vm_vblank, dml_float_t); 134 dml_get_per_surface_var_decl(dst_y_per_row_vblank, dml_float_t); 135 dml_get_per_surface_var_decl(dst_y_prefetch, dml_float_t); 136 dml_get_per_surface_var_decl(dst_y_per_vm_flip, dml_float_t); 137 dml_get_per_surface_var_decl(dst_y_per_row_flip, dml_float_t); 138 dml_get_per_surface_var_decl(dst_y_per_pte_row_nom_l, dml_float_t); 139 dml_get_per_surface_var_decl(dst_y_per_pte_row_nom_c, dml_float_t); 140 dml_get_per_surface_var_decl(dst_y_per_meta_row_nom_l, dml_float_t); 141 dml_get_per_surface_var_decl(dst_y_per_meta_row_nom_c, dml_float_t); 142 dml_get_per_surface_var_decl(refcyc_per_vm_group_vblank_in_us, dml_float_t); 143 dml_get_per_surface_var_decl(refcyc_per_vm_group_flip_in_us, dml_float_t); 144 dml_get_per_surface_var_decl(refcyc_per_vm_req_vblank_in_us, dml_float_t); 145 dml_get_per_surface_var_decl(refcyc_per_vm_req_flip_in_us, dml_float_t); 146 dml_get_per_surface_var_decl(refcyc_per_vm_dmdata_in_us, dml_float_t); 147 dml_get_per_surface_var_decl(dmdata_dl_delta_in_us, dml_float_t); 148 dml_get_per_surface_var_decl(refcyc_per_line_delivery_l_in_us, dml_float_t); 149 dml_get_per_surface_var_decl(refcyc_per_line_delivery_c_in_us, dml_float_t); 150 dml_get_per_surface_var_decl(refcyc_per_line_delivery_pre_l_in_us, dml_float_t); 151 dml_get_per_surface_var_decl(refcyc_per_line_delivery_pre_c_in_us, dml_float_t); 152 dml_get_per_surface_var_decl(refcyc_per_req_delivery_l_in_us, dml_float_t); 153 dml_get_per_surface_var_decl(refcyc_per_req_delivery_c_in_us, dml_float_t); 154 dml_get_per_surface_var_decl(refcyc_per_req_delivery_pre_l_in_us, dml_float_t); 155 dml_get_per_surface_var_decl(refcyc_per_req_delivery_pre_c_in_us, dml_float_t); 156 dml_get_per_surface_var_decl(refcyc_per_cursor_req_delivery_in_us, dml_float_t); 157 dml_get_per_surface_var_decl(refcyc_per_cursor_req_delivery_pre_in_us, dml_float_t); 158 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_nom_l_in_us, dml_float_t); 159 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_nom_c_in_us, dml_float_t); 160 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_vblank_l_in_us, dml_float_t); 161 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_vblank_c_in_us, dml_float_t); 162 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_flip_l_in_us, dml_float_t); 163 dml_get_per_surface_var_decl(refcyc_per_meta_chunk_flip_c_in_us, dml_float_t); 164 dml_get_per_surface_var_decl(refcyc_per_pte_group_nom_l_in_us, dml_float_t); 165 dml_get_per_surface_var_decl(refcyc_per_pte_group_nom_c_in_us, dml_float_t); 166 dml_get_per_surface_var_decl(refcyc_per_pte_group_vblank_l_in_us, dml_float_t); 167 dml_get_per_surface_var_decl(refcyc_per_pte_group_vblank_c_in_us, dml_float_t); 168 dml_get_per_surface_var_decl(refcyc_per_pte_group_flip_l_in_us, dml_float_t); 169 dml_get_per_surface_var_decl(refcyc_per_pte_group_flip_c_in_us, dml_float_t); 170 171 dml_get_per_surface_var_decl(dpte_group_size_in_bytes, dml_uint_t); 172 dml_get_per_surface_var_decl(vm_group_size_in_bytes, dml_uint_t); 173 dml_get_per_surface_var_decl(swath_height_l, dml_uint_t); 174 dml_get_per_surface_var_decl(swath_height_c, dml_uint_t); 175 dml_get_per_surface_var_decl(dpte_row_height_l, dml_uint_t); 176 dml_get_per_surface_var_decl(dpte_row_height_c, dml_uint_t); 177 dml_get_per_surface_var_decl(dpte_row_height_linear_l, dml_uint_t); 178 dml_get_per_surface_var_decl(dpte_row_height_linear_c, dml_uint_t); 179 dml_get_per_surface_var_decl(meta_row_height_l, dml_uint_t); 180 dml_get_per_surface_var_decl(meta_row_height_c, dml_uint_t); 181 dml_get_per_surface_var_decl(vstartup_calculated, dml_uint_t); 182 dml_get_per_surface_var_decl(vupdate_offset, dml_uint_t); 183 dml_get_per_surface_var_decl(vupdate_width, dml_uint_t); 184 dml_get_per_surface_var_decl(vready_offset, dml_uint_t); 185 dml_get_per_surface_var_decl(vready_at_or_after_vsync, dml_uint_t); 186 dml_get_per_surface_var_decl(min_dst_y_next_start, dml_uint_t); 187 dml_get_per_surface_var_decl(det_stored_buffer_size_l_bytes, dml_uint_t); 188 dml_get_per_surface_var_decl(det_stored_buffer_size_c_bytes, dml_uint_t); 189 dml_get_per_surface_var_decl(use_mall_for_static_screen, dml_uint_t); 190 dml_get_per_surface_var_decl(surface_size_for_mall, dml_uint_t); 191 dml_get_per_surface_var_decl(dcc_max_uncompressed_block_l, dml_uint_t); 192 dml_get_per_surface_var_decl(dcc_max_uncompressed_block_c, dml_uint_t); 193 dml_get_per_surface_var_decl(dcc_max_compressed_block_l, dml_uint_t); 194 dml_get_per_surface_var_decl(dcc_max_compressed_block_c, dml_uint_t); 195 dml_get_per_surface_var_decl(dcc_independent_block_l, dml_uint_t); 196 dml_get_per_surface_var_decl(dcc_independent_block_c, dml_uint_t); 197 dml_get_per_surface_var_decl(max_active_dram_clock_change_latency_supported, dml_uint_t); 198 dml_get_per_surface_var_decl(pte_buffer_mode, dml_uint_t); 199 dml_get_per_surface_var_decl(bigk_fragment_size, dml_uint_t); 200 dml_get_per_surface_var_decl(dpte_bytes_per_row, dml_uint_t); 201 dml_get_per_surface_var_decl(meta_bytes_per_row, dml_uint_t); 202 dml_get_per_surface_var_decl(det_buffer_size_kbytes, dml_uint_t); 203 204 #endif 205