1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Driver for the Atmel AHB DMA Controller (aka HDMA or DMAC on AT91 systems)
5 * Copyright (C) 2008 Atmel Corporation
6 * Copyright (C) 2022 Microchip Technology, Inc. and its subsidiaries
8 * This supports the Atmel AHB DMA Controller found in several Atmel SoCs.
9 * The only Atmel DMA Controller that is not covered by this driver is the one
10 * found on AT91SAM9263.
13 #include <dt-bindings/dma/at91.h>
14 #include <linux/bitfield.h>
15 #include <linux/clk.h>
16 #include <linux/dmaengine.h>
17 #include <linux/dmapool.h>
18 #include <linux/dma-mapping.h>
19 #include <linux/interrupt.h>
20 #include <linux/module.h>
22 #include <linux/overflow.h>
23 #include <linux/of_platform.h>
24 #include <linux/of_dma.h>
25 #include <linux/platform_device.h>
26 #include <linux/slab.h>
28 #include "dmaengine.h"
35 * at_hdmac : Name of the ATmel AHB DMA Controller
36 * at_dma_ / atdma : ATmel DMA controller entity related
37 * atc_ / atchan : ATmel DMA Channel entity related
40 #define AT_DMA_MAX_NR_CHANNELS 8
42 /* Global Configuration Register */
43 #define AT_DMA_GCFG 0x00
44 #define AT_DMA_IF_BIGEND(i) BIT((i)) /* AHB-Lite Interface i in Big-endian mode */
45 #define AT_DMA_ARB_CFG BIT(4) /* Arbiter mode. */
47 /* Controller Enable Register */
48 #define AT_DMA_EN 0x04
49 #define AT_DMA_ENABLE BIT(0)
51 /* Software Single Request Register */
52 #define AT_DMA_SREQ 0x08
53 #define AT_DMA_SSREQ(x) BIT((x) << 1) /* Request a source single transfer on channel x */
54 #define AT_DMA_DSREQ(x) BIT(1 + ((x) << 1)) /* Request a destination single transfer on channel x */
56 /* Software Chunk Transfer Request Register */
57 #define AT_DMA_CREQ 0x0c
58 #define AT_DMA_SCREQ(x) BIT((x) << 1) /* Request a source chunk transfer on channel x */
59 #define AT_DMA_DCREQ(x) BIT(1 + ((x) << 1)) /* Request a destination chunk transfer on channel x */
61 /* Software Last Transfer Flag Register */
62 #define AT_DMA_LAST 0x10
63 #define AT_DMA_SLAST(x) BIT((x) << 1) /* This src rq is last tx of buffer on channel x */
64 #define AT_DMA_DLAST(x) BIT(1 + ((x) << 1)) /* This dst rq is last tx of buffer on channel x */
66 /* Request Synchronization Register */
67 #define AT_DMA_SYNC 0x14
68 #define AT_DMA_SYR(h) BIT((h)) /* Synchronize handshake line h */
70 /* Error, Chained Buffer transfer completed and Buffer transfer completed Interrupt registers */
71 #define AT_DMA_EBCIER 0x18 /* Enable register */
72 #define AT_DMA_EBCIDR 0x1c /* Disable register */
73 #define AT_DMA_EBCIMR 0x20 /* Mask Register */
74 #define AT_DMA_EBCISR 0x24 /* Status Register */
75 #define AT_DMA_CBTC_OFFSET 8
76 #define AT_DMA_ERR_OFFSET 16
77 #define AT_DMA_BTC(x) BIT((x))
78 #define AT_DMA_CBTC(x) BIT(AT_DMA_CBTC_OFFSET + (x))
79 #define AT_DMA_ERR(x) BIT(AT_DMA_ERR_OFFSET + (x))
81 /* Channel Handler Enable Register */
82 #define AT_DMA_CHER 0x28
83 #define AT_DMA_ENA(x) BIT((x))
84 #define AT_DMA_SUSP(x) BIT(8 + (x))
85 #define AT_DMA_KEEP(x) BIT(24 + (x))
87 /* Channel Handler Disable Register */
88 #define AT_DMA_CHDR 0x2c
89 #define AT_DMA_DIS(x) BIT(x)
90 #define AT_DMA_RES(x) BIT(8 + (x))
92 /* Channel Handler Status Register */
93 #define AT_DMA_CHSR 0x30
94 #define AT_DMA_EMPT(x) BIT(16 + (x))
95 #define AT_DMA_STAL(x) BIT(24 + (x))
97 /* Channel registers base address */
98 #define AT_DMA_CH_REGS_BASE 0x3c
99 #define ch_regs(x) (AT_DMA_CH_REGS_BASE + (x) * 0x28) /* Channel x base addr */
101 /* Hardware register offset for each channel */
102 #define ATC_SADDR_OFFSET 0x00 /* Source Address Register */
103 #define ATC_DADDR_OFFSET 0x04 /* Destination Address Register */
104 #define ATC_DSCR_OFFSET 0x08 /* Descriptor Address Register */
105 #define ATC_CTRLA_OFFSET 0x0c /* Control A Register */
106 #define ATC_CTRLB_OFFSET 0x10 /* Control B Register */
107 #define ATC_CFG_OFFSET 0x14 /* Configuration Register */
108 #define ATC_SPIP_OFFSET 0x18 /* Src PIP Configuration Register */
109 #define ATC_DPIP_OFFSET 0x1c /* Dst PIP Configuration Register */
112 /* Bitfield definitions */
114 /* Bitfields in DSCR */
115 #define ATC_DSCR_IF GENMASK(1, 0) /* Dsc feched via AHB-Lite Interface */
117 /* Bitfields in CTRLA */
118 #define ATC_BTSIZE_MAX GENMASK(15, 0) /* Maximum Buffer Transfer Size */
119 #define ATC_BTSIZE GENMASK(15, 0) /* Buffer Transfer Size */
120 #define ATC_SCSIZE GENMASK(18, 16) /* Source Chunk Transfer Size */
121 #define ATC_DCSIZE GENMASK(22, 20) /* Destination Chunk Transfer Size */
122 #define ATC_SRC_WIDTH GENMASK(25, 24) /* Source Single Transfer Size */
123 #define ATC_DST_WIDTH GENMASK(29, 28) /* Destination Single Transfer Size */
124 #define ATC_DONE BIT(31) /* Tx Done (only written back in descriptor) */
126 /* Bitfields in CTRLB */
127 #define ATC_SIF GENMASK(1, 0) /* Src tx done via AHB-Lite Interface i */
128 #define ATC_DIF GENMASK(5, 4) /* Dst tx done via AHB-Lite Interface i */
129 #define AT_DMA_MEM_IF 0x0 /* interface 0 as memory interface */
130 #define AT_DMA_PER_IF 0x1 /* interface 1 as peripheral interface */
131 #define ATC_SRC_PIP BIT(8) /* Source Picture-in-Picture enabled */
132 #define ATC_DST_PIP BIT(12) /* Destination Picture-in-Picture enabled */
133 #define ATC_SRC_DSCR_DIS BIT(16) /* Src Descriptor fetch disable */
134 #define ATC_DST_DSCR_DIS BIT(20) /* Dst Descriptor fetch disable */
135 #define ATC_FC GENMASK(23, 21) /* Choose Flow Controller */
136 #define ATC_FC_MEM2MEM 0x0 /* Mem-to-Mem (DMA) */
137 #define ATC_FC_MEM2PER 0x1 /* Mem-to-Periph (DMA) */
138 #define ATC_FC_PER2MEM 0x2 /* Periph-to-Mem (DMA) */
139 #define ATC_FC_PER2PER 0x3 /* Periph-to-Periph (DMA) */
140 #define ATC_FC_PER2MEM_PER 0x4 /* Periph-to-Mem (Peripheral) */
141 #define ATC_FC_MEM2PER_PER 0x5 /* Mem-to-Periph (Peripheral) */
142 #define ATC_FC_PER2PER_SRCPER 0x6 /* Periph-to-Periph (Src Peripheral) */
143 #define ATC_FC_PER2PER_DSTPER 0x7 /* Periph-to-Periph (Dst Peripheral) */
144 #define ATC_SRC_ADDR_MODE GENMASK(25, 24)
145 #define ATC_SRC_ADDR_MODE_INCR 0x0 /* Incrementing Mode */
146 #define ATC_SRC_ADDR_MODE_DECR 0x1 /* Decrementing Mode */
147 #define ATC_SRC_ADDR_MODE_FIXED 0x2 /* Fixed Mode */
148 #define ATC_DST_ADDR_MODE GENMASK(29, 28)
149 #define ATC_DST_ADDR_MODE_INCR 0x0 /* Incrementing Mode */
150 #define ATC_DST_ADDR_MODE_DECR 0x1 /* Decrementing Mode */
151 #define ATC_DST_ADDR_MODE_FIXED 0x2 /* Fixed Mode */
152 #define ATC_IEN BIT(30) /* BTC interrupt enable (active low) */
153 #define ATC_AUTO BIT(31) /* Auto multiple buffer tx enable */
155 /* Bitfields in CFG */
156 #define ATC_SRC_PER GENMASK(3, 0) /* Channel src rq associated with periph handshaking ifc h */
157 #define ATC_DST_PER GENMASK(7, 4) /* Channel dst rq associated with periph handshaking ifc h */
158 #define ATC_SRC_REP BIT(8) /* Source Replay Mod */
159 #define ATC_SRC_H2SEL BIT(9) /* Source Handshaking Mod */
160 #define ATC_SRC_PER_MSB GENMASK(11, 10) /* Channel src rq (most significant bits) */
161 #define ATC_DST_REP BIT(12) /* Destination Replay Mod */
162 #define ATC_DST_H2SEL BIT(13) /* Destination Handshaking Mod */
163 #define ATC_DST_PER_MSB GENMASK(15, 14) /* Channel dst rq (most significant bits) */
164 #define ATC_SOD BIT(16) /* Stop On Done */
165 #define ATC_LOCK_IF BIT(20) /* Interface Lock */
166 #define ATC_LOCK_B BIT(21) /* AHB Bus Lock */
167 #define ATC_LOCK_IF_L BIT(22) /* Master Interface Arbiter Lock */
168 #define ATC_AHB_PROT GENMASK(26, 24) /* AHB Protection */
169 #define ATC_FIFOCFG GENMASK(29, 28) /* FIFO Request Configuration */
170 #define ATC_FIFOCFG_LARGESTBURST 0x0
171 #define ATC_FIFOCFG_HALFFIFO 0x1
172 #define ATC_FIFOCFG_ENOUGHSPACE 0x2
174 /* Bitfields in SPIP */
175 #define ATC_SPIP_HOLE GENMASK(15, 0)
176 #define ATC_SPIP_BOUNDARY GENMASK(25, 16)
178 /* Bitfields in DPIP */
179 #define ATC_DPIP_HOLE GENMASK(15, 0)
180 #define ATC_DPIP_BOUNDARY GENMASK(25, 16)
182 #define ATC_PER_MSB GENMASK(5, 4) /* Extract MSBs of a handshaking identifier */
183 #define ATC_SRC_PER_ID(id) \
184 ({ typeof(id) _id = (id); \
185 FIELD_PREP(ATC_SRC_PER_MSB, FIELD_GET(ATC_PER_MSB, _id)) | \
186 FIELD_PREP(ATC_SRC_PER, _id); })
187 #define ATC_DST_PER_ID(id) \
188 ({ typeof(id) _id = (id); \
189 FIELD_PREP(ATC_DST_PER_MSB, FIELD_GET(ATC_PER_MSB, _id)) | \
190 FIELD_PREP(ATC_DST_PER, _id); })
194 /*-- descriptors -----------------------------------------------------*/
196 /* LLI == Linked List Item; aka DMA buffer descriptor */
198 /* values that are not changed by hardware */
201 /* value that may get written back: */
203 /* more values that are not changed by hardware */
205 u32 dscr; /* chain to next lli */
209 * struct atdma_sg - atdma scatter gather entry
210 * @len: length of the current Linked List Item.
211 * @lli: linked list item that is passed to the DMA controller
212 * @lli_phys: physical address of the LLI.
221 * struct at_desc - software descriptor
222 * @vd: pointer to the virtual dma descriptor.
223 * @atchan: pointer to the atmel dma channel.
224 * @total_len: total transaction byte count
225 * @sg_len: number of sg entries.
229 struct virt_dma_desc vd;
230 struct at_dma_chan *atchan;
233 /* Interleaved data */
238 /* Memset temporary buffer */
240 dma_addr_t memset_paddr;
242 struct atdma_sg sg[];
245 /*-- Channels --------------------------------------------------------*/
248 * atc_status - information bits stored in channel status flag
250 * Manipulated with atomic operations.
258 * struct at_dma_chan - internal representation of an Atmel HDMAC channel
259 * @vc: virtual dma channel entry.
260 * @atdma: pointer to the driver data.
261 * @ch_regs: memory mapped register base
262 * @mask: channel index in a mask
263 * @per_if: peripheral interface
264 * @mem_if: memory interface
265 * @status: transmit status information from irq/prep* functions
266 * to tasklet (use atomic operations)
267 * @save_cfg: configuration register that is saved on suspend/resume cycle
268 * @save_dscr: for cyclic operations, preserve next descriptor address in
269 * the cyclic list on suspend/resume cycle
270 * @dma_sconfig: configuration for slave transfers, passed via
272 * @desc: pointer to the atmel dma descriptor.
275 struct virt_dma_chan vc;
276 struct at_dma *atdma;
277 void __iomem *ch_regs;
281 unsigned long status;
284 struct dma_slave_config dma_sconfig;
286 struct at_desc *desc;
289 #define channel_readl(atchan, name) \
290 __raw_readl((atchan)->ch_regs + ATC_##name##_OFFSET)
292 #define channel_writel(atchan, name, val) \
293 __raw_writel((val), (atchan)->ch_regs + ATC_##name##_OFFSET)
296 * Fix sconfig's burst size according to at_hdmac. We need to convert them as:
297 * 1 -> 0, 4 -> 1, 8 -> 2, 16 -> 3, 32 -> 4, 64 -> 5, 128 -> 6, 256 -> 7.
299 * This can be done by finding most significant bit set.
301 static inline void convert_burst(u32 *maxburst)
304 *maxburst = fls(*maxburst) - 2;
310 * Fix sconfig's bus width according to at_hdmac.
311 * 1 byte -> 0, 2 bytes -> 1, 4 bytes -> 2.
313 static inline u8 convert_buswidth(enum dma_slave_buswidth addr_width)
315 switch (addr_width) {
316 case DMA_SLAVE_BUSWIDTH_2_BYTES:
318 case DMA_SLAVE_BUSWIDTH_4_BYTES:
321 /* For 1 byte width or fallback */
326 /*-- Controller ------------------------------------------------------*/
329 * struct at_dma - internal representation of an Atmel HDMA Controller
330 * @dma_device: dmaengine dma_device object members
331 * @atdma_devtype: identifier of DMA controller compatibility
332 * @ch_regs: memory mapped register base
333 * @clk: dma controller clock
334 * @save_imr: interrupt mask register that is saved on suspend/resume cycle
335 * @all_chan_mask: all channels availlable in a mask
336 * @lli_pool: hw lli table
337 * @chan: channels table to store at_dma_chan structures
340 struct dma_device dma_device;
347 struct dma_pool *lli_pool;
348 struct dma_pool *memset_pool;
349 /* AT THE END channels table */
350 struct at_dma_chan chan[];
353 #define dma_readl(atdma, name) \
354 __raw_readl((atdma)->regs + AT_DMA_##name)
355 #define dma_writel(atdma, name, val) \
356 __raw_writel((val), (atdma)->regs + AT_DMA_##name)
358 static inline struct at_desc *to_atdma_desc(struct dma_async_tx_descriptor *t)
360 return container_of(t, struct at_desc, vd.tx);
363 static inline struct at_dma_chan *to_at_dma_chan(struct dma_chan *chan)
365 return container_of(chan, struct at_dma_chan, vc.chan);
368 static inline struct at_dma *to_at_dma(struct dma_device *ddev)
370 return container_of(ddev, struct at_dma, dma_device);
374 /*-- Helper functions ------------------------------------------------*/
376 static struct device *chan2dev(struct dma_chan *chan)
378 return &chan->dev->device;
381 #if defined(VERBOSE_DEBUG)
382 static void vdbg_dump_regs(struct at_dma_chan *atchan)
384 struct at_dma *atdma = to_at_dma(atchan->vc.chan.device);
386 dev_err(chan2dev(&atchan->vc.chan),
387 " channel %d : imr = 0x%x, chsr = 0x%x\n",
388 atchan->vc.chan.chan_id,
389 dma_readl(atdma, EBCIMR),
390 dma_readl(atdma, CHSR));
392 dev_err(chan2dev(&atchan->vc.chan),
393 " channel: s0x%x d0x%x ctrl0x%x:0x%x cfg0x%x l0x%x\n",
394 channel_readl(atchan, SADDR),
395 channel_readl(atchan, DADDR),
396 channel_readl(atchan, CTRLA),
397 channel_readl(atchan, CTRLB),
398 channel_readl(atchan, CFG),
399 channel_readl(atchan, DSCR));
402 static void vdbg_dump_regs(struct at_dma_chan *atchan) {}
405 static void atc_dump_lli(struct at_dma_chan *atchan, struct at_lli *lli)
407 dev_crit(chan2dev(&atchan->vc.chan),
408 "desc: s%pad d%pad ctrl0x%x:0x%x l%pad\n",
409 &lli->saddr, &lli->daddr,
410 lli->ctrla, lli->ctrlb, &lli->dscr);
414 static void atc_setup_irq(struct at_dma *atdma, int chan_id, int on)
418 /* enable interrupts on buffer transfer completion & error */
419 ebci = AT_DMA_BTC(chan_id)
420 | AT_DMA_ERR(chan_id);
422 dma_writel(atdma, EBCIER, ebci);
424 dma_writel(atdma, EBCIDR, ebci);
427 static void atc_enable_chan_irq(struct at_dma *atdma, int chan_id)
429 atc_setup_irq(atdma, chan_id, 1);
432 static void atc_disable_chan_irq(struct at_dma *atdma, int chan_id)
434 atc_setup_irq(atdma, chan_id, 0);
439 * atc_chan_is_enabled - test if given channel is enabled
440 * @atchan: channel we want to test status
442 static inline int atc_chan_is_enabled(struct at_dma_chan *atchan)
444 struct at_dma *atdma = to_at_dma(atchan->vc.chan.device);
446 return !!(dma_readl(atdma, CHSR) & atchan->mask);
450 * atc_chan_is_paused - test channel pause/resume status
451 * @atchan: channel we want to test status
453 static inline int atc_chan_is_paused(struct at_dma_chan *atchan)
455 return test_bit(ATC_IS_PAUSED, &atchan->status);
459 * atc_chan_is_cyclic - test if given channel has cyclic property set
460 * @atchan: channel we want to test status
462 static inline int atc_chan_is_cyclic(struct at_dma_chan *atchan)
464 return test_bit(ATC_IS_CYCLIC, &atchan->status);
468 * set_lli_eol - set end-of-link to descriptor so it will end transfer
469 * @desc: descriptor, signle or at the end of a chain, to end chain on
470 * @i: index of the atmel scatter gather entry that is at the end of the chain.
472 static void set_lli_eol(struct at_desc *desc, unsigned int i)
474 u32 ctrlb = desc->sg[i].lli->ctrlb;
477 ctrlb |= ATC_SRC_DSCR_DIS | ATC_DST_DSCR_DIS;
479 desc->sg[i].lli->ctrlb = ctrlb;
480 desc->sg[i].lli->dscr = 0;
483 #define ATC_DEFAULT_CFG FIELD_PREP(ATC_FIFOCFG, ATC_FIFOCFG_HALFFIFO)
484 #define ATC_DEFAULT_CTRLB (FIELD_PREP(ATC_SIF, AT_DMA_MEM_IF) | \
485 FIELD_PREP(ATC_DIF, AT_DMA_MEM_IF))
486 #define ATC_DMA_BUSWIDTHS\
487 (BIT(DMA_SLAVE_BUSWIDTH_UNDEFINED) |\
488 BIT(DMA_SLAVE_BUSWIDTH_1_BYTE) |\
489 BIT(DMA_SLAVE_BUSWIDTH_2_BYTES) |\
490 BIT(DMA_SLAVE_BUSWIDTH_4_BYTES))
492 #define ATC_MAX_DSCR_TRIALS 10
495 * Initial number of descriptors to allocate for each channel. This could
496 * be increased during dma usage.
498 static unsigned int init_nr_desc_per_channel = 64;
499 module_param(init_nr_desc_per_channel, uint, 0644);
500 MODULE_PARM_DESC(init_nr_desc_per_channel,
501 "initial descriptors per channel (default: 64)");
504 * struct at_dma_platform_data - Controller configuration parameters
505 * @nr_channels: Number of channels supported by hardware (max 8)
506 * @cap_mask: dma_capability flags supported by the platform
508 struct at_dma_platform_data {
509 unsigned int nr_channels;
510 dma_cap_mask_t cap_mask;
514 * struct at_dma_slave - Controller-specific information about a slave
515 * @dma_dev: required DMA master device
516 * @cfg: Platform-specific initializer for the CFG register
518 struct at_dma_slave {
519 struct device *dma_dev;
523 static inline unsigned int atc_get_xfer_width(dma_addr_t src, dma_addr_t dst,
528 if (!((src | dst | len) & 3))
530 else if (!((src | dst | len) & 1))
538 static void atdma_lli_chain(struct at_desc *desc, unsigned int i)
540 struct atdma_sg *atdma_sg = &desc->sg[i];
543 desc->sg[i - 1].lli->dscr = atdma_sg->lli_phys;
547 * atc_dostart - starts the DMA engine for real
548 * @atchan: the channel we want to start
550 static void atc_dostart(struct at_dma_chan *atchan)
552 struct virt_dma_desc *vd = vchan_next_desc(&atchan->vc);
553 struct at_desc *desc;
560 vdbg_dump_regs(atchan);
563 atchan->desc = desc = to_atdma_desc(&vd->tx);
565 channel_writel(atchan, SADDR, 0);
566 channel_writel(atchan, DADDR, 0);
567 channel_writel(atchan, CTRLA, 0);
568 channel_writel(atchan, CTRLB, 0);
569 channel_writel(atchan, DSCR, desc->sg[0].lli_phys);
570 channel_writel(atchan, SPIP,
571 FIELD_PREP(ATC_SPIP_HOLE, desc->src_hole) |
572 FIELD_PREP(ATC_SPIP_BOUNDARY, desc->boundary));
573 channel_writel(atchan, DPIP,
574 FIELD_PREP(ATC_DPIP_HOLE, desc->dst_hole) |
575 FIELD_PREP(ATC_DPIP_BOUNDARY, desc->boundary));
577 /* Don't allow CPU to reorder channel enable. */
579 dma_writel(atchan->atdma, CHER, atchan->mask);
581 vdbg_dump_regs(atchan);
584 static void atdma_desc_free(struct virt_dma_desc *vd)
586 struct at_dma *atdma = to_at_dma(vd->tx.chan->device);
587 struct at_desc *desc = to_atdma_desc(&vd->tx);
590 for (i = 0; i < desc->sglen; i++) {
592 dma_pool_free(atdma->lli_pool, desc->sg[i].lli,
593 desc->sg[i].lli_phys);
596 /* If the transfer was a memset, free our temporary buffer */
597 if (desc->memset_buffer) {
598 dma_pool_free(atdma->memset_pool, desc->memset_vaddr,
600 desc->memset_buffer = false;
607 * atc_calc_bytes_left - calculates the number of bytes left according to the
608 * value read from CTRLA.
610 * @current_len: the number of bytes left before reading CTRLA
611 * @ctrla: the value of CTRLA
613 static inline u32 atc_calc_bytes_left(u32 current_len, u32 ctrla)
615 u32 btsize = FIELD_GET(ATC_BTSIZE, ctrla);
616 u32 src_width = FIELD_GET(ATC_SRC_WIDTH, ctrla);
619 * According to the datasheet, when reading the Control A Register
620 * (ctrla), the Buffer Transfer Size (btsize) bitfield refers to the
621 * number of transfers completed on the Source Interface.
622 * So btsize is always a number of source width transfers.
624 return current_len - (btsize << src_width);
628 * atc_get_llis_residue - Get residue for a hardware linked list transfer
630 * Calculate the residue by removing the length of the Linked List Item (LLI)
631 * already transferred from the total length. To get the current LLI we can use
632 * the value of the channel's DSCR register and compare it against the DSCR
635 * The CTRLA register provides us with the amount of data already read from the
636 * source for the LLI. So we can compute a more accurate residue by also
637 * removing the number of bytes corresponding to this amount of data.
639 * However, the DSCR and CTRLA registers cannot be read both atomically. Hence a
640 * race condition may occur: the first read register may refer to one LLI
641 * whereas the second read may refer to a later LLI in the list because of the
642 * DMA transfer progression inbetween the two reads.
644 * One solution could have been to pause the DMA transfer, read the DSCR and
645 * CTRLA then resume the DMA transfer. Nonetheless, this approach presents some
647 * - If the DMA transfer is paused, RX overruns or TX underruns are more likey
648 * to occur depending on the system latency. Taking the USART driver as an
649 * example, it uses a cyclic DMA transfer to read data from the Receive
650 * Holding Register (RHR) to avoid RX overruns since the RHR is not protected
651 * by any FIFO on most Atmel SoCs. So pausing the DMA transfer to compute the
652 * residue would break the USART driver design.
653 * - The atc_pause() function masks interrupts but we'd rather avoid to do so
654 * for system latency purpose.
656 * Then we'd rather use another solution: the DSCR is read a first time, the
657 * CTRLA is read in turn, next the DSCR is read a second time. If the two
658 * consecutive read values of the DSCR are the same then we assume both refers
659 * to the very same LLI as well as the CTRLA value read inbetween does. For
660 * cyclic tranfers, the assumption is that a full loop is "not so fast". If the
661 * two DSCR values are different, we read again the CTRLA then the DSCR till two
662 * consecutive read values from DSCR are equal or till the maximum trials is
663 * reach. This algorithm is very unlikely not to find a stable value for DSCR.
664 * @atchan: pointer to an atmel hdmac channel.
665 * @desc: pointer to the descriptor for which the residue is calculated.
666 * @residue: residue to be set to dma_tx_state.
667 * Returns 0 on success, -errno otherwise.
669 static int atc_get_llis_residue(struct at_dma_chan *atchan,
670 struct at_desc *desc, u32 *residue)
672 u32 len, ctrla, dscr;
675 len = desc->total_len;
676 dscr = channel_readl(atchan, DSCR);
677 rmb(); /* ensure DSCR is read before CTRLA */
678 ctrla = channel_readl(atchan, CTRLA);
679 for (i = 0; i < ATC_MAX_DSCR_TRIALS; ++i) {
682 rmb(); /* ensure DSCR is read after CTRLA */
683 new_dscr = channel_readl(atchan, DSCR);
686 * If the DSCR register value has not changed inside the DMA
687 * controller since the previous read, we assume that both the
688 * dscr and ctrla values refers to the very same descriptor.
690 if (likely(new_dscr == dscr))
694 * DSCR has changed inside the DMA controller, so the previouly
695 * read value of CTRLA may refer to an already processed
696 * descriptor hence could be outdated. We need to update ctrla
697 * to match the current descriptor.
700 rmb(); /* ensure DSCR is read before CTRLA */
701 ctrla = channel_readl(atchan, CTRLA);
703 if (unlikely(i == ATC_MAX_DSCR_TRIALS))
706 /* For the first descriptor we can be more accurate. */
707 if (desc->sg[0].lli->dscr == dscr) {
708 *residue = atc_calc_bytes_left(len, ctrla);
711 len -= desc->sg[0].len;
713 for (i = 1; i < desc->sglen; i++) {
714 if (desc->sg[i].lli && desc->sg[i].lli->dscr == dscr)
716 len -= desc->sg[i].len;
720 * For the current LLI in the chain we can calculate the remaining bytes
721 * using the channel's CTRLA register.
723 *residue = atc_calc_bytes_left(len, ctrla);
729 * atc_get_residue - get the number of bytes residue for a cookie.
730 * The residue is passed by address and updated on success.
732 * @cookie: transaction identifier to check status of
733 * @residue: residue to be updated.
734 * Return 0 on success, -errono otherwise.
736 static int atc_get_residue(struct dma_chan *chan, dma_cookie_t cookie,
739 struct at_dma_chan *atchan = to_at_dma_chan(chan);
740 struct virt_dma_desc *vd;
741 struct at_desc *desc = NULL;
744 vd = vchan_find_desc(&atchan->vc, cookie);
746 desc = to_atdma_desc(&vd->tx);
747 else if (atchan->desc && atchan->desc->vd.tx.cookie == cookie)
753 if (desc->sg[0].lli->dscr)
754 /* hardware linked list transfer */
755 return atc_get_llis_residue(atchan, desc, residue);
757 /* single transfer */
758 len = desc->total_len;
759 ctrla = channel_readl(atchan, CTRLA);
760 *residue = atc_calc_bytes_left(len, ctrla);
765 * atc_handle_error - handle errors reported by DMA controller
766 * @atchan: channel where error occurs.
769 static void atc_handle_error(struct at_dma_chan *atchan, unsigned int i)
771 struct at_desc *desc = atchan->desc;
773 /* Disable channel on AHB error */
774 dma_writel(atchan->atdma, CHDR, AT_DMA_RES(i) | atchan->mask);
777 * KERN_CRITICAL may seem harsh, but since this only happens
778 * when someone submits a bad physical address in a
779 * descriptor, we should consider ourselves lucky that the
780 * controller flagged an error instead of scribbling over
781 * random memory locations.
783 dev_crit(chan2dev(&atchan->vc.chan), "Bad descriptor submitted for DMA!\n");
784 dev_crit(chan2dev(&atchan->vc.chan), "cookie: %d\n",
786 for (i = 0; i < desc->sglen; i++)
787 atc_dump_lli(atchan, desc->sg[i].lli);
790 static void atdma_handle_chan_done(struct at_dma_chan *atchan, u32 pending,
793 struct at_desc *desc;
795 spin_lock(&atchan->vc.lock);
799 if (pending & AT_DMA_ERR(i)) {
800 atc_handle_error(atchan, i);
801 /* Pretend the descriptor completed successfully */
804 if (atc_chan_is_cyclic(atchan)) {
805 vchan_cyclic_callback(&desc->vd);
807 vchan_cookie_complete(&desc->vd);
809 if (!(atc_chan_is_enabled(atchan)))
813 spin_unlock(&atchan->vc.lock);
816 static irqreturn_t at_dma_interrupt(int irq, void *dev_id)
818 struct at_dma *atdma = dev_id;
819 struct at_dma_chan *atchan;
821 u32 status, pending, imr;
825 imr = dma_readl(atdma, EBCIMR);
826 status = dma_readl(atdma, EBCISR);
827 pending = status & imr;
832 dev_vdbg(atdma->dma_device.dev,
833 "interrupt: status = 0x%08x, 0x%08x, 0x%08x\n",
834 status, imr, pending);
836 for (i = 0; i < atdma->dma_device.chancnt; i++) {
837 atchan = &atdma->chan[i];
838 if (!(pending & (AT_DMA_BTC(i) | AT_DMA_ERR(i))))
840 atdma_handle_chan_done(atchan, pending, i);
849 /*-- DMA Engine API --------------------------------------------------*/
851 * atc_prep_dma_interleaved - prepare memory to memory interleaved operation
852 * @chan: the channel to prepare operation on
853 * @xt: Interleaved transfer template
854 * @flags: tx descriptor status flags
856 static struct dma_async_tx_descriptor *
857 atc_prep_dma_interleaved(struct dma_chan *chan,
858 struct dma_interleaved_template *xt,
861 struct at_dma *atdma = to_at_dma(chan->device);
862 struct at_dma_chan *atchan = to_at_dma_chan(chan);
863 struct data_chunk *first;
864 struct atdma_sg *atdma_sg;
865 struct at_desc *desc;
874 if (unlikely(!xt || xt->numf != 1 || !xt->frame_size))
879 dev_info(chan2dev(chan),
880 "%s: src=%pad, dest=%pad, numf=%d, frame_size=%d, flags=0x%lx\n",
881 __func__, &xt->src_start, &xt->dst_start, xt->numf,
882 xt->frame_size, flags);
885 * The controller can only "skip" X bytes every Y bytes, so we
886 * need to make sure we are given a template that fit that
887 * description, ie a template with chunks that always have the
888 * same size, with the same ICGs.
890 for (i = 0; i < xt->frame_size; i++) {
891 struct data_chunk *chunk = xt->sgl + i;
893 if ((chunk->size != xt->sgl->size) ||
894 (dmaengine_get_dst_icg(xt, chunk) != dmaengine_get_dst_icg(xt, first)) ||
895 (dmaengine_get_src_icg(xt, chunk) != dmaengine_get_src_icg(xt, first))) {
896 dev_err(chan2dev(chan),
897 "%s: the controller can transfer only identical chunks\n",
905 dwidth = atc_get_xfer_width(xt->src_start, xt->dst_start, len);
907 xfer_count = len >> dwidth;
908 if (xfer_count > ATC_BTSIZE_MAX) {
909 dev_err(chan2dev(chan), "%s: buffer is too big\n", __func__);
913 ctrla = FIELD_PREP(ATC_SRC_WIDTH, dwidth) |
914 FIELD_PREP(ATC_DST_WIDTH, dwidth);
916 ctrlb = ATC_DEFAULT_CTRLB | ATC_IEN |
917 FIELD_PREP(ATC_SRC_ADDR_MODE, ATC_SRC_ADDR_MODE_INCR) |
918 FIELD_PREP(ATC_DST_ADDR_MODE, ATC_DST_ADDR_MODE_INCR) |
919 ATC_SRC_PIP | ATC_DST_PIP |
920 FIELD_PREP(ATC_FC, ATC_FC_MEM2MEM);
922 desc = kzalloc(struct_size(desc, sg, 1), GFP_ATOMIC);
928 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool, GFP_NOWAIT,
929 &atdma_sg->lli_phys);
930 if (!atdma_sg->lli) {
936 lli->saddr = xt->src_start;
937 lli->daddr = xt->dst_start;
938 lli->ctrla = ctrla | xfer_count;
941 desc->boundary = first->size >> dwidth;
942 desc->dst_hole = (dmaengine_get_dst_icg(xt, first) >> dwidth) + 1;
943 desc->src_hole = (dmaengine_get_src_icg(xt, first) >> dwidth) + 1;
946 desc->total_len = len;
948 set_lli_eol(desc, 0);
949 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
953 * atc_prep_dma_memcpy - prepare a memcpy operation
954 * @chan: the channel to prepare operation on
955 * @dest: operation virtual destination address
956 * @src: operation virtual source address
957 * @len: operation length
958 * @flags: tx descriptor status flags
960 static struct dma_async_tx_descriptor *
961 atc_prep_dma_memcpy(struct dma_chan *chan, dma_addr_t dest, dma_addr_t src,
962 size_t len, unsigned long flags)
964 struct at_dma *atdma = to_at_dma(chan->device);
965 struct at_dma_chan *atchan = to_at_dma_chan(chan);
966 struct at_desc *desc = NULL;
970 unsigned int src_width;
971 unsigned int dst_width;
976 dev_dbg(chan2dev(chan), "prep_dma_memcpy: d%pad s%pad l0x%zx f0x%lx\n",
977 &dest, &src, len, flags);
979 if (unlikely(!len)) {
980 dev_err(chan2dev(chan), "prep_dma_memcpy: length is zero!\n");
984 sg_len = DIV_ROUND_UP(len, ATC_BTSIZE_MAX);
985 desc = kzalloc(struct_size(desc, sg, sg_len), GFP_ATOMIC);
988 desc->sglen = sg_len;
990 ctrlb = ATC_DEFAULT_CTRLB | ATC_IEN |
991 FIELD_PREP(ATC_SRC_ADDR_MODE, ATC_SRC_ADDR_MODE_INCR) |
992 FIELD_PREP(ATC_DST_ADDR_MODE, ATC_DST_ADDR_MODE_INCR) |
993 FIELD_PREP(ATC_FC, ATC_FC_MEM2MEM);
996 * We can be a lot more clever here, but this should take care
997 * of the most common optimization.
999 src_width = dst_width = atc_get_xfer_width(src, dest, len);
1001 ctrla = FIELD_PREP(ATC_SRC_WIDTH, src_width) |
1002 FIELD_PREP(ATC_DST_WIDTH, dst_width);
1004 for (offset = 0, i = 0; offset < len;
1005 offset += xfer_count << src_width, i++) {
1006 struct atdma_sg *atdma_sg = &desc->sg[i];
1009 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool, GFP_NOWAIT,
1010 &atdma_sg->lli_phys);
1013 lli = atdma_sg->lli;
1015 xfer_count = min_t(size_t, (len - offset) >> src_width,
1018 lli->saddr = src + offset;
1019 lli->daddr = dest + offset;
1020 lli->ctrla = ctrla | xfer_count;
1023 desc->sg[i].len = xfer_count << src_width;
1025 atdma_lli_chain(desc, i);
1028 desc->total_len = len;
1030 /* set end-of-link to the last link descriptor of list*/
1031 set_lli_eol(desc, i - 1);
1033 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
1036 atdma_desc_free(&desc->vd);
1040 static int atdma_create_memset_lli(struct dma_chan *chan,
1041 struct atdma_sg *atdma_sg,
1042 dma_addr_t psrc, dma_addr_t pdst, size_t len)
1044 struct at_dma *atdma = to_at_dma(chan->device);
1047 u32 ctrla = FIELD_PREP(ATC_SRC_WIDTH, 2) | FIELD_PREP(ATC_DST_WIDTH, 2);
1048 u32 ctrlb = ATC_DEFAULT_CTRLB | ATC_IEN |
1049 FIELD_PREP(ATC_SRC_ADDR_MODE, ATC_SRC_ADDR_MODE_FIXED) |
1050 FIELD_PREP(ATC_DST_ADDR_MODE, ATC_DST_ADDR_MODE_INCR) |
1051 FIELD_PREP(ATC_FC, ATC_FC_MEM2MEM);
1053 xfer_count = len >> 2;
1054 if (xfer_count > ATC_BTSIZE_MAX) {
1055 dev_err(chan2dev(chan), "%s: buffer is too big\n", __func__);
1059 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool, GFP_NOWAIT,
1060 &atdma_sg->lli_phys);
1063 lli = atdma_sg->lli;
1067 lli->ctrla = ctrla | xfer_count;
1070 atdma_sg->len = len;
1076 * atc_prep_dma_memset - prepare a memcpy operation
1077 * @chan: the channel to prepare operation on
1078 * @dest: operation virtual destination address
1079 * @value: value to set memory buffer to
1080 * @len: operation length
1081 * @flags: tx descriptor status flags
1083 static struct dma_async_tx_descriptor *
1084 atc_prep_dma_memset(struct dma_chan *chan, dma_addr_t dest, int value,
1085 size_t len, unsigned long flags)
1087 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1088 struct at_dma *atdma = to_at_dma(chan->device);
1089 struct at_desc *desc;
1090 void __iomem *vaddr;
1095 dev_vdbg(chan2dev(chan), "%s: d%pad v0x%x l0x%zx f0x%lx\n", __func__,
1096 &dest, value, len, flags);
1098 if (unlikely(!len)) {
1099 dev_dbg(chan2dev(chan), "%s: length is zero!\n", __func__);
1103 if (!is_dma_fill_aligned(chan->device, dest, 0, len)) {
1104 dev_dbg(chan2dev(chan), "%s: buffer is not aligned\n",
1109 vaddr = dma_pool_alloc(atdma->memset_pool, GFP_NOWAIT, &paddr);
1111 dev_err(chan2dev(chan), "%s: couldn't allocate buffer\n",
1116 /* Only the first byte of value is to be used according to dmaengine */
1117 fill_pattern = (char)value;
1119 *(u32*)vaddr = (fill_pattern << 24) |
1120 (fill_pattern << 16) |
1121 (fill_pattern << 8) |
1124 desc = kzalloc(struct_size(desc, sg, 1), GFP_ATOMIC);
1126 goto err_free_buffer;
1129 ret = atdma_create_memset_lli(chan, desc->sg, paddr, dest, len);
1133 desc->memset_paddr = paddr;
1134 desc->memset_vaddr = vaddr;
1135 desc->memset_buffer = true;
1137 desc->total_len = len;
1139 /* set end-of-link on the descriptor */
1140 set_lli_eol(desc, 0);
1142 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
1147 dma_pool_free(atdma->memset_pool, vaddr, paddr);
1151 static struct dma_async_tx_descriptor *
1152 atc_prep_dma_memset_sg(struct dma_chan *chan,
1153 struct scatterlist *sgl,
1154 unsigned int sg_len, int value,
1155 unsigned long flags)
1157 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1158 struct at_dma *atdma = to_at_dma(chan->device);
1159 struct at_desc *desc;
1160 struct scatterlist *sg;
1161 void __iomem *vaddr;
1163 size_t total_len = 0;
1167 dev_vdbg(chan2dev(chan), "%s: v0x%x l0x%zx f0x%lx\n", __func__,
1168 value, sg_len, flags);
1170 if (unlikely(!sgl || !sg_len)) {
1171 dev_dbg(chan2dev(chan), "%s: scatterlist is empty!\n",
1176 vaddr = dma_pool_alloc(atdma->memset_pool, GFP_NOWAIT, &paddr);
1178 dev_err(chan2dev(chan), "%s: couldn't allocate buffer\n",
1182 *(u32*)vaddr = value;
1184 desc = kzalloc(struct_size(desc, sg, sg_len), GFP_ATOMIC);
1186 goto err_free_dma_buf;
1187 desc->sglen = sg_len;
1189 for_each_sg(sgl, sg, sg_len, i) {
1190 dma_addr_t dest = sg_dma_address(sg);
1191 size_t len = sg_dma_len(sg);
1193 dev_vdbg(chan2dev(chan), "%s: d%pad, l0x%zx\n",
1194 __func__, &dest, len);
1196 if (!is_dma_fill_aligned(chan->device, dest, 0, len)) {
1197 dev_err(chan2dev(chan), "%s: buffer is not aligned\n",
1202 ret = atdma_create_memset_lli(chan, &desc->sg[i], paddr, dest,
1207 atdma_lli_chain(desc, i);
1211 desc->memset_paddr = paddr;
1212 desc->memset_vaddr = vaddr;
1213 desc->memset_buffer = true;
1215 desc->total_len = total_len;
1217 /* set end-of-link on the descriptor */
1218 set_lli_eol(desc, i - 1);
1220 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
1223 atdma_desc_free(&desc->vd);
1225 dma_pool_free(atdma->memset_pool, vaddr, paddr);
1230 * atc_prep_slave_sg - prepare descriptors for a DMA_SLAVE transaction
1231 * @chan: DMA channel
1232 * @sgl: scatterlist to transfer to/from
1233 * @sg_len: number of entries in @scatterlist
1234 * @direction: DMA direction
1235 * @flags: tx descriptor status flags
1236 * @context: transaction context (ignored)
1238 static struct dma_async_tx_descriptor *
1239 atc_prep_slave_sg(struct dma_chan *chan, struct scatterlist *sgl,
1240 unsigned int sg_len, enum dma_transfer_direction direction,
1241 unsigned long flags, void *context)
1243 struct at_dma *atdma = to_at_dma(chan->device);
1244 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1245 struct at_dma_slave *atslave = chan->private;
1246 struct dma_slave_config *sconfig = &atchan->dma_sconfig;
1247 struct at_desc *desc;
1251 unsigned int reg_width;
1252 unsigned int mem_width;
1254 struct scatterlist *sg;
1255 size_t total_len = 0;
1257 dev_vdbg(chan2dev(chan), "prep_slave_sg (%d): %s f0x%lx\n",
1259 direction == DMA_MEM_TO_DEV ? "TO DEVICE" : "FROM DEVICE",
1262 if (unlikely(!atslave || !sg_len)) {
1263 dev_dbg(chan2dev(chan), "prep_slave_sg: sg length is zero!\n");
1267 desc = kzalloc(struct_size(desc, sg, sg_len), GFP_ATOMIC);
1270 desc->sglen = sg_len;
1272 ctrla = FIELD_PREP(ATC_SCSIZE, sconfig->src_maxburst) |
1273 FIELD_PREP(ATC_DCSIZE, sconfig->dst_maxburst);
1276 switch (direction) {
1277 case DMA_MEM_TO_DEV:
1278 reg_width = convert_buswidth(sconfig->dst_addr_width);
1279 ctrla |= FIELD_PREP(ATC_DST_WIDTH, reg_width);
1280 ctrlb |= FIELD_PREP(ATC_DST_ADDR_MODE,
1281 ATC_DST_ADDR_MODE_FIXED) |
1282 FIELD_PREP(ATC_SRC_ADDR_MODE, ATC_SRC_ADDR_MODE_INCR) |
1283 FIELD_PREP(ATC_FC, ATC_FC_MEM2PER) |
1284 FIELD_PREP(ATC_SIF, atchan->mem_if) |
1285 FIELD_PREP(ATC_DIF, atchan->per_if);
1286 reg = sconfig->dst_addr;
1287 for_each_sg(sgl, sg, sg_len, i) {
1288 struct atdma_sg *atdma_sg = &desc->sg[i];
1293 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool,
1295 &atdma_sg->lli_phys);
1298 lli = atdma_sg->lli;
1300 mem = sg_dma_address(sg);
1301 len = sg_dma_len(sg);
1302 if (unlikely(!len)) {
1303 dev_dbg(chan2dev(chan),
1304 "prep_slave_sg: sg(%d) data length is zero\n", i);
1308 if (unlikely(mem & 3 || len & 3))
1313 lli->ctrla = ctrla |
1314 FIELD_PREP(ATC_SRC_WIDTH, mem_width) |
1318 atdma_sg->len = len;
1321 desc->sg[i].len = len;
1322 atdma_lli_chain(desc, i);
1325 case DMA_DEV_TO_MEM:
1326 reg_width = convert_buswidth(sconfig->src_addr_width);
1327 ctrla |= FIELD_PREP(ATC_SRC_WIDTH, reg_width);
1328 ctrlb |= FIELD_PREP(ATC_DST_ADDR_MODE, ATC_DST_ADDR_MODE_INCR) |
1329 FIELD_PREP(ATC_SRC_ADDR_MODE,
1330 ATC_SRC_ADDR_MODE_FIXED) |
1331 FIELD_PREP(ATC_FC, ATC_FC_PER2MEM) |
1332 FIELD_PREP(ATC_SIF, atchan->per_if) |
1333 FIELD_PREP(ATC_DIF, atchan->mem_if);
1335 reg = sconfig->src_addr;
1336 for_each_sg(sgl, sg, sg_len, i) {
1337 struct atdma_sg *atdma_sg = &desc->sg[i];
1342 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool,
1344 &atdma_sg->lli_phys);
1347 lli = atdma_sg->lli;
1349 mem = sg_dma_address(sg);
1350 len = sg_dma_len(sg);
1351 if (unlikely(!len)) {
1352 dev_dbg(chan2dev(chan),
1353 "prep_slave_sg: sg(%d) data length is zero\n", i);
1357 if (unlikely(mem & 3 || len & 3))
1362 lli->ctrla = ctrla |
1363 FIELD_PREP(ATC_DST_WIDTH, mem_width) |
1367 desc->sg[i].len = len;
1370 atdma_lli_chain(desc, i);
1377 /* set end-of-link to the last link descriptor of list*/
1378 set_lli_eol(desc, i - 1);
1380 desc->total_len = total_len;
1382 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
1385 dev_err(chan2dev(chan), "not enough descriptors available\n");
1387 atdma_desc_free(&desc->vd);
1392 * atc_dma_cyclic_check_values
1393 * Check for too big/unaligned periods and unaligned DMA buffer
1396 atc_dma_cyclic_check_values(unsigned int reg_width, dma_addr_t buf_addr,
1399 if (period_len > (ATC_BTSIZE_MAX << reg_width))
1401 if (unlikely(period_len & ((1 << reg_width) - 1)))
1403 if (unlikely(buf_addr & ((1 << reg_width) - 1)))
1413 * atc_dma_cyclic_fill_desc - Fill one period descriptor
1416 atc_dma_cyclic_fill_desc(struct dma_chan *chan, struct at_desc *desc,
1417 unsigned int i, dma_addr_t buf_addr,
1418 unsigned int reg_width, size_t period_len,
1419 enum dma_transfer_direction direction)
1421 struct at_dma *atdma = to_at_dma(chan->device);
1422 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1423 struct dma_slave_config *sconfig = &atchan->dma_sconfig;
1424 struct atdma_sg *atdma_sg = &desc->sg[i];
1427 atdma_sg->lli = dma_pool_alloc(atdma->lli_pool, GFP_ATOMIC,
1428 &atdma_sg->lli_phys);
1431 lli = atdma_sg->lli;
1433 switch (direction) {
1434 case DMA_MEM_TO_DEV:
1435 lli->saddr = buf_addr + (period_len * i);
1436 lli->daddr = sconfig->dst_addr;
1437 lli->ctrlb = FIELD_PREP(ATC_DST_ADDR_MODE,
1438 ATC_DST_ADDR_MODE_FIXED) |
1439 FIELD_PREP(ATC_SRC_ADDR_MODE,
1440 ATC_SRC_ADDR_MODE_INCR) |
1441 FIELD_PREP(ATC_FC, ATC_FC_MEM2PER) |
1442 FIELD_PREP(ATC_SIF, atchan->mem_if) |
1443 FIELD_PREP(ATC_DIF, atchan->per_if);
1447 case DMA_DEV_TO_MEM:
1448 lli->saddr = sconfig->src_addr;
1449 lli->daddr = buf_addr + (period_len * i);
1450 lli->ctrlb = FIELD_PREP(ATC_DST_ADDR_MODE,
1451 ATC_DST_ADDR_MODE_INCR) |
1452 FIELD_PREP(ATC_SRC_ADDR_MODE,
1453 ATC_SRC_ADDR_MODE_FIXED) |
1454 FIELD_PREP(ATC_FC, ATC_FC_PER2MEM) |
1455 FIELD_PREP(ATC_SIF, atchan->per_if) |
1456 FIELD_PREP(ATC_DIF, atchan->mem_if);
1463 lli->ctrla = FIELD_PREP(ATC_SCSIZE, sconfig->src_maxburst) |
1464 FIELD_PREP(ATC_DCSIZE, sconfig->dst_maxburst) |
1465 FIELD_PREP(ATC_DST_WIDTH, reg_width) |
1466 FIELD_PREP(ATC_SRC_WIDTH, reg_width) |
1467 period_len >> reg_width;
1468 desc->sg[i].len = period_len;
1474 * atc_prep_dma_cyclic - prepare the cyclic DMA transfer
1475 * @chan: the DMA channel to prepare
1476 * @buf_addr: physical DMA address where the buffer starts
1477 * @buf_len: total number of bytes for the entire buffer
1478 * @period_len: number of bytes for each period
1479 * @direction: transfer direction, to or from device
1480 * @flags: tx descriptor status flags
1482 static struct dma_async_tx_descriptor *
1483 atc_prep_dma_cyclic(struct dma_chan *chan, dma_addr_t buf_addr, size_t buf_len,
1484 size_t period_len, enum dma_transfer_direction direction,
1485 unsigned long flags)
1487 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1488 struct at_dma_slave *atslave = chan->private;
1489 struct dma_slave_config *sconfig = &atchan->dma_sconfig;
1490 struct at_desc *desc;
1491 unsigned long was_cyclic;
1492 unsigned int reg_width;
1493 unsigned int periods = buf_len / period_len;
1496 dev_vdbg(chan2dev(chan), "prep_dma_cyclic: %s buf@%pad - %d (%d/%d)\n",
1497 direction == DMA_MEM_TO_DEV ? "TO DEVICE" : "FROM DEVICE",
1499 periods, buf_len, period_len);
1501 if (unlikely(!atslave || !buf_len || !period_len)) {
1502 dev_dbg(chan2dev(chan), "prep_dma_cyclic: length is zero!\n");
1506 was_cyclic = test_and_set_bit(ATC_IS_CYCLIC, &atchan->status);
1508 dev_dbg(chan2dev(chan), "prep_dma_cyclic: channel in use!\n");
1512 if (unlikely(!is_slave_direction(direction)))
1515 if (direction == DMA_MEM_TO_DEV)
1516 reg_width = convert_buswidth(sconfig->dst_addr_width);
1518 reg_width = convert_buswidth(sconfig->src_addr_width);
1520 /* Check for too big/unaligned periods and unaligned DMA buffer */
1521 if (atc_dma_cyclic_check_values(reg_width, buf_addr, period_len))
1524 desc = kzalloc(struct_size(desc, sg, periods), GFP_ATOMIC);
1527 desc->sglen = periods;
1529 /* build cyclic linked list */
1530 for (i = 0; i < periods; i++) {
1531 if (atc_dma_cyclic_fill_desc(chan, desc, i, buf_addr,
1532 reg_width, period_len, direction))
1534 atdma_lli_chain(desc, i);
1536 desc->total_len = buf_len;
1537 /* lets make a cyclic list */
1538 desc->sg[i - 1].lli->dscr = desc->sg[0].lli_phys;
1540 return vchan_tx_prep(&atchan->vc, &desc->vd, flags);
1543 atdma_desc_free(&desc->vd);
1545 clear_bit(ATC_IS_CYCLIC, &atchan->status);
1549 static int atc_config(struct dma_chan *chan,
1550 struct dma_slave_config *sconfig)
1552 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1554 dev_vdbg(chan2dev(chan), "%s\n", __func__);
1556 /* Check if it is chan is configured for slave transfers */
1560 memcpy(&atchan->dma_sconfig, sconfig, sizeof(*sconfig));
1562 convert_burst(&atchan->dma_sconfig.src_maxburst);
1563 convert_burst(&atchan->dma_sconfig.dst_maxburst);
1568 static int atc_pause(struct dma_chan *chan)
1570 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1571 struct at_dma *atdma = to_at_dma(chan->device);
1572 int chan_id = atchan->vc.chan.chan_id;
1573 unsigned long flags;
1575 dev_vdbg(chan2dev(chan), "%s\n", __func__);
1577 spin_lock_irqsave(&atchan->vc.lock, flags);
1579 dma_writel(atdma, CHER, AT_DMA_SUSP(chan_id));
1580 set_bit(ATC_IS_PAUSED, &atchan->status);
1582 spin_unlock_irqrestore(&atchan->vc.lock, flags);
1587 static int atc_resume(struct dma_chan *chan)
1589 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1590 struct at_dma *atdma = to_at_dma(chan->device);
1591 int chan_id = atchan->vc.chan.chan_id;
1592 unsigned long flags;
1594 dev_vdbg(chan2dev(chan), "%s\n", __func__);
1596 if (!atc_chan_is_paused(atchan))
1599 spin_lock_irqsave(&atchan->vc.lock, flags);
1601 dma_writel(atdma, CHDR, AT_DMA_RES(chan_id));
1602 clear_bit(ATC_IS_PAUSED, &atchan->status);
1604 spin_unlock_irqrestore(&atchan->vc.lock, flags);
1609 static int atc_terminate_all(struct dma_chan *chan)
1611 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1612 struct at_dma *atdma = to_at_dma(chan->device);
1613 int chan_id = atchan->vc.chan.chan_id;
1614 unsigned long flags;
1618 dev_vdbg(chan2dev(chan), "%s\n", __func__);
1621 * This is only called when something went wrong elsewhere, so
1622 * we don't really care about the data. Just disable the
1623 * channel. We still have to poll the channel enable bit due
1624 * to AHB/HSB limitations.
1626 spin_lock_irqsave(&atchan->vc.lock, flags);
1628 /* disabling channel: must also remove suspend state */
1629 dma_writel(atdma, CHDR, AT_DMA_RES(chan_id) | atchan->mask);
1631 /* confirm that this channel is disabled */
1632 while (dma_readl(atdma, CHSR) & atchan->mask)
1636 vchan_terminate_vdesc(&atchan->desc->vd);
1637 atchan->desc = NULL;
1640 vchan_get_all_descriptors(&atchan->vc, &list);
1642 clear_bit(ATC_IS_PAUSED, &atchan->status);
1643 /* if channel dedicated to cyclic operations, free it */
1644 clear_bit(ATC_IS_CYCLIC, &atchan->status);
1646 spin_unlock_irqrestore(&atchan->vc.lock, flags);
1648 vchan_dma_desc_free_list(&atchan->vc, &list);
1654 * atc_tx_status - poll for transaction completion
1655 * @chan: DMA channel
1656 * @cookie: transaction identifier to check status of
1657 * @txstate: if not %NULL updated with transaction state
1659 * If @txstate is passed in, upon return it reflect the driver
1660 * internal state and can be used with dma_async_is_complete() to check
1661 * the status of multiple cookies without re-checking hardware state.
1663 static enum dma_status
1664 atc_tx_status(struct dma_chan *chan,
1665 dma_cookie_t cookie,
1666 struct dma_tx_state *txstate)
1668 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1669 unsigned long flags;
1670 enum dma_status dma_status;
1674 dma_status = dma_cookie_status(chan, cookie, txstate);
1675 if (dma_status == DMA_COMPLETE || !txstate)
1678 spin_lock_irqsave(&atchan->vc.lock, flags);
1679 /* Get number of bytes left in the active transactions */
1680 ret = atc_get_residue(chan, cookie, &residue);
1681 spin_unlock_irqrestore(&atchan->vc.lock, flags);
1683 if (unlikely(ret < 0)) {
1684 dev_vdbg(chan2dev(chan), "get residual bytes error\n");
1687 dma_set_residue(txstate, residue);
1690 dev_vdbg(chan2dev(chan), "tx_status %d: cookie = %d residue = %u\n",
1691 dma_status, cookie, residue);
1696 static void atc_issue_pending(struct dma_chan *chan)
1698 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1699 unsigned long flags;
1701 spin_lock_irqsave(&atchan->vc.lock, flags);
1702 if (vchan_issue_pending(&atchan->vc) && !atchan->desc) {
1703 if (!(atc_chan_is_enabled(atchan)))
1704 atc_dostart(atchan);
1706 spin_unlock_irqrestore(&atchan->vc.lock, flags);
1710 * atc_alloc_chan_resources - allocate resources for DMA channel
1711 * @chan: allocate descriptor resources for this channel
1713 * return - the number of allocated descriptors
1715 static int atc_alloc_chan_resources(struct dma_chan *chan)
1717 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1718 struct at_dma *atdma = to_at_dma(chan->device);
1719 struct at_dma_slave *atslave;
1722 dev_vdbg(chan2dev(chan), "alloc_chan_resources\n");
1724 /* ASSERT: channel is idle */
1725 if (atc_chan_is_enabled(atchan)) {
1726 dev_dbg(chan2dev(chan), "DMA channel not idle ?\n");
1730 cfg = ATC_DEFAULT_CFG;
1732 atslave = chan->private;
1735 * We need controller-specific data to set up slave
1738 BUG_ON(!atslave->dma_dev || atslave->dma_dev != atdma->dma_device.dev);
1740 /* if cfg configuration specified take it instead of default */
1745 /* channel parameters */
1746 channel_writel(atchan, CFG, cfg);
1752 * atc_free_chan_resources - free all channel resources
1753 * @chan: DMA channel
1755 static void atc_free_chan_resources(struct dma_chan *chan)
1757 struct at_dma_chan *atchan = to_at_dma_chan(chan);
1759 BUG_ON(atc_chan_is_enabled(atchan));
1761 vchan_free_chan_resources(to_virt_chan(chan));
1765 * Free atslave allocated in at_dma_xlate()
1767 kfree(chan->private);
1768 chan->private = NULL;
1770 dev_vdbg(chan2dev(chan), "free_chan_resources: done\n");
1774 static bool at_dma_filter(struct dma_chan *chan, void *slave)
1776 struct at_dma_slave *atslave = slave;
1778 if (atslave->dma_dev == chan->device->dev) {
1779 chan->private = atslave;
1786 static struct dma_chan *at_dma_xlate(struct of_phandle_args *dma_spec,
1787 struct of_dma *of_dma)
1789 struct dma_chan *chan;
1790 struct at_dma_chan *atchan;
1791 struct at_dma_slave *atslave;
1792 dma_cap_mask_t mask;
1793 unsigned int per_id;
1794 struct platform_device *dmac_pdev;
1796 if (dma_spec->args_count != 2)
1799 dmac_pdev = of_find_device_by_node(dma_spec->np);
1804 dma_cap_set(DMA_SLAVE, mask);
1806 atslave = kmalloc(sizeof(*atslave), GFP_KERNEL);
1808 put_device(&dmac_pdev->dev);
1812 atslave->cfg = ATC_DST_H2SEL | ATC_SRC_H2SEL;
1814 * We can fill both SRC_PER and DST_PER, one of these fields will be
1815 * ignored depending on DMA transfer direction.
1817 per_id = dma_spec->args[1] & AT91_DMA_CFG_PER_ID_MASK;
1818 atslave->cfg |= ATC_DST_PER_ID(per_id) | ATC_SRC_PER_ID(per_id);
1820 * We have to translate the value we get from the device tree since
1821 * the half FIFO configuration value had to be 0 to keep backward
1824 switch (dma_spec->args[1] & AT91_DMA_CFG_FIFOCFG_MASK) {
1825 case AT91_DMA_CFG_FIFOCFG_ALAP:
1826 atslave->cfg |= FIELD_PREP(ATC_FIFOCFG,
1827 ATC_FIFOCFG_LARGESTBURST);
1829 case AT91_DMA_CFG_FIFOCFG_ASAP:
1830 atslave->cfg |= FIELD_PREP(ATC_FIFOCFG,
1831 ATC_FIFOCFG_ENOUGHSPACE);
1833 case AT91_DMA_CFG_FIFOCFG_HALF:
1835 atslave->cfg |= FIELD_PREP(ATC_FIFOCFG, ATC_FIFOCFG_HALFFIFO);
1837 atslave->dma_dev = &dmac_pdev->dev;
1839 chan = dma_request_channel(mask, at_dma_filter, atslave);
1841 put_device(&dmac_pdev->dev);
1846 atchan = to_at_dma_chan(chan);
1847 atchan->per_if = dma_spec->args[0] & 0xff;
1848 atchan->mem_if = (dma_spec->args[0] >> 16) & 0xff;
1853 static struct dma_chan *at_dma_xlate(struct of_phandle_args *dma_spec,
1854 struct of_dma *of_dma)
1860 /*-- Module Management -----------------------------------------------*/
1862 /* cap_mask is a multi-u32 bitfield, fill it with proper C code. */
1863 static struct at_dma_platform_data at91sam9rl_config = {
1866 static struct at_dma_platform_data at91sam9g45_config = {
1870 #if defined(CONFIG_OF)
1871 static const struct of_device_id atmel_dma_dt_ids[] = {
1873 .compatible = "atmel,at91sam9rl-dma",
1874 .data = &at91sam9rl_config,
1876 .compatible = "atmel,at91sam9g45-dma",
1877 .data = &at91sam9g45_config,
1883 MODULE_DEVICE_TABLE(of, atmel_dma_dt_ids);
1886 static const struct platform_device_id atdma_devtypes[] = {
1888 .name = "at91sam9rl_dma",
1889 .driver_data = (unsigned long) &at91sam9rl_config,
1891 .name = "at91sam9g45_dma",
1892 .driver_data = (unsigned long) &at91sam9g45_config,
1898 static inline const struct at_dma_platform_data * __init at_dma_get_driver_data(
1899 struct platform_device *pdev)
1901 if (pdev->dev.of_node) {
1902 const struct of_device_id *match;
1903 match = of_match_node(atmel_dma_dt_ids, pdev->dev.of_node);
1908 return (struct at_dma_platform_data *)
1909 platform_get_device_id(pdev)->driver_data;
1913 * at_dma_off - disable DMA controller
1914 * @atdma: the Atmel HDAMC device
1916 static void at_dma_off(struct at_dma *atdma)
1918 dma_writel(atdma, EN, 0);
1920 /* disable all interrupts */
1921 dma_writel(atdma, EBCIDR, -1L);
1923 /* confirm that all channels are disabled */
1924 while (dma_readl(atdma, CHSR) & atdma->all_chan_mask)
1928 static int __init at_dma_probe(struct platform_device *pdev)
1930 struct at_dma *atdma;
1934 const struct at_dma_platform_data *plat_dat;
1936 /* setup platform data for each SoC */
1937 dma_cap_set(DMA_MEMCPY, at91sam9rl_config.cap_mask);
1938 dma_cap_set(DMA_INTERLEAVE, at91sam9g45_config.cap_mask);
1939 dma_cap_set(DMA_MEMCPY, at91sam9g45_config.cap_mask);
1940 dma_cap_set(DMA_MEMSET, at91sam9g45_config.cap_mask);
1941 dma_cap_set(DMA_MEMSET_SG, at91sam9g45_config.cap_mask);
1942 dma_cap_set(DMA_PRIVATE, at91sam9g45_config.cap_mask);
1943 dma_cap_set(DMA_SLAVE, at91sam9g45_config.cap_mask);
1945 /* get DMA parameters from controller type */
1946 plat_dat = at_dma_get_driver_data(pdev);
1950 atdma = devm_kzalloc(&pdev->dev,
1951 struct_size(atdma, chan, plat_dat->nr_channels),
1956 atdma->regs = devm_platform_ioremap_resource(pdev, 0);
1957 if (IS_ERR(atdma->regs))
1958 return PTR_ERR(atdma->regs);
1960 irq = platform_get_irq(pdev, 0);
1964 /* discover transaction capabilities */
1965 atdma->dma_device.cap_mask = plat_dat->cap_mask;
1966 atdma->all_chan_mask = (1 << plat_dat->nr_channels) - 1;
1968 atdma->clk = devm_clk_get(&pdev->dev, "dma_clk");
1969 if (IS_ERR(atdma->clk))
1970 return PTR_ERR(atdma->clk);
1972 err = clk_prepare_enable(atdma->clk);
1976 /* force dma off, just in case */
1979 err = request_irq(irq, at_dma_interrupt, 0, "at_hdmac", atdma);
1983 platform_set_drvdata(pdev, atdma);
1985 /* create a pool of consistent memory blocks for hardware descriptors */
1986 atdma->lli_pool = dma_pool_create("at_hdmac_lli_pool",
1987 &pdev->dev, sizeof(struct at_lli),
1988 4 /* word alignment */, 0);
1989 if (!atdma->lli_pool) {
1990 dev_err(&pdev->dev, "Unable to allocate DMA LLI descriptor pool\n");
1992 goto err_desc_pool_create;
1995 /* create a pool of consistent memory blocks for memset blocks */
1996 atdma->memset_pool = dma_pool_create("at_hdmac_memset_pool",
1997 &pdev->dev, sizeof(int), 4, 0);
1998 if (!atdma->memset_pool) {
1999 dev_err(&pdev->dev, "No memory for memset dma pool\n");
2001 goto err_memset_pool_create;
2004 /* clear any pending interrupt */
2005 while (dma_readl(atdma, EBCISR))
2008 /* initialize channels related values */
2009 INIT_LIST_HEAD(&atdma->dma_device.channels);
2010 for (i = 0; i < plat_dat->nr_channels; i++) {
2011 struct at_dma_chan *atchan = &atdma->chan[i];
2013 atchan->mem_if = AT_DMA_MEM_IF;
2014 atchan->per_if = AT_DMA_PER_IF;
2016 atchan->ch_regs = atdma->regs + ch_regs(i);
2017 atchan->mask = 1 << i;
2019 atchan->atdma = atdma;
2020 atchan->vc.desc_free = atdma_desc_free;
2021 vchan_init(&atchan->vc, &atdma->dma_device);
2022 atc_enable_chan_irq(atdma, i);
2025 /* set base routines */
2026 atdma->dma_device.device_alloc_chan_resources = atc_alloc_chan_resources;
2027 atdma->dma_device.device_free_chan_resources = atc_free_chan_resources;
2028 atdma->dma_device.device_tx_status = atc_tx_status;
2029 atdma->dma_device.device_issue_pending = atc_issue_pending;
2030 atdma->dma_device.dev = &pdev->dev;
2032 /* set prep routines based on capability */
2033 if (dma_has_cap(DMA_INTERLEAVE, atdma->dma_device.cap_mask))
2034 atdma->dma_device.device_prep_interleaved_dma = atc_prep_dma_interleaved;
2036 if (dma_has_cap(DMA_MEMCPY, atdma->dma_device.cap_mask))
2037 atdma->dma_device.device_prep_dma_memcpy = atc_prep_dma_memcpy;
2039 if (dma_has_cap(DMA_MEMSET, atdma->dma_device.cap_mask)) {
2040 atdma->dma_device.device_prep_dma_memset = atc_prep_dma_memset;
2041 atdma->dma_device.device_prep_dma_memset_sg = atc_prep_dma_memset_sg;
2042 atdma->dma_device.fill_align = DMAENGINE_ALIGN_4_BYTES;
2045 if (dma_has_cap(DMA_SLAVE, atdma->dma_device.cap_mask)) {
2046 atdma->dma_device.device_prep_slave_sg = atc_prep_slave_sg;
2047 /* controller can do slave DMA: can trigger cyclic transfers */
2048 dma_cap_set(DMA_CYCLIC, atdma->dma_device.cap_mask);
2049 atdma->dma_device.device_prep_dma_cyclic = atc_prep_dma_cyclic;
2050 atdma->dma_device.device_config = atc_config;
2051 atdma->dma_device.device_pause = atc_pause;
2052 atdma->dma_device.device_resume = atc_resume;
2053 atdma->dma_device.device_terminate_all = atc_terminate_all;
2054 atdma->dma_device.src_addr_widths = ATC_DMA_BUSWIDTHS;
2055 atdma->dma_device.dst_addr_widths = ATC_DMA_BUSWIDTHS;
2056 atdma->dma_device.directions = BIT(DMA_DEV_TO_MEM) | BIT(DMA_MEM_TO_DEV);
2057 atdma->dma_device.residue_granularity = DMA_RESIDUE_GRANULARITY_BURST;
2060 dma_writel(atdma, EN, AT_DMA_ENABLE);
2062 dev_info(&pdev->dev, "Atmel AHB DMA Controller ( %s%s%s), %d channels\n",
2063 dma_has_cap(DMA_MEMCPY, atdma->dma_device.cap_mask) ? "cpy " : "",
2064 dma_has_cap(DMA_MEMSET, atdma->dma_device.cap_mask) ? "set " : "",
2065 dma_has_cap(DMA_SLAVE, atdma->dma_device.cap_mask) ? "slave " : "",
2066 plat_dat->nr_channels);
2068 err = dma_async_device_register(&atdma->dma_device);
2070 dev_err(&pdev->dev, "Unable to register: %d.\n", err);
2071 goto err_dma_async_device_register;
2075 * Do not return an error if the dmac node is not present in order to
2076 * not break the existing way of requesting channel with
2077 * dma_request_channel().
2079 if (pdev->dev.of_node) {
2080 err = of_dma_controller_register(pdev->dev.of_node,
2081 at_dma_xlate, atdma);
2083 dev_err(&pdev->dev, "could not register of_dma_controller\n");
2084 goto err_of_dma_controller_register;
2090 err_of_dma_controller_register:
2091 dma_async_device_unregister(&atdma->dma_device);
2092 err_dma_async_device_register:
2093 dma_pool_destroy(atdma->memset_pool);
2094 err_memset_pool_create:
2095 dma_pool_destroy(atdma->lli_pool);
2096 err_desc_pool_create:
2097 free_irq(platform_get_irq(pdev, 0), atdma);
2099 clk_disable_unprepare(atdma->clk);
2103 static int at_dma_remove(struct platform_device *pdev)
2105 struct at_dma *atdma = platform_get_drvdata(pdev);
2106 struct dma_chan *chan, *_chan;
2109 if (pdev->dev.of_node)
2110 of_dma_controller_free(pdev->dev.of_node);
2111 dma_async_device_unregister(&atdma->dma_device);
2113 dma_pool_destroy(atdma->memset_pool);
2114 dma_pool_destroy(atdma->lli_pool);
2115 free_irq(platform_get_irq(pdev, 0), atdma);
2117 list_for_each_entry_safe(chan, _chan, &atdma->dma_device.channels,
2119 /* Disable interrupts */
2120 atc_disable_chan_irq(atdma, chan->chan_id);
2121 list_del(&chan->device_node);
2124 clk_disable_unprepare(atdma->clk);
2129 static void at_dma_shutdown(struct platform_device *pdev)
2131 struct at_dma *atdma = platform_get_drvdata(pdev);
2133 at_dma_off(platform_get_drvdata(pdev));
2134 clk_disable_unprepare(atdma->clk);
2137 static int at_dma_prepare(struct device *dev)
2139 struct at_dma *atdma = dev_get_drvdata(dev);
2140 struct dma_chan *chan, *_chan;
2142 list_for_each_entry_safe(chan, _chan, &atdma->dma_device.channels,
2144 struct at_dma_chan *atchan = to_at_dma_chan(chan);
2145 /* wait for transaction completion (except in cyclic case) */
2146 if (atc_chan_is_enabled(atchan) && !atc_chan_is_cyclic(atchan))
2152 static void atc_suspend_cyclic(struct at_dma_chan *atchan)
2154 struct dma_chan *chan = &atchan->vc.chan;
2156 /* Channel should be paused by user
2157 * do it anyway even if it is not done already */
2158 if (!atc_chan_is_paused(atchan)) {
2159 dev_warn(chan2dev(chan),
2160 "cyclic channel not paused, should be done by channel user\n");
2164 /* now preserve additional data for cyclic operations */
2165 /* next descriptor address in the cyclic list */
2166 atchan->save_dscr = channel_readl(atchan, DSCR);
2168 vdbg_dump_regs(atchan);
2171 static int at_dma_suspend_noirq(struct device *dev)
2173 struct at_dma *atdma = dev_get_drvdata(dev);
2174 struct dma_chan *chan, *_chan;
2177 list_for_each_entry_safe(chan, _chan, &atdma->dma_device.channels,
2179 struct at_dma_chan *atchan = to_at_dma_chan(chan);
2181 if (atc_chan_is_cyclic(atchan))
2182 atc_suspend_cyclic(atchan);
2183 atchan->save_cfg = channel_readl(atchan, CFG);
2185 atdma->save_imr = dma_readl(atdma, EBCIMR);
2187 /* disable DMA controller */
2189 clk_disable_unprepare(atdma->clk);
2193 static void atc_resume_cyclic(struct at_dma_chan *atchan)
2195 struct at_dma *atdma = to_at_dma(atchan->vc.chan.device);
2197 /* restore channel status for cyclic descriptors list:
2198 * next descriptor in the cyclic list at the time of suspend */
2199 channel_writel(atchan, SADDR, 0);
2200 channel_writel(atchan, DADDR, 0);
2201 channel_writel(atchan, CTRLA, 0);
2202 channel_writel(atchan, CTRLB, 0);
2203 channel_writel(atchan, DSCR, atchan->save_dscr);
2204 dma_writel(atdma, CHER, atchan->mask);
2206 /* channel pause status should be removed by channel user
2207 * We cannot take the initiative to do it here */
2209 vdbg_dump_regs(atchan);
2212 static int at_dma_resume_noirq(struct device *dev)
2214 struct at_dma *atdma = dev_get_drvdata(dev);
2215 struct dma_chan *chan, *_chan;
2217 /* bring back DMA controller */
2218 clk_prepare_enable(atdma->clk);
2219 dma_writel(atdma, EN, AT_DMA_ENABLE);
2221 /* clear any pending interrupt */
2222 while (dma_readl(atdma, EBCISR))
2225 /* restore saved data */
2226 dma_writel(atdma, EBCIER, atdma->save_imr);
2227 list_for_each_entry_safe(chan, _chan, &atdma->dma_device.channels,
2229 struct at_dma_chan *atchan = to_at_dma_chan(chan);
2231 channel_writel(atchan, CFG, atchan->save_cfg);
2232 if (atc_chan_is_cyclic(atchan))
2233 atc_resume_cyclic(atchan);
2238 static const struct dev_pm_ops __maybe_unused at_dma_dev_pm_ops = {
2239 .prepare = at_dma_prepare,
2240 .suspend_noirq = at_dma_suspend_noirq,
2241 .resume_noirq = at_dma_resume_noirq,
2244 static struct platform_driver at_dma_driver = {
2245 .remove = at_dma_remove,
2246 .shutdown = at_dma_shutdown,
2247 .id_table = atdma_devtypes,
2250 .pm = pm_ptr(&at_dma_dev_pm_ops),
2251 .of_match_table = of_match_ptr(atmel_dma_dt_ids),
2255 static int __init at_dma_init(void)
2257 return platform_driver_probe(&at_dma_driver, at_dma_probe);
2259 subsys_initcall(at_dma_init);
2261 static void __exit at_dma_exit(void)
2263 platform_driver_unregister(&at_dma_driver);
2265 module_exit(at_dma_exit);
2267 MODULE_DESCRIPTION("Atmel AHB DMA Controller driver");
2268 MODULE_AUTHOR("Nicolas Ferre <nicolas.ferre@atmel.com>");
2269 MODULE_AUTHOR("Tudor Ambarus <tudor.ambarus@microchip.com>");
2270 MODULE_LICENSE("GPL");
2271 MODULE_ALIAS("platform:at_hdmac");