1#ifndef DC_DSC_H_
  2#define DC_DSC_H_
  3/*
  4 * Copyright 2019 Advanced Micro Devices, Inc.
  5 *
  6 * Permission is hereby granted, free of charge, to any person obtaining a
  7 * copy of this software and associated documentation files (the "Software"),
  8 * to deal in the Software without restriction, including without limitation
  9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 10 * and/or sell copies of the Software, and to permit persons to whom the
 11 * Software is furnished to do so, subject to the following conditions:
 12 *
 13 * The above copyright notice and this permission notice shall be included in
 14 * all copies or substantial portions of the Software.
 15 *
 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 19 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 22 * OTHER DEALINGS IN THE SOFTWARE.
 23 *
 24 * Author: AMD
 25 */
 26
 27/* put it here temporarily until linux has the new addresses official defined */
 28/* DP Extended DSC Capabilities */
 29#define DP_DSC_BRANCH_OVERALL_THROUGHPUT_0  0x0a0   /* DP 1.4a SCR */
 30#define DP_DSC_BRANCH_OVERALL_THROUGHPUT_1  0x0a1
 31#define DP_DSC_BRANCH_MAX_LINE_WIDTH        0x0a2
 32#include "dc_types.h"
 33
 34struct dc_dsc_bw_range {
 35	uint32_t min_kbps; /* Bandwidth if min_target_bpp_x16 is used */
 36	uint32_t min_target_bpp_x16;
 37	uint32_t max_kbps; /* Bandwidth if max_target_bpp_x16 is used */
 38	uint32_t max_target_bpp_x16;
 39	uint32_t stream_kbps; /* Uncompressed stream bandwidth */
 40};
 41
 42struct display_stream_compressor {
 43	const struct dsc_funcs *funcs;
 44	struct dc_context *ctx;
 45	int inst;
 46};
 47
 48struct dc_dsc_policy {
 49	bool use_min_slices_h;
 50	int max_slices_h; // Maximum available if 0
 51	int min_slice_height; // Must not be less than 8
 52	uint32_t max_target_bpp;
 53	uint32_t min_target_bpp;
 54	bool enable_dsc_when_not_needed;
 55};
 56
 57struct dc_dsc_config_options {
 58	uint32_t dsc_min_slice_height_override;
 59	uint32_t max_target_bpp_limit_override_x16;
 60	uint32_t slice_height_granularity;
 61	uint32_t dsc_force_odm_hslice_override;
 62};
 63
 64bool dc_dsc_parse_dsc_dpcd(const struct dc *dc,
 65		const uint8_t *dpcd_dsc_basic_data,
 66		const uint8_t *dpcd_dsc_ext_data,
 67		struct dsc_dec_dpcd_caps *dsc_sink_caps);
 68
 69bool dc_dsc_compute_bandwidth_range(
 70		const struct display_stream_compressor *dsc,
 71		uint32_t dsc_min_slice_height_override,
 72		uint32_t min_bpp_x16,
 73		uint32_t max_bpp_x16,
 74		const struct dsc_dec_dpcd_caps *dsc_sink_caps,
 75		const struct dc_crtc_timing *timing,
 76		const enum dc_link_encoding_format link_encoding,
 77		struct dc_dsc_bw_range *range);
 78
 79bool dc_dsc_compute_config(
 80		const struct display_stream_compressor *dsc,
 81		const struct dsc_dec_dpcd_caps *dsc_sink_caps,
 82		const struct dc_dsc_config_options *options,
 83		uint32_t target_bandwidth_kbps,
 84		const struct dc_crtc_timing *timing,
 85		const enum dc_link_encoding_format link_encoding,
 86		struct dc_dsc_config *dsc_cfg);
 87
 88uint32_t dc_dsc_stream_bandwidth_in_kbps(const struct dc_crtc_timing *timing,
 89		uint32_t bpp_x16, uint32_t num_slices_h, bool is_dp);
 90
 91uint32_t dc_dsc_stream_bandwidth_overhead_in_kbps(
 92		const struct dc_crtc_timing *timing,
 93		const int num_slices_h,
 94		const bool is_dp);
 95
 96/* TODO - Hardware/specs limitation should be owned by dc dsc and returned to DM,
 97 * and DM can choose to OVERRIDE the limitation on CASE BY CASE basis.
 98 * Hardware/specs limitation should not be writable by DM.
 99 * It should be decoupled from DM specific policy and named differently.
100 */
101void dc_dsc_get_policy_for_timing(const struct dc_crtc_timing *timing,
102		uint32_t max_target_bpp_limit_override_x16,
103		struct dc_dsc_policy *policy);
104
105void dc_dsc_policy_set_max_target_bpp_limit(uint32_t limit);
106
107void dc_dsc_policy_set_enable_dsc_when_not_needed(bool enable);
108
109void dc_dsc_policy_set_disable_dsc_stream_overhead(bool disable);
110
111void dc_dsc_get_default_config_option(const struct dc *dc, struct dc_dsc_config_options *options);
112
113#endif