tty: hvc: Remove redundant license text
[linux/fpc-iii.git] / drivers / dma / bcm2835-dma.c
blob6204cc32d09c5096df8aec304c3c37b3bcb6be44
1 /*
2 * BCM2835 DMA engine support
4 * This driver only supports cyclic DMA transfers
5 * as needed for the I2S module.
7 * Author: Florian Meier <florian.meier@koalo.de>
8 * Copyright 2013
10 * Based on
11 * OMAP DMAengine support by Russell King
13 * BCM2708 DMA Driver
14 * Copyright (C) 2010 Broadcom
16 * Raspberry Pi PCM I2S ALSA Driver
17 * Copyright (c) by Phil Poole 2013
19 * MARVELL MMP Peripheral DMA Driver
20 * Copyright 2012 Marvell International Ltd.
22 * This program is free software; you can redistribute it and/or modify
23 * it under the terms of the GNU General Public License as published by
24 * the Free Software Foundation; either version 2 of the License, or
25 * (at your option) any later version.
27 * This program is distributed in the hope that it will be useful,
28 * but WITHOUT ANY WARRANTY; without even the implied warranty of
29 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
30 * GNU General Public License for more details.
32 #include <linux/dmaengine.h>
33 #include <linux/dma-mapping.h>
34 #include <linux/dmapool.h>
35 #include <linux/err.h>
36 #include <linux/init.h>
37 #include <linux/interrupt.h>
38 #include <linux/list.h>
39 #include <linux/module.h>
40 #include <linux/platform_device.h>
41 #include <linux/slab.h>
42 #include <linux/io.h>
43 #include <linux/spinlock.h>
44 #include <linux/of.h>
45 #include <linux/of_dma.h>
47 #include "virt-dma.h"
49 #define BCM2835_DMA_MAX_DMA_CHAN_SUPPORTED 14
50 #define BCM2835_DMA_CHAN_NAME_SIZE 8
52 struct bcm2835_dmadev {
53 struct dma_device ddev;
54 spinlock_t lock;
55 void __iomem *base;
56 struct device_dma_parameters dma_parms;
59 struct bcm2835_dma_cb {
60 uint32_t info;
61 uint32_t src;
62 uint32_t dst;
63 uint32_t length;
64 uint32_t stride;
65 uint32_t next;
66 uint32_t pad[2];
69 struct bcm2835_cb_entry {
70 struct bcm2835_dma_cb *cb;
71 dma_addr_t paddr;
74 struct bcm2835_chan {
75 struct virt_dma_chan vc;
76 struct list_head node;
78 struct dma_slave_config cfg;
79 unsigned int dreq;
81 int ch;
82 struct bcm2835_desc *desc;
83 struct dma_pool *cb_pool;
85 void __iomem *chan_base;
86 int irq_number;
87 unsigned int irq_flags;
89 bool is_lite_channel;
92 struct bcm2835_desc {
93 struct bcm2835_chan *c;
94 struct virt_dma_desc vd;
95 enum dma_transfer_direction dir;
97 unsigned int frames;
98 size_t size;
100 bool cyclic;
102 struct bcm2835_cb_entry cb_list[];
105 #define BCM2835_DMA_CS 0x00
106 #define BCM2835_DMA_ADDR 0x04
107 #define BCM2835_DMA_TI 0x08
108 #define BCM2835_DMA_SOURCE_AD 0x0c
109 #define BCM2835_DMA_DEST_AD 0x10
110 #define BCM2835_DMA_LEN 0x14
111 #define BCM2835_DMA_STRIDE 0x18
112 #define BCM2835_DMA_NEXTCB 0x1c
113 #define BCM2835_DMA_DEBUG 0x20
115 /* DMA CS Control and Status bits */
116 #define BCM2835_DMA_ACTIVE BIT(0) /* activate the DMA */
117 #define BCM2835_DMA_END BIT(1) /* current CB has ended */
118 #define BCM2835_DMA_INT BIT(2) /* interrupt status */
119 #define BCM2835_DMA_DREQ BIT(3) /* DREQ state */
120 #define BCM2835_DMA_ISPAUSED BIT(4) /* Pause requested or not active */
121 #define BCM2835_DMA_ISHELD BIT(5) /* Is held by DREQ flow control */
122 #define BCM2835_DMA_WAITING_FOR_WRITES BIT(6) /* waiting for last
123 * AXI-write to ack
125 #define BCM2835_DMA_ERR BIT(8)
126 #define BCM2835_DMA_PRIORITY(x) ((x & 15) << 16) /* AXI priority */
127 #define BCM2835_DMA_PANIC_PRIORITY(x) ((x & 15) << 20) /* panic priority */
128 /* current value of TI.BCM2835_DMA_WAIT_RESP */
129 #define BCM2835_DMA_WAIT_FOR_WRITES BIT(28)
130 #define BCM2835_DMA_DIS_DEBUG BIT(29) /* disable debug pause signal */
131 #define BCM2835_DMA_ABORT BIT(30) /* Stop current CB, go to next, WO */
132 #define BCM2835_DMA_RESET BIT(31) /* WO, self clearing */
134 /* Transfer information bits - also bcm2835_cb.info field */
135 #define BCM2835_DMA_INT_EN BIT(0)
136 #define BCM2835_DMA_TDMODE BIT(1) /* 2D-Mode */
137 #define BCM2835_DMA_WAIT_RESP BIT(3) /* wait for AXI-write to be acked */
138 #define BCM2835_DMA_D_INC BIT(4)
139 #define BCM2835_DMA_D_WIDTH BIT(5) /* 128bit writes if set */
140 #define BCM2835_DMA_D_DREQ BIT(6) /* enable DREQ for destination */
141 #define BCM2835_DMA_D_IGNORE BIT(7) /* ignore destination writes */
142 #define BCM2835_DMA_S_INC BIT(8)
143 #define BCM2835_DMA_S_WIDTH BIT(9) /* 128bit writes if set */
144 #define BCM2835_DMA_S_DREQ BIT(10) /* enable SREQ for source */
145 #define BCM2835_DMA_S_IGNORE BIT(11) /* ignore source reads - read 0 */
146 #define BCM2835_DMA_BURST_LENGTH(x) ((x & 15) << 12)
147 #define BCM2835_DMA_PER_MAP(x) ((x & 31) << 16) /* REQ source */
148 #define BCM2835_DMA_WAIT(x) ((x & 31) << 21) /* add DMA-wait cycles */
149 #define BCM2835_DMA_NO_WIDE_BURSTS BIT(26) /* no 2 beat write bursts */
151 /* debug register bits */
152 #define BCM2835_DMA_DEBUG_LAST_NOT_SET_ERR BIT(0)
153 #define BCM2835_DMA_DEBUG_FIFO_ERR BIT(1)
154 #define BCM2835_DMA_DEBUG_READ_ERR BIT(2)
155 #define BCM2835_DMA_DEBUG_OUTSTANDING_WRITES_SHIFT 4
156 #define BCM2835_DMA_DEBUG_OUTSTANDING_WRITES_BITS 4
157 #define BCM2835_DMA_DEBUG_ID_SHIFT 16
158 #define BCM2835_DMA_DEBUG_ID_BITS 9
159 #define BCM2835_DMA_DEBUG_STATE_SHIFT 16
160 #define BCM2835_DMA_DEBUG_STATE_BITS 9
161 #define BCM2835_DMA_DEBUG_VERSION_SHIFT 25
162 #define BCM2835_DMA_DEBUG_VERSION_BITS 3
163 #define BCM2835_DMA_DEBUG_LITE BIT(28)
165 /* shared registers for all dma channels */
166 #define BCM2835_DMA_INT_STATUS 0xfe0
167 #define BCM2835_DMA_ENABLE 0xff0
169 #define BCM2835_DMA_DATA_TYPE_S8 1
170 #define BCM2835_DMA_DATA_TYPE_S16 2
171 #define BCM2835_DMA_DATA_TYPE_S32 4
172 #define BCM2835_DMA_DATA_TYPE_S128 16
174 /* Valid only for channels 0 - 14, 15 has its own base address */
175 #define BCM2835_DMA_CHAN(n) ((n) << 8) /* Base address */
176 #define BCM2835_DMA_CHANIO(base, n) ((base) + BCM2835_DMA_CHAN(n))
178 /* the max dma length for different channels */
179 #define MAX_DMA_LEN SZ_1G
180 #define MAX_LITE_DMA_LEN (SZ_64K - 4)
182 static inline size_t bcm2835_dma_max_frame_length(struct bcm2835_chan *c)
184 /* lite and normal channels have different max frame length */
185 return c->is_lite_channel ? MAX_LITE_DMA_LEN : MAX_DMA_LEN;
188 /* how many frames of max_len size do we need to transfer len bytes */
189 static inline size_t bcm2835_dma_frames_for_length(size_t len,
190 size_t max_len)
192 return DIV_ROUND_UP(len, max_len);
195 static inline struct bcm2835_dmadev *to_bcm2835_dma_dev(struct dma_device *d)
197 return container_of(d, struct bcm2835_dmadev, ddev);
200 static inline struct bcm2835_chan *to_bcm2835_dma_chan(struct dma_chan *c)
202 return container_of(c, struct bcm2835_chan, vc.chan);
205 static inline struct bcm2835_desc *to_bcm2835_dma_desc(
206 struct dma_async_tx_descriptor *t)
208 return container_of(t, struct bcm2835_desc, vd.tx);
211 static void bcm2835_dma_free_cb_chain(struct bcm2835_desc *desc)
213 size_t i;
215 for (i = 0; i < desc->frames; i++)
216 dma_pool_free(desc->c->cb_pool, desc->cb_list[i].cb,
217 desc->cb_list[i].paddr);
219 kfree(desc);
222 static void bcm2835_dma_desc_free(struct virt_dma_desc *vd)
224 bcm2835_dma_free_cb_chain(
225 container_of(vd, struct bcm2835_desc, vd));
228 static void bcm2835_dma_create_cb_set_length(
229 struct bcm2835_chan *chan,
230 struct bcm2835_dma_cb *control_block,
231 size_t len,
232 size_t period_len,
233 size_t *total_len,
234 u32 finalextrainfo)
236 size_t max_len = bcm2835_dma_max_frame_length(chan);
238 /* set the length taking lite-channel limitations into account */
239 control_block->length = min_t(u32, len, max_len);
241 /* finished if we have no period_length */
242 if (!period_len)
243 return;
246 * period_len means: that we need to generate
247 * transfers that are terminating at every
248 * multiple of period_len - this is typically
249 * used to set the interrupt flag in info
250 * which is required during cyclic transfers
253 /* have we filled in period_length yet? */
254 if (*total_len + control_block->length < period_len) {
255 /* update number of bytes in this period so far */
256 *total_len += control_block->length;
257 return;
260 /* calculate the length that remains to reach period_length */
261 control_block->length = period_len - *total_len;
263 /* reset total_length for next period */
264 *total_len = 0;
266 /* add extrainfo bits in info */
267 control_block->info |= finalextrainfo;
270 static inline size_t bcm2835_dma_count_frames_for_sg(
271 struct bcm2835_chan *c,
272 struct scatterlist *sgl,
273 unsigned int sg_len)
275 size_t frames = 0;
276 struct scatterlist *sgent;
277 unsigned int i;
278 size_t plength = bcm2835_dma_max_frame_length(c);
280 for_each_sg(sgl, sgent, sg_len, i)
281 frames += bcm2835_dma_frames_for_length(
282 sg_dma_len(sgent), plength);
284 return frames;
288 * bcm2835_dma_create_cb_chain - create a control block and fills data in
290 * @chan: the @dma_chan for which we run this
291 * @direction: the direction in which we transfer
292 * @cyclic: it is a cyclic transfer
293 * @info: the default info bits to apply per controlblock
294 * @frames: number of controlblocks to allocate
295 * @src: the src address to assign (if the S_INC bit is set
296 * in @info, then it gets incremented)
297 * @dst: the dst address to assign (if the D_INC bit is set
298 * in @info, then it gets incremented)
299 * @buf_len: the full buffer length (may also be 0)
300 * @period_len: the period length when to apply @finalextrainfo
301 * in addition to the last transfer
302 * this will also break some control-blocks early
303 * @finalextrainfo: additional bits in last controlblock
304 * (or when period_len is reached in case of cyclic)
305 * @gfp: the GFP flag to use for allocation
307 static struct bcm2835_desc *bcm2835_dma_create_cb_chain(
308 struct dma_chan *chan, enum dma_transfer_direction direction,
309 bool cyclic, u32 info, u32 finalextrainfo, size_t frames,
310 dma_addr_t src, dma_addr_t dst, size_t buf_len,
311 size_t period_len, gfp_t gfp)
313 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
314 size_t len = buf_len, total_len;
315 size_t frame;
316 struct bcm2835_desc *d;
317 struct bcm2835_cb_entry *cb_entry;
318 struct bcm2835_dma_cb *control_block;
320 if (!frames)
321 return NULL;
323 /* allocate and setup the descriptor. */
324 d = kzalloc(sizeof(*d) + frames * sizeof(struct bcm2835_cb_entry),
325 gfp);
326 if (!d)
327 return NULL;
329 d->c = c;
330 d->dir = direction;
331 d->cyclic = cyclic;
334 * Iterate over all frames, create a control block
335 * for each frame and link them together.
337 for (frame = 0, total_len = 0; frame < frames; d->frames++, frame++) {
338 cb_entry = &d->cb_list[frame];
339 cb_entry->cb = dma_pool_alloc(c->cb_pool, gfp,
340 &cb_entry->paddr);
341 if (!cb_entry->cb)
342 goto error_cb;
344 /* fill in the control block */
345 control_block = cb_entry->cb;
346 control_block->info = info;
347 control_block->src = src;
348 control_block->dst = dst;
349 control_block->stride = 0;
350 control_block->next = 0;
351 /* set up length in control_block if requested */
352 if (buf_len) {
353 /* calculate length honoring period_length */
354 bcm2835_dma_create_cb_set_length(
355 c, control_block,
356 len, period_len, &total_len,
357 cyclic ? finalextrainfo : 0);
359 /* calculate new remaining length */
360 len -= control_block->length;
363 /* link this the last controlblock */
364 if (frame)
365 d->cb_list[frame - 1].cb->next = cb_entry->paddr;
367 /* update src and dst and length */
368 if (src && (info & BCM2835_DMA_S_INC))
369 src += control_block->length;
370 if (dst && (info & BCM2835_DMA_D_INC))
371 dst += control_block->length;
373 /* Length of total transfer */
374 d->size += control_block->length;
377 /* the last frame requires extra flags */
378 d->cb_list[d->frames - 1].cb->info |= finalextrainfo;
380 /* detect a size missmatch */
381 if (buf_len && (d->size != buf_len))
382 goto error_cb;
384 return d;
385 error_cb:
386 bcm2835_dma_free_cb_chain(d);
388 return NULL;
391 static void bcm2835_dma_fill_cb_chain_with_sg(
392 struct dma_chan *chan,
393 enum dma_transfer_direction direction,
394 struct bcm2835_cb_entry *cb,
395 struct scatterlist *sgl,
396 unsigned int sg_len)
398 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
399 size_t len, max_len;
400 unsigned int i;
401 dma_addr_t addr;
402 struct scatterlist *sgent;
404 max_len = bcm2835_dma_max_frame_length(c);
405 for_each_sg(sgl, sgent, sg_len, i) {
406 for (addr = sg_dma_address(sgent), len = sg_dma_len(sgent);
407 len > 0;
408 addr += cb->cb->length, len -= cb->cb->length, cb++) {
409 if (direction == DMA_DEV_TO_MEM)
410 cb->cb->dst = addr;
411 else
412 cb->cb->src = addr;
413 cb->cb->length = min(len, max_len);
418 static int bcm2835_dma_abort(void __iomem *chan_base)
420 unsigned long cs;
421 long int timeout = 10000;
423 cs = readl(chan_base + BCM2835_DMA_CS);
424 if (!(cs & BCM2835_DMA_ACTIVE))
425 return 0;
427 /* Write 0 to the active bit - Pause the DMA */
428 writel(0, chan_base + BCM2835_DMA_CS);
430 /* Wait for any current AXI transfer to complete */
431 while ((cs & BCM2835_DMA_ISPAUSED) && --timeout) {
432 cpu_relax();
433 cs = readl(chan_base + BCM2835_DMA_CS);
436 /* We'll un-pause when we set of our next DMA */
437 if (!timeout)
438 return -ETIMEDOUT;
440 if (!(cs & BCM2835_DMA_ACTIVE))
441 return 0;
443 /* Terminate the control block chain */
444 writel(0, chan_base + BCM2835_DMA_NEXTCB);
446 /* Abort the whole DMA */
447 writel(BCM2835_DMA_ABORT | BCM2835_DMA_ACTIVE,
448 chan_base + BCM2835_DMA_CS);
450 return 0;
453 static void bcm2835_dma_start_desc(struct bcm2835_chan *c)
455 struct virt_dma_desc *vd = vchan_next_desc(&c->vc);
456 struct bcm2835_desc *d;
458 if (!vd) {
459 c->desc = NULL;
460 return;
463 list_del(&vd->node);
465 c->desc = d = to_bcm2835_dma_desc(&vd->tx);
467 writel(d->cb_list[0].paddr, c->chan_base + BCM2835_DMA_ADDR);
468 writel(BCM2835_DMA_ACTIVE, c->chan_base + BCM2835_DMA_CS);
471 static irqreturn_t bcm2835_dma_callback(int irq, void *data)
473 struct bcm2835_chan *c = data;
474 struct bcm2835_desc *d;
475 unsigned long flags;
477 /* check the shared interrupt */
478 if (c->irq_flags & IRQF_SHARED) {
479 /* check if the interrupt is enabled */
480 flags = readl(c->chan_base + BCM2835_DMA_CS);
481 /* if not set then we are not the reason for the irq */
482 if (!(flags & BCM2835_DMA_INT))
483 return IRQ_NONE;
486 spin_lock_irqsave(&c->vc.lock, flags);
488 /* Acknowledge interrupt */
489 writel(BCM2835_DMA_INT, c->chan_base + BCM2835_DMA_CS);
491 d = c->desc;
493 if (d) {
494 if (d->cyclic) {
495 /* call the cyclic callback */
496 vchan_cyclic_callback(&d->vd);
498 /* Keep the DMA engine running */
499 writel(BCM2835_DMA_ACTIVE,
500 c->chan_base + BCM2835_DMA_CS);
501 } else {
502 vchan_cookie_complete(&c->desc->vd);
503 bcm2835_dma_start_desc(c);
507 spin_unlock_irqrestore(&c->vc.lock, flags);
509 return IRQ_HANDLED;
512 static int bcm2835_dma_alloc_chan_resources(struct dma_chan *chan)
514 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
515 struct device *dev = c->vc.chan.device->dev;
517 dev_dbg(dev, "Allocating DMA channel %d\n", c->ch);
519 c->cb_pool = dma_pool_create(dev_name(dev), dev,
520 sizeof(struct bcm2835_dma_cb), 0, 0);
521 if (!c->cb_pool) {
522 dev_err(dev, "unable to allocate descriptor pool\n");
523 return -ENOMEM;
526 return request_irq(c->irq_number, bcm2835_dma_callback,
527 c->irq_flags, "DMA IRQ", c);
530 static void bcm2835_dma_free_chan_resources(struct dma_chan *chan)
532 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
534 vchan_free_chan_resources(&c->vc);
535 free_irq(c->irq_number, c);
536 dma_pool_destroy(c->cb_pool);
538 dev_dbg(c->vc.chan.device->dev, "Freeing DMA channel %u\n", c->ch);
541 static size_t bcm2835_dma_desc_size(struct bcm2835_desc *d)
543 return d->size;
546 static size_t bcm2835_dma_desc_size_pos(struct bcm2835_desc *d, dma_addr_t addr)
548 unsigned int i;
549 size_t size;
551 for (size = i = 0; i < d->frames; i++) {
552 struct bcm2835_dma_cb *control_block = d->cb_list[i].cb;
553 size_t this_size = control_block->length;
554 dma_addr_t dma;
556 if (d->dir == DMA_DEV_TO_MEM)
557 dma = control_block->dst;
558 else
559 dma = control_block->src;
561 if (size)
562 size += this_size;
563 else if (addr >= dma && addr < dma + this_size)
564 size += dma + this_size - addr;
567 return size;
570 static enum dma_status bcm2835_dma_tx_status(struct dma_chan *chan,
571 dma_cookie_t cookie, struct dma_tx_state *txstate)
573 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
574 struct virt_dma_desc *vd;
575 enum dma_status ret;
576 unsigned long flags;
578 ret = dma_cookie_status(chan, cookie, txstate);
579 if (ret == DMA_COMPLETE || !txstate)
580 return ret;
582 spin_lock_irqsave(&c->vc.lock, flags);
583 vd = vchan_find_desc(&c->vc, cookie);
584 if (vd) {
585 txstate->residue =
586 bcm2835_dma_desc_size(to_bcm2835_dma_desc(&vd->tx));
587 } else if (c->desc && c->desc->vd.tx.cookie == cookie) {
588 struct bcm2835_desc *d = c->desc;
589 dma_addr_t pos;
591 if (d->dir == DMA_MEM_TO_DEV)
592 pos = readl(c->chan_base + BCM2835_DMA_SOURCE_AD);
593 else if (d->dir == DMA_DEV_TO_MEM)
594 pos = readl(c->chan_base + BCM2835_DMA_DEST_AD);
595 else
596 pos = 0;
598 txstate->residue = bcm2835_dma_desc_size_pos(d, pos);
599 } else {
600 txstate->residue = 0;
603 spin_unlock_irqrestore(&c->vc.lock, flags);
605 return ret;
608 static void bcm2835_dma_issue_pending(struct dma_chan *chan)
610 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
611 unsigned long flags;
613 spin_lock_irqsave(&c->vc.lock, flags);
614 if (vchan_issue_pending(&c->vc) && !c->desc)
615 bcm2835_dma_start_desc(c);
617 spin_unlock_irqrestore(&c->vc.lock, flags);
620 static struct dma_async_tx_descriptor *bcm2835_dma_prep_dma_memcpy(
621 struct dma_chan *chan, dma_addr_t dst, dma_addr_t src,
622 size_t len, unsigned long flags)
624 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
625 struct bcm2835_desc *d;
626 u32 info = BCM2835_DMA_D_INC | BCM2835_DMA_S_INC;
627 u32 extra = BCM2835_DMA_INT_EN | BCM2835_DMA_WAIT_RESP;
628 size_t max_len = bcm2835_dma_max_frame_length(c);
629 size_t frames;
631 /* if src, dst or len is not given return with an error */
632 if (!src || !dst || !len)
633 return NULL;
635 /* calculate number of frames */
636 frames = bcm2835_dma_frames_for_length(len, max_len);
638 /* allocate the CB chain - this also fills in the pointers */
639 d = bcm2835_dma_create_cb_chain(chan, DMA_MEM_TO_MEM, false,
640 info, extra, frames,
641 src, dst, len, 0, GFP_KERNEL);
642 if (!d)
643 return NULL;
645 return vchan_tx_prep(&c->vc, &d->vd, flags);
648 static struct dma_async_tx_descriptor *bcm2835_dma_prep_slave_sg(
649 struct dma_chan *chan,
650 struct scatterlist *sgl, unsigned int sg_len,
651 enum dma_transfer_direction direction,
652 unsigned long flags, void *context)
654 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
655 struct bcm2835_desc *d;
656 dma_addr_t src = 0, dst = 0;
657 u32 info = BCM2835_DMA_WAIT_RESP;
658 u32 extra = BCM2835_DMA_INT_EN;
659 size_t frames;
661 if (!is_slave_direction(direction)) {
662 dev_err(chan->device->dev,
663 "%s: bad direction?\n", __func__);
664 return NULL;
667 if (c->dreq != 0)
668 info |= BCM2835_DMA_PER_MAP(c->dreq);
670 if (direction == DMA_DEV_TO_MEM) {
671 if (c->cfg.src_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES)
672 return NULL;
673 src = c->cfg.src_addr;
674 info |= BCM2835_DMA_S_DREQ | BCM2835_DMA_D_INC;
675 } else {
676 if (c->cfg.dst_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES)
677 return NULL;
678 dst = c->cfg.dst_addr;
679 info |= BCM2835_DMA_D_DREQ | BCM2835_DMA_S_INC;
682 /* count frames in sg list */
683 frames = bcm2835_dma_count_frames_for_sg(c, sgl, sg_len);
685 /* allocate the CB chain */
686 d = bcm2835_dma_create_cb_chain(chan, direction, false,
687 info, extra,
688 frames, src, dst, 0, 0,
689 GFP_KERNEL);
690 if (!d)
691 return NULL;
693 /* fill in frames with scatterlist pointers */
694 bcm2835_dma_fill_cb_chain_with_sg(chan, direction, d->cb_list,
695 sgl, sg_len);
697 return vchan_tx_prep(&c->vc, &d->vd, flags);
700 static struct dma_async_tx_descriptor *bcm2835_dma_prep_dma_cyclic(
701 struct dma_chan *chan, dma_addr_t buf_addr, size_t buf_len,
702 size_t period_len, enum dma_transfer_direction direction,
703 unsigned long flags)
705 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
706 struct bcm2835_desc *d;
707 dma_addr_t src, dst;
708 u32 info = BCM2835_DMA_WAIT_RESP;
709 u32 extra = BCM2835_DMA_INT_EN;
710 size_t max_len = bcm2835_dma_max_frame_length(c);
711 size_t frames;
713 /* Grab configuration */
714 if (!is_slave_direction(direction)) {
715 dev_err(chan->device->dev, "%s: bad direction?\n", __func__);
716 return NULL;
719 if (!buf_len) {
720 dev_err(chan->device->dev,
721 "%s: bad buffer length (= 0)\n", __func__);
722 return NULL;
726 * warn if buf_len is not a multiple of period_len - this may leed
727 * to unexpected latencies for interrupts and thus audiable clicks
729 if (buf_len % period_len)
730 dev_warn_once(chan->device->dev,
731 "%s: buffer_length (%zd) is not a multiple of period_len (%zd)\n",
732 __func__, buf_len, period_len);
734 /* Setup DREQ channel */
735 if (c->dreq != 0)
736 info |= BCM2835_DMA_PER_MAP(c->dreq);
738 if (direction == DMA_DEV_TO_MEM) {
739 if (c->cfg.src_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES)
740 return NULL;
741 src = c->cfg.src_addr;
742 dst = buf_addr;
743 info |= BCM2835_DMA_S_DREQ | BCM2835_DMA_D_INC;
744 } else {
745 if (c->cfg.dst_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES)
746 return NULL;
747 dst = c->cfg.dst_addr;
748 src = buf_addr;
749 info |= BCM2835_DMA_D_DREQ | BCM2835_DMA_S_INC;
752 /* calculate number of frames */
753 frames = /* number of periods */
754 DIV_ROUND_UP(buf_len, period_len) *
755 /* number of frames per period */
756 bcm2835_dma_frames_for_length(period_len, max_len);
759 * allocate the CB chain
760 * note that we need to use GFP_NOWAIT, as the ALSA i2s dmaengine
761 * implementation calls prep_dma_cyclic with interrupts disabled.
763 d = bcm2835_dma_create_cb_chain(chan, direction, true,
764 info, extra,
765 frames, src, dst, buf_len,
766 period_len, GFP_NOWAIT);
767 if (!d)
768 return NULL;
770 /* wrap around into a loop */
771 d->cb_list[d->frames - 1].cb->next = d->cb_list[0].paddr;
773 return vchan_tx_prep(&c->vc, &d->vd, flags);
776 static int bcm2835_dma_slave_config(struct dma_chan *chan,
777 struct dma_slave_config *cfg)
779 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
781 if ((cfg->direction == DMA_DEV_TO_MEM &&
782 cfg->src_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES) ||
783 (cfg->direction == DMA_MEM_TO_DEV &&
784 cfg->dst_addr_width != DMA_SLAVE_BUSWIDTH_4_BYTES) ||
785 !is_slave_direction(cfg->direction)) {
786 return -EINVAL;
789 c->cfg = *cfg;
791 return 0;
794 static int bcm2835_dma_terminate_all(struct dma_chan *chan)
796 struct bcm2835_chan *c = to_bcm2835_dma_chan(chan);
797 struct bcm2835_dmadev *d = to_bcm2835_dma_dev(c->vc.chan.device);
798 unsigned long flags;
799 int timeout = 10000;
800 LIST_HEAD(head);
802 spin_lock_irqsave(&c->vc.lock, flags);
804 /* Prevent this channel being scheduled */
805 spin_lock(&d->lock);
806 list_del_init(&c->node);
807 spin_unlock(&d->lock);
810 * Stop DMA activity: we assume the callback will not be called
811 * after bcm_dma_abort() returns (even if it does, it will see
812 * c->desc is NULL and exit.)
814 if (c->desc) {
815 bcm2835_dma_desc_free(&c->desc->vd);
816 c->desc = NULL;
817 bcm2835_dma_abort(c->chan_base);
819 /* Wait for stopping */
820 while (--timeout) {
821 if (!(readl(c->chan_base + BCM2835_DMA_CS) &
822 BCM2835_DMA_ACTIVE))
823 break;
825 cpu_relax();
828 if (!timeout)
829 dev_err(d->ddev.dev, "DMA transfer could not be terminated\n");
832 vchan_get_all_descriptors(&c->vc, &head);
833 spin_unlock_irqrestore(&c->vc.lock, flags);
834 vchan_dma_desc_free_list(&c->vc, &head);
836 return 0;
839 static int bcm2835_dma_chan_init(struct bcm2835_dmadev *d, int chan_id,
840 int irq, unsigned int irq_flags)
842 struct bcm2835_chan *c;
844 c = devm_kzalloc(d->ddev.dev, sizeof(*c), GFP_KERNEL);
845 if (!c)
846 return -ENOMEM;
848 c->vc.desc_free = bcm2835_dma_desc_free;
849 vchan_init(&c->vc, &d->ddev);
850 INIT_LIST_HEAD(&c->node);
852 c->chan_base = BCM2835_DMA_CHANIO(d->base, chan_id);
853 c->ch = chan_id;
854 c->irq_number = irq;
855 c->irq_flags = irq_flags;
857 /* check in DEBUG register if this is a LITE channel */
858 if (readl(c->chan_base + BCM2835_DMA_DEBUG) &
859 BCM2835_DMA_DEBUG_LITE)
860 c->is_lite_channel = true;
862 return 0;
865 static void bcm2835_dma_free(struct bcm2835_dmadev *od)
867 struct bcm2835_chan *c, *next;
869 list_for_each_entry_safe(c, next, &od->ddev.channels,
870 vc.chan.device_node) {
871 list_del(&c->vc.chan.device_node);
872 tasklet_kill(&c->vc.task);
876 static const struct of_device_id bcm2835_dma_of_match[] = {
877 { .compatible = "brcm,bcm2835-dma", },
880 MODULE_DEVICE_TABLE(of, bcm2835_dma_of_match);
882 static struct dma_chan *bcm2835_dma_xlate(struct of_phandle_args *spec,
883 struct of_dma *ofdma)
885 struct bcm2835_dmadev *d = ofdma->of_dma_data;
886 struct dma_chan *chan;
888 chan = dma_get_any_slave_channel(&d->ddev);
889 if (!chan)
890 return NULL;
892 /* Set DREQ from param */
893 to_bcm2835_dma_chan(chan)->dreq = spec->args[0];
895 return chan;
898 static int bcm2835_dma_probe(struct platform_device *pdev)
900 struct bcm2835_dmadev *od;
901 struct resource *res;
902 void __iomem *base;
903 int rc;
904 int i, j;
905 int irq[BCM2835_DMA_MAX_DMA_CHAN_SUPPORTED + 1];
906 int irq_flags;
907 uint32_t chans_available;
908 char chan_name[BCM2835_DMA_CHAN_NAME_SIZE];
910 if (!pdev->dev.dma_mask)
911 pdev->dev.dma_mask = &pdev->dev.coherent_dma_mask;
913 rc = dma_set_mask_and_coherent(&pdev->dev, DMA_BIT_MASK(32));
914 if (rc)
915 return rc;
917 od = devm_kzalloc(&pdev->dev, sizeof(*od), GFP_KERNEL);
918 if (!od)
919 return -ENOMEM;
921 pdev->dev.dma_parms = &od->dma_parms;
922 dma_set_max_seg_size(&pdev->dev, 0x3FFFFFFF);
924 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
925 base = devm_ioremap_resource(&pdev->dev, res);
926 if (IS_ERR(base))
927 return PTR_ERR(base);
929 od->base = base;
931 dma_cap_set(DMA_SLAVE, od->ddev.cap_mask);
932 dma_cap_set(DMA_PRIVATE, od->ddev.cap_mask);
933 dma_cap_set(DMA_CYCLIC, od->ddev.cap_mask);
934 dma_cap_set(DMA_SLAVE, od->ddev.cap_mask);
935 dma_cap_set(DMA_MEMCPY, od->ddev.cap_mask);
936 od->ddev.device_alloc_chan_resources = bcm2835_dma_alloc_chan_resources;
937 od->ddev.device_free_chan_resources = bcm2835_dma_free_chan_resources;
938 od->ddev.device_tx_status = bcm2835_dma_tx_status;
939 od->ddev.device_issue_pending = bcm2835_dma_issue_pending;
940 od->ddev.device_prep_dma_cyclic = bcm2835_dma_prep_dma_cyclic;
941 od->ddev.device_prep_slave_sg = bcm2835_dma_prep_slave_sg;
942 od->ddev.device_prep_dma_memcpy = bcm2835_dma_prep_dma_memcpy;
943 od->ddev.device_config = bcm2835_dma_slave_config;
944 od->ddev.device_terminate_all = bcm2835_dma_terminate_all;
945 od->ddev.src_addr_widths = BIT(DMA_SLAVE_BUSWIDTH_4_BYTES);
946 od->ddev.dst_addr_widths = BIT(DMA_SLAVE_BUSWIDTH_4_BYTES);
947 od->ddev.directions = BIT(DMA_DEV_TO_MEM) | BIT(DMA_MEM_TO_DEV) |
948 BIT(DMA_MEM_TO_MEM);
949 od->ddev.residue_granularity = DMA_RESIDUE_GRANULARITY_BURST;
950 od->ddev.dev = &pdev->dev;
951 INIT_LIST_HEAD(&od->ddev.channels);
952 spin_lock_init(&od->lock);
954 platform_set_drvdata(pdev, od);
956 /* Request DMA channel mask from device tree */
957 if (of_property_read_u32(pdev->dev.of_node,
958 "brcm,dma-channel-mask",
959 &chans_available)) {
960 dev_err(&pdev->dev, "Failed to get channel mask\n");
961 rc = -EINVAL;
962 goto err_no_dma;
965 /* get irqs for each channel that we support */
966 for (i = 0; i <= BCM2835_DMA_MAX_DMA_CHAN_SUPPORTED; i++) {
967 /* skip masked out channels */
968 if (!(chans_available & (1 << i))) {
969 irq[i] = -1;
970 continue;
973 /* get the named irq */
974 snprintf(chan_name, sizeof(chan_name), "dma%i", i);
975 irq[i] = platform_get_irq_byname(pdev, chan_name);
976 if (irq[i] >= 0)
977 continue;
979 /* legacy device tree case handling */
980 dev_warn_once(&pdev->dev,
981 "missing interrupt-names property in device tree - legacy interpretation is used\n");
983 * in case of channel >= 11
984 * use the 11th interrupt and that is shared
986 irq[i] = platform_get_irq(pdev, i < 11 ? i : 11);
989 /* get irqs for each channel */
990 for (i = 0; i <= BCM2835_DMA_MAX_DMA_CHAN_SUPPORTED; i++) {
991 /* skip channels without irq */
992 if (irq[i] < 0)
993 continue;
995 /* check if there are other channels that also use this irq */
996 irq_flags = 0;
997 for (j = 0; j <= BCM2835_DMA_MAX_DMA_CHAN_SUPPORTED; j++)
998 if ((i != j) && (irq[j] == irq[i])) {
999 irq_flags = IRQF_SHARED;
1000 break;
1003 /* initialize the channel */
1004 rc = bcm2835_dma_chan_init(od, i, irq[i], irq_flags);
1005 if (rc)
1006 goto err_no_dma;
1009 dev_dbg(&pdev->dev, "Initialized %i DMA channels\n", i);
1011 /* Device-tree DMA controller registration */
1012 rc = of_dma_controller_register(pdev->dev.of_node,
1013 bcm2835_dma_xlate, od);
1014 if (rc) {
1015 dev_err(&pdev->dev, "Failed to register DMA controller\n");
1016 goto err_no_dma;
1019 rc = dma_async_device_register(&od->ddev);
1020 if (rc) {
1021 dev_err(&pdev->dev,
1022 "Failed to register slave DMA engine device: %d\n", rc);
1023 goto err_no_dma;
1026 dev_dbg(&pdev->dev, "Load BCM2835 DMA engine driver\n");
1028 return 0;
1030 err_no_dma:
1031 bcm2835_dma_free(od);
1032 return rc;
1035 static int bcm2835_dma_remove(struct platform_device *pdev)
1037 struct bcm2835_dmadev *od = platform_get_drvdata(pdev);
1039 dma_async_device_unregister(&od->ddev);
1040 bcm2835_dma_free(od);
1042 return 0;
1045 static struct platform_driver bcm2835_dma_driver = {
1046 .probe = bcm2835_dma_probe,
1047 .remove = bcm2835_dma_remove,
1048 .driver = {
1049 .name = "bcm2835-dma",
1050 .of_match_table = of_match_ptr(bcm2835_dma_of_match),
1054 module_platform_driver(bcm2835_dma_driver);
1056 MODULE_ALIAS("platform:bcm2835-dma");
1057 MODULE_DESCRIPTION("BCM2835 DMA engine driver");
1058 MODULE_AUTHOR("Florian Meier <florian.meier@koalo.de>");
1059 MODULE_LICENSE("GPL v2");