PM: sleep: wakeirq: Introduce device-managed devm_pm_set_dedicated_wake_irq()

Commit Message

Xu Yang March 4, 2025, 11:09 a.m. UTC

Add device-managed variant of dev_pm_set_dedicated_wake_irq() and
dev_pm_set_dedicated_wake_irq_reverse() which automatically
free and clear the wake irq on device destruction to simplify error
handling.

Signed-off-by: Xu Yang <[e-mail]>
---
 drivers/base/power/wakeirq.c | 43 ++++++++++++++++++++++++++++++++++++
 include/linux/pm_wakeirq.h   | 12 ++++++++++
 2 files changed, 55 insertions(+)

Patch

diff --git a/drivers/base/power/wakeirq.c b/drivers/base/power/wakeirq.c
index 8aa28c08b289..dc2c9cbf40e9 100644
--- a/drivers/base/power/wakeirq.c
+++ b/drivers/base/power/wakeirq.c
@@ -129,6 +129,49 @@  int devm_pm_set_wake_irq(struct device *dev, int irq)
 }
 EXPORT_SYMBOL_GPL(devm_pm_set_wake_irq);
 
+/**
+ * devm_pm_set_dedicated_wake_irq - device-managed variant of
+ *                                  dev_pm_set_dedicated_wake_irq
+ * @dev: Device entry
+ * @irq: Device IO interrupt
+ *
+ * Request a dedicated wake-up interrupt, same with dev_pm_set_dedicated_wake_irq,
+ * but the device will be auto clear wake capability on driver detach.
+ */
+int devm_pm_set_dedicated_wake_irq(struct device *dev, int irq)
+{
+	int ret;
+
+	ret = dev_pm_set_dedicated_wake_irq(dev, irq);
+	if (ret)
+		return ret;
+
+	return devm_add_action_or_reset(dev, devm_pm_clear_wake_irq, dev);
+}
+EXPORT_SYMBOL_GPL(devm_pm_set_dedicated_wake_irq);
+
+/**
+ * devm_pm_set_dedicated_wake_irq_reverse - device-managed variant of
+ *                                          dev_pm_set_dedicated_wake_irq_reverse
+ * @dev: Device entry
+ * @irq: Device IO interrupt
+ *
+ * Request a dedicated wake-up interrupt with reverse enable ordering, same with
+ * dev_pm_set_dedicated_wake_irq_reverse, but the device will be auto clear wake
+ * capability on driver detach.
+ */
+int devm_pm_set_dedicated_wake_irq_reverse(struct device *dev, int irq)
+{
+	int ret;
+
+	ret = dev_pm_set_dedicated_wake_irq_reverse(dev, irq);
+	if (ret)
+		return ret;
+
+	return devm_add_action_or_reset(dev, devm_pm_clear_wake_irq, dev);
+}
+EXPORT_SYMBOL_GPL(devm_pm_set_dedicated_wake_irq_reverse);
+
 /**
  * handle_threaded_wake_irq - Handler for dedicated wake-up interrupts
  * @irq: Device specific dedicated wake-up interrupt
diff --git a/include/linux/pm_wakeirq.h b/include/linux/pm_wakeirq.h
index 25b63ed51b76..98a532cd92fe 100644
--- a/include/linux/pm_wakeirq.h
+++ b/include/linux/pm_wakeirq.h
@@ -11,6 +11,8 @@  extern int dev_pm_set_dedicated_wake_irq(struct device *dev, int irq);
 extern int dev_pm_set_dedicated_wake_irq_reverse(struct device *dev, int irq);
 extern void dev_pm_clear_wake_irq(struct device *dev);
 extern int devm_pm_set_wake_irq(struct device *dev, int irq);
+extern int devm_pm_set_dedicated_wake_irq(struct device *dev, int irq);
+extern int devm_pm_set_dedicated_wake_irq_reverse(struct device *dev, int irq);
 
 #else	/* !CONFIG_PM */
 
@@ -38,5 +40,15 @@  static inline int devm_pm_set_wake_irq(struct device *dev, int irq)
 	return 0;
 }
 
+static inline int devm_pm_set_dedicated_wake_irq(struct device *dev, int irq)
+{
+	return 0;
+}
+
+static inline int devm_pm_set_dedicated_wake_irq_reverse(struct device *dev, int irq)
+{
+	return 0;
+}
+
 #endif	/* CONFIG_PM */
 #endif	/* _LINUX_PM_WAKEIRQ_H */