1 // SPDX-License-Identifier: GPL-2.0
13  * dev_pm_attach_wake_irq - Attach device interrupt as a wake IRQ
15  * @irq: Device wake-up capable interrupt
19  * dedicated wake-up interrupt as a wake IRQ.
27 		return -EINVAL;  in dev_pm_attach_wake_irq()
29 	spin_lock_irqsave(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
30 	if (dev_WARN_ONCE(dev, dev->power.wakeirq,  in dev_pm_attach_wake_irq()
32 		spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
33 		return -EEXIST;  in dev_pm_attach_wake_irq()
36 	dev->power.wakeirq = wirq;  in dev_pm_attach_wake_irq()
39 	spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
44  * dev_pm_set_wake_irq - Attach device IO interrupt as wake IRQ
49  * automatically configured for wake-up from suspend  based
59 		return -EINVAL;  in dev_pm_set_wake_irq()
63 		return -ENOMEM;  in dev_pm_set_wake_irq()
65 	wirq->dev = dev;  in dev_pm_set_wake_irq()
66 	wirq->irq = irq;  in dev_pm_set_wake_irq()
77  * dev_pm_clear_wake_irq - Detach a device IO interrupt wake IRQ
89 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_clear_wake_irq()
95 	spin_lock_irqsave(&dev->power.lock, flags);  in dev_pm_clear_wake_irq()
97 	dev->power.wakeirq = NULL;  in dev_pm_clear_wake_irq()
98 	spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_clear_wake_irq()
100 	if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED) {  in dev_pm_clear_wake_irq()
101 		free_irq(wirq->irq, wirq);  in dev_pm_clear_wake_irq()
102 		wirq->status &= ~WAKE_IRQ_DEDICATED_MASK;  in dev_pm_clear_wake_irq()
104 	kfree(wirq->name);  in dev_pm_clear_wake_irq()
110  * handle_threaded_wake_irq - Handler for dedicated wake-up interrupts
111  * @irq: Device specific dedicated wake-up interrupt
114  * Some devices have a separate wake-up interrupt in addition to the
115  * device IO interrupt. The wake-up interrupt signals that a device
116  * should be woken up from it's idle state. This handler uses device
118  * up to the device to do whatever it needs to. Note that as the
119  * device may need to restore context and start up regulators, we
123  * We assume that the wake-up interrupt just needs to wake-up the
134 		pm_wakeup_event(wirq->dev, 0);  in handle_threaded_wake_irq()
140 	res = pm_runtime_resume(wirq->dev);  in handle_threaded_wake_irq()
142 		dev_warn(wirq->dev,  in handle_threaded_wake_irq()
149  * dev_pm_set_dedicated_wake_irq - Request a dedicated wake-up interrupt
151  * @irq: Device wake-up interrupt
153  * Unless your hardware has separate wake-up interrupts in addition
156  * Sets up a threaded interrupt handler for a device that has
157  * a dedicated wake-up interrupt in addition to the device IO
171 		return -EINVAL;  in dev_pm_set_dedicated_wake_irq()
175 		return -ENOMEM;  in dev_pm_set_dedicated_wake_irq()
177 	wirq->name = kasprintf(GFP_KERNEL, "%s:wakeup", dev_name(dev));  in dev_pm_set_dedicated_wake_irq()
178 	if (!wirq->name) {  in dev_pm_set_dedicated_wake_irq()
179 		err = -ENOMEM;  in dev_pm_set_dedicated_wake_irq()
183 	wirq->dev = dev;  in dev_pm_set_dedicated_wake_irq()
184 	wirq->irq = irq;  in dev_pm_set_dedicated_wake_irq()
191 	 * Consumer device may need to power up and restore state  in dev_pm_set_dedicated_wake_irq()
195 				   IRQF_ONESHOT, wirq->name, wirq);  in dev_pm_set_dedicated_wake_irq()
203 	wirq->status = WAKE_IRQ_DEDICATED_ALLOCATED;  in dev_pm_set_dedicated_wake_irq()
210 	kfree(wirq->name);  in dev_pm_set_dedicated_wake_irq()
219  * dev_pm_enable_wake_irq - Enable device wake-up interrupt
223  * runtime_resume() to override the PM runtime core managed wake-up
224  * interrupt handling to enable the wake-up interrupt.
226  * Note that for runtime_suspend()) the wake-up interrupts
232 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_enable_wake_irq()
234 	if (wirq && (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED))  in dev_pm_enable_wake_irq()
235 		enable_irq(wirq->irq);  in dev_pm_enable_wake_irq()
240  * dev_pm_disable_wake_irq - Disable device wake-up interrupt
244  * runtime_suspend() to override the PM runtime core managed wake-up
245  * interrupt handling to disable the wake-up interrupt.
249 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_disable_wake_irq()
251 	if (wirq && (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED))  in dev_pm_disable_wake_irq()
252 		disable_irq_nosync(wirq->irq);  in dev_pm_disable_wake_irq()
257  * dev_pm_enable_wake_irq_check - Checks and enables wake-up interrupt
259  * @can_change_status: Can change wake-up interrupt status
261  * Enables wakeirq conditionally. We need to enable wake-up interrupt
264  * otherwise try to disable already disabled wakeirq. The wake-up interrupt
268  * Caller must hold &dev->power.lock to change wirq->status
273 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_enable_wake_irq_check()
275 	if (!wirq || !(wirq->status & WAKE_IRQ_DEDICATED_MASK))  in dev_pm_enable_wake_irq_check()
278 	if (likely(wirq->status & WAKE_IRQ_DEDICATED_MANAGED)) {  in dev_pm_enable_wake_irq_check()
281 		wirq->status |= WAKE_IRQ_DEDICATED_MANAGED;  in dev_pm_enable_wake_irq_check()
288 	enable_irq(wirq->irq);  in dev_pm_enable_wake_irq_check()
292  * dev_pm_disable_wake_irq_check - Checks and disables wake-up interrupt
295  * Disables wake-up interrupt conditionally based on status.
300 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_disable_wake_irq_check()
302 	if (!wirq || !(wirq->status & WAKE_IRQ_DEDICATED_MASK))  in dev_pm_disable_wake_irq_check()
305 	if (wirq->status & WAKE_IRQ_DEDICATED_MANAGED)  in dev_pm_disable_wake_irq_check()
306 		disable_irq_nosync(wirq->irq);  in dev_pm_disable_wake_irq_check()
310  * dev_pm_arm_wake_irq - Arm device wake-up
311  * @wirq: Device wake-up interrupt
313  * Sets up the wake-up event conditionally based on the
321 	if (device_may_wakeup(wirq->dev)) {  in dev_pm_arm_wake_irq()
322 		if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED &&  in dev_pm_arm_wake_irq()
323 		    !pm_runtime_status_suspended(wirq->dev))  in dev_pm_arm_wake_irq()
324 			enable_irq(wirq->irq);  in dev_pm_arm_wake_irq()
326 		enable_irq_wake(wirq->irq);  in dev_pm_arm_wake_irq()
331  * dev_pm_disarm_wake_irq - Disarm device wake-up
332  * @wirq: Device wake-up interrupt
334  * Clears up the wake-up event conditionally based on the
342 	if (device_may_wakeup(wirq->dev)) {  in dev_pm_disarm_wake_irq()
343 		disable_irq_wake(wirq->irq);  in dev_pm_disarm_wake_irq()
345 		if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED &&  in dev_pm_disarm_wake_irq()
346 		    !pm_runtime_status_suspended(wirq->dev))  in dev_pm_disarm_wake_irq()
347 			disable_irq_nosync(wirq->irq);  in dev_pm_disarm_wake_irq()