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 "gpio_service_interface.h"
30#include "inc/hw/aux_engine.h"
31
32enum 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
53struct 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
215enum {	/* 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
241struct 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
253struct dce110_aux_registers_mask {
254	DCE_AUX_REG_FIELD_LIST(uint32_t);
255};
256
257struct dce110_aux_registers_shift {
258	DCE_AUX_REG_FIELD_LIST(uint8_t);
259};
260
261
262struct 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
280struct 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
287struct 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
297void dce110_engine_destroy(struct dce_aux **engine);
298
299bool dce110_aux_engine_acquire(
300	struct dce_aux *aux_engine,
301	struct ddc *ddc);
302
303int dce_aux_transfer_raw(struct ddc_service *ddc,
304		struct aux_payload *cmd,
305		enum aux_return_code_type *operation_result);
306
307int dce_aux_transfer_dmub_raw(struct ddc_service *ddc,
308		struct aux_payload *payload,
309		enum aux_return_code_type *operation_result);
310bool dce_aux_transfer_with_retries(struct ddc_service *ddc,
311		struct aux_payload *cmd);
312
313struct 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