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 #ifndef __DAL_AUX_ENGINE_DCE110_H__
27 #define __DAL_AUX_ENGINE_DCE110_H__
28 
29 #include "i2caux_interface.h"
30 #include "inc/hw/aux_engine.h"
31 
32 enum aux_return_code_type;
33 
34 #define AUX_COMMON_REG_LIST0(id)\
35 	SRI(AUX_CONTROL, DP_AUX, id), \
36 	SRI(AUX_ARB_CONTROL, DP_AUX, id), \
37 	SRI(AUX_SW_DATA, DP_AUX, id), \
38 	SRI(AUX_SW_CONTROL, DP_AUX, id), \
39 	SRI(AUX_INTERRUPT_CONTROL, DP_AUX, id), \
40 	SRI(AUX_DPHY_RX_CONTROL1, DP_AUX, id), \
41 	SRI(AUX_SW_STATUS, DP_AUX, id)
42 
43 #define AUX_COMMON_REG_LIST(id)\
44 	SRI(AUX_CONTROL, DP_AUX, id), \
45 	SRI(AUX_ARB_CONTROL, DP_AUX, id), \
46 	SRI(AUX_SW_DATA, DP_AUX, id), \
47 	SRI(AUX_SW_CONTROL, DP_AUX, id), \
48 	SRI(AUX_INTERRUPT_CONTROL, DP_AUX, id), \
49 	SRI(AUX_SW_STATUS, DP_AUX, id), \
50 	SR(AUXN_IMPCAL), \
51 	SR(AUXP_IMPCAL)
52 
53 struct dce110_aux_registers {
54 	uint32_t AUX_CONTROL;
55 	uint32_t AUX_ARB_CONTROL;
56 	uint32_t AUX_SW_DATA;
57 	uint32_t AUX_SW_CONTROL;
58 	uint32_t AUX_INTERRUPT_CONTROL;
59 	uint32_t AUX_DPHY_RX_CONTROL1;
60 	uint32_t AUX_SW_STATUS;
61 	uint32_t AUXN_IMPCAL;
62 	uint32_t AUXP_IMPCAL;
63 
64 	uint32_t AUX_RESET_MASK;
65 };
66 
67 #define DCE_AUX_REG_FIELD_LIST(type)\
68 	type AUX_EN;\
69 	type AUX_RESET;\
70 	type AUX_RESET_DONE;\
71 	type AUX_REG_RW_CNTL_STATUS;\
72 	type AUX_SW_USE_AUX_REG_REQ;\
73 	type AUX_SW_DONE_USING_AUX_REG;\
74 	type AUX_SW_AUTOINCREMENT_DISABLE;\
75 	type AUX_SW_DATA_RW;\
76 	type AUX_SW_INDEX;\
77 	type AUX_SW_GO;\
78 	type AUX_SW_DATA;\
79 	type AUX_SW_REPLY_BYTE_COUNT;\
80 	type AUX_SW_DONE;\
81 	type AUX_SW_DONE_ACK;\
82 	type AUXN_IMPCAL_ENABLE;\
83 	type AUXP_IMPCAL_ENABLE;\
84 	type AUXN_IMPCAL_OVERRIDE_ENABLE;\
85 	type AUXP_IMPCAL_OVERRIDE_ENABLE;\
86 	type AUX_RX_TIMEOUT_LEN;\
87 	type AUX_RX_TIMEOUT_LEN_MUL;\
88 	type AUXN_CALOUT_ERROR_AK;\
89 	type AUXP_CALOUT_ERROR_AK;\
90 	type AUX_SW_START_DELAY;\
91 	type AUX_SW_WR_BYTES
92 
93 #define DCE10_AUX_MASK_SH_LIST(mask_sh)\
94 	AUX_SF(AUX_CONTROL, AUX_EN, mask_sh),\
95 	AUX_SF(AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
96 	AUX_SF(AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
97 	AUX_SF(AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
98 	AUX_SF(AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
99 	AUX_SF(AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
100 	AUX_SF(AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
101 	AUX_SF(AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
102 	AUX_SF(AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
103 	AUX_SF(AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
104 	AUX_SF(AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
105 	AUX_SF(AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
106 	AUX_SF(AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
107 	AUX_SF(AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
108 	AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
109 	AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
110 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
111 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
112 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
113 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
114 
115 #define DCE_AUX_MASK_SH_LIST(mask_sh)\
116 	AUX_SF(AUX_CONTROL, AUX_EN, mask_sh),\
117 	AUX_SF(AUX_CONTROL, AUX_RESET, mask_sh),\
118 	AUX_SF(AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
119 	AUX_SF(AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
120 	AUX_SF(AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
121 	AUX_SF(AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
122 	AUX_SF(AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
123 	AUX_SF(AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
124 	AUX_SF(AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
125 	AUX_SF(AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
126 	AUX_SF(AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
127 	AUX_SF(AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
128 	AUX_SF(AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
129 	AUX_SF(AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
130 	AUX_SF(AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
131 	AUX_SF(AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
132 	AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
133 	AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
134 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
135 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
136 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
137 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
138 
139 #define DCE12_AUX_MASK_SH_LIST(mask_sh)\
140 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
141 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
142 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
143 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
144 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
145 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
146 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
147 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
148 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
149 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
150 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
151 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
152 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
153 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
154 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
155 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
156 	AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
157 	AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
158 	AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
159 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
160 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
161 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
162 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
163 
164 /* DCN10 MASK */
165 #define DCN10_AUX_MASK_SH_LIST(mask_sh)\
166 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
167 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
168 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
169 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
170 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
171 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
172 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
173 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
174 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
175 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
176 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
177 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
178 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
179 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
180 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
181 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
182 	AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
183 	AUX_SF(AUXN_IMPCAL, AUXN_CALOUT_ERROR_AK, mask_sh),\
184 	AUX_SF(AUXP_IMPCAL, AUXP_CALOUT_ERROR_AK, mask_sh),\
185 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_ENABLE, mask_sh),\
186 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_ENABLE, mask_sh),\
187 	AUX_SF(AUXP_IMPCAL, AUXP_IMPCAL_OVERRIDE_ENABLE, mask_sh),\
188 	AUX_SF(AUXN_IMPCAL, AUXN_IMPCAL_OVERRIDE_ENABLE, mask_sh)
189 
190 /* for all other DCN */
191 #define DCN_AUX_MASK_SH_LIST(mask_sh)\
192 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_EN, mask_sh),\
193 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET, mask_sh),\
194 	AUX_SF(DP_AUX0_AUX_CONTROL, AUX_RESET_DONE, mask_sh),\
195 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_REG_RW_CNTL_STATUS, mask_sh),\
196 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_USE_AUX_REG_REQ, mask_sh),\
197 	AUX_SF(DP_AUX0_AUX_ARB_CONTROL, AUX_SW_DONE_USING_AUX_REG, mask_sh),\
198 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_START_DELAY, mask_sh),\
199 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_WR_BYTES, mask_sh),\
200 	AUX_SF(DP_AUX0_AUX_SW_CONTROL, AUX_SW_GO, mask_sh),\
201 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
202 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA_RW, mask_sh),\
203 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_AUTOINCREMENT_DISABLE, mask_sh),\
204 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_INDEX, mask_sh),\
205 	AUX_SF(DP_AUX0_AUX_SW_DATA, AUX_SW_DATA, mask_sh),\
206 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_REPLY_BYTE_COUNT, mask_sh),\
207 	AUX_SF(DP_AUX0_AUX_SW_STATUS, AUX_SW_DONE, mask_sh),\
208 	AUX_SF(DP_AUX0_AUX_INTERRUPT_CONTROL, AUX_SW_DONE_ACK, mask_sh),\
209 	AUX_SF(DP_AUX0_AUX_DPHY_RX_CONTROL1, AUX_RX_TIMEOUT_LEN, mask_sh),\
210 	AUX_SF(DP_AUX0_AUX_DPHY_RX_CONTROL1, AUX_RX_TIMEOUT_LEN_MUL, mask_sh)
211 
212 #define AUX_SF(reg_name, field_name, post_fix)\
213 	.field_name = reg_name ## __ ## field_name ## post_fix
214 
215 enum {	/* This is the timeout as defined in DP 1.2a,
216 	 * 2.3.4 "Detailed uPacket TX AUX CH State Description".
217 	 */
218 	AUX_TIMEOUT_PERIOD = 400,
219 
220 	/* Ideally, the SW timeout should be just above 550usec
221 	 * which is programmed in HW.
222 	 * But the SW timeout of 600usec is not reliable,
223 	 * because on some systems, delay_in_microseconds()
224 	 * returns faster than it should.
225 	 * EPR #379763: by trial-and-error on different systems,
226 	 * 700usec is the minimum reliable SW timeout for polling
227 	 * the AUX_SW_STATUS.AUX_SW_DONE bit.
228 	 * This timeout expires *only* when there is
229 	 * AUX Error or AUX Timeout conditions - not during normal operation.
230 	 * During normal operation, AUX_SW_STATUS.AUX_SW_DONE bit is set
231 	 * at most within ~240usec. That means,
232 	 * increasing this timeout will not affect normal operation,
233 	 * and we'll timeout after
234 	 * SW_AUX_TIMEOUT_PERIOD_MULTIPLIER * AUX_TIMEOUT_PERIOD = 2400usec.
235 	 * This timeout is especially important for
236 	 * converters, resume from S3, and CTS.
237 	 */
238 	SW_AUX_TIMEOUT_PERIOD_MULTIPLIER = 6
239 };
240 
241 struct dce_aux {
242 	uint32_t inst;
243 	struct ddc *ddc;
244 	struct dc_context *ctx;
245 	/* following values are expressed in milliseconds */
246 	uint32_t delay;
247 	uint32_t max_defer_write_retry;
248 
249 	bool acquire_reset;
250 	struct dce_aux_funcs *funcs;
251 };
252 
253 struct dce110_aux_registers_mask {
254 	DCE_AUX_REG_FIELD_LIST(uint32_t);
255 };
256 
257 struct dce110_aux_registers_shift {
258 	DCE_AUX_REG_FIELD_LIST(uint8_t);
259 };
260 
261 
262 struct aux_engine_dce110 {
263 	struct dce_aux base;
264 	const struct dce110_aux_registers *regs;
265 	const struct dce110_aux_registers_mask *mask;
266 	const struct dce110_aux_registers_shift *shift;
267 	struct {
268 		uint32_t aux_control;
269 		uint32_t aux_arb_control;
270 		uint32_t aux_sw_data;
271 		uint32_t aux_sw_control;
272 		uint32_t aux_interrupt_control;
273 		uint32_t aux_dphy_rx_control1;
274 		uint32_t aux_dphy_rx_control0;
275 		uint32_t aux_sw_status;
276 	} addr;
277 	uint32_t polling_timeout_period;
278 };
279 
280 struct aux_engine_dce110_init_data {
281 	uint32_t engine_id;
282 	uint32_t timeout_period;
283 	struct dc_context *ctx;
284 	const struct dce110_aux_registers *regs;
285 };
286 
287 struct dce_aux *dce110_aux_engine_construct(struct aux_engine_dce110 *aux_engine110,
288 		struct dc_context *ctx,
289 		uint32_t inst,
290 		uint32_t timeout_period,
291 		const struct dce110_aux_registers *regs,
292 
293 		const struct dce110_aux_registers_mask *mask,
294 		const struct dce110_aux_registers_shift *shift,
295 		bool is_ext_aux_timeout_configurable);
296 
297 void dce110_engine_destroy(struct dce_aux **engine);
298 
299 bool dce110_aux_engine_acquire(
300 	struct dce_aux *aux_engine,
301 	struct ddc *ddc);
302 
303 int dce_aux_transfer_raw(struct ddc_service *ddc,
304 		struct aux_payload *cmd,
305 		enum aux_return_code_type *operation_result);
306 
307 int dce_aux_transfer_dmub_raw(struct ddc_service *ddc,
308 		struct aux_payload *payload,
309 		enum aux_return_code_type *operation_result);
310 bool dce_aux_transfer_with_retries(struct ddc_service *ddc,
311 		struct aux_payload *cmd);
312 
313 struct dce_aux_funcs {
314 	uint32_t (*configure_timeout)
315 		(struct ddc_service *ddc,
316 		 uint32_t timeout);
317 	void (*destroy)
318 		(struct aux_engine **ptr);
319 };
320 
321 #endif
322