2 * Copyright 2017 Advanced Micro Devices, Inc.
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:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
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.
26 #include "dc_features.h"
27 #include "display_mode_enums.h"
29 #ifndef __DISPLAY_MODE_STRUCTS_H__
30 #define __DISPLAY_MODE_STRUCTS_H__
32 typedef struct _vcs_dpi_voltage_scaling_st voltage_scaling_st;
33 typedef struct _vcs_dpi_soc_bounding_box_st soc_bounding_box_st;
34 typedef struct _vcs_dpi_ip_params_st ip_params_st;
35 typedef struct _vcs_dpi_display_pipe_source_params_st display_pipe_source_params_st;
36 typedef struct _vcs_dpi_display_output_params_st display_output_params_st;
37 typedef struct _vcs_dpi_scaler_ratio_depth_st scaler_ratio_depth_st;
38 typedef struct _vcs_dpi_scaler_taps_st scaler_taps_st;
39 typedef struct _vcs_dpi_display_pipe_dest_params_st display_pipe_dest_params_st;
40 typedef struct _vcs_dpi_display_pipe_params_st display_pipe_params_st;
41 typedef struct _vcs_dpi_display_clocks_and_cfg_st display_clocks_and_cfg_st;
42 typedef struct _vcs_dpi_display_e2e_pipe_params_st display_e2e_pipe_params_st;
43 typedef struct _vcs_dpi_display_data_rq_misc_params_st display_data_rq_misc_params_st;
44 typedef struct _vcs_dpi_display_data_rq_sizing_params_st display_data_rq_sizing_params_st;
45 typedef struct _vcs_dpi_display_data_rq_dlg_params_st display_data_rq_dlg_params_st;
46 typedef struct _vcs_dpi_display_rq_dlg_params_st display_rq_dlg_params_st;
47 typedef struct _vcs_dpi_display_rq_sizing_params_st display_rq_sizing_params_st;
48 typedef struct _vcs_dpi_display_rq_misc_params_st display_rq_misc_params_st;
49 typedef struct _vcs_dpi_display_rq_params_st display_rq_params_st;
50 typedef struct _vcs_dpi_display_dlg_regs_st display_dlg_regs_st;
51 typedef struct _vcs_dpi_display_ttu_regs_st display_ttu_regs_st;
52 typedef struct _vcs_dpi_display_data_rq_regs_st display_data_rq_regs_st;
53 typedef struct _vcs_dpi_display_rq_regs_st display_rq_regs_st;
54 typedef struct _vcs_dpi_display_dlg_sys_params_st display_dlg_sys_params_st;
55 typedef struct _vcs_dpi_display_arb_params_st display_arb_params_st;
57 struct _vcs_dpi_voltage_scaling_st {
62 double phyclk_d18_mhz;
63 double dram_speed_mts;
66 double dram_bw_per_chan_gbps;
72 struct _vcs_dpi_soc_bounding_box_st {
73 struct _vcs_dpi_voltage_scaling_st clock_limits[DC__VOLTAGE_STATES];
74 unsigned int num_states;
75 double sr_exit_time_us;
76 double sr_enter_plus_exit_time_us;
77 double urgent_latency_us;
78 double urgent_latency_pixel_data_only_us;
79 double urgent_latency_pixel_mixed_with_vm_data_us;
80 double urgent_latency_vm_data_only_us;
81 double writeback_latency_us;
82 double ideal_dram_bw_after_urgent_percent;
83 double pct_ideal_dram_sdp_bw_after_urgent_pixel_only; // PercentOfIdealDRAMFabricAndSDPPortBWReceivedAfterUrgLatencyPixelDataOnly
84 double pct_ideal_dram_sdp_bw_after_urgent_pixel_and_vm;
85 double pct_ideal_dram_sdp_bw_after_urgent_vm_only;
86 double pct_ideal_sdp_bw_after_urgent;
87 double max_avg_sdp_bw_use_normal_percent;
88 double max_avg_dram_bw_use_normal_percent;
89 unsigned int max_request_size_bytes;
90 double downspread_percent;
91 double dram_page_open_time_ns;
92 double dram_rw_turnaround_time_ns;
93 double dram_return_buffer_per_channel_bytes;
94 double dram_channel_width_bytes;
95 double fabric_datapath_to_dcn_data_return_bytes;
96 double dcn_downspread_percent;
97 double dispclk_dppclk_vco_speed_mhz;
98 double dfs_vco_period_ps;
99 unsigned int urgent_out_of_order_return_per_channel_pixel_only_bytes;
100 unsigned int urgent_out_of_order_return_per_channel_pixel_and_vm_bytes;
101 unsigned int urgent_out_of_order_return_per_channel_vm_only_bytes;
102 unsigned int round_trip_ping_latency_dcfclk_cycles;
103 unsigned int urgent_out_of_order_return_per_channel_bytes;
104 unsigned int channel_interleave_bytes;
105 unsigned int num_banks;
106 unsigned int num_chans;
107 unsigned int vmm_page_size_bytes;
108 unsigned int hostvm_min_page_size_bytes;
109 unsigned int gpuvm_min_page_size_bytes;
110 double dram_clock_change_latency_us;
111 double dummy_pstate_latency_us;
112 double writeback_dram_clock_change_latency_us;
113 unsigned int return_bus_width_bytes;
114 unsigned int voltage_override;
115 double xfc_bus_transport_time_us;
116 double xfc_xbuf_latency_tolerance_us;
117 int use_urgent_burst_bw;
119 bool do_urgent_latency_adjustment;
120 double urgent_latency_adjustment_fabric_clock_component_us;
121 double urgent_latency_adjustment_fabric_clock_reference_mhz;
122 bool disable_dram_clock_change_vactive_support;
123 bool allow_dram_clock_one_display_vactive;
124 enum self_refresh_affinity allow_dram_self_refresh_or_dram_clock_change_in_vblank;
127 struct _vcs_dpi_ip_params_st {
129 bool clamp_min_dcfclk;
132 bool dsc422_native_support;
133 unsigned int gpuvm_max_page_table_levels;
134 unsigned int hostvm_max_page_table_levels;
135 unsigned int hostvm_cached_page_table_levels;
136 unsigned int pte_group_size_bytes;
137 unsigned int max_inter_dcn_tile_repeaters;
138 unsigned int num_dsc;
139 unsigned int odm_capable;
140 unsigned int rob_buffer_size_kbytes;
141 unsigned int det_buffer_size_kbytes;
142 unsigned int dpte_buffer_size_in_pte_reqs_luma;
143 unsigned int dpte_buffer_size_in_pte_reqs_chroma;
144 unsigned int pde_proc_buffer_size_64k_reqs;
145 unsigned int dpp_output_buffer_pixels;
146 unsigned int opp_output_buffer_lines;
147 unsigned int pixel_chunk_size_kbytes;
148 unsigned char pte_enable;
149 unsigned int pte_chunk_size_kbytes;
150 unsigned int meta_chunk_size_kbytes;
151 unsigned int min_meta_chunk_size_bytes;
152 unsigned int writeback_chunk_size_kbytes;
153 unsigned int line_buffer_size_bits;
154 unsigned int max_line_buffer_lines;
155 unsigned int writeback_luma_buffer_size_kbytes;
156 unsigned int writeback_chroma_buffer_size_kbytes;
157 unsigned int writeback_chroma_line_buffer_width_pixels;
159 unsigned int writeback_interface_buffer_size_kbytes;
160 unsigned int writeback_line_buffer_buffer_size;
162 unsigned int writeback_10bpc420_supported;
163 double writeback_max_hscl_ratio;
164 double writeback_max_vscl_ratio;
165 double writeback_min_hscl_ratio;
166 double writeback_min_vscl_ratio;
167 unsigned int maximum_dsc_bits_per_component;
168 unsigned int writeback_max_hscl_taps;
169 unsigned int writeback_max_vscl_taps;
170 unsigned int writeback_line_buffer_luma_buffer_size;
171 unsigned int writeback_line_buffer_chroma_buffer_size;
173 unsigned int max_page_table_levels;
174 unsigned int max_num_dpp;
175 unsigned int max_num_otg;
176 unsigned int cursor_chunk_size;
177 unsigned int cursor_buffer_size;
178 unsigned int max_num_wb;
179 unsigned int max_dchub_pscl_bw_pix_per_clk;
180 unsigned int max_pscl_lb_bw_pix_per_clk;
181 unsigned int max_lb_vscl_bw_pix_per_clk;
182 unsigned int max_vscl_hscl_bw_pix_per_clk;
183 double max_hscl_ratio;
184 double max_vscl_ratio;
185 unsigned int hscl_mults;
186 unsigned int vscl_mults;
187 unsigned int max_hscl_taps;
188 unsigned int max_vscl_taps;
189 unsigned int xfc_supported;
190 unsigned int ptoi_supported;
191 unsigned int gfx7_compat_tiling_supported;
193 bool odm_combine_4to1_supported;
194 bool dynamic_metadata_vm_enabled;
195 unsigned int max_num_hdmi_frl_outputs;
197 unsigned int xfc_fill_constant_bytes;
198 double dispclk_ramp_margin_percent;
199 double xfc_fill_bw_overhead_percent;
200 double underscan_factor;
201 unsigned int min_vblank_lines;
202 unsigned int dppclk_delay_subtotal;
203 unsigned int dispclk_delay_subtotal;
204 double dcfclk_cstate_latency;
205 unsigned int dppclk_delay_scl;
206 unsigned int dppclk_delay_scl_lb_only;
207 unsigned int dppclk_delay_cnvc_formatter;
208 unsigned int dppclk_delay_cnvc_cursor;
209 unsigned int is_line_buffer_bpp_fixed;
210 unsigned int line_buffer_fixed_bpp;
211 unsigned int dcc_supported;
213 unsigned int IsLineBufferBppFixed;
214 unsigned int LineBufferFixedBpp;
215 unsigned int can_vstartup_lines_exceed_vsync_plus_back_porch_lines_minus_one;
216 unsigned int bug_forcing_LC_req_same_size_fixed;
217 unsigned int number_of_cursors;
220 struct _vcs_dpi_display_xfc_params_st {
221 double xfc_tslv_vready_offset_us;
222 double xfc_tslv_vupdate_width_us;
223 double xfc_tslv_vupdate_offset_us;
224 int xfc_slv_chunk_size_bytes;
227 struct _vcs_dpi_display_pipe_source_params_st {
229 double dcc_fraction_of_zs_req_luma;
230 double dcc_fraction_of_zs_req_chroma;
232 unsigned int dcc_rate;
233 unsigned int dcc_rate_chroma;
234 unsigned char dcc_use_global;
236 bool unbounded_req_mode;
237 bool gpuvm; // gpuvm enabled
238 bool hostvm; // hostvm enabled
239 bool gpuvm_levels_force_en;
240 unsigned int gpuvm_levels_force;
241 bool hostvm_levels_force_en;
242 unsigned int hostvm_levels_force;
246 unsigned int surface_width_y;
247 unsigned int surface_height_y;
248 unsigned int surface_width_c;
249 unsigned int surface_height_c;
250 unsigned int viewport_width;
251 unsigned int viewport_height;
252 unsigned int viewport_y_y;
253 unsigned int viewport_y_c;
254 unsigned int viewport_width_c;
255 unsigned int viewport_height_c;
256 unsigned int viewport_width_max;
257 unsigned int viewport_height_max;
258 unsigned int data_pitch;
259 unsigned int data_pitch_c;
260 unsigned int meta_pitch;
261 unsigned int meta_pitch_c;
262 unsigned int cur0_src_width;
264 unsigned int cur1_src_width;
267 unsigned char is_hsplit;
268 unsigned char dynamic_metadata_enable;
269 unsigned int dynamic_metadata_lines_before_active;
270 unsigned int dynamic_metadata_xmit_bytes;
271 unsigned int hsplit_grp;
272 unsigned char xfc_enable;
273 unsigned char xfc_slave;
274 unsigned char immediate_flip;
275 struct _vcs_dpi_display_xfc_params_st xfc_params;
276 //for vstartuplines calculation freesync
277 unsigned char v_total_min;
278 unsigned char v_total_max;
280 struct writeback_st {
294 struct _vcs_dpi_display_output_params_st {
297 unsigned int dsc_input_bpc;
305 int max_audio_sample_rate;
306 struct writeback_st wb;
309 struct _vcs_dpi_scaler_ratio_depth_st {
322 struct _vcs_dpi_scaler_taps_st {
325 unsigned int htaps_c;
326 unsigned int vtaps_c;
329 struct _vcs_dpi_display_pipe_dest_params_st {
330 unsigned int recout_width;
331 unsigned int recout_height;
332 unsigned int full_recout_width;
333 unsigned int full_recout_height;
334 unsigned int hblank_start;
335 unsigned int hblank_end;
336 unsigned int vblank_start;
337 unsigned int vblank_end;
340 unsigned int vfront_porch;
341 unsigned int vactive;
342 unsigned int hactive;
343 unsigned int vstartup_start;
344 unsigned int vupdate_offset;
345 unsigned int vupdate_width;
346 unsigned int vready_offset;
347 unsigned char interlaced;
348 double pixel_rate_mhz;
349 unsigned char synchronized_vblank_all_planes;
350 unsigned char otg_inst;
351 unsigned int odm_combine;
352 unsigned char use_maximum_vstartup;
353 unsigned int vtotal_max;
354 unsigned int vtotal_min;
357 struct _vcs_dpi_display_pipe_params_st {
358 display_pipe_source_params_st src;
359 display_pipe_dest_params_st dest;
360 scaler_ratio_depth_st scale_ratio_depth;
361 scaler_taps_st scale_taps;
364 struct _vcs_dpi_display_clocks_and_cfg_st {
373 struct _vcs_dpi_display_e2e_pipe_params_st {
374 display_pipe_params_st pipe;
375 display_output_params_st dout;
376 display_clocks_and_cfg_st clks_cfg;
379 struct _vcs_dpi_display_data_rq_misc_params_st {
380 unsigned int full_swath_bytes;
381 unsigned int stored_swath_bytes;
382 unsigned int blk256_height;
383 unsigned int blk256_width;
384 unsigned int req_height;
385 unsigned int req_width;
388 struct _vcs_dpi_display_data_rq_sizing_params_st {
389 unsigned int chunk_bytes;
390 unsigned int min_chunk_bytes;
391 unsigned int meta_chunk_bytes;
392 unsigned int min_meta_chunk_bytes;
393 unsigned int mpte_group_bytes;
394 unsigned int dpte_group_bytes;
397 struct _vcs_dpi_display_data_rq_dlg_params_st {
398 unsigned int swath_width_ub;
399 unsigned int swath_height;
400 unsigned int req_per_swath_ub;
401 unsigned int meta_pte_bytes_per_frame_ub;
402 unsigned int dpte_req_per_row_ub;
403 unsigned int dpte_groups_per_row_ub;
404 unsigned int dpte_row_height;
405 unsigned int dpte_bytes_per_row_ub;
406 unsigned int meta_chunks_per_row_ub;
407 unsigned int meta_req_per_row_ub;
408 unsigned int meta_row_height;
409 unsigned int meta_bytes_per_row_ub;
412 struct _vcs_dpi_display_rq_dlg_params_st {
413 display_data_rq_dlg_params_st rq_l;
414 display_data_rq_dlg_params_st rq_c;
417 struct _vcs_dpi_display_rq_sizing_params_st {
418 display_data_rq_sizing_params_st rq_l;
419 display_data_rq_sizing_params_st rq_c;
422 struct _vcs_dpi_display_rq_misc_params_st {
423 display_data_rq_misc_params_st rq_l;
424 display_data_rq_misc_params_st rq_c;
427 struct _vcs_dpi_display_rq_params_st {
428 unsigned char yuv420;
429 unsigned char yuv420_10bpc;
430 unsigned char rgbe_alpha;
431 display_rq_misc_params_st misc;
432 display_rq_sizing_params_st sizing;
433 display_rq_dlg_params_st dlg;
436 struct _vcs_dpi_display_dlg_regs_st {
437 unsigned int refcyc_h_blank_end;
438 unsigned int dlg_vblank_end;
439 unsigned int min_dst_y_next_start;
440 unsigned int refcyc_per_htotal;
441 unsigned int refcyc_x_after_scaler;
442 unsigned int dst_y_after_scaler;
443 unsigned int dst_y_prefetch;
444 unsigned int dst_y_per_vm_vblank;
445 unsigned int dst_y_per_row_vblank;
446 unsigned int dst_y_per_vm_flip;
447 unsigned int dst_y_per_row_flip;
448 unsigned int ref_freq_to_pix_freq;
449 unsigned int vratio_prefetch;
450 unsigned int vratio_prefetch_c;
451 unsigned int refcyc_per_pte_group_vblank_l;
452 unsigned int refcyc_per_pte_group_vblank_c;
453 unsigned int refcyc_per_meta_chunk_vblank_l;
454 unsigned int refcyc_per_meta_chunk_vblank_c;
455 unsigned int refcyc_per_pte_group_flip_l;
456 unsigned int refcyc_per_pte_group_flip_c;
457 unsigned int refcyc_per_meta_chunk_flip_l;
458 unsigned int refcyc_per_meta_chunk_flip_c;
459 unsigned int dst_y_per_pte_row_nom_l;
460 unsigned int dst_y_per_pte_row_nom_c;
461 unsigned int refcyc_per_pte_group_nom_l;
462 unsigned int refcyc_per_pte_group_nom_c;
463 unsigned int dst_y_per_meta_row_nom_l;
464 unsigned int dst_y_per_meta_row_nom_c;
465 unsigned int refcyc_per_meta_chunk_nom_l;
466 unsigned int refcyc_per_meta_chunk_nom_c;
467 unsigned int refcyc_per_line_delivery_pre_l;
468 unsigned int refcyc_per_line_delivery_pre_c;
469 unsigned int refcyc_per_line_delivery_l;
470 unsigned int refcyc_per_line_delivery_c;
471 unsigned int chunk_hdl_adjust_cur0;
472 unsigned int chunk_hdl_adjust_cur1;
473 unsigned int vready_after_vcount0;
474 unsigned int dst_y_offset_cur0;
475 unsigned int dst_y_offset_cur1;
476 unsigned int xfc_reg_transfer_delay;
477 unsigned int xfc_reg_precharge_delay;
478 unsigned int xfc_reg_remote_surface_flip_latency;
479 unsigned int xfc_reg_prefetch_margin;
480 unsigned int dst_y_delta_drq_limit;
481 unsigned int refcyc_per_vm_group_vblank;
482 unsigned int refcyc_per_vm_group_flip;
483 unsigned int refcyc_per_vm_req_vblank;
484 unsigned int refcyc_per_vm_req_flip;
485 unsigned int refcyc_per_vm_dmdata;
486 unsigned int dmdata_dl_delta;
489 struct _vcs_dpi_display_ttu_regs_st {
490 unsigned int qos_level_low_wm;
491 unsigned int qos_level_high_wm;
492 unsigned int min_ttu_vblank;
493 unsigned int qos_level_flip;
494 unsigned int refcyc_per_req_delivery_l;
495 unsigned int refcyc_per_req_delivery_c;
496 unsigned int refcyc_per_req_delivery_cur0;
497 unsigned int refcyc_per_req_delivery_cur1;
498 unsigned int refcyc_per_req_delivery_pre_l;
499 unsigned int refcyc_per_req_delivery_pre_c;
500 unsigned int refcyc_per_req_delivery_pre_cur0;
501 unsigned int refcyc_per_req_delivery_pre_cur1;
502 unsigned int qos_level_fixed_l;
503 unsigned int qos_level_fixed_c;
504 unsigned int qos_level_fixed_cur0;
505 unsigned int qos_level_fixed_cur1;
506 unsigned int qos_ramp_disable_l;
507 unsigned int qos_ramp_disable_c;
508 unsigned int qos_ramp_disable_cur0;
509 unsigned int qos_ramp_disable_cur1;
512 struct _vcs_dpi_display_data_rq_regs_st {
513 unsigned int chunk_size;
514 unsigned int min_chunk_size;
515 unsigned int meta_chunk_size;
516 unsigned int min_meta_chunk_size;
517 unsigned int dpte_group_size;
518 unsigned int mpte_group_size;
519 unsigned int swath_height;
520 unsigned int pte_row_height_linear;
523 struct _vcs_dpi_display_rq_regs_st {
524 display_data_rq_regs_st rq_regs_l;
525 display_data_rq_regs_st rq_regs_c;
526 unsigned int drq_expansion_mode;
527 unsigned int prq_expansion_mode;
528 unsigned int mrq_expansion_mode;
529 unsigned int crq_expansion_mode;
530 unsigned int plane1_base_address;
533 struct _vcs_dpi_display_dlg_sys_params_st {
539 double t_srx_delay_us;
540 double deepsleep_dcfclk_mhz;
541 double total_flip_bw;
542 unsigned int total_flip_bytes;
545 struct _vcs_dpi_display_arb_params_st {
546 int max_req_outstanding;
547 int min_req_outstanding;
551 #endif /*__DISPLAY_MODE_STRUCTS_H__*/