| #ifndef DC_DSC_H_ | |
| #define DC_DSC_H_ | |
| /* | |
| * Copyright 2019 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. | |
| * | |
| * Author: AMD | |
| */ | |
| /* put it here temporarily until linux has the new addresses official defined */ | |
| /* DP Extended DSC Capabilities */ | |
| #define DP_DSC_BRANCH_OVERALL_THROUGHPUT_0 0x0a0 /* DP 1.4a SCR */ | |
| #define DP_DSC_BRANCH_OVERALL_THROUGHPUT_1 0x0a1 | |
| #define DP_DSC_BRANCH_MAX_LINE_WIDTH 0x0a2 | |
| #include "dc_types.h" | |
| struct dc_dsc_bw_range { | |
| uint32_t min_kbps; /* Bandwidth if min_target_bpp_x16 is used */ | |
| uint32_t min_target_bpp_x16; | |
| uint32_t max_kbps; /* Bandwidth if max_target_bpp_x16 is used */ | |
| uint32_t max_target_bpp_x16; | |
| uint32_t stream_kbps; /* Uncompressed stream bandwidth */ | |
| }; | |
| struct display_stream_compressor { | |
| const struct dsc_funcs *funcs; | |
| struct dc_context *ctx; | |
| int inst; | |
| }; | |
| struct dc_dsc_policy { | |
| bool use_min_slices_h; | |
| int max_slices_h; // Maximum available if 0 | |
| int min_slice_height; // Must not be less than 8 | |
| uint32_t max_target_bpp; | |
| uint32_t min_target_bpp; | |
| bool enable_dsc_when_not_needed; | |
| bool ycbcr422_simple; | |
| }; | |
| struct dc_dsc_config_options { | |
| uint32_t dsc_min_slice_height_override; | |
| uint32_t max_target_bpp_limit_override_x16; | |
| uint32_t slice_height_granularity; | |
| uint32_t dsc_force_odm_hslice_override; | |
| bool force_dsc_when_not_needed; | |
| }; | |
| struct dc_dsc_primary_bpp { | |
| uint32_t vic; | |
| uint32_t target_bpp; | |
| }; | |
| bool dc_dsc_parse_dsc_dpcd(const struct dc *dc, | |
| const uint8_t *dpcd_dsc_basic_data, | |
| const uint8_t *dpcd_dsc_ext_data, | |
| struct dsc_dec_dpcd_caps *dsc_sink_caps); | |
| bool dc_dsc_parse_dsc_edid(const struct dc *dc, | |
| const struct dc_edid_caps *edid_caps, | |
| struct dsc_dec_dpcd_caps *dsc_sink_caps); | |
| bool dc_dsc_compute_bandwidth_range( | |
| const struct display_stream_compressor *dsc, | |
| uint32_t dsc_min_slice_height_override, | |
| uint32_t min_bpp_x16, | |
| uint32_t max_bpp_x16, | |
| const struct dsc_dec_dpcd_caps *dsc_sink_caps, | |
| const struct dc_crtc_timing *timing, | |
| const enum dc_link_encoding_format link_encoding, | |
| struct dc_dsc_bw_range *range); | |
| bool dc_dsc_compute_config( | |
| const struct display_stream_compressor *dsc, | |
| const struct dsc_dec_dpcd_caps *dsc_sink_caps, | |
| const struct dc_dsc_config_options *options, | |
| uint32_t target_bandwidth_kbps, | |
| const struct dc_crtc_timing *timing, | |
| const enum dc_link_encoding_format link_encoding, | |
| struct dc_dsc_config *dsc_cfg); | |
| uint32_t dc_dsc_stream_bandwidth_in_kbps(const struct dc_crtc_timing *timing, | |
| uint32_t bpp_x16, uint32_t num_slices_h, bool is_dp); | |
| uint32_t dc_dsc_stream_bandwidth_overhead_in_kbps( | |
| const struct dc_crtc_timing *timing, | |
| const uint32_t num_slices_h, | |
| const bool is_dp); | |
| void dc_dsc_dump_decoder_caps(const struct display_stream_compressor *dsc, | |
| const struct dsc_dec_dpcd_caps *dsc_sink_caps); | |
| void dc_dsc_dump_encoder_caps(const struct display_stream_compressor *dsc, | |
| const struct dc_crtc_timing *timing); | |
| /* TODO - Hardware/specs limitation should be owned by dc dsc and returned to DM, | |
| * and DM can choose to OVERRIDE the limitation on CASE BY CASE basis. | |
| * Hardware/specs limitation should not be writable by DM. | |
| * It should be decoupled from DM specific policy and named differently. | |
| */ | |
| void dc_dsc_get_policy_for_timing(const struct dc_crtc_timing *timing, | |
| uint32_t max_target_bpp_limit_override_x16, | |
| struct dc_dsc_policy *policy, | |
| const enum dc_link_encoding_format link_encoding); | |
| void dc_dsc_policy_set_max_target_bpp_limit(uint32_t limit); | |
| void dc_dsc_policy_set_enable_dsc_when_not_needed(bool enable); | |
| void dc_dsc_policy_set_disable_dsc_stream_overhead(bool disable); | |
| void dc_dsc_get_default_config_option(const struct dc *dc, struct dc_dsc_config_options *options); | |
| #endif |