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.
25 #ifndef __DISPLAY_MODE_STRUCTS_H__
26 #define __DISPLAY_MODE_STRUCTS_H__
28 #define MAX_CLOCK_LIMIT_STATES 8
30 typedef struct _vcs_dpi_voltage_scaling_st voltage_scaling_st
;
31 typedef struct _vcs_dpi_soc_bounding_box_st soc_bounding_box_st
;
32 typedef struct _vcs_dpi_ip_params_st ip_params_st
;
33 typedef struct _vcs_dpi_display_pipe_source_params_st display_pipe_source_params_st
;
34 typedef struct _vcs_dpi_display_output_params_st display_output_params_st
;
35 typedef struct _vcs_dpi_scaler_ratio_depth_st scaler_ratio_depth_st
;
36 typedef struct _vcs_dpi_scaler_taps_st scaler_taps_st
;
37 typedef struct _vcs_dpi_display_pipe_dest_params_st display_pipe_dest_params_st
;
38 typedef struct _vcs_dpi_display_pipe_params_st display_pipe_params_st
;
39 typedef struct _vcs_dpi_display_clocks_and_cfg_st display_clocks_and_cfg_st
;
40 typedef struct _vcs_dpi_display_e2e_pipe_params_st display_e2e_pipe_params_st
;
41 typedef struct _vcs_dpi_display_data_rq_misc_params_st display_data_rq_misc_params_st
;
42 typedef struct _vcs_dpi_display_data_rq_sizing_params_st display_data_rq_sizing_params_st
;
43 typedef struct _vcs_dpi_display_data_rq_dlg_params_st display_data_rq_dlg_params_st
;
44 typedef struct _vcs_dpi_display_rq_dlg_params_st display_rq_dlg_params_st
;
45 typedef struct _vcs_dpi_display_rq_sizing_params_st display_rq_sizing_params_st
;
46 typedef struct _vcs_dpi_display_rq_misc_params_st display_rq_misc_params_st
;
47 typedef struct _vcs_dpi_display_rq_params_st display_rq_params_st
;
48 typedef struct _vcs_dpi_display_dlg_regs_st display_dlg_regs_st
;
49 typedef struct _vcs_dpi_display_ttu_regs_st display_ttu_regs_st
;
50 typedef struct _vcs_dpi_display_data_rq_regs_st display_data_rq_regs_st
;
51 typedef struct _vcs_dpi_display_rq_regs_st display_rq_regs_st
;
52 typedef struct _vcs_dpi_display_dlg_sys_params_st display_dlg_sys_params_st
;
53 typedef struct _vcs_dpi_display_arb_params_st display_arb_params_st
;
55 struct _vcs_dpi_voltage_scaling_st
{
60 double phyclk_d18_mhz
;
61 double dram_speed_mts
;
69 struct _vcs_dpi_soc_bounding_box_st
{
70 double sr_exit_time_us
;
71 double sr_enter_plus_exit_time_us
;
72 double urgent_latency_us
;
73 double urgent_latency_pixel_data_only_us
;
74 double urgent_latency_pixel_mixed_with_vm_data_us
;
75 double urgent_latency_vm_data_only_us
;
76 double writeback_latency_us
;
77 double ideal_dram_bw_after_urgent_percent
;
78 double pct_ideal_dram_sdp_bw_after_urgent_pixel_only
; // PercentOfIdealDRAMFabricAndSDPPortBWReceivedAfterUrgLatencyPixelDataOnly
79 double pct_ideal_dram_sdp_bw_after_urgent_pixel_and_vm
;
80 double pct_ideal_dram_sdp_bw_after_urgent_vm_only
;
81 double max_avg_sdp_bw_use_normal_percent
;
82 double max_avg_dram_bw_use_normal_percent
;
83 unsigned int max_request_size_bytes
;
84 double downspread_percent
;
85 double dram_page_open_time_ns
;
86 double dram_rw_turnaround_time_ns
;
87 double dram_return_buffer_per_channel_bytes
;
88 double dram_channel_width_bytes
;
89 double fabric_datapath_to_dcn_data_return_bytes
;
90 double dcn_downspread_percent
;
91 double dispclk_dppclk_vco_speed_mhz
;
92 double dfs_vco_period_ps
;
93 unsigned int urgent_out_of_order_return_per_channel_pixel_only_bytes
;
94 unsigned int urgent_out_of_order_return_per_channel_pixel_and_vm_bytes
;
95 unsigned int urgent_out_of_order_return_per_channel_vm_only_bytes
;
96 unsigned int round_trip_ping_latency_dcfclk_cycles
;
97 unsigned int urgent_out_of_order_return_per_channel_bytes
;
98 unsigned int channel_interleave_bytes
;
99 unsigned int num_banks
;
100 unsigned int num_chans
;
101 unsigned int vmm_page_size_bytes
;
102 unsigned int hostvm_min_page_size_bytes
;
103 unsigned int gpuvm_min_page_size_bytes
;
104 double dram_clock_change_latency_us
;
105 double dummy_pstate_latency_us
;
106 double writeback_dram_clock_change_latency_us
;
107 unsigned int return_bus_width_bytes
;
108 unsigned int voltage_override
;
109 double xfc_bus_transport_time_us
;
110 double xfc_xbuf_latency_tolerance_us
;
111 int use_urgent_burst_bw
;
112 unsigned int num_states
;
113 struct _vcs_dpi_voltage_scaling_st clock_limits
[MAX_CLOCK_LIMIT_STATES
];
114 bool do_urgent_latency_adjustment
;
115 double urgent_latency_adjustment_fabric_clock_component_us
;
116 double urgent_latency_adjustment_fabric_clock_reference_mhz
;
117 bool disable_dram_clock_change_vactive_support
;
120 struct _vcs_dpi_ip_params_st
{
123 unsigned int gpuvm_max_page_table_levels
;
124 unsigned int hostvm_max_page_table_levels
;
125 unsigned int hostvm_cached_page_table_levels
;
126 unsigned int pte_group_size_bytes
;
127 unsigned int max_inter_dcn_tile_repeaters
;
128 unsigned int num_dsc
;
129 unsigned int odm_capable
;
130 unsigned int rob_buffer_size_kbytes
;
131 unsigned int det_buffer_size_kbytes
;
132 unsigned int dpte_buffer_size_in_pte_reqs_luma
;
133 unsigned int dpte_buffer_size_in_pte_reqs_chroma
;
134 unsigned int pde_proc_buffer_size_64k_reqs
;
135 unsigned int dpp_output_buffer_pixels
;
136 unsigned int opp_output_buffer_lines
;
137 unsigned int pixel_chunk_size_kbytes
;
138 unsigned char pte_enable
;
139 unsigned int pte_chunk_size_kbytes
;
140 unsigned int meta_chunk_size_kbytes
;
141 unsigned int writeback_chunk_size_kbytes
;
142 unsigned int line_buffer_size_bits
;
143 unsigned int max_line_buffer_lines
;
144 unsigned int writeback_luma_buffer_size_kbytes
;
145 unsigned int writeback_chroma_buffer_size_kbytes
;
146 unsigned int writeback_chroma_line_buffer_width_pixels
;
148 unsigned int writeback_interface_buffer_size_kbytes
;
149 unsigned int writeback_line_buffer_buffer_size
;
151 unsigned int writeback_10bpc420_supported
;
152 double writeback_max_hscl_ratio
;
153 double writeback_max_vscl_ratio
;
154 double writeback_min_hscl_ratio
;
155 double writeback_min_vscl_ratio
;
156 unsigned int writeback_max_hscl_taps
;
157 unsigned int writeback_max_vscl_taps
;
158 unsigned int writeback_line_buffer_luma_buffer_size
;
159 unsigned int writeback_line_buffer_chroma_buffer_size
;
161 unsigned int max_page_table_levels
;
162 unsigned int max_num_dpp
;
163 unsigned int max_num_otg
;
164 unsigned int cursor_chunk_size
;
165 unsigned int cursor_buffer_size
;
166 unsigned int max_num_wb
;
167 unsigned int max_dchub_pscl_bw_pix_per_clk
;
168 unsigned int max_pscl_lb_bw_pix_per_clk
;
169 unsigned int max_lb_vscl_bw_pix_per_clk
;
170 unsigned int max_vscl_hscl_bw_pix_per_clk
;
171 double max_hscl_ratio
;
172 double max_vscl_ratio
;
173 unsigned int hscl_mults
;
174 unsigned int vscl_mults
;
175 unsigned int max_hscl_taps
;
176 unsigned int max_vscl_taps
;
177 unsigned int xfc_supported
;
178 unsigned int ptoi_supported
;
179 unsigned int gfx7_compat_tiling_supported
;
181 bool odm_combine_4to1_supported
;
182 bool dynamic_metadata_vm_enabled
;
183 unsigned int max_num_hdmi_frl_outputs
;
185 unsigned int xfc_fill_constant_bytes
;
186 double dispclk_ramp_margin_percent
;
187 double xfc_fill_bw_overhead_percent
;
188 double underscan_factor
;
189 unsigned int min_vblank_lines
;
190 unsigned int dppclk_delay_subtotal
;
191 unsigned int dispclk_delay_subtotal
;
192 unsigned int dcfclk_cstate_latency
;
193 unsigned int dppclk_delay_scl
;
194 unsigned int dppclk_delay_scl_lb_only
;
195 unsigned int dppclk_delay_cnvc_formatter
;
196 unsigned int dppclk_delay_cnvc_cursor
;
197 unsigned int is_line_buffer_bpp_fixed
;
198 unsigned int line_buffer_fixed_bpp
;
199 unsigned int dcc_supported
;
201 unsigned int IsLineBufferBppFixed
;
202 unsigned int LineBufferFixedBpp
;
203 unsigned int can_vstartup_lines_exceed_vsync_plus_back_porch_lines_minus_one
;
204 unsigned int bug_forcing_LC_req_same_size_fixed
;
207 struct _vcs_dpi_display_xfc_params_st
{
208 double xfc_tslv_vready_offset_us
;
209 double xfc_tslv_vupdate_width_us
;
210 double xfc_tslv_vupdate_offset_us
;
211 int xfc_slv_chunk_size_bytes
;
214 struct _vcs_dpi_display_pipe_source_params_st
{
217 unsigned int dcc_rate
;
218 unsigned int dcc_rate_chroma
;
219 unsigned char dcc_use_global
;
221 bool gpuvm
; // gpuvm enabled
222 bool hostvm
; // hostvm enabled
223 bool gpuvm_levels_force_en
;
224 unsigned int gpuvm_levels_force
;
225 bool hostvm_levels_force_en
;
226 unsigned int hostvm_levels_force
;
230 unsigned int surface_width_y
;
231 unsigned int surface_height_y
;
232 unsigned int surface_width_c
;
233 unsigned int surface_height_c
;
234 unsigned int viewport_width
;
235 unsigned int viewport_height
;
236 unsigned int viewport_y_y
;
237 unsigned int viewport_y_c
;
238 unsigned int viewport_width_c
;
239 unsigned int viewport_height_c
;
240 unsigned int data_pitch
;
241 unsigned int data_pitch_c
;
242 unsigned int meta_pitch
;
243 unsigned int meta_pitch_c
;
244 unsigned int cur0_src_width
;
246 unsigned int cur1_src_width
;
249 unsigned char is_hsplit
;
250 unsigned char dynamic_metadata_enable
;
251 unsigned int dynamic_metadata_lines_before_active
;
252 unsigned int dynamic_metadata_xmit_bytes
;
253 unsigned int hsplit_grp
;
254 unsigned char xfc_enable
;
255 unsigned char xfc_slave
;
256 unsigned char immediate_flip
;
257 struct _vcs_dpi_display_xfc_params_st xfc_params
;
258 //for vstartuplines calculation freesync
259 unsigned char v_total_min
;
260 unsigned char v_total_max
;
262 struct writeback_st
{
276 struct _vcs_dpi_display_output_params_st
{
286 int max_audio_sample_rate
;
287 struct writeback_st wb
;
290 struct _vcs_dpi_scaler_ratio_depth_st
{
303 struct _vcs_dpi_scaler_taps_st
{
306 unsigned int htaps_c
;
307 unsigned int vtaps_c
;
310 struct _vcs_dpi_display_pipe_dest_params_st
{
311 unsigned int recout_width
;
312 unsigned int recout_height
;
313 unsigned int full_recout_width
;
314 unsigned int full_recout_height
;
315 unsigned int hblank_start
;
316 unsigned int hblank_end
;
317 unsigned int vblank_start
;
318 unsigned int vblank_end
;
321 unsigned int vactive
;
322 unsigned int hactive
;
323 unsigned int vstartup_start
;
324 unsigned int vupdate_offset
;
325 unsigned int vupdate_width
;
326 unsigned int vready_offset
;
327 unsigned char interlaced
;
328 unsigned char embedded
;
329 double pixel_rate_mhz
;
330 unsigned char synchronized_vblank_all_planes
;
331 unsigned char otg_inst
;
332 unsigned int odm_combine
;
333 unsigned char use_maximum_vstartup
;
334 unsigned int vtotal_max
;
335 unsigned int vtotal_min
;
338 struct _vcs_dpi_display_pipe_params_st
{
339 display_pipe_source_params_st src
;
340 display_pipe_dest_params_st dest
;
341 scaler_ratio_depth_st scale_ratio_depth
;
342 scaler_taps_st scale_taps
;
345 struct _vcs_dpi_display_clocks_and_cfg_st
{
354 struct _vcs_dpi_display_e2e_pipe_params_st
{
355 display_pipe_params_st pipe
;
356 display_output_params_st dout
;
357 display_clocks_and_cfg_st clks_cfg
;
360 struct _vcs_dpi_display_data_rq_misc_params_st
{
361 unsigned int full_swath_bytes
;
362 unsigned int stored_swath_bytes
;
363 unsigned int blk256_height
;
364 unsigned int blk256_width
;
365 unsigned int req_height
;
366 unsigned int req_width
;
369 struct _vcs_dpi_display_data_rq_sizing_params_st
{
370 unsigned int chunk_bytes
;
371 unsigned int min_chunk_bytes
;
372 unsigned int meta_chunk_bytes
;
373 unsigned int min_meta_chunk_bytes
;
374 unsigned int mpte_group_bytes
;
375 unsigned int dpte_group_bytes
;
378 struct _vcs_dpi_display_data_rq_dlg_params_st
{
379 unsigned int swath_width_ub
;
380 unsigned int swath_height
;
381 unsigned int req_per_swath_ub
;
382 unsigned int meta_pte_bytes_per_frame_ub
;
383 unsigned int dpte_req_per_row_ub
;
384 unsigned int dpte_groups_per_row_ub
;
385 unsigned int dpte_row_height
;
386 unsigned int dpte_bytes_per_row_ub
;
387 unsigned int meta_chunks_per_row_ub
;
388 unsigned int meta_req_per_row_ub
;
389 unsigned int meta_row_height
;
390 unsigned int meta_bytes_per_row_ub
;
393 struct _vcs_dpi_display_rq_dlg_params_st
{
394 display_data_rq_dlg_params_st rq_l
;
395 display_data_rq_dlg_params_st rq_c
;
398 struct _vcs_dpi_display_rq_sizing_params_st
{
399 display_data_rq_sizing_params_st rq_l
;
400 display_data_rq_sizing_params_st rq_c
;
403 struct _vcs_dpi_display_rq_misc_params_st
{
404 display_data_rq_misc_params_st rq_l
;
405 display_data_rq_misc_params_st rq_c
;
408 struct _vcs_dpi_display_rq_params_st
{
409 unsigned char yuv420
;
410 unsigned char yuv420_10bpc
;
411 unsigned char rgbe_alpha
;
412 display_rq_misc_params_st misc
;
413 display_rq_sizing_params_st sizing
;
414 display_rq_dlg_params_st dlg
;
417 struct _vcs_dpi_display_dlg_regs_st
{
418 unsigned int refcyc_h_blank_end
;
419 unsigned int dlg_vblank_end
;
420 unsigned int min_dst_y_next_start
;
421 unsigned int refcyc_per_htotal
;
422 unsigned int refcyc_x_after_scaler
;
423 unsigned int dst_y_after_scaler
;
424 unsigned int dst_y_prefetch
;
425 unsigned int dst_y_per_vm_vblank
;
426 unsigned int dst_y_per_row_vblank
;
427 unsigned int dst_y_per_vm_flip
;
428 unsigned int dst_y_per_row_flip
;
429 unsigned int ref_freq_to_pix_freq
;
430 unsigned int vratio_prefetch
;
431 unsigned int vratio_prefetch_c
;
432 unsigned int refcyc_per_pte_group_vblank_l
;
433 unsigned int refcyc_per_pte_group_vblank_c
;
434 unsigned int refcyc_per_meta_chunk_vblank_l
;
435 unsigned int refcyc_per_meta_chunk_vblank_c
;
436 unsigned int refcyc_per_pte_group_flip_l
;
437 unsigned int refcyc_per_pte_group_flip_c
;
438 unsigned int refcyc_per_meta_chunk_flip_l
;
439 unsigned int refcyc_per_meta_chunk_flip_c
;
440 unsigned int dst_y_per_pte_row_nom_l
;
441 unsigned int dst_y_per_pte_row_nom_c
;
442 unsigned int refcyc_per_pte_group_nom_l
;
443 unsigned int refcyc_per_pte_group_nom_c
;
444 unsigned int dst_y_per_meta_row_nom_l
;
445 unsigned int dst_y_per_meta_row_nom_c
;
446 unsigned int refcyc_per_meta_chunk_nom_l
;
447 unsigned int refcyc_per_meta_chunk_nom_c
;
448 unsigned int refcyc_per_line_delivery_pre_l
;
449 unsigned int refcyc_per_line_delivery_pre_c
;
450 unsigned int refcyc_per_line_delivery_l
;
451 unsigned int refcyc_per_line_delivery_c
;
452 unsigned int chunk_hdl_adjust_cur0
;
453 unsigned int chunk_hdl_adjust_cur1
;
454 unsigned int vready_after_vcount0
;
455 unsigned int dst_y_offset_cur0
;
456 unsigned int dst_y_offset_cur1
;
457 unsigned int xfc_reg_transfer_delay
;
458 unsigned int xfc_reg_precharge_delay
;
459 unsigned int xfc_reg_remote_surface_flip_latency
;
460 unsigned int xfc_reg_prefetch_margin
;
461 unsigned int dst_y_delta_drq_limit
;
462 unsigned int refcyc_per_vm_group_vblank
;
463 unsigned int refcyc_per_vm_group_flip
;
464 unsigned int refcyc_per_vm_req_vblank
;
465 unsigned int refcyc_per_vm_req_flip
;
466 unsigned int refcyc_per_vm_dmdata
;
469 struct _vcs_dpi_display_ttu_regs_st
{
470 unsigned int qos_level_low_wm
;
471 unsigned int qos_level_high_wm
;
472 unsigned int min_ttu_vblank
;
473 unsigned int qos_level_flip
;
474 unsigned int refcyc_per_req_delivery_l
;
475 unsigned int refcyc_per_req_delivery_c
;
476 unsigned int refcyc_per_req_delivery_cur0
;
477 unsigned int refcyc_per_req_delivery_cur1
;
478 unsigned int refcyc_per_req_delivery_pre_l
;
479 unsigned int refcyc_per_req_delivery_pre_c
;
480 unsigned int refcyc_per_req_delivery_pre_cur0
;
481 unsigned int refcyc_per_req_delivery_pre_cur1
;
482 unsigned int qos_level_fixed_l
;
483 unsigned int qos_level_fixed_c
;
484 unsigned int qos_level_fixed_cur0
;
485 unsigned int qos_level_fixed_cur1
;
486 unsigned int qos_ramp_disable_l
;
487 unsigned int qos_ramp_disable_c
;
488 unsigned int qos_ramp_disable_cur0
;
489 unsigned int qos_ramp_disable_cur1
;
492 struct _vcs_dpi_display_data_rq_regs_st
{
493 unsigned int chunk_size
;
494 unsigned int min_chunk_size
;
495 unsigned int meta_chunk_size
;
496 unsigned int min_meta_chunk_size
;
497 unsigned int dpte_group_size
;
498 unsigned int mpte_group_size
;
499 unsigned int swath_height
;
500 unsigned int pte_row_height_linear
;
503 struct _vcs_dpi_display_rq_regs_st
{
504 display_data_rq_regs_st rq_regs_l
;
505 display_data_rq_regs_st rq_regs_c
;
506 unsigned int drq_expansion_mode
;
507 unsigned int prq_expansion_mode
;
508 unsigned int mrq_expansion_mode
;
509 unsigned int crq_expansion_mode
;
510 unsigned int plane1_base_address
;
513 struct _vcs_dpi_display_dlg_sys_params_st
{
519 double t_srx_delay_us
;
520 double deepsleep_dcfclk_mhz
;
521 double total_flip_bw
;
522 unsigned int total_flip_bytes
;
525 struct _vcs_dpi_display_arb_params_st
{
526 int max_req_outstanding
;
527 int min_req_outstanding
;
531 #endif /*__DISPLAY_MODE_STRUCTS_H__*/