domain.c 44 KB

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