Linux Audio

Check our new training course

Loading...
v6.13.7
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * drivers/uio/uio_dmem_genirq.c
  4 *
  5 * Userspace I/O platform driver with generic IRQ handling code.
  6 *
  7 * Copyright (C) 2012 Damian Hobson-Garcia
  8 *
  9 * Based on uio_pdrv_genirq.c by Magnus Damm
 10 */
 11
 12#include <linux/platform_device.h>
 13#include <linux/uio_driver.h>
 14#include <linux/spinlock.h>
 15#include <linux/bitops.h>
 16#include <linux/module.h>
 17#include <linux/interrupt.h>
 18#include <linux/platform_data/uio_dmem_genirq.h>
 19#include <linux/stringify.h>
 20#include <linux/pm_runtime.h>
 21#include <linux/dma-mapping.h>
 22#include <linux/slab.h>
 23#include <linux/irq.h>
 24
 25#include <linux/of.h>
 26#include <linux/of_platform.h>
 27#include <linux/of_address.h>
 28
 29#define DRIVER_NAME "uio_dmem_genirq"
 30#define DMEM_MAP_ERROR (~0)
 31
 32struct uio_dmem_genirq_platdata {
 33	struct uio_info *uioinfo;
 34	spinlock_t lock;
 35	unsigned long flags;
 36	struct platform_device *pdev;
 37	unsigned int dmem_region_start;
 38	unsigned int num_dmem_regions;
 
 39	struct mutex alloc_lock;
 40	unsigned int refcnt;
 41};
 42
 43/* Bits in uio_dmem_genirq_platdata.flags */
 44enum {
 45	UIO_IRQ_DISABLED = 0,
 46};
 47
 48static int uio_dmem_genirq_open(struct uio_info *info, struct inode *inode)
 49{
 50	struct uio_dmem_genirq_platdata *priv = info->priv;
 51	struct uio_mem *uiomem;
 
 52
 53	uiomem = &priv->uioinfo->mem[priv->dmem_region_start];
 54
 55	mutex_lock(&priv->alloc_lock);
 56	while (!priv->refcnt && uiomem < &priv->uioinfo->mem[MAX_UIO_MAPS]) {
 57		void *addr;
 58		if (!uiomem->size)
 59			break;
 60
 61		addr = dma_alloc_coherent(&priv->pdev->dev, uiomem->size,
 62					  &uiomem->dma_addr, GFP_KERNEL);
 63		uiomem->addr = addr ? (uintptr_t) addr : DMEM_MAP_ERROR;
 
 
 
 64		++uiomem;
 65	}
 66	priv->refcnt++;
 67
 68	mutex_unlock(&priv->alloc_lock);
 69	/* Wait until the Runtime PM code has woken up the device */
 70	pm_runtime_get_sync(&priv->pdev->dev);
 71	return 0;
 72}
 73
 74static int uio_dmem_genirq_release(struct uio_info *info, struct inode *inode)
 75{
 76	struct uio_dmem_genirq_platdata *priv = info->priv;
 77	struct uio_mem *uiomem;
 
 78
 79	/* Tell the Runtime PM code that the device has become idle */
 80	pm_runtime_put_sync(&priv->pdev->dev);
 81
 82	uiomem = &priv->uioinfo->mem[priv->dmem_region_start];
 83
 84	mutex_lock(&priv->alloc_lock);
 85
 86	priv->refcnt--;
 87	while (!priv->refcnt && uiomem < &priv->uioinfo->mem[MAX_UIO_MAPS]) {
 88		if (!uiomem->size)
 89			break;
 90		if (uiomem->addr) {
 91			dma_free_coherent(uiomem->dma_device, uiomem->size,
 92					  (void *) (uintptr_t) uiomem->addr,
 93					  uiomem->dma_addr);
 94		}
 95		uiomem->addr = DMEM_MAP_ERROR;
 
 96		++uiomem;
 97	}
 98
 99	mutex_unlock(&priv->alloc_lock);
100	return 0;
101}
102
103static irqreturn_t uio_dmem_genirq_handler(int irq, struct uio_info *dev_info)
104{
105	struct uio_dmem_genirq_platdata *priv = dev_info->priv;
106
107	/* Just disable the interrupt in the interrupt controller, and
108	 * remember the state so we can allow user space to enable it later.
109	 */
110
111	spin_lock(&priv->lock);
112	if (!__test_and_set_bit(UIO_IRQ_DISABLED, &priv->flags))
113		disable_irq_nosync(irq);
114	spin_unlock(&priv->lock);
115
116	return IRQ_HANDLED;
117}
118
119static int uio_dmem_genirq_irqcontrol(struct uio_info *dev_info, s32 irq_on)
120{
121	struct uio_dmem_genirq_platdata *priv = dev_info->priv;
122	unsigned long flags;
123
124	/* Allow user space to enable and disable the interrupt
125	 * in the interrupt controller, but keep track of the
126	 * state to prevent per-irq depth damage.
127	 *
128	 * Serialize this operation to support multiple tasks and concurrency
129	 * with irq handler on SMP systems.
130	 */
131
132	spin_lock_irqsave(&priv->lock, flags);
133	if (irq_on) {
134		if (__test_and_clear_bit(UIO_IRQ_DISABLED, &priv->flags))
135			enable_irq(dev_info->irq);
136	} else {
137		if (!__test_and_set_bit(UIO_IRQ_DISABLED, &priv->flags))
138			disable_irq_nosync(dev_info->irq);
139	}
140	spin_unlock_irqrestore(&priv->lock, flags);
141
142	return 0;
143}
144
145static void uio_dmem_genirq_pm_disable(void *data)
146{
147	struct device *dev = data;
148
149	pm_runtime_disable(dev);
150}
151
152static int uio_dmem_genirq_probe(struct platform_device *pdev)
153{
154	struct uio_dmem_genirq_pdata *pdata = dev_get_platdata(&pdev->dev);
155	struct uio_info *uioinfo = &pdata->uioinfo;
156	struct uio_dmem_genirq_platdata *priv;
157	struct uio_mem *uiomem;
158	int ret = -EINVAL;
159	int i;
160
161	if (pdev->dev.of_node) {
162		/* alloc uioinfo for one device */
163		uioinfo = devm_kzalloc(&pdev->dev, sizeof(*uioinfo), GFP_KERNEL);
164		if (!uioinfo) {
165			dev_err(&pdev->dev, "unable to kmalloc\n");
166			return -ENOMEM;
167		}
168		uioinfo->name = devm_kasprintf(&pdev->dev, GFP_KERNEL, "%pOFn",
169					       pdev->dev.of_node);
170		uioinfo->version = "devicetree";
171	}
172
173	if (!uioinfo || !uioinfo->name || !uioinfo->version) {
174		dev_err(&pdev->dev, "missing platform_data\n");
175		return -EINVAL;
176	}
177
178	if (uioinfo->handler || uioinfo->irqcontrol ||
179	    uioinfo->irq_flags & IRQF_SHARED) {
180		dev_err(&pdev->dev, "interrupt configuration error\n");
181		return -EINVAL;
182	}
183
184	priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
185	if (!priv) {
186		dev_err(&pdev->dev, "unable to kmalloc\n");
187		return -ENOMEM;
188	}
189
190	ret = dma_set_coherent_mask(&pdev->dev, DMA_BIT_MASK(32));
191	if (ret) {
192		dev_err(&pdev->dev, "DMA enable failed\n");
193		return ret;
194	}
195
196	priv->uioinfo = uioinfo;
197	spin_lock_init(&priv->lock);
198	priv->flags = 0; /* interrupt is enabled to begin with */
199	priv->pdev = pdev;
200	mutex_init(&priv->alloc_lock);
201
202	if (!uioinfo->irq) {
203		/* Multiple IRQs are not supported */
204		ret = platform_get_irq(pdev, 0);
205		if (ret == -ENXIO && pdev->dev.of_node)
206			ret = UIO_IRQ_NONE;
207		else if (ret < 0)
208			return ret;
209		uioinfo->irq = ret;
210	}
211
212	if (uioinfo->irq) {
 
 
213		/*
214		 * If a level interrupt, dont do lazy disable. Otherwise the
215		 * irq will fire again since clearing of the actual cause, on
216		 * device level, is done in userspace
217		 * irqd_is_level_type() isn't used since isn't valid until
218		 * irq is configured.
219		 */
220		if (irq_get_trigger_type(uioinfo->irq) & IRQ_TYPE_LEVEL_MASK) {
 
221			dev_dbg(&pdev->dev, "disable lazy unmask\n");
222			irq_set_status_flags(uioinfo->irq, IRQ_DISABLE_UNLAZY);
223		}
224	}
225
226	uiomem = &uioinfo->mem[0];
227
228	for (i = 0; i < pdev->num_resources; ++i) {
229		struct resource *r = &pdev->resource[i];
230
231		if (r->flags != IORESOURCE_MEM)
232			continue;
233
234		if (uiomem >= &uioinfo->mem[MAX_UIO_MAPS]) {
235			dev_warn(&pdev->dev, "device has more than "
236					__stringify(MAX_UIO_MAPS)
237					" I/O memory resources.\n");
238			break;
239		}
240
241		uiomem->memtype = UIO_MEM_PHYS;
242		uiomem->addr = r->start;
243		uiomem->size = resource_size(r);
244		++uiomem;
245	}
246
247	priv->dmem_region_start = uiomem - &uioinfo->mem[0];
248	priv->num_dmem_regions = pdata->num_dynamic_regions;
249
250	for (i = 0; i < pdata->num_dynamic_regions; ++i) {
251		if (uiomem >= &uioinfo->mem[MAX_UIO_MAPS]) {
252			dev_warn(&pdev->dev, "device has more than "
253					__stringify(MAX_UIO_MAPS)
254					" dynamic and fixed memory regions.\n");
255			break;
256		}
257		uiomem->memtype = UIO_MEM_DMA_COHERENT;
258		uiomem->dma_device = &pdev->dev;
259		uiomem->addr = DMEM_MAP_ERROR;
260		uiomem->size = pdata->dynamic_region_sizes[i];
261		++uiomem;
262	}
263
264	while (uiomem < &uioinfo->mem[MAX_UIO_MAPS]) {
265		uiomem->size = 0;
266		++uiomem;
267	}
268
269	/* This driver requires no hardware specific kernel code to handle
270	 * interrupts. Instead, the interrupt handler simply disables the
271	 * interrupt in the interrupt controller. User space is responsible
272	 * for performing hardware specific acknowledge and re-enabling of
273	 * the interrupt in the interrupt controller.
274	 *
275	 * Interrupt sharing is not supported.
276	 */
277
278	uioinfo->handler = uio_dmem_genirq_handler;
279	uioinfo->irqcontrol = uio_dmem_genirq_irqcontrol;
280	uioinfo->open = uio_dmem_genirq_open;
281	uioinfo->release = uio_dmem_genirq_release;
282	uioinfo->priv = priv;
283
284	/* Enable Runtime PM for this device:
285	 * The device starts in suspended state to allow the hardware to be
286	 * turned off by default. The Runtime PM bus code should power on the
287	 * hardware and enable clocks at open().
288	 */
289	pm_runtime_enable(&pdev->dev);
290
291	ret = devm_add_action_or_reset(&pdev->dev, uio_dmem_genirq_pm_disable, &pdev->dev);
292	if (ret)
293		return ret;
294
295	return devm_uio_register_device(&pdev->dev, priv->uioinfo);
296}
297
298static int uio_dmem_genirq_runtime_nop(struct device *dev)
299{
300	/* Runtime PM callback shared between ->runtime_suspend()
301	 * and ->runtime_resume(). Simply returns success.
302	 *
303	 * In this driver pm_runtime_get_sync() and pm_runtime_put_sync()
304	 * are used at open() and release() time. This allows the
305	 * Runtime PM code to turn off power to the device while the
306	 * device is unused, ie before open() and after release().
307	 *
308	 * This Runtime PM callback does not need to save or restore
309	 * any registers since user space is responsbile for hardware
310	 * register reinitialization after open().
311	 */
312	return 0;
313}
314
315static const struct dev_pm_ops uio_dmem_genirq_dev_pm_ops = {
316	.runtime_suspend = uio_dmem_genirq_runtime_nop,
317	.runtime_resume = uio_dmem_genirq_runtime_nop,
318};
319
320#ifdef CONFIG_OF
321static const struct of_device_id uio_of_genirq_match[] = {
322	{ /* empty for now */ },
323};
324MODULE_DEVICE_TABLE(of, uio_of_genirq_match);
325#endif
326
327static struct platform_driver uio_dmem_genirq = {
328	.probe = uio_dmem_genirq_probe,
329	.driver = {
330		.name = DRIVER_NAME,
331		.pm = &uio_dmem_genirq_dev_pm_ops,
332		.of_match_table = of_match_ptr(uio_of_genirq_match),
333	},
334};
335
336module_platform_driver(uio_dmem_genirq);
337
338MODULE_AUTHOR("Damian Hobson-Garcia");
339MODULE_DESCRIPTION("Userspace I/O platform driver with dynamic memory.");
340MODULE_LICENSE("GPL v2");
341MODULE_ALIAS("platform:" DRIVER_NAME);
v6.8
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * drivers/uio/uio_dmem_genirq.c
  4 *
  5 * Userspace I/O platform driver with generic IRQ handling code.
  6 *
  7 * Copyright (C) 2012 Damian Hobson-Garcia
  8 *
  9 * Based on uio_pdrv_genirq.c by Magnus Damm
 10 */
 11
 12#include <linux/platform_device.h>
 13#include <linux/uio_driver.h>
 14#include <linux/spinlock.h>
 15#include <linux/bitops.h>
 16#include <linux/module.h>
 17#include <linux/interrupt.h>
 18#include <linux/platform_data/uio_dmem_genirq.h>
 19#include <linux/stringify.h>
 20#include <linux/pm_runtime.h>
 21#include <linux/dma-mapping.h>
 22#include <linux/slab.h>
 23#include <linux/irq.h>
 24
 25#include <linux/of.h>
 26#include <linux/of_platform.h>
 27#include <linux/of_address.h>
 28
 29#define DRIVER_NAME "uio_dmem_genirq"
 30#define DMEM_MAP_ERROR (~0)
 31
 32struct uio_dmem_genirq_platdata {
 33	struct uio_info *uioinfo;
 34	spinlock_t lock;
 35	unsigned long flags;
 36	struct platform_device *pdev;
 37	unsigned int dmem_region_start;
 38	unsigned int num_dmem_regions;
 39	void *dmem_region_vaddr[MAX_UIO_MAPS];
 40	struct mutex alloc_lock;
 41	unsigned int refcnt;
 42};
 43
 44/* Bits in uio_dmem_genirq_platdata.flags */
 45enum {
 46	UIO_IRQ_DISABLED = 0,
 47};
 48
 49static int uio_dmem_genirq_open(struct uio_info *info, struct inode *inode)
 50{
 51	struct uio_dmem_genirq_platdata *priv = info->priv;
 52	struct uio_mem *uiomem;
 53	int dmem_region = priv->dmem_region_start;
 54
 55	uiomem = &priv->uioinfo->mem[priv->dmem_region_start];
 56
 57	mutex_lock(&priv->alloc_lock);
 58	while (!priv->refcnt && uiomem < &priv->uioinfo->mem[MAX_UIO_MAPS]) {
 59		void *addr;
 60		if (!uiomem->size)
 61			break;
 62
 63		addr = dma_alloc_coherent(&priv->pdev->dev, uiomem->size,
 64				(dma_addr_t *)&uiomem->addr, GFP_KERNEL);
 65		if (!addr) {
 66			uiomem->addr = DMEM_MAP_ERROR;
 67		}
 68		priv->dmem_region_vaddr[dmem_region++] = addr;
 69		++uiomem;
 70	}
 71	priv->refcnt++;
 72
 73	mutex_unlock(&priv->alloc_lock);
 74	/* Wait until the Runtime PM code has woken up the device */
 75	pm_runtime_get_sync(&priv->pdev->dev);
 76	return 0;
 77}
 78
 79static int uio_dmem_genirq_release(struct uio_info *info, struct inode *inode)
 80{
 81	struct uio_dmem_genirq_platdata *priv = info->priv;
 82	struct uio_mem *uiomem;
 83	int dmem_region = priv->dmem_region_start;
 84
 85	/* Tell the Runtime PM code that the device has become idle */
 86	pm_runtime_put_sync(&priv->pdev->dev);
 87
 88	uiomem = &priv->uioinfo->mem[priv->dmem_region_start];
 89
 90	mutex_lock(&priv->alloc_lock);
 91
 92	priv->refcnt--;
 93	while (!priv->refcnt && uiomem < &priv->uioinfo->mem[MAX_UIO_MAPS]) {
 94		if (!uiomem->size)
 95			break;
 96		if (priv->dmem_region_vaddr[dmem_region]) {
 97			dma_free_coherent(&priv->pdev->dev, uiomem->size,
 98					priv->dmem_region_vaddr[dmem_region],
 99					uiomem->addr);
100		}
101		uiomem->addr = DMEM_MAP_ERROR;
102		++dmem_region;
103		++uiomem;
104	}
105
106	mutex_unlock(&priv->alloc_lock);
107	return 0;
108}
109
110static irqreturn_t uio_dmem_genirq_handler(int irq, struct uio_info *dev_info)
111{
112	struct uio_dmem_genirq_platdata *priv = dev_info->priv;
113
114	/* Just disable the interrupt in the interrupt controller, and
115	 * remember the state so we can allow user space to enable it later.
116	 */
117
118	spin_lock(&priv->lock);
119	if (!__test_and_set_bit(UIO_IRQ_DISABLED, &priv->flags))
120		disable_irq_nosync(irq);
121	spin_unlock(&priv->lock);
122
123	return IRQ_HANDLED;
124}
125
126static int uio_dmem_genirq_irqcontrol(struct uio_info *dev_info, s32 irq_on)
127{
128	struct uio_dmem_genirq_platdata *priv = dev_info->priv;
129	unsigned long flags;
130
131	/* Allow user space to enable and disable the interrupt
132	 * in the interrupt controller, but keep track of the
133	 * state to prevent per-irq depth damage.
134	 *
135	 * Serialize this operation to support multiple tasks and concurrency
136	 * with irq handler on SMP systems.
137	 */
138
139	spin_lock_irqsave(&priv->lock, flags);
140	if (irq_on) {
141		if (__test_and_clear_bit(UIO_IRQ_DISABLED, &priv->flags))
142			enable_irq(dev_info->irq);
143	} else {
144		if (!__test_and_set_bit(UIO_IRQ_DISABLED, &priv->flags))
145			disable_irq_nosync(dev_info->irq);
146	}
147	spin_unlock_irqrestore(&priv->lock, flags);
148
149	return 0;
150}
151
152static void uio_dmem_genirq_pm_disable(void *data)
153{
154	struct device *dev = data;
155
156	pm_runtime_disable(dev);
157}
158
159static int uio_dmem_genirq_probe(struct platform_device *pdev)
160{
161	struct uio_dmem_genirq_pdata *pdata = dev_get_platdata(&pdev->dev);
162	struct uio_info *uioinfo = &pdata->uioinfo;
163	struct uio_dmem_genirq_platdata *priv;
164	struct uio_mem *uiomem;
165	int ret = -EINVAL;
166	int i;
167
168	if (pdev->dev.of_node) {
169		/* alloc uioinfo for one device */
170		uioinfo = devm_kzalloc(&pdev->dev, sizeof(*uioinfo), GFP_KERNEL);
171		if (!uioinfo) {
172			dev_err(&pdev->dev, "unable to kmalloc\n");
173			return -ENOMEM;
174		}
175		uioinfo->name = devm_kasprintf(&pdev->dev, GFP_KERNEL, "%pOFn",
176					       pdev->dev.of_node);
177		uioinfo->version = "devicetree";
178	}
179
180	if (!uioinfo || !uioinfo->name || !uioinfo->version) {
181		dev_err(&pdev->dev, "missing platform_data\n");
182		return -EINVAL;
183	}
184
185	if (uioinfo->handler || uioinfo->irqcontrol ||
186	    uioinfo->irq_flags & IRQF_SHARED) {
187		dev_err(&pdev->dev, "interrupt configuration error\n");
188		return -EINVAL;
189	}
190
191	priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
192	if (!priv) {
193		dev_err(&pdev->dev, "unable to kmalloc\n");
194		return -ENOMEM;
195	}
196
197	ret = dma_set_coherent_mask(&pdev->dev, DMA_BIT_MASK(32));
198	if (ret) {
199		dev_err(&pdev->dev, "DMA enable failed\n");
200		return ret;
201	}
202
203	priv->uioinfo = uioinfo;
204	spin_lock_init(&priv->lock);
205	priv->flags = 0; /* interrupt is enabled to begin with */
206	priv->pdev = pdev;
207	mutex_init(&priv->alloc_lock);
208
209	if (!uioinfo->irq) {
210		/* Multiple IRQs are not supported */
211		ret = platform_get_irq(pdev, 0);
212		if (ret == -ENXIO && pdev->dev.of_node)
213			ret = UIO_IRQ_NONE;
214		else if (ret < 0)
215			return ret;
216		uioinfo->irq = ret;
217	}
218
219	if (uioinfo->irq) {
220		struct irq_data *irq_data = irq_get_irq_data(uioinfo->irq);
221
222		/*
223		 * If a level interrupt, dont do lazy disable. Otherwise the
224		 * irq will fire again since clearing of the actual cause, on
225		 * device level, is done in userspace
226		 * irqd_is_level_type() isn't used since isn't valid until
227		 * irq is configured.
228		 */
229		if (irq_data &&
230		    irqd_get_trigger_type(irq_data) & IRQ_TYPE_LEVEL_MASK) {
231			dev_dbg(&pdev->dev, "disable lazy unmask\n");
232			irq_set_status_flags(uioinfo->irq, IRQ_DISABLE_UNLAZY);
233		}
234	}
235
236	uiomem = &uioinfo->mem[0];
237
238	for (i = 0; i < pdev->num_resources; ++i) {
239		struct resource *r = &pdev->resource[i];
240
241		if (r->flags != IORESOURCE_MEM)
242			continue;
243
244		if (uiomem >= &uioinfo->mem[MAX_UIO_MAPS]) {
245			dev_warn(&pdev->dev, "device has more than "
246					__stringify(MAX_UIO_MAPS)
247					" I/O memory resources.\n");
248			break;
249		}
250
251		uiomem->memtype = UIO_MEM_PHYS;
252		uiomem->addr = r->start;
253		uiomem->size = resource_size(r);
254		++uiomem;
255	}
256
257	priv->dmem_region_start = uiomem - &uioinfo->mem[0];
258	priv->num_dmem_regions = pdata->num_dynamic_regions;
259
260	for (i = 0; i < pdata->num_dynamic_regions; ++i) {
261		if (uiomem >= &uioinfo->mem[MAX_UIO_MAPS]) {
262			dev_warn(&pdev->dev, "device has more than "
263					__stringify(MAX_UIO_MAPS)
264					" dynamic and fixed memory regions.\n");
265			break;
266		}
267		uiomem->memtype = UIO_MEM_PHYS;
 
268		uiomem->addr = DMEM_MAP_ERROR;
269		uiomem->size = pdata->dynamic_region_sizes[i];
270		++uiomem;
271	}
272
273	while (uiomem < &uioinfo->mem[MAX_UIO_MAPS]) {
274		uiomem->size = 0;
275		++uiomem;
276	}
277
278	/* This driver requires no hardware specific kernel code to handle
279	 * interrupts. Instead, the interrupt handler simply disables the
280	 * interrupt in the interrupt controller. User space is responsible
281	 * for performing hardware specific acknowledge and re-enabling of
282	 * the interrupt in the interrupt controller.
283	 *
284	 * Interrupt sharing is not supported.
285	 */
286
287	uioinfo->handler = uio_dmem_genirq_handler;
288	uioinfo->irqcontrol = uio_dmem_genirq_irqcontrol;
289	uioinfo->open = uio_dmem_genirq_open;
290	uioinfo->release = uio_dmem_genirq_release;
291	uioinfo->priv = priv;
292
293	/* Enable Runtime PM for this device:
294	 * The device starts in suspended state to allow the hardware to be
295	 * turned off by default. The Runtime PM bus code should power on the
296	 * hardware and enable clocks at open().
297	 */
298	pm_runtime_enable(&pdev->dev);
299
300	ret = devm_add_action_or_reset(&pdev->dev, uio_dmem_genirq_pm_disable, &pdev->dev);
301	if (ret)
302		return ret;
303
304	return devm_uio_register_device(&pdev->dev, priv->uioinfo);
305}
306
307static int uio_dmem_genirq_runtime_nop(struct device *dev)
308{
309	/* Runtime PM callback shared between ->runtime_suspend()
310	 * and ->runtime_resume(). Simply returns success.
311	 *
312	 * In this driver pm_runtime_get_sync() and pm_runtime_put_sync()
313	 * are used at open() and release() time. This allows the
314	 * Runtime PM code to turn off power to the device while the
315	 * device is unused, ie before open() and after release().
316	 *
317	 * This Runtime PM callback does not need to save or restore
318	 * any registers since user space is responsbile for hardware
319	 * register reinitialization after open().
320	 */
321	return 0;
322}
323
324static const struct dev_pm_ops uio_dmem_genirq_dev_pm_ops = {
325	.runtime_suspend = uio_dmem_genirq_runtime_nop,
326	.runtime_resume = uio_dmem_genirq_runtime_nop,
327};
328
329#ifdef CONFIG_OF
330static const struct of_device_id uio_of_genirq_match[] = {
331	{ /* empty for now */ },
332};
333MODULE_DEVICE_TABLE(of, uio_of_genirq_match);
334#endif
335
336static struct platform_driver uio_dmem_genirq = {
337	.probe = uio_dmem_genirq_probe,
338	.driver = {
339		.name = DRIVER_NAME,
340		.pm = &uio_dmem_genirq_dev_pm_ops,
341		.of_match_table = of_match_ptr(uio_of_genirq_match),
342	},
343};
344
345module_platform_driver(uio_dmem_genirq);
346
347MODULE_AUTHOR("Damian Hobson-Garcia");
348MODULE_DESCRIPTION("Userspace I/O platform driver with dynamic memory.");
349MODULE_LICENSE("GPL v2");
350MODULE_ALIAS("platform:" DRIVER_NAME);