wakeup.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898
  1. /*
  2. * drivers/base/power/wakeup.c - System wakeup events framework
  3. *
  4. * Copyright (c) 2010 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
  5. *
  6. * This file is released under the GPLv2.
  7. */
  8. #include <linux/device.h>
  9. #include <linux/slab.h>
  10. #include <linux/sched.h>
  11. #include <linux/capability.h>
  12. #include <linux/export.h>
  13. #include <linux/suspend.h>
  14. #include <linux/seq_file.h>
  15. #include <linux/debugfs.h>
  16. #include <trace/events/power.h>
  17. #include "power.h"
  18. /*
  19. * If set, the suspend/hibernate code will abort transitions to a sleep state
  20. * if wakeup events are registered during or immediately before the transition.
  21. */
  22. bool events_check_enabled __read_mostly;
  23. /*
  24. * Combined counters of registered wakeup events and wakeup events in progress.
  25. * They need to be modified together atomically, so it's better to use one
  26. * atomic variable to hold them both.
  27. */
  28. static atomic_t combined_event_count = ATOMIC_INIT(0);
  29. #define IN_PROGRESS_BITS (sizeof(int) * 4)
  30. #define MAX_IN_PROGRESS ((1 << IN_PROGRESS_BITS) - 1)
  31. static void split_counters(unsigned int *cnt, unsigned int *inpr)
  32. {
  33. unsigned int comb = atomic_read(&combined_event_count);
  34. *cnt = (comb >> IN_PROGRESS_BITS);
  35. *inpr = comb & MAX_IN_PROGRESS;
  36. }
  37. /* A preserved old value of the events counter. */
  38. static unsigned int saved_count;
  39. static DEFINE_SPINLOCK(events_lock);
  40. static void pm_wakeup_timer_fn(unsigned long data);
  41. static LIST_HEAD(wakeup_sources);
  42. static DECLARE_WAIT_QUEUE_HEAD(wakeup_count_wait_queue);
  43. /**
  44. * wakeup_source_prepare - Prepare a new wakeup source for initialization.
  45. * @ws: Wakeup source to prepare.
  46. * @name: Pointer to the name of the new wakeup source.
  47. *
  48. * Callers must ensure that the @name string won't be freed when @ws is still in
  49. * use.
  50. */
  51. void wakeup_source_prepare(struct wakeup_source *ws, const char *name)
  52. {
  53. if (ws) {
  54. memset(ws, 0, sizeof(*ws));
  55. ws->name = name;
  56. }
  57. }
  58. EXPORT_SYMBOL_GPL(wakeup_source_prepare);
  59. /**
  60. * wakeup_source_create - Create a struct wakeup_source object.
  61. * @name: Name of the new wakeup source.
  62. */
  63. struct wakeup_source *wakeup_source_create(const char *name)
  64. {
  65. struct wakeup_source *ws;
  66. ws = kmalloc(sizeof(*ws), GFP_KERNEL);
  67. if (!ws)
  68. return NULL;
  69. wakeup_source_prepare(ws, name ? kstrdup(name, GFP_KERNEL) : NULL);
  70. return ws;
  71. }
  72. EXPORT_SYMBOL_GPL(wakeup_source_create);
  73. /**
  74. * wakeup_source_drop - Prepare a struct wakeup_source object for destruction.
  75. * @ws: Wakeup source to prepare for destruction.
  76. *
  77. * Callers must ensure that __pm_stay_awake() or __pm_wakeup_event() will never
  78. * be run in parallel with this function for the same wakeup source object.
  79. */
  80. void wakeup_source_drop(struct wakeup_source *ws)
  81. {
  82. if (!ws)
  83. return;
  84. del_timer_sync(&ws->timer);
  85. __pm_relax(ws);
  86. }
  87. EXPORT_SYMBOL_GPL(wakeup_source_drop);
  88. /**
  89. * wakeup_source_destroy - Destroy a struct wakeup_source object.
  90. * @ws: Wakeup source to destroy.
  91. *
  92. * Use only for wakeup source objects created with wakeup_source_create().
  93. */
  94. void wakeup_source_destroy(struct wakeup_source *ws)
  95. {
  96. if (!ws)
  97. return;
  98. wakeup_source_drop(ws);
  99. kfree(ws->name);
  100. kfree(ws);
  101. }
  102. EXPORT_SYMBOL_GPL(wakeup_source_destroy);
  103. /**
  104. * wakeup_source_add - Add given object to the list of wakeup sources.
  105. * @ws: Wakeup source object to add to the list.
  106. */
  107. void wakeup_source_add(struct wakeup_source *ws)
  108. {
  109. unsigned long flags;
  110. if (WARN_ON(!ws))
  111. return;
  112. spin_lock_init(&ws->lock);
  113. setup_timer(&ws->timer, pm_wakeup_timer_fn, (unsigned long)ws);
  114. ws->active = false;
  115. ws->last_time = ktime_get();
  116. spin_lock_irqsave(&events_lock, flags);
  117. list_add_rcu(&ws->entry, &wakeup_sources);
  118. spin_unlock_irqrestore(&events_lock, flags);
  119. }
  120. EXPORT_SYMBOL_GPL(wakeup_source_add);
  121. /**
  122. * wakeup_source_remove - Remove given object from the wakeup sources list.
  123. * @ws: Wakeup source object to remove from the list.
  124. */
  125. void wakeup_source_remove(struct wakeup_source *ws)
  126. {
  127. unsigned long flags;
  128. if (WARN_ON(!ws))
  129. return;
  130. spin_lock_irqsave(&events_lock, flags);
  131. list_del_rcu(&ws->entry);
  132. spin_unlock_irqrestore(&events_lock, flags);
  133. synchronize_rcu();
  134. }
  135. EXPORT_SYMBOL_GPL(wakeup_source_remove);
  136. /**
  137. * wakeup_source_register - Create wakeup source and add it to the list.
  138. * @name: Name of the wakeup source to register.
  139. */
  140. struct wakeup_source *wakeup_source_register(const char *name)
  141. {
  142. struct wakeup_source *ws;
  143. ws = wakeup_source_create(name);
  144. if (ws)
  145. wakeup_source_add(ws);
  146. return ws;
  147. }
  148. EXPORT_SYMBOL_GPL(wakeup_source_register);
  149. /**
  150. * wakeup_source_unregister - Remove wakeup source from the list and remove it.
  151. * @ws: Wakeup source object to unregister.
  152. */
  153. void wakeup_source_unregister(struct wakeup_source *ws)
  154. {
  155. if (ws) {
  156. wakeup_source_remove(ws);
  157. wakeup_source_destroy(ws);
  158. }
  159. }
  160. EXPORT_SYMBOL_GPL(wakeup_source_unregister);
  161. /**
  162. * device_wakeup_attach - Attach a wakeup source object to a device object.
  163. * @dev: Device to handle.
  164. * @ws: Wakeup source object to attach to @dev.
  165. *
  166. * This causes @dev to be treated as a wakeup device.
  167. */
  168. static int device_wakeup_attach(struct device *dev, struct wakeup_source *ws)
  169. {
  170. spin_lock_irq(&dev->power.lock);
  171. if (dev->power.wakeup) {
  172. spin_unlock_irq(&dev->power.lock);
  173. return -EEXIST;
  174. }
  175. dev->power.wakeup = ws;
  176. spin_unlock_irq(&dev->power.lock);
  177. return 0;
  178. }
  179. /**
  180. * device_wakeup_enable - Enable given device to be a wakeup source.
  181. * @dev: Device to handle.
  182. *
  183. * Create a wakeup source object, register it and attach it to @dev.
  184. */
  185. int device_wakeup_enable(struct device *dev)
  186. {
  187. struct wakeup_source *ws;
  188. int ret;
  189. if (!dev || !dev->power.can_wakeup)
  190. return -EINVAL;
  191. ws = wakeup_source_register(dev_name(dev));
  192. if (!ws)
  193. return -ENOMEM;
  194. ret = device_wakeup_attach(dev, ws);
  195. if (ret)
  196. wakeup_source_unregister(ws);
  197. return ret;
  198. }
  199. EXPORT_SYMBOL_GPL(device_wakeup_enable);
  200. /**
  201. * device_wakeup_detach - Detach a device's wakeup source object from it.
  202. * @dev: Device to detach the wakeup source object from.
  203. *
  204. * After it returns, @dev will not be treated as a wakeup device any more.
  205. */
  206. static struct wakeup_source *device_wakeup_detach(struct device *dev)
  207. {
  208. struct wakeup_source *ws;
  209. spin_lock_irq(&dev->power.lock);
  210. ws = dev->power.wakeup;
  211. dev->power.wakeup = NULL;
  212. spin_unlock_irq(&dev->power.lock);
  213. return ws;
  214. }
  215. /**
  216. * device_wakeup_disable - Do not regard a device as a wakeup source any more.
  217. * @dev: Device to handle.
  218. *
  219. * Detach the @dev's wakeup source object from it, unregister this wakeup source
  220. * object and destroy it.
  221. */
  222. int device_wakeup_disable(struct device *dev)
  223. {
  224. struct wakeup_source *ws;
  225. if (!dev || !dev->power.can_wakeup)
  226. return -EINVAL;
  227. ws = device_wakeup_detach(dev);
  228. if (ws)
  229. wakeup_source_unregister(ws);
  230. return 0;
  231. }
  232. EXPORT_SYMBOL_GPL(device_wakeup_disable);
  233. /**
  234. * device_set_wakeup_capable - Set/reset device wakeup capability flag.
  235. * @dev: Device to handle.
  236. * @capable: Whether or not @dev is capable of waking up the system from sleep.
  237. *
  238. * If @capable is set, set the @dev's power.can_wakeup flag and add its
  239. * wakeup-related attributes to sysfs. Otherwise, unset the @dev's
  240. * power.can_wakeup flag and remove its wakeup-related attributes from sysfs.
  241. *
  242. * This function may sleep and it can't be called from any context where
  243. * sleeping is not allowed.
  244. */
  245. void device_set_wakeup_capable(struct device *dev, bool capable)
  246. {
  247. if (!!dev->power.can_wakeup == !!capable)
  248. return;
  249. if (device_is_registered(dev) && !list_empty(&dev->power.entry)) {
  250. if (capable) {
  251. if (wakeup_sysfs_add(dev))
  252. return;
  253. } else {
  254. wakeup_sysfs_remove(dev);
  255. }
  256. }
  257. dev->power.can_wakeup = capable;
  258. }
  259. EXPORT_SYMBOL_GPL(device_set_wakeup_capable);
  260. /**
  261. * device_init_wakeup - Device wakeup initialization.
  262. * @dev: Device to handle.
  263. * @enable: Whether or not to enable @dev as a wakeup device.
  264. *
  265. * By default, most devices should leave wakeup disabled. The exceptions are
  266. * devices that everyone expects to be wakeup sources: keyboards, power buttons,
  267. * possibly network interfaces, etc. Also, devices that don't generate their
  268. * own wakeup requests but merely forward requests from one bus to another
  269. * (like PCI bridges) should have wakeup enabled by default.
  270. */
  271. int device_init_wakeup(struct device *dev, bool enable)
  272. {
  273. int ret = 0;
  274. if (enable) {
  275. device_set_wakeup_capable(dev, true);
  276. ret = device_wakeup_enable(dev);
  277. } else {
  278. device_set_wakeup_capable(dev, false);
  279. }
  280. return ret;
  281. }
  282. EXPORT_SYMBOL_GPL(device_init_wakeup);
  283. /**
  284. * device_set_wakeup_enable - Enable or disable a device to wake up the system.
  285. * @dev: Device to handle.
  286. */
  287. int device_set_wakeup_enable(struct device *dev, bool enable)
  288. {
  289. if (!dev || !dev->power.can_wakeup)
  290. return -EINVAL;
  291. return enable ? device_wakeup_enable(dev) : device_wakeup_disable(dev);
  292. }
  293. EXPORT_SYMBOL_GPL(device_set_wakeup_enable);
  294. /*
  295. * The functions below use the observation that each wakeup event starts a
  296. * period in which the system should not be suspended. The moment this period
  297. * will end depends on how the wakeup event is going to be processed after being
  298. * detected and all of the possible cases can be divided into two distinct
  299. * groups.
  300. *
  301. * First, a wakeup event may be detected by the same functional unit that will
  302. * carry out the entire processing of it and possibly will pass it to user space
  303. * for further processing. In that case the functional unit that has detected
  304. * the event may later "close" the "no suspend" period associated with it
  305. * directly as soon as it has been dealt with. The pair of pm_stay_awake() and
  306. * pm_relax(), balanced with each other, is supposed to be used in such
  307. * situations.
  308. *
  309. * Second, a wakeup event may be detected by one functional unit and processed
  310. * by another one. In that case the unit that has detected it cannot really
  311. * "close" the "no suspend" period associated with it, unless it knows in
  312. * advance what's going to happen to the event during processing. This
  313. * knowledge, however, may not be available to it, so it can simply specify time
  314. * to wait before the system can be suspended and pass it as the second
  315. * argument of pm_wakeup_event().
  316. *
  317. * It is valid to call pm_relax() after pm_wakeup_event(), in which case the
  318. * "no suspend" period will be ended either by the pm_relax(), or by the timer
  319. * function executed when the timer expires, whichever comes first.
  320. */
  321. /**
  322. * wakup_source_activate - Mark given wakeup source as active.
  323. * @ws: Wakeup source to handle.
  324. *
  325. * Update the @ws' statistics and, if @ws has just been activated, notify the PM
  326. * core of the event by incrementing the counter of of wakeup events being
  327. * processed.
  328. */
  329. static void wakeup_source_activate(struct wakeup_source *ws)
  330. {
  331. unsigned int cec;
  332. /*
  333. * active wakeup source should bring the system
  334. * out of PM_SUSPEND_FREEZE state
  335. */
  336. freeze_wake();
  337. ws->active = true;
  338. ws->active_count++;
  339. ws->last_time = ktime_get();
  340. if (ws->autosleep_enabled)
  341. ws->start_prevent_time = ws->last_time;
  342. /* Increment the counter of events in progress. */
  343. cec = atomic_inc_return(&combined_event_count);
  344. trace_wakeup_source_activate(ws->name, cec);
  345. }
  346. /**
  347. * wakeup_source_report_event - Report wakeup event using the given source.
  348. * @ws: Wakeup source to report the event for.
  349. */
  350. static void wakeup_source_report_event(struct wakeup_source *ws)
  351. {
  352. ws->event_count++;
  353. /* This is racy, but the counter is approximate anyway. */
  354. if (events_check_enabled)
  355. ws->wakeup_count++;
  356. if (!ws->active)
  357. wakeup_source_activate(ws);
  358. }
  359. /**
  360. * __pm_stay_awake - Notify the PM core of a wakeup event.
  361. * @ws: Wakeup source object associated with the source of the event.
  362. *
  363. * It is safe to call this function from interrupt context.
  364. */
  365. void __pm_stay_awake(struct wakeup_source *ws)
  366. {
  367. unsigned long flags;
  368. if (!ws)
  369. return;
  370. spin_lock_irqsave(&ws->lock, flags);
  371. wakeup_source_report_event(ws);
  372. del_timer(&ws->timer);
  373. ws->timer_expires = 0;
  374. spin_unlock_irqrestore(&ws->lock, flags);
  375. }
  376. EXPORT_SYMBOL_GPL(__pm_stay_awake);
  377. /**
  378. * pm_stay_awake - Notify the PM core that a wakeup event is being processed.
  379. * @dev: Device the wakeup event is related to.
  380. *
  381. * Notify the PM core of a wakeup event (signaled by @dev) by calling
  382. * __pm_stay_awake for the @dev's wakeup source object.
  383. *
  384. * Call this function after detecting of a wakeup event if pm_relax() is going
  385. * to be called directly after processing the event (and possibly passing it to
  386. * user space for further processing).
  387. */
  388. void pm_stay_awake(struct device *dev)
  389. {
  390. unsigned long flags;
  391. if (!dev)
  392. return;
  393. spin_lock_irqsave(&dev->power.lock, flags);
  394. __pm_stay_awake(dev->power.wakeup);
  395. spin_unlock_irqrestore(&dev->power.lock, flags);
  396. }
  397. EXPORT_SYMBOL_GPL(pm_stay_awake);
  398. #ifdef CONFIG_PM_AUTOSLEEP
  399. static void update_prevent_sleep_time(struct wakeup_source *ws, ktime_t now)
  400. {
  401. ktime_t delta = ktime_sub(now, ws->start_prevent_time);
  402. ws->prevent_sleep_time = ktime_add(ws->prevent_sleep_time, delta);
  403. }
  404. #else
  405. static inline void update_prevent_sleep_time(struct wakeup_source *ws,
  406. ktime_t now) {}
  407. #endif
  408. /**
  409. * wakup_source_deactivate - Mark given wakeup source as inactive.
  410. * @ws: Wakeup source to handle.
  411. *
  412. * Update the @ws' statistics and notify the PM core that the wakeup source has
  413. * become inactive by decrementing the counter of wakeup events being processed
  414. * and incrementing the counter of registered wakeup events.
  415. */
  416. static void wakeup_source_deactivate(struct wakeup_source *ws)
  417. {
  418. unsigned int cnt, inpr, cec;
  419. ktime_t duration;
  420. ktime_t now;
  421. ws->relax_count++;
  422. /*
  423. * __pm_relax() may be called directly or from a timer function.
  424. * If it is called directly right after the timer function has been
  425. * started, but before the timer function calls __pm_relax(), it is
  426. * possible that __pm_stay_awake() will be called in the meantime and
  427. * will set ws->active. Then, ws->active may be cleared immediately
  428. * by the __pm_relax() called from the timer function, but in such a
  429. * case ws->relax_count will be different from ws->active_count.
  430. */
  431. if (ws->relax_count != ws->active_count) {
  432. ws->relax_count--;
  433. return;
  434. }
  435. ws->active = false;
  436. now = ktime_get();
  437. duration = ktime_sub(now, ws->last_time);
  438. ws->total_time = ktime_add(ws->total_time, duration);
  439. if (ktime_to_ns(duration) > ktime_to_ns(ws->max_time))
  440. ws->max_time = duration;
  441. ws->last_time = now;
  442. del_timer(&ws->timer);
  443. ws->timer_expires = 0;
  444. if (ws->autosleep_enabled)
  445. update_prevent_sleep_time(ws, now);
  446. /*
  447. * Increment the counter of registered wakeup events and decrement the
  448. * couter of wakeup events in progress simultaneously.
  449. */
  450. cec = atomic_add_return(MAX_IN_PROGRESS, &combined_event_count);
  451. trace_wakeup_source_deactivate(ws->name, cec);
  452. split_counters(&cnt, &inpr);
  453. if (!inpr && waitqueue_active(&wakeup_count_wait_queue))
  454. wake_up(&wakeup_count_wait_queue);
  455. }
  456. /**
  457. * __pm_relax - Notify the PM core that processing of a wakeup event has ended.
  458. * @ws: Wakeup source object associated with the source of the event.
  459. *
  460. * Call this function for wakeup events whose processing started with calling
  461. * __pm_stay_awake().
  462. *
  463. * It is safe to call it from interrupt context.
  464. */
  465. void __pm_relax(struct wakeup_source *ws)
  466. {
  467. unsigned long flags;
  468. if (!ws)
  469. return;
  470. spin_lock_irqsave(&ws->lock, flags);
  471. if (ws->active)
  472. wakeup_source_deactivate(ws);
  473. spin_unlock_irqrestore(&ws->lock, flags);
  474. }
  475. EXPORT_SYMBOL_GPL(__pm_relax);
  476. /**
  477. * pm_relax - Notify the PM core that processing of a wakeup event has ended.
  478. * @dev: Device that signaled the event.
  479. *
  480. * Execute __pm_relax() for the @dev's wakeup source object.
  481. */
  482. void pm_relax(struct device *dev)
  483. {
  484. unsigned long flags;
  485. if (!dev)
  486. return;
  487. spin_lock_irqsave(&dev->power.lock, flags);
  488. __pm_relax(dev->power.wakeup);
  489. spin_unlock_irqrestore(&dev->power.lock, flags);
  490. }
  491. EXPORT_SYMBOL_GPL(pm_relax);
  492. /**
  493. * pm_wakeup_timer_fn - Delayed finalization of a wakeup event.
  494. * @data: Address of the wakeup source object associated with the event source.
  495. *
  496. * Call wakeup_source_deactivate() for the wakeup source whose address is stored
  497. * in @data if it is currently active and its timer has not been canceled and
  498. * the expiration time of the timer is not in future.
  499. */
  500. static void pm_wakeup_timer_fn(unsigned long data)
  501. {
  502. struct wakeup_source *ws = (struct wakeup_source *)data;
  503. unsigned long flags;
  504. spin_lock_irqsave(&ws->lock, flags);
  505. if (ws->active && ws->timer_expires
  506. && time_after_eq(jiffies, ws->timer_expires)) {
  507. wakeup_source_deactivate(ws);
  508. ws->expire_count++;
  509. }
  510. spin_unlock_irqrestore(&ws->lock, flags);
  511. }
  512. /**
  513. * __pm_wakeup_event - Notify the PM core of a wakeup event.
  514. * @ws: Wakeup source object associated with the event source.
  515. * @msec: Anticipated event processing time (in milliseconds).
  516. *
  517. * Notify the PM core of a wakeup event whose source is @ws that will take
  518. * approximately @msec milliseconds to be processed by the kernel. If @ws is
  519. * not active, activate it. If @msec is nonzero, set up the @ws' timer to
  520. * execute pm_wakeup_timer_fn() in future.
  521. *
  522. * It is safe to call this function from interrupt context.
  523. */
  524. void __pm_wakeup_event(struct wakeup_source *ws, unsigned int msec)
  525. {
  526. unsigned long flags;
  527. unsigned long expires;
  528. if (!ws)
  529. return;
  530. spin_lock_irqsave(&ws->lock, flags);
  531. wakeup_source_report_event(ws);
  532. if (!msec) {
  533. wakeup_source_deactivate(ws);
  534. goto unlock;
  535. }
  536. expires = jiffies + msecs_to_jiffies(msec);
  537. if (!expires)
  538. expires = 1;
  539. if (!ws->timer_expires || time_after(expires, ws->timer_expires)) {
  540. mod_timer(&ws->timer, expires);
  541. ws->timer_expires = expires;
  542. }
  543. unlock:
  544. spin_unlock_irqrestore(&ws->lock, flags);
  545. }
  546. EXPORT_SYMBOL_GPL(__pm_wakeup_event);
  547. /**
  548. * pm_wakeup_event - Notify the PM core of a wakeup event.
  549. * @dev: Device the wakeup event is related to.
  550. * @msec: Anticipated event processing time (in milliseconds).
  551. *
  552. * Call __pm_wakeup_event() for the @dev's wakeup source object.
  553. */
  554. void pm_wakeup_event(struct device *dev, unsigned int msec)
  555. {
  556. unsigned long flags;
  557. if (!dev)
  558. return;
  559. spin_lock_irqsave(&dev->power.lock, flags);
  560. __pm_wakeup_event(dev->power.wakeup, msec);
  561. spin_unlock_irqrestore(&dev->power.lock, flags);
  562. }
  563. EXPORT_SYMBOL_GPL(pm_wakeup_event);
  564. static void print_active_wakeup_sources(void)
  565. {
  566. struct wakeup_source *ws;
  567. int active = 0;
  568. struct wakeup_source *last_activity_ws = NULL;
  569. rcu_read_lock();
  570. list_for_each_entry_rcu(ws, &wakeup_sources, entry) {
  571. if (ws->active) {
  572. pr_info("active wakeup source: %s\n", ws->name);
  573. active = 1;
  574. } else if (!active &&
  575. (!last_activity_ws ||
  576. ktime_to_ns(ws->last_time) >
  577. ktime_to_ns(last_activity_ws->last_time))) {
  578. last_activity_ws = ws;
  579. }
  580. }
  581. if (!active && last_activity_ws)
  582. pr_info("last active wakeup source: %s\n",
  583. last_activity_ws->name);
  584. rcu_read_unlock();
  585. }
  586. /**
  587. * pm_wakeup_pending - Check if power transition in progress should be aborted.
  588. *
  589. * Compare the current number of registered wakeup events with its preserved
  590. * value from the past and return true if new wakeup events have been registered
  591. * since the old value was stored. Also return true if the current number of
  592. * wakeup events being processed is different from zero.
  593. */
  594. bool pm_wakeup_pending(void)
  595. {
  596. unsigned long flags;
  597. bool ret = false;
  598. spin_lock_irqsave(&events_lock, flags);
  599. if (events_check_enabled) {
  600. unsigned int cnt, inpr;
  601. split_counters(&cnt, &inpr);
  602. ret = (cnt != saved_count || inpr > 0);
  603. events_check_enabled = !ret;
  604. }
  605. spin_unlock_irqrestore(&events_lock, flags);
  606. if (ret)
  607. print_active_wakeup_sources();
  608. return ret;
  609. }
  610. /**
  611. * pm_get_wakeup_count - Read the number of registered wakeup events.
  612. * @count: Address to store the value at.
  613. * @block: Whether or not to block.
  614. *
  615. * Store the number of registered wakeup events at the address in @count. If
  616. * @block is set, block until the current number of wakeup events being
  617. * processed is zero.
  618. *
  619. * Return 'false' if the current number of wakeup events being processed is
  620. * nonzero. Otherwise return 'true'.
  621. */
  622. bool pm_get_wakeup_count(unsigned int *count, bool block)
  623. {
  624. unsigned int cnt, inpr;
  625. if (block) {
  626. DEFINE_WAIT(wait);
  627. for (;;) {
  628. prepare_to_wait(&wakeup_count_wait_queue, &wait,
  629. TASK_INTERRUPTIBLE);
  630. split_counters(&cnt, &inpr);
  631. if (inpr == 0 || signal_pending(current))
  632. break;
  633. schedule();
  634. }
  635. finish_wait(&wakeup_count_wait_queue, &wait);
  636. }
  637. split_counters(&cnt, &inpr);
  638. *count = cnt;
  639. return !inpr;
  640. }
  641. /**
  642. * pm_save_wakeup_count - Save the current number of registered wakeup events.
  643. * @count: Value to compare with the current number of registered wakeup events.
  644. *
  645. * If @count is equal to the current number of registered wakeup events and the
  646. * current number of wakeup events being processed is zero, store @count as the
  647. * old number of registered wakeup events for pm_check_wakeup_events(), enable
  648. * wakeup events detection and return 'true'. Otherwise disable wakeup events
  649. * detection and return 'false'.
  650. */
  651. bool pm_save_wakeup_count(unsigned int count)
  652. {
  653. unsigned int cnt, inpr;
  654. unsigned long flags;
  655. events_check_enabled = false;
  656. spin_lock_irqsave(&events_lock, flags);
  657. split_counters(&cnt, &inpr);
  658. if (cnt == count && inpr == 0) {
  659. saved_count = count;
  660. events_check_enabled = true;
  661. }
  662. spin_unlock_irqrestore(&events_lock, flags);
  663. return events_check_enabled;
  664. }
  665. #ifdef CONFIG_PM_AUTOSLEEP
  666. /**
  667. * pm_wakep_autosleep_enabled - Modify autosleep_enabled for all wakeup sources.
  668. * @enabled: Whether to set or to clear the autosleep_enabled flags.
  669. */
  670. void pm_wakep_autosleep_enabled(bool set)
  671. {
  672. struct wakeup_source *ws;
  673. ktime_t now = ktime_get();
  674. rcu_read_lock();
  675. list_for_each_entry_rcu(ws, &wakeup_sources, entry) {
  676. spin_lock_irq(&ws->lock);
  677. if (ws->autosleep_enabled != set) {
  678. ws->autosleep_enabled = set;
  679. if (ws->active) {
  680. if (set)
  681. ws->start_prevent_time = now;
  682. else
  683. update_prevent_sleep_time(ws, now);
  684. }
  685. }
  686. spin_unlock_irq(&ws->lock);
  687. }
  688. rcu_read_unlock();
  689. }
  690. #endif /* CONFIG_PM_AUTOSLEEP */
  691. static struct dentry *wakeup_sources_stats_dentry;
  692. /**
  693. * print_wakeup_source_stats - Print wakeup source statistics information.
  694. * @m: seq_file to print the statistics into.
  695. * @ws: Wakeup source object to print the statistics for.
  696. */
  697. static int print_wakeup_source_stats(struct seq_file *m,
  698. struct wakeup_source *ws)
  699. {
  700. unsigned long flags;
  701. ktime_t total_time;
  702. ktime_t max_time;
  703. unsigned long active_count;
  704. ktime_t active_time;
  705. ktime_t prevent_sleep_time;
  706. int ret;
  707. spin_lock_irqsave(&ws->lock, flags);
  708. total_time = ws->total_time;
  709. max_time = ws->max_time;
  710. prevent_sleep_time = ws->prevent_sleep_time;
  711. active_count = ws->active_count;
  712. if (ws->active) {
  713. ktime_t now = ktime_get();
  714. active_time = ktime_sub(now, ws->last_time);
  715. total_time = ktime_add(total_time, active_time);
  716. if (active_time.tv64 > max_time.tv64)
  717. max_time = active_time;
  718. if (ws->autosleep_enabled)
  719. prevent_sleep_time = ktime_add(prevent_sleep_time,
  720. ktime_sub(now, ws->start_prevent_time));
  721. } else {
  722. active_time = ktime_set(0, 0);
  723. }
  724. ret = seq_printf(m, "%-12s\t%lu\t\t%lu\t\t%lu\t\t%lu\t\t"
  725. "%lld\t\t%lld\t\t%lld\t\t%lld\t\t%lld\n",
  726. ws->name, active_count, ws->event_count,
  727. ws->wakeup_count, ws->expire_count,
  728. ktime_to_ms(active_time), ktime_to_ms(total_time),
  729. ktime_to_ms(max_time), ktime_to_ms(ws->last_time),
  730. ktime_to_ms(prevent_sleep_time));
  731. spin_unlock_irqrestore(&ws->lock, flags);
  732. return ret;
  733. }
  734. /**
  735. * wakeup_sources_stats_show - Print wakeup sources statistics information.
  736. * @m: seq_file to print the statistics into.
  737. */
  738. static int wakeup_sources_stats_show(struct seq_file *m, void *unused)
  739. {
  740. struct wakeup_source *ws;
  741. seq_puts(m, "name\t\tactive_count\tevent_count\twakeup_count\t"
  742. "expire_count\tactive_since\ttotal_time\tmax_time\t"
  743. "last_change\tprevent_suspend_time\n");
  744. rcu_read_lock();
  745. list_for_each_entry_rcu(ws, &wakeup_sources, entry)
  746. print_wakeup_source_stats(m, ws);
  747. rcu_read_unlock();
  748. return 0;
  749. }
  750. static int wakeup_sources_stats_open(struct inode *inode, struct file *file)
  751. {
  752. return single_open(file, wakeup_sources_stats_show, NULL);
  753. }
  754. static const struct file_operations wakeup_sources_stats_fops = {
  755. .owner = THIS_MODULE,
  756. .open = wakeup_sources_stats_open,
  757. .read = seq_read,
  758. .llseek = seq_lseek,
  759. .release = single_release,
  760. };
  761. static int __init wakeup_sources_debugfs_init(void)
  762. {
  763. wakeup_sources_stats_dentry = debugfs_create_file("wakeup_sources",
  764. S_IRUGO, NULL, NULL, &wakeup_sources_stats_fops);
  765. return 0;
  766. }
  767. postcore_initcall(wakeup_sources_debugfs_init);