1 // SPDX-License-Identifier: GPL-2.0
5 #include <linux/irq.h>
13  * dev_pm_attach_wake_irq - Attach device interrupt as a wake IRQ
15  * @wirq: Wake irq specific data
17  * Internal function to attach a dedicated wake-up interrupt as a wake IRQ.
24 		return -EINVAL;  in dev_pm_attach_wake_irq()
26 	spin_lock_irqsave(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
27 	if (dev_WARN_ONCE(dev, dev->power.wakeirq,  in dev_pm_attach_wake_irq()
28 			  "wake irq already initialized\n")) {  in dev_pm_attach_wake_irq()
29 		spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
30 		return -EEXIST;  in dev_pm_attach_wake_irq()
33 	dev->power.wakeirq = wirq;  in dev_pm_attach_wake_irq()
36 	spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_attach_wake_irq()
41  * dev_pm_set_wake_irq - Attach device IO interrupt as wake IRQ
43  * @irq: Device IO interrupt
45  * Attach a device IO interrupt as a wake IRQ. The wake IRQ gets
46  * automatically configured for wake-up from suspend  based
50 int dev_pm_set_wake_irq(struct device *dev, int irq)  in dev_pm_set_wake_irq()  argument
55 	if (irq < 0)  in dev_pm_set_wake_irq()
56 		return -EINVAL;  in dev_pm_set_wake_irq()
60 		return -ENOMEM;  in dev_pm_set_wake_irq()
62 	wirq->dev = dev;  in dev_pm_set_wake_irq()
63 	wirq->irq = irq;  in dev_pm_set_wake_irq()
74  * dev_pm_clear_wake_irq - Detach a device IO interrupt wake IRQ
77  * Detach a device wake IRQ and free resources.
81  * a wake IRQ configured. This avoid adding wake IRQ specific
86 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_clear_wake_irq()
92 	spin_lock_irqsave(&dev->power.lock, flags);  in dev_pm_clear_wake_irq()
94 	dev->power.wakeirq = NULL;  in dev_pm_clear_wake_irq()
95 	spin_unlock_irqrestore(&dev->power.lock, flags);  in dev_pm_clear_wake_irq()
97 	if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED) {  in dev_pm_clear_wake_irq()
98 		free_irq(wirq->irq, wirq);  in dev_pm_clear_wake_irq()
99 		wirq->status &= ~WAKE_IRQ_DEDICATED_MASK;  in dev_pm_clear_wake_irq()
101 	kfree(wirq->name);  in dev_pm_clear_wake_irq()
112  * devm_pm_set_wake_irq - device-managed variant of dev_pm_set_wake_irq
114  * @irq: Device IO interrupt
117  * Attach a device IO interrupt as a wake IRQ, same with dev_pm_set_wake_irq,
118  * but the device will be auto clear wake capability on driver detach.
120 int devm_pm_set_wake_irq(struct device *dev, int irq)  in devm_pm_set_wake_irq()  argument
124 	ret = dev_pm_set_wake_irq(dev, irq);  in devm_pm_set_wake_irq()
133  * handle_threaded_wake_irq - Handler for dedicated wake-up interrupts
134  * @irq: Device specific dedicated wake-up interrupt
135  * @_wirq: Wake IRQ data
137  * Some devices have a separate wake-up interrupt in addition to the
138  * device IO interrupt. The wake-up interrupt signals that a device
140  * specific pm_runtime functions to wake the device, and then it's
143  * use a threaded IRQ.
146  * We assume that the wake-up interrupt just needs to wake-up the
147  * device, and then device's pm_runtime_resume() can deal with the
150 static irqreturn_t handle_threaded_wake_irq(int irq, void *_wirq)  in handle_threaded_wake_irq()  argument
156 	if (irqd_is_wakeup_set(irq_get_irq_data(irq))) {  in handle_threaded_wake_irq()
157 		pm_wakeup_event(wirq->dev, 0);  in handle_threaded_wake_irq()
163 	res = pm_runtime_resume(wirq->dev);  in handle_threaded_wake_irq()
165 		dev_warn(wirq->dev,  in handle_threaded_wake_irq()
166 			 "wake IRQ with no resume: %i\n", res);  in handle_threaded_wake_irq()
171 static int __dev_pm_set_dedicated_wake_irq(struct device *dev, int irq, unsigned int flag)  in __dev_pm_set_dedicated_wake_irq()  argument
176 	if (irq < 0)  in __dev_pm_set_dedicated_wake_irq()
177 		return -EINVAL;  in __dev_pm_set_dedicated_wake_irq()
181 		return -ENOMEM;  in __dev_pm_set_dedicated_wake_irq()
183 	wirq->name = kasprintf(GFP_KERNEL, "%s:wakeup", dev_name(dev));  in __dev_pm_set_dedicated_wake_irq()
184 	if (!wirq->name) {  in __dev_pm_set_dedicated_wake_irq()
185 		err = -ENOMEM;  in __dev_pm_set_dedicated_wake_irq()
189 	wirq->dev = dev;  in __dev_pm_set_dedicated_wake_irq()
190 	wirq->irq = irq;  in __dev_pm_set_dedicated_wake_irq()
193 	irq_set_status_flags(irq, IRQ_DISABLE_UNLAZY);  in __dev_pm_set_dedicated_wake_irq()
197 	 * so we use a threaded irq.  in __dev_pm_set_dedicated_wake_irq()
199 	err = request_threaded_irq(irq, NULL, handle_threaded_wake_irq,  in __dev_pm_set_dedicated_wake_irq()
201 				   wirq->name, wirq);  in __dev_pm_set_dedicated_wake_irq()
209 	wirq->status = WAKE_IRQ_DEDICATED_ALLOCATED | flag;  in __dev_pm_set_dedicated_wake_irq()
214 	free_irq(irq, wirq);  in __dev_pm_set_dedicated_wake_irq()
216 	kfree(wirq->name);  in __dev_pm_set_dedicated_wake_irq()
224  * dev_pm_set_dedicated_wake_irq - Request a dedicated wake-up interrupt
226  * @irq: Device wake-up interrupt
228  * Unless your hardware has separate wake-up interrupts in addition
232  * a dedicated wake-up interrupt in addition to the device IO
235 int dev_pm_set_dedicated_wake_irq(struct device *dev, int irq)  in dev_pm_set_dedicated_wake_irq()  argument
237 	return __dev_pm_set_dedicated_wake_irq(dev, irq, 0);  in dev_pm_set_dedicated_wake_irq()
242  * dev_pm_set_dedicated_wake_irq_reverse - Request a dedicated wake-up interrupt
245  * @irq: Device wake-up interrupt
247  * Unless your hardware has separate wake-up interrupts in addition
251  * wake-up interrupt in addition to the device IO interrupt. It sets
253  * to enable dedicated wake-up interrupt after running the runtime suspend
256 int dev_pm_set_dedicated_wake_irq_reverse(struct device *dev, int irq)  in dev_pm_set_dedicated_wake_irq_reverse()  argument
258 	return __dev_pm_set_dedicated_wake_irq(dev, irq, WAKE_IRQ_DEDICATED_REVERSE);  in dev_pm_set_dedicated_wake_irq_reverse()
263  * dev_pm_enable_wake_irq_check - Checks and enables wake-up interrupt
265  * @can_change_status: Can change wake-up interrupt status
267  * Enables wakeirq conditionally. We need to enable wake-up interrupt
270  * otherwise try to disable already disabled wakeirq. The wake-up interrupt
274  * Caller must hold &dev->power.lock to change wirq->status
279 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_enable_wake_irq_check()
281 	if (!wirq || !(wirq->status & WAKE_IRQ_DEDICATED_MASK))  in dev_pm_enable_wake_irq_check()
284 	if (likely(wirq->status & WAKE_IRQ_DEDICATED_MANAGED)) {  in dev_pm_enable_wake_irq_check()
287 		wirq->status |= WAKE_IRQ_DEDICATED_MANAGED;  in dev_pm_enable_wake_irq_check()
294 	if (!can_change_status || !(wirq->status & WAKE_IRQ_DEDICATED_REVERSE)) {  in dev_pm_enable_wake_irq_check()
295 		enable_irq(wirq->irq);  in dev_pm_enable_wake_irq_check()
296 		wirq->status |= WAKE_IRQ_DEDICATED_ENABLED;  in dev_pm_enable_wake_irq_check()
301  * dev_pm_disable_wake_irq_check - Checks and disables wake-up interrupt
305  * Disables wake-up interrupt conditionally based on status.
310 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_disable_wake_irq_check()
312 	if (!wirq || !(wirq->status & WAKE_IRQ_DEDICATED_MASK))  in dev_pm_disable_wake_irq_check()
315 	if (cond_disable && (wirq->status & WAKE_IRQ_DEDICATED_REVERSE))  in dev_pm_disable_wake_irq_check()
318 	if (wirq->status & WAKE_IRQ_DEDICATED_MANAGED) {  in dev_pm_disable_wake_irq_check()
319 		wirq->status &= ~WAKE_IRQ_DEDICATED_ENABLED;  in dev_pm_disable_wake_irq_check()
320 		disable_irq_nosync(wirq->irq);  in dev_pm_disable_wake_irq_check()
325  * dev_pm_enable_wake_irq_complete - enable wake IRQ not enabled before
326  * @dev: Device using the wake IRQ
328  * Enable wake IRQ conditionally based on status, mainly used if want to
329  * enable wake IRQ after running ->runtime_suspend() which depends on
336 	struct wake_irq *wirq = dev->power.wakeirq;  in dev_pm_enable_wake_irq_complete()
338 	if (!wirq || !(wirq->status & WAKE_IRQ_DEDICATED_MASK))  in dev_pm_enable_wake_irq_complete()
341 	if (wirq->status & WAKE_IRQ_DEDICATED_MANAGED &&  in dev_pm_enable_wake_irq_complete()
342 	    wirq->status & WAKE_IRQ_DEDICATED_REVERSE) {  in dev_pm_enable_wake_irq_complete()
343 		enable_irq(wirq->irq);  in dev_pm_enable_wake_irq_complete()
344 		wirq->status |= WAKE_IRQ_DEDICATED_ENABLED;  in dev_pm_enable_wake_irq_complete()
349  * dev_pm_arm_wake_irq - Arm device wake-up
350  * @wirq: Device wake-up interrupt
352  * Sets up the wake-up event conditionally based on the
360 	if (device_may_wakeup(wirq->dev)) {  in dev_pm_arm_wake_irq()
361 		if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED &&  in dev_pm_arm_wake_irq()
362 		    !(wirq->status & WAKE_IRQ_DEDICATED_ENABLED))  in dev_pm_arm_wake_irq()
363 			enable_irq(wirq->irq);  in dev_pm_arm_wake_irq()
365 		enable_irq_wake(wirq->irq);  in dev_pm_arm_wake_irq()
370  * dev_pm_disarm_wake_irq - Disarm device wake-up
371  * @wirq: Device wake-up interrupt
373  * Clears up the wake-up event conditionally based on the
381 	if (device_may_wakeup(wirq->dev)) {  in dev_pm_disarm_wake_irq()
382 		disable_irq_wake(wirq->irq);  in dev_pm_disarm_wake_irq()
384 		if (wirq->status & WAKE_IRQ_DEDICATED_ALLOCATED &&  in dev_pm_disarm_wake_irq()
385 		    !(wirq->status & WAKE_IRQ_DEDICATED_ENABLED))  in dev_pm_disarm_wake_irq()
386 			disable_irq_nosync(wirq->irq);  in dev_pm_disarm_wake_irq()