xref: /linux/drivers/gpu/drm/amd/display/dc/inc/hw/hw_shared.h (revision 06ed6aa56ffac9241e03a24649e8d048f8f1b10c)
1 /*
2  * Copyright 2015 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 #ifndef __DAL_HW_SHARED_H__
27 #define __DAL_HW_SHARED_H__
28 
29 #include "os_types.h"
30 #include "fixed31_32.h"
31 #include "dc_hw_types.h"
32 
33 /******************************************************************************
34  * Data types shared between different Virtual HW blocks
35  ******************************************************************************/
36 
37 #define MAX_AUDIOS 7
38 #define MAX_PIPES 6
39 #define MAX_DWB_PIPES	1
40 
41 struct gamma_curve {
42 	uint32_t offset;
43 	uint32_t segments_num;
44 };
45 
46 struct curve_points {
47 	struct fixed31_32 x;
48 	struct fixed31_32 y;
49 	struct fixed31_32 offset;
50 	struct fixed31_32 slope;
51 
52 	uint32_t custom_float_x;
53 	uint32_t custom_float_y;
54 	uint32_t custom_float_offset;
55 	uint32_t custom_float_slope;
56 };
57 
58 struct curve_points3 {
59 	struct curve_points red;
60 	struct curve_points green;
61 	struct curve_points blue;
62 };
63 
64 struct pwl_result_data {
65 	struct fixed31_32 red;
66 	struct fixed31_32 green;
67 	struct fixed31_32 blue;
68 
69 	struct fixed31_32 delta_red;
70 	struct fixed31_32 delta_green;
71 	struct fixed31_32 delta_blue;
72 
73 	uint32_t red_reg;
74 	uint32_t green_reg;
75 	uint32_t blue_reg;
76 
77 	uint32_t delta_red_reg;
78 	uint32_t delta_green_reg;
79 	uint32_t delta_blue_reg;
80 };
81 
82 struct dc_rgb {
83 	uint32_t red;
84 	uint32_t green;
85 	uint32_t blue;
86 };
87 
88 struct tetrahedral_17x17x17 {
89 	struct dc_rgb lut0[1229];
90 	struct dc_rgb lut1[1228];
91 	struct dc_rgb lut2[1228];
92 	struct dc_rgb lut3[1228];
93 };
94 struct tetrahedral_9x9x9 {
95 	struct dc_rgb lut0[183];
96 	struct dc_rgb lut1[182];
97 	struct dc_rgb lut2[182];
98 	struct dc_rgb lut3[182];
99 };
100 
101 struct tetrahedral_params {
102 	union {
103 		struct tetrahedral_17x17x17 tetrahedral_17;
104 		struct tetrahedral_9x9x9 tetrahedral_9;
105 	};
106 	bool use_tetrahedral_9;
107 	bool use_12bits;
108 
109 };
110 
111 /* arr_curve_points - regamma regions/segments specification
112  * arr_points - beginning and end point specified separately (only one on DCE)
113  * corner_points - beginning and end point for all 3 colors (DCN)
114  * rgb_resulted - final curve
115  */
116 struct pwl_params {
117 	struct gamma_curve arr_curve_points[34];
118 	union {
119 		struct curve_points arr_points[2];
120 		struct curve_points3 corner_points[2];
121 	};
122 	struct pwl_result_data rgb_resulted[256 + 3];
123 	uint32_t hw_points_num;
124 };
125 
126 /* move to dpp
127  * while we are moving functionality out of opp to dpp to align
128  * HW programming to HW IP, we define these struct in hw_shared
129  * so we can still compile while refactoring
130  */
131 
132 enum lb_pixel_depth {
133 	/* do not change the values because it is used as bit vector */
134 	LB_PIXEL_DEPTH_18BPP = 1,
135 	LB_PIXEL_DEPTH_24BPP = 2,
136 	LB_PIXEL_DEPTH_30BPP = 4,
137 	LB_PIXEL_DEPTH_36BPP = 8
138 };
139 
140 enum graphics_csc_adjust_type {
141 	GRAPHICS_CSC_ADJUST_TYPE_BYPASS = 0,
142 	GRAPHICS_CSC_ADJUST_TYPE_HW, /* without adjustments */
143 	GRAPHICS_CSC_ADJUST_TYPE_SW  /*use adjustments */
144 };
145 
146 enum ipp_degamma_mode {
147 	IPP_DEGAMMA_MODE_BYPASS,
148 	IPP_DEGAMMA_MODE_HW_sRGB,
149 	IPP_DEGAMMA_MODE_HW_xvYCC,
150 	IPP_DEGAMMA_MODE_USER_PWL
151 };
152 
153 enum ipp_output_format {
154 	IPP_OUTPUT_FORMAT_12_BIT_FIX,
155 	IPP_OUTPUT_FORMAT_16_BIT_BYPASS,
156 	IPP_OUTPUT_FORMAT_FLOAT
157 };
158 
159 enum expansion_mode {
160 	EXPANSION_MODE_DYNAMIC,
161 	EXPANSION_MODE_ZERO
162 };
163 
164 struct default_adjustment {
165 	enum lb_pixel_depth lb_color_depth;
166 	enum dc_color_space out_color_space;
167 	enum dc_color_space in_color_space;
168 	enum dc_color_depth color_depth;
169 	enum pixel_format surface_pixel_format;
170 	enum graphics_csc_adjust_type csc_adjust_type;
171 	bool force_hw_default;
172 };
173 
174 
175 struct out_csc_color_matrix {
176 	enum dc_color_space color_space;
177 	uint16_t regval[12];
178 };
179 
180 enum gamut_remap_select {
181 	GAMUT_REMAP_BYPASS = 0,
182 	GAMUT_REMAP_COEFF,
183 	GAMUT_REMAP_COMA_COEFF,
184 	GAMUT_REMAP_COMB_COEFF
185 };
186 
187 enum opp_regamma {
188 	OPP_REGAMMA_BYPASS = 0,
189 	OPP_REGAMMA_SRGB,
190 	OPP_REGAMMA_XVYCC,
191 	OPP_REGAMMA_USER
192 };
193 
194 enum optc_dsc_mode {
195 	OPTC_DSC_DISABLED = 0,
196 	OPTC_DSC_ENABLED_444 = 1, /* 'RGB 444' or 'Simple YCbCr 4:2:2' (4:2:2 upsampled to 4:4:4) */
197 	OPTC_DSC_ENABLED_NATIVE_SUBSAMPLED = 2 /* Native 4:2:2 or 4:2:0 */
198 };
199 
200 struct dc_bias_and_scale {
201 	uint16_t scale_red;
202 	uint16_t bias_red;
203 	uint16_t scale_green;
204 	uint16_t bias_green;
205 	uint16_t scale_blue;
206 	uint16_t bias_blue;
207 };
208 
209 enum test_pattern_dyn_range {
210 	TEST_PATTERN_DYN_RANGE_VESA = 0,
211 	TEST_PATTERN_DYN_RANGE_CEA
212 };
213 
214 enum test_pattern_mode {
215 	TEST_PATTERN_MODE_COLORSQUARES_RGB = 0,
216 	TEST_PATTERN_MODE_COLORSQUARES_YCBCR601,
217 	TEST_PATTERN_MODE_COLORSQUARES_YCBCR709,
218 	TEST_PATTERN_MODE_VERTICALBARS,
219 	TEST_PATTERN_MODE_HORIZONTALBARS,
220 	TEST_PATTERN_MODE_SINGLERAMP_RGB,
221 	TEST_PATTERN_MODE_DUALRAMP_RGB,
222 	TEST_PATTERN_MODE_XR_BIAS_RGB
223 };
224 
225 enum test_pattern_color_format {
226 	TEST_PATTERN_COLOR_FORMAT_BPC_6 = 0,
227 	TEST_PATTERN_COLOR_FORMAT_BPC_8,
228 	TEST_PATTERN_COLOR_FORMAT_BPC_10,
229 	TEST_PATTERN_COLOR_FORMAT_BPC_12
230 };
231 
232 enum controller_dp_test_pattern {
233 	CONTROLLER_DP_TEST_PATTERN_D102 = 0,
234 	CONTROLLER_DP_TEST_PATTERN_SYMBOLERROR,
235 	CONTROLLER_DP_TEST_PATTERN_PRBS7,
236 	CONTROLLER_DP_TEST_PATTERN_COLORSQUARES,
237 	CONTROLLER_DP_TEST_PATTERN_VERTICALBARS,
238 	CONTROLLER_DP_TEST_PATTERN_HORIZONTALBARS,
239 	CONTROLLER_DP_TEST_PATTERN_COLORRAMP,
240 	CONTROLLER_DP_TEST_PATTERN_VIDEOMODE,
241 	CONTROLLER_DP_TEST_PATTERN_RESERVED_8,
242 	CONTROLLER_DP_TEST_PATTERN_RESERVED_9,
243 	CONTROLLER_DP_TEST_PATTERN_RESERVED_A,
244 	CONTROLLER_DP_TEST_PATTERN_COLORSQUARES_CEA,
245 	CONTROLLER_DP_TEST_PATTERN_SOLID_COLOR
246 };
247 
248 enum controller_dp_color_space {
249 	CONTROLLER_DP_COLOR_SPACE_RGB,
250 	CONTROLLER_DP_COLOR_SPACE_YCBCR601,
251 	CONTROLLER_DP_COLOR_SPACE_YCBCR709,
252 	CONTROLLER_DP_COLOR_SPACE_UDEFINED
253 };
254 
255 enum dc_lut_mode {
256 	LUT_BYPASS,
257 	LUT_RAM_A,
258 	LUT_RAM_B
259 };
260 #endif /* __DAL_HW_SHARED_H__ */
261