Loading...
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Copyright (C) 2009 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
4 *
5 * This file contains power management functions related to interrupts.
6 */
7
8#include <linux/irq.h>
9#include <linux/module.h>
10#include <linux/interrupt.h>
11#include <linux/suspend.h>
12#include <linux/syscore_ops.h>
13
14#include "internals.h"
15
16bool irq_pm_check_wakeup(struct irq_desc *desc)
17{
18 if (irqd_is_wakeup_armed(&desc->irq_data)) {
19 irqd_clear(&desc->irq_data, IRQD_WAKEUP_ARMED);
20 desc->istate |= IRQS_SUSPENDED | IRQS_PENDING;
21 desc->depth++;
22 irq_disable(desc);
23 pm_system_irq_wakeup(irq_desc_get_irq(desc));
24 return true;
25 }
26 return false;
27}
28
29/*
30 * Called from __setup_irq() with desc->lock held after @action has
31 * been installed in the action chain.
32 */
33void irq_pm_install_action(struct irq_desc *desc, struct irqaction *action)
34{
35 desc->nr_actions++;
36
37 if (action->flags & IRQF_FORCE_RESUME)
38 desc->force_resume_depth++;
39
40 WARN_ON_ONCE(desc->force_resume_depth &&
41 desc->force_resume_depth != desc->nr_actions);
42
43 if (action->flags & IRQF_NO_SUSPEND)
44 desc->no_suspend_depth++;
45 else if (action->flags & IRQF_COND_SUSPEND)
46 desc->cond_suspend_depth++;
47
48 WARN_ON_ONCE(desc->no_suspend_depth &&
49 (desc->no_suspend_depth +
50 desc->cond_suspend_depth) != desc->nr_actions);
51}
52
53/*
54 * Called from __free_irq() with desc->lock held after @action has
55 * been removed from the action chain.
56 */
57void irq_pm_remove_action(struct irq_desc *desc, struct irqaction *action)
58{
59 desc->nr_actions--;
60
61 if (action->flags & IRQF_FORCE_RESUME)
62 desc->force_resume_depth--;
63
64 if (action->flags & IRQF_NO_SUSPEND)
65 desc->no_suspend_depth--;
66 else if (action->flags & IRQF_COND_SUSPEND)
67 desc->cond_suspend_depth--;
68}
69
70static bool suspend_device_irq(struct irq_desc *desc)
71{
72 if (!desc->action || irq_desc_is_chained(desc) ||
73 desc->no_suspend_depth)
74 return false;
75
76 if (irqd_is_wakeup_set(&desc->irq_data)) {
77 irqd_set(&desc->irq_data, IRQD_WAKEUP_ARMED);
78 /*
79 * We return true here to force the caller to issue
80 * synchronize_irq(). We need to make sure that the
81 * IRQD_WAKEUP_ARMED is visible before we return from
82 * suspend_device_irqs().
83 */
84 return true;
85 }
86
87 desc->istate |= IRQS_SUSPENDED;
88 __disable_irq(desc);
89
90 /*
91 * Hardware which has no wakeup source configuration facility
92 * requires that the non wakeup interrupts are masked at the
93 * chip level. The chip implementation indicates that with
94 * IRQCHIP_MASK_ON_SUSPEND.
95 */
96 if (irq_desc_get_chip(desc)->flags & IRQCHIP_MASK_ON_SUSPEND)
97 mask_irq(desc);
98 return true;
99}
100
101/**
102 * suspend_device_irqs - disable all currently enabled interrupt lines
103 *
104 * During system-wide suspend or hibernation device drivers need to be
105 * prevented from receiving interrupts and this function is provided
106 * for this purpose.
107 *
108 * So we disable all interrupts and mark them IRQS_SUSPENDED except
109 * for those which are unused, those which are marked as not
110 * suspendable via an interrupt request with the flag IRQF_NO_SUSPEND
111 * set and those which are marked as active wakeup sources.
112 *
113 * The active wakeup sources are handled by the flow handler entry
114 * code which checks for the IRQD_WAKEUP_ARMED flag, suspends the
115 * interrupt and notifies the pm core about the wakeup.
116 */
117void suspend_device_irqs(void)
118{
119 struct irq_desc *desc;
120 int irq;
121
122 for_each_irq_desc(irq, desc) {
123 unsigned long flags;
124 bool sync;
125
126 if (irq_settings_is_nested_thread(desc))
127 continue;
128 raw_spin_lock_irqsave(&desc->lock, flags);
129 sync = suspend_device_irq(desc);
130 raw_spin_unlock_irqrestore(&desc->lock, flags);
131
132 if (sync)
133 synchronize_irq(irq);
134 }
135}
136EXPORT_SYMBOL_GPL(suspend_device_irqs);
137
138static void resume_irq(struct irq_desc *desc)
139{
140 irqd_clear(&desc->irq_data, IRQD_WAKEUP_ARMED);
141
142 if (desc->istate & IRQS_SUSPENDED)
143 goto resume;
144
145 /* Force resume the interrupt? */
146 if (!desc->force_resume_depth)
147 return;
148
149 /* Pretend that it got disabled ! */
150 desc->depth++;
151 irq_state_set_disabled(desc);
152 irq_state_set_masked(desc);
153resume:
154 desc->istate &= ~IRQS_SUSPENDED;
155 __enable_irq(desc);
156}
157
158static void resume_irqs(bool want_early)
159{
160 struct irq_desc *desc;
161 int irq;
162
163 for_each_irq_desc(irq, desc) {
164 unsigned long flags;
165 bool is_early = desc->action &&
166 desc->action->flags & IRQF_EARLY_RESUME;
167
168 if (!is_early && want_early)
169 continue;
170 if (irq_settings_is_nested_thread(desc))
171 continue;
172
173 raw_spin_lock_irqsave(&desc->lock, flags);
174 resume_irq(desc);
175 raw_spin_unlock_irqrestore(&desc->lock, flags);
176 }
177}
178
179/**
180 * rearm_wake_irq - rearm a wakeup interrupt line after signaling wakeup
181 * @irq: Interrupt to rearm
182 */
183void rearm_wake_irq(unsigned int irq)
184{
185 unsigned long flags;
186 struct irq_desc *desc = irq_get_desc_buslock(irq, &flags, IRQ_GET_DESC_CHECK_GLOBAL);
187
188 if (!desc || !(desc->istate & IRQS_SUSPENDED) ||
189 !irqd_is_wakeup_set(&desc->irq_data))
190 return;
191
192 desc->istate &= ~IRQS_SUSPENDED;
193 irqd_set(&desc->irq_data, IRQD_WAKEUP_ARMED);
194 __enable_irq(desc);
195
196 irq_put_desc_busunlock(desc, flags);
197}
198
199/**
200 * irq_pm_syscore_ops - enable interrupt lines early
201 *
202 * Enable all interrupt lines with %IRQF_EARLY_RESUME set.
203 */
204static void irq_pm_syscore_resume(void)
205{
206 resume_irqs(true);
207}
208
209static struct syscore_ops irq_pm_syscore_ops = {
210 .resume = irq_pm_syscore_resume,
211};
212
213static int __init irq_pm_init_ops(void)
214{
215 register_syscore_ops(&irq_pm_syscore_ops);
216 return 0;
217}
218
219device_initcall(irq_pm_init_ops);
220
221/**
222 * resume_device_irqs - enable interrupt lines disabled by suspend_device_irqs()
223 *
224 * Enable all non-%IRQF_EARLY_RESUME interrupt lines previously
225 * disabled by suspend_device_irqs() that have the IRQS_SUSPENDED flag
226 * set as well as those with %IRQF_FORCE_RESUME.
227 */
228void resume_device_irqs(void)
229{
230 resume_irqs(false);
231}
232EXPORT_SYMBOL_GPL(resume_device_irqs);
1/*
2 * linux/kernel/irq/pm.c
3 *
4 * Copyright (C) 2009 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
5 *
6 * This file contains power management functions related to interrupts.
7 */
8
9#include <linux/irq.h>
10#include <linux/module.h>
11#include <linux/interrupt.h>
12#include <linux/syscore_ops.h>
13
14#include "internals.h"
15
16/**
17 * suspend_device_irqs - disable all currently enabled interrupt lines
18 *
19 * During system-wide suspend or hibernation device drivers need to be prevented
20 * from receiving interrupts and this function is provided for this purpose.
21 * It marks all interrupt lines in use, except for the timer ones, as disabled
22 * and sets the IRQS_SUSPENDED flag for each of them.
23 */
24void suspend_device_irqs(void)
25{
26 struct irq_desc *desc;
27 int irq;
28
29 for_each_irq_desc(irq, desc) {
30 unsigned long flags;
31
32 raw_spin_lock_irqsave(&desc->lock, flags);
33 __disable_irq(desc, irq, true);
34 raw_spin_unlock_irqrestore(&desc->lock, flags);
35 }
36
37 for_each_irq_desc(irq, desc)
38 if (desc->istate & IRQS_SUSPENDED)
39 synchronize_irq(irq);
40}
41EXPORT_SYMBOL_GPL(suspend_device_irqs);
42
43static void resume_irqs(bool want_early)
44{
45 struct irq_desc *desc;
46 int irq;
47
48 for_each_irq_desc(irq, desc) {
49 unsigned long flags;
50 bool is_early = desc->action &&
51 desc->action->flags & IRQF_EARLY_RESUME;
52
53 if (is_early != want_early)
54 continue;
55
56 raw_spin_lock_irqsave(&desc->lock, flags);
57 __enable_irq(desc, irq, true);
58 raw_spin_unlock_irqrestore(&desc->lock, flags);
59 }
60}
61
62/**
63 * irq_pm_syscore_ops - enable interrupt lines early
64 *
65 * Enable all interrupt lines with %IRQF_EARLY_RESUME set.
66 */
67static void irq_pm_syscore_resume(void)
68{
69 resume_irqs(true);
70}
71
72static struct syscore_ops irq_pm_syscore_ops = {
73 .resume = irq_pm_syscore_resume,
74};
75
76static int __init irq_pm_init_ops(void)
77{
78 register_syscore_ops(&irq_pm_syscore_ops);
79 return 0;
80}
81
82device_initcall(irq_pm_init_ops);
83
84/**
85 * resume_device_irqs - enable interrupt lines disabled by suspend_device_irqs()
86 *
87 * Enable all non-%IRQF_EARLY_RESUME interrupt lines previously
88 * disabled by suspend_device_irqs() that have the IRQS_SUSPENDED flag
89 * set as well as those with %IRQF_FORCE_RESUME.
90 */
91void resume_device_irqs(void)
92{
93 resume_irqs(false);
94}
95EXPORT_SYMBOL_GPL(resume_device_irqs);
96
97/**
98 * check_wakeup_irqs - check if any wake-up interrupts are pending
99 */
100int check_wakeup_irqs(void)
101{
102 struct irq_desc *desc;
103 int irq;
104
105 for_each_irq_desc(irq, desc) {
106 /*
107 * Only interrupts which are marked as wakeup source
108 * and have not been disabled before the suspend check
109 * can abort suspend.
110 */
111 if (irqd_is_wakeup_set(&desc->irq_data)) {
112 if (desc->depth == 1 && desc->istate & IRQS_PENDING)
113 return -EBUSY;
114 continue;
115 }
116 /*
117 * Check the non wakeup interrupts whether they need
118 * to be masked before finally going into suspend
119 * state. That's for hardware which has no wakeup
120 * source configuration facility. The chip
121 * implementation indicates that with
122 * IRQCHIP_MASK_ON_SUSPEND.
123 */
124 if (desc->istate & IRQS_SUSPENDED &&
125 irq_desc_get_chip(desc)->flags & IRQCHIP_MASK_ON_SUSPEND)
126 mask_irq(desc);
127 }
128
129 return 0;
130}