1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Platform driver for the Synopsys DesignWare DMA Controller
4 *
5 * Copyright (C) 2007-2008 Atmel Corporation
6 * Copyright (C) 2010-2011 ST Microelectronics
7 * Copyright (C) 2013 Intel Corporation
8 *
9 * Some parts of this driver are derived from the original dw_dmac.
10 */
11
12#include <linux/module.h>
13#include <linux/device.h>
14#include <linux/clk.h>
15#include <linux/pm_runtime.h>
16#include <linux/platform_device.h>
17#include <linux/dmaengine.h>
18#include <linux/dma-mapping.h>
19#include <linux/of.h>
20#include <linux/acpi.h>
21
22#include "internal.h"
23
24#define DRV_NAME "dw_dmac"
25
26static int dw_probe(struct platform_device *pdev)
27{
28 const struct dw_dma_chip_pdata *match;
29 struct dw_dma_chip_pdata *data;
30 struct dw_dma_chip *chip;
31 struct device *dev = &pdev->dev;
32 int err;
33
34 match = device_get_match_data(dev);
35 if (!match)
36 return -ENODEV;
37
38 data = devm_kmemdup(dev: &pdev->dev, src: match, len: sizeof(*match), GFP_KERNEL);
39 if (!data)
40 return -ENOMEM;
41
42 chip = devm_kzalloc(dev, size: sizeof(*chip), GFP_KERNEL);
43 if (!chip)
44 return -ENOMEM;
45
46 chip->irq = platform_get_irq(pdev, 0);
47 if (chip->irq < 0)
48 return chip->irq;
49
50 chip->regs = devm_platform_ioremap_resource(pdev, index: 0);
51 if (IS_ERR(ptr: chip->regs))
52 return PTR_ERR(ptr: chip->regs);
53
54 err = dma_coerce_mask_and_coherent(dev: &pdev->dev, DMA_BIT_MASK(32));
55 if (err)
56 return err;
57
58 if (!data->pdata)
59 data->pdata = dev_get_platdata(dev);
60 if (!data->pdata)
61 data->pdata = dw_dma_parse_dt(pdev);
62
63 chip->dev = dev;
64 chip->id = pdev->id;
65 chip->pdata = data->pdata;
66
67 data->chip = chip;
68
69 chip->clk = devm_clk_get_optional(dev: chip->dev, id: "hclk");
70 if (IS_ERR(ptr: chip->clk))
71 return PTR_ERR(ptr: chip->clk);
72 err = clk_prepare_enable(clk: chip->clk);
73 if (err)
74 return err;
75
76 pm_runtime_enable(dev: &pdev->dev);
77
78 err = data->probe(chip);
79 if (err)
80 goto err_dw_dma_probe;
81
82 platform_set_drvdata(pdev, data);
83
84 dw_dma_of_controller_register(dw: chip->dw);
85
86 dw_dma_acpi_controller_register(dw: chip->dw);
87
88 return 0;
89
90err_dw_dma_probe:
91 pm_runtime_disable(dev: &pdev->dev);
92 clk_disable_unprepare(clk: chip->clk);
93 return err;
94}
95
96static void dw_remove(struct platform_device *pdev)
97{
98 struct dw_dma_chip_pdata *data = platform_get_drvdata(pdev);
99 struct dw_dma_chip *chip = data->chip;
100 int ret;
101
102 dw_dma_acpi_controller_free(dw: chip->dw);
103
104 dw_dma_of_controller_free(dw: chip->dw);
105
106 ret = data->remove(chip);
107 if (ret)
108 dev_warn(chip->dev, "can't remove device properly: %d\n", ret);
109
110 pm_runtime_disable(dev: &pdev->dev);
111 clk_disable_unprepare(clk: chip->clk);
112}
113
114static void dw_shutdown(struct platform_device *pdev)
115{
116 struct dw_dma_chip_pdata *data = platform_get_drvdata(pdev);
117 struct dw_dma_chip *chip = data->chip;
118
119 /*
120 * We have to call do_dw_dma_disable() to stop any ongoing transfer. On
121 * some platforms we can't do that since DMA device is powered off.
122 * Moreover we have no possibility to check if the platform is affected
123 * or not. That's why we call pm_runtime_get_sync() / pm_runtime_put()
124 * unconditionally. On the other hand we can't use
125 * pm_runtime_suspended() because runtime PM framework is not fully
126 * used by the driver.
127 */
128 pm_runtime_get_sync(dev: chip->dev);
129 do_dw_dma_disable(chip);
130 pm_runtime_put_sync_suspend(dev: chip->dev);
131
132 clk_disable_unprepare(clk: chip->clk);
133}
134
135#ifdef CONFIG_OF
136static const struct of_device_id dw_dma_of_id_table[] = {
137 { .compatible = "snps,dma-spear1340", .data = &dw_dma_chip_pdata },
138 { .compatible = "renesas,rzn1-dma", .data = &dw_dma_chip_pdata },
139 {}
140};
141MODULE_DEVICE_TABLE(of, dw_dma_of_id_table);
142#endif
143
144#ifdef CONFIG_ACPI
145static const struct acpi_device_id dw_dma_acpi_id_table[] = {
146 { "INTL9C60", (kernel_ulong_t)&dw_dma_chip_pdata },
147 { "80862286", (kernel_ulong_t)&dw_dma_chip_pdata },
148 { "808622C0", (kernel_ulong_t)&dw_dma_chip_pdata },
149
150 /* Elkhart Lake iDMA 32-bit (PSE DMA) */
151 { "80864BB4", (kernel_ulong_t)&xbar_chip_pdata },
152 { "80864BB5", (kernel_ulong_t)&xbar_chip_pdata },
153 { "80864BB6", (kernel_ulong_t)&xbar_chip_pdata },
154
155 { }
156};
157MODULE_DEVICE_TABLE(acpi, dw_dma_acpi_id_table);
158#endif
159
160#ifdef CONFIG_PM_SLEEP
161
162static int dw_suspend_late(struct device *dev)
163{
164 struct dw_dma_chip_pdata *data = dev_get_drvdata(dev);
165 struct dw_dma_chip *chip = data->chip;
166
167 do_dw_dma_disable(chip);
168 clk_disable_unprepare(clk: chip->clk);
169
170 return 0;
171}
172
173static int dw_resume_early(struct device *dev)
174{
175 struct dw_dma_chip_pdata *data = dev_get_drvdata(dev);
176 struct dw_dma_chip *chip = data->chip;
177 int ret;
178
179 ret = clk_prepare_enable(clk: chip->clk);
180 if (ret)
181 return ret;
182
183 return do_dw_dma_enable(chip);
184}
185
186#endif /* CONFIG_PM_SLEEP */
187
188static const struct dev_pm_ops dw_dev_pm_ops = {
189 SET_LATE_SYSTEM_SLEEP_PM_OPS(dw_suspend_late, dw_resume_early)
190};
191
192static struct platform_driver dw_driver = {
193 .probe = dw_probe,
194 .remove_new = dw_remove,
195 .shutdown = dw_shutdown,
196 .driver = {
197 .name = DRV_NAME,
198 .pm = &dw_dev_pm_ops,
199 .of_match_table = of_match_ptr(dw_dma_of_id_table),
200 .acpi_match_table = ACPI_PTR(dw_dma_acpi_id_table),
201 },
202};
203
204static int __init dw_init(void)
205{
206 return platform_driver_register(&dw_driver);
207}
208subsys_initcall(dw_init);
209
210static void __exit dw_exit(void)
211{
212 platform_driver_unregister(&dw_driver);
213}
214module_exit(dw_exit);
215
216MODULE_LICENSE("GPL v2");
217MODULE_DESCRIPTION("Synopsys DesignWare DMA Controller platform driver");
218MODULE_ALIAS("platform:" DRV_NAME);
219

source code of linux/drivers/dma/dw/platform.c