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