1 // SPDX-License-Identifier: GPL-2.0-only
3 * Qualcomm Technologies HIDMA DMA engine Management interface
5 * Copyright (c) 2015-2017, The Linux Foundation. All rights reserved.
8 #include <linux/dmaengine.h>
9 #include <linux/acpi.h>
11 #include <linux/property.h>
12 #include <linux/of_address.h>
13 #include <linux/of_irq.h>
14 #include <linux/of_platform.h>
15 #include <linux/of_device.h>
16 #include <linux/platform_device.h>
17 #include <linux/module.h>
18 #include <linux/uaccess.h>
19 #include <linux/slab.h>
20 #include <linux/pm_runtime.h>
21 #include <linux/bitops.h>
22 #include <linux/dma-mapping.h>
24 #include "hidma_mgmt.h"
26 #define HIDMA_QOS_N_OFFSET 0x700
27 #define HIDMA_CFG_OFFSET 0x400
28 #define HIDMA_MAX_BUS_REQ_LEN_OFFSET 0x41C
29 #define HIDMA_MAX_XACTIONS_OFFSET 0x420
30 #define HIDMA_HW_VERSION_OFFSET 0x424
31 #define HIDMA_CHRESET_TIMEOUT_OFFSET 0x418
33 #define HIDMA_MAX_WR_XACTIONS_MASK GENMASK(4, 0)
34 #define HIDMA_MAX_RD_XACTIONS_MASK GENMASK(4, 0)
35 #define HIDMA_WEIGHT_MASK GENMASK(6, 0)
36 #define HIDMA_MAX_BUS_REQ_LEN_MASK GENMASK(15, 0)
37 #define HIDMA_CHRESET_TIMEOUT_MASK GENMASK(19, 0)
39 #define HIDMA_MAX_WR_XACTIONS_BIT_POS 16
40 #define HIDMA_MAX_BUS_WR_REQ_BIT_POS 16
41 #define HIDMA_WRR_BIT_POS 8
42 #define HIDMA_PRIORITY_BIT_POS 15
44 #define HIDMA_AUTOSUSPEND_TIMEOUT 2000
45 #define HIDMA_MAX_CHANNEL_WEIGHT 15
47 static unsigned int max_write_request;
48 module_param(max_write_request, uint, 0644);
49 MODULE_PARM_DESC(max_write_request,
50 "maximum write burst (default: ACPI/DT value)");
52 static unsigned int max_read_request;
53 module_param(max_read_request, uint, 0644);
54 MODULE_PARM_DESC(max_read_request,
55 "maximum read burst (default: ACPI/DT value)");
57 static unsigned int max_wr_xactions;
58 module_param(max_wr_xactions, uint, 0644);
59 MODULE_PARM_DESC(max_wr_xactions,
60 "maximum number of write transactions (default: ACPI/DT value)");
62 static unsigned int max_rd_xactions;
63 module_param(max_rd_xactions, uint, 0644);
64 MODULE_PARM_DESC(max_rd_xactions,
65 "maximum number of read transactions (default: ACPI/DT value)");
67 int hidma_mgmt_setup(struct hidma_mgmt_dev *mgmtdev)
72 if (!is_power_of_2(mgmtdev->max_write_request) ||
73 (mgmtdev->max_write_request < 128) ||
74 (mgmtdev->max_write_request > 1024)) {
75 dev_err(&mgmtdev->pdev->dev, "invalid write request %d\n",
76 mgmtdev->max_write_request);
80 if (!is_power_of_2(mgmtdev->max_read_request) ||
81 (mgmtdev->max_read_request < 128) ||
82 (mgmtdev->max_read_request > 1024)) {
83 dev_err(&mgmtdev->pdev->dev, "invalid read request %d\n",
84 mgmtdev->max_read_request);
88 if (mgmtdev->max_wr_xactions > HIDMA_MAX_WR_XACTIONS_MASK) {
89 dev_err(&mgmtdev->pdev->dev,
90 "max_wr_xactions cannot be bigger than %ld\n",
91 HIDMA_MAX_WR_XACTIONS_MASK);
95 if (mgmtdev->max_rd_xactions > HIDMA_MAX_RD_XACTIONS_MASK) {
96 dev_err(&mgmtdev->pdev->dev,
97 "max_rd_xactions cannot be bigger than %ld\n",
98 HIDMA_MAX_RD_XACTIONS_MASK);
102 for (i = 0; i < mgmtdev->dma_channels; i++) {
103 if (mgmtdev->priority[i] > 1) {
104 dev_err(&mgmtdev->pdev->dev,
105 "priority can be 0 or 1\n");
109 if (mgmtdev->weight[i] > HIDMA_MAX_CHANNEL_WEIGHT) {
110 dev_err(&mgmtdev->pdev->dev,
111 "max value of weight can be %d.\n",
112 HIDMA_MAX_CHANNEL_WEIGHT);
116 /* weight needs to be at least one */
117 if (mgmtdev->weight[i] == 0)
118 mgmtdev->weight[i] = 1;
121 pm_runtime_get_sync(&mgmtdev->pdev->dev);
122 val = readl(mgmtdev->virtaddr + HIDMA_MAX_BUS_REQ_LEN_OFFSET);
123 val &= ~(HIDMA_MAX_BUS_REQ_LEN_MASK << HIDMA_MAX_BUS_WR_REQ_BIT_POS);
124 val |= mgmtdev->max_write_request << HIDMA_MAX_BUS_WR_REQ_BIT_POS;
125 val &= ~HIDMA_MAX_BUS_REQ_LEN_MASK;
126 val |= mgmtdev->max_read_request;
127 writel(val, mgmtdev->virtaddr + HIDMA_MAX_BUS_REQ_LEN_OFFSET);
129 val = readl(mgmtdev->virtaddr + HIDMA_MAX_XACTIONS_OFFSET);
130 val &= ~(HIDMA_MAX_WR_XACTIONS_MASK << HIDMA_MAX_WR_XACTIONS_BIT_POS);
131 val |= mgmtdev->max_wr_xactions << HIDMA_MAX_WR_XACTIONS_BIT_POS;
132 val &= ~HIDMA_MAX_RD_XACTIONS_MASK;
133 val |= mgmtdev->max_rd_xactions;
134 writel(val, mgmtdev->virtaddr + HIDMA_MAX_XACTIONS_OFFSET);
136 mgmtdev->hw_version =
137 readl(mgmtdev->virtaddr + HIDMA_HW_VERSION_OFFSET);
138 mgmtdev->hw_version_major = (mgmtdev->hw_version >> 28) & 0xF;
139 mgmtdev->hw_version_minor = (mgmtdev->hw_version >> 16) & 0xF;
141 for (i = 0; i < mgmtdev->dma_channels; i++) {
142 u32 weight = mgmtdev->weight[i];
143 u32 priority = mgmtdev->priority[i];
145 val = readl(mgmtdev->virtaddr + HIDMA_QOS_N_OFFSET + (4 * i));
146 val &= ~(1 << HIDMA_PRIORITY_BIT_POS);
147 val |= (priority & 0x1) << HIDMA_PRIORITY_BIT_POS;
148 val &= ~(HIDMA_WEIGHT_MASK << HIDMA_WRR_BIT_POS);
149 val |= (weight & HIDMA_WEIGHT_MASK) << HIDMA_WRR_BIT_POS;
150 writel(val, mgmtdev->virtaddr + HIDMA_QOS_N_OFFSET + (4 * i));
153 val = readl(mgmtdev->virtaddr + HIDMA_CHRESET_TIMEOUT_OFFSET);
154 val &= ~HIDMA_CHRESET_TIMEOUT_MASK;
155 val |= mgmtdev->chreset_timeout_cycles & HIDMA_CHRESET_TIMEOUT_MASK;
156 writel(val, mgmtdev->virtaddr + HIDMA_CHRESET_TIMEOUT_OFFSET);
158 pm_runtime_mark_last_busy(&mgmtdev->pdev->dev);
159 pm_runtime_put_autosuspend(&mgmtdev->pdev->dev);
162 EXPORT_SYMBOL_GPL(hidma_mgmt_setup);
164 static int hidma_mgmt_probe(struct platform_device *pdev)
166 struct hidma_mgmt_dev *mgmtdev;
167 struct resource *res;
168 void __iomem *virtaddr;
173 pm_runtime_set_autosuspend_delay(&pdev->dev, HIDMA_AUTOSUSPEND_TIMEOUT);
174 pm_runtime_use_autosuspend(&pdev->dev);
175 pm_runtime_set_active(&pdev->dev);
176 pm_runtime_enable(&pdev->dev);
177 pm_runtime_get_sync(&pdev->dev);
179 virtaddr = devm_platform_get_and_ioremap_resource(pdev, 0, &res);
180 if (IS_ERR(virtaddr)) {
181 rc = PTR_ERR(virtaddr);
185 irq = platform_get_irq(pdev, 0);
191 mgmtdev = devm_kzalloc(&pdev->dev, sizeof(*mgmtdev), GFP_KERNEL);
197 mgmtdev->pdev = pdev;
198 mgmtdev->addrsize = resource_size(res);
199 mgmtdev->virtaddr = virtaddr;
201 rc = device_property_read_u32(&pdev->dev, "dma-channels",
202 &mgmtdev->dma_channels);
204 dev_err(&pdev->dev, "number of channels missing\n");
208 rc = device_property_read_u32(&pdev->dev,
209 "channel-reset-timeout-cycles",
210 &mgmtdev->chreset_timeout_cycles);
212 dev_err(&pdev->dev, "channel reset timeout missing\n");
216 rc = device_property_read_u32(&pdev->dev, "max-write-burst-bytes",
217 &mgmtdev->max_write_request);
219 dev_err(&pdev->dev, "max-write-burst-bytes missing\n");
223 if (max_write_request &&
224 (max_write_request != mgmtdev->max_write_request)) {
225 dev_info(&pdev->dev, "overriding max-write-burst-bytes: %d\n",
227 mgmtdev->max_write_request = max_write_request;
229 max_write_request = mgmtdev->max_write_request;
231 rc = device_property_read_u32(&pdev->dev, "max-read-burst-bytes",
232 &mgmtdev->max_read_request);
234 dev_err(&pdev->dev, "max-read-burst-bytes missing\n");
237 if (max_read_request &&
238 (max_read_request != mgmtdev->max_read_request)) {
239 dev_info(&pdev->dev, "overriding max-read-burst-bytes: %d\n",
241 mgmtdev->max_read_request = max_read_request;
243 max_read_request = mgmtdev->max_read_request;
245 rc = device_property_read_u32(&pdev->dev, "max-write-transactions",
246 &mgmtdev->max_wr_xactions);
248 dev_err(&pdev->dev, "max-write-transactions missing\n");
251 if (max_wr_xactions &&
252 (max_wr_xactions != mgmtdev->max_wr_xactions)) {
253 dev_info(&pdev->dev, "overriding max-write-transactions: %d\n",
255 mgmtdev->max_wr_xactions = max_wr_xactions;
257 max_wr_xactions = mgmtdev->max_wr_xactions;
259 rc = device_property_read_u32(&pdev->dev, "max-read-transactions",
260 &mgmtdev->max_rd_xactions);
262 dev_err(&pdev->dev, "max-read-transactions missing\n");
265 if (max_rd_xactions &&
266 (max_rd_xactions != mgmtdev->max_rd_xactions)) {
267 dev_info(&pdev->dev, "overriding max-read-transactions: %d\n",
269 mgmtdev->max_rd_xactions = max_rd_xactions;
271 max_rd_xactions = mgmtdev->max_rd_xactions;
273 mgmtdev->priority = devm_kcalloc(&pdev->dev,
274 mgmtdev->dma_channels,
275 sizeof(*mgmtdev->priority),
277 if (!mgmtdev->priority) {
282 mgmtdev->weight = devm_kcalloc(&pdev->dev,
283 mgmtdev->dma_channels,
284 sizeof(*mgmtdev->weight), GFP_KERNEL);
285 if (!mgmtdev->weight) {
290 rc = hidma_mgmt_setup(mgmtdev);
292 dev_err(&pdev->dev, "setup failed\n");
297 val = readl(mgmtdev->virtaddr + HIDMA_CFG_OFFSET);
299 writel(val, mgmtdev->virtaddr + HIDMA_CFG_OFFSET);
301 rc = hidma_mgmt_init_sys(mgmtdev);
303 dev_err(&pdev->dev, "sysfs setup failed\n");
308 "HW rev: %d.%d @ %pa with %d physical channels\n",
309 mgmtdev->hw_version_major, mgmtdev->hw_version_minor,
310 &res->start, mgmtdev->dma_channels);
312 platform_set_drvdata(pdev, mgmtdev);
313 pm_runtime_mark_last_busy(&pdev->dev);
314 pm_runtime_put_autosuspend(&pdev->dev);
317 pm_runtime_put_sync_suspend(&pdev->dev);
318 pm_runtime_disable(&pdev->dev);
322 #if IS_ENABLED(CONFIG_ACPI)
323 static const struct acpi_device_id hidma_mgmt_acpi_ids[] = {
327 MODULE_DEVICE_TABLE(acpi, hidma_mgmt_acpi_ids);
330 static const struct of_device_id hidma_mgmt_match[] = {
331 {.compatible = "qcom,hidma-mgmt-1.0",},
334 MODULE_DEVICE_TABLE(of, hidma_mgmt_match);
336 static struct platform_driver hidma_mgmt_driver = {
337 .probe = hidma_mgmt_probe,
339 .name = "hidma-mgmt",
340 .of_match_table = hidma_mgmt_match,
341 .acpi_match_table = ACPI_PTR(hidma_mgmt_acpi_ids),
345 #if defined(CONFIG_OF) && defined(CONFIG_OF_IRQ)
346 static int object_counter;
348 static int __init hidma_mgmt_of_populate_channels(struct device_node *np)
350 struct platform_device *pdev_parent = of_find_device_by_node(np);
351 struct platform_device_info pdevinfo;
352 struct device_node *child;
353 struct resource *res;
356 /* allocate a resource array */
357 res = kcalloc(3, sizeof(*res), GFP_KERNEL);
361 for_each_available_child_of_node(np, child) {
362 struct platform_device *new_pdev;
364 ret = of_address_to_resource(child, 0, &res[0]);
368 ret = of_address_to_resource(child, 1, &res[1]);
372 ret = of_irq_to_resource(child, 0, &res[2]);
376 memset(&pdevinfo, 0, sizeof(pdevinfo));
377 pdevinfo.fwnode = &child->fwnode;
378 pdevinfo.parent = pdev_parent ? &pdev_parent->dev : NULL;
379 pdevinfo.name = child->name;
380 pdevinfo.id = object_counter++;
382 pdevinfo.num_res = 3;
383 pdevinfo.data = NULL;
384 pdevinfo.size_data = 0;
385 pdevinfo.dma_mask = DMA_BIT_MASK(64);
386 new_pdev = platform_device_register_full(&pdevinfo);
387 if (IS_ERR(new_pdev)) {
388 ret = PTR_ERR(new_pdev);
391 new_pdev->dev.of_node = child;
392 of_dma_configure(&new_pdev->dev, child, true);
394 * It is assumed that calling of_msi_configure is safe on
395 * platforms with or without MSI support.
397 of_msi_configure(&new_pdev->dev, child);
412 static int __init hidma_mgmt_init(void)
414 #if defined(CONFIG_OF) && defined(CONFIG_OF_IRQ)
415 struct device_node *child;
417 for_each_matching_node(child, hidma_mgmt_match) {
418 /* device tree based firmware here */
419 hidma_mgmt_of_populate_channels(child);
423 * We do not check for return value here, as it is assumed that
424 * platform_driver_register must not fail. The reason for this is that
425 * the (potential) hidma_mgmt_of_populate_channels calls above are not
426 * cleaned up if it does fail, and to do this work is quite
427 * complicated. In particular, various calls of of_address_to_resource,
428 * of_irq_to_resource, platform_device_register_full, of_dma_configure,
429 * and of_msi_configure which then call other functions and so on, must
430 * be cleaned up - this is not a trivial exercise.
432 * Currently, this module is not intended to be unloaded, and there is
433 * no module_exit function defined which does the needed cleanup. For
434 * this reason, we have to assume success here.
436 platform_driver_register(&hidma_mgmt_driver);
440 module_init(hidma_mgmt_init);
441 MODULE_LICENSE("GPL v2");