generic_ops.c 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298
  1. // SPDX-License-Identifier: GPL-2.0
  2. /*
  3. * drivers/base/power/generic_ops.c - Generic PM callbacks for subsystems
  4. *
  5. * Copyright (c) 2010 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
  6. */
  7. #include <linux/pm.h>
  8. #include <linux/pm_runtime.h>
  9. #include <linux/export.h>
  10. #ifdef CONFIG_PM
  11. /**
  12. * pm_generic_runtime_suspend - Generic runtime suspend callback for subsystems.
  13. * @dev: Device to suspend.
  14. *
  15. * If PM operations are defined for the @dev's driver and they include
  16. * ->runtime_suspend(), execute it and return its error code. Otherwise,
  17. * return 0.
  18. */
  19. int pm_generic_runtime_suspend(struct device *dev)
  20. {
  21. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  22. int ret;
  23. ret = pm && pm->runtime_suspend ? pm->runtime_suspend(dev) : 0;
  24. return ret;
  25. }
  26. EXPORT_SYMBOL_GPL(pm_generic_runtime_suspend);
  27. /**
  28. * pm_generic_runtime_resume - Generic runtime resume callback for subsystems.
  29. * @dev: Device to resume.
  30. *
  31. * If PM operations are defined for the @dev's driver and they include
  32. * ->runtime_resume(), execute it and return its error code. Otherwise,
  33. * return 0.
  34. */
  35. int pm_generic_runtime_resume(struct device *dev)
  36. {
  37. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  38. int ret;
  39. ret = pm && pm->runtime_resume ? pm->runtime_resume(dev) : 0;
  40. return ret;
  41. }
  42. EXPORT_SYMBOL_GPL(pm_generic_runtime_resume);
  43. #endif /* CONFIG_PM */
  44. #ifdef CONFIG_PM_SLEEP
  45. /**
  46. * pm_generic_prepare - Generic routine preparing a device for power transition.
  47. * @dev: Device to prepare.
  48. *
  49. * Prepare a device for a system-wide power transition.
  50. */
  51. int pm_generic_prepare(struct device *dev)
  52. {
  53. struct device_driver *drv = dev->driver;
  54. int ret = 0;
  55. if (drv && drv->pm && drv->pm->prepare)
  56. ret = drv->pm->prepare(dev);
  57. return ret;
  58. }
  59. /**
  60. * pm_generic_suspend_noirq - Generic suspend_noirq callback for subsystems.
  61. * @dev: Device to suspend.
  62. */
  63. int pm_generic_suspend_noirq(struct device *dev)
  64. {
  65. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  66. return pm && pm->suspend_noirq ? pm->suspend_noirq(dev) : 0;
  67. }
  68. EXPORT_SYMBOL_GPL(pm_generic_suspend_noirq);
  69. /**
  70. * pm_generic_suspend_late - Generic suspend_late callback for subsystems.
  71. * @dev: Device to suspend.
  72. */
  73. int pm_generic_suspend_late(struct device *dev)
  74. {
  75. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  76. return pm && pm->suspend_late ? pm->suspend_late(dev) : 0;
  77. }
  78. EXPORT_SYMBOL_GPL(pm_generic_suspend_late);
  79. /**
  80. * pm_generic_suspend - Generic suspend callback for subsystems.
  81. * @dev: Device to suspend.
  82. */
  83. int pm_generic_suspend(struct device *dev)
  84. {
  85. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  86. return pm && pm->suspend ? pm->suspend(dev) : 0;
  87. }
  88. EXPORT_SYMBOL_GPL(pm_generic_suspend);
  89. /**
  90. * pm_generic_freeze_noirq - Generic freeze_noirq callback for subsystems.
  91. * @dev: Device to freeze.
  92. */
  93. int pm_generic_freeze_noirq(struct device *dev)
  94. {
  95. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  96. return pm && pm->freeze_noirq ? pm->freeze_noirq(dev) : 0;
  97. }
  98. EXPORT_SYMBOL_GPL(pm_generic_freeze_noirq);
  99. /**
  100. * pm_generic_freeze_late - Generic freeze_late callback for subsystems.
  101. * @dev: Device to freeze.
  102. */
  103. int pm_generic_freeze_late(struct device *dev)
  104. {
  105. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  106. return pm && pm->freeze_late ? pm->freeze_late(dev) : 0;
  107. }
  108. EXPORT_SYMBOL_GPL(pm_generic_freeze_late);
  109. /**
  110. * pm_generic_freeze - Generic freeze callback for subsystems.
  111. * @dev: Device to freeze.
  112. */
  113. int pm_generic_freeze(struct device *dev)
  114. {
  115. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  116. return pm && pm->freeze ? pm->freeze(dev) : 0;
  117. }
  118. EXPORT_SYMBOL_GPL(pm_generic_freeze);
  119. /**
  120. * pm_generic_poweroff_noirq - Generic poweroff_noirq callback for subsystems.
  121. * @dev: Device to handle.
  122. */
  123. int pm_generic_poweroff_noirq(struct device *dev)
  124. {
  125. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  126. return pm && pm->poweroff_noirq ? pm->poweroff_noirq(dev) : 0;
  127. }
  128. EXPORT_SYMBOL_GPL(pm_generic_poweroff_noirq);
  129. /**
  130. * pm_generic_poweroff_late - Generic poweroff_late callback for subsystems.
  131. * @dev: Device to handle.
  132. */
  133. int pm_generic_poweroff_late(struct device *dev)
  134. {
  135. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  136. return pm && pm->poweroff_late ? pm->poweroff_late(dev) : 0;
  137. }
  138. EXPORT_SYMBOL_GPL(pm_generic_poweroff_late);
  139. /**
  140. * pm_generic_poweroff - Generic poweroff callback for subsystems.
  141. * @dev: Device to handle.
  142. */
  143. int pm_generic_poweroff(struct device *dev)
  144. {
  145. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  146. return pm && pm->poweroff ? pm->poweroff(dev) : 0;
  147. }
  148. EXPORT_SYMBOL_GPL(pm_generic_poweroff);
  149. /**
  150. * pm_generic_thaw_noirq - Generic thaw_noirq callback for subsystems.
  151. * @dev: Device to thaw.
  152. */
  153. int pm_generic_thaw_noirq(struct device *dev)
  154. {
  155. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  156. return pm && pm->thaw_noirq ? pm->thaw_noirq(dev) : 0;
  157. }
  158. EXPORT_SYMBOL_GPL(pm_generic_thaw_noirq);
  159. /**
  160. * pm_generic_thaw_early - Generic thaw_early callback for subsystems.
  161. * @dev: Device to thaw.
  162. */
  163. int pm_generic_thaw_early(struct device *dev)
  164. {
  165. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  166. return pm && pm->thaw_early ? pm->thaw_early(dev) : 0;
  167. }
  168. EXPORT_SYMBOL_GPL(pm_generic_thaw_early);
  169. /**
  170. * pm_generic_thaw - Generic thaw callback for subsystems.
  171. * @dev: Device to thaw.
  172. */
  173. int pm_generic_thaw(struct device *dev)
  174. {
  175. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  176. return pm && pm->thaw ? pm->thaw(dev) : 0;
  177. }
  178. EXPORT_SYMBOL_GPL(pm_generic_thaw);
  179. /**
  180. * pm_generic_resume_noirq - Generic resume_noirq callback for subsystems.
  181. * @dev: Device to resume.
  182. */
  183. int pm_generic_resume_noirq(struct device *dev)
  184. {
  185. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  186. return pm && pm->resume_noirq ? pm->resume_noirq(dev) : 0;
  187. }
  188. EXPORT_SYMBOL_GPL(pm_generic_resume_noirq);
  189. /**
  190. * pm_generic_resume_early - Generic resume_early callback for subsystems.
  191. * @dev: Device to resume.
  192. */
  193. int pm_generic_resume_early(struct device *dev)
  194. {
  195. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  196. return pm && pm->resume_early ? pm->resume_early(dev) : 0;
  197. }
  198. EXPORT_SYMBOL_GPL(pm_generic_resume_early);
  199. /**
  200. * pm_generic_resume - Generic resume callback for subsystems.
  201. * @dev: Device to resume.
  202. */
  203. int pm_generic_resume(struct device *dev)
  204. {
  205. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  206. return pm && pm->resume ? pm->resume(dev) : 0;
  207. }
  208. EXPORT_SYMBOL_GPL(pm_generic_resume);
  209. /**
  210. * pm_generic_restore_noirq - Generic restore_noirq callback for subsystems.
  211. * @dev: Device to restore.
  212. */
  213. int pm_generic_restore_noirq(struct device *dev)
  214. {
  215. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  216. return pm && pm->restore_noirq ? pm->restore_noirq(dev) : 0;
  217. }
  218. EXPORT_SYMBOL_GPL(pm_generic_restore_noirq);
  219. /**
  220. * pm_generic_restore_early - Generic restore_early callback for subsystems.
  221. * @dev: Device to resume.
  222. */
  223. int pm_generic_restore_early(struct device *dev)
  224. {
  225. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  226. return pm && pm->restore_early ? pm->restore_early(dev) : 0;
  227. }
  228. EXPORT_SYMBOL_GPL(pm_generic_restore_early);
  229. /**
  230. * pm_generic_restore - Generic restore callback for subsystems.
  231. * @dev: Device to restore.
  232. */
  233. int pm_generic_restore(struct device *dev)
  234. {
  235. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  236. return pm && pm->restore ? pm->restore(dev) : 0;
  237. }
  238. EXPORT_SYMBOL_GPL(pm_generic_restore);
  239. /**
  240. * pm_generic_complete - Generic routine completing a device power transition.
  241. * @dev: Device to handle.
  242. *
  243. * Complete a device power transition during a system-wide power transition.
  244. */
  245. void pm_generic_complete(struct device *dev)
  246. {
  247. struct device_driver *drv = dev->driver;
  248. if (drv && drv->pm && drv->pm->complete)
  249. drv->pm->complete(dev);
  250. }
  251. #endif /* CONFIG_PM_SLEEP */