domain.c 44 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701
  1. /*
  2. * drivers/base/power/domain.c - Common code related to device power domains.
  3. *
  4. * Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, Renesas Electronics Corp.
  5. *
  6. * This file is released under the GPLv2.
  7. */
  8. #include <linux/init.h>
  9. #include <linux/kernel.h>
  10. #include <linux/io.h>
  11. #include <linux/pm_runtime.h>
  12. #include <linux/pm_domain.h>
  13. #include <linux/slab.h>
  14. #include <linux/err.h>
  15. #include <linux/sched.h>
  16. #include <linux/suspend.h>
  17. #include <linux/export.h>
  18. #define GENPD_DEV_CALLBACK(genpd, type, callback, dev) \
  19. ({ \
  20. type (*__routine)(struct device *__d); \
  21. type __ret = (type)0; \
  22. \
  23. __routine = genpd->dev_ops.callback; \
  24. if (__routine) { \
  25. __ret = __routine(dev); \
  26. } else { \
  27. __routine = dev_gpd_data(dev)->ops.callback; \
  28. if (__routine) \
  29. __ret = __routine(dev); \
  30. } \
  31. __ret; \
  32. })
  33. #define GENPD_DEV_TIMED_CALLBACK(genpd, type, callback, dev, field, name) \
  34. ({ \
  35. ktime_t __start = ktime_get(); \
  36. type __retval = GENPD_DEV_CALLBACK(genpd, type, callback, dev); \
  37. s64 __elapsed = ktime_to_ns(ktime_sub(ktime_get(), __start)); \
  38. struct generic_pm_domain_data *__gpd_data = dev_gpd_data(dev); \
  39. if (__elapsed > __gpd_data->td.field) { \
  40. __gpd_data->td.field = __elapsed; \
  41. dev_warn(dev, name " latency exceeded, new value %lld ns\n", \
  42. __elapsed); \
  43. } \
  44. __retval; \
  45. })
  46. static LIST_HEAD(gpd_list);
  47. static DEFINE_MUTEX(gpd_list_lock);
  48. #ifdef CONFIG_PM
  49. struct generic_pm_domain *dev_to_genpd(struct device *dev)
  50. {
  51. if (IS_ERR_OR_NULL(dev->pm_domain))
  52. return ERR_PTR(-EINVAL);
  53. return pd_to_genpd(dev->pm_domain);
  54. }
  55. static int genpd_stop_dev(struct generic_pm_domain *genpd, struct device *dev)
  56. {
  57. return GENPD_DEV_TIMED_CALLBACK(genpd, int, stop, dev,
  58. stop_latency_ns, "stop");
  59. }
  60. static int genpd_start_dev(struct generic_pm_domain *genpd, struct device *dev)
  61. {
  62. return GENPD_DEV_TIMED_CALLBACK(genpd, int, start, dev,
  63. start_latency_ns, "start");
  64. }
  65. static int genpd_save_dev(struct generic_pm_domain *genpd, struct device *dev)
  66. {
  67. return GENPD_DEV_TIMED_CALLBACK(genpd, int, save_state, dev,
  68. save_state_latency_ns, "state save");
  69. }
  70. static int genpd_restore_dev(struct generic_pm_domain *genpd, struct device *dev)
  71. {
  72. return GENPD_DEV_TIMED_CALLBACK(genpd, int, restore_state, dev,
  73. restore_state_latency_ns,
  74. "state restore");
  75. }
  76. static bool genpd_sd_counter_dec(struct generic_pm_domain *genpd)
  77. {
  78. bool ret = false;
  79. if (!WARN_ON(atomic_read(&genpd->sd_count) == 0))
  80. ret = !!atomic_dec_and_test(&genpd->sd_count);
  81. return ret;
  82. }
  83. static void genpd_sd_counter_inc(struct generic_pm_domain *genpd)
  84. {
  85. atomic_inc(&genpd->sd_count);
  86. smp_mb__after_atomic_inc();
  87. }
  88. static void genpd_acquire_lock(struct generic_pm_domain *genpd)
  89. {
  90. DEFINE_WAIT(wait);
  91. mutex_lock(&genpd->lock);
  92. /*
  93. * Wait for the domain to transition into either the active,
  94. * or the power off state.
  95. */
  96. for (;;) {
  97. prepare_to_wait(&genpd->status_wait_queue, &wait,
  98. TASK_UNINTERRUPTIBLE);
  99. if (genpd->status == GPD_STATE_ACTIVE
  100. || genpd->status == GPD_STATE_POWER_OFF)
  101. break;
  102. mutex_unlock(&genpd->lock);
  103. schedule();
  104. mutex_lock(&genpd->lock);
  105. }
  106. finish_wait(&genpd->status_wait_queue, &wait);
  107. }
  108. static void genpd_release_lock(struct generic_pm_domain *genpd)
  109. {
  110. mutex_unlock(&genpd->lock);
  111. }
  112. static void genpd_set_active(struct generic_pm_domain *genpd)
  113. {
  114. if (genpd->resume_count == 0)
  115. genpd->status = GPD_STATE_ACTIVE;
  116. }
  117. /**
  118. * __pm_genpd_poweron - Restore power to a given PM domain and its masters.
  119. * @genpd: PM domain to power up.
  120. *
  121. * Restore power to @genpd and all of its masters so that it is possible to
  122. * resume a device belonging to it.
  123. */
  124. int __pm_genpd_poweron(struct generic_pm_domain *genpd)
  125. __releases(&genpd->lock) __acquires(&genpd->lock)
  126. {
  127. struct gpd_link *link;
  128. DEFINE_WAIT(wait);
  129. int ret = 0;
  130. /* If the domain's master is being waited for, we have to wait too. */
  131. for (;;) {
  132. prepare_to_wait(&genpd->status_wait_queue, &wait,
  133. TASK_UNINTERRUPTIBLE);
  134. if (genpd->status != GPD_STATE_WAIT_MASTER)
  135. break;
  136. mutex_unlock(&genpd->lock);
  137. schedule();
  138. mutex_lock(&genpd->lock);
  139. }
  140. finish_wait(&genpd->status_wait_queue, &wait);
  141. if (genpd->status == GPD_STATE_ACTIVE
  142. || (genpd->prepared_count > 0 && genpd->suspend_power_off))
  143. return 0;
  144. if (genpd->status != GPD_STATE_POWER_OFF) {
  145. genpd_set_active(genpd);
  146. return 0;
  147. }
  148. /*
  149. * The list is guaranteed not to change while the loop below is being
  150. * executed, unless one of the masters' .power_on() callbacks fiddles
  151. * with it.
  152. */
  153. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  154. genpd_sd_counter_inc(link->master);
  155. genpd->status = GPD_STATE_WAIT_MASTER;
  156. mutex_unlock(&genpd->lock);
  157. ret = pm_genpd_poweron(link->master);
  158. mutex_lock(&genpd->lock);
  159. /*
  160. * The "wait for parent" status is guaranteed not to change
  161. * while the master is powering on.
  162. */
  163. genpd->status = GPD_STATE_POWER_OFF;
  164. wake_up_all(&genpd->status_wait_queue);
  165. if (ret) {
  166. genpd_sd_counter_dec(link->master);
  167. goto err;
  168. }
  169. }
  170. if (genpd->power_on) {
  171. ktime_t time_start = ktime_get();
  172. s64 elapsed_ns;
  173. ret = genpd->power_on(genpd);
  174. if (ret)
  175. goto err;
  176. elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
  177. if (elapsed_ns > genpd->power_on_latency_ns) {
  178. genpd->power_on_latency_ns = elapsed_ns;
  179. if (genpd->name)
  180. pr_warning("%s: Power-on latency exceeded, "
  181. "new value %lld ns\n", genpd->name,
  182. elapsed_ns);
  183. }
  184. }
  185. genpd_set_active(genpd);
  186. return 0;
  187. err:
  188. list_for_each_entry_continue_reverse(link, &genpd->slave_links, slave_node)
  189. genpd_sd_counter_dec(link->master);
  190. return ret;
  191. }
  192. /**
  193. * pm_genpd_poweron - Restore power to a given PM domain and its masters.
  194. * @genpd: PM domain to power up.
  195. */
  196. int pm_genpd_poweron(struct generic_pm_domain *genpd)
  197. {
  198. int ret;
  199. mutex_lock(&genpd->lock);
  200. ret = __pm_genpd_poweron(genpd);
  201. mutex_unlock(&genpd->lock);
  202. return ret;
  203. }
  204. #endif /* CONFIG_PM */
  205. #ifdef CONFIG_PM_RUNTIME
  206. /**
  207. * __pm_genpd_save_device - Save the pre-suspend state of a device.
  208. * @pdd: Domain data of the device to save the state of.
  209. * @genpd: PM domain the device belongs to.
  210. */
  211. static int __pm_genpd_save_device(struct pm_domain_data *pdd,
  212. struct generic_pm_domain *genpd)
  213. __releases(&genpd->lock) __acquires(&genpd->lock)
  214. {
  215. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  216. struct device *dev = pdd->dev;
  217. int ret = 0;
  218. if (gpd_data->need_restore)
  219. return 0;
  220. mutex_unlock(&genpd->lock);
  221. genpd_start_dev(genpd, dev);
  222. ret = genpd_save_dev(genpd, dev);
  223. genpd_stop_dev(genpd, dev);
  224. mutex_lock(&genpd->lock);
  225. if (!ret)
  226. gpd_data->need_restore = true;
  227. return ret;
  228. }
  229. /**
  230. * __pm_genpd_restore_device - Restore the pre-suspend state of a device.
  231. * @pdd: Domain data of the device to restore the state of.
  232. * @genpd: PM domain the device belongs to.
  233. */
  234. static void __pm_genpd_restore_device(struct pm_domain_data *pdd,
  235. struct generic_pm_domain *genpd)
  236. __releases(&genpd->lock) __acquires(&genpd->lock)
  237. {
  238. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  239. struct device *dev = pdd->dev;
  240. if (!gpd_data->need_restore)
  241. return;
  242. mutex_unlock(&genpd->lock);
  243. genpd_start_dev(genpd, dev);
  244. genpd_restore_dev(genpd, dev);
  245. genpd_stop_dev(genpd, dev);
  246. mutex_lock(&genpd->lock);
  247. gpd_data->need_restore = false;
  248. }
  249. /**
  250. * genpd_abort_poweroff - Check if a PM domain power off should be aborted.
  251. * @genpd: PM domain to check.
  252. *
  253. * Return true if a PM domain's status changed to GPD_STATE_ACTIVE during
  254. * a "power off" operation, which means that a "power on" has occured in the
  255. * meantime, or if its resume_count field is different from zero, which means
  256. * that one of its devices has been resumed in the meantime.
  257. */
  258. static bool genpd_abort_poweroff(struct generic_pm_domain *genpd)
  259. {
  260. return genpd->status == GPD_STATE_WAIT_MASTER
  261. || genpd->status == GPD_STATE_ACTIVE || genpd->resume_count > 0;
  262. }
  263. /**
  264. * genpd_queue_power_off_work - Queue up the execution of pm_genpd_poweroff().
  265. * @genpd: PM domait to power off.
  266. *
  267. * Queue up the execution of pm_genpd_poweroff() unless it's already been done
  268. * before.
  269. */
  270. void genpd_queue_power_off_work(struct generic_pm_domain *genpd)
  271. {
  272. if (!work_pending(&genpd->power_off_work))
  273. queue_work(pm_wq, &genpd->power_off_work);
  274. }
  275. /**
  276. * pm_genpd_poweroff - Remove power from a given PM domain.
  277. * @genpd: PM domain to power down.
  278. *
  279. * If all of the @genpd's devices have been suspended and all of its subdomains
  280. * have been powered down, run the runtime suspend callbacks provided by all of
  281. * the @genpd's devices' drivers and remove power from @genpd.
  282. */
  283. static int pm_genpd_poweroff(struct generic_pm_domain *genpd)
  284. __releases(&genpd->lock) __acquires(&genpd->lock)
  285. {
  286. struct pm_domain_data *pdd;
  287. struct gpd_link *link;
  288. unsigned int not_suspended;
  289. int ret = 0;
  290. start:
  291. /*
  292. * Do not try to power off the domain in the following situations:
  293. * (1) The domain is already in the "power off" state.
  294. * (2) The domain is waiting for its master to power up.
  295. * (3) One of the domain's devices is being resumed right now.
  296. * (4) System suspend is in progress.
  297. */
  298. if (genpd->status == GPD_STATE_POWER_OFF
  299. || genpd->status == GPD_STATE_WAIT_MASTER
  300. || genpd->resume_count > 0 || genpd->prepared_count > 0)
  301. return 0;
  302. if (atomic_read(&genpd->sd_count) > 0)
  303. return -EBUSY;
  304. not_suspended = 0;
  305. list_for_each_entry(pdd, &genpd->dev_list, list_node)
  306. if (pdd->dev->driver && (!pm_runtime_suspended(pdd->dev)
  307. || pdd->dev->power.irq_safe))
  308. not_suspended++;
  309. if (not_suspended > genpd->in_progress)
  310. return -EBUSY;
  311. if (genpd->poweroff_task) {
  312. /*
  313. * Another instance of pm_genpd_poweroff() is executing
  314. * callbacks, so tell it to start over and return.
  315. */
  316. genpd->status = GPD_STATE_REPEAT;
  317. return 0;
  318. }
  319. if (genpd->gov && genpd->gov->power_down_ok) {
  320. if (!genpd->gov->power_down_ok(&genpd->domain))
  321. return -EAGAIN;
  322. }
  323. genpd->status = GPD_STATE_BUSY;
  324. genpd->poweroff_task = current;
  325. list_for_each_entry_reverse(pdd, &genpd->dev_list, list_node) {
  326. ret = atomic_read(&genpd->sd_count) == 0 ?
  327. __pm_genpd_save_device(pdd, genpd) : -EBUSY;
  328. if (genpd_abort_poweroff(genpd))
  329. goto out;
  330. if (ret) {
  331. genpd_set_active(genpd);
  332. goto out;
  333. }
  334. if (genpd->status == GPD_STATE_REPEAT) {
  335. genpd->poweroff_task = NULL;
  336. goto start;
  337. }
  338. }
  339. if (genpd->power_off) {
  340. ktime_t time_start;
  341. s64 elapsed_ns;
  342. if (atomic_read(&genpd->sd_count) > 0) {
  343. ret = -EBUSY;
  344. goto out;
  345. }
  346. time_start = ktime_get();
  347. /*
  348. * If sd_count > 0 at this point, one of the subdomains hasn't
  349. * managed to call pm_genpd_poweron() for the master yet after
  350. * incrementing it. In that case pm_genpd_poweron() will wait
  351. * for us to drop the lock, so we can call .power_off() and let
  352. * the pm_genpd_poweron() restore power for us (this shouldn't
  353. * happen very often).
  354. */
  355. ret = genpd->power_off(genpd);
  356. if (ret == -EBUSY) {
  357. genpd_set_active(genpd);
  358. goto out;
  359. }
  360. elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
  361. if (elapsed_ns > genpd->power_off_latency_ns) {
  362. genpd->power_off_latency_ns = elapsed_ns;
  363. if (genpd->name)
  364. pr_warning("%s: Power-off latency exceeded, "
  365. "new value %lld ns\n", genpd->name,
  366. elapsed_ns);
  367. }
  368. }
  369. genpd->status = GPD_STATE_POWER_OFF;
  370. genpd->power_off_time = ktime_get();
  371. /* Update PM QoS information for devices in the domain. */
  372. list_for_each_entry_reverse(pdd, &genpd->dev_list, list_node) {
  373. struct gpd_timing_data *td = &to_gpd_data(pdd)->td;
  374. pm_runtime_update_max_time_suspended(pdd->dev,
  375. td->start_latency_ns +
  376. td->restore_state_latency_ns +
  377. genpd->power_on_latency_ns);
  378. }
  379. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  380. genpd_sd_counter_dec(link->master);
  381. genpd_queue_power_off_work(link->master);
  382. }
  383. out:
  384. genpd->poweroff_task = NULL;
  385. wake_up_all(&genpd->status_wait_queue);
  386. return ret;
  387. }
  388. /**
  389. * genpd_power_off_work_fn - Power off PM domain whose subdomain count is 0.
  390. * @work: Work structure used for scheduling the execution of this function.
  391. */
  392. static void genpd_power_off_work_fn(struct work_struct *work)
  393. {
  394. struct generic_pm_domain *genpd;
  395. genpd = container_of(work, struct generic_pm_domain, power_off_work);
  396. genpd_acquire_lock(genpd);
  397. pm_genpd_poweroff(genpd);
  398. genpd_release_lock(genpd);
  399. }
  400. /**
  401. * pm_genpd_runtime_suspend - Suspend a device belonging to I/O PM domain.
  402. * @dev: Device to suspend.
  403. *
  404. * Carry out a runtime suspend of a device under the assumption that its
  405. * pm_domain field points to the domain member of an object of type
  406. * struct generic_pm_domain representing a PM domain consisting of I/O devices.
  407. */
  408. static int pm_genpd_runtime_suspend(struct device *dev)
  409. {
  410. struct generic_pm_domain *genpd;
  411. bool (*stop_ok)(struct device *__dev);
  412. int ret;
  413. dev_dbg(dev, "%s()\n", __func__);
  414. genpd = dev_to_genpd(dev);
  415. if (IS_ERR(genpd))
  416. return -EINVAL;
  417. might_sleep_if(!genpd->dev_irq_safe);
  418. stop_ok = genpd->gov ? genpd->gov->stop_ok : NULL;
  419. if (stop_ok && !stop_ok(dev))
  420. return -EBUSY;
  421. ret = genpd_stop_dev(genpd, dev);
  422. if (ret)
  423. return ret;
  424. pm_runtime_update_max_time_suspended(dev,
  425. dev_gpd_data(dev)->td.start_latency_ns);
  426. /*
  427. * If power.irq_safe is set, this routine will be run with interrupts
  428. * off, so it can't use mutexes.
  429. */
  430. if (dev->power.irq_safe)
  431. return 0;
  432. mutex_lock(&genpd->lock);
  433. genpd->in_progress++;
  434. pm_genpd_poweroff(genpd);
  435. genpd->in_progress--;
  436. mutex_unlock(&genpd->lock);
  437. return 0;
  438. }
  439. /**
  440. * pm_genpd_runtime_resume - Resume a device belonging to I/O PM domain.
  441. * @dev: Device to resume.
  442. *
  443. * Carry out a runtime resume of a device under the assumption that its
  444. * pm_domain field points to the domain member of an object of type
  445. * struct generic_pm_domain representing a PM domain consisting of I/O devices.
  446. */
  447. static int pm_genpd_runtime_resume(struct device *dev)
  448. {
  449. struct generic_pm_domain *genpd;
  450. DEFINE_WAIT(wait);
  451. int ret;
  452. dev_dbg(dev, "%s()\n", __func__);
  453. genpd = dev_to_genpd(dev);
  454. if (IS_ERR(genpd))
  455. return -EINVAL;
  456. might_sleep_if(!genpd->dev_irq_safe);
  457. /* If power.irq_safe, the PM domain is never powered off. */
  458. if (dev->power.irq_safe)
  459. goto out;
  460. mutex_lock(&genpd->lock);
  461. ret = __pm_genpd_poweron(genpd);
  462. if (ret) {
  463. mutex_unlock(&genpd->lock);
  464. return ret;
  465. }
  466. genpd->status = GPD_STATE_BUSY;
  467. genpd->resume_count++;
  468. for (;;) {
  469. prepare_to_wait(&genpd->status_wait_queue, &wait,
  470. TASK_UNINTERRUPTIBLE);
  471. /*
  472. * If current is the powering off task, we have been called
  473. * reentrantly from one of the device callbacks, so we should
  474. * not wait.
  475. */
  476. if (!genpd->poweroff_task || genpd->poweroff_task == current)
  477. break;
  478. mutex_unlock(&genpd->lock);
  479. schedule();
  480. mutex_lock(&genpd->lock);
  481. }
  482. finish_wait(&genpd->status_wait_queue, &wait);
  483. __pm_genpd_restore_device(dev->power.subsys_data->domain_data, genpd);
  484. genpd->resume_count--;
  485. genpd_set_active(genpd);
  486. wake_up_all(&genpd->status_wait_queue);
  487. mutex_unlock(&genpd->lock);
  488. out:
  489. genpd_start_dev(genpd, dev);
  490. return 0;
  491. }
  492. /**
  493. * pm_genpd_poweroff_unused - Power off all PM domains with no devices in use.
  494. */
  495. void pm_genpd_poweroff_unused(void)
  496. {
  497. struct generic_pm_domain *genpd;
  498. mutex_lock(&gpd_list_lock);
  499. list_for_each_entry(genpd, &gpd_list, gpd_list_node)
  500. genpd_queue_power_off_work(genpd);
  501. mutex_unlock(&gpd_list_lock);
  502. }
  503. #else
  504. static inline void genpd_power_off_work_fn(struct work_struct *work) {}
  505. #define pm_genpd_runtime_suspend NULL
  506. #define pm_genpd_runtime_resume NULL
  507. #endif /* CONFIG_PM_RUNTIME */
  508. #ifdef CONFIG_PM_SLEEP
  509. static bool genpd_dev_active_wakeup(struct generic_pm_domain *genpd,
  510. struct device *dev)
  511. {
  512. return GENPD_DEV_CALLBACK(genpd, bool, active_wakeup, dev);
  513. }
  514. static int genpd_suspend_dev(struct generic_pm_domain *genpd, struct device *dev)
  515. {
  516. return GENPD_DEV_CALLBACK(genpd, int, suspend, dev);
  517. }
  518. static int genpd_suspend_late(struct generic_pm_domain *genpd, struct device *dev)
  519. {
  520. return GENPD_DEV_CALLBACK(genpd, int, suspend_late, dev);
  521. }
  522. static int genpd_resume_early(struct generic_pm_domain *genpd, struct device *dev)
  523. {
  524. return GENPD_DEV_CALLBACK(genpd, int, resume_early, dev);
  525. }
  526. static int genpd_resume_dev(struct generic_pm_domain *genpd, struct device *dev)
  527. {
  528. return GENPD_DEV_CALLBACK(genpd, int, resume, dev);
  529. }
  530. static int genpd_freeze_dev(struct generic_pm_domain *genpd, struct device *dev)
  531. {
  532. return GENPD_DEV_CALLBACK(genpd, int, freeze, dev);
  533. }
  534. static int genpd_freeze_late(struct generic_pm_domain *genpd, struct device *dev)
  535. {
  536. return GENPD_DEV_CALLBACK(genpd, int, freeze_late, dev);
  537. }
  538. static int genpd_thaw_early(struct generic_pm_domain *genpd, struct device *dev)
  539. {
  540. return GENPD_DEV_CALLBACK(genpd, int, thaw_early, dev);
  541. }
  542. static int genpd_thaw_dev(struct generic_pm_domain *genpd, struct device *dev)
  543. {
  544. return GENPD_DEV_CALLBACK(genpd, int, thaw, dev);
  545. }
  546. /**
  547. * pm_genpd_sync_poweroff - Synchronously power off a PM domain and its masters.
  548. * @genpd: PM domain to power off, if possible.
  549. *
  550. * Check if the given PM domain can be powered off (during system suspend or
  551. * hibernation) and do that if so. Also, in that case propagate to its masters.
  552. *
  553. * This function is only called in "noirq" stages of system power transitions,
  554. * so it need not acquire locks (all of the "noirq" callbacks are executed
  555. * sequentially, so it is guaranteed that it will never run twice in parallel).
  556. */
  557. static void pm_genpd_sync_poweroff(struct generic_pm_domain *genpd)
  558. {
  559. struct gpd_link *link;
  560. if (genpd->status == GPD_STATE_POWER_OFF)
  561. return;
  562. if (genpd->suspended_count != genpd->device_count
  563. || atomic_read(&genpd->sd_count) > 0)
  564. return;
  565. if (genpd->power_off)
  566. genpd->power_off(genpd);
  567. genpd->status = GPD_STATE_POWER_OFF;
  568. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  569. genpd_sd_counter_dec(link->master);
  570. pm_genpd_sync_poweroff(link->master);
  571. }
  572. }
  573. /**
  574. * resume_needed - Check whether to resume a device before system suspend.
  575. * @dev: Device to check.
  576. * @genpd: PM domain the device belongs to.
  577. *
  578. * There are two cases in which a device that can wake up the system from sleep
  579. * states should be resumed by pm_genpd_prepare(): (1) if the device is enabled
  580. * to wake up the system and it has to remain active for this purpose while the
  581. * system is in the sleep state and (2) if the device is not enabled to wake up
  582. * the system from sleep states and it generally doesn't generate wakeup signals
  583. * by itself (those signals are generated on its behalf by other parts of the
  584. * system). In the latter case it may be necessary to reconfigure the device's
  585. * wakeup settings during system suspend, because it may have been set up to
  586. * signal remote wakeup from the system's working state as needed by runtime PM.
  587. * Return 'true' in either of the above cases.
  588. */
  589. static bool resume_needed(struct device *dev, struct generic_pm_domain *genpd)
  590. {
  591. bool active_wakeup;
  592. if (!device_can_wakeup(dev))
  593. return false;
  594. active_wakeup = genpd_dev_active_wakeup(genpd, dev);
  595. return device_may_wakeup(dev) ? active_wakeup : !active_wakeup;
  596. }
  597. /**
  598. * pm_genpd_prepare - Start power transition of a device in a PM domain.
  599. * @dev: Device to start the transition of.
  600. *
  601. * Start a power transition of a device (during a system-wide power transition)
  602. * under the assumption that its pm_domain field points to the domain member of
  603. * an object of type struct generic_pm_domain representing a PM domain
  604. * consisting of I/O devices.
  605. */
  606. static int pm_genpd_prepare(struct device *dev)
  607. {
  608. struct generic_pm_domain *genpd;
  609. int ret;
  610. dev_dbg(dev, "%s()\n", __func__);
  611. genpd = dev_to_genpd(dev);
  612. if (IS_ERR(genpd))
  613. return -EINVAL;
  614. /*
  615. * If a wakeup request is pending for the device, it should be woken up
  616. * at this point and a system wakeup event should be reported if it's
  617. * set up to wake up the system from sleep states.
  618. */
  619. pm_runtime_get_noresume(dev);
  620. if (pm_runtime_barrier(dev) && device_may_wakeup(dev))
  621. pm_wakeup_event(dev, 0);
  622. if (pm_wakeup_pending()) {
  623. pm_runtime_put_sync(dev);
  624. return -EBUSY;
  625. }
  626. if (resume_needed(dev, genpd))
  627. pm_runtime_resume(dev);
  628. genpd_acquire_lock(genpd);
  629. if (genpd->prepared_count++ == 0) {
  630. genpd->suspended_count = 0;
  631. genpd->suspend_power_off = genpd->status == GPD_STATE_POWER_OFF;
  632. }
  633. genpd_release_lock(genpd);
  634. if (genpd->suspend_power_off) {
  635. pm_runtime_put_noidle(dev);
  636. return 0;
  637. }
  638. /*
  639. * The PM domain must be in the GPD_STATE_ACTIVE state at this point,
  640. * so pm_genpd_poweron() will return immediately, but if the device
  641. * is suspended (e.g. it's been stopped by genpd_stop_dev()), we need
  642. * to make it operational.
  643. */
  644. pm_runtime_resume(dev);
  645. __pm_runtime_disable(dev, false);
  646. ret = pm_generic_prepare(dev);
  647. if (ret) {
  648. mutex_lock(&genpd->lock);
  649. if (--genpd->prepared_count == 0)
  650. genpd->suspend_power_off = false;
  651. mutex_unlock(&genpd->lock);
  652. pm_runtime_enable(dev);
  653. }
  654. pm_runtime_put_sync(dev);
  655. return ret;
  656. }
  657. /**
  658. * pm_genpd_suspend - Suspend a device belonging to an I/O PM domain.
  659. * @dev: Device to suspend.
  660. *
  661. * Suspend a device under the assumption that its pm_domain field points to the
  662. * domain member of an object of type struct generic_pm_domain representing
  663. * a PM domain consisting of I/O devices.
  664. */
  665. static int pm_genpd_suspend(struct device *dev)
  666. {
  667. struct generic_pm_domain *genpd;
  668. dev_dbg(dev, "%s()\n", __func__);
  669. genpd = dev_to_genpd(dev);
  670. if (IS_ERR(genpd))
  671. return -EINVAL;
  672. return genpd->suspend_power_off ? 0 : genpd_suspend_dev(genpd, dev);
  673. }
  674. /**
  675. * pm_genpd_suspend_late - Late suspend of a device from an I/O PM domain.
  676. * @dev: Device to suspend.
  677. *
  678. * Carry out a late suspend of a device under the assumption that its
  679. * pm_domain field points to the domain member of an object of type
  680. * struct generic_pm_domain representing a PM domain consisting of I/O devices.
  681. */
  682. static int pm_genpd_suspend_late(struct device *dev)
  683. {
  684. struct generic_pm_domain *genpd;
  685. dev_dbg(dev, "%s()\n", __func__);
  686. genpd = dev_to_genpd(dev);
  687. if (IS_ERR(genpd))
  688. return -EINVAL;
  689. return genpd->suspend_power_off ? 0 : genpd_suspend_late(genpd, dev);
  690. }
  691. /**
  692. * pm_genpd_suspend_noirq - Completion of suspend of device in an I/O PM domain.
  693. * @dev: Device to suspend.
  694. *
  695. * Stop the device and remove power from the domain if all devices in it have
  696. * been stopped.
  697. */
  698. static int pm_genpd_suspend_noirq(struct device *dev)
  699. {
  700. struct generic_pm_domain *genpd;
  701. dev_dbg(dev, "%s()\n", __func__);
  702. genpd = dev_to_genpd(dev);
  703. if (IS_ERR(genpd))
  704. return -EINVAL;
  705. if (genpd->suspend_power_off
  706. || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
  707. return 0;
  708. genpd_stop_dev(genpd, dev);
  709. /*
  710. * Since all of the "noirq" callbacks are executed sequentially, it is
  711. * guaranteed that this function will never run twice in parallel for
  712. * the same PM domain, so it is not necessary to use locking here.
  713. */
  714. genpd->suspended_count++;
  715. pm_genpd_sync_poweroff(genpd);
  716. return 0;
  717. }
  718. /**
  719. * pm_genpd_resume_noirq - Start of resume of device in an I/O PM domain.
  720. * @dev: Device to resume.
  721. *
  722. * Restore power to the device's PM domain, if necessary, and start the device.
  723. */
  724. static int pm_genpd_resume_noirq(struct device *dev)
  725. {
  726. struct generic_pm_domain *genpd;
  727. dev_dbg(dev, "%s()\n", __func__);
  728. genpd = dev_to_genpd(dev);
  729. if (IS_ERR(genpd))
  730. return -EINVAL;
  731. if (genpd->suspend_power_off
  732. || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
  733. return 0;
  734. /*
  735. * Since all of the "noirq" callbacks are executed sequentially, it is
  736. * guaranteed that this function will never run twice in parallel for
  737. * the same PM domain, so it is not necessary to use locking here.
  738. */
  739. pm_genpd_poweron(genpd);
  740. genpd->suspended_count--;
  741. return genpd_start_dev(genpd, dev);
  742. }
  743. /**
  744. * pm_genpd_resume_early - Early resume of a device in an I/O PM domain.
  745. * @dev: Device to resume.
  746. *
  747. * Carry out an early resume of a device under the assumption that its
  748. * pm_domain field points to the domain member of an object of type
  749. * struct generic_pm_domain representing a power domain consisting of I/O
  750. * devices.
  751. */
  752. static int pm_genpd_resume_early(struct device *dev)
  753. {
  754. struct generic_pm_domain *genpd;
  755. dev_dbg(dev, "%s()\n", __func__);
  756. genpd = dev_to_genpd(dev);
  757. if (IS_ERR(genpd))
  758. return -EINVAL;
  759. return genpd->suspend_power_off ? 0 : genpd_resume_early(genpd, dev);
  760. }
  761. /**
  762. * pm_genpd_resume - Resume of device in an I/O PM domain.
  763. * @dev: Device to resume.
  764. *
  765. * Resume a device under the assumption that its pm_domain field points to the
  766. * domain member of an object of type struct generic_pm_domain representing
  767. * a power domain consisting of I/O devices.
  768. */
  769. static int pm_genpd_resume(struct device *dev)
  770. {
  771. struct generic_pm_domain *genpd;
  772. dev_dbg(dev, "%s()\n", __func__);
  773. genpd = dev_to_genpd(dev);
  774. if (IS_ERR(genpd))
  775. return -EINVAL;
  776. return genpd->suspend_power_off ? 0 : genpd_resume_dev(genpd, dev);
  777. }
  778. /**
  779. * pm_genpd_freeze - Freezing a device in an I/O PM domain.
  780. * @dev: Device to freeze.
  781. *
  782. * Freeze a device under the assumption that its pm_domain field points to the
  783. * domain member of an object of type struct generic_pm_domain representing
  784. * a power domain consisting of I/O devices.
  785. */
  786. static int pm_genpd_freeze(struct device *dev)
  787. {
  788. struct generic_pm_domain *genpd;
  789. dev_dbg(dev, "%s()\n", __func__);
  790. genpd = dev_to_genpd(dev);
  791. if (IS_ERR(genpd))
  792. return -EINVAL;
  793. return genpd->suspend_power_off ? 0 : genpd_freeze_dev(genpd, dev);
  794. }
  795. /**
  796. * pm_genpd_freeze_late - Late freeze of a device in an I/O PM domain.
  797. * @dev: Device to freeze.
  798. *
  799. * Carry out a late freeze of a device under the assumption that its
  800. * pm_domain field points to the domain member of an object of type
  801. * struct generic_pm_domain representing a power domain consisting of I/O
  802. * devices.
  803. */
  804. static int pm_genpd_freeze_late(struct device *dev)
  805. {
  806. struct generic_pm_domain *genpd;
  807. dev_dbg(dev, "%s()\n", __func__);
  808. genpd = dev_to_genpd(dev);
  809. if (IS_ERR(genpd))
  810. return -EINVAL;
  811. return genpd->suspend_power_off ? 0 : genpd_freeze_late(genpd, dev);
  812. }
  813. /**
  814. * pm_genpd_freeze_noirq - Completion of freezing a device in an I/O PM domain.
  815. * @dev: Device to freeze.
  816. *
  817. * Carry out a late freeze of a device under the assumption that its
  818. * pm_domain field points to the domain member of an object of type
  819. * struct generic_pm_domain representing a power domain consisting of I/O
  820. * devices.
  821. */
  822. static int pm_genpd_freeze_noirq(struct device *dev)
  823. {
  824. struct generic_pm_domain *genpd;
  825. dev_dbg(dev, "%s()\n", __func__);
  826. genpd = dev_to_genpd(dev);
  827. if (IS_ERR(genpd))
  828. return -EINVAL;
  829. return genpd->suspend_power_off ? 0 : genpd_stop_dev(genpd, dev);
  830. }
  831. /**
  832. * pm_genpd_thaw_noirq - Early thaw of device in an I/O PM domain.
  833. * @dev: Device to thaw.
  834. *
  835. * Start the device, unless power has been removed from the domain already
  836. * before the system transition.
  837. */
  838. static int pm_genpd_thaw_noirq(struct device *dev)
  839. {
  840. struct generic_pm_domain *genpd;
  841. dev_dbg(dev, "%s()\n", __func__);
  842. genpd = dev_to_genpd(dev);
  843. if (IS_ERR(genpd))
  844. return -EINVAL;
  845. return genpd->suspend_power_off ? 0 : genpd_start_dev(genpd, dev);
  846. }
  847. /**
  848. * pm_genpd_thaw_early - Early thaw of device in an I/O PM domain.
  849. * @dev: Device to thaw.
  850. *
  851. * Carry out an early thaw of a device under the assumption that its
  852. * pm_domain field points to the domain member of an object of type
  853. * struct generic_pm_domain representing a power domain consisting of I/O
  854. * devices.
  855. */
  856. static int pm_genpd_thaw_early(struct device *dev)
  857. {
  858. struct generic_pm_domain *genpd;
  859. dev_dbg(dev, "%s()\n", __func__);
  860. genpd = dev_to_genpd(dev);
  861. if (IS_ERR(genpd))
  862. return -EINVAL;
  863. return genpd->suspend_power_off ? 0 : genpd_thaw_early(genpd, dev);
  864. }
  865. /**
  866. * pm_genpd_thaw - Thaw a device belonging to an I/O power domain.
  867. * @dev: Device to thaw.
  868. *
  869. * Thaw a device under the assumption that its pm_domain field points to the
  870. * domain member of an object of type struct generic_pm_domain representing
  871. * a power domain consisting of I/O devices.
  872. */
  873. static int pm_genpd_thaw(struct device *dev)
  874. {
  875. struct generic_pm_domain *genpd;
  876. dev_dbg(dev, "%s()\n", __func__);
  877. genpd = dev_to_genpd(dev);
  878. if (IS_ERR(genpd))
  879. return -EINVAL;
  880. return genpd->suspend_power_off ? 0 : genpd_thaw_dev(genpd, dev);
  881. }
  882. /**
  883. * pm_genpd_restore_noirq - Start of restore of device in an I/O PM domain.
  884. * @dev: Device to resume.
  885. *
  886. * Make sure the domain will be in the same power state as before the
  887. * hibernation the system is resuming from and start the device if necessary.
  888. */
  889. static int pm_genpd_restore_noirq(struct device *dev)
  890. {
  891. struct generic_pm_domain *genpd;
  892. dev_dbg(dev, "%s()\n", __func__);
  893. genpd = dev_to_genpd(dev);
  894. if (IS_ERR(genpd))
  895. return -EINVAL;
  896. /*
  897. * Since all of the "noirq" callbacks are executed sequentially, it is
  898. * guaranteed that this function will never run twice in parallel for
  899. * the same PM domain, so it is not necessary to use locking here.
  900. *
  901. * At this point suspended_count == 0 means we are being run for the
  902. * first time for the given domain in the present cycle.
  903. */
  904. if (genpd->suspended_count++ == 0) {
  905. /*
  906. * The boot kernel might put the domain into arbitrary state,
  907. * so make it appear as powered off to pm_genpd_poweron(), so
  908. * that it tries to power it on in case it was really off.
  909. */
  910. genpd->status = GPD_STATE_POWER_OFF;
  911. if (genpd->suspend_power_off) {
  912. /*
  913. * If the domain was off before the hibernation, make
  914. * sure it will be off going forward.
  915. */
  916. if (genpd->power_off)
  917. genpd->power_off(genpd);
  918. return 0;
  919. }
  920. }
  921. pm_genpd_poweron(genpd);
  922. return genpd_start_dev(genpd, dev);
  923. }
  924. /**
  925. * pm_genpd_complete - Complete power transition of a device in a power domain.
  926. * @dev: Device to complete the transition of.
  927. *
  928. * Complete a power transition of a device (during a system-wide power
  929. * transition) under the assumption that its pm_domain field points to the
  930. * domain member of an object of type struct generic_pm_domain representing
  931. * a power domain consisting of I/O devices.
  932. */
  933. static void pm_genpd_complete(struct device *dev)
  934. {
  935. struct generic_pm_domain *genpd;
  936. bool run_complete;
  937. dev_dbg(dev, "%s()\n", __func__);
  938. genpd = dev_to_genpd(dev);
  939. if (IS_ERR(genpd))
  940. return;
  941. mutex_lock(&genpd->lock);
  942. run_complete = !genpd->suspend_power_off;
  943. if (--genpd->prepared_count == 0)
  944. genpd->suspend_power_off = false;
  945. mutex_unlock(&genpd->lock);
  946. if (run_complete) {
  947. pm_generic_complete(dev);
  948. pm_runtime_set_active(dev);
  949. pm_runtime_enable(dev);
  950. pm_runtime_idle(dev);
  951. }
  952. }
  953. #else
  954. #define pm_genpd_prepare NULL
  955. #define pm_genpd_suspend NULL
  956. #define pm_genpd_suspend_late NULL
  957. #define pm_genpd_suspend_noirq NULL
  958. #define pm_genpd_resume_early NULL
  959. #define pm_genpd_resume_noirq NULL
  960. #define pm_genpd_resume NULL
  961. #define pm_genpd_freeze NULL
  962. #define pm_genpd_freeze_late NULL
  963. #define pm_genpd_freeze_noirq NULL
  964. #define pm_genpd_thaw_early NULL
  965. #define pm_genpd_thaw_noirq NULL
  966. #define pm_genpd_thaw NULL
  967. #define pm_genpd_restore_noirq NULL
  968. #define pm_genpd_complete NULL
  969. #endif /* CONFIG_PM_SLEEP */
  970. /**
  971. * __pm_genpd_add_device - Add a device to an I/O PM domain.
  972. * @genpd: PM domain to add the device to.
  973. * @dev: Device to be added.
  974. * @td: Set of PM QoS timing parameters to attach to the device.
  975. */
  976. int __pm_genpd_add_device(struct generic_pm_domain *genpd, struct device *dev,
  977. struct gpd_timing_data *td)
  978. {
  979. struct generic_pm_domain_data *gpd_data;
  980. struct pm_domain_data *pdd;
  981. int ret = 0;
  982. dev_dbg(dev, "%s()\n", __func__);
  983. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
  984. return -EINVAL;
  985. genpd_acquire_lock(genpd);
  986. if (genpd->status == GPD_STATE_POWER_OFF) {
  987. ret = -EINVAL;
  988. goto out;
  989. }
  990. if (genpd->prepared_count > 0) {
  991. ret = -EAGAIN;
  992. goto out;
  993. }
  994. list_for_each_entry(pdd, &genpd->dev_list, list_node)
  995. if (pdd->dev == dev) {
  996. ret = -EINVAL;
  997. goto out;
  998. }
  999. gpd_data = kzalloc(sizeof(*gpd_data), GFP_KERNEL);
  1000. if (!gpd_data) {
  1001. ret = -ENOMEM;
  1002. goto out;
  1003. }
  1004. genpd->device_count++;
  1005. dev->pm_domain = &genpd->domain;
  1006. dev_pm_get_subsys_data(dev);
  1007. dev->power.subsys_data->domain_data = &gpd_data->base;
  1008. gpd_data->base.dev = dev;
  1009. gpd_data->need_restore = false;
  1010. list_add_tail(&gpd_data->base.list_node, &genpd->dev_list);
  1011. if (td)
  1012. gpd_data->td = *td;
  1013. out:
  1014. genpd_release_lock(genpd);
  1015. return ret;
  1016. }
  1017. /**
  1018. * __pm_genpd_of_add_device - Add a device to an I/O PM domain.
  1019. * @genpd_node: Device tree node pointer representing a PM domain to which the
  1020. * the device is added to.
  1021. * @dev: Device to be added.
  1022. * @td: Set of PM QoS timing parameters to attach to the device.
  1023. */
  1024. int __pm_genpd_of_add_device(struct device_node *genpd_node, struct device *dev,
  1025. struct gpd_timing_data *td)
  1026. {
  1027. struct generic_pm_domain *genpd = NULL, *gpd;
  1028. dev_dbg(dev, "%s()\n", __func__);
  1029. if (IS_ERR_OR_NULL(genpd_node) || IS_ERR_OR_NULL(dev))
  1030. return -EINVAL;
  1031. mutex_lock(&gpd_list_lock);
  1032. list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
  1033. if (gpd->of_node == genpd_node) {
  1034. genpd = gpd;
  1035. break;
  1036. }
  1037. }
  1038. mutex_unlock(&gpd_list_lock);
  1039. if (!genpd)
  1040. return -EINVAL;
  1041. return __pm_genpd_add_device(genpd, dev, td);
  1042. }
  1043. /**
  1044. * pm_genpd_remove_device - Remove a device from an I/O PM domain.
  1045. * @genpd: PM domain to remove the device from.
  1046. * @dev: Device to be removed.
  1047. */
  1048. int pm_genpd_remove_device(struct generic_pm_domain *genpd,
  1049. struct device *dev)
  1050. {
  1051. struct pm_domain_data *pdd;
  1052. int ret = -EINVAL;
  1053. dev_dbg(dev, "%s()\n", __func__);
  1054. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
  1055. return -EINVAL;
  1056. genpd_acquire_lock(genpd);
  1057. if (genpd->prepared_count > 0) {
  1058. ret = -EAGAIN;
  1059. goto out;
  1060. }
  1061. list_for_each_entry(pdd, &genpd->dev_list, list_node) {
  1062. if (pdd->dev != dev)
  1063. continue;
  1064. list_del_init(&pdd->list_node);
  1065. pdd->dev = NULL;
  1066. dev_pm_put_subsys_data(dev);
  1067. dev->pm_domain = NULL;
  1068. kfree(to_gpd_data(pdd));
  1069. genpd->device_count--;
  1070. ret = 0;
  1071. break;
  1072. }
  1073. out:
  1074. genpd_release_lock(genpd);
  1075. return ret;
  1076. }
  1077. /**
  1078. * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
  1079. * @genpd: Master PM domain to add the subdomain to.
  1080. * @subdomain: Subdomain to be added.
  1081. */
  1082. int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
  1083. struct generic_pm_domain *subdomain)
  1084. {
  1085. struct gpd_link *link;
  1086. int ret = 0;
  1087. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
  1088. return -EINVAL;
  1089. start:
  1090. genpd_acquire_lock(genpd);
  1091. mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
  1092. if (subdomain->status != GPD_STATE_POWER_OFF
  1093. && subdomain->status != GPD_STATE_ACTIVE) {
  1094. mutex_unlock(&subdomain->lock);
  1095. genpd_release_lock(genpd);
  1096. goto start;
  1097. }
  1098. if (genpd->status == GPD_STATE_POWER_OFF
  1099. && subdomain->status != GPD_STATE_POWER_OFF) {
  1100. ret = -EINVAL;
  1101. goto out;
  1102. }
  1103. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  1104. if (link->slave == subdomain && link->master == genpd) {
  1105. ret = -EINVAL;
  1106. goto out;
  1107. }
  1108. }
  1109. link = kzalloc(sizeof(*link), GFP_KERNEL);
  1110. if (!link) {
  1111. ret = -ENOMEM;
  1112. goto out;
  1113. }
  1114. link->master = genpd;
  1115. list_add_tail(&link->master_node, &genpd->master_links);
  1116. link->slave = subdomain;
  1117. list_add_tail(&link->slave_node, &subdomain->slave_links);
  1118. if (subdomain->status != GPD_STATE_POWER_OFF)
  1119. genpd_sd_counter_inc(genpd);
  1120. out:
  1121. mutex_unlock(&subdomain->lock);
  1122. genpd_release_lock(genpd);
  1123. return ret;
  1124. }
  1125. /**
  1126. * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
  1127. * @genpd: Master PM domain to remove the subdomain from.
  1128. * @subdomain: Subdomain to be removed.
  1129. */
  1130. int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
  1131. struct generic_pm_domain *subdomain)
  1132. {
  1133. struct gpd_link *link;
  1134. int ret = -EINVAL;
  1135. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
  1136. return -EINVAL;
  1137. start:
  1138. genpd_acquire_lock(genpd);
  1139. list_for_each_entry(link, &genpd->master_links, master_node) {
  1140. if (link->slave != subdomain)
  1141. continue;
  1142. mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
  1143. if (subdomain->status != GPD_STATE_POWER_OFF
  1144. && subdomain->status != GPD_STATE_ACTIVE) {
  1145. mutex_unlock(&subdomain->lock);
  1146. genpd_release_lock(genpd);
  1147. goto start;
  1148. }
  1149. list_del(&link->master_node);
  1150. list_del(&link->slave_node);
  1151. kfree(link);
  1152. if (subdomain->status != GPD_STATE_POWER_OFF)
  1153. genpd_sd_counter_dec(genpd);
  1154. mutex_unlock(&subdomain->lock);
  1155. ret = 0;
  1156. break;
  1157. }
  1158. genpd_release_lock(genpd);
  1159. return ret;
  1160. }
  1161. /**
  1162. * pm_genpd_add_callbacks - Add PM domain callbacks to a given device.
  1163. * @dev: Device to add the callbacks to.
  1164. * @ops: Set of callbacks to add.
  1165. * @td: Timing data to add to the device along with the callbacks (optional).
  1166. */
  1167. int pm_genpd_add_callbacks(struct device *dev, struct gpd_dev_ops *ops,
  1168. struct gpd_timing_data *td)
  1169. {
  1170. struct pm_domain_data *pdd;
  1171. int ret = 0;
  1172. if (!(dev && dev->power.subsys_data && ops))
  1173. return -EINVAL;
  1174. pm_runtime_disable(dev);
  1175. device_pm_lock();
  1176. pdd = dev->power.subsys_data->domain_data;
  1177. if (pdd) {
  1178. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  1179. gpd_data->ops = *ops;
  1180. if (td)
  1181. gpd_data->td = *td;
  1182. } else {
  1183. ret = -EINVAL;
  1184. }
  1185. device_pm_unlock();
  1186. pm_runtime_enable(dev);
  1187. return ret;
  1188. }
  1189. EXPORT_SYMBOL_GPL(pm_genpd_add_callbacks);
  1190. /**
  1191. * __pm_genpd_remove_callbacks - Remove PM domain callbacks from a given device.
  1192. * @dev: Device to remove the callbacks from.
  1193. * @clear_td: If set, clear the device's timing data too.
  1194. */
  1195. int __pm_genpd_remove_callbacks(struct device *dev, bool clear_td)
  1196. {
  1197. struct pm_domain_data *pdd;
  1198. int ret = 0;
  1199. if (!(dev && dev->power.subsys_data))
  1200. return -EINVAL;
  1201. pm_runtime_disable(dev);
  1202. device_pm_lock();
  1203. pdd = dev->power.subsys_data->domain_data;
  1204. if (pdd) {
  1205. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  1206. gpd_data->ops = (struct gpd_dev_ops){ 0 };
  1207. if (clear_td)
  1208. gpd_data->td = (struct gpd_timing_data){ 0 };
  1209. } else {
  1210. ret = -EINVAL;
  1211. }
  1212. device_pm_unlock();
  1213. pm_runtime_enable(dev);
  1214. return ret;
  1215. }
  1216. EXPORT_SYMBOL_GPL(__pm_genpd_remove_callbacks);
  1217. /* Default device callbacks for generic PM domains. */
  1218. /**
  1219. * pm_genpd_default_save_state - Default "save device state" for PM domians.
  1220. * @dev: Device to handle.
  1221. */
  1222. static int pm_genpd_default_save_state(struct device *dev)
  1223. {
  1224. int (*cb)(struct device *__dev);
  1225. struct device_driver *drv = dev->driver;
  1226. cb = dev_gpd_data(dev)->ops.save_state;
  1227. if (cb)
  1228. return cb(dev);
  1229. if (drv && drv->pm && drv->pm->runtime_suspend)
  1230. return drv->pm->runtime_suspend(dev);
  1231. return 0;
  1232. }
  1233. /**
  1234. * pm_genpd_default_restore_state - Default PM domians "restore device state".
  1235. * @dev: Device to handle.
  1236. */
  1237. static int pm_genpd_default_restore_state(struct device *dev)
  1238. {
  1239. int (*cb)(struct device *__dev);
  1240. struct device_driver *drv = dev->driver;
  1241. cb = dev_gpd_data(dev)->ops.restore_state;
  1242. if (cb)
  1243. return cb(dev);
  1244. if (drv && drv->pm && drv->pm->runtime_resume)
  1245. return drv->pm->runtime_resume(dev);
  1246. return 0;
  1247. }
  1248. #ifdef CONFIG_PM_SLEEP
  1249. /**
  1250. * pm_genpd_default_suspend - Default "device suspend" for PM domians.
  1251. * @dev: Device to handle.
  1252. */
  1253. static int pm_genpd_default_suspend(struct device *dev)
  1254. {
  1255. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend;
  1256. return cb ? cb(dev) : pm_generic_suspend(dev);
  1257. }
  1258. /**
  1259. * pm_genpd_default_suspend_late - Default "late device suspend" for PM domians.
  1260. * @dev: Device to handle.
  1261. */
  1262. static int pm_genpd_default_suspend_late(struct device *dev)
  1263. {
  1264. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend_late;
  1265. return cb ? cb(dev) : pm_generic_suspend_late(dev);
  1266. }
  1267. /**
  1268. * pm_genpd_default_resume_early - Default "early device resume" for PM domians.
  1269. * @dev: Device to handle.
  1270. */
  1271. static int pm_genpd_default_resume_early(struct device *dev)
  1272. {
  1273. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume_early;
  1274. return cb ? cb(dev) : pm_generic_resume_early(dev);
  1275. }
  1276. /**
  1277. * pm_genpd_default_resume - Default "device resume" for PM domians.
  1278. * @dev: Device to handle.
  1279. */
  1280. static int pm_genpd_default_resume(struct device *dev)
  1281. {
  1282. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume;
  1283. return cb ? cb(dev) : pm_generic_resume(dev);
  1284. }
  1285. /**
  1286. * pm_genpd_default_freeze - Default "device freeze" for PM domians.
  1287. * @dev: Device to handle.
  1288. */
  1289. static int pm_genpd_default_freeze(struct device *dev)
  1290. {
  1291. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze;
  1292. return cb ? cb(dev) : pm_generic_freeze(dev);
  1293. }
  1294. /**
  1295. * pm_genpd_default_freeze_late - Default "late device freeze" for PM domians.
  1296. * @dev: Device to handle.
  1297. */
  1298. static int pm_genpd_default_freeze_late(struct device *dev)
  1299. {
  1300. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze_late;
  1301. return cb ? cb(dev) : pm_generic_freeze_late(dev);
  1302. }
  1303. /**
  1304. * pm_genpd_default_thaw_early - Default "early device thaw" for PM domians.
  1305. * @dev: Device to handle.
  1306. */
  1307. static int pm_genpd_default_thaw_early(struct device *dev)
  1308. {
  1309. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw_early;
  1310. return cb ? cb(dev) : pm_generic_thaw_early(dev);
  1311. }
  1312. /**
  1313. * pm_genpd_default_thaw - Default "device thaw" for PM domians.
  1314. * @dev: Device to handle.
  1315. */
  1316. static int pm_genpd_default_thaw(struct device *dev)
  1317. {
  1318. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw;
  1319. return cb ? cb(dev) : pm_generic_thaw(dev);
  1320. }
  1321. #else /* !CONFIG_PM_SLEEP */
  1322. #define pm_genpd_default_suspend NULL
  1323. #define pm_genpd_default_suspend_late NULL
  1324. #define pm_genpd_default_resume_early NULL
  1325. #define pm_genpd_default_resume NULL
  1326. #define pm_genpd_default_freeze NULL
  1327. #define pm_genpd_default_freeze_late NULL
  1328. #define pm_genpd_default_thaw_early NULL
  1329. #define pm_genpd_default_thaw NULL
  1330. #endif /* !CONFIG_PM_SLEEP */
  1331. /**
  1332. * pm_genpd_init - Initialize a generic I/O PM domain object.
  1333. * @genpd: PM domain object to initialize.
  1334. * @gov: PM domain governor to associate with the domain (may be NULL).
  1335. * @is_off: Initial value of the domain's power_is_off field.
  1336. */
  1337. void pm_genpd_init(struct generic_pm_domain *genpd,
  1338. struct dev_power_governor *gov, bool is_off)
  1339. {
  1340. if (IS_ERR_OR_NULL(genpd))
  1341. return;
  1342. INIT_LIST_HEAD(&genpd->master_links);
  1343. INIT_LIST_HEAD(&genpd->slave_links);
  1344. INIT_LIST_HEAD(&genpd->dev_list);
  1345. mutex_init(&genpd->lock);
  1346. genpd->gov = gov;
  1347. INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn);
  1348. genpd->in_progress = 0;
  1349. atomic_set(&genpd->sd_count, 0);
  1350. genpd->status = is_off ? GPD_STATE_POWER_OFF : GPD_STATE_ACTIVE;
  1351. init_waitqueue_head(&genpd->status_wait_queue);
  1352. genpd->poweroff_task = NULL;
  1353. genpd->resume_count = 0;
  1354. genpd->device_count = 0;
  1355. genpd->max_off_time_ns = -1;
  1356. genpd->domain.ops.runtime_suspend = pm_genpd_runtime_suspend;
  1357. genpd->domain.ops.runtime_resume = pm_genpd_runtime_resume;
  1358. genpd->domain.ops.runtime_idle = pm_generic_runtime_idle;
  1359. genpd->domain.ops.prepare = pm_genpd_prepare;
  1360. genpd->domain.ops.suspend = pm_genpd_suspend;
  1361. genpd->domain.ops.suspend_late = pm_genpd_suspend_late;
  1362. genpd->domain.ops.suspend_noirq = pm_genpd_suspend_noirq;
  1363. genpd->domain.ops.resume_noirq = pm_genpd_resume_noirq;
  1364. genpd->domain.ops.resume_early = pm_genpd_resume_early;
  1365. genpd->domain.ops.resume = pm_genpd_resume;
  1366. genpd->domain.ops.freeze = pm_genpd_freeze;
  1367. genpd->domain.ops.freeze_late = pm_genpd_freeze_late;
  1368. genpd->domain.ops.freeze_noirq = pm_genpd_freeze_noirq;
  1369. genpd->domain.ops.thaw_noirq = pm_genpd_thaw_noirq;
  1370. genpd->domain.ops.thaw_early = pm_genpd_thaw_early;
  1371. genpd->domain.ops.thaw = pm_genpd_thaw;
  1372. genpd->domain.ops.poweroff = pm_genpd_suspend;
  1373. genpd->domain.ops.poweroff_late = pm_genpd_suspend_late;
  1374. genpd->domain.ops.poweroff_noirq = pm_genpd_suspend_noirq;
  1375. genpd->domain.ops.restore_noirq = pm_genpd_restore_noirq;
  1376. genpd->domain.ops.restore_early = pm_genpd_resume_early;
  1377. genpd->domain.ops.restore = pm_genpd_resume;
  1378. genpd->domain.ops.complete = pm_genpd_complete;
  1379. genpd->dev_ops.save_state = pm_genpd_default_save_state;
  1380. genpd->dev_ops.restore_state = pm_genpd_default_restore_state;
  1381. genpd->dev_ops.suspend = pm_genpd_default_suspend;
  1382. genpd->dev_ops.suspend_late = pm_genpd_default_suspend_late;
  1383. genpd->dev_ops.resume_early = pm_genpd_default_resume_early;
  1384. genpd->dev_ops.resume = pm_genpd_default_resume;
  1385. genpd->dev_ops.freeze = pm_genpd_default_freeze;
  1386. genpd->dev_ops.freeze_late = pm_genpd_default_freeze_late;
  1387. genpd->dev_ops.thaw_early = pm_genpd_default_thaw_early;
  1388. genpd->dev_ops.thaw = pm_genpd_default_thaw;
  1389. mutex_lock(&gpd_list_lock);
  1390. list_add(&genpd->gpd_list_node, &gpd_list);
  1391. mutex_unlock(&gpd_list_lock);
  1392. }