drivers/gpu/drm/amd/display/dc/inc/dce_calcs.h - arm/linux - Git at Google


            
            /*

            
             * Copyright 2015-2017 Advanced Micro Devices, Inc.

            
             *

            
             * Permission is hereby granted, free of charge, to any person obtaining a

            
             * copy of this software and associated documentation files (the "Software"),

            
             * to deal in the Software without restriction, including without limitation

            
             * the rights to use, copy, modify, merge, publish, distribute, sublicense,

            
             * and/or sell copies of the Software, and to permit persons to whom the

            
             * Software is furnished to do so, subject to the following conditions:

            
             *

            
             * The above copyright notice and this permission notice shall be included in

            
             * all copies or substantial portions of the Software.

            
             *

            
             * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

            
             * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

            
             * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL

            
             * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR

            
             * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,

            
             * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

            
             * OTHER DEALINGS IN THE SOFTWARE.

            
             *

            
             * Authors: AMD

            
             *

            
             */


            /**

            
             * Bandwidth and Watermark calculations interface.

            
             * (Refer to "DCEx_mode_support.xlsm" from Perforce.)

            
             */

            
            #ifndef __DCE_CALCS_H__

            
            #define __DCE_CALCS_H__


            #include "bw_fixed.h"


            struct pipe_ctx;

            
            struct dc;

            
            struct dc_state;

            
            struct dce_bw_output;


            enum bw_calcs_version {

            
            	BW_CALCS_VERSION_INVALID,

            
            	BW_CALCS_VERSION_CARRIZO,

            
            	BW_CALCS_VERSION_POLARIS10,

            
            	BW_CALCS_VERSION_POLARIS11,

            
            	BW_CALCS_VERSION_STONEY,

            
            	BW_CALCS_VERSION_VEGA10

            
            };


            /*******************************************************************************

            
             * There are three types of input into Calculations:

            
             * 1. per-DCE static values - these are "hardcoded" properties of the DCEIP

            
             * 2. board-level values - these are generally coming from VBIOS parser

            
             * 3. mode/configuration values - depending Mode, Scaling number of Displays etc.

            
             ******************************************************************************/


            enum bw_defines {

            
            	//Common

            
            	bw_def_no = 0,

            
            	bw_def_none = 0,

            
            	bw_def_yes = 1,

            
            	bw_def_ok = 1,

            
            	bw_def_high = 2,

            
            	bw_def_mid = 1,

            
            	bw_def_low = 0,


            	//Internal

            
            	bw_defs_start = 255,

            
            	bw_def_underlay422,

            
            	bw_def_underlay420_luma,

            
            	bw_def_underlay420_chroma,

            
            	bw_def_underlay444,

            
            	bw_def_graphics,

            
            	bw_def_display_write_back420_luma,

            
            	bw_def_display_write_back420_chroma,

            
            	bw_def_portrait,

            
            	bw_def_hsr_mtn_4,

            
            	bw_def_hsr_mtn_h_taps,

            
            	bw_def_ceiling__h_taps_div_4___meq_hsr,

            
            	bw_def_invalid_linear_or_stereo_mode,

            
            	bw_def_invalid_rotation_or_bpp_or_stereo,

            
            	bw_def_vsr_mtn_v_taps,

            
            	bw_def_vsr_mtn_4,

            
            	bw_def_auto,

            
            	bw_def_manual,

            
            	bw_def_exceeded_allowed_maximum_sclk,

            
            	bw_def_exceeded_allowed_page_close_open,

            
            	bw_def_exceeded_allowed_outstanding_pte_req_queue_size,

            
            	bw_def_exceeded_allowed_maximum_bw,

            
            	bw_def_landscape,


            	//Panning and bezel

            
            	bw_def_any_lines,


            	//Underlay mode

            
            	bw_def_underlay_only,

            
            	bw_def_blended,

            
            	bw_def_blend,


            	//Stereo mode

            
            	bw_def_mono,

            
            	bw_def_side_by_side,

            
            	bw_def_top_bottom,


            	//Underlay surface type

            
            	bw_def_420,

            
            	bw_def_422,

            
            	bw_def_444,


            	//Tiling mode

            
            	bw_def_linear,

            
            	bw_def_tiled,

            
            	bw_def_array_linear_general,

            
            	bw_def_array_linear_aligned,

            
            	bw_def_rotated_micro_tiling,

            
            	bw_def_display_micro_tiling,


            	//Memory type

            
            	bw_def_gddr5,

            
            	bw_def_hbm,


            	//Voltage

            
            	bw_def_high_no_nbp_state_change,

            
            	bw_def_0_72,

            
            	bw_def_0_8,

            
            	bw_def_0_9,


            	bw_def_notok = -1,

            
            	bw_def_na = -1

            
            };


            struct bw_calcs_dceip {

            
            	enum bw_calcs_version version;

            
            	bool large_cursor;

            
            	uint32_t cursor_max_outstanding_group_num;

            
            	bool dmif_pipe_en_fbc_chunk_tracker;

            
            	struct bw_fixed dmif_request_buffer_size;

            
            	uint32_t lines_interleaved_into_lb;

            
            	uint32_t low_power_tiling_mode;

            
            	uint32_t chunk_width;

            
            	uint32_t number_of_graphics_pipes;

            
            	uint32_t number_of_underlay_pipes;

            
            	bool display_write_back_supported;

            
            	bool argb_compression_support;

            
            	struct bw_fixed underlay_vscaler_efficiency6_bit_per_component;

            
            	struct bw_fixed underlay_vscaler_efficiency8_bit_per_component;

            
            	struct bw_fixed underlay_vscaler_efficiency10_bit_per_component;

            
            	struct bw_fixed underlay_vscaler_efficiency12_bit_per_component;

            
            	struct bw_fixed graphics_vscaler_efficiency6_bit_per_component;

            
            	struct bw_fixed graphics_vscaler_efficiency8_bit_per_component;

            
            	struct bw_fixed graphics_vscaler_efficiency10_bit_per_component;

            
            	struct bw_fixed graphics_vscaler_efficiency12_bit_per_component;

            
            	struct bw_fixed alpha_vscaler_efficiency;

            
            	uint32_t max_dmif_buffer_allocated;

            
            	uint32_t graphics_dmif_size;

            
            	uint32_t underlay_luma_dmif_size;

            
            	uint32_t underlay_chroma_dmif_size;

            
            	bool pre_downscaler_enabled;

            
            	bool underlay_downscale_prefetch_enabled;

            
            	struct bw_fixed lb_write_pixels_per_dispclk;

            
            	struct bw_fixed lb_size_per_component444;

            
            	bool graphics_lb_nodownscaling_multi_line_prefetching;

            
            	struct bw_fixed stutter_and_dram_clock_state_change_gated_before_cursor;

            
            	struct bw_fixed underlay420_luma_lb_size_per_component;

            
            	struct bw_fixed underlay420_chroma_lb_size_per_component;

            
            	struct bw_fixed underlay422_lb_size_per_component;

            
            	struct bw_fixed cursor_chunk_width;

            
            	struct bw_fixed cursor_dcp_buffer_lines;

            
            	struct bw_fixed underlay_maximum_width_efficient_for_tiling;

            
            	struct bw_fixed underlay_maximum_height_efficient_for_tiling;

            
            	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting_multiple_displays_or_single_rotated_display;

            
            	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting_single_display_no_rotation;

            
            	struct bw_fixed minimum_outstanding_pte_request_limit;

            
            	struct bw_fixed maximum_total_outstanding_pte_requests_allowed_by_saw;

            
            	bool limit_excessive_outstanding_dmif_requests;

            
            	struct bw_fixed linear_mode_line_request_alternation_slice;

            
            	uint32_t scatter_gather_lines_of_pte_prefetching_in_linear_mode;

            
            	uint32_t display_write_back420_luma_mcifwr_buffer_size;

            
            	uint32_t display_write_back420_chroma_mcifwr_buffer_size;

            
            	struct bw_fixed request_efficiency;

            
            	struct bw_fixed dispclk_per_request;

            
            	struct bw_fixed dispclk_ramping_factor;

            
            	struct bw_fixed display_pipe_throughput_factor;

            
            	uint32_t scatter_gather_pte_request_rows_in_tiling_mode;

            
            	struct bw_fixed mcifwr_all_surfaces_burst_time;

            
            };


            struct bw_calcs_vbios {

            
            	enum bw_defines memory_type;

            
            	uint32_t dram_channel_width_in_bits;

            
            	uint32_t number_of_dram_channels;

            
            	uint32_t number_of_dram_banks;

            
            	struct bw_fixed low_yclk; /*m_hz*/

            
            	struct bw_fixed mid_yclk; /*m_hz*/

            
            	struct bw_fixed high_yclk; /*m_hz*/

            
            	struct bw_fixed low_sclk; /*m_hz*/

            
            	struct bw_fixed mid1_sclk; /*m_hz*/

            
            	struct bw_fixed mid2_sclk; /*m_hz*/

            
            	struct bw_fixed mid3_sclk; /*m_hz*/

            
            	struct bw_fixed mid4_sclk; /*m_hz*/

            
            	struct bw_fixed mid5_sclk; /*m_hz*/

            
            	struct bw_fixed mid6_sclk; /*m_hz*/

            
            	struct bw_fixed high_sclk; /*m_hz*/

            
            	struct bw_fixed low_voltage_max_dispclk; /*m_hz*/

            
            	struct bw_fixed mid_voltage_max_dispclk; /*m_hz*/

            
            	struct bw_fixed high_voltage_max_dispclk; /*m_hz*/

            
            	struct bw_fixed low_voltage_max_phyclk;

            
            	struct bw_fixed mid_voltage_max_phyclk;

            
            	struct bw_fixed high_voltage_max_phyclk;

            
            	struct bw_fixed data_return_bus_width;

            
            	struct bw_fixed trc;

            
            	struct bw_fixed dmifmc_urgent_latency;

            
            	struct bw_fixed stutter_self_refresh_exit_latency;

            
            	struct bw_fixed stutter_self_refresh_entry_latency;

            
            	struct bw_fixed nbp_state_change_latency;

            
            	struct bw_fixed mcifwrmc_urgent_latency;

            
            	bool scatter_gather_enable;

            
            	struct bw_fixed down_spread_percentage;

            
            	uint32_t cursor_width;

            
            	uint32_t average_compression_rate;

            
            	uint32_t number_of_request_slots_gmc_reserves_for_dmif_per_channel;

            
            	struct bw_fixed blackout_duration;

            
            	struct bw_fixed maximum_blackout_recovery_time;

            
            };


            /*******************************************************************************

            
             * Temporary data structure(s).

            
             ******************************************************************************/

            
            #define maximum_number_of_surfaces 12

            
            /*Units : MHz, us */


            struct bw_calcs_data {

            
            	/* data for all displays */

            
            	uint32_t number_of_displays;

            
            	enum bw_defines underlay_surface_type;

            
            	enum bw_defines panning_and_bezel_adjustment;

            
            	enum bw_defines graphics_tiling_mode;

            
            	uint32_t graphics_lb_bpc;

            
            	uint32_t underlay_lb_bpc;

            
            	enum bw_defines underlay_tiling_mode;

            
            	enum bw_defines d0_underlay_mode;

            
            	bool d1_display_write_back_dwb_enable;

            
            	enum bw_defines d1_underlay_mode;


            	bool cpup_state_change_enable;

            
            	bool cpuc_state_change_enable;

            
            	bool nbp_state_change_enable;

            
            	bool stutter_mode_enable;

            
            	uint32_t y_clk_level;

            
            	uint32_t sclk_level;

            
            	uint32_t number_of_underlay_surfaces;

            
            	uint32_t number_of_dram_wrchannels;

            
            	uint32_t chunk_request_delay;

            
            	uint32_t number_of_dram_channels;

            
            	enum bw_defines underlay_micro_tile_mode;

            
            	enum bw_defines graphics_micro_tile_mode;

            
            	struct bw_fixed max_phyclk;

            
            	struct bw_fixed dram_efficiency;

            
            	struct bw_fixed src_width_after_surface_type;

            
            	struct bw_fixed src_height_after_surface_type;

            
            	struct bw_fixed hsr_after_surface_type;

            
            	struct bw_fixed vsr_after_surface_type;

            
            	struct bw_fixed src_width_after_rotation;

            
            	struct bw_fixed src_height_after_rotation;

            
            	struct bw_fixed hsr_after_rotation;

            
            	struct bw_fixed vsr_after_rotation;

            
            	struct bw_fixed source_height_pixels;

            
            	struct bw_fixed hsr_after_stereo;

            
            	struct bw_fixed vsr_after_stereo;

            
            	struct bw_fixed source_width_in_lb;

            
            	struct bw_fixed lb_line_pitch;

            
            	struct bw_fixed underlay_maximum_source_efficient_for_tiling;

            
            	struct bw_fixed num_lines_at_frame_start;

            
            	struct bw_fixed min_dmif_size_in_time;

            
            	struct bw_fixed min_mcifwr_size_in_time;

            
            	struct bw_fixed total_requests_for_dmif_size;

            
            	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting;

            
            	struct bw_fixed useful_pte_per_pte_request;

            
            	struct bw_fixed scatter_gather_pte_request_rows;

            
            	struct bw_fixed scatter_gather_row_height;

            
            	struct bw_fixed scatter_gather_pte_requests_in_vblank;

            
            	struct bw_fixed inefficient_linear_pitch_in_bytes;

            
            	struct bw_fixed cursor_total_data;

            
            	struct bw_fixed cursor_total_request_groups;

            
            	struct bw_fixed scatter_gather_total_pte_requests;

            
            	struct bw_fixed scatter_gather_total_pte_request_groups;

            
            	struct bw_fixed tile_width_in_pixels;

            
            	struct bw_fixed dmif_total_number_of_data_request_page_close_open;

            
            	struct bw_fixed mcifwr_total_number_of_data_request_page_close_open;

            
            	struct bw_fixed bytes_per_page_close_open;

            
            	struct bw_fixed mcifwr_total_page_close_open_time;

            
            	struct bw_fixed total_requests_for_adjusted_dmif_size;

            
            	struct bw_fixed total_dmifmc_urgent_trips;

            
            	struct bw_fixed total_dmifmc_urgent_latency;

            
            	struct bw_fixed total_display_reads_required_data;

            
            	struct bw_fixed total_display_reads_required_dram_access_data;

            
            	struct bw_fixed total_display_writes_required_data;

            
            	struct bw_fixed total_display_writes_required_dram_access_data;

            
            	struct bw_fixed display_reads_required_data;

            
            	struct bw_fixed display_reads_required_dram_access_data;

            
            	struct bw_fixed dmif_total_page_close_open_time;

            
            	struct bw_fixed min_cursor_memory_interface_buffer_size_in_time;

            
            	struct bw_fixed min_read_buffer_size_in_time;

            
            	struct bw_fixed display_reads_time_for_data_transfer;

            
            	struct bw_fixed display_writes_time_for_data_transfer;

            
            	struct bw_fixed dmif_required_dram_bandwidth;

            
            	struct bw_fixed mcifwr_required_dram_bandwidth;

            
            	struct bw_fixed required_dmifmc_urgent_latency_for_page_close_open;

            
            	struct bw_fixed required_mcifmcwr_urgent_latency;

            
            	struct bw_fixed required_dram_bandwidth_gbyte_per_second;

            
            	struct bw_fixed dram_bandwidth;

            
            	struct bw_fixed dmif_required_sclk;

            
            	struct bw_fixed mcifwr_required_sclk;

            
            	struct bw_fixed required_sclk;

            
            	struct bw_fixed downspread_factor;

            
            	struct bw_fixed v_scaler_efficiency;

            
            	struct bw_fixed scaler_limits_factor;

            
            	struct bw_fixed display_pipe_pixel_throughput;

            
            	struct bw_fixed total_dispclk_required_with_ramping;

            
            	struct bw_fixed total_dispclk_required_without_ramping;

            
            	struct bw_fixed total_read_request_bandwidth;

            
            	struct bw_fixed total_write_request_bandwidth;

            
            	struct bw_fixed dispclk_required_for_total_read_request_bandwidth;

            
            	struct bw_fixed total_dispclk_required_with_ramping_with_request_bandwidth;

            
            	struct bw_fixed total_dispclk_required_without_ramping_with_request_bandwidth;

            
            	struct bw_fixed dispclk;

            
            	struct bw_fixed blackout_recovery_time;

            
            	struct bw_fixed min_pixels_per_data_fifo_entry;

            
            	struct bw_fixed sclk_deep_sleep;

            
            	struct bw_fixed chunk_request_time;

            
            	struct bw_fixed cursor_request_time;

            
            	struct bw_fixed line_source_pixels_transfer_time;

            
            	struct bw_fixed dmifdram_access_efficiency;

            
            	struct bw_fixed mcifwrdram_access_efficiency;

            
            	struct bw_fixed total_average_bandwidth_no_compression;

            
            	struct bw_fixed total_average_bandwidth;

            
            	struct bw_fixed total_stutter_cycle_duration;

            
            	struct bw_fixed stutter_burst_time;

            
            	struct bw_fixed time_in_self_refresh;

            
            	struct bw_fixed stutter_efficiency;

            
            	struct bw_fixed worst_number_of_trips_to_memory;

            
            	struct bw_fixed immediate_flip_time;

            
            	struct bw_fixed latency_for_non_dmif_clients;

            
            	struct bw_fixed latency_for_non_mcifwr_clients;

            
            	struct bw_fixed dmifmc_urgent_latency_supported_in_high_sclk_and_yclk;

            
            	struct bw_fixed nbp_state_dram_speed_change_margin;

            
            	struct bw_fixed display_reads_time_for_data_transfer_and_urgent_latency;

            
            	struct bw_fixed dram_speed_change_margin;

            
            	struct bw_fixed min_vblank_dram_speed_change_margin;

            
            	struct bw_fixed min_stutter_refresh_duration;

            
            	uint32_t total_stutter_dmif_buffer_size;

            
            	uint32_t total_bytes_requested;

            
            	uint32_t min_stutter_dmif_buffer_size;

            
            	uint32_t num_stutter_bursts;

            
            	struct bw_fixed v_blank_nbp_state_dram_speed_change_latency_supported;

            
            	struct bw_fixed nbp_state_dram_speed_change_latency_supported;

            
            	bool fbc_en[maximum_number_of_surfaces];

            
            	bool lpt_en[maximum_number_of_surfaces];

            
            	bool displays_match_flag[maximum_number_of_surfaces];

            
            	bool use_alpha[maximum_number_of_surfaces];

            
            	bool orthogonal_rotation[maximum_number_of_surfaces];

            
            	bool enable[maximum_number_of_surfaces];

            
            	bool access_one_channel_only[maximum_number_of_surfaces];

            
            	bool scatter_gather_enable_for_pipe[maximum_number_of_surfaces];

            
            	bool interlace_mode[maximum_number_of_surfaces];

            
            	bool display_pstate_change_enable[maximum_number_of_surfaces];

            
            	bool line_buffer_prefetch[maximum_number_of_surfaces];

            
            	uint32_t bytes_per_pixel[maximum_number_of_surfaces];

            
            	uint32_t max_chunks_non_fbc_mode[maximum_number_of_surfaces];

            
            	uint32_t lb_bpc[maximum_number_of_surfaces];

            
            	uint32_t output_bpphdmi[maximum_number_of_surfaces];

            
            	uint32_t output_bppdp4_lane_hbr[maximum_number_of_surfaces];

            
            	uint32_t output_bppdp4_lane_hbr2[maximum_number_of_surfaces];

            
            	uint32_t output_bppdp4_lane_hbr3[maximum_number_of_surfaces];

            
            	enum bw_defines stereo_mode[maximum_number_of_surfaces];

            
            	struct bw_fixed dmif_buffer_transfer_time[maximum_number_of_surfaces];

            
            	struct bw_fixed displays_with_same_mode[maximum_number_of_surfaces];

            
            	struct bw_fixed stutter_dmif_buffer_size[maximum_number_of_surfaces];

            
            	struct bw_fixed stutter_refresh_duration[maximum_number_of_surfaces];

            
            	struct bw_fixed stutter_exit_watermark[maximum_number_of_surfaces];

            
            	struct bw_fixed stutter_entry_watermark[maximum_number_of_surfaces];

            
            	struct bw_fixed h_total[maximum_number_of_surfaces];

            
            	struct bw_fixed v_total[maximum_number_of_surfaces];

            
            	struct bw_fixed pixel_rate[maximum_number_of_surfaces];

            
            	struct bw_fixed src_width[maximum_number_of_surfaces];

            
            	struct bw_fixed pitch_in_pixels[maximum_number_of_surfaces];

            
            	struct bw_fixed pitch_in_pixels_after_surface_type[maximum_number_of_surfaces];

            
            	struct bw_fixed src_height[maximum_number_of_surfaces];

            
            	struct bw_fixed scale_ratio[maximum_number_of_surfaces];

            
            	struct bw_fixed h_taps[maximum_number_of_surfaces];

            
            	struct bw_fixed v_taps[maximum_number_of_surfaces];

            
            	struct bw_fixed h_scale_ratio[maximum_number_of_surfaces];

            
            	struct bw_fixed v_scale_ratio[maximum_number_of_surfaces];

            
            	struct bw_fixed rotation_angle[maximum_number_of_surfaces];

            
            	struct bw_fixed compression_rate[maximum_number_of_surfaces];

            
            	struct bw_fixed hsr[maximum_number_of_surfaces];

            
            	struct bw_fixed vsr[maximum_number_of_surfaces];

            
            	struct bw_fixed source_width_rounded_up_to_chunks[maximum_number_of_surfaces];

            
            	struct bw_fixed source_width_pixels[maximum_number_of_surfaces];

            
            	struct bw_fixed source_height_rounded_up_to_chunks[maximum_number_of_surfaces];

            
            	struct bw_fixed display_bandwidth[maximum_number_of_surfaces];

            
            	struct bw_fixed request_bandwidth[maximum_number_of_surfaces];

            
            	struct bw_fixed bytes_per_request[maximum_number_of_surfaces];

            
            	struct bw_fixed useful_bytes_per_request[maximum_number_of_surfaces];

            
            	struct bw_fixed lines_interleaved_in_mem_access[maximum_number_of_surfaces];

            
            	struct bw_fixed latency_hiding_lines[maximum_number_of_surfaces];

            
            	struct bw_fixed lb_partitions[maximum_number_of_surfaces];

            
            	struct bw_fixed lb_partitions_max[maximum_number_of_surfaces];

            
            	struct bw_fixed dispclk_required_with_ramping[maximum_number_of_surfaces];

            
            	struct bw_fixed dispclk_required_without_ramping[maximum_number_of_surfaces];

            
            	struct bw_fixed data_buffer_size[maximum_number_of_surfaces];

            
            	struct bw_fixed outstanding_chunk_request_limit[maximum_number_of_surfaces];

            
            	struct bw_fixed urgent_watermark[maximum_number_of_surfaces];

            
            	struct bw_fixed nbp_state_change_watermark[maximum_number_of_surfaces];

            
            	struct bw_fixed v_filter_init[maximum_number_of_surfaces];

            
            	struct bw_fixed stutter_cycle_duration[maximum_number_of_surfaces];

            
            	struct bw_fixed average_bandwidth[maximum_number_of_surfaces];

            
            	struct bw_fixed average_bandwidth_no_compression[maximum_number_of_surfaces];

            
            	struct bw_fixed scatter_gather_pte_request_limit[maximum_number_of_surfaces];

            
            	struct bw_fixed lb_size_per_component[maximum_number_of_surfaces];

            
            	struct bw_fixed memory_chunk_size_in_bytes[maximum_number_of_surfaces];

            
            	struct bw_fixed pipe_chunk_size_in_bytes[maximum_number_of_surfaces];

            
            	struct bw_fixed number_of_trips_to_memory_for_getting_apte_row[maximum_number_of_surfaces];

            
            	struct bw_fixed adjusted_data_buffer_size[maximum_number_of_surfaces];

            
            	struct bw_fixed adjusted_data_buffer_size_in_memory[maximum_number_of_surfaces];

            
            	struct bw_fixed pixels_per_data_fifo_entry[maximum_number_of_surfaces];

            
            	struct bw_fixed scatter_gather_pte_requests_in_row[maximum_number_of_surfaces];

            
            	struct bw_fixed pte_request_per_chunk[maximum_number_of_surfaces];

            
            	struct bw_fixed scatter_gather_page_width[maximum_number_of_surfaces];

            
            	struct bw_fixed scatter_gather_page_height[maximum_number_of_surfaces];

            
            	struct bw_fixed lb_lines_in_per_line_out_in_beginning_of_frame[maximum_number_of_surfaces];

            
            	struct bw_fixed lb_lines_in_per_line_out_in_middle_of_frame[maximum_number_of_surfaces];

            
            	struct bw_fixed cursor_width_pixels[maximum_number_of_surfaces];

            
            	struct bw_fixed minimum_latency_hiding[maximum_number_of_surfaces];

            
            	struct bw_fixed maximum_latency_hiding[maximum_number_of_surfaces];

            
            	struct bw_fixed minimum_latency_hiding_with_cursor[maximum_number_of_surfaces];

            
            	struct bw_fixed maximum_latency_hiding_with_cursor[maximum_number_of_surfaces];

            
            	struct bw_fixed src_pixels_for_first_output_pixel[maximum_number_of_surfaces];

            
            	struct bw_fixed src_pixels_for_last_output_pixel[maximum_number_of_surfaces];

            
            	struct bw_fixed src_data_for_first_output_pixel[maximum_number_of_surfaces];

            
            	struct bw_fixed src_data_for_last_output_pixel[maximum_number_of_surfaces];

            
            	struct bw_fixed active_time[maximum_number_of_surfaces];

            
            	struct bw_fixed horizontal_blank_and_chunk_granularity_factor[maximum_number_of_surfaces];

            
            	struct bw_fixed cursor_latency_hiding[maximum_number_of_surfaces];

            
            	struct bw_fixed v_blank_dram_speed_change_margin[maximum_number_of_surfaces];

            
            	uint32_t num_displays_with_margin[3][8];

            
            	struct bw_fixed dmif_burst_time[3][8];

            
            	struct bw_fixed mcifwr_burst_time[3][8];

            
            	struct bw_fixed line_source_transfer_time[maximum_number_of_surfaces][3][8];

            
            	struct bw_fixed dram_speed_change_line_source_transfer_time[maximum_number_of_surfaces][3][8];

            
            	struct bw_fixed min_dram_speed_change_margin[3][8];

            
            	struct bw_fixed dispclk_required_for_dram_speed_change[3][8];

            
            	struct bw_fixed blackout_duration_margin[3][8];

            
            	struct bw_fixed dispclk_required_for_blackout_duration[3][8];

            
            	struct bw_fixed dispclk_required_for_blackout_recovery[3][8];

            
            	struct bw_fixed dmif_required_sclk_for_urgent_latency[6];

            
            };


            /**

            
             * Initialize structures with data which will NOT change at runtime.

            
             */

            
            void bw_calcs_init(

            
            	struct bw_calcs_dceip *bw_dceip,

            
            	struct bw_calcs_vbios *bw_vbios,

            
            	struct hw_asic_id asic_id);


            /**

            
             * Return:

            
             *	true -	Display(s) configuration supported.

            
             *		In this case 'calcs_output' contains data for HW programming

            
             *	false - Display(s) configuration not supported (not enough bandwidth).

            
             */

            
            bool bw_calcs(

            
            	struct dc_context *ctx,

            
            	const struct bw_calcs_dceip *dceip,

            
            	const struct bw_calcs_vbios *vbios,

            
            	const struct pipe_ctx *pipe,

            
            	int pipe_count,

            
            	struct dce_bw_output *calcs_output);


            #endif /* __BANDWIDTH_CALCS_H__ */
	/*
	* Copyright 2015-2017 Advanced Micro Devices, Inc.
	*
	* Permission is hereby granted, free of charge, to any person obtaining a
	* copy of this software and associated documentation files (the "Software"),
	* to deal in the Software without restriction, including without limitation
	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	* and/or sell copies of the Software, and to permit persons to whom the
	* Software is furnished to do so, subject to the following conditions:
	*
	* The above copyright notice and this permission notice shall be included in
	* all copies or substantial portions of the Software.
	*
	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	* THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
	* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
	* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
	* OTHER DEALINGS IN THE SOFTWARE.
	*
	* Authors: AMD
	*
	*/

	/**
	* Bandwidth and Watermark calculations interface.
	* (Refer to "DCEx_mode_support.xlsm" from Perforce.)
	*/
	#ifndef __DCE_CALCS_H__
	#define __DCE_CALCS_H__

	#include "bw_fixed.h"

	struct pipe_ctx;
	struct dc;
	struct dc_state;
	struct dce_bw_output;

	enum bw_calcs_version {
	BW_CALCS_VERSION_INVALID,
	BW_CALCS_VERSION_CARRIZO,
	BW_CALCS_VERSION_POLARIS10,
	BW_CALCS_VERSION_POLARIS11,
	BW_CALCS_VERSION_STONEY,
	BW_CALCS_VERSION_VEGA10
	};

	/*******************************************************************************
	* There are three types of input into Calculations:
	* 1. per-DCE static values - these are "hardcoded" properties of the DCEIP
	* 2. board-level values - these are generally coming from VBIOS parser
	* 3. mode/configuration values - depending Mode, Scaling number of Displays etc.
	******************************************************************************/

	enum bw_defines {
	//Common
	bw_def_no = 0,
	bw_def_none = 0,
	bw_def_yes = 1,
	bw_def_ok = 1,
	bw_def_high = 2,
	bw_def_mid = 1,
	bw_def_low = 0,

	//Internal
	bw_defs_start = 255,
	bw_def_underlay422,
	bw_def_underlay420_luma,
	bw_def_underlay420_chroma,
	bw_def_underlay444,
	bw_def_graphics,
	bw_def_display_write_back420_luma,
	bw_def_display_write_back420_chroma,
	bw_def_portrait,
	bw_def_hsr_mtn_4,
	bw_def_hsr_mtn_h_taps,
	bw_def_ceiling__h_taps_div_4___meq_hsr,
	bw_def_invalid_linear_or_stereo_mode,
	bw_def_invalid_rotation_or_bpp_or_stereo,
	bw_def_vsr_mtn_v_taps,
	bw_def_vsr_mtn_4,
	bw_def_auto,
	bw_def_manual,
	bw_def_exceeded_allowed_maximum_sclk,
	bw_def_exceeded_allowed_page_close_open,
	bw_def_exceeded_allowed_outstanding_pte_req_queue_size,
	bw_def_exceeded_allowed_maximum_bw,
	bw_def_landscape,

	//Panning and bezel
	bw_def_any_lines,

	//Underlay mode
	bw_def_underlay_only,
	bw_def_blended,
	bw_def_blend,

	//Stereo mode
	bw_def_mono,
	bw_def_side_by_side,
	bw_def_top_bottom,

	//Underlay surface type
	bw_def_420,
	bw_def_422,
	bw_def_444,

	//Tiling mode
	bw_def_linear,
	bw_def_tiled,
	bw_def_array_linear_general,
	bw_def_array_linear_aligned,
	bw_def_rotated_micro_tiling,
	bw_def_display_micro_tiling,

	//Memory type
	bw_def_gddr5,
	bw_def_hbm,

	//Voltage
	bw_def_high_no_nbp_state_change,
	bw_def_0_72,
	bw_def_0_8,
	bw_def_0_9,

	bw_def_notok = -1,
	bw_def_na = -1
	};

	struct bw_calcs_dceip {
	enum bw_calcs_version version;
	bool large_cursor;
	uint32_t cursor_max_outstanding_group_num;
	bool dmif_pipe_en_fbc_chunk_tracker;
	struct bw_fixed dmif_request_buffer_size;
	uint32_t lines_interleaved_into_lb;
	uint32_t low_power_tiling_mode;
	uint32_t chunk_width;
	uint32_t number_of_graphics_pipes;
	uint32_t number_of_underlay_pipes;
	bool display_write_back_supported;
	bool argb_compression_support;
	struct bw_fixed underlay_vscaler_efficiency6_bit_per_component;
	struct bw_fixed underlay_vscaler_efficiency8_bit_per_component;
	struct bw_fixed underlay_vscaler_efficiency10_bit_per_component;
	struct bw_fixed underlay_vscaler_efficiency12_bit_per_component;
	struct bw_fixed graphics_vscaler_efficiency6_bit_per_component;
	struct bw_fixed graphics_vscaler_efficiency8_bit_per_component;
	struct bw_fixed graphics_vscaler_efficiency10_bit_per_component;
	struct bw_fixed graphics_vscaler_efficiency12_bit_per_component;
	struct bw_fixed alpha_vscaler_efficiency;
	uint32_t max_dmif_buffer_allocated;
	uint32_t graphics_dmif_size;
	uint32_t underlay_luma_dmif_size;
	uint32_t underlay_chroma_dmif_size;
	bool pre_downscaler_enabled;
	bool underlay_downscale_prefetch_enabled;
	struct bw_fixed lb_write_pixels_per_dispclk;
	struct bw_fixed lb_size_per_component444;
	bool graphics_lb_nodownscaling_multi_line_prefetching;
	struct bw_fixed stutter_and_dram_clock_state_change_gated_before_cursor;
	struct bw_fixed underlay420_luma_lb_size_per_component;
	struct bw_fixed underlay420_chroma_lb_size_per_component;
	struct bw_fixed underlay422_lb_size_per_component;
	struct bw_fixed cursor_chunk_width;
	struct bw_fixed cursor_dcp_buffer_lines;
	struct bw_fixed underlay_maximum_width_efficient_for_tiling;
	struct bw_fixed underlay_maximum_height_efficient_for_tiling;
	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting_multiple_displays_or_single_rotated_display;
	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting_single_display_no_rotation;
	struct bw_fixed minimum_outstanding_pte_request_limit;
	struct bw_fixed maximum_total_outstanding_pte_requests_allowed_by_saw;
	bool limit_excessive_outstanding_dmif_requests;
	struct bw_fixed linear_mode_line_request_alternation_slice;
	uint32_t scatter_gather_lines_of_pte_prefetching_in_linear_mode;
	uint32_t display_write_back420_luma_mcifwr_buffer_size;
	uint32_t display_write_back420_chroma_mcifwr_buffer_size;
	struct bw_fixed request_efficiency;
	struct bw_fixed dispclk_per_request;
	struct bw_fixed dispclk_ramping_factor;
	struct bw_fixed display_pipe_throughput_factor;
	uint32_t scatter_gather_pte_request_rows_in_tiling_mode;
	struct bw_fixed mcifwr_all_surfaces_burst_time;
	};

	struct bw_calcs_vbios {
	enum bw_defines memory_type;
	uint32_t dram_channel_width_in_bits;
	uint32_t number_of_dram_channels;
	uint32_t number_of_dram_banks;
	struct bw_fixed low_yclk; /m_hz/
	struct bw_fixed mid_yclk; /m_hz/
	struct bw_fixed high_yclk; /m_hz/
	struct bw_fixed low_sclk; /m_hz/
	struct bw_fixed mid1_sclk; /m_hz/
	struct bw_fixed mid2_sclk; /m_hz/
	struct bw_fixed mid3_sclk; /m_hz/
	struct bw_fixed mid4_sclk; /m_hz/
	struct bw_fixed mid5_sclk; /m_hz/
	struct bw_fixed mid6_sclk; /m_hz/
	struct bw_fixed high_sclk; /m_hz/
	struct bw_fixed low_voltage_max_dispclk; /m_hz/
	struct bw_fixed mid_voltage_max_dispclk; /m_hz/
	struct bw_fixed high_voltage_max_dispclk; /m_hz/
	struct bw_fixed low_voltage_max_phyclk;
	struct bw_fixed mid_voltage_max_phyclk;
	struct bw_fixed high_voltage_max_phyclk;
	struct bw_fixed data_return_bus_width;
	struct bw_fixed trc;
	struct bw_fixed dmifmc_urgent_latency;
	struct bw_fixed stutter_self_refresh_exit_latency;
	struct bw_fixed stutter_self_refresh_entry_latency;
	struct bw_fixed nbp_state_change_latency;
	struct bw_fixed mcifwrmc_urgent_latency;
	bool scatter_gather_enable;
	struct bw_fixed down_spread_percentage;
	uint32_t cursor_width;
	uint32_t average_compression_rate;
	uint32_t number_of_request_slots_gmc_reserves_for_dmif_per_channel;
	struct bw_fixed blackout_duration;
	struct bw_fixed maximum_blackout_recovery_time;
	};

	/*******************************************************************************
	* Temporary data structure(s).
	******************************************************************************/
	#define maximum_number_of_surfaces 12
	/Units : MHz, us /

	struct bw_calcs_data {
	/* data for all displays */
	uint32_t number_of_displays;
	enum bw_defines underlay_surface_type;
	enum bw_defines panning_and_bezel_adjustment;
	enum bw_defines graphics_tiling_mode;
	uint32_t graphics_lb_bpc;
	uint32_t underlay_lb_bpc;
	enum bw_defines underlay_tiling_mode;
	enum bw_defines d0_underlay_mode;
	bool d1_display_write_back_dwb_enable;
	enum bw_defines d1_underlay_mode;

	bool cpup_state_change_enable;
	bool cpuc_state_change_enable;
	bool nbp_state_change_enable;
	bool stutter_mode_enable;
	uint32_t y_clk_level;
	uint32_t sclk_level;
	uint32_t number_of_underlay_surfaces;
	uint32_t number_of_dram_wrchannels;
	uint32_t chunk_request_delay;
	uint32_t number_of_dram_channels;
	enum bw_defines underlay_micro_tile_mode;
	enum bw_defines graphics_micro_tile_mode;
	struct bw_fixed max_phyclk;
	struct bw_fixed dram_efficiency;
	struct bw_fixed src_width_after_surface_type;
	struct bw_fixed src_height_after_surface_type;
	struct bw_fixed hsr_after_surface_type;
	struct bw_fixed vsr_after_surface_type;
	struct bw_fixed src_width_after_rotation;
	struct bw_fixed src_height_after_rotation;
	struct bw_fixed hsr_after_rotation;
	struct bw_fixed vsr_after_rotation;
	struct bw_fixed source_height_pixels;
	struct bw_fixed hsr_after_stereo;
	struct bw_fixed vsr_after_stereo;
	struct bw_fixed source_width_in_lb;
	struct bw_fixed lb_line_pitch;
	struct bw_fixed underlay_maximum_source_efficient_for_tiling;
	struct bw_fixed num_lines_at_frame_start;
	struct bw_fixed min_dmif_size_in_time;
	struct bw_fixed min_mcifwr_size_in_time;
	struct bw_fixed total_requests_for_dmif_size;
	struct bw_fixed peak_pte_request_to_eviction_ratio_limiting;
	struct bw_fixed useful_pte_per_pte_request;
	struct bw_fixed scatter_gather_pte_request_rows;
	struct bw_fixed scatter_gather_row_height;
	struct bw_fixed scatter_gather_pte_requests_in_vblank;
	struct bw_fixed inefficient_linear_pitch_in_bytes;
	struct bw_fixed cursor_total_data;
	struct bw_fixed cursor_total_request_groups;
	struct bw_fixed scatter_gather_total_pte_requests;
	struct bw_fixed scatter_gather_total_pte_request_groups;
	struct bw_fixed tile_width_in_pixels;
	struct bw_fixed dmif_total_number_of_data_request_page_close_open;
	struct bw_fixed mcifwr_total_number_of_data_request_page_close_open;
	struct bw_fixed bytes_per_page_close_open;
	struct bw_fixed mcifwr_total_page_close_open_time;
	struct bw_fixed total_requests_for_adjusted_dmif_size;
	struct bw_fixed total_dmifmc_urgent_trips;
	struct bw_fixed total_dmifmc_urgent_latency;
	struct bw_fixed total_display_reads_required_data;
	struct bw_fixed total_display_reads_required_dram_access_data;
	struct bw_fixed total_display_writes_required_data;
	struct bw_fixed total_display_writes_required_dram_access_data;
	struct bw_fixed display_reads_required_data;
	struct bw_fixed display_reads_required_dram_access_data;
	struct bw_fixed dmif_total_page_close_open_time;
	struct bw_fixed min_cursor_memory_interface_buffer_size_in_time;
	struct bw_fixed min_read_buffer_size_in_time;
	struct bw_fixed display_reads_time_for_data_transfer;
	struct bw_fixed display_writes_time_for_data_transfer;
	struct bw_fixed dmif_required_dram_bandwidth;
	struct bw_fixed mcifwr_required_dram_bandwidth;
	struct bw_fixed required_dmifmc_urgent_latency_for_page_close_open;
	struct bw_fixed required_mcifmcwr_urgent_latency;
	struct bw_fixed required_dram_bandwidth_gbyte_per_second;
	struct bw_fixed dram_bandwidth;
	struct bw_fixed dmif_required_sclk;
	struct bw_fixed mcifwr_required_sclk;
	struct bw_fixed required_sclk;
	struct bw_fixed downspread_factor;
	struct bw_fixed v_scaler_efficiency;
	struct bw_fixed scaler_limits_factor;
	struct bw_fixed display_pipe_pixel_throughput;
	struct bw_fixed total_dispclk_required_with_ramping;
	struct bw_fixed total_dispclk_required_without_ramping;
	struct bw_fixed total_read_request_bandwidth;
	struct bw_fixed total_write_request_bandwidth;
	struct bw_fixed dispclk_required_for_total_read_request_bandwidth;
	struct bw_fixed total_dispclk_required_with_ramping_with_request_bandwidth;
	struct bw_fixed total_dispclk_required_without_ramping_with_request_bandwidth;
	struct bw_fixed dispclk;
	struct bw_fixed blackout_recovery_time;
	struct bw_fixed min_pixels_per_data_fifo_entry;
	struct bw_fixed sclk_deep_sleep;
	struct bw_fixed chunk_request_time;
	struct bw_fixed cursor_request_time;
	struct bw_fixed line_source_pixels_transfer_time;
	struct bw_fixed dmifdram_access_efficiency;
	struct bw_fixed mcifwrdram_access_efficiency;
	struct bw_fixed total_average_bandwidth_no_compression;
	struct bw_fixed total_average_bandwidth;
	struct bw_fixed total_stutter_cycle_duration;
	struct bw_fixed stutter_burst_time;
	struct bw_fixed time_in_self_refresh;
	struct bw_fixed stutter_efficiency;
	struct bw_fixed worst_number_of_trips_to_memory;
	struct bw_fixed immediate_flip_time;
	struct bw_fixed latency_for_non_dmif_clients;
	struct bw_fixed latency_for_non_mcifwr_clients;
	struct bw_fixed dmifmc_urgent_latency_supported_in_high_sclk_and_yclk;
	struct bw_fixed nbp_state_dram_speed_change_margin;
	struct bw_fixed display_reads_time_for_data_transfer_and_urgent_latency;
	struct bw_fixed dram_speed_change_margin;
	struct bw_fixed min_vblank_dram_speed_change_margin;
	struct bw_fixed min_stutter_refresh_duration;
	uint32_t total_stutter_dmif_buffer_size;
	uint32_t total_bytes_requested;
	uint32_t min_stutter_dmif_buffer_size;
	uint32_t num_stutter_bursts;
	struct bw_fixed v_blank_nbp_state_dram_speed_change_latency_supported;
	struct bw_fixed nbp_state_dram_speed_change_latency_supported;
	bool fbc_en[maximum_number_of_surfaces];
	bool lpt_en[maximum_number_of_surfaces];
	bool displays_match_flag[maximum_number_of_surfaces];
	bool use_alpha[maximum_number_of_surfaces];
	bool orthogonal_rotation[maximum_number_of_surfaces];
	bool enable[maximum_number_of_surfaces];
	bool access_one_channel_only[maximum_number_of_surfaces];
	bool scatter_gather_enable_for_pipe[maximum_number_of_surfaces];
	bool interlace_mode[maximum_number_of_surfaces];
	bool display_pstate_change_enable[maximum_number_of_surfaces];
	bool line_buffer_prefetch[maximum_number_of_surfaces];
	uint32_t bytes_per_pixel[maximum_number_of_surfaces];
	uint32_t max_chunks_non_fbc_mode[maximum_number_of_surfaces];
	uint32_t lb_bpc[maximum_number_of_surfaces];
	uint32_t output_bpphdmi[maximum_number_of_surfaces];
	uint32_t output_bppdp4_lane_hbr[maximum_number_of_surfaces];
	uint32_t output_bppdp4_lane_hbr2[maximum_number_of_surfaces];
	uint32_t output_bppdp4_lane_hbr3[maximum_number_of_surfaces];
	enum bw_defines stereo_mode[maximum_number_of_surfaces];
	struct bw_fixed dmif_buffer_transfer_time[maximum_number_of_surfaces];
	struct bw_fixed displays_with_same_mode[maximum_number_of_surfaces];
	struct bw_fixed stutter_dmif_buffer_size[maximum_number_of_surfaces];
	struct bw_fixed stutter_refresh_duration[maximum_number_of_surfaces];
	struct bw_fixed stutter_exit_watermark[maximum_number_of_surfaces];
	struct bw_fixed stutter_entry_watermark[maximum_number_of_surfaces];
	struct bw_fixed h_total[maximum_number_of_surfaces];
	struct bw_fixed v_total[maximum_number_of_surfaces];
	struct bw_fixed pixel_rate[maximum_number_of_surfaces];
	struct bw_fixed src_width[maximum_number_of_surfaces];
	struct bw_fixed pitch_in_pixels[maximum_number_of_surfaces];
	struct bw_fixed pitch_in_pixels_after_surface_type[maximum_number_of_surfaces];
	struct bw_fixed src_height[maximum_number_of_surfaces];
	struct bw_fixed scale_ratio[maximum_number_of_surfaces];
	struct bw_fixed h_taps[maximum_number_of_surfaces];
	struct bw_fixed v_taps[maximum_number_of_surfaces];
	struct bw_fixed h_scale_ratio[maximum_number_of_surfaces];
	struct bw_fixed v_scale_ratio[maximum_number_of_surfaces];
	struct bw_fixed rotation_angle[maximum_number_of_surfaces];
	struct bw_fixed compression_rate[maximum_number_of_surfaces];
	struct bw_fixed hsr[maximum_number_of_surfaces];
	struct bw_fixed vsr[maximum_number_of_surfaces];
	struct bw_fixed source_width_rounded_up_to_chunks[maximum_number_of_surfaces];
	struct bw_fixed source_width_pixels[maximum_number_of_surfaces];
	struct bw_fixed source_height_rounded_up_to_chunks[maximum_number_of_surfaces];
	struct bw_fixed display_bandwidth[maximum_number_of_surfaces];
	struct bw_fixed request_bandwidth[maximum_number_of_surfaces];
	struct bw_fixed bytes_per_request[maximum_number_of_surfaces];
	struct bw_fixed useful_bytes_per_request[maximum_number_of_surfaces];
	struct bw_fixed lines_interleaved_in_mem_access[maximum_number_of_surfaces];
	struct bw_fixed latency_hiding_lines[maximum_number_of_surfaces];
	struct bw_fixed lb_partitions[maximum_number_of_surfaces];
	struct bw_fixed lb_partitions_max[maximum_number_of_surfaces];
	struct bw_fixed dispclk_required_with_ramping[maximum_number_of_surfaces];
	struct bw_fixed dispclk_required_without_ramping[maximum_number_of_surfaces];
	struct bw_fixed data_buffer_size[maximum_number_of_surfaces];
	struct bw_fixed outstanding_chunk_request_limit[maximum_number_of_surfaces];
	struct bw_fixed urgent_watermark[maximum_number_of_surfaces];
	struct bw_fixed nbp_state_change_watermark[maximum_number_of_surfaces];
	struct bw_fixed v_filter_init[maximum_number_of_surfaces];
	struct bw_fixed stutter_cycle_duration[maximum_number_of_surfaces];
	struct bw_fixed average_bandwidth[maximum_number_of_surfaces];
	struct bw_fixed average_bandwidth_no_compression[maximum_number_of_surfaces];
	struct bw_fixed scatter_gather_pte_request_limit[maximum_number_of_surfaces];
	struct bw_fixed lb_size_per_component[maximum_number_of_surfaces];
	struct bw_fixed memory_chunk_size_in_bytes[maximum_number_of_surfaces];
	struct bw_fixed pipe_chunk_size_in_bytes[maximum_number_of_surfaces];
	struct bw_fixed number_of_trips_to_memory_for_getting_apte_row[maximum_number_of_surfaces];
	struct bw_fixed adjusted_data_buffer_size[maximum_number_of_surfaces];
	struct bw_fixed adjusted_data_buffer_size_in_memory[maximum_number_of_surfaces];
	struct bw_fixed pixels_per_data_fifo_entry[maximum_number_of_surfaces];
	struct bw_fixed scatter_gather_pte_requests_in_row[maximum_number_of_surfaces];
	struct bw_fixed pte_request_per_chunk[maximum_number_of_surfaces];
	struct bw_fixed scatter_gather_page_width[maximum_number_of_surfaces];
	struct bw_fixed scatter_gather_page_height[maximum_number_of_surfaces];
	struct bw_fixed lb_lines_in_per_line_out_in_beginning_of_frame[maximum_number_of_surfaces];
	struct bw_fixed lb_lines_in_per_line_out_in_middle_of_frame[maximum_number_of_surfaces];
	struct bw_fixed cursor_width_pixels[maximum_number_of_surfaces];
	struct bw_fixed minimum_latency_hiding[maximum_number_of_surfaces];
	struct bw_fixed maximum_latency_hiding[maximum_number_of_surfaces];
	struct bw_fixed minimum_latency_hiding_with_cursor[maximum_number_of_surfaces];
	struct bw_fixed maximum_latency_hiding_with_cursor[maximum_number_of_surfaces];
	struct bw_fixed src_pixels_for_first_output_pixel[maximum_number_of_surfaces];
	struct bw_fixed src_pixels_for_last_output_pixel[maximum_number_of_surfaces];
	struct bw_fixed src_data_for_first_output_pixel[maximum_number_of_surfaces];
	struct bw_fixed src_data_for_last_output_pixel[maximum_number_of_surfaces];
	struct bw_fixed active_time[maximum_number_of_surfaces];
	struct bw_fixed horizontal_blank_and_chunk_granularity_factor[maximum_number_of_surfaces];
	struct bw_fixed cursor_latency_hiding[maximum_number_of_surfaces];
	struct bw_fixed v_blank_dram_speed_change_margin[maximum_number_of_surfaces];
	uint32_t num_displays_with_margin[3][8];
	struct bw_fixed dmif_burst_time[3][8];
	struct bw_fixed mcifwr_burst_time[3][8];
	struct bw_fixed line_source_transfer_time[maximum_number_of_surfaces][3][8];
	struct bw_fixed dram_speed_change_line_source_transfer_time[maximum_number_of_surfaces][3][8];
	struct bw_fixed min_dram_speed_change_margin[3][8];
	struct bw_fixed dispclk_required_for_dram_speed_change[3][8];
	struct bw_fixed blackout_duration_margin[3][8];
	struct bw_fixed dispclk_required_for_blackout_duration[3][8];
	struct bw_fixed dispclk_required_for_blackout_recovery[3][8];
	struct bw_fixed dmif_required_sclk_for_urgent_latency[6];
	};

	/**
	* Initialize structures with data which will NOT change at runtime.
	*/
	void bw_calcs_init(
	struct bw_calcs_dceip *bw_dceip,
	struct bw_calcs_vbios *bw_vbios,
	struct hw_asic_id asic_id);

	/**
	* Return:
	* true - Display(s) configuration supported.
	* In this case 'calcs_output' contains data for HW programming
	* false - Display(s) configuration not supported (not enough bandwidth).
	*/
	bool bw_calcs(
	struct dc_context *ctx,
	const struct bw_calcs_dceip *dceip,
	const struct bw_calcs_vbios *vbios,
	const struct pipe_ctx *pipe,
	int pipe_count,
	struct dce_bw_output *calcs_output);

	#endif /* __BANDWIDTH_CALCS_H__ */