generic_ops.c 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233
  1. /*
  2. * drivers/base/power/generic_ops.c - Generic PM callbacks for subsystems
  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/pm.h>
  9. #include <linux/pm_runtime.h>
  10. #ifdef CONFIG_PM_RUNTIME
  11. /**
  12. * pm_generic_runtime_idle - Generic runtime idle callback for subsystems.
  13. * @dev: Device to handle.
  14. *
  15. * If PM operations are defined for the @dev's driver and they include
  16. * ->runtime_idle(), execute it and return its error code, if nonzero.
  17. * Otherwise, execute pm_runtime_suspend() for the device and return 0.
  18. */
  19. int pm_generic_runtime_idle(struct device *dev)
  20. {
  21. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  22. if (pm && pm->runtime_idle) {
  23. int ret = pm->runtime_idle(dev);
  24. if (ret)
  25. return ret;
  26. }
  27. pm_runtime_suspend(dev);
  28. return 0;
  29. }
  30. EXPORT_SYMBOL_GPL(pm_generic_runtime_idle);
  31. /**
  32. * pm_generic_runtime_suspend - Generic runtime suspend callback for subsystems.
  33. * @dev: Device to suspend.
  34. *
  35. * If PM operations are defined for the @dev's driver and they include
  36. * ->runtime_suspend(), execute it and return its error code. Otherwise,
  37. * return 0.
  38. */
  39. int pm_generic_runtime_suspend(struct device *dev)
  40. {
  41. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  42. int ret;
  43. ret = pm && pm->runtime_suspend ? pm->runtime_suspend(dev) : 0;
  44. return ret;
  45. }
  46. EXPORT_SYMBOL_GPL(pm_generic_runtime_suspend);
  47. /**
  48. * pm_generic_runtime_resume - Generic runtime resume callback for subsystems.
  49. * @dev: Device to resume.
  50. *
  51. * If PM operations are defined for the @dev's driver and they include
  52. * ->runtime_resume(), execute it and return its error code. Otherwise,
  53. * return 0.
  54. */
  55. int pm_generic_runtime_resume(struct device *dev)
  56. {
  57. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  58. int ret;
  59. ret = pm && pm->runtime_resume ? pm->runtime_resume(dev) : 0;
  60. return ret;
  61. }
  62. EXPORT_SYMBOL_GPL(pm_generic_runtime_resume);
  63. #endif /* CONFIG_PM_RUNTIME */
  64. #ifdef CONFIG_PM_SLEEP
  65. /**
  66. * __pm_generic_call - Generic suspend/freeze/poweroff/thaw subsystem callback.
  67. * @dev: Device to handle.
  68. * @event: PM transition of the system under way.
  69. *
  70. * If the device has not been suspended at run time, execute the
  71. * suspend/freeze/poweroff/thaw callback provided by its driver, if defined, and
  72. * return its error code. Otherwise, return zero.
  73. */
  74. static int __pm_generic_call(struct device *dev, int event)
  75. {
  76. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  77. int (*callback)(struct device *);
  78. if (!pm || pm_runtime_suspended(dev))
  79. return 0;
  80. switch (event) {
  81. case PM_EVENT_SUSPEND:
  82. callback = pm->suspend;
  83. break;
  84. case PM_EVENT_FREEZE:
  85. callback = pm->freeze;
  86. break;
  87. case PM_EVENT_HIBERNATE:
  88. callback = pm->poweroff;
  89. break;
  90. case PM_EVENT_THAW:
  91. callback = pm->thaw;
  92. break;
  93. default:
  94. callback = NULL;
  95. break;
  96. }
  97. return callback ? callback(dev) : 0;
  98. }
  99. /**
  100. * pm_generic_suspend - Generic suspend callback for subsystems.
  101. * @dev: Device to suspend.
  102. */
  103. int pm_generic_suspend(struct device *dev)
  104. {
  105. return __pm_generic_call(dev, PM_EVENT_SUSPEND);
  106. }
  107. EXPORT_SYMBOL_GPL(pm_generic_suspend);
  108. /**
  109. * pm_generic_freeze - Generic freeze callback for subsystems.
  110. * @dev: Device to freeze.
  111. */
  112. int pm_generic_freeze(struct device *dev)
  113. {
  114. return __pm_generic_call(dev, PM_EVENT_FREEZE);
  115. }
  116. EXPORT_SYMBOL_GPL(pm_generic_freeze);
  117. /**
  118. * pm_generic_poweroff - Generic poweroff callback for subsystems.
  119. * @dev: Device to handle.
  120. */
  121. int pm_generic_poweroff(struct device *dev)
  122. {
  123. return __pm_generic_call(dev, PM_EVENT_HIBERNATE);
  124. }
  125. EXPORT_SYMBOL_GPL(pm_generic_poweroff);
  126. /**
  127. * pm_generic_thaw - Generic thaw callback for subsystems.
  128. * @dev: Device to thaw.
  129. */
  130. int pm_generic_thaw(struct device *dev)
  131. {
  132. return __pm_generic_call(dev, PM_EVENT_THAW);
  133. }
  134. EXPORT_SYMBOL_GPL(pm_generic_thaw);
  135. /**
  136. * __pm_generic_resume - Generic resume/restore callback for subsystems.
  137. * @dev: Device to handle.
  138. * @event: PM transition of the system under way.
  139. *
  140. * Execute the resume/resotre callback provided by the @dev's driver, if
  141. * defined. If it returns 0, change the device's runtime PM status to 'active'.
  142. * Return the callback's error code.
  143. */
  144. static int __pm_generic_resume(struct device *dev, int event)
  145. {
  146. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  147. int (*callback)(struct device *);
  148. int ret;
  149. if (!pm)
  150. return 0;
  151. switch (event) {
  152. case PM_EVENT_RESUME:
  153. callback = pm->resume;
  154. break;
  155. case PM_EVENT_RESTORE:
  156. callback = pm->restore;
  157. break;
  158. default:
  159. callback = NULL;
  160. break;
  161. }
  162. if (!callback)
  163. return 0;
  164. ret = callback(dev);
  165. if (!ret && pm_runtime_enabled(dev)) {
  166. pm_runtime_disable(dev);
  167. pm_runtime_set_active(dev);
  168. pm_runtime_enable(dev);
  169. }
  170. return ret;
  171. }
  172. /**
  173. * pm_generic_resume - Generic resume callback for subsystems.
  174. * @dev: Device to resume.
  175. */
  176. int pm_generic_resume(struct device *dev)
  177. {
  178. return __pm_generic_resume(dev, PM_EVENT_RESUME);
  179. }
  180. EXPORT_SYMBOL_GPL(pm_generic_resume);
  181. /**
  182. * pm_generic_restore - Generic restore callback for subsystems.
  183. * @dev: Device to restore.
  184. */
  185. int pm_generic_restore(struct device *dev)
  186. {
  187. return __pm_generic_resume(dev, PM_EVENT_RESTORE);
  188. }
  189. EXPORT_SYMBOL_GPL(pm_generic_restore);
  190. #endif /* CONFIG_PM_SLEEP */
  191. struct dev_pm_ops generic_subsys_pm_ops = {
  192. #ifdef CONFIG_PM_SLEEP
  193. .suspend = pm_generic_suspend,
  194. .resume = pm_generic_resume,
  195. .freeze = pm_generic_freeze,
  196. .thaw = pm_generic_thaw,
  197. .poweroff = pm_generic_poweroff,
  198. .restore = pm_generic_restore,
  199. #endif
  200. #ifdef CONFIG_PM_RUNTIME
  201. .runtime_suspend = pm_generic_runtime_suspend,
  202. .runtime_resume = pm_generic_runtime_resume,
  203. .runtime_idle = pm_generic_runtime_idle,
  204. #endif
  205. };
  206. EXPORT_SYMBOL_GPL(generic_subsys_pm_ops);