xref: /openbmc/linux/drivers/gpu/drm/msm/dp/dp_aux.c (revision 0bf49ffb)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright (c) 2012-2020, The Linux Foundation. All rights reserved.
4  */
5 
6 #include <linux/delay.h>
7 #include <drm/drm_print.h>
8 
9 #include "dp_reg.h"
10 #include "dp_aux.h"
11 
12 #define DP_AUX_ENUM_STR(x)		#x
13 
14 struct dp_aux_private {
15 	struct device *dev;
16 	struct dp_catalog *catalog;
17 
18 	struct mutex mutex;
19 	struct completion comp;
20 
21 	u32 aux_error_num;
22 	u32 retry_cnt;
23 	bool cmd_busy;
24 	bool native;
25 	bool read;
26 	bool no_send_addr;
27 	bool no_send_stop;
28 	u32 offset;
29 	u32 segment;
30 	u32 isr;
31 
32 	struct drm_dp_aux dp_aux;
33 };
34 
35 static const char *dp_aux_get_error(u32 aux_error)
36 {
37 	switch (aux_error) {
38 	case DP_AUX_ERR_NONE:
39 		return DP_AUX_ENUM_STR(DP_AUX_ERR_NONE);
40 	case DP_AUX_ERR_ADDR:
41 		return DP_AUX_ENUM_STR(DP_AUX_ERR_ADDR);
42 	case DP_AUX_ERR_TOUT:
43 		return DP_AUX_ENUM_STR(DP_AUX_ERR_TOUT);
44 	case DP_AUX_ERR_NACK:
45 		return DP_AUX_ENUM_STR(DP_AUX_ERR_NACK);
46 	case DP_AUX_ERR_DEFER:
47 		return DP_AUX_ENUM_STR(DP_AUX_ERR_DEFER);
48 	case DP_AUX_ERR_NACK_DEFER:
49 		return DP_AUX_ENUM_STR(DP_AUX_ERR_NACK_DEFER);
50 	default:
51 		return "unknown";
52 	}
53 }
54 
55 static u32 dp_aux_write(struct dp_aux_private *aux,
56 			struct drm_dp_aux_msg *msg)
57 {
58 	u32 data[4], reg, len;
59 	u8 *msgdata = msg->buffer;
60 	int const AUX_CMD_FIFO_LEN = 128;
61 	int i = 0;
62 
63 	if (aux->read)
64 		len = 4;
65 	else
66 		len = msg->size + 4;
67 
68 	/*
69 	 * cmd fifo only has depth of 144 bytes
70 	 * limit buf length to 128 bytes here
71 	 */
72 	if (len > AUX_CMD_FIFO_LEN) {
73 		DRM_ERROR("buf size greater than allowed size of 128 bytes\n");
74 		return 0;
75 	}
76 
77 	/* Pack cmd and write to HW */
78 	data[0] = (msg->address >> 16) & 0xf; /* addr[19:16] */
79 	if (aux->read)
80 		data[0] |=  BIT(4); /* R/W */
81 
82 	data[1] = (msg->address >> 8) & 0xff;	/* addr[15:8] */
83 	data[2] = msg->address & 0xff;		/* addr[7:0] */
84 	data[3] = (msg->size - 1) & 0xff;	/* len[7:0] */
85 
86 	for (i = 0; i < len; i++) {
87 		reg = (i < 4) ? data[i] : msgdata[i - 4];
88 		/* index = 0, write */
89 		reg = (((reg) << DP_AUX_DATA_OFFSET)
90 		       & DP_AUX_DATA_MASK) | DP_AUX_DATA_WRITE;
91 		if (i == 0)
92 			reg |= DP_AUX_DATA_INDEX_WRITE;
93 		aux->catalog->aux_data = reg;
94 		dp_catalog_aux_write_data(aux->catalog);
95 	}
96 
97 	dp_catalog_aux_clear_trans(aux->catalog, false);
98 	dp_catalog_aux_clear_hw_interrupts(aux->catalog);
99 
100 	reg = 0; /* Transaction number == 1 */
101 	if (!aux->native) { /* i2c */
102 		reg |= DP_AUX_TRANS_CTRL_I2C;
103 
104 		if (aux->no_send_addr)
105 			reg |= DP_AUX_TRANS_CTRL_NO_SEND_ADDR;
106 
107 		if (aux->no_send_stop)
108 			reg |= DP_AUX_TRANS_CTRL_NO_SEND_STOP;
109 	}
110 
111 	reg |= DP_AUX_TRANS_CTRL_GO;
112 	aux->catalog->aux_data = reg;
113 	dp_catalog_aux_write_trans(aux->catalog);
114 
115 	return len;
116 }
117 
118 static int dp_aux_cmd_fifo_tx(struct dp_aux_private *aux,
119 			      struct drm_dp_aux_msg *msg)
120 {
121 	u32 ret, len, timeout;
122 	int aux_timeout_ms = HZ/4;
123 
124 	reinit_completion(&aux->comp);
125 
126 	len = dp_aux_write(aux, msg);
127 	if (len == 0) {
128 		DRM_ERROR("DP AUX write failed\n");
129 		return -EINVAL;
130 	}
131 
132 	timeout = wait_for_completion_timeout(&aux->comp, aux_timeout_ms);
133 	if (!timeout) {
134 		DRM_ERROR("aux %s timeout\n", (aux->read ? "read" : "write"));
135 		return -ETIMEDOUT;
136 	}
137 
138 	if (aux->aux_error_num == DP_AUX_ERR_NONE) {
139 		ret = len;
140 	} else {
141 		DRM_ERROR_RATELIMITED("aux err: %s\n",
142 			dp_aux_get_error(aux->aux_error_num));
143 
144 		ret = -EINVAL;
145 	}
146 
147 	return ret;
148 }
149 
150 static void dp_aux_cmd_fifo_rx(struct dp_aux_private *aux,
151 		struct drm_dp_aux_msg *msg)
152 {
153 	u32 data;
154 	u8 *dp;
155 	u32 i, actual_i;
156 	u32 len = msg->size;
157 
158 	dp_catalog_aux_clear_trans(aux->catalog, true);
159 
160 	data = DP_AUX_DATA_INDEX_WRITE; /* INDEX_WRITE */
161 	data |= DP_AUX_DATA_READ;  /* read */
162 
163 	aux->catalog->aux_data = data;
164 	dp_catalog_aux_write_data(aux->catalog);
165 
166 	dp = msg->buffer;
167 
168 	/* discard first byte */
169 	data = dp_catalog_aux_read_data(aux->catalog);
170 
171 	for (i = 0; i < len; i++) {
172 		data = dp_catalog_aux_read_data(aux->catalog);
173 		*dp++ = (u8)((data >> DP_AUX_DATA_OFFSET) & 0xff);
174 
175 		actual_i = (data >> DP_AUX_DATA_INDEX_OFFSET) & 0xFF;
176 		if (i != actual_i)
177 			DRM_ERROR("Index mismatch: expected %d, found %d\n",
178 				i, actual_i);
179 	}
180 }
181 
182 static void dp_aux_native_handler(struct dp_aux_private *aux)
183 {
184 	u32 isr = aux->isr;
185 
186 	if (isr & DP_INTR_AUX_I2C_DONE)
187 		aux->aux_error_num = DP_AUX_ERR_NONE;
188 	else if (isr & DP_INTR_WRONG_ADDR)
189 		aux->aux_error_num = DP_AUX_ERR_ADDR;
190 	else if (isr & DP_INTR_TIMEOUT)
191 		aux->aux_error_num = DP_AUX_ERR_TOUT;
192 	if (isr & DP_INTR_NACK_DEFER)
193 		aux->aux_error_num = DP_AUX_ERR_NACK;
194 	if (isr & DP_INTR_AUX_ERROR) {
195 		aux->aux_error_num = DP_AUX_ERR_PHY;
196 		dp_catalog_aux_clear_hw_interrupts(aux->catalog);
197 	}
198 
199 	complete(&aux->comp);
200 }
201 
202 static void dp_aux_i2c_handler(struct dp_aux_private *aux)
203 {
204 	u32 isr = aux->isr;
205 
206 	if (isr & DP_INTR_AUX_I2C_DONE) {
207 		if (isr & (DP_INTR_I2C_NACK | DP_INTR_I2C_DEFER))
208 			aux->aux_error_num = DP_AUX_ERR_NACK;
209 		else
210 			aux->aux_error_num = DP_AUX_ERR_NONE;
211 	} else {
212 		if (isr & DP_INTR_WRONG_ADDR)
213 			aux->aux_error_num = DP_AUX_ERR_ADDR;
214 		else if (isr & DP_INTR_TIMEOUT)
215 			aux->aux_error_num = DP_AUX_ERR_TOUT;
216 		if (isr & DP_INTR_NACK_DEFER)
217 			aux->aux_error_num = DP_AUX_ERR_NACK_DEFER;
218 		if (isr & DP_INTR_I2C_NACK)
219 			aux->aux_error_num = DP_AUX_ERR_NACK;
220 		if (isr & DP_INTR_I2C_DEFER)
221 			aux->aux_error_num = DP_AUX_ERR_DEFER;
222 		if (isr & DP_INTR_AUX_ERROR) {
223 			aux->aux_error_num = DP_AUX_ERR_PHY;
224 			dp_catalog_aux_clear_hw_interrupts(aux->catalog);
225 		}
226 	}
227 
228 	complete(&aux->comp);
229 }
230 
231 static void dp_aux_update_offset_and_segment(struct dp_aux_private *aux,
232 					     struct drm_dp_aux_msg *input_msg)
233 {
234 	u32 edid_address = 0x50;
235 	u32 segment_address = 0x30;
236 	bool i2c_read = input_msg->request &
237 		(DP_AUX_I2C_READ & DP_AUX_NATIVE_READ);
238 	u8 *data;
239 
240 	if (aux->native || i2c_read || ((input_msg->address != edid_address) &&
241 		(input_msg->address != segment_address)))
242 		return;
243 
244 
245 	data = input_msg->buffer;
246 	if (input_msg->address == segment_address)
247 		aux->segment = *data;
248 	else
249 		aux->offset = *data;
250 }
251 
252 /**
253  * dp_aux_transfer_helper() - helper function for EDID read transactions
254  *
255  * @aux: DP AUX private structure
256  * @input_msg: input message from DRM upstream APIs
257  * @send_seg: send the segment to sink
258  *
259  * return: void
260  *
261  * This helper function is used to fix EDID reads for non-compliant
262  * sinks that do not handle the i2c middle-of-transaction flag correctly.
263  */
264 static void dp_aux_transfer_helper(struct dp_aux_private *aux,
265 				   struct drm_dp_aux_msg *input_msg,
266 				   bool send_seg)
267 {
268 	struct drm_dp_aux_msg helper_msg;
269 	u32 message_size = 0x10;
270 	u32 segment_address = 0x30;
271 	u32 const edid_block_length = 0x80;
272 	bool i2c_mot = input_msg->request & DP_AUX_I2C_MOT;
273 	bool i2c_read = input_msg->request &
274 		(DP_AUX_I2C_READ & DP_AUX_NATIVE_READ);
275 
276 	if (!i2c_mot || !i2c_read || (input_msg->size == 0))
277 		return;
278 
279 	/*
280 	 * Sending the segment value and EDID offset will be performed
281 	 * from the DRM upstream EDID driver for each block. Avoid
282 	 * duplicate AUX transactions related to this while reading the
283 	 * first 16 bytes of each block.
284 	 */
285 	if (!(aux->offset % edid_block_length) || !send_seg)
286 		goto end;
287 
288 	aux->read = false;
289 	aux->cmd_busy = true;
290 	aux->no_send_addr = true;
291 	aux->no_send_stop = true;
292 
293 	/*
294 	 * Send the segment address for every i2c read in which the
295 	 * middle-of-tranaction flag is set. This is required to support EDID
296 	 * reads of more than 2 blocks as the segment address is reset to 0
297 	 * since we are overriding the middle-of-transaction flag for read
298 	 * transactions.
299 	 */
300 
301 	if (aux->segment) {
302 		memset(&helper_msg, 0, sizeof(helper_msg));
303 		helper_msg.address = segment_address;
304 		helper_msg.buffer = &aux->segment;
305 		helper_msg.size = 1;
306 		dp_aux_cmd_fifo_tx(aux, &helper_msg);
307 	}
308 
309 	/*
310 	 * Send the offset address for every i2c read in which the
311 	 * middle-of-transaction flag is set. This will ensure that the sink
312 	 * will update its read pointer and return the correct portion of the
313 	 * EDID buffer in the subsequent i2c read trasntion triggered in the
314 	 * native AUX transfer function.
315 	 */
316 	memset(&helper_msg, 0, sizeof(helper_msg));
317 	helper_msg.address = input_msg->address;
318 	helper_msg.buffer = &aux->offset;
319 	helper_msg.size = 1;
320 	dp_aux_cmd_fifo_tx(aux, &helper_msg);
321 
322 end:
323 	aux->offset += message_size;
324 	if (aux->offset == 0x80 || aux->offset == 0x100)
325 		aux->segment = 0x0; /* reset segment at end of block */
326 }
327 
328 /*
329  * This function does the real job to process an AUX transaction.
330  * It will call aux_reset() function to reset the AUX channel,
331  * if the waiting is timeout.
332  */
333 static ssize_t dp_aux_transfer(struct drm_dp_aux *dp_aux,
334 			       struct drm_dp_aux_msg *msg)
335 {
336 	ssize_t ret;
337 	int const aux_cmd_native_max = 16;
338 	int const aux_cmd_i2c_max = 128;
339 	struct dp_aux_private *aux = container_of(dp_aux,
340 		struct dp_aux_private, dp_aux);
341 
342 	mutex_lock(&aux->mutex);
343 
344 	aux->native = msg->request & (DP_AUX_NATIVE_WRITE & DP_AUX_NATIVE_READ);
345 
346 	/* Ignore address only message */
347 	if ((msg->size == 0) || (msg->buffer == NULL)) {
348 		msg->reply = aux->native ?
349 			DP_AUX_NATIVE_REPLY_ACK : DP_AUX_I2C_REPLY_ACK;
350 		ret = msg->size;
351 		goto unlock_exit;
352 	}
353 
354 	/* msg sanity check */
355 	if ((aux->native && (msg->size > aux_cmd_native_max)) ||
356 		(msg->size > aux_cmd_i2c_max)) {
357 		DRM_ERROR("%s: invalid msg: size(%zu), request(%x)\n",
358 			__func__, msg->size, msg->request);
359 		ret = -EINVAL;
360 		goto unlock_exit;
361 	}
362 
363 	dp_aux_update_offset_and_segment(aux, msg);
364 	dp_aux_transfer_helper(aux, msg, true);
365 
366 	aux->read = msg->request & (DP_AUX_I2C_READ & DP_AUX_NATIVE_READ);
367 	aux->cmd_busy = true;
368 
369 	if (aux->read) {
370 		aux->no_send_addr = true;
371 		aux->no_send_stop = false;
372 	} else {
373 		aux->no_send_addr = true;
374 		aux->no_send_stop = true;
375 	}
376 
377 	ret = dp_aux_cmd_fifo_tx(aux, msg);
378 
379 	if (ret < 0) {
380 		usleep_range(400, 500); /* at least 400us to next try */
381 		goto unlock_exit;
382 	}
383 
384 	if (aux->aux_error_num == DP_AUX_ERR_NONE) {
385 		if (aux->read)
386 			dp_aux_cmd_fifo_rx(aux, msg);
387 
388 		msg->reply = aux->native ?
389 			DP_AUX_NATIVE_REPLY_ACK : DP_AUX_I2C_REPLY_ACK;
390 	} else {
391 		/* Reply defer to retry */
392 		msg->reply = aux->native ?
393 			DP_AUX_NATIVE_REPLY_DEFER : DP_AUX_I2C_REPLY_DEFER;
394 	}
395 
396 	/* Return requested size for success or retry */
397 	ret = msg->size;
398 	aux->retry_cnt = 0;
399 
400 unlock_exit:
401 	aux->cmd_busy = false;
402 	mutex_unlock(&aux->mutex);
403 	return ret;
404 }
405 
406 void dp_aux_isr(struct drm_dp_aux *dp_aux)
407 {
408 	struct dp_aux_private *aux;
409 
410 	if (!dp_aux) {
411 		DRM_ERROR("invalid input\n");
412 		return;
413 	}
414 
415 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
416 
417 	aux->isr = dp_catalog_aux_get_irq(aux->catalog);
418 
419 	if (!aux->cmd_busy)
420 		return;
421 
422 	if (aux->native)
423 		dp_aux_native_handler(aux);
424 	else
425 		dp_aux_i2c_handler(aux);
426 }
427 
428 void dp_aux_reconfig(struct drm_dp_aux *dp_aux)
429 {
430 	struct dp_aux_private *aux;
431 
432 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
433 
434 	dp_catalog_aux_update_cfg(aux->catalog);
435 	dp_catalog_aux_reset(aux->catalog);
436 }
437 
438 void dp_aux_init(struct drm_dp_aux *dp_aux)
439 {
440 	struct dp_aux_private *aux;
441 
442 	if (!dp_aux) {
443 		DRM_ERROR("invalid input\n");
444 		return;
445 	}
446 
447 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
448 
449 	dp_catalog_aux_enable(aux->catalog, true);
450 	aux->retry_cnt = 0;
451 }
452 
453 void dp_aux_deinit(struct drm_dp_aux *dp_aux)
454 {
455 	struct dp_aux_private *aux;
456 
457 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
458 
459 	dp_catalog_aux_enable(aux->catalog, false);
460 }
461 
462 int dp_aux_register(struct drm_dp_aux *dp_aux)
463 {
464 	struct dp_aux_private *aux;
465 	int ret;
466 
467 	if (!dp_aux) {
468 		DRM_ERROR("invalid input\n");
469 		return -EINVAL;
470 	}
471 
472 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
473 
474 	aux->dp_aux.name = "dpu_dp_aux";
475 	aux->dp_aux.dev = aux->dev;
476 	aux->dp_aux.transfer = dp_aux_transfer;
477 	ret = drm_dp_aux_register(&aux->dp_aux);
478 	if (ret) {
479 		DRM_ERROR("%s: failed to register drm aux: %d\n", __func__,
480 				ret);
481 		return ret;
482 	}
483 
484 	return 0;
485 }
486 
487 void dp_aux_unregister(struct drm_dp_aux *dp_aux)
488 {
489 	drm_dp_aux_unregister(dp_aux);
490 }
491 
492 struct drm_dp_aux *dp_aux_get(struct device *dev, struct dp_catalog *catalog)
493 {
494 	struct dp_aux_private *aux;
495 
496 	if (!catalog) {
497 		DRM_ERROR("invalid input\n");
498 		return ERR_PTR(-ENODEV);
499 	}
500 
501 	aux = devm_kzalloc(dev, sizeof(*aux), GFP_KERNEL);
502 	if (!aux)
503 		return ERR_PTR(-ENOMEM);
504 
505 	init_completion(&aux->comp);
506 	aux->cmd_busy = false;
507 	mutex_init(&aux->mutex);
508 
509 	aux->dev = dev;
510 	aux->catalog = catalog;
511 	aux->retry_cnt = 0;
512 
513 	return &aux->dp_aux;
514 }
515 
516 void dp_aux_put(struct drm_dp_aux *dp_aux)
517 {
518 	struct dp_aux_private *aux;
519 
520 	if (!dp_aux)
521 		return;
522 
523 	aux = container_of(dp_aux, struct dp_aux_private, dp_aux);
524 
525 	mutex_destroy(&aux->mutex);
526 
527 	devm_kfree(aux->dev, aux);
528 }
529