1 /* 2 * pm_wakeup.h - Power management wakeup interface 3 * 4 * Copyright (C) 2008 Alan Stern 5 * Copyright (C) 2010 Rafael J. Wysocki, Novell Inc. 6 * 7 * This program is free software; you can redistribute it and/or modify 8 * it under the terms of the GNU General Public License as published by 9 * the Free Software Foundation; either version 2 of the License, or 10 * (at your option) any later version. 11 * 12 * This program is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 * GNU General Public License for more details. 16 * 17 * You should have received a copy of the GNU General Public License 18 * along with this program; if not, write to the Free Software 19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 20 */ 21 22 #ifndef _LINUX_PM_WAKEUP_H 23 #define _LINUX_PM_WAKEUP_H 24 25 #ifndef _DEVICE_H_ 26 # error "please don't include this file directly" 27 #endif 28 29 #include <linux/types.h> 30 31 /** 32 * struct wakeup_source - Representation of wakeup sources 33 * 34 * @total_time: Total time this wakeup source has been active. 35 * @max_time: Maximum time this wakeup source has been continuously active. 36 * @last_time: Monotonic clock when the wakeup source's was activated last time. 37 * @event_count: Number of signaled wakeup events. 38 * @active_count: Number of times the wakeup sorce was activated. 39 * @relax_count: Number of times the wakeup sorce was deactivated. 40 * @hit_count: Number of times the wakeup sorce might abort system suspend. 41 * @active: Status of the wakeup source. 42 */ 43 struct wakeup_source { 44 char *name; 45 struct list_head entry; 46 spinlock_t lock; 47 struct timer_list timer; 48 unsigned long timer_expires; 49 ktime_t total_time; 50 ktime_t max_time; 51 ktime_t last_time; 52 unsigned long event_count; 53 unsigned long active_count; 54 unsigned long relax_count; 55 unsigned long hit_count; 56 unsigned int active:1; 57 }; 58 59 #ifdef CONFIG_PM_SLEEP 60 61 /* 62 * Changes to device_may_wakeup take effect on the next pm state change. 63 */ 64 65 static inline void device_set_wakeup_capable(struct device *dev, bool capable) 66 { 67 dev->power.can_wakeup = capable; 68 } 69 70 static inline bool device_can_wakeup(struct device *dev) 71 { 72 return dev->power.can_wakeup; 73 } 74 75 76 77 static inline bool device_may_wakeup(struct device *dev) 78 { 79 return dev->power.can_wakeup && !!dev->power.wakeup; 80 } 81 82 /* drivers/base/power/wakeup.c */ 83 extern struct wakeup_source *wakeup_source_create(const char *name); 84 extern void wakeup_source_destroy(struct wakeup_source *ws); 85 extern void wakeup_source_add(struct wakeup_source *ws); 86 extern void wakeup_source_remove(struct wakeup_source *ws); 87 extern struct wakeup_source *wakeup_source_register(const char *name); 88 extern void wakeup_source_unregister(struct wakeup_source *ws); 89 extern int device_wakeup_enable(struct device *dev); 90 extern int device_wakeup_disable(struct device *dev); 91 extern int device_init_wakeup(struct device *dev, bool val); 92 extern int device_set_wakeup_enable(struct device *dev, bool enable); 93 extern void __pm_stay_awake(struct wakeup_source *ws); 94 extern void pm_stay_awake(struct device *dev); 95 extern void __pm_relax(struct wakeup_source *ws); 96 extern void pm_relax(struct device *dev); 97 extern void __pm_wakeup_event(struct wakeup_source *ws, unsigned int msec); 98 extern void pm_wakeup_event(struct device *dev, unsigned int msec); 99 100 #else /* !CONFIG_PM_SLEEP */ 101 102 static inline void device_set_wakeup_capable(struct device *dev, bool capable) 103 { 104 dev->power.can_wakeup = capable; 105 } 106 107 static inline bool device_can_wakeup(struct device *dev) 108 { 109 return dev->power.can_wakeup; 110 } 111 112 static inline bool device_may_wakeup(struct device *dev) 113 { 114 return false; 115 } 116 117 static inline struct wakeup_source *wakeup_source_create(const char *name) 118 { 119 return NULL; 120 } 121 122 static inline void wakeup_source_destroy(struct wakeup_source *ws) {} 123 124 static inline void wakeup_source_add(struct wakeup_source *ws) {} 125 126 static inline void wakeup_source_remove(struct wakeup_source *ws) {} 127 128 static inline struct wakeup_source *wakeup_source_register(const char *name) 129 { 130 return NULL; 131 } 132 133 static inline void wakeup_source_unregister(struct wakeup_source *ws) {} 134 135 static inline int device_wakeup_enable(struct device *dev) 136 { 137 return -EINVAL; 138 } 139 140 static inline int device_wakeup_disable(struct device *dev) 141 { 142 return 0; 143 } 144 145 static inline int device_init_wakeup(struct device *dev, bool val) 146 { 147 dev->power.can_wakeup = val; 148 return val ? -EINVAL : 0; 149 } 150 151 152 static inline int device_set_wakeup_enable(struct device *dev, bool enable) 153 { 154 return -EINVAL; 155 } 156 157 static inline void __pm_stay_awake(struct wakeup_source *ws) {} 158 159 static inline void pm_stay_awake(struct device *dev) {} 160 161 static inline void __pm_relax(struct wakeup_source *ws) {} 162 163 static inline void pm_relax(struct device *dev) {} 164 165 static inline void __pm_wakeup_event(struct wakeup_source *ws, unsigned int msec) {} 166 167 static inline void pm_wakeup_event(struct device *dev, unsigned int msec) {} 168 169 #endif /* !CONFIG_PM_SLEEP */ 170 171 #endif /* _LINUX_PM_WAKEUP_H */ 172