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