domain.c 44 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729
  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 || to_gpd_data(pdd)->always_on))
  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. if (dev_gpd_data(dev)->always_on)
  419. return -EBUSY;
  420. stop_ok = genpd->gov ? genpd->gov->stop_ok : NULL;
  421. if (stop_ok && !stop_ok(dev))
  422. return -EBUSY;
  423. ret = genpd_stop_dev(genpd, dev);
  424. if (ret)
  425. return ret;
  426. pm_runtime_update_max_time_suspended(dev,
  427. dev_gpd_data(dev)->td.start_latency_ns);
  428. /*
  429. * If power.irq_safe is set, this routine will be run with interrupts
  430. * off, so it can't use mutexes.
  431. */
  432. if (dev->power.irq_safe)
  433. return 0;
  434. mutex_lock(&genpd->lock);
  435. genpd->in_progress++;
  436. pm_genpd_poweroff(genpd);
  437. genpd->in_progress--;
  438. mutex_unlock(&genpd->lock);
  439. return 0;
  440. }
  441. /**
  442. * pm_genpd_runtime_resume - Resume a device belonging to I/O PM domain.
  443. * @dev: Device to resume.
  444. *
  445. * Carry out a runtime resume of a device under the assumption that its
  446. * pm_domain field points to the domain member of an object of type
  447. * struct generic_pm_domain representing a PM domain consisting of I/O devices.
  448. */
  449. static int pm_genpd_runtime_resume(struct device *dev)
  450. {
  451. struct generic_pm_domain *genpd;
  452. DEFINE_WAIT(wait);
  453. int ret;
  454. dev_dbg(dev, "%s()\n", __func__);
  455. genpd = dev_to_genpd(dev);
  456. if (IS_ERR(genpd))
  457. return -EINVAL;
  458. might_sleep_if(!genpd->dev_irq_safe);
  459. /* If power.irq_safe, the PM domain is never powered off. */
  460. if (dev->power.irq_safe)
  461. goto out;
  462. mutex_lock(&genpd->lock);
  463. ret = __pm_genpd_poweron(genpd);
  464. if (ret) {
  465. mutex_unlock(&genpd->lock);
  466. return ret;
  467. }
  468. genpd->status = GPD_STATE_BUSY;
  469. genpd->resume_count++;
  470. for (;;) {
  471. prepare_to_wait(&genpd->status_wait_queue, &wait,
  472. TASK_UNINTERRUPTIBLE);
  473. /*
  474. * If current is the powering off task, we have been called
  475. * reentrantly from one of the device callbacks, so we should
  476. * not wait.
  477. */
  478. if (!genpd->poweroff_task || genpd->poweroff_task == current)
  479. break;
  480. mutex_unlock(&genpd->lock);
  481. schedule();
  482. mutex_lock(&genpd->lock);
  483. }
  484. finish_wait(&genpd->status_wait_queue, &wait);
  485. __pm_genpd_restore_device(dev->power.subsys_data->domain_data, genpd);
  486. genpd->resume_count--;
  487. genpd_set_active(genpd);
  488. wake_up_all(&genpd->status_wait_queue);
  489. mutex_unlock(&genpd->lock);
  490. out:
  491. genpd_start_dev(genpd, dev);
  492. return 0;
  493. }
  494. /**
  495. * pm_genpd_poweroff_unused - Power off all PM domains with no devices in use.
  496. */
  497. void pm_genpd_poweroff_unused(void)
  498. {
  499. struct generic_pm_domain *genpd;
  500. mutex_lock(&gpd_list_lock);
  501. list_for_each_entry(genpd, &gpd_list, gpd_list_node)
  502. genpd_queue_power_off_work(genpd);
  503. mutex_unlock(&gpd_list_lock);
  504. }
  505. #else
  506. static inline void genpd_power_off_work_fn(struct work_struct *work) {}
  507. #define pm_genpd_runtime_suspend NULL
  508. #define pm_genpd_runtime_resume NULL
  509. #endif /* CONFIG_PM_RUNTIME */
  510. #ifdef CONFIG_PM_SLEEP
  511. static bool genpd_dev_active_wakeup(struct generic_pm_domain *genpd,
  512. struct device *dev)
  513. {
  514. return GENPD_DEV_CALLBACK(genpd, bool, active_wakeup, dev);
  515. }
  516. static int genpd_suspend_dev(struct generic_pm_domain *genpd, struct device *dev)
  517. {
  518. return GENPD_DEV_CALLBACK(genpd, int, suspend, dev);
  519. }
  520. static int genpd_suspend_late(struct generic_pm_domain *genpd, struct device *dev)
  521. {
  522. return GENPD_DEV_CALLBACK(genpd, int, suspend_late, dev);
  523. }
  524. static int genpd_resume_early(struct generic_pm_domain *genpd, struct device *dev)
  525. {
  526. return GENPD_DEV_CALLBACK(genpd, int, resume_early, dev);
  527. }
  528. static int genpd_resume_dev(struct generic_pm_domain *genpd, struct device *dev)
  529. {
  530. return GENPD_DEV_CALLBACK(genpd, int, resume, dev);
  531. }
  532. static int genpd_freeze_dev(struct generic_pm_domain *genpd, struct device *dev)
  533. {
  534. return GENPD_DEV_CALLBACK(genpd, int, freeze, dev);
  535. }
  536. static int genpd_freeze_late(struct generic_pm_domain *genpd, struct device *dev)
  537. {
  538. return GENPD_DEV_CALLBACK(genpd, int, freeze_late, dev);
  539. }
  540. static int genpd_thaw_early(struct generic_pm_domain *genpd, struct device *dev)
  541. {
  542. return GENPD_DEV_CALLBACK(genpd, int, thaw_early, dev);
  543. }
  544. static int genpd_thaw_dev(struct generic_pm_domain *genpd, struct device *dev)
  545. {
  546. return GENPD_DEV_CALLBACK(genpd, int, thaw, dev);
  547. }
  548. /**
  549. * pm_genpd_sync_poweroff - Synchronously power off a PM domain and its masters.
  550. * @genpd: PM domain to power off, if possible.
  551. *
  552. * Check if the given PM domain can be powered off (during system suspend or
  553. * hibernation) and do that if so. Also, in that case propagate to its masters.
  554. *
  555. * This function is only called in "noirq" stages of system power transitions,
  556. * so it need not acquire locks (all of the "noirq" callbacks are executed
  557. * sequentially, so it is guaranteed that it will never run twice in parallel).
  558. */
  559. static void pm_genpd_sync_poweroff(struct generic_pm_domain *genpd)
  560. {
  561. struct gpd_link *link;
  562. if (genpd->status == GPD_STATE_POWER_OFF)
  563. return;
  564. if (genpd->suspended_count != genpd->device_count
  565. || atomic_read(&genpd->sd_count) > 0)
  566. return;
  567. if (genpd->power_off)
  568. genpd->power_off(genpd);
  569. genpd->status = GPD_STATE_POWER_OFF;
  570. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  571. genpd_sd_counter_dec(link->master);
  572. pm_genpd_sync_poweroff(link->master);
  573. }
  574. }
  575. /**
  576. * resume_needed - Check whether to resume a device before system suspend.
  577. * @dev: Device to check.
  578. * @genpd: PM domain the device belongs to.
  579. *
  580. * There are two cases in which a device that can wake up the system from sleep
  581. * states should be resumed by pm_genpd_prepare(): (1) if the device is enabled
  582. * to wake up the system and it has to remain active for this purpose while the
  583. * system is in the sleep state and (2) if the device is not enabled to wake up
  584. * the system from sleep states and it generally doesn't generate wakeup signals
  585. * by itself (those signals are generated on its behalf by other parts of the
  586. * system). In the latter case it may be necessary to reconfigure the device's
  587. * wakeup settings during system suspend, because it may have been set up to
  588. * signal remote wakeup from the system's working state as needed by runtime PM.
  589. * Return 'true' in either of the above cases.
  590. */
  591. static bool resume_needed(struct device *dev, struct generic_pm_domain *genpd)
  592. {
  593. bool active_wakeup;
  594. if (!device_can_wakeup(dev))
  595. return false;
  596. active_wakeup = genpd_dev_active_wakeup(genpd, dev);
  597. return device_may_wakeup(dev) ? active_wakeup : !active_wakeup;
  598. }
  599. /**
  600. * pm_genpd_prepare - Start power transition of a device in a PM domain.
  601. * @dev: Device to start the transition of.
  602. *
  603. * Start a power transition of a device (during a system-wide power transition)
  604. * under the assumption that its pm_domain field points to the domain member of
  605. * an object of type struct generic_pm_domain representing a PM domain
  606. * consisting of I/O devices.
  607. */
  608. static int pm_genpd_prepare(struct device *dev)
  609. {
  610. struct generic_pm_domain *genpd;
  611. int ret;
  612. dev_dbg(dev, "%s()\n", __func__);
  613. genpd = dev_to_genpd(dev);
  614. if (IS_ERR(genpd))
  615. return -EINVAL;
  616. /*
  617. * If a wakeup request is pending for the device, it should be woken up
  618. * at this point and a system wakeup event should be reported if it's
  619. * set up to wake up the system from sleep states.
  620. */
  621. pm_runtime_get_noresume(dev);
  622. if (pm_runtime_barrier(dev) && device_may_wakeup(dev))
  623. pm_wakeup_event(dev, 0);
  624. if (pm_wakeup_pending()) {
  625. pm_runtime_put_sync(dev);
  626. return -EBUSY;
  627. }
  628. if (resume_needed(dev, genpd))
  629. pm_runtime_resume(dev);
  630. genpd_acquire_lock(genpd);
  631. if (genpd->prepared_count++ == 0) {
  632. genpd->suspended_count = 0;
  633. genpd->suspend_power_off = genpd->status == GPD_STATE_POWER_OFF;
  634. }
  635. genpd_release_lock(genpd);
  636. if (genpd->suspend_power_off) {
  637. pm_runtime_put_noidle(dev);
  638. return 0;
  639. }
  640. /*
  641. * The PM domain must be in the GPD_STATE_ACTIVE state at this point,
  642. * so pm_genpd_poweron() will return immediately, but if the device
  643. * is suspended (e.g. it's been stopped by genpd_stop_dev()), we need
  644. * to make it operational.
  645. */
  646. pm_runtime_resume(dev);
  647. __pm_runtime_disable(dev, false);
  648. ret = pm_generic_prepare(dev);
  649. if (ret) {
  650. mutex_lock(&genpd->lock);
  651. if (--genpd->prepared_count == 0)
  652. genpd->suspend_power_off = false;
  653. mutex_unlock(&genpd->lock);
  654. pm_runtime_enable(dev);
  655. }
  656. pm_runtime_put_sync(dev);
  657. return ret;
  658. }
  659. /**
  660. * pm_genpd_suspend - Suspend a device belonging to an I/O PM domain.
  661. * @dev: Device to suspend.
  662. *
  663. * Suspend a device under the assumption that its pm_domain field points to the
  664. * domain member of an object of type struct generic_pm_domain representing
  665. * a PM domain consisting of I/O devices.
  666. */
  667. static int pm_genpd_suspend(struct device *dev)
  668. {
  669. struct generic_pm_domain *genpd;
  670. dev_dbg(dev, "%s()\n", __func__);
  671. genpd = dev_to_genpd(dev);
  672. if (IS_ERR(genpd))
  673. return -EINVAL;
  674. return genpd->suspend_power_off ? 0 : genpd_suspend_dev(genpd, dev);
  675. }
  676. /**
  677. * pm_genpd_suspend_late - Late suspend of a device from an I/O PM domain.
  678. * @dev: Device to suspend.
  679. *
  680. * Carry out a late suspend of a device under the assumption that its
  681. * pm_domain field points to the domain member of an object of type
  682. * struct generic_pm_domain representing a PM domain consisting of I/O devices.
  683. */
  684. static int pm_genpd_suspend_late(struct device *dev)
  685. {
  686. struct generic_pm_domain *genpd;
  687. dev_dbg(dev, "%s()\n", __func__);
  688. genpd = dev_to_genpd(dev);
  689. if (IS_ERR(genpd))
  690. return -EINVAL;
  691. return genpd->suspend_power_off ? 0 : genpd_suspend_late(genpd, dev);
  692. }
  693. /**
  694. * pm_genpd_suspend_noirq - Completion of suspend of device in an I/O PM domain.
  695. * @dev: Device to suspend.
  696. *
  697. * Stop the device and remove power from the domain if all devices in it have
  698. * been stopped.
  699. */
  700. static int pm_genpd_suspend_noirq(struct device *dev)
  701. {
  702. struct generic_pm_domain *genpd;
  703. dev_dbg(dev, "%s()\n", __func__);
  704. genpd = dev_to_genpd(dev);
  705. if (IS_ERR(genpd))
  706. return -EINVAL;
  707. if (genpd->suspend_power_off || dev_gpd_data(dev)->always_on
  708. || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
  709. return 0;
  710. genpd_stop_dev(genpd, dev);
  711. /*
  712. * Since all of the "noirq" callbacks are executed sequentially, it is
  713. * guaranteed that this function will never run twice in parallel for
  714. * the same PM domain, so it is not necessary to use locking here.
  715. */
  716. genpd->suspended_count++;
  717. pm_genpd_sync_poweroff(genpd);
  718. return 0;
  719. }
  720. /**
  721. * pm_genpd_resume_noirq - Start of resume of device in an I/O PM domain.
  722. * @dev: Device to resume.
  723. *
  724. * Restore power to the device's PM domain, if necessary, and start the device.
  725. */
  726. static int pm_genpd_resume_noirq(struct device *dev)
  727. {
  728. struct generic_pm_domain *genpd;
  729. dev_dbg(dev, "%s()\n", __func__);
  730. genpd = dev_to_genpd(dev);
  731. if (IS_ERR(genpd))
  732. return -EINVAL;
  733. if (genpd->suspend_power_off || dev_gpd_data(dev)->always_on
  734. || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
  735. return 0;
  736. /*
  737. * Since all of the "noirq" callbacks are executed sequentially, it is
  738. * guaranteed that this function will never run twice in parallel for
  739. * the same PM domain, so it is not necessary to use locking here.
  740. */
  741. pm_genpd_poweron(genpd);
  742. genpd->suspended_count--;
  743. return genpd_start_dev(genpd, dev);
  744. }
  745. /**
  746. * pm_genpd_resume_early - Early resume of a device in an I/O PM domain.
  747. * @dev: Device to resume.
  748. *
  749. * Carry out an early resume of a device under the assumption that its
  750. * pm_domain field points to the domain member of an object of type
  751. * struct generic_pm_domain representing a power domain consisting of I/O
  752. * devices.
  753. */
  754. static int pm_genpd_resume_early(struct device *dev)
  755. {
  756. struct generic_pm_domain *genpd;
  757. dev_dbg(dev, "%s()\n", __func__);
  758. genpd = dev_to_genpd(dev);
  759. if (IS_ERR(genpd))
  760. return -EINVAL;
  761. return genpd->suspend_power_off ? 0 : genpd_resume_early(genpd, dev);
  762. }
  763. /**
  764. * pm_genpd_resume - Resume of device in an I/O PM domain.
  765. * @dev: Device to resume.
  766. *
  767. * Resume a device under the assumption that its pm_domain field points to the
  768. * domain member of an object of type struct generic_pm_domain representing
  769. * a power domain consisting of I/O devices.
  770. */
  771. static int pm_genpd_resume(struct device *dev)
  772. {
  773. struct generic_pm_domain *genpd;
  774. dev_dbg(dev, "%s()\n", __func__);
  775. genpd = dev_to_genpd(dev);
  776. if (IS_ERR(genpd))
  777. return -EINVAL;
  778. return genpd->suspend_power_off ? 0 : genpd_resume_dev(genpd, dev);
  779. }
  780. /**
  781. * pm_genpd_freeze - Freezing a device in an I/O PM domain.
  782. * @dev: Device to freeze.
  783. *
  784. * Freeze a device under the assumption that its pm_domain field points to the
  785. * domain member of an object of type struct generic_pm_domain representing
  786. * a power domain consisting of I/O devices.
  787. */
  788. static int pm_genpd_freeze(struct device *dev)
  789. {
  790. struct generic_pm_domain *genpd;
  791. dev_dbg(dev, "%s()\n", __func__);
  792. genpd = dev_to_genpd(dev);
  793. if (IS_ERR(genpd))
  794. return -EINVAL;
  795. return genpd->suspend_power_off ? 0 : genpd_freeze_dev(genpd, dev);
  796. }
  797. /**
  798. * pm_genpd_freeze_late - Late freeze of a device in an I/O PM domain.
  799. * @dev: Device to freeze.
  800. *
  801. * Carry out a late freeze of a device under the assumption that its
  802. * pm_domain field points to the domain member of an object of type
  803. * struct generic_pm_domain representing a power domain consisting of I/O
  804. * devices.
  805. */
  806. static int pm_genpd_freeze_late(struct device *dev)
  807. {
  808. struct generic_pm_domain *genpd;
  809. dev_dbg(dev, "%s()\n", __func__);
  810. genpd = dev_to_genpd(dev);
  811. if (IS_ERR(genpd))
  812. return -EINVAL;
  813. return genpd->suspend_power_off ? 0 : genpd_freeze_late(genpd, dev);
  814. }
  815. /**
  816. * pm_genpd_freeze_noirq - Completion of freezing a device in an I/O PM domain.
  817. * @dev: Device to freeze.
  818. *
  819. * Carry out a late freeze of a device under the assumption that its
  820. * pm_domain field points to the domain member of an object of type
  821. * struct generic_pm_domain representing a power domain consisting of I/O
  822. * devices.
  823. */
  824. static int pm_genpd_freeze_noirq(struct device *dev)
  825. {
  826. struct generic_pm_domain *genpd;
  827. dev_dbg(dev, "%s()\n", __func__);
  828. genpd = dev_to_genpd(dev);
  829. if (IS_ERR(genpd))
  830. return -EINVAL;
  831. return genpd->suspend_power_off || dev_gpd_data(dev)->always_on ?
  832. 0 : genpd_stop_dev(genpd, dev);
  833. }
  834. /**
  835. * pm_genpd_thaw_noirq - Early thaw of device in an I/O PM domain.
  836. * @dev: Device to thaw.
  837. *
  838. * Start the device, unless power has been removed from the domain already
  839. * before the system transition.
  840. */
  841. static int pm_genpd_thaw_noirq(struct device *dev)
  842. {
  843. struct generic_pm_domain *genpd;
  844. dev_dbg(dev, "%s()\n", __func__);
  845. genpd = dev_to_genpd(dev);
  846. if (IS_ERR(genpd))
  847. return -EINVAL;
  848. return genpd->suspend_power_off || dev_gpd_data(dev)->always_on ?
  849. 0 : genpd_start_dev(genpd, dev);
  850. }
  851. /**
  852. * pm_genpd_thaw_early - Early thaw of device in an I/O PM domain.
  853. * @dev: Device to thaw.
  854. *
  855. * Carry out an early thaw of a device under the assumption that its
  856. * pm_domain field points to the domain member of an object of type
  857. * struct generic_pm_domain representing a power domain consisting of I/O
  858. * devices.
  859. */
  860. static int pm_genpd_thaw_early(struct device *dev)
  861. {
  862. struct generic_pm_domain *genpd;
  863. dev_dbg(dev, "%s()\n", __func__);
  864. genpd = dev_to_genpd(dev);
  865. if (IS_ERR(genpd))
  866. return -EINVAL;
  867. return genpd->suspend_power_off ? 0 : genpd_thaw_early(genpd, dev);
  868. }
  869. /**
  870. * pm_genpd_thaw - Thaw a device belonging to an I/O power domain.
  871. * @dev: Device to thaw.
  872. *
  873. * Thaw a device under the assumption that its pm_domain field points to the
  874. * domain member of an object of type struct generic_pm_domain representing
  875. * a power domain consisting of I/O devices.
  876. */
  877. static int pm_genpd_thaw(struct device *dev)
  878. {
  879. struct generic_pm_domain *genpd;
  880. dev_dbg(dev, "%s()\n", __func__);
  881. genpd = dev_to_genpd(dev);
  882. if (IS_ERR(genpd))
  883. return -EINVAL;
  884. return genpd->suspend_power_off ? 0 : genpd_thaw_dev(genpd, dev);
  885. }
  886. /**
  887. * pm_genpd_restore_noirq - Start of restore of device in an I/O PM domain.
  888. * @dev: Device to resume.
  889. *
  890. * Make sure the domain will be in the same power state as before the
  891. * hibernation the system is resuming from and start the device if necessary.
  892. */
  893. static int pm_genpd_restore_noirq(struct device *dev)
  894. {
  895. struct generic_pm_domain *genpd;
  896. dev_dbg(dev, "%s()\n", __func__);
  897. genpd = dev_to_genpd(dev);
  898. if (IS_ERR(genpd))
  899. return -EINVAL;
  900. /*
  901. * Since all of the "noirq" callbacks are executed sequentially, it is
  902. * guaranteed that this function will never run twice in parallel for
  903. * the same PM domain, so it is not necessary to use locking here.
  904. *
  905. * At this point suspended_count == 0 means we are being run for the
  906. * first time for the given domain in the present cycle.
  907. */
  908. if (genpd->suspended_count++ == 0) {
  909. /*
  910. * The boot kernel might put the domain into arbitrary state,
  911. * so make it appear as powered off to pm_genpd_poweron(), so
  912. * that it tries to power it on in case it was really off.
  913. */
  914. genpd->status = GPD_STATE_POWER_OFF;
  915. if (genpd->suspend_power_off) {
  916. /*
  917. * If the domain was off before the hibernation, make
  918. * sure it will be off going forward.
  919. */
  920. if (genpd->power_off)
  921. genpd->power_off(genpd);
  922. return 0;
  923. }
  924. }
  925. if (genpd->suspend_power_off)
  926. return 0;
  927. pm_genpd_poweron(genpd);
  928. return dev_gpd_data(dev)->always_on ? 0 : genpd_start_dev(genpd, dev);
  929. }
  930. /**
  931. * pm_genpd_complete - Complete power transition of a device in a power domain.
  932. * @dev: Device to complete the transition of.
  933. *
  934. * Complete a power transition of a device (during a system-wide power
  935. * transition) under the assumption that its pm_domain field points to the
  936. * domain member of an object of type struct generic_pm_domain representing
  937. * a power domain consisting of I/O devices.
  938. */
  939. static void pm_genpd_complete(struct device *dev)
  940. {
  941. struct generic_pm_domain *genpd;
  942. bool run_complete;
  943. dev_dbg(dev, "%s()\n", __func__);
  944. genpd = dev_to_genpd(dev);
  945. if (IS_ERR(genpd))
  946. return;
  947. mutex_lock(&genpd->lock);
  948. run_complete = !genpd->suspend_power_off;
  949. if (--genpd->prepared_count == 0)
  950. genpd->suspend_power_off = false;
  951. mutex_unlock(&genpd->lock);
  952. if (run_complete) {
  953. pm_generic_complete(dev);
  954. pm_runtime_set_active(dev);
  955. pm_runtime_enable(dev);
  956. pm_runtime_idle(dev);
  957. }
  958. }
  959. #else
  960. #define pm_genpd_prepare NULL
  961. #define pm_genpd_suspend NULL
  962. #define pm_genpd_suspend_late NULL
  963. #define pm_genpd_suspend_noirq NULL
  964. #define pm_genpd_resume_early NULL
  965. #define pm_genpd_resume_noirq NULL
  966. #define pm_genpd_resume NULL
  967. #define pm_genpd_freeze NULL
  968. #define pm_genpd_freeze_late NULL
  969. #define pm_genpd_freeze_noirq NULL
  970. #define pm_genpd_thaw_early NULL
  971. #define pm_genpd_thaw_noirq NULL
  972. #define pm_genpd_thaw NULL
  973. #define pm_genpd_restore_noirq NULL
  974. #define pm_genpd_complete NULL
  975. #endif /* CONFIG_PM_SLEEP */
  976. /**
  977. * __pm_genpd_add_device - Add a device to an I/O PM domain.
  978. * @genpd: PM domain to add the device to.
  979. * @dev: Device to be added.
  980. * @td: Set of PM QoS timing parameters to attach to the device.
  981. */
  982. int __pm_genpd_add_device(struct generic_pm_domain *genpd, struct device *dev,
  983. struct gpd_timing_data *td)
  984. {
  985. struct generic_pm_domain_data *gpd_data;
  986. struct pm_domain_data *pdd;
  987. int ret = 0;
  988. dev_dbg(dev, "%s()\n", __func__);
  989. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
  990. return -EINVAL;
  991. genpd_acquire_lock(genpd);
  992. if (genpd->status == GPD_STATE_POWER_OFF) {
  993. ret = -EINVAL;
  994. goto out;
  995. }
  996. if (genpd->prepared_count > 0) {
  997. ret = -EAGAIN;
  998. goto out;
  999. }
  1000. list_for_each_entry(pdd, &genpd->dev_list, list_node)
  1001. if (pdd->dev == dev) {
  1002. ret = -EINVAL;
  1003. goto out;
  1004. }
  1005. gpd_data = kzalloc(sizeof(*gpd_data), GFP_KERNEL);
  1006. if (!gpd_data) {
  1007. ret = -ENOMEM;
  1008. goto out;
  1009. }
  1010. genpd->device_count++;
  1011. dev->pm_domain = &genpd->domain;
  1012. dev_pm_get_subsys_data(dev);
  1013. dev->power.subsys_data->domain_data = &gpd_data->base;
  1014. gpd_data->base.dev = dev;
  1015. gpd_data->need_restore = false;
  1016. list_add_tail(&gpd_data->base.list_node, &genpd->dev_list);
  1017. if (td)
  1018. gpd_data->td = *td;
  1019. out:
  1020. genpd_release_lock(genpd);
  1021. return ret;
  1022. }
  1023. /**
  1024. * __pm_genpd_of_add_device - Add a device to an I/O PM domain.
  1025. * @genpd_node: Device tree node pointer representing a PM domain to which the
  1026. * the device is added to.
  1027. * @dev: Device to be added.
  1028. * @td: Set of PM QoS timing parameters to attach to the device.
  1029. */
  1030. int __pm_genpd_of_add_device(struct device_node *genpd_node, struct device *dev,
  1031. struct gpd_timing_data *td)
  1032. {
  1033. struct generic_pm_domain *genpd = NULL, *gpd;
  1034. dev_dbg(dev, "%s()\n", __func__);
  1035. if (IS_ERR_OR_NULL(genpd_node) || IS_ERR_OR_NULL(dev))
  1036. return -EINVAL;
  1037. mutex_lock(&gpd_list_lock);
  1038. list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
  1039. if (gpd->of_node == genpd_node) {
  1040. genpd = gpd;
  1041. break;
  1042. }
  1043. }
  1044. mutex_unlock(&gpd_list_lock);
  1045. if (!genpd)
  1046. return -EINVAL;
  1047. return __pm_genpd_add_device(genpd, dev, td);
  1048. }
  1049. /**
  1050. * pm_genpd_remove_device - Remove a device from an I/O PM domain.
  1051. * @genpd: PM domain to remove the device from.
  1052. * @dev: Device to be removed.
  1053. */
  1054. int pm_genpd_remove_device(struct generic_pm_domain *genpd,
  1055. struct device *dev)
  1056. {
  1057. struct pm_domain_data *pdd;
  1058. int ret = -EINVAL;
  1059. dev_dbg(dev, "%s()\n", __func__);
  1060. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
  1061. return -EINVAL;
  1062. genpd_acquire_lock(genpd);
  1063. if (genpd->prepared_count > 0) {
  1064. ret = -EAGAIN;
  1065. goto out;
  1066. }
  1067. list_for_each_entry(pdd, &genpd->dev_list, list_node) {
  1068. if (pdd->dev != dev)
  1069. continue;
  1070. list_del_init(&pdd->list_node);
  1071. pdd->dev = NULL;
  1072. dev_pm_put_subsys_data(dev);
  1073. dev->pm_domain = NULL;
  1074. kfree(to_gpd_data(pdd));
  1075. genpd->device_count--;
  1076. ret = 0;
  1077. break;
  1078. }
  1079. out:
  1080. genpd_release_lock(genpd);
  1081. return ret;
  1082. }
  1083. /**
  1084. * pm_genpd_dev_always_on - Set/unset the "always on" flag for a given device.
  1085. * @dev: Device to set/unset the flag for.
  1086. * @val: The new value of the device's "always on" flag.
  1087. */
  1088. void pm_genpd_dev_always_on(struct device *dev, bool val)
  1089. {
  1090. struct pm_subsys_data *psd;
  1091. unsigned long flags;
  1092. spin_lock_irqsave(&dev->power.lock, flags);
  1093. psd = dev_to_psd(dev);
  1094. if (psd && psd->domain_data)
  1095. to_gpd_data(psd->domain_data)->always_on = val;
  1096. spin_unlock_irqrestore(&dev->power.lock, flags);
  1097. }
  1098. EXPORT_SYMBOL_GPL(pm_genpd_dev_always_on);
  1099. /**
  1100. * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
  1101. * @genpd: Master PM domain to add the subdomain to.
  1102. * @subdomain: Subdomain to be added.
  1103. */
  1104. int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
  1105. struct generic_pm_domain *subdomain)
  1106. {
  1107. struct gpd_link *link;
  1108. int ret = 0;
  1109. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
  1110. return -EINVAL;
  1111. start:
  1112. genpd_acquire_lock(genpd);
  1113. mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
  1114. if (subdomain->status != GPD_STATE_POWER_OFF
  1115. && subdomain->status != GPD_STATE_ACTIVE) {
  1116. mutex_unlock(&subdomain->lock);
  1117. genpd_release_lock(genpd);
  1118. goto start;
  1119. }
  1120. if (genpd->status == GPD_STATE_POWER_OFF
  1121. && subdomain->status != GPD_STATE_POWER_OFF) {
  1122. ret = -EINVAL;
  1123. goto out;
  1124. }
  1125. list_for_each_entry(link, &genpd->slave_links, slave_node) {
  1126. if (link->slave == subdomain && link->master == genpd) {
  1127. ret = -EINVAL;
  1128. goto out;
  1129. }
  1130. }
  1131. link = kzalloc(sizeof(*link), GFP_KERNEL);
  1132. if (!link) {
  1133. ret = -ENOMEM;
  1134. goto out;
  1135. }
  1136. link->master = genpd;
  1137. list_add_tail(&link->master_node, &genpd->master_links);
  1138. link->slave = subdomain;
  1139. list_add_tail(&link->slave_node, &subdomain->slave_links);
  1140. if (subdomain->status != GPD_STATE_POWER_OFF)
  1141. genpd_sd_counter_inc(genpd);
  1142. out:
  1143. mutex_unlock(&subdomain->lock);
  1144. genpd_release_lock(genpd);
  1145. return ret;
  1146. }
  1147. /**
  1148. * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
  1149. * @genpd: Master PM domain to remove the subdomain from.
  1150. * @subdomain: Subdomain to be removed.
  1151. */
  1152. int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
  1153. struct generic_pm_domain *subdomain)
  1154. {
  1155. struct gpd_link *link;
  1156. int ret = -EINVAL;
  1157. if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
  1158. return -EINVAL;
  1159. start:
  1160. genpd_acquire_lock(genpd);
  1161. list_for_each_entry(link, &genpd->master_links, master_node) {
  1162. if (link->slave != subdomain)
  1163. continue;
  1164. mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
  1165. if (subdomain->status != GPD_STATE_POWER_OFF
  1166. && subdomain->status != GPD_STATE_ACTIVE) {
  1167. mutex_unlock(&subdomain->lock);
  1168. genpd_release_lock(genpd);
  1169. goto start;
  1170. }
  1171. list_del(&link->master_node);
  1172. list_del(&link->slave_node);
  1173. kfree(link);
  1174. if (subdomain->status != GPD_STATE_POWER_OFF)
  1175. genpd_sd_counter_dec(genpd);
  1176. mutex_unlock(&subdomain->lock);
  1177. ret = 0;
  1178. break;
  1179. }
  1180. genpd_release_lock(genpd);
  1181. return ret;
  1182. }
  1183. /**
  1184. * pm_genpd_add_callbacks - Add PM domain callbacks to a given device.
  1185. * @dev: Device to add the callbacks to.
  1186. * @ops: Set of callbacks to add.
  1187. * @td: Timing data to add to the device along with the callbacks (optional).
  1188. */
  1189. int pm_genpd_add_callbacks(struct device *dev, struct gpd_dev_ops *ops,
  1190. struct gpd_timing_data *td)
  1191. {
  1192. struct pm_domain_data *pdd;
  1193. int ret = 0;
  1194. if (!(dev && dev->power.subsys_data && ops))
  1195. return -EINVAL;
  1196. pm_runtime_disable(dev);
  1197. device_pm_lock();
  1198. pdd = dev->power.subsys_data->domain_data;
  1199. if (pdd) {
  1200. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  1201. gpd_data->ops = *ops;
  1202. if (td)
  1203. gpd_data->td = *td;
  1204. } else {
  1205. ret = -EINVAL;
  1206. }
  1207. device_pm_unlock();
  1208. pm_runtime_enable(dev);
  1209. return ret;
  1210. }
  1211. EXPORT_SYMBOL_GPL(pm_genpd_add_callbacks);
  1212. /**
  1213. * __pm_genpd_remove_callbacks - Remove PM domain callbacks from a given device.
  1214. * @dev: Device to remove the callbacks from.
  1215. * @clear_td: If set, clear the device's timing data too.
  1216. */
  1217. int __pm_genpd_remove_callbacks(struct device *dev, bool clear_td)
  1218. {
  1219. struct pm_domain_data *pdd;
  1220. int ret = 0;
  1221. if (!(dev && dev->power.subsys_data))
  1222. return -EINVAL;
  1223. pm_runtime_disable(dev);
  1224. device_pm_lock();
  1225. pdd = dev->power.subsys_data->domain_data;
  1226. if (pdd) {
  1227. struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
  1228. gpd_data->ops = (struct gpd_dev_ops){ 0 };
  1229. if (clear_td)
  1230. gpd_data->td = (struct gpd_timing_data){ 0 };
  1231. } else {
  1232. ret = -EINVAL;
  1233. }
  1234. device_pm_unlock();
  1235. pm_runtime_enable(dev);
  1236. return ret;
  1237. }
  1238. EXPORT_SYMBOL_GPL(__pm_genpd_remove_callbacks);
  1239. /* Default device callbacks for generic PM domains. */
  1240. /**
  1241. * pm_genpd_default_save_state - Default "save device state" for PM domians.
  1242. * @dev: Device to handle.
  1243. */
  1244. static int pm_genpd_default_save_state(struct device *dev)
  1245. {
  1246. int (*cb)(struct device *__dev);
  1247. struct device_driver *drv = dev->driver;
  1248. cb = dev_gpd_data(dev)->ops.save_state;
  1249. if (cb)
  1250. return cb(dev);
  1251. if (drv && drv->pm && drv->pm->runtime_suspend)
  1252. return drv->pm->runtime_suspend(dev);
  1253. return 0;
  1254. }
  1255. /**
  1256. * pm_genpd_default_restore_state - Default PM domians "restore device state".
  1257. * @dev: Device to handle.
  1258. */
  1259. static int pm_genpd_default_restore_state(struct device *dev)
  1260. {
  1261. int (*cb)(struct device *__dev);
  1262. struct device_driver *drv = dev->driver;
  1263. cb = dev_gpd_data(dev)->ops.restore_state;
  1264. if (cb)
  1265. return cb(dev);
  1266. if (drv && drv->pm && drv->pm->runtime_resume)
  1267. return drv->pm->runtime_resume(dev);
  1268. return 0;
  1269. }
  1270. #ifdef CONFIG_PM_SLEEP
  1271. /**
  1272. * pm_genpd_default_suspend - Default "device suspend" for PM domians.
  1273. * @dev: Device to handle.
  1274. */
  1275. static int pm_genpd_default_suspend(struct device *dev)
  1276. {
  1277. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend;
  1278. return cb ? cb(dev) : pm_generic_suspend(dev);
  1279. }
  1280. /**
  1281. * pm_genpd_default_suspend_late - Default "late device suspend" for PM domians.
  1282. * @dev: Device to handle.
  1283. */
  1284. static int pm_genpd_default_suspend_late(struct device *dev)
  1285. {
  1286. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend_late;
  1287. return cb ? cb(dev) : pm_generic_suspend_late(dev);
  1288. }
  1289. /**
  1290. * pm_genpd_default_resume_early - Default "early device resume" for PM domians.
  1291. * @dev: Device to handle.
  1292. */
  1293. static int pm_genpd_default_resume_early(struct device *dev)
  1294. {
  1295. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume_early;
  1296. return cb ? cb(dev) : pm_generic_resume_early(dev);
  1297. }
  1298. /**
  1299. * pm_genpd_default_resume - Default "device resume" for PM domians.
  1300. * @dev: Device to handle.
  1301. */
  1302. static int pm_genpd_default_resume(struct device *dev)
  1303. {
  1304. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume;
  1305. return cb ? cb(dev) : pm_generic_resume(dev);
  1306. }
  1307. /**
  1308. * pm_genpd_default_freeze - Default "device freeze" for PM domians.
  1309. * @dev: Device to handle.
  1310. */
  1311. static int pm_genpd_default_freeze(struct device *dev)
  1312. {
  1313. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze;
  1314. return cb ? cb(dev) : pm_generic_freeze(dev);
  1315. }
  1316. /**
  1317. * pm_genpd_default_freeze_late - Default "late device freeze" for PM domians.
  1318. * @dev: Device to handle.
  1319. */
  1320. static int pm_genpd_default_freeze_late(struct device *dev)
  1321. {
  1322. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze_late;
  1323. return cb ? cb(dev) : pm_generic_freeze_late(dev);
  1324. }
  1325. /**
  1326. * pm_genpd_default_thaw_early - Default "early device thaw" for PM domians.
  1327. * @dev: Device to handle.
  1328. */
  1329. static int pm_genpd_default_thaw_early(struct device *dev)
  1330. {
  1331. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw_early;
  1332. return cb ? cb(dev) : pm_generic_thaw_early(dev);
  1333. }
  1334. /**
  1335. * pm_genpd_default_thaw - Default "device thaw" for PM domians.
  1336. * @dev: Device to handle.
  1337. */
  1338. static int pm_genpd_default_thaw(struct device *dev)
  1339. {
  1340. int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw;
  1341. return cb ? cb(dev) : pm_generic_thaw(dev);
  1342. }
  1343. #else /* !CONFIG_PM_SLEEP */
  1344. #define pm_genpd_default_suspend NULL
  1345. #define pm_genpd_default_suspend_late NULL
  1346. #define pm_genpd_default_resume_early NULL
  1347. #define pm_genpd_default_resume NULL
  1348. #define pm_genpd_default_freeze NULL
  1349. #define pm_genpd_default_freeze_late NULL
  1350. #define pm_genpd_default_thaw_early NULL
  1351. #define pm_genpd_default_thaw NULL
  1352. #endif /* !CONFIG_PM_SLEEP */
  1353. /**
  1354. * pm_genpd_init - Initialize a generic I/O PM domain object.
  1355. * @genpd: PM domain object to initialize.
  1356. * @gov: PM domain governor to associate with the domain (may be NULL).
  1357. * @is_off: Initial value of the domain's power_is_off field.
  1358. */
  1359. void pm_genpd_init(struct generic_pm_domain *genpd,
  1360. struct dev_power_governor *gov, bool is_off)
  1361. {
  1362. if (IS_ERR_OR_NULL(genpd))
  1363. return;
  1364. INIT_LIST_HEAD(&genpd->master_links);
  1365. INIT_LIST_HEAD(&genpd->slave_links);
  1366. INIT_LIST_HEAD(&genpd->dev_list);
  1367. mutex_init(&genpd->lock);
  1368. genpd->gov = gov;
  1369. INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn);
  1370. genpd->in_progress = 0;
  1371. atomic_set(&genpd->sd_count, 0);
  1372. genpd->status = is_off ? GPD_STATE_POWER_OFF : GPD_STATE_ACTIVE;
  1373. init_waitqueue_head(&genpd->status_wait_queue);
  1374. genpd->poweroff_task = NULL;
  1375. genpd->resume_count = 0;
  1376. genpd->device_count = 0;
  1377. genpd->max_off_time_ns = -1;
  1378. genpd->domain.ops.runtime_suspend = pm_genpd_runtime_suspend;
  1379. genpd->domain.ops.runtime_resume = pm_genpd_runtime_resume;
  1380. genpd->domain.ops.runtime_idle = pm_generic_runtime_idle;
  1381. genpd->domain.ops.prepare = pm_genpd_prepare;
  1382. genpd->domain.ops.suspend = pm_genpd_suspend;
  1383. genpd->domain.ops.suspend_late = pm_genpd_suspend_late;
  1384. genpd->domain.ops.suspend_noirq = pm_genpd_suspend_noirq;
  1385. genpd->domain.ops.resume_noirq = pm_genpd_resume_noirq;
  1386. genpd->domain.ops.resume_early = pm_genpd_resume_early;
  1387. genpd->domain.ops.resume = pm_genpd_resume;
  1388. genpd->domain.ops.freeze = pm_genpd_freeze;
  1389. genpd->domain.ops.freeze_late = pm_genpd_freeze_late;
  1390. genpd->domain.ops.freeze_noirq = pm_genpd_freeze_noirq;
  1391. genpd->domain.ops.thaw_noirq = pm_genpd_thaw_noirq;
  1392. genpd->domain.ops.thaw_early = pm_genpd_thaw_early;
  1393. genpd->domain.ops.thaw = pm_genpd_thaw;
  1394. genpd->domain.ops.poweroff = pm_genpd_suspend;
  1395. genpd->domain.ops.poweroff_late = pm_genpd_suspend_late;
  1396. genpd->domain.ops.poweroff_noirq = pm_genpd_suspend_noirq;
  1397. genpd->domain.ops.restore_noirq = pm_genpd_restore_noirq;
  1398. genpd->domain.ops.restore_early = pm_genpd_resume_early;
  1399. genpd->domain.ops.restore = pm_genpd_resume;
  1400. genpd->domain.ops.complete = pm_genpd_complete;
  1401. genpd->dev_ops.save_state = pm_genpd_default_save_state;
  1402. genpd->dev_ops.restore_state = pm_genpd_default_restore_state;
  1403. genpd->dev_ops.suspend = pm_genpd_default_suspend;
  1404. genpd->dev_ops.suspend_late = pm_genpd_default_suspend_late;
  1405. genpd->dev_ops.resume_early = pm_genpd_default_resume_early;
  1406. genpd->dev_ops.resume = pm_genpd_default_resume;
  1407. genpd->dev_ops.freeze = pm_genpd_default_freeze;
  1408. genpd->dev_ops.freeze_late = pm_genpd_default_freeze_late;
  1409. genpd->dev_ops.thaw_early = pm_genpd_default_thaw_early;
  1410. genpd->dev_ops.thaw = pm_genpd_default_thaw;
  1411. mutex_lock(&gpd_list_lock);
  1412. list_add(&genpd->gpd_list_node, &gpd_list);
  1413. mutex_unlock(&gpd_list_lock);
  1414. }