Loading...
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/suspend.h>
13#include <linux/syscore_ops.h>
14
15#include "internals.h"
16
17bool irq_pm_check_wakeup(struct irq_desc *desc)
18{
19 if (irqd_is_wakeup_armed(&desc->irq_data)) {
20 irqd_clear(&desc->irq_data, IRQD_WAKEUP_ARMED);
21 desc->istate |= IRQS_SUSPENDED | IRQS_PENDING;
22 desc->depth++;
23 irq_disable(desc);
24 pm_system_irq_wakeup(irq_desc_get_irq(desc));
25 return true;
26 }
27 return false;
28}
29
30/*
31 * Called from __setup_irq() with desc->lock held after @action has
32 * been installed in the action chain.
33 */
34void irq_pm_install_action(struct irq_desc *desc, struct irqaction *action)
35{
36 desc->nr_actions++;
37
38 if (action->flags & IRQF_FORCE_RESUME)
39 desc->force_resume_depth++;
40
41 WARN_ON_ONCE(desc->force_resume_depth &&
42 desc->force_resume_depth != desc->nr_actions);
43
44 if (action->flags & IRQF_NO_SUSPEND)
45 desc->no_suspend_depth++;
46 else if (action->flags & IRQF_COND_SUSPEND)
47 desc->cond_suspend_depth++;
48
49 WARN_ON_ONCE(desc->no_suspend_depth &&
50 (desc->no_suspend_depth +
51 desc->cond_suspend_depth) != desc->nr_actions);
52}
53
54/*
55 * Called from __free_irq() with desc->lock held after @action has
56 * been removed from the action chain.
57 */
58void irq_pm_remove_action(struct irq_desc *desc, struct irqaction *action)
59{
60 desc->nr_actions--;
61
62 if (action->flags & IRQF_FORCE_RESUME)
63 desc->force_resume_depth--;
64
65 if (action->flags & IRQF_NO_SUSPEND)
66 desc->no_suspend_depth--;
67 else if (action->flags & IRQF_COND_SUSPEND)
68 desc->cond_suspend_depth--;
69}
70
71static bool suspend_device_irq(struct irq_desc *desc)
72{
73 if (!desc->action || irq_desc_is_chained(desc) ||
74 desc->no_suspend_depth)
75 return false;
76
77 if (irqd_is_wakeup_set(&desc->irq_data)) {
78 irqd_set(&desc->irq_data, IRQD_WAKEUP_ARMED);
79 /*
80 * We return true here to force the caller to issue
81 * synchronize_irq(). We need to make sure that the
82 * IRQD_WAKEUP_ARMED is visible before we return from
83 * suspend_device_irqs().
84 */
85 return true;
86 }
87
88 desc->istate |= IRQS_SUSPENDED;
89 __disable_irq(desc);
90
91 /*
92 * Hardware which has no wakeup source configuration facility
93 * requires that the non wakeup interrupts are masked at the
94 * chip level. The chip implementation indicates that with
95 * IRQCHIP_MASK_ON_SUSPEND.
96 */
97 if (irq_desc_get_chip(desc)->flags & IRQCHIP_MASK_ON_SUSPEND)
98 mask_irq(desc);
99 return true;
100}
101
102/**
103 * suspend_device_irqs - disable all currently enabled interrupt lines
104 *
105 * During system-wide suspend or hibernation device drivers need to be
106 * prevented from receiving interrupts and this function is provided
107 * for this purpose.
108 *
109 * So we disable all interrupts and mark them IRQS_SUSPENDED except
110 * for those which are unused, those which are marked as not
111 * suspendable via an interrupt request with the flag IRQF_NO_SUSPEND
112 * set and those which are marked as active wakeup sources.
113 *
114 * The active wakeup sources are handled by the flow handler entry
115 * code which checks for the IRQD_WAKEUP_ARMED flag, suspends the
116 * interrupt and notifies the pm core about the wakeup.
117 */
118void suspend_device_irqs(void)
119{
120 struct irq_desc *desc;
121 int irq;
122
123 for_each_irq_desc(irq, desc) {
124 unsigned long flags;
125 bool sync;
126
127 if (irq_settings_is_nested_thread(desc))
128 continue;
129 raw_spin_lock_irqsave(&desc->lock, flags);
130 sync = suspend_device_irq(desc);
131 raw_spin_unlock_irqrestore(&desc->lock, flags);
132
133 if (sync)
134 synchronize_irq(irq);
135 }
136}
137EXPORT_SYMBOL_GPL(suspend_device_irqs);
138
139static void resume_irq(struct irq_desc *desc)
140{
141 irqd_clear(&desc->irq_data, IRQD_WAKEUP_ARMED);
142
143 if (desc->istate & IRQS_SUSPENDED)
144 goto resume;
145
146 /* Force resume the interrupt? */
147 if (!desc->force_resume_depth)
148 return;
149
150 /* Pretend that it got disabled ! */
151 desc->depth++;
152resume:
153 desc->istate &= ~IRQS_SUSPENDED;
154 __enable_irq(desc);
155}
156
157static void resume_irqs(bool want_early)
158{
159 struct irq_desc *desc;
160 int irq;
161
162 for_each_irq_desc(irq, desc) {
163 unsigned long flags;
164 bool is_early = desc->action &&
165 desc->action->flags & IRQF_EARLY_RESUME;
166
167 if (!is_early && want_early)
168 continue;
169 if (irq_settings_is_nested_thread(desc))
170 continue;
171
172 raw_spin_lock_irqsave(&desc->lock, flags);
173 resume_irq(desc);
174 raw_spin_unlock_irqrestore(&desc->lock, flags);
175 }
176}
177
178/**
179 * irq_pm_syscore_ops - enable interrupt lines early
180 *
181 * Enable all interrupt lines with %IRQF_EARLY_RESUME set.
182 */
183static void irq_pm_syscore_resume(void)
184{
185 resume_irqs(true);
186}
187
188static struct syscore_ops irq_pm_syscore_ops = {
189 .resume = irq_pm_syscore_resume,
190};
191
192static int __init irq_pm_init_ops(void)
193{
194 register_syscore_ops(&irq_pm_syscore_ops);
195 return 0;
196}
197
198device_initcall(irq_pm_init_ops);
199
200/**
201 * resume_device_irqs - enable interrupt lines disabled by suspend_device_irqs()
202 *
203 * Enable all non-%IRQF_EARLY_RESUME interrupt lines previously
204 * disabled by suspend_device_irqs() that have the IRQS_SUSPENDED flag
205 * set as well as those with %IRQF_FORCE_RESUME.
206 */
207void resume_device_irqs(void)
208{
209 resume_irqs(false);
210}
211EXPORT_SYMBOL_GPL(resume_device_irqs);
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 unsigned long chipflags = irq_desc_get_chip(desc)->flags;
73 struct irq_data *irqd = &desc->irq_data;
74
75 if (!desc->action || irq_desc_is_chained(desc) ||
76 desc->no_suspend_depth)
77 return false;
78
79 if (irqd_is_wakeup_set(irqd)) {
80 irqd_set(irqd, IRQD_WAKEUP_ARMED);
81
82 if ((chipflags & IRQCHIP_ENABLE_WAKEUP_ON_SUSPEND) &&
83 irqd_irq_disabled(irqd)) {
84 /*
85 * Interrupt marked for wakeup is in disabled state.
86 * Enable interrupt here to unmask/enable in irqchip
87 * to be able to resume with such interrupts.
88 */
89 __enable_irq(desc);
90 irqd_set(irqd, IRQD_IRQ_ENABLED_ON_SUSPEND);
91 }
92 /*
93 * We return true here to force the caller to issue
94 * synchronize_irq(). We need to make sure that the
95 * IRQD_WAKEUP_ARMED is visible before we return from
96 * suspend_device_irqs().
97 */
98 return true;
99 }
100
101 desc->istate |= IRQS_SUSPENDED;
102 __disable_irq(desc);
103
104 /*
105 * Hardware which has no wakeup source configuration facility
106 * requires that the non wakeup interrupts are masked at the
107 * chip level. The chip implementation indicates that with
108 * IRQCHIP_MASK_ON_SUSPEND.
109 */
110 if (chipflags & IRQCHIP_MASK_ON_SUSPEND)
111 mask_irq(desc);
112 return true;
113}
114
115/**
116 * suspend_device_irqs - disable all currently enabled interrupt lines
117 *
118 * During system-wide suspend or hibernation device drivers need to be
119 * prevented from receiving interrupts and this function is provided
120 * for this purpose.
121 *
122 * So we disable all interrupts and mark them IRQS_SUSPENDED except
123 * for those which are unused, those which are marked as not
124 * suspendable via an interrupt request with the flag IRQF_NO_SUSPEND
125 * set and those which are marked as active wakeup sources.
126 *
127 * The active wakeup sources are handled by the flow handler entry
128 * code which checks for the IRQD_WAKEUP_ARMED flag, suspends the
129 * interrupt and notifies the pm core about the wakeup.
130 */
131void suspend_device_irqs(void)
132{
133 struct irq_desc *desc;
134 int irq;
135
136 for_each_irq_desc(irq, desc) {
137 unsigned long flags;
138 bool sync;
139
140 if (irq_settings_is_nested_thread(desc))
141 continue;
142 raw_spin_lock_irqsave(&desc->lock, flags);
143 sync = suspend_device_irq(desc);
144 raw_spin_unlock_irqrestore(&desc->lock, flags);
145
146 if (sync)
147 synchronize_irq(irq);
148 }
149}
150EXPORT_SYMBOL_GPL(suspend_device_irqs);
151
152static void resume_irq(struct irq_desc *desc)
153{
154 struct irq_data *irqd = &desc->irq_data;
155
156 irqd_clear(irqd, IRQD_WAKEUP_ARMED);
157
158 if (irqd_is_enabled_on_suspend(irqd)) {
159 /*
160 * Interrupt marked for wakeup was enabled during suspend
161 * entry. Disable such interrupts to restore them back to
162 * original state.
163 */
164 __disable_irq(desc);
165 irqd_clear(irqd, IRQD_IRQ_ENABLED_ON_SUSPEND);
166 }
167
168 if (desc->istate & IRQS_SUSPENDED)
169 goto resume;
170
171 /* Force resume the interrupt? */
172 if (!desc->force_resume_depth)
173 return;
174
175 /* Pretend that it got disabled ! */
176 desc->depth++;
177 irq_state_set_disabled(desc);
178 irq_state_set_masked(desc);
179resume:
180 desc->istate &= ~IRQS_SUSPENDED;
181 __enable_irq(desc);
182}
183
184static void resume_irqs(bool want_early)
185{
186 struct irq_desc *desc;
187 int irq;
188
189 for_each_irq_desc(irq, desc) {
190 unsigned long flags;
191 bool is_early = desc->action &&
192 desc->action->flags & IRQF_EARLY_RESUME;
193
194 if (!is_early && want_early)
195 continue;
196 if (irq_settings_is_nested_thread(desc))
197 continue;
198
199 raw_spin_lock_irqsave(&desc->lock, flags);
200 resume_irq(desc);
201 raw_spin_unlock_irqrestore(&desc->lock, flags);
202 }
203}
204
205/**
206 * rearm_wake_irq - rearm a wakeup interrupt line after signaling wakeup
207 * @irq: Interrupt to rearm
208 */
209void rearm_wake_irq(unsigned int irq)
210{
211 unsigned long flags;
212 struct irq_desc *desc = irq_get_desc_buslock(irq, &flags, IRQ_GET_DESC_CHECK_GLOBAL);
213
214 if (!desc)
215 return;
216
217 if (!(desc->istate & IRQS_SUSPENDED) ||
218 !irqd_is_wakeup_set(&desc->irq_data))
219 goto unlock;
220
221 desc->istate &= ~IRQS_SUSPENDED;
222 irqd_set(&desc->irq_data, IRQD_WAKEUP_ARMED);
223 __enable_irq(desc);
224
225unlock:
226 irq_put_desc_busunlock(desc, flags);
227}
228
229/**
230 * irq_pm_syscore_ops - enable interrupt lines early
231 *
232 * Enable all interrupt lines with %IRQF_EARLY_RESUME set.
233 */
234static void irq_pm_syscore_resume(void)
235{
236 resume_irqs(true);
237}
238
239static struct syscore_ops irq_pm_syscore_ops = {
240 .resume = irq_pm_syscore_resume,
241};
242
243static int __init irq_pm_init_ops(void)
244{
245 register_syscore_ops(&irq_pm_syscore_ops);
246 return 0;
247}
248
249device_initcall(irq_pm_init_ops);
250
251/**
252 * resume_device_irqs - enable interrupt lines disabled by suspend_device_irqs()
253 *
254 * Enable all non-%IRQF_EARLY_RESUME interrupt lines previously
255 * disabled by suspend_device_irqs() that have the IRQS_SUSPENDED flag
256 * set as well as those with %IRQF_FORCE_RESUME.
257 */
258void resume_device_irqs(void)
259{
260 resume_irqs(false);
261}
262EXPORT_SYMBOL_GPL(resume_device_irqs);