usb: dwc3: keystone: drop dma_mask configuration
[linux/fpc-iii.git] / drivers / dma / sh / shdma-base.c
blobb35007e21e6b3cc0318126de473d99b8d917289c
1 /*
2 * Dmaengine driver base library for DMA controllers, found on SH-based SoCs
4 * extracted from shdma.c
6 * Copyright (C) 2011-2012 Guennadi Liakhovetski <g.liakhovetski@gmx.de>
7 * Copyright (C) 2009 Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com>
8 * Copyright (C) 2009 Renesas Solutions, Inc. All rights reserved.
9 * Copyright (C) 2007 Freescale Semiconductor, Inc. All rights reserved.
11 * This is free software; you can redistribute it and/or modify
12 * it under the terms of version 2 of the GNU General Public License as
13 * published by the Free Software Foundation.
16 #include <linux/delay.h>
17 #include <linux/shdma-base.h>
18 #include <linux/dmaengine.h>
19 #include <linux/init.h>
20 #include <linux/interrupt.h>
21 #include <linux/module.h>
22 #include <linux/pm_runtime.h>
23 #include <linux/slab.h>
24 #include <linux/spinlock.h>
26 #include "../dmaengine.h"
28 /* DMA descriptor control */
29 enum shdma_desc_status {
30 DESC_IDLE,
31 DESC_PREPARED,
32 DESC_SUBMITTED,
33 DESC_COMPLETED, /* completed, have to call callback */
34 DESC_WAITING, /* callback called, waiting for ack / re-submit */
37 #define NR_DESCS_PER_CHANNEL 32
39 #define to_shdma_chan(c) container_of(c, struct shdma_chan, dma_chan)
40 #define to_shdma_dev(d) container_of(d, struct shdma_dev, dma_dev)
43 * For slave DMA we assume, that there is a finite number of DMA slaves in the
44 * system, and that each such slave can only use a finite number of channels.
45 * We use slave channel IDs to make sure, that no such slave channel ID is
46 * allocated more than once.
48 static unsigned int slave_num = 256;
49 module_param(slave_num, uint, 0444);
51 /* A bitmask with slave_num bits */
52 static unsigned long *shdma_slave_used;
54 /* Called under spin_lock_irq(&schan->chan_lock") */
55 static void shdma_chan_xfer_ld_queue(struct shdma_chan *schan)
57 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
58 const struct shdma_ops *ops = sdev->ops;
59 struct shdma_desc *sdesc;
61 /* DMA work check */
62 if (ops->channel_busy(schan))
63 return;
65 /* Find the first not transferred descriptor */
66 list_for_each_entry(sdesc, &schan->ld_queue, node)
67 if (sdesc->mark == DESC_SUBMITTED) {
68 ops->start_xfer(schan, sdesc);
69 break;
73 static dma_cookie_t shdma_tx_submit(struct dma_async_tx_descriptor *tx)
75 struct shdma_desc *chunk, *c, *desc =
76 container_of(tx, struct shdma_desc, async_tx);
77 struct shdma_chan *schan = to_shdma_chan(tx->chan);
78 dma_async_tx_callback callback = tx->callback;
79 dma_cookie_t cookie;
80 bool power_up;
82 spin_lock_irq(&schan->chan_lock);
84 power_up = list_empty(&schan->ld_queue);
86 cookie = dma_cookie_assign(tx);
88 /* Mark all chunks of this descriptor as submitted, move to the queue */
89 list_for_each_entry_safe(chunk, c, desc->node.prev, node) {
91 * All chunks are on the global ld_free, so, we have to find
92 * the end of the chain ourselves
94 if (chunk != desc && (chunk->mark == DESC_IDLE ||
95 chunk->async_tx.cookie > 0 ||
96 chunk->async_tx.cookie == -EBUSY ||
97 &chunk->node == &schan->ld_free))
98 break;
99 chunk->mark = DESC_SUBMITTED;
100 if (chunk->chunks == 1) {
101 chunk->async_tx.callback = callback;
102 chunk->async_tx.callback_param = tx->callback_param;
103 } else {
104 /* Callback goes to the last chunk */
105 chunk->async_tx.callback = NULL;
107 chunk->cookie = cookie;
108 list_move_tail(&chunk->node, &schan->ld_queue);
110 dev_dbg(schan->dev, "submit #%d@%p on %d\n",
111 tx->cookie, &chunk->async_tx, schan->id);
114 if (power_up) {
115 int ret;
116 schan->pm_state = SHDMA_PM_BUSY;
118 ret = pm_runtime_get(schan->dev);
120 spin_unlock_irq(&schan->chan_lock);
121 if (ret < 0)
122 dev_err(schan->dev, "%s(): GET = %d\n", __func__, ret);
124 pm_runtime_barrier(schan->dev);
126 spin_lock_irq(&schan->chan_lock);
128 /* Have we been reset, while waiting? */
129 if (schan->pm_state != SHDMA_PM_ESTABLISHED) {
130 struct shdma_dev *sdev =
131 to_shdma_dev(schan->dma_chan.device);
132 const struct shdma_ops *ops = sdev->ops;
133 dev_dbg(schan->dev, "Bring up channel %d\n",
134 schan->id);
136 * TODO: .xfer_setup() might fail on some platforms.
137 * Make it int then, on error remove chunks from the
138 * queue again
140 ops->setup_xfer(schan, schan->slave_id);
142 if (schan->pm_state == SHDMA_PM_PENDING)
143 shdma_chan_xfer_ld_queue(schan);
144 schan->pm_state = SHDMA_PM_ESTABLISHED;
146 } else {
148 * Tell .device_issue_pending() not to run the queue, interrupts
149 * will do it anyway
151 schan->pm_state = SHDMA_PM_PENDING;
154 spin_unlock_irq(&schan->chan_lock);
156 return cookie;
159 /* Called with desc_lock held */
160 static struct shdma_desc *shdma_get_desc(struct shdma_chan *schan)
162 struct shdma_desc *sdesc;
164 list_for_each_entry(sdesc, &schan->ld_free, node)
165 if (sdesc->mark != DESC_PREPARED) {
166 BUG_ON(sdesc->mark != DESC_IDLE);
167 list_del(&sdesc->node);
168 return sdesc;
171 return NULL;
174 static int shdma_setup_slave(struct shdma_chan *schan, int slave_id,
175 dma_addr_t slave_addr)
177 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
178 const struct shdma_ops *ops = sdev->ops;
179 int ret, match;
181 if (schan->dev->of_node) {
182 match = schan->hw_req;
183 ret = ops->set_slave(schan, match, slave_addr, true);
184 if (ret < 0)
185 return ret;
187 slave_id = schan->slave_id;
188 } else {
189 match = slave_id;
192 if (slave_id < 0 || slave_id >= slave_num)
193 return -EINVAL;
195 if (test_and_set_bit(slave_id, shdma_slave_used))
196 return -EBUSY;
198 ret = ops->set_slave(schan, match, slave_addr, false);
199 if (ret < 0) {
200 clear_bit(slave_id, shdma_slave_used);
201 return ret;
204 schan->slave_id = slave_id;
206 return 0;
210 * This is the standard shdma filter function to be used as a replacement to the
211 * "old" method, using the .private pointer. If for some reason you allocate a
212 * channel without slave data, use something like ERR_PTR(-EINVAL) as a filter
213 * parameter. If this filter is used, the slave driver, after calling
214 * dma_request_channel(), will also have to call dmaengine_slave_config() with
215 * .slave_id, .direction, and either .src_addr or .dst_addr set.
216 * NOTE: this filter doesn't support multiple DMAC drivers with the DMA_SLAVE
217 * capability! If this becomes a requirement, hardware glue drivers, using this
218 * services would have to provide their own filters, which first would check
219 * the device driver, similar to how other DMAC drivers, e.g., sa11x0-dma.c, do
220 * this, and only then, in case of a match, call this common filter.
221 * NOTE 2: This filter function is also used in the DT case by shdma_of_xlate().
222 * In that case the MID-RID value is used for slave channel filtering and is
223 * passed to this function in the "arg" parameter.
225 bool shdma_chan_filter(struct dma_chan *chan, void *arg)
227 struct shdma_chan *schan = to_shdma_chan(chan);
228 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
229 const struct shdma_ops *ops = sdev->ops;
230 int match = (long)arg;
231 int ret;
233 if (match < 0)
234 /* No slave requested - arbitrary channel */
235 return true;
237 if (!schan->dev->of_node && match >= slave_num)
238 return false;
240 ret = ops->set_slave(schan, match, 0, true);
241 if (ret < 0)
242 return false;
244 return true;
246 EXPORT_SYMBOL(shdma_chan_filter);
248 static int shdma_alloc_chan_resources(struct dma_chan *chan)
250 struct shdma_chan *schan = to_shdma_chan(chan);
251 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
252 const struct shdma_ops *ops = sdev->ops;
253 struct shdma_desc *desc;
254 struct shdma_slave *slave = chan->private;
255 int ret, i;
258 * This relies on the guarantee from dmaengine that alloc_chan_resources
259 * never runs concurrently with itself or free_chan_resources.
261 if (slave) {
262 /* Legacy mode: .private is set in filter */
263 ret = shdma_setup_slave(schan, slave->slave_id, 0);
264 if (ret < 0)
265 goto esetslave;
266 } else {
267 schan->slave_id = -EINVAL;
270 schan->desc = kcalloc(NR_DESCS_PER_CHANNEL,
271 sdev->desc_size, GFP_KERNEL);
272 if (!schan->desc) {
273 ret = -ENOMEM;
274 goto edescalloc;
276 schan->desc_num = NR_DESCS_PER_CHANNEL;
278 for (i = 0; i < NR_DESCS_PER_CHANNEL; i++) {
279 desc = ops->embedded_desc(schan->desc, i);
280 dma_async_tx_descriptor_init(&desc->async_tx,
281 &schan->dma_chan);
282 desc->async_tx.tx_submit = shdma_tx_submit;
283 desc->mark = DESC_IDLE;
285 list_add(&desc->node, &schan->ld_free);
288 return NR_DESCS_PER_CHANNEL;
290 edescalloc:
291 if (slave)
292 esetslave:
293 clear_bit(slave->slave_id, shdma_slave_used);
294 chan->private = NULL;
295 return ret;
298 static dma_async_tx_callback __ld_cleanup(struct shdma_chan *schan, bool all)
300 struct shdma_desc *desc, *_desc;
301 /* Is the "exposed" head of a chain acked? */
302 bool head_acked = false;
303 dma_cookie_t cookie = 0;
304 dma_async_tx_callback callback = NULL;
305 void *param = NULL;
306 unsigned long flags;
307 LIST_HEAD(cyclic_list);
309 spin_lock_irqsave(&schan->chan_lock, flags);
310 list_for_each_entry_safe(desc, _desc, &schan->ld_queue, node) {
311 struct dma_async_tx_descriptor *tx = &desc->async_tx;
313 BUG_ON(tx->cookie > 0 && tx->cookie != desc->cookie);
314 BUG_ON(desc->mark != DESC_SUBMITTED &&
315 desc->mark != DESC_COMPLETED &&
316 desc->mark != DESC_WAITING);
319 * queue is ordered, and we use this loop to (1) clean up all
320 * completed descriptors, and to (2) update descriptor flags of
321 * any chunks in a (partially) completed chain
323 if (!all && desc->mark == DESC_SUBMITTED &&
324 desc->cookie != cookie)
325 break;
327 if (tx->cookie > 0)
328 cookie = tx->cookie;
330 if (desc->mark == DESC_COMPLETED && desc->chunks == 1) {
331 if (schan->dma_chan.completed_cookie != desc->cookie - 1)
332 dev_dbg(schan->dev,
333 "Completing cookie %d, expected %d\n",
334 desc->cookie,
335 schan->dma_chan.completed_cookie + 1);
336 schan->dma_chan.completed_cookie = desc->cookie;
339 /* Call callback on the last chunk */
340 if (desc->mark == DESC_COMPLETED && tx->callback) {
341 desc->mark = DESC_WAITING;
342 callback = tx->callback;
343 param = tx->callback_param;
344 dev_dbg(schan->dev, "descriptor #%d@%p on %d callback\n",
345 tx->cookie, tx, schan->id);
346 BUG_ON(desc->chunks != 1);
347 break;
350 if (tx->cookie > 0 || tx->cookie == -EBUSY) {
351 if (desc->mark == DESC_COMPLETED) {
352 BUG_ON(tx->cookie < 0);
353 desc->mark = DESC_WAITING;
355 head_acked = async_tx_test_ack(tx);
356 } else {
357 switch (desc->mark) {
358 case DESC_COMPLETED:
359 desc->mark = DESC_WAITING;
360 /* Fall through */
361 case DESC_WAITING:
362 if (head_acked)
363 async_tx_ack(&desc->async_tx);
367 dev_dbg(schan->dev, "descriptor %p #%d completed.\n",
368 tx, tx->cookie);
370 if (((desc->mark == DESC_COMPLETED ||
371 desc->mark == DESC_WAITING) &&
372 async_tx_test_ack(&desc->async_tx)) || all) {
374 if (all || !desc->cyclic) {
375 /* Remove from ld_queue list */
376 desc->mark = DESC_IDLE;
377 list_move(&desc->node, &schan->ld_free);
378 } else {
379 /* reuse as cyclic */
380 desc->mark = DESC_SUBMITTED;
381 list_move_tail(&desc->node, &cyclic_list);
384 if (list_empty(&schan->ld_queue)) {
385 dev_dbg(schan->dev, "Bring down channel %d\n", schan->id);
386 pm_runtime_put(schan->dev);
387 schan->pm_state = SHDMA_PM_ESTABLISHED;
392 if (all && !callback)
394 * Terminating and the loop completed normally: forgive
395 * uncompleted cookies
397 schan->dma_chan.completed_cookie = schan->dma_chan.cookie;
399 list_splice_tail(&cyclic_list, &schan->ld_queue);
401 spin_unlock_irqrestore(&schan->chan_lock, flags);
403 if (callback)
404 callback(param);
406 return callback;
410 * shdma_chan_ld_cleanup - Clean up link descriptors
412 * Clean up the ld_queue of DMA channel.
414 static void shdma_chan_ld_cleanup(struct shdma_chan *schan, bool all)
416 while (__ld_cleanup(schan, all))
421 * shdma_free_chan_resources - Free all resources of the channel.
423 static void shdma_free_chan_resources(struct dma_chan *chan)
425 struct shdma_chan *schan = to_shdma_chan(chan);
426 struct shdma_dev *sdev = to_shdma_dev(chan->device);
427 const struct shdma_ops *ops = sdev->ops;
428 LIST_HEAD(list);
430 /* Protect against ISR */
431 spin_lock_irq(&schan->chan_lock);
432 ops->halt_channel(schan);
433 spin_unlock_irq(&schan->chan_lock);
435 /* Now no new interrupts will occur */
437 /* Prepared and not submitted descriptors can still be on the queue */
438 if (!list_empty(&schan->ld_queue))
439 shdma_chan_ld_cleanup(schan, true);
441 if (schan->slave_id >= 0) {
442 /* The caller is holding dma_list_mutex */
443 clear_bit(schan->slave_id, shdma_slave_used);
444 chan->private = NULL;
447 spin_lock_irq(&schan->chan_lock);
449 list_splice_init(&schan->ld_free, &list);
450 schan->desc_num = 0;
452 spin_unlock_irq(&schan->chan_lock);
454 kfree(schan->desc);
458 * shdma_add_desc - get, set up and return one transfer descriptor
459 * @schan: DMA channel
460 * @flags: DMA transfer flags
461 * @dst: destination DMA address, incremented when direction equals
462 * DMA_DEV_TO_MEM or DMA_MEM_TO_MEM
463 * @src: source DMA address, incremented when direction equals
464 * DMA_MEM_TO_DEV or DMA_MEM_TO_MEM
465 * @len: DMA transfer length
466 * @first: if NULL, set to the current descriptor and cookie set to -EBUSY
467 * @direction: needed for slave DMA to decide which address to keep constant,
468 * equals DMA_MEM_TO_MEM for MEMCPY
469 * Returns 0 or an error
470 * Locks: called with desc_lock held
472 static struct shdma_desc *shdma_add_desc(struct shdma_chan *schan,
473 unsigned long flags, dma_addr_t *dst, dma_addr_t *src, size_t *len,
474 struct shdma_desc **first, enum dma_transfer_direction direction)
476 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
477 const struct shdma_ops *ops = sdev->ops;
478 struct shdma_desc *new;
479 size_t copy_size = *len;
481 if (!copy_size)
482 return NULL;
484 /* Allocate the link descriptor from the free list */
485 new = shdma_get_desc(schan);
486 if (!new) {
487 dev_err(schan->dev, "No free link descriptor available\n");
488 return NULL;
491 ops->desc_setup(schan, new, *src, *dst, &copy_size);
493 if (!*first) {
494 /* First desc */
495 new->async_tx.cookie = -EBUSY;
496 *first = new;
497 } else {
498 /* Other desc - invisible to the user */
499 new->async_tx.cookie = -EINVAL;
502 dev_dbg(schan->dev,
503 "chaining (%zu/%zu)@%pad -> %pad with %p, cookie %d\n",
504 copy_size, *len, src, dst, &new->async_tx,
505 new->async_tx.cookie);
507 new->mark = DESC_PREPARED;
508 new->async_tx.flags = flags;
509 new->direction = direction;
510 new->partial = 0;
512 *len -= copy_size;
513 if (direction == DMA_MEM_TO_MEM || direction == DMA_MEM_TO_DEV)
514 *src += copy_size;
515 if (direction == DMA_MEM_TO_MEM || direction == DMA_DEV_TO_MEM)
516 *dst += copy_size;
518 return new;
522 * shdma_prep_sg - prepare transfer descriptors from an SG list
524 * Common routine for public (MEMCPY) and slave DMA. The MEMCPY case is also
525 * converted to scatter-gather to guarantee consistent locking and a correct
526 * list manipulation. For slave DMA direction carries the usual meaning, and,
527 * logically, the SG list is RAM and the addr variable contains slave address,
528 * e.g., the FIFO I/O register. For MEMCPY direction equals DMA_MEM_TO_MEM
529 * and the SG list contains only one element and points at the source buffer.
531 static struct dma_async_tx_descriptor *shdma_prep_sg(struct shdma_chan *schan,
532 struct scatterlist *sgl, unsigned int sg_len, dma_addr_t *addr,
533 enum dma_transfer_direction direction, unsigned long flags, bool cyclic)
535 struct scatterlist *sg;
536 struct shdma_desc *first = NULL, *new = NULL /* compiler... */;
537 LIST_HEAD(tx_list);
538 int chunks = 0;
539 unsigned long irq_flags;
540 int i;
542 for_each_sg(sgl, sg, sg_len, i)
543 chunks += DIV_ROUND_UP(sg_dma_len(sg), schan->max_xfer_len);
545 /* Have to lock the whole loop to protect against concurrent release */
546 spin_lock_irqsave(&schan->chan_lock, irq_flags);
549 * Chaining:
550 * first descriptor is what user is dealing with in all API calls, its
551 * cookie is at first set to -EBUSY, at tx-submit to a positive
552 * number
553 * if more than one chunk is needed further chunks have cookie = -EINVAL
554 * the last chunk, if not equal to the first, has cookie = -ENOSPC
555 * all chunks are linked onto the tx_list head with their .node heads
556 * only during this function, then they are immediately spliced
557 * back onto the free list in form of a chain
559 for_each_sg(sgl, sg, sg_len, i) {
560 dma_addr_t sg_addr = sg_dma_address(sg);
561 size_t len = sg_dma_len(sg);
563 if (!len)
564 goto err_get_desc;
566 do {
567 dev_dbg(schan->dev, "Add SG #%d@%p[%zu], dma %pad\n",
568 i, sg, len, &sg_addr);
570 if (direction == DMA_DEV_TO_MEM)
571 new = shdma_add_desc(schan, flags,
572 &sg_addr, addr, &len, &first,
573 direction);
574 else
575 new = shdma_add_desc(schan, flags,
576 addr, &sg_addr, &len, &first,
577 direction);
578 if (!new)
579 goto err_get_desc;
581 new->cyclic = cyclic;
582 if (cyclic)
583 new->chunks = 1;
584 else
585 new->chunks = chunks--;
586 list_add_tail(&new->node, &tx_list);
587 } while (len);
590 if (new != first)
591 new->async_tx.cookie = -ENOSPC;
593 /* Put them back on the free list, so, they don't get lost */
594 list_splice_tail(&tx_list, &schan->ld_free);
596 spin_unlock_irqrestore(&schan->chan_lock, irq_flags);
598 return &first->async_tx;
600 err_get_desc:
601 list_for_each_entry(new, &tx_list, node)
602 new->mark = DESC_IDLE;
603 list_splice(&tx_list, &schan->ld_free);
605 spin_unlock_irqrestore(&schan->chan_lock, irq_flags);
607 return NULL;
610 static struct dma_async_tx_descriptor *shdma_prep_memcpy(
611 struct dma_chan *chan, dma_addr_t dma_dest, dma_addr_t dma_src,
612 size_t len, unsigned long flags)
614 struct shdma_chan *schan = to_shdma_chan(chan);
615 struct scatterlist sg;
617 if (!chan || !len)
618 return NULL;
620 BUG_ON(!schan->desc_num);
622 sg_init_table(&sg, 1);
623 sg_set_page(&sg, pfn_to_page(PFN_DOWN(dma_src)), len,
624 offset_in_page(dma_src));
625 sg_dma_address(&sg) = dma_src;
626 sg_dma_len(&sg) = len;
628 return shdma_prep_sg(schan, &sg, 1, &dma_dest, DMA_MEM_TO_MEM,
629 flags, false);
632 static struct dma_async_tx_descriptor *shdma_prep_slave_sg(
633 struct dma_chan *chan, struct scatterlist *sgl, unsigned int sg_len,
634 enum dma_transfer_direction direction, unsigned long flags, void *context)
636 struct shdma_chan *schan = to_shdma_chan(chan);
637 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
638 const struct shdma_ops *ops = sdev->ops;
639 int slave_id = schan->slave_id;
640 dma_addr_t slave_addr;
642 if (!chan)
643 return NULL;
645 BUG_ON(!schan->desc_num);
647 /* Someone calling slave DMA on a generic channel? */
648 if (slave_id < 0 || !sg_len) {
649 dev_warn(schan->dev, "%s: bad parameter: len=%d, id=%d\n",
650 __func__, sg_len, slave_id);
651 return NULL;
654 slave_addr = ops->slave_addr(schan);
656 return shdma_prep_sg(schan, sgl, sg_len, &slave_addr,
657 direction, flags, false);
660 #define SHDMA_MAX_SG_LEN 32
662 static struct dma_async_tx_descriptor *shdma_prep_dma_cyclic(
663 struct dma_chan *chan, dma_addr_t buf_addr, size_t buf_len,
664 size_t period_len, enum dma_transfer_direction direction,
665 unsigned long flags, void *context)
667 struct shdma_chan *schan = to_shdma_chan(chan);
668 struct shdma_dev *sdev = to_shdma_dev(schan->dma_chan.device);
669 const struct shdma_ops *ops = sdev->ops;
670 unsigned int sg_len = buf_len / period_len;
671 int slave_id = schan->slave_id;
672 dma_addr_t slave_addr;
673 struct scatterlist sgl[SHDMA_MAX_SG_LEN];
674 int i;
676 if (!chan)
677 return NULL;
679 BUG_ON(!schan->desc_num);
681 if (sg_len > SHDMA_MAX_SG_LEN) {
682 dev_err(schan->dev, "sg length %d exceds limit %d",
683 sg_len, SHDMA_MAX_SG_LEN);
684 return NULL;
687 /* Someone calling slave DMA on a generic channel? */
688 if (slave_id < 0 || (buf_len < period_len)) {
689 dev_warn(schan->dev,
690 "%s: bad parameter: buf_len=%zu, period_len=%zu, id=%d\n",
691 __func__, buf_len, period_len, slave_id);
692 return NULL;
695 slave_addr = ops->slave_addr(schan);
697 sg_init_table(sgl, sg_len);
698 for (i = 0; i < sg_len; i++) {
699 dma_addr_t src = buf_addr + (period_len * i);
701 sg_set_page(&sgl[i], pfn_to_page(PFN_DOWN(src)), period_len,
702 offset_in_page(src));
703 sg_dma_address(&sgl[i]) = src;
704 sg_dma_len(&sgl[i]) = period_len;
707 return shdma_prep_sg(schan, sgl, sg_len, &slave_addr,
708 direction, flags, true);
711 static int shdma_control(struct dma_chan *chan, enum dma_ctrl_cmd cmd,
712 unsigned long arg)
714 struct shdma_chan *schan = to_shdma_chan(chan);
715 struct shdma_dev *sdev = to_shdma_dev(chan->device);
716 const struct shdma_ops *ops = sdev->ops;
717 struct dma_slave_config *config;
718 unsigned long flags;
719 int ret;
721 switch (cmd) {
722 case DMA_TERMINATE_ALL:
723 spin_lock_irqsave(&schan->chan_lock, flags);
724 ops->halt_channel(schan);
726 if (ops->get_partial && !list_empty(&schan->ld_queue)) {
727 /* Record partial transfer */
728 struct shdma_desc *desc = list_first_entry(&schan->ld_queue,
729 struct shdma_desc, node);
730 desc->partial = ops->get_partial(schan, desc);
733 spin_unlock_irqrestore(&schan->chan_lock, flags);
735 shdma_chan_ld_cleanup(schan, true);
736 break;
737 case DMA_SLAVE_CONFIG:
739 * So far only .slave_id is used, but the slave drivers are
740 * encouraged to also set a transfer direction and an address.
742 if (!arg)
743 return -EINVAL;
745 * We could lock this, but you shouldn't be configuring the
746 * channel, while using it...
748 config = (struct dma_slave_config *)arg;
749 ret = shdma_setup_slave(schan, config->slave_id,
750 config->direction == DMA_DEV_TO_MEM ?
751 config->src_addr : config->dst_addr);
752 if (ret < 0)
753 return ret;
754 break;
755 default:
756 return -ENXIO;
759 return 0;
762 static void shdma_issue_pending(struct dma_chan *chan)
764 struct shdma_chan *schan = to_shdma_chan(chan);
766 spin_lock_irq(&schan->chan_lock);
767 if (schan->pm_state == SHDMA_PM_ESTABLISHED)
768 shdma_chan_xfer_ld_queue(schan);
769 else
770 schan->pm_state = SHDMA_PM_PENDING;
771 spin_unlock_irq(&schan->chan_lock);
774 static enum dma_status shdma_tx_status(struct dma_chan *chan,
775 dma_cookie_t cookie,
776 struct dma_tx_state *txstate)
778 struct shdma_chan *schan = to_shdma_chan(chan);
779 enum dma_status status;
780 unsigned long flags;
782 shdma_chan_ld_cleanup(schan, false);
784 spin_lock_irqsave(&schan->chan_lock, flags);
786 status = dma_cookie_status(chan, cookie, txstate);
789 * If we don't find cookie on the queue, it has been aborted and we have
790 * to report error
792 if (status != DMA_COMPLETE) {
793 struct shdma_desc *sdesc;
794 status = DMA_ERROR;
795 list_for_each_entry(sdesc, &schan->ld_queue, node)
796 if (sdesc->cookie == cookie) {
797 status = DMA_IN_PROGRESS;
798 break;
802 spin_unlock_irqrestore(&schan->chan_lock, flags);
804 return status;
807 /* Called from error IRQ or NMI */
808 bool shdma_reset(struct shdma_dev *sdev)
810 const struct shdma_ops *ops = sdev->ops;
811 struct shdma_chan *schan;
812 unsigned int handled = 0;
813 int i;
815 /* Reset all channels */
816 shdma_for_each_chan(schan, sdev, i) {
817 struct shdma_desc *sdesc;
818 LIST_HEAD(dl);
820 if (!schan)
821 continue;
823 spin_lock(&schan->chan_lock);
825 /* Stop the channel */
826 ops->halt_channel(schan);
828 list_splice_init(&schan->ld_queue, &dl);
830 if (!list_empty(&dl)) {
831 dev_dbg(schan->dev, "Bring down channel %d\n", schan->id);
832 pm_runtime_put(schan->dev);
834 schan->pm_state = SHDMA_PM_ESTABLISHED;
836 spin_unlock(&schan->chan_lock);
838 /* Complete all */
839 list_for_each_entry(sdesc, &dl, node) {
840 struct dma_async_tx_descriptor *tx = &sdesc->async_tx;
841 sdesc->mark = DESC_IDLE;
842 if (tx->callback)
843 tx->callback(tx->callback_param);
846 spin_lock(&schan->chan_lock);
847 list_splice(&dl, &schan->ld_free);
848 spin_unlock(&schan->chan_lock);
850 handled++;
853 return !!handled;
855 EXPORT_SYMBOL(shdma_reset);
857 static irqreturn_t chan_irq(int irq, void *dev)
859 struct shdma_chan *schan = dev;
860 const struct shdma_ops *ops =
861 to_shdma_dev(schan->dma_chan.device)->ops;
862 irqreturn_t ret;
864 spin_lock(&schan->chan_lock);
866 ret = ops->chan_irq(schan, irq) ? IRQ_WAKE_THREAD : IRQ_NONE;
868 spin_unlock(&schan->chan_lock);
870 return ret;
873 static irqreturn_t chan_irqt(int irq, void *dev)
875 struct shdma_chan *schan = dev;
876 const struct shdma_ops *ops =
877 to_shdma_dev(schan->dma_chan.device)->ops;
878 struct shdma_desc *sdesc;
880 spin_lock_irq(&schan->chan_lock);
881 list_for_each_entry(sdesc, &schan->ld_queue, node) {
882 if (sdesc->mark == DESC_SUBMITTED &&
883 ops->desc_completed(schan, sdesc)) {
884 dev_dbg(schan->dev, "done #%d@%p\n",
885 sdesc->async_tx.cookie, &sdesc->async_tx);
886 sdesc->mark = DESC_COMPLETED;
887 break;
890 /* Next desc */
891 shdma_chan_xfer_ld_queue(schan);
892 spin_unlock_irq(&schan->chan_lock);
894 shdma_chan_ld_cleanup(schan, false);
896 return IRQ_HANDLED;
899 int shdma_request_irq(struct shdma_chan *schan, int irq,
900 unsigned long flags, const char *name)
902 int ret = devm_request_threaded_irq(schan->dev, irq, chan_irq,
903 chan_irqt, flags, name, schan);
905 schan->irq = ret < 0 ? ret : irq;
907 return ret;
909 EXPORT_SYMBOL(shdma_request_irq);
911 void shdma_chan_probe(struct shdma_dev *sdev,
912 struct shdma_chan *schan, int id)
914 schan->pm_state = SHDMA_PM_ESTABLISHED;
916 /* reference struct dma_device */
917 schan->dma_chan.device = &sdev->dma_dev;
918 dma_cookie_init(&schan->dma_chan);
920 schan->dev = sdev->dma_dev.dev;
921 schan->id = id;
923 if (!schan->max_xfer_len)
924 schan->max_xfer_len = PAGE_SIZE;
926 spin_lock_init(&schan->chan_lock);
928 /* Init descripter manage list */
929 INIT_LIST_HEAD(&schan->ld_queue);
930 INIT_LIST_HEAD(&schan->ld_free);
932 /* Add the channel to DMA device channel list */
933 list_add_tail(&schan->dma_chan.device_node,
934 &sdev->dma_dev.channels);
935 sdev->schan[sdev->dma_dev.chancnt++] = schan;
937 EXPORT_SYMBOL(shdma_chan_probe);
939 void shdma_chan_remove(struct shdma_chan *schan)
941 list_del(&schan->dma_chan.device_node);
943 EXPORT_SYMBOL(shdma_chan_remove);
945 int shdma_init(struct device *dev, struct shdma_dev *sdev,
946 int chan_num)
948 struct dma_device *dma_dev = &sdev->dma_dev;
951 * Require all call-backs for now, they can trivially be made optional
952 * later as required
954 if (!sdev->ops ||
955 !sdev->desc_size ||
956 !sdev->ops->embedded_desc ||
957 !sdev->ops->start_xfer ||
958 !sdev->ops->setup_xfer ||
959 !sdev->ops->set_slave ||
960 !sdev->ops->desc_setup ||
961 !sdev->ops->slave_addr ||
962 !sdev->ops->channel_busy ||
963 !sdev->ops->halt_channel ||
964 !sdev->ops->desc_completed)
965 return -EINVAL;
967 sdev->schan = kcalloc(chan_num, sizeof(*sdev->schan), GFP_KERNEL);
968 if (!sdev->schan)
969 return -ENOMEM;
971 INIT_LIST_HEAD(&dma_dev->channels);
973 /* Common and MEMCPY operations */
974 dma_dev->device_alloc_chan_resources
975 = shdma_alloc_chan_resources;
976 dma_dev->device_free_chan_resources = shdma_free_chan_resources;
977 dma_dev->device_prep_dma_memcpy = shdma_prep_memcpy;
978 dma_dev->device_tx_status = shdma_tx_status;
979 dma_dev->device_issue_pending = shdma_issue_pending;
981 /* Compulsory for DMA_SLAVE fields */
982 dma_dev->device_prep_slave_sg = shdma_prep_slave_sg;
983 dma_dev->device_prep_dma_cyclic = shdma_prep_dma_cyclic;
984 dma_dev->device_control = shdma_control;
986 dma_dev->dev = dev;
988 return 0;
990 EXPORT_SYMBOL(shdma_init);
992 void shdma_cleanup(struct shdma_dev *sdev)
994 kfree(sdev->schan);
996 EXPORT_SYMBOL(shdma_cleanup);
998 static int __init shdma_enter(void)
1000 shdma_slave_used = kzalloc(DIV_ROUND_UP(slave_num, BITS_PER_LONG) *
1001 sizeof(long), GFP_KERNEL);
1002 if (!shdma_slave_used)
1003 return -ENOMEM;
1004 return 0;
1006 module_init(shdma_enter);
1008 static void __exit shdma_exit(void)
1010 kfree(shdma_slave_used);
1012 module_exit(shdma_exit);
1014 MODULE_LICENSE("GPL v2");
1015 MODULE_DESCRIPTION("SH-DMA driver base library");
1016 MODULE_AUTHOR("Guennadi Liakhovetski <g.liakhovetski@gmx.de>");