kernel/irq/pm.c

   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
  17 bool 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  */
  34 void 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  */
  58 void 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
  71 static 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  */
 118 void 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 }
 137 EXPORT_SYMBOL_GPL(suspend_device_irqs);
 138
 139 static 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++;
 152         irq_state_set_disabled(desc);
 153         irq_state_set_masked(desc);
 154 resume:
 155         desc->istate &= ~IRQS_SUSPENDED;
 156         __enable_irq(desc);
 157 }
 158
 159 static void resume_irqs(bool want_early)
 160 {
 161         struct irq_desc *desc;
 162         int irq;
 163
 164         for_each_irq_desc(irq, desc) {
 165                 unsigned long flags;
 166                 bool is_early = desc->action &&
 167                         desc->action->flags & IRQF_EARLY_RESUME;
 168
 169                 if (!is_early && want_early)
 170                         continue;
 171                 if (irq_settings_is_nested_thread(desc))
 172                         continue;
 173
 174                 raw_spin_lock_irqsave(&desc->lock, flags);
 175                 resume_irq(desc);
 176                 raw_spin_unlock_irqrestore(&desc->lock, flags);
 177         }
 178 }
 179
 180 /**
 181  * irq_pm_syscore_ops - enable interrupt lines early
 182  *
 183  * Enable all interrupt lines with %IRQF_EARLY_RESUME set.
 184  */
 185 static void irq_pm_syscore_resume(void)
 186 {
 187         resume_irqs(true);
 188 }
 189
 190 static struct syscore_ops irq_pm_syscore_ops = {
 191         .resume         = irq_pm_syscore_resume,
 192 };
 193
 194 static int __init irq_pm_init_ops(void)
 195 {
 196         register_syscore_ops(&irq_pm_syscore_ops);
 197         return 0;
 198 }
 199
 200 device_initcall(irq_pm_init_ops);
 201
 202 /**
 203  * resume_device_irqs - enable interrupt lines disabled by suspend_device_irqs()
 204  *
 205  * Enable all non-%IRQF_EARLY_RESUME interrupt lines previously
 206  * disabled by suspend_device_irqs() that have the IRQS_SUSPENDED flag
 207  * set as well as those with %IRQF_FORCE_RESUME.
 208  */
 209 void resume_device_irqs(void)
 210 {
 211         resume_irqs(false);
 212 }
 213 EXPORT_SYMBOL_GPL(resume_device_irqs);