1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * drivers/dma/fsl-edma.c
5 * Copyright 2013-2014 Freescale Semiconductor, Inc.
7 * Driver for the Freescale eDMA engine with flexible channel multiplexing
8 * capability for DMA request sources. The eDMA block can be found on some
9 * Vybrid and Layerscape SoCs.
12 #include <linux/module.h>
13 #include <linux/interrupt.h>
14 #include <linux/clk.h>
16 #include <linux/of_device.h>
17 #include <linux/of_address.h>
18 #include <linux/of_irq.h>
19 #include <linux/of_dma.h>
21 #include "fsl-edma-common.h"
23 static void fsl_edma_synchronize(struct dma_chan
*chan
)
25 struct fsl_edma_chan
*fsl_chan
= to_fsl_edma_chan(chan
);
27 vchan_synchronize(&fsl_chan
->vchan
);
30 static irqreturn_t
fsl_edma_tx_handler(int irq
, void *dev_id
)
32 struct fsl_edma_engine
*fsl_edma
= dev_id
;
33 unsigned int intr
, ch
;
34 struct edma_regs
*regs
= &fsl_edma
->regs
;
35 struct fsl_edma_chan
*fsl_chan
;
37 intr
= edma_readl(fsl_edma
, regs
->intl
);
41 for (ch
= 0; ch
< fsl_edma
->n_chans
; ch
++) {
42 if (intr
& (0x1 << ch
)) {
43 edma_writeb(fsl_edma
, EDMA_CINT_CINT(ch
), regs
->cint
);
45 fsl_chan
= &fsl_edma
->chans
[ch
];
47 spin_lock(&fsl_chan
->vchan
.lock
);
49 if (!fsl_chan
->edesc
) {
50 /* terminate_all called before */
51 spin_unlock(&fsl_chan
->vchan
.lock
);
55 if (!fsl_chan
->edesc
->iscyclic
) {
56 list_del(&fsl_chan
->edesc
->vdesc
.node
);
57 vchan_cookie_complete(&fsl_chan
->edesc
->vdesc
);
58 fsl_chan
->edesc
= NULL
;
59 fsl_chan
->status
= DMA_COMPLETE
;
60 fsl_chan
->idle
= true;
62 vchan_cyclic_callback(&fsl_chan
->edesc
->vdesc
);
66 fsl_edma_xfer_desc(fsl_chan
);
68 spin_unlock(&fsl_chan
->vchan
.lock
);
74 static irqreturn_t
fsl_edma_err_handler(int irq
, void *dev_id
)
76 struct fsl_edma_engine
*fsl_edma
= dev_id
;
78 struct edma_regs
*regs
= &fsl_edma
->regs
;
80 err
= edma_readl(fsl_edma
, regs
->errl
);
84 for (ch
= 0; ch
< fsl_edma
->n_chans
; ch
++) {
85 if (err
& (0x1 << ch
)) {
86 fsl_edma_disable_request(&fsl_edma
->chans
[ch
]);
87 edma_writeb(fsl_edma
, EDMA_CERR_CERR(ch
), regs
->cerr
);
88 fsl_edma
->chans
[ch
].status
= DMA_ERROR
;
89 fsl_edma
->chans
[ch
].idle
= true;
95 static irqreturn_t
fsl_edma_irq_handler(int irq
, void *dev_id
)
97 if (fsl_edma_tx_handler(irq
, dev_id
) == IRQ_HANDLED
)
100 return fsl_edma_err_handler(irq
, dev_id
);
103 static struct dma_chan
*fsl_edma_xlate(struct of_phandle_args
*dma_spec
,
104 struct of_dma
*ofdma
)
106 struct fsl_edma_engine
*fsl_edma
= ofdma
->of_dma_data
;
107 struct dma_chan
*chan
, *_chan
;
108 struct fsl_edma_chan
*fsl_chan
;
109 u32 dmamux_nr
= fsl_edma
->drvdata
->dmamuxs
;
110 unsigned long chans_per_mux
= fsl_edma
->n_chans
/ dmamux_nr
;
112 if (dma_spec
->args_count
!= 2)
115 mutex_lock(&fsl_edma
->fsl_edma_mutex
);
116 list_for_each_entry_safe(chan
, _chan
, &fsl_edma
->dma_dev
.channels
, device_node
) {
117 if (chan
->client_count
)
119 if ((chan
->chan_id
/ chans_per_mux
) == dma_spec
->args
[0]) {
120 chan
= dma_get_slave_channel(chan
);
122 chan
->device
->privatecnt
++;
123 fsl_chan
= to_fsl_edma_chan(chan
);
124 fsl_chan
->slave_id
= dma_spec
->args
[1];
125 fsl_edma_chan_mux(fsl_chan
, fsl_chan
->slave_id
,
127 mutex_unlock(&fsl_edma
->fsl_edma_mutex
);
132 mutex_unlock(&fsl_edma
->fsl_edma_mutex
);
137 fsl_edma_irq_init(struct platform_device
*pdev
, struct fsl_edma_engine
*fsl_edma
)
141 fsl_edma
->txirq
= platform_get_irq_byname(pdev
, "edma-tx");
142 if (fsl_edma
->txirq
< 0)
143 return fsl_edma
->txirq
;
145 fsl_edma
->errirq
= platform_get_irq_byname(pdev
, "edma-err");
146 if (fsl_edma
->errirq
< 0)
147 return fsl_edma
->errirq
;
149 if (fsl_edma
->txirq
== fsl_edma
->errirq
) {
150 ret
= devm_request_irq(&pdev
->dev
, fsl_edma
->txirq
,
151 fsl_edma_irq_handler
, 0, "eDMA", fsl_edma
);
153 dev_err(&pdev
->dev
, "Can't register eDMA IRQ.\n");
157 ret
= devm_request_irq(&pdev
->dev
, fsl_edma
->txirq
,
158 fsl_edma_tx_handler
, 0, "eDMA tx", fsl_edma
);
160 dev_err(&pdev
->dev
, "Can't register eDMA tx IRQ.\n");
164 ret
= devm_request_irq(&pdev
->dev
, fsl_edma
->errirq
,
165 fsl_edma_err_handler
, 0, "eDMA err", fsl_edma
);
167 dev_err(&pdev
->dev
, "Can't register eDMA err IRQ.\n");
176 fsl_edma2_irq_init(struct platform_device
*pdev
,
177 struct fsl_edma_engine
*fsl_edma
)
182 count
= platform_irq_count(pdev
);
183 dev_dbg(&pdev
->dev
, "%s Found %d interrupts\r\n", __func__
, count
);
185 dev_err(&pdev
->dev
, "Interrupts in DTS not correct.\n");
189 * 16 channel independent interrupts + 1 error interrupt on i.mx7ulp.
190 * 2 channel share one interrupt, for example, ch0/ch16, ch1/ch17...
191 * For now, just simply request irq without IRQF_SHARED flag, since 16
192 * channels are enough on i.mx7ulp whose M4 domain own some peripherals.
194 for (i
= 0; i
< count
; i
++) {
195 irq
= platform_get_irq(pdev
, i
);
199 sprintf(fsl_edma
->chans
[i
].chan_name
, "eDMA2-CH%02d", i
);
201 /* The last IRQ is for eDMA err */
203 ret
= devm_request_irq(&pdev
->dev
, irq
,
204 fsl_edma_err_handler
,
205 0, "eDMA2-ERR", fsl_edma
);
207 ret
= devm_request_irq(&pdev
->dev
, irq
,
208 fsl_edma_tx_handler
, 0,
209 fsl_edma
->chans
[i
].chan_name
,
218 static void fsl_edma_irq_exit(
219 struct platform_device
*pdev
, struct fsl_edma_engine
*fsl_edma
)
221 if (fsl_edma
->txirq
== fsl_edma
->errirq
) {
222 devm_free_irq(&pdev
->dev
, fsl_edma
->txirq
, fsl_edma
);
224 devm_free_irq(&pdev
->dev
, fsl_edma
->txirq
, fsl_edma
);
225 devm_free_irq(&pdev
->dev
, fsl_edma
->errirq
, fsl_edma
);
229 static void fsl_disable_clocks(struct fsl_edma_engine
*fsl_edma
, int nr_clocks
)
233 for (i
= 0; i
< nr_clocks
; i
++)
234 clk_disable_unprepare(fsl_edma
->muxclk
[i
]);
237 static struct fsl_edma_drvdata vf610_data
= {
239 .dmamuxs
= DMAMUX_NR
,
240 .setup_irq
= fsl_edma_irq_init
,
243 static struct fsl_edma_drvdata ls1028a_data
= {
245 .dmamuxs
= DMAMUX_NR
,
247 .setup_irq
= fsl_edma_irq_init
,
250 static struct fsl_edma_drvdata imx7ulp_data
= {
254 .setup_irq
= fsl_edma2_irq_init
,
257 static const struct of_device_id fsl_edma_dt_ids
[] = {
258 { .compatible
= "fsl,vf610-edma", .data
= &vf610_data
},
259 { .compatible
= "fsl,ls1028a-edma", .data
= &ls1028a_data
},
260 { .compatible
= "fsl,imx7ulp-edma", .data
= &imx7ulp_data
},
263 MODULE_DEVICE_TABLE(of
, fsl_edma_dt_ids
);
265 static int fsl_edma_probe(struct platform_device
*pdev
)
267 const struct of_device_id
*of_id
=
268 of_match_device(fsl_edma_dt_ids
, &pdev
->dev
);
269 struct device_node
*np
= pdev
->dev
.of_node
;
270 struct fsl_edma_engine
*fsl_edma
;
271 const struct fsl_edma_drvdata
*drvdata
= NULL
;
272 struct fsl_edma_chan
*fsl_chan
;
273 struct edma_regs
*regs
;
274 struct resource
*res
;
279 drvdata
= of_id
->data
;
281 dev_err(&pdev
->dev
, "unable to find driver data\n");
285 ret
= of_property_read_u32(np
, "dma-channels", &chans
);
287 dev_err(&pdev
->dev
, "Can't get dma-channels.\n");
291 len
= sizeof(*fsl_edma
) + sizeof(*fsl_chan
) * chans
;
292 fsl_edma
= devm_kzalloc(&pdev
->dev
, len
, GFP_KERNEL
);
296 fsl_edma
->drvdata
= drvdata
;
297 fsl_edma
->n_chans
= chans
;
298 mutex_init(&fsl_edma
->fsl_edma_mutex
);
300 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
301 fsl_edma
->membase
= devm_ioremap_resource(&pdev
->dev
, res
);
302 if (IS_ERR(fsl_edma
->membase
))
303 return PTR_ERR(fsl_edma
->membase
);
305 fsl_edma_setup_regs(fsl_edma
);
306 regs
= &fsl_edma
->regs
;
308 if (drvdata
->has_dmaclk
) {
309 fsl_edma
->dmaclk
= devm_clk_get(&pdev
->dev
, "dma");
310 if (IS_ERR(fsl_edma
->dmaclk
)) {
311 dev_err(&pdev
->dev
, "Missing DMA block clock.\n");
312 return PTR_ERR(fsl_edma
->dmaclk
);
315 ret
= clk_prepare_enable(fsl_edma
->dmaclk
);
317 dev_err(&pdev
->dev
, "DMA clk block failed.\n");
322 for (i
= 0; i
< fsl_edma
->drvdata
->dmamuxs
; i
++) {
325 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 1 + i
);
326 fsl_edma
->muxbase
[i
] = devm_ioremap_resource(&pdev
->dev
, res
);
327 if (IS_ERR(fsl_edma
->muxbase
[i
])) {
328 /* on error: disable all previously enabled clks */
329 fsl_disable_clocks(fsl_edma
, i
);
330 return PTR_ERR(fsl_edma
->muxbase
[i
]);
333 sprintf(clkname
, "dmamux%d", i
);
334 fsl_edma
->muxclk
[i
] = devm_clk_get(&pdev
->dev
, clkname
);
335 if (IS_ERR(fsl_edma
->muxclk
[i
])) {
336 dev_err(&pdev
->dev
, "Missing DMAMUX block clock.\n");
337 /* on error: disable all previously enabled clks */
338 fsl_disable_clocks(fsl_edma
, i
);
339 return PTR_ERR(fsl_edma
->muxclk
[i
]);
342 ret
= clk_prepare_enable(fsl_edma
->muxclk
[i
]);
344 /* on error: disable all previously enabled clks */
345 fsl_disable_clocks(fsl_edma
, i
);
349 fsl_edma
->big_endian
= of_property_read_bool(np
, "big-endian");
351 INIT_LIST_HEAD(&fsl_edma
->dma_dev
.channels
);
352 for (i
= 0; i
< fsl_edma
->n_chans
; i
++) {
353 struct fsl_edma_chan
*fsl_chan
= &fsl_edma
->chans
[i
];
355 fsl_chan
->edma
= fsl_edma
;
356 fsl_chan
->pm_state
= RUNNING
;
357 fsl_chan
->slave_id
= 0;
358 fsl_chan
->idle
= true;
359 fsl_chan
->dma_dir
= DMA_NONE
;
360 fsl_chan
->vchan
.desc_free
= fsl_edma_free_desc
;
361 vchan_init(&fsl_chan
->vchan
, &fsl_edma
->dma_dev
);
363 edma_writew(fsl_edma
, 0x0, ®s
->tcd
[i
].csr
);
364 fsl_edma_chan_mux(fsl_chan
, 0, false);
367 edma_writel(fsl_edma
, ~0, regs
->intl
);
368 ret
= fsl_edma
->drvdata
->setup_irq(pdev
, fsl_edma
);
372 dma_cap_set(DMA_PRIVATE
, fsl_edma
->dma_dev
.cap_mask
);
373 dma_cap_set(DMA_SLAVE
, fsl_edma
->dma_dev
.cap_mask
);
374 dma_cap_set(DMA_CYCLIC
, fsl_edma
->dma_dev
.cap_mask
);
376 fsl_edma
->dma_dev
.dev
= &pdev
->dev
;
377 fsl_edma
->dma_dev
.device_alloc_chan_resources
378 = fsl_edma_alloc_chan_resources
;
379 fsl_edma
->dma_dev
.device_free_chan_resources
380 = fsl_edma_free_chan_resources
;
381 fsl_edma
->dma_dev
.device_tx_status
= fsl_edma_tx_status
;
382 fsl_edma
->dma_dev
.device_prep_slave_sg
= fsl_edma_prep_slave_sg
;
383 fsl_edma
->dma_dev
.device_prep_dma_cyclic
= fsl_edma_prep_dma_cyclic
;
384 fsl_edma
->dma_dev
.device_config
= fsl_edma_slave_config
;
385 fsl_edma
->dma_dev
.device_pause
= fsl_edma_pause
;
386 fsl_edma
->dma_dev
.device_resume
= fsl_edma_resume
;
387 fsl_edma
->dma_dev
.device_terminate_all
= fsl_edma_terminate_all
;
388 fsl_edma
->dma_dev
.device_synchronize
= fsl_edma_synchronize
;
389 fsl_edma
->dma_dev
.device_issue_pending
= fsl_edma_issue_pending
;
391 fsl_edma
->dma_dev
.src_addr_widths
= FSL_EDMA_BUSWIDTHS
;
392 fsl_edma
->dma_dev
.dst_addr_widths
= FSL_EDMA_BUSWIDTHS
;
393 fsl_edma
->dma_dev
.directions
= BIT(DMA_DEV_TO_MEM
) | BIT(DMA_MEM_TO_DEV
);
395 platform_set_drvdata(pdev
, fsl_edma
);
397 ret
= dma_async_device_register(&fsl_edma
->dma_dev
);
400 "Can't register Freescale eDMA engine. (%d)\n", ret
);
401 fsl_disable_clocks(fsl_edma
, fsl_edma
->drvdata
->dmamuxs
);
405 ret
= of_dma_controller_register(np
, fsl_edma_xlate
, fsl_edma
);
408 "Can't register Freescale eDMA of_dma. (%d)\n", ret
);
409 dma_async_device_unregister(&fsl_edma
->dma_dev
);
410 fsl_disable_clocks(fsl_edma
, fsl_edma
->drvdata
->dmamuxs
);
414 /* enable round robin arbitration */
415 edma_writel(fsl_edma
, EDMA_CR_ERGA
| EDMA_CR_ERCA
, regs
->cr
);
420 static int fsl_edma_remove(struct platform_device
*pdev
)
422 struct device_node
*np
= pdev
->dev
.of_node
;
423 struct fsl_edma_engine
*fsl_edma
= platform_get_drvdata(pdev
);
425 fsl_edma_irq_exit(pdev
, fsl_edma
);
426 fsl_edma_cleanup_vchan(&fsl_edma
->dma_dev
);
427 of_dma_controller_free(np
);
428 dma_async_device_unregister(&fsl_edma
->dma_dev
);
429 fsl_disable_clocks(fsl_edma
, fsl_edma
->drvdata
->dmamuxs
);
434 static int fsl_edma_suspend_late(struct device
*dev
)
436 struct fsl_edma_engine
*fsl_edma
= dev_get_drvdata(dev
);
437 struct fsl_edma_chan
*fsl_chan
;
441 for (i
= 0; i
< fsl_edma
->n_chans
; i
++) {
442 fsl_chan
= &fsl_edma
->chans
[i
];
443 spin_lock_irqsave(&fsl_chan
->vchan
.lock
, flags
);
444 /* Make sure chan is idle or will force disable. */
445 if (unlikely(!fsl_chan
->idle
)) {
446 dev_warn(dev
, "WARN: There is non-idle channel.");
447 fsl_edma_disable_request(fsl_chan
);
448 fsl_edma_chan_mux(fsl_chan
, 0, false);
451 fsl_chan
->pm_state
= SUSPENDED
;
452 spin_unlock_irqrestore(&fsl_chan
->vchan
.lock
, flags
);
458 static int fsl_edma_resume_early(struct device
*dev
)
460 struct fsl_edma_engine
*fsl_edma
= dev_get_drvdata(dev
);
461 struct fsl_edma_chan
*fsl_chan
;
462 struct edma_regs
*regs
= &fsl_edma
->regs
;
465 for (i
= 0; i
< fsl_edma
->n_chans
; i
++) {
466 fsl_chan
= &fsl_edma
->chans
[i
];
467 fsl_chan
->pm_state
= RUNNING
;
468 edma_writew(fsl_edma
, 0x0, ®s
->tcd
[i
].csr
);
469 if (fsl_chan
->slave_id
!= 0)
470 fsl_edma_chan_mux(fsl_chan
, fsl_chan
->slave_id
, true);
473 edma_writel(fsl_edma
, EDMA_CR_ERGA
| EDMA_CR_ERCA
, regs
->cr
);
479 * eDMA provides the service to others, so it should be suspend late
480 * and resume early. When eDMA suspend, all of the clients should stop
481 * the DMA data transmission and let the channel idle.
483 static const struct dev_pm_ops fsl_edma_pm_ops
= {
484 .suspend_late
= fsl_edma_suspend_late
,
485 .resume_early
= fsl_edma_resume_early
,
488 static struct platform_driver fsl_edma_driver
= {
491 .of_match_table
= fsl_edma_dt_ids
,
492 .pm
= &fsl_edma_pm_ops
,
494 .probe
= fsl_edma_probe
,
495 .remove
= fsl_edma_remove
,
498 static int __init
fsl_edma_init(void)
500 return platform_driver_register(&fsl_edma_driver
);
502 subsys_initcall(fsl_edma_init
);
504 static void __exit
fsl_edma_exit(void)
506 platform_driver_unregister(&fsl_edma_driver
);
508 module_exit(fsl_edma_exit
);
510 MODULE_ALIAS("platform:fsl-edma");
511 MODULE_DESCRIPTION("Freescale eDMA engine driver");
512 MODULE_LICENSE("GPL v2");