Linux Audio

Check our new training course

Loading...
  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