1 // SPDX-License-Identifier: BSD-3-Clause
3 * Copyright (c) 2020, MIPI Alliance, Inc.
5 * Author: Nicolas Pitre <npitre@baylibre.com>
7 * Note: The I3C HCI v2.0 spec is still in flux. The IBI support is based on
8 * v1.x of the spec and v2.0 will likely be split out.
11 #include <linux/bitfield.h>
12 #include <linux/device.h>
13 #include <linux/dma-mapping.h>
14 #include <linux/errno.h>
15 #include <linux/i3c/master.h>
24 * Software Parameter Values (somewhat arb itrary for now).
25 * Some of them could be determined at run time eventually.
28 #define XFER_RINGS 1 /* max: 8 */
29 #define XFER_RING_ENTRIES 16 /* max: 255 */
31 #define IBI_RINGS 1 /* max: 8 */
32 #define IBI_STATUS_RING_ENTRIES 32 /* max: 255 */
33 #define IBI_CHUNK_CACHELINES 1 /* max: 256 bytes equivalent */
34 #define IBI_CHUNK_POOL_SIZE 128 /* max: 1023 */
37 * Ring Header Preamble
40 #define rhs_reg_read(r) readl(hci->RHS_regs + (RHS_##r))
41 #define rhs_reg_write(r, v) writel(v, hci->RHS_regs + (RHS_##r))
43 #define RHS_CONTROL 0x00
44 #define PREAMBLE_SIZE GENMASK(31, 24) /* Preamble Section Size */
45 #define HEADER_SIZE GENMASK(23, 16) /* Ring Header Size */
46 #define MAX_HEADER_COUNT_CAP GENMASK(7, 4) /* HC Max Header Count */
47 #define MAX_HEADER_COUNT GENMASK(3, 0) /* Driver Max Header Count */
49 #define RHS_RHn_OFFSET(n) (0x04 + (n)*4)
52 * Ring Header (Per-Ring Bundle)
55 #define rh_reg_read(r) readl(rh->regs + (RH_##r))
56 #define rh_reg_write(r, v) writel(v, rh->regs + (RH_##r))
58 #define RH_CR_SETUP 0x00 /* Command/Response Ring */
59 #define CR_XFER_STRUCT_SIZE GENMASK(31, 24)
60 #define CR_RESP_STRUCT_SIZE GENMASK(23, 16)
61 #define CR_RING_SIZE GENMASK(8, 0)
63 #define RH_IBI_SETUP 0x04
64 #define IBI_STATUS_STRUCT_SIZE GENMASK(31, 24)
65 #define IBI_STATUS_RING_SIZE GENMASK(23, 16)
66 #define IBI_DATA_CHUNK_SIZE GENMASK(12, 10)
67 #define IBI_DATA_CHUNK_COUNT GENMASK(9, 0)
69 #define RH_CHUNK_CONTROL 0x08
71 #define RH_INTR_STATUS 0x10
72 #define RH_INTR_STATUS_ENABLE 0x14
73 #define RH_INTR_SIGNAL_ENABLE 0x18
74 #define RH_INTR_FORCE 0x1c
75 #define INTR_IBI_READY BIT(12)
76 #define INTR_TRANSFER_COMPLETION BIT(11)
77 #define INTR_RING_OP BIT(10)
78 #define INTR_TRANSFER_ERR BIT(9)
79 #define INTR_WARN_INS_STOP_MODE BIT(7)
80 #define INTR_IBI_RING_FULL BIT(6)
81 #define INTR_TRANSFER_ABORT BIT(5)
83 #define RH_RING_STATUS 0x20
84 #define RING_STATUS_LOCKED BIT(3)
85 #define RING_STATUS_ABORTED BIT(2)
86 #define RING_STATUS_RUNNING BIT(1)
87 #define RING_STATUS_ENABLED BIT(0)
89 #define RH_RING_CONTROL 0x24
90 #define RING_CTRL_ABORT BIT(2)
91 #define RING_CTRL_RUN_STOP BIT(1)
92 #define RING_CTRL_ENABLE BIT(0)
94 #define RH_RING_OPERATION1 0x28
95 #define RING_OP1_IBI_DEQ_PTR GENMASK(23, 16)
96 #define RING_OP1_CR_SW_DEQ_PTR GENMASK(15, 8)
97 #define RING_OP1_CR_ENQ_PTR GENMASK(7, 0)
99 #define RH_RING_OPERATION2 0x2c
100 #define RING_OP2_IBI_ENQ_PTR GENMASK(23, 16)
101 #define RING_OP2_CR_DEQ_PTR GENMASK(7, 0)
103 #define RH_CMD_RING_BASE_LO 0x30
104 #define RH_CMD_RING_BASE_HI 0x34
105 #define RH_RESP_RING_BASE_LO 0x38
106 #define RH_RESP_RING_BASE_HI 0x3c
107 #define RH_IBI_STATUS_RING_BASE_LO 0x40
108 #define RH_IBI_STATUS_RING_BASE_HI 0x44
109 #define RH_IBI_DATA_RING_BASE_LO 0x48
110 #define RH_IBI_DATA_RING_BASE_HI 0x4c
112 #define RH_CMD_RING_SG 0x50 /* Ring Scatter Gather Support */
113 #define RH_RESP_RING_SG 0x54
114 #define RH_IBI_STATUS_RING_SG 0x58
115 #define RH_IBI_DATA_RING_SG 0x5c
116 #define RING_SG_BLP BIT(31) /* Buffer Vs. List Pointer */
117 #define RING_SG_LIST_SIZE GENMASK(15, 0)
120 * Data Buffer Descriptor (in memory)
123 #define DATA_BUF_BLP BIT(31) /* Buffer Vs. List Pointer */
124 #define DATA_BUF_IOC BIT(30) /* Interrupt on Completion */
125 #define DATA_BUF_BLOCK_SIZE GENMASK(15, 0)
130 void *xfer, *resp, *ibi_status, *ibi_data;
131 dma_addr_t xfer_dma, resp_dma, ibi_status_dma, ibi_data_dma;
132 unsigned int xfer_entries, ibi_status_entries, ibi_chunks_total;
133 unsigned int xfer_struct_sz, resp_struct_sz, ibi_status_sz, ibi_chunk_sz;
134 unsigned int done_ptr, ibi_chunk_ptr;
135 struct hci_xfer **src_xfers;
137 struct completion op_done;
140 struct hci_rings_data {
142 struct hci_rh_data headers[] __counted_by(total);
145 struct hci_dma_dev_ibi_data {
146 struct i3c_generic_ibi_pool *pool;
147 unsigned int max_len;
150 static inline u32 lo32(dma_addr_t physaddr)
155 static inline u32 hi32(dma_addr_t physaddr)
157 /* trickery to avoid compiler warnings on 32-bit build targets */
158 if (sizeof(dma_addr_t) > 4) {
165 static void hci_dma_cleanup(struct i3c_hci *hci)
167 struct hci_rings_data *rings = hci->io_data;
168 struct hci_rh_data *rh;
174 for (i = 0; i < rings->total; i++) {
175 rh = &rings->headers[i];
177 rh_reg_write(RING_CONTROL, 0);
178 rh_reg_write(CR_SETUP, 0);
179 rh_reg_write(IBI_SETUP, 0);
180 rh_reg_write(INTR_SIGNAL_ENABLE, 0);
183 dma_free_coherent(&hci->master.dev,
184 rh->xfer_struct_sz * rh->xfer_entries,
185 rh->xfer, rh->xfer_dma);
187 dma_free_coherent(&hci->master.dev,
188 rh->resp_struct_sz * rh->xfer_entries,
189 rh->resp, rh->resp_dma);
190 kfree(rh->src_xfers);
192 dma_free_coherent(&hci->master.dev,
193 rh->ibi_status_sz * rh->ibi_status_entries,
194 rh->ibi_status, rh->ibi_status_dma);
195 if (rh->ibi_data_dma)
196 dma_unmap_single(&hci->master.dev, rh->ibi_data_dma,
197 rh->ibi_chunk_sz * rh->ibi_chunks_total,
202 rhs_reg_write(CONTROL, 0);
208 static int hci_dma_init(struct i3c_hci *hci)
210 struct hci_rings_data *rings;
211 struct hci_rh_data *rh;
213 unsigned int i, nr_rings, xfers_sz, resps_sz;
214 unsigned int ibi_status_ring_sz, ibi_data_ring_sz;
217 regval = rhs_reg_read(CONTROL);
218 nr_rings = FIELD_GET(MAX_HEADER_COUNT_CAP, regval);
219 dev_info(&hci->master.dev, "%d DMA rings available\n", nr_rings);
220 if (unlikely(nr_rings > 8)) {
221 dev_err(&hci->master.dev, "number of rings should be <= 8\n");
224 if (nr_rings > XFER_RINGS)
225 nr_rings = XFER_RINGS;
226 rings = kzalloc(struct_size(rings, headers, nr_rings), GFP_KERNEL);
229 hci->io_data = rings;
230 rings->total = nr_rings;
232 regval = FIELD_PREP(MAX_HEADER_COUNT, rings->total);
233 rhs_reg_write(CONTROL, regval);
235 for (i = 0; i < rings->total; i++) {
236 u32 offset = rhs_reg_read(RHn_OFFSET(i));
238 dev_info(&hci->master.dev, "Ring %d at offset %#x\n", i, offset);
242 rh = &rings->headers[i];
243 rh->regs = hci->base_regs + offset;
244 spin_lock_init(&rh->lock);
245 init_completion(&rh->op_done);
247 rh->xfer_entries = XFER_RING_ENTRIES;
249 regval = rh_reg_read(CR_SETUP);
250 rh->xfer_struct_sz = FIELD_GET(CR_XFER_STRUCT_SIZE, regval);
251 rh->resp_struct_sz = FIELD_GET(CR_RESP_STRUCT_SIZE, regval);
252 DBG("xfer_struct_sz = %d, resp_struct_sz = %d",
253 rh->xfer_struct_sz, rh->resp_struct_sz);
254 xfers_sz = rh->xfer_struct_sz * rh->xfer_entries;
255 resps_sz = rh->resp_struct_sz * rh->xfer_entries;
257 rh->xfer = dma_alloc_coherent(&hci->master.dev, xfers_sz,
258 &rh->xfer_dma, GFP_KERNEL);
259 rh->resp = dma_alloc_coherent(&hci->master.dev, resps_sz,
260 &rh->resp_dma, GFP_KERNEL);
262 kmalloc_array(rh->xfer_entries, sizeof(*rh->src_xfers),
265 if (!rh->xfer || !rh->resp || !rh->src_xfers)
268 rh_reg_write(CMD_RING_BASE_LO, lo32(rh->xfer_dma));
269 rh_reg_write(CMD_RING_BASE_HI, hi32(rh->xfer_dma));
270 rh_reg_write(RESP_RING_BASE_LO, lo32(rh->resp_dma));
271 rh_reg_write(RESP_RING_BASE_HI, hi32(rh->resp_dma));
273 regval = FIELD_PREP(CR_RING_SIZE, rh->xfer_entries);
274 rh_reg_write(CR_SETUP, regval);
276 rh_reg_write(INTR_STATUS_ENABLE, 0xffffffff);
277 rh_reg_write(INTR_SIGNAL_ENABLE, INTR_IBI_READY |
278 INTR_TRANSFER_COMPLETION |
281 INTR_WARN_INS_STOP_MODE |
283 INTR_TRANSFER_ABORT);
290 regval = rh_reg_read(IBI_SETUP);
291 rh->ibi_status_sz = FIELD_GET(IBI_STATUS_STRUCT_SIZE, regval);
292 rh->ibi_status_entries = IBI_STATUS_RING_ENTRIES;
293 rh->ibi_chunks_total = IBI_CHUNK_POOL_SIZE;
295 rh->ibi_chunk_sz = dma_get_cache_alignment();
296 rh->ibi_chunk_sz *= IBI_CHUNK_CACHELINES;
297 BUG_ON(rh->ibi_chunk_sz > 256);
299 ibi_status_ring_sz = rh->ibi_status_sz * rh->ibi_status_entries;
300 ibi_data_ring_sz = rh->ibi_chunk_sz * rh->ibi_chunks_total;
303 dma_alloc_coherent(&hci->master.dev, ibi_status_ring_sz,
304 &rh->ibi_status_dma, GFP_KERNEL);
305 rh->ibi_data = kmalloc(ibi_data_ring_sz, GFP_KERNEL);
307 if (!rh->ibi_status || !rh->ibi_data)
310 dma_map_single(&hci->master.dev, rh->ibi_data,
311 ibi_data_ring_sz, DMA_FROM_DEVICE);
312 if (dma_mapping_error(&hci->master.dev, rh->ibi_data_dma)) {
313 rh->ibi_data_dma = 0;
318 regval = FIELD_PREP(IBI_STATUS_RING_SIZE,
319 rh->ibi_status_entries) |
320 FIELD_PREP(IBI_DATA_CHUNK_SIZE,
321 ilog2(rh->ibi_chunk_sz) - 2) |
322 FIELD_PREP(IBI_DATA_CHUNK_COUNT,
323 rh->ibi_chunks_total);
324 rh_reg_write(IBI_SETUP, regval);
326 regval = rh_reg_read(INTR_SIGNAL_ENABLE);
327 regval |= INTR_IBI_READY;
328 rh_reg_write(INTR_SIGNAL_ENABLE, regval);
331 rh_reg_write(RING_CONTROL, RING_CTRL_ENABLE |
338 hci_dma_cleanup(hci);
342 static void hci_dma_unmap_xfer(struct i3c_hci *hci,
343 struct hci_xfer *xfer_list, unsigned int n)
345 struct hci_xfer *xfer;
348 for (i = 0; i < n; i++) {
349 xfer = xfer_list + i;
352 dma_unmap_single(&hci->master.dev,
353 xfer->data_dma, xfer->data_len,
354 xfer->rnw ? DMA_FROM_DEVICE : DMA_TO_DEVICE);
358 static int hci_dma_queue_xfer(struct i3c_hci *hci,
359 struct hci_xfer *xfer_list, int n)
361 struct hci_rings_data *rings = hci->io_data;
362 struct hci_rh_data *rh;
363 unsigned int i, ring, enqueue_ptr;
364 u32 op1_val, op2_val;
366 /* For now we only use ring 0 */
368 rh = &rings->headers[ring];
370 op1_val = rh_reg_read(RING_OPERATION1);
371 enqueue_ptr = FIELD_GET(RING_OP1_CR_ENQ_PTR, op1_val);
372 for (i = 0; i < n; i++) {
373 struct hci_xfer *xfer = xfer_list + i;
374 u32 *ring_data = rh->xfer + rh->xfer_struct_sz * enqueue_ptr;
376 /* store cmd descriptor */
377 *ring_data++ = xfer->cmd_desc[0];
378 *ring_data++ = xfer->cmd_desc[1];
379 if (hci->cmd == &mipi_i3c_hci_cmd_v2) {
380 *ring_data++ = xfer->cmd_desc[2];
381 *ring_data++ = xfer->cmd_desc[3];
384 /* first word of Data Buffer Descriptor Structure */
388 FIELD_PREP(DATA_BUF_BLOCK_SIZE, xfer->data_len) |
389 ((i == n - 1) ? DATA_BUF_IOC : 0);
391 /* 2nd and 3rd words of Data Buffer Descriptor Structure */
394 dma_map_single(&hci->master.dev,
400 if (dma_mapping_error(&hci->master.dev,
402 hci_dma_unmap_xfer(hci, xfer_list, i);
405 *ring_data++ = lo32(xfer->data_dma);
406 *ring_data++ = hi32(xfer->data_dma);
412 /* remember corresponding xfer struct */
413 rh->src_xfers[enqueue_ptr] = xfer;
414 /* remember corresponding ring/entry for this xfer structure */
415 xfer->ring_number = ring;
416 xfer->ring_entry = enqueue_ptr;
418 enqueue_ptr = (enqueue_ptr + 1) % rh->xfer_entries;
421 * We may update the hardware view of the enqueue pointer
422 * only if we didn't reach its dequeue pointer.
424 op2_val = rh_reg_read(RING_OPERATION2);
425 if (enqueue_ptr == FIELD_GET(RING_OP2_CR_DEQ_PTR, op2_val)) {
426 /* the ring is full */
427 hci_dma_unmap_xfer(hci, xfer_list, i + 1);
432 /* take care to update the hardware enqueue pointer atomically */
433 spin_lock_irq(&rh->lock);
434 op1_val = rh_reg_read(RING_OPERATION1);
435 op1_val &= ~RING_OP1_CR_ENQ_PTR;
436 op1_val |= FIELD_PREP(RING_OP1_CR_ENQ_PTR, enqueue_ptr);
437 rh_reg_write(RING_OPERATION1, op1_val);
438 spin_unlock_irq(&rh->lock);
443 static bool hci_dma_dequeue_xfer(struct i3c_hci *hci,
444 struct hci_xfer *xfer_list, int n)
446 struct hci_rings_data *rings = hci->io_data;
447 struct hci_rh_data *rh = &rings->headers[xfer_list[0].ring_number];
449 bool did_unqueue = false;
452 rh_reg_write(RING_CONTROL, RING_CTRL_ABORT);
453 if (wait_for_completion_timeout(&rh->op_done, HZ) == 0) {
455 * We're deep in it if ever this condition is ever met.
456 * Hardware might still be writing to memory, etc.
458 dev_crit(&hci->master.dev, "unable to abort the ring\n");
462 for (i = 0; i < n; i++) {
463 struct hci_xfer *xfer = xfer_list + i;
464 int idx = xfer->ring_entry;
467 * At the time the abort happened, the xfer might have
468 * completed already. If not then replace corresponding
469 * descriptor entries with a no-op.
472 u32 *ring_data = rh->xfer + rh->xfer_struct_sz * idx;
474 /* store no-op cmd descriptor */
475 *ring_data++ = FIELD_PREP(CMD_0_ATTR, 0x7);
477 if (hci->cmd == &mipi_i3c_hci_cmd_v2) {
482 /* disassociate this xfer struct */
483 rh->src_xfers[idx] = NULL;
486 hci_dma_unmap_xfer(hci, xfer, 1);
492 /* restart the ring */
493 rh_reg_write(RING_CONTROL, RING_CTRL_ENABLE);
498 static void hci_dma_xfer_done(struct i3c_hci *hci, struct hci_rh_data *rh)
500 u32 op1_val, op2_val, resp, *ring_resp;
501 unsigned int tid, done_ptr = rh->done_ptr;
502 struct hci_xfer *xfer;
505 op2_val = rh_reg_read(RING_OPERATION2);
506 if (done_ptr == FIELD_GET(RING_OP2_CR_DEQ_PTR, op2_val))
509 ring_resp = rh->resp + rh->resp_struct_sz * done_ptr;
511 tid = RESP_TID(resp);
512 DBG("resp = 0x%08x", resp);
514 xfer = rh->src_xfers[done_ptr];
516 DBG("orphaned ring entry");
518 hci_dma_unmap_xfer(hci, xfer, 1);
519 xfer->ring_entry = -1;
520 xfer->response = resp;
521 if (tid != xfer->cmd_tid) {
522 dev_err(&hci->master.dev,
523 "response tid=%d when expecting %d\n",
525 /* TODO: do something about it? */
527 if (xfer->completion)
528 complete(xfer->completion);
531 done_ptr = (done_ptr + 1) % rh->xfer_entries;
532 rh->done_ptr = done_ptr;
535 /* take care to update the software dequeue pointer atomically */
536 spin_lock(&rh->lock);
537 op1_val = rh_reg_read(RING_OPERATION1);
538 op1_val &= ~RING_OP1_CR_SW_DEQ_PTR;
539 op1_val |= FIELD_PREP(RING_OP1_CR_SW_DEQ_PTR, done_ptr);
540 rh_reg_write(RING_OPERATION1, op1_val);
541 spin_unlock(&rh->lock);
544 static int hci_dma_request_ibi(struct i3c_hci *hci, struct i3c_dev_desc *dev,
545 const struct i3c_ibi_setup *req)
547 struct i3c_hci_dev_data *dev_data = i3c_dev_get_master_data(dev);
548 struct i3c_generic_ibi_pool *pool;
549 struct hci_dma_dev_ibi_data *dev_ibi;
551 dev_ibi = kmalloc(sizeof(*dev_ibi), GFP_KERNEL);
554 pool = i3c_generic_ibi_alloc_pool(dev, req);
557 return PTR_ERR(pool);
559 dev_ibi->pool = pool;
560 dev_ibi->max_len = req->max_payload_len;
561 dev_data->ibi_data = dev_ibi;
565 static void hci_dma_free_ibi(struct i3c_hci *hci, struct i3c_dev_desc *dev)
567 struct i3c_hci_dev_data *dev_data = i3c_dev_get_master_data(dev);
568 struct hci_dma_dev_ibi_data *dev_ibi = dev_data->ibi_data;
570 dev_data->ibi_data = NULL;
571 i3c_generic_ibi_free_pool(dev_ibi->pool);
575 static void hci_dma_recycle_ibi_slot(struct i3c_hci *hci,
576 struct i3c_dev_desc *dev,
577 struct i3c_ibi_slot *slot)
579 struct i3c_hci_dev_data *dev_data = i3c_dev_get_master_data(dev);
580 struct hci_dma_dev_ibi_data *dev_ibi = dev_data->ibi_data;
582 i3c_generic_ibi_recycle_slot(dev_ibi->pool, slot);
585 static void hci_dma_process_ibi(struct i3c_hci *hci, struct hci_rh_data *rh)
587 struct i3c_dev_desc *dev;
588 struct i3c_hci_dev_data *dev_data;
589 struct hci_dma_dev_ibi_data *dev_ibi;
590 struct i3c_ibi_slot *slot;
591 u32 op1_val, op2_val, ibi_status_error;
592 unsigned int ptr, enq_ptr, deq_ptr;
593 unsigned int ibi_size, ibi_chunks, ibi_data_offset, first_part;
594 int ibi_addr, last_ptr;
596 dma_addr_t ring_ibi_data_dma;
598 op1_val = rh_reg_read(RING_OPERATION1);
599 deq_ptr = FIELD_GET(RING_OP1_IBI_DEQ_PTR, op1_val);
601 op2_val = rh_reg_read(RING_OPERATION2);
602 enq_ptr = FIELD_GET(RING_OP2_IBI_ENQ_PTR, op2_val);
604 ibi_status_error = 0;
610 /* let's find all we can about this IBI */
611 for (ptr = deq_ptr; ptr != enq_ptr;
612 ptr = (ptr + 1) % rh->ibi_status_entries) {
613 u32 ibi_status, *ring_ibi_status;
616 ring_ibi_status = rh->ibi_status + rh->ibi_status_sz * ptr;
617 ibi_status = *ring_ibi_status;
618 DBG("status = %#x", ibi_status);
620 if (ibi_status_error) {
621 /* we no longer care */
622 } else if (ibi_status & IBI_ERROR) {
623 ibi_status_error = ibi_status;
624 } else if (ibi_addr == -1) {
625 ibi_addr = FIELD_GET(IBI_TARGET_ADDR, ibi_status);
626 } else if (ibi_addr != FIELD_GET(IBI_TARGET_ADDR, ibi_status)) {
627 /* the address changed unexpectedly */
628 ibi_status_error = ibi_status;
631 chunks = FIELD_GET(IBI_CHUNKS, ibi_status);
632 ibi_chunks += chunks;
633 if (!(ibi_status & IBI_LAST_STATUS)) {
634 ibi_size += chunks * rh->ibi_chunk_sz;
636 ibi_size += FIELD_GET(IBI_DATA_LENGTH, ibi_status);
642 /* validate what we've got */
644 if (last_ptr == -1) {
645 /* this IBI sequence is not yet complete */
646 DBG("no LAST_STATUS available (e=%d d=%d)", enq_ptr, deq_ptr);
649 deq_ptr = last_ptr + 1;
650 deq_ptr %= rh->ibi_status_entries;
652 if (ibi_status_error) {
653 dev_err(&hci->master.dev, "IBI error from %#x\n", ibi_addr);
657 /* determine who this is for */
658 dev = i3c_hci_addr_to_dev(hci, ibi_addr);
660 dev_err(&hci->master.dev,
661 "IBI for unknown device %#x\n", ibi_addr);
665 dev_data = i3c_dev_get_master_data(dev);
666 dev_ibi = dev_data->ibi_data;
667 if (ibi_size > dev_ibi->max_len) {
668 dev_err(&hci->master.dev, "IBI payload too big (%d > %d)\n",
669 ibi_size, dev_ibi->max_len);
674 * This ring model is not suitable for zero-copy processing of IBIs.
675 * We have the data chunk ring wrap-around to deal with, meaning
676 * that the payload might span multiple chunks beginning at the
677 * end of the ring and wrap to the start of the ring. Furthermore
678 * there is no guarantee that those chunks will be released in order
679 * and in a timely manner by the upper driver. So let's just copy
680 * them to a discrete buffer. In practice they're supposed to be
683 slot = i3c_generic_ibi_get_free_slot(dev_ibi->pool);
685 dev_err(&hci->master.dev, "no free slot for IBI\n");
689 /* copy first part of the payload */
690 ibi_data_offset = rh->ibi_chunk_sz * rh->ibi_chunk_ptr;
691 ring_ibi_data = rh->ibi_data + ibi_data_offset;
692 ring_ibi_data_dma = rh->ibi_data_dma + ibi_data_offset;
693 first_part = (rh->ibi_chunks_total - rh->ibi_chunk_ptr)
695 if (first_part > ibi_size)
696 first_part = ibi_size;
697 dma_sync_single_for_cpu(&hci->master.dev, ring_ibi_data_dma,
698 first_part, DMA_FROM_DEVICE);
699 memcpy(slot->data, ring_ibi_data, first_part);
701 /* copy second part if any */
702 if (ibi_size > first_part) {
703 /* we wrap back to the start and copy remaining data */
704 ring_ibi_data = rh->ibi_data;
705 ring_ibi_data_dma = rh->ibi_data_dma;
706 dma_sync_single_for_cpu(&hci->master.dev, ring_ibi_data_dma,
707 ibi_size - first_part, DMA_FROM_DEVICE);
708 memcpy(slot->data + first_part, ring_ibi_data,
709 ibi_size - first_part);
714 slot->len = ibi_size;
715 i3c_master_queue_ibi(dev, slot);
718 /* take care to update the ibi dequeue pointer atomically */
719 spin_lock(&rh->lock);
720 op1_val = rh_reg_read(RING_OPERATION1);
721 op1_val &= ~RING_OP1_IBI_DEQ_PTR;
722 op1_val |= FIELD_PREP(RING_OP1_IBI_DEQ_PTR, deq_ptr);
723 rh_reg_write(RING_OPERATION1, op1_val);
724 spin_unlock(&rh->lock);
726 /* update the chunk pointer */
727 rh->ibi_chunk_ptr += ibi_chunks;
728 rh->ibi_chunk_ptr %= rh->ibi_chunks_total;
730 /* and tell the hardware about freed chunks */
731 rh_reg_write(CHUNK_CONTROL, rh_reg_read(CHUNK_CONTROL) + ibi_chunks);
734 static bool hci_dma_irq_handler(struct i3c_hci *hci, unsigned int mask)
736 struct hci_rings_data *rings = hci->io_data;
738 bool handled = false;
740 for (i = 0; mask && i < rings->total; i++) {
741 struct hci_rh_data *rh;
744 if (!(mask & BIT(i)))
748 rh = &rings->headers[i];
749 status = rh_reg_read(INTR_STATUS);
750 DBG("rh%d status: %#x", i, status);
753 rh_reg_write(INTR_STATUS, status);
755 if (status & INTR_IBI_READY)
756 hci_dma_process_ibi(hci, rh);
757 if (status & (INTR_TRANSFER_COMPLETION | INTR_TRANSFER_ERR))
758 hci_dma_xfer_done(hci, rh);
759 if (status & INTR_RING_OP)
760 complete(&rh->op_done);
762 if (status & INTR_TRANSFER_ABORT) {
763 dev_notice_ratelimited(&hci->master.dev,
764 "ring %d: Transfer Aborted\n", i);
765 mipi_i3c_hci_resume(hci);
767 if (status & INTR_WARN_INS_STOP_MODE)
768 dev_warn_ratelimited(&hci->master.dev,
769 "ring %d: Inserted Stop on Mode Change\n", i);
770 if (status & INTR_IBI_RING_FULL)
771 dev_err_ratelimited(&hci->master.dev,
772 "ring %d: IBI Ring Full Condition\n", i);
780 const struct hci_io_ops mipi_i3c_hci_dma = {
781 .init = hci_dma_init,
782 .cleanup = hci_dma_cleanup,
783 .queue_xfer = hci_dma_queue_xfer,
784 .dequeue_xfer = hci_dma_dequeue_xfer,
785 .irq_handler = hci_dma_irq_handler,
786 .request_ibi = hci_dma_request_ibi,
787 .free_ibi = hci_dma_free_ibi,
788 .recycle_ibi_slot = hci_dma_recycle_ibi_slot,