xref: /openbmc/linux/drivers/gpu/drm/amd/display/dc/inc/hw/dpp.h (revision ae40e94f)
1 /*
2  * Copyright 2012-15 Advanced Micro Devices, Inc.
3  *
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:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
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.
21  *
22  * Authors: AMD
23  *
24  */
25 
26 
27 #ifndef __DAL_DPP_H__
28 #define __DAL_DPP_H__
29 
30 #include "transform.h"
31 
32 struct dpp {
33 	const struct dpp_funcs *funcs;
34 	struct dc_context *ctx;
35 	int inst;
36 	struct dpp_caps *caps;
37 	struct pwl_params regamma_params;
38 	struct pwl_params degamma_params;
39 
40 };
41 
42 struct dpp_input_csc_matrix {
43 	enum dc_color_space color_space;
44 	uint16_t regval[12];
45 };
46 
47 struct dpp_grph_csc_adjustment {
48 	struct fixed31_32 temperature_matrix[CSC_TEMPERATURE_MATRIX_SIZE];
49 	enum graphics_gamut_adjust_type gamut_adjust_type;
50 };
51 
52 struct dcn_dpp_state {
53 	uint32_t is_enabled;
54 	uint32_t igam_lut_mode;
55 	uint32_t igam_input_format;
56 	uint32_t dgam_lut_mode;
57 	uint32_t rgam_lut_mode;
58 	uint32_t gamut_remap_mode;
59 	uint32_t gamut_remap_c11_c12;
60 	uint32_t gamut_remap_c13_c14;
61 	uint32_t gamut_remap_c21_c22;
62 	uint32_t gamut_remap_c23_c24;
63 	uint32_t gamut_remap_c31_c32;
64 	uint32_t gamut_remap_c33_c34;
65 };
66 
67 struct dpp_funcs {
68 	void (*dpp_read_state)(struct dpp *dpp, struct dcn_dpp_state *s);
69 
70 	void (*dpp_reset)(struct dpp *dpp);
71 
72 	void (*dpp_set_scaler)(struct dpp *dpp,
73 			const struct scaler_data *scl_data);
74 
75 	void (*dpp_set_pixel_storage_depth)(
76 			struct dpp *dpp,
77 			enum lb_pixel_depth depth,
78 			const struct bit_depth_reduction_params *bit_depth_params);
79 
80 	bool (*dpp_get_optimal_number_of_taps)(
81 			struct dpp *dpp,
82 			struct scaler_data *scl_data,
83 			const struct scaling_taps *in_taps);
84 
85 	void (*dpp_set_gamut_remap)(
86 			struct dpp *dpp,
87 			const struct dpp_grph_csc_adjustment *adjust);
88 
89 	void (*dpp_set_csc_default)(
90 		struct dpp *dpp,
91 		enum dc_color_space colorspace);
92 
93 	void (*dpp_set_csc_adjustment)(
94 		struct dpp *dpp,
95 		const uint16_t *regval);
96 
97 	void (*dpp_power_on_regamma_lut)(
98 		struct dpp *dpp,
99 		bool power_on);
100 
101 	void (*dpp_program_regamma_lut)(
102 			struct dpp *dpp,
103 			const struct pwl_result_data *rgb,
104 			uint32_t num);
105 
106 	void (*dpp_configure_regamma_lut)(
107 			struct dpp *dpp,
108 			bool is_ram_a);
109 
110 	void (*dpp_program_regamma_lutb_settings)(
111 			struct dpp *dpp,
112 			const struct pwl_params *params);
113 
114 	void (*dpp_program_regamma_luta_settings)(
115 			struct dpp *dpp,
116 			const struct pwl_params *params);
117 
118 	void (*dpp_program_regamma_pwl)(
119 		struct dpp *dpp,
120 		const struct pwl_params *params,
121 		enum opp_regamma mode);
122 
123 	void (*dpp_program_bias_and_scale)(
124 			struct dpp *dpp,
125 			struct dc_bias_and_scale *params);
126 
127 	void (*dpp_set_degamma)(
128 			struct dpp *dpp_base,
129 			enum ipp_degamma_mode mode);
130 
131 	void (*dpp_program_input_lut)(
132 			struct dpp *dpp_base,
133 			const struct dc_gamma *gamma);
134 
135 	void (*dpp_program_degamma_pwl)(struct dpp *dpp_base,
136 									 const struct pwl_params *params);
137 
138 	void (*dpp_setup)(
139 			struct dpp *dpp_base,
140 			enum surface_pixel_format format,
141 			enum expansion_mode mode,
142 			struct dc_csc_transform input_csc_color_matrix,
143 			enum dc_color_space input_color_space);
144 
145 	void (*dpp_full_bypass)(struct dpp *dpp_base);
146 
147 	void (*set_cursor_attributes)(
148 			struct dpp *dpp_base,
149 			enum dc_cursor_color_format color_format);
150 
151 	void (*set_cursor_position)(
152 			struct dpp *dpp_base,
153 			const struct dc_cursor_position *pos,
154 			const struct dc_cursor_mi_param *param,
155 			uint32_t width,
156 			uint32_t height
157 			);
158 	void (*dpp_set_hdr_multiplier)(
159 			struct dpp *dpp_base,
160 			uint32_t multiplier);
161 	void (*set_optional_cursor_attributes)(
162 			struct dpp *dpp_base,
163 			struct dpp_cursor_attributes *attr);
164 
165 	void (*dpp_dppclk_control)(
166 			struct dpp *dpp_base,
167 			bool dppclk_div,
168 			bool enable);
169 
170 };
171 
172 
173 
174 #endif
175