devfreq.c 53 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * devfreq: Generic Dynamic Voltage and Frequency Scaling (DVFS) Framework
  4. * for Non-CPU Devices.
  5. *
  6. * Copyright (C) 2011 Samsung Electronics
  7. * MyungJoo Ham <[email protected]>
  8. */
  9. #include <linux/kernel.h>
  10. #include <linux/kmod.h>
  11. #include <linux/sched.h>
  12. #include <linux/debugfs.h>
  13. #include <linux/errno.h>
  14. #include <linux/err.h>
  15. #include <linux/init.h>
  16. #include <linux/export.h>
  17. #include <linux/slab.h>
  18. #include <linux/stat.h>
  19. #include <linux/pm_opp.h>
  20. #include <linux/devfreq.h>
  21. #include <linux/workqueue.h>
  22. #include <linux/platform_device.h>
  23. #include <linux/list.h>
  24. #include <linux/printk.h>
  25. #include <linux/hrtimer.h>
  26. #include <linux/of.h>
  27. #include <linux/pm_qos.h>
  28. #include "governor.h"
  29. #define CREATE_TRACE_POINTS
  30. #include <trace/events/devfreq.h>
  31. #define HZ_PER_KHZ 1000
  32. static struct class *devfreq_class;
  33. static struct dentry *devfreq_debugfs;
  34. /*
  35. * devfreq core provides delayed work based load monitoring helper
  36. * functions. Governors can use these or can implement their own
  37. * monitoring mechanism.
  38. */
  39. static struct workqueue_struct *devfreq_wq;
  40. /* The list of all device-devfreq governors */
  41. static LIST_HEAD(devfreq_governor_list);
  42. /* The list of all device-devfreq */
  43. static LIST_HEAD(devfreq_list);
  44. static DEFINE_MUTEX(devfreq_list_lock);
  45. static const char timer_name[][DEVFREQ_NAME_LEN] = {
  46. [DEVFREQ_TIMER_DEFERRABLE] = { "deferrable" },
  47. [DEVFREQ_TIMER_DELAYED] = { "delayed" },
  48. };
  49. /**
  50. * find_device_devfreq() - find devfreq struct using device pointer
  51. * @dev: device pointer used to lookup device devfreq.
  52. *
  53. * Search the list of device devfreqs and return the matched device's
  54. * devfreq info. devfreq_list_lock should be held by the caller.
  55. */
  56. static struct devfreq *find_device_devfreq(struct device *dev)
  57. {
  58. struct devfreq *tmp_devfreq;
  59. lockdep_assert_held(&devfreq_list_lock);
  60. if (IS_ERR_OR_NULL(dev)) {
  61. pr_err("DEVFREQ: %s: Invalid parameters\n", __func__);
  62. return ERR_PTR(-EINVAL);
  63. }
  64. list_for_each_entry(tmp_devfreq, &devfreq_list, node) {
  65. if (tmp_devfreq->dev.parent == dev)
  66. return tmp_devfreq;
  67. }
  68. return ERR_PTR(-ENODEV);
  69. }
  70. static unsigned long find_available_min_freq(struct devfreq *devfreq)
  71. {
  72. struct dev_pm_opp *opp;
  73. unsigned long min_freq = 0;
  74. opp = dev_pm_opp_find_freq_ceil(devfreq->dev.parent, &min_freq);
  75. if (IS_ERR(opp))
  76. min_freq = 0;
  77. else
  78. dev_pm_opp_put(opp);
  79. return min_freq;
  80. }
  81. static unsigned long find_available_max_freq(struct devfreq *devfreq)
  82. {
  83. struct dev_pm_opp *opp;
  84. unsigned long max_freq = ULONG_MAX;
  85. opp = dev_pm_opp_find_freq_floor(devfreq->dev.parent, &max_freq);
  86. if (IS_ERR(opp))
  87. max_freq = 0;
  88. else
  89. dev_pm_opp_put(opp);
  90. return max_freq;
  91. }
  92. /**
  93. * get_freq_range() - Get the current freq range
  94. * @devfreq: the devfreq instance
  95. * @min_freq: the min frequency
  96. * @max_freq: the max frequency
  97. *
  98. * This takes into consideration all constraints.
  99. */
  100. static void get_freq_range(struct devfreq *devfreq,
  101. unsigned long *min_freq,
  102. unsigned long *max_freq)
  103. {
  104. unsigned long *freq_table = devfreq->profile->freq_table;
  105. s32 qos_min_freq, qos_max_freq;
  106. lockdep_assert_held(&devfreq->lock);
  107. /*
  108. * Initialize minimum/maximum frequency from freq table.
  109. * The devfreq drivers can initialize this in either ascending or
  110. * descending order and devfreq core supports both.
  111. */
  112. if (freq_table[0] < freq_table[devfreq->profile->max_state - 1]) {
  113. *min_freq = freq_table[0];
  114. *max_freq = freq_table[devfreq->profile->max_state - 1];
  115. } else {
  116. *min_freq = freq_table[devfreq->profile->max_state - 1];
  117. *max_freq = freq_table[0];
  118. }
  119. /* Apply constraints from PM QoS */
  120. qos_min_freq = dev_pm_qos_read_value(devfreq->dev.parent,
  121. DEV_PM_QOS_MIN_FREQUENCY);
  122. qos_max_freq = dev_pm_qos_read_value(devfreq->dev.parent,
  123. DEV_PM_QOS_MAX_FREQUENCY);
  124. *min_freq = max(*min_freq, (unsigned long)HZ_PER_KHZ * qos_min_freq);
  125. if (qos_max_freq != PM_QOS_MAX_FREQUENCY_DEFAULT_VALUE)
  126. *max_freq = min(*max_freq,
  127. (unsigned long)HZ_PER_KHZ * qos_max_freq);
  128. /* Apply constraints from OPP interface */
  129. *min_freq = max(*min_freq, devfreq->scaling_min_freq);
  130. *max_freq = min(*max_freq, devfreq->scaling_max_freq);
  131. if (*min_freq > *max_freq)
  132. *min_freq = *max_freq;
  133. }
  134. /**
  135. * devfreq_get_freq_level() - Lookup freq_table for the frequency
  136. * @devfreq: the devfreq instance
  137. * @freq: the target frequency
  138. */
  139. static int devfreq_get_freq_level(struct devfreq *devfreq, unsigned long freq)
  140. {
  141. int lev;
  142. for (lev = 0; lev < devfreq->profile->max_state; lev++)
  143. if (freq == devfreq->profile->freq_table[lev])
  144. return lev;
  145. return -EINVAL;
  146. }
  147. static int set_freq_table(struct devfreq *devfreq)
  148. {
  149. struct devfreq_dev_profile *profile = devfreq->profile;
  150. struct dev_pm_opp *opp;
  151. unsigned long freq;
  152. int i, count;
  153. /* Initialize the freq_table from OPP table */
  154. count = dev_pm_opp_get_opp_count(devfreq->dev.parent);
  155. if (count <= 0)
  156. return -EINVAL;
  157. profile->max_state = count;
  158. profile->freq_table = devm_kcalloc(devfreq->dev.parent,
  159. profile->max_state,
  160. sizeof(*profile->freq_table),
  161. GFP_KERNEL);
  162. if (!profile->freq_table) {
  163. profile->max_state = 0;
  164. return -ENOMEM;
  165. }
  166. for (i = 0, freq = 0; i < profile->max_state; i++, freq++) {
  167. opp = dev_pm_opp_find_freq_ceil(devfreq->dev.parent, &freq);
  168. if (IS_ERR(opp)) {
  169. devm_kfree(devfreq->dev.parent, profile->freq_table);
  170. profile->max_state = 0;
  171. return PTR_ERR(opp);
  172. }
  173. dev_pm_opp_put(opp);
  174. profile->freq_table[i] = freq;
  175. }
  176. return 0;
  177. }
  178. /**
  179. * devfreq_update_status() - Update statistics of devfreq behavior
  180. * @devfreq: the devfreq instance
  181. * @freq: the update target frequency
  182. */
  183. int devfreq_update_status(struct devfreq *devfreq, unsigned long freq)
  184. {
  185. int lev, prev_lev, ret = 0;
  186. u64 cur_time;
  187. lockdep_assert_held(&devfreq->lock);
  188. cur_time = get_jiffies_64();
  189. /* Immediately exit if previous_freq is not initialized yet. */
  190. if (!devfreq->previous_freq)
  191. goto out;
  192. prev_lev = devfreq_get_freq_level(devfreq, devfreq->previous_freq);
  193. if (prev_lev < 0) {
  194. ret = prev_lev;
  195. goto out;
  196. }
  197. devfreq->stats.time_in_state[prev_lev] +=
  198. cur_time - devfreq->stats.last_update;
  199. lev = devfreq_get_freq_level(devfreq, freq);
  200. if (lev < 0) {
  201. ret = lev;
  202. goto out;
  203. }
  204. if (lev != prev_lev) {
  205. devfreq->stats.trans_table[
  206. (prev_lev * devfreq->profile->max_state) + lev]++;
  207. devfreq->stats.total_trans++;
  208. }
  209. out:
  210. devfreq->stats.last_update = cur_time;
  211. return ret;
  212. }
  213. EXPORT_SYMBOL(devfreq_update_status);
  214. /**
  215. * find_devfreq_governor() - find devfreq governor from name
  216. * @name: name of the governor
  217. *
  218. * Search the list of devfreq governors and return the matched
  219. * governor's pointer. devfreq_list_lock should be held by the caller.
  220. */
  221. static struct devfreq_governor *find_devfreq_governor(const char *name)
  222. {
  223. struct devfreq_governor *tmp_governor;
  224. lockdep_assert_held(&devfreq_list_lock);
  225. if (IS_ERR_OR_NULL(name)) {
  226. pr_err("DEVFREQ: %s: Invalid parameters\n", __func__);
  227. return ERR_PTR(-EINVAL);
  228. }
  229. list_for_each_entry(tmp_governor, &devfreq_governor_list, node) {
  230. if (!strncmp(tmp_governor->name, name, DEVFREQ_NAME_LEN))
  231. return tmp_governor;
  232. }
  233. return ERR_PTR(-ENODEV);
  234. }
  235. /**
  236. * try_then_request_governor() - Try to find the governor and request the
  237. * module if is not found.
  238. * @name: name of the governor
  239. *
  240. * Search the list of devfreq governors and request the module and try again
  241. * if is not found. This can happen when both drivers (the governor driver
  242. * and the driver that call devfreq_add_device) are built as modules.
  243. * devfreq_list_lock should be held by the caller. Returns the matched
  244. * governor's pointer or an error pointer.
  245. */
  246. static struct devfreq_governor *try_then_request_governor(const char *name)
  247. {
  248. struct devfreq_governor *governor;
  249. int err = 0;
  250. lockdep_assert_held(&devfreq_list_lock);
  251. if (IS_ERR_OR_NULL(name)) {
  252. pr_err("DEVFREQ: %s: Invalid parameters\n", __func__);
  253. return ERR_PTR(-EINVAL);
  254. }
  255. governor = find_devfreq_governor(name);
  256. if (IS_ERR(governor)) {
  257. mutex_unlock(&devfreq_list_lock);
  258. if (!strncmp(name, DEVFREQ_GOV_SIMPLE_ONDEMAND,
  259. DEVFREQ_NAME_LEN))
  260. err = request_module("governor_%s", "simpleondemand");
  261. else
  262. err = request_module("governor_%s", name);
  263. /* Restore previous state before return */
  264. mutex_lock(&devfreq_list_lock);
  265. if (err)
  266. return (err < 0) ? ERR_PTR(err) : ERR_PTR(-EINVAL);
  267. governor = find_devfreq_governor(name);
  268. }
  269. return governor;
  270. }
  271. static int devfreq_notify_transition(struct devfreq *devfreq,
  272. struct devfreq_freqs *freqs, unsigned int state)
  273. {
  274. if (!devfreq)
  275. return -EINVAL;
  276. switch (state) {
  277. case DEVFREQ_PRECHANGE:
  278. srcu_notifier_call_chain(&devfreq->transition_notifier_list,
  279. DEVFREQ_PRECHANGE, freqs);
  280. break;
  281. case DEVFREQ_POSTCHANGE:
  282. srcu_notifier_call_chain(&devfreq->transition_notifier_list,
  283. DEVFREQ_POSTCHANGE, freqs);
  284. break;
  285. default:
  286. return -EINVAL;
  287. }
  288. return 0;
  289. }
  290. static int devfreq_set_target(struct devfreq *devfreq, unsigned long new_freq,
  291. u32 flags)
  292. {
  293. struct devfreq_freqs freqs;
  294. unsigned long cur_freq;
  295. int err = 0;
  296. if (devfreq->profile->get_cur_freq)
  297. devfreq->profile->get_cur_freq(devfreq->dev.parent, &cur_freq);
  298. else
  299. cur_freq = devfreq->previous_freq;
  300. freqs.old = cur_freq;
  301. freqs.new = new_freq;
  302. devfreq_notify_transition(devfreq, &freqs, DEVFREQ_PRECHANGE);
  303. err = devfreq->profile->target(devfreq->dev.parent, &new_freq, flags);
  304. if (err) {
  305. freqs.new = cur_freq;
  306. devfreq_notify_transition(devfreq, &freqs, DEVFREQ_POSTCHANGE);
  307. return err;
  308. }
  309. freqs.new = new_freq;
  310. devfreq_notify_transition(devfreq, &freqs, DEVFREQ_POSTCHANGE);
  311. if (devfreq_update_status(devfreq, new_freq))
  312. dev_err(&devfreq->dev,
  313. "Couldn't update frequency transition information.\n");
  314. devfreq->previous_freq = new_freq;
  315. if (devfreq->suspend_freq)
  316. devfreq->resume_freq = new_freq;
  317. return err;
  318. }
  319. /* Load monitoring helper functions for governors use */
  320. /**
  321. * update_devfreq() - Reevaluate the device and configure frequency.
  322. * @devfreq: the devfreq instance.
  323. *
  324. * Note: Lock devfreq->lock before calling update_devfreq
  325. * This function is exported for governors.
  326. */
  327. int update_devfreq(struct devfreq *devfreq)
  328. {
  329. unsigned long freq, min_freq, max_freq;
  330. int err = 0;
  331. u32 flags = 0;
  332. lockdep_assert_held(&devfreq->lock);
  333. if (!devfreq->governor)
  334. return -EINVAL;
  335. /* Reevaluate the proper frequency */
  336. err = devfreq->governor->get_target_freq(devfreq, &freq);
  337. if (err)
  338. return err;
  339. get_freq_range(devfreq, &min_freq, &max_freq);
  340. if (freq < min_freq) {
  341. freq = min_freq;
  342. flags &= ~DEVFREQ_FLAG_LEAST_UPPER_BOUND; /* Use GLB */
  343. }
  344. if (freq > max_freq) {
  345. freq = max_freq;
  346. flags |= DEVFREQ_FLAG_LEAST_UPPER_BOUND; /* Use LUB */
  347. }
  348. return devfreq_set_target(devfreq, freq, flags);
  349. }
  350. EXPORT_SYMBOL(update_devfreq);
  351. /**
  352. * devfreq_monitor() - Periodically poll devfreq objects.
  353. * @work: the work struct used to run devfreq_monitor periodically.
  354. *
  355. */
  356. static void devfreq_monitor(struct work_struct *work)
  357. {
  358. int err;
  359. struct devfreq *devfreq = container_of(work,
  360. struct devfreq, work.work);
  361. mutex_lock(&devfreq->lock);
  362. err = update_devfreq(devfreq);
  363. if (err)
  364. dev_err(&devfreq->dev, "dvfs failed with (%d) error\n", err);
  365. if (devfreq->stop_polling)
  366. goto out;
  367. queue_delayed_work(devfreq_wq, &devfreq->work,
  368. msecs_to_jiffies(devfreq->profile->polling_ms));
  369. out:
  370. mutex_unlock(&devfreq->lock);
  371. trace_devfreq_monitor(devfreq);
  372. }
  373. /**
  374. * devfreq_monitor_start() - Start load monitoring of devfreq instance
  375. * @devfreq: the devfreq instance.
  376. *
  377. * Helper function for starting devfreq device load monitoring. By
  378. * default delayed work based monitoring is supported. Function
  379. * to be called from governor in response to DEVFREQ_GOV_START
  380. * event when device is added to devfreq framework.
  381. */
  382. void devfreq_monitor_start(struct devfreq *devfreq)
  383. {
  384. if (devfreq->governor->interrupt_driven)
  385. return;
  386. mutex_lock(&devfreq->lock);
  387. if (delayed_work_pending(&devfreq->work))
  388. goto out;
  389. switch (devfreq->profile->timer) {
  390. case DEVFREQ_TIMER_DEFERRABLE:
  391. INIT_DEFERRABLE_WORK(&devfreq->work, devfreq_monitor);
  392. break;
  393. case DEVFREQ_TIMER_DELAYED:
  394. INIT_DELAYED_WORK(&devfreq->work, devfreq_monitor);
  395. break;
  396. default:
  397. goto out;
  398. }
  399. if (devfreq->profile->polling_ms)
  400. queue_delayed_work(devfreq_wq, &devfreq->work,
  401. msecs_to_jiffies(devfreq->profile->polling_ms));
  402. out:
  403. devfreq->stop_polling = false;
  404. mutex_unlock(&devfreq->lock);
  405. }
  406. EXPORT_SYMBOL(devfreq_monitor_start);
  407. /**
  408. * devfreq_monitor_stop() - Stop load monitoring of a devfreq instance
  409. * @devfreq: the devfreq instance.
  410. *
  411. * Helper function to stop devfreq device load monitoring. Function
  412. * to be called from governor in response to DEVFREQ_GOV_STOP
  413. * event when device is removed from devfreq framework.
  414. */
  415. void devfreq_monitor_stop(struct devfreq *devfreq)
  416. {
  417. if (devfreq->governor->interrupt_driven)
  418. return;
  419. mutex_lock(&devfreq->lock);
  420. if (devfreq->stop_polling) {
  421. mutex_unlock(&devfreq->lock);
  422. return;
  423. }
  424. devfreq->stop_polling = true;
  425. mutex_unlock(&devfreq->lock);
  426. cancel_delayed_work_sync(&devfreq->work);
  427. }
  428. EXPORT_SYMBOL(devfreq_monitor_stop);
  429. /**
  430. * devfreq_monitor_suspend() - Suspend load monitoring of a devfreq instance
  431. * @devfreq: the devfreq instance.
  432. *
  433. * Helper function to suspend devfreq device load monitoring. Function
  434. * to be called from governor in response to DEVFREQ_GOV_SUSPEND
  435. * event or when polling interval is set to zero.
  436. *
  437. * Note: Though this function is same as devfreq_monitor_stop(),
  438. * intentionally kept separate to provide hooks for collecting
  439. * transition statistics.
  440. */
  441. void devfreq_monitor_suspend(struct devfreq *devfreq)
  442. {
  443. mutex_lock(&devfreq->lock);
  444. if (devfreq->stop_polling) {
  445. mutex_unlock(&devfreq->lock);
  446. return;
  447. }
  448. devfreq_update_status(devfreq, devfreq->previous_freq);
  449. devfreq->stop_polling = true;
  450. mutex_unlock(&devfreq->lock);
  451. if (devfreq->governor->interrupt_driven)
  452. return;
  453. cancel_delayed_work_sync(&devfreq->work);
  454. }
  455. EXPORT_SYMBOL(devfreq_monitor_suspend);
  456. /**
  457. * devfreq_monitor_resume() - Resume load monitoring of a devfreq instance
  458. * @devfreq: the devfreq instance.
  459. *
  460. * Helper function to resume devfreq device load monitoring. Function
  461. * to be called from governor in response to DEVFREQ_GOV_RESUME
  462. * event or when polling interval is set to non-zero.
  463. */
  464. void devfreq_monitor_resume(struct devfreq *devfreq)
  465. {
  466. unsigned long freq;
  467. mutex_lock(&devfreq->lock);
  468. if (!devfreq->stop_polling)
  469. goto out;
  470. if (devfreq->governor->interrupt_driven)
  471. goto out_update;
  472. if (!delayed_work_pending(&devfreq->work) &&
  473. devfreq->profile->polling_ms)
  474. queue_delayed_work(devfreq_wq, &devfreq->work,
  475. msecs_to_jiffies(devfreq->profile->polling_ms));
  476. out_update:
  477. devfreq->stats.last_update = get_jiffies_64();
  478. devfreq->stop_polling = false;
  479. if (devfreq->profile->get_cur_freq &&
  480. !devfreq->profile->get_cur_freq(devfreq->dev.parent, &freq))
  481. devfreq->previous_freq = freq;
  482. out:
  483. mutex_unlock(&devfreq->lock);
  484. }
  485. EXPORT_SYMBOL(devfreq_monitor_resume);
  486. /**
  487. * devfreq_update_interval() - Update device devfreq monitoring interval
  488. * @devfreq: the devfreq instance.
  489. * @delay: new polling interval to be set.
  490. *
  491. * Helper function to set new load monitoring polling interval. Function
  492. * to be called from governor in response to DEVFREQ_GOV_UPDATE_INTERVAL event.
  493. */
  494. void devfreq_update_interval(struct devfreq *devfreq, unsigned int *delay)
  495. {
  496. unsigned int cur_delay = devfreq->profile->polling_ms;
  497. unsigned int new_delay = *delay;
  498. mutex_lock(&devfreq->lock);
  499. devfreq->profile->polling_ms = new_delay;
  500. if (devfreq->stop_polling)
  501. goto out;
  502. if (devfreq->governor->interrupt_driven)
  503. goto out;
  504. /* if new delay is zero, stop polling */
  505. if (!new_delay) {
  506. mutex_unlock(&devfreq->lock);
  507. cancel_delayed_work_sync(&devfreq->work);
  508. return;
  509. }
  510. /* if current delay is zero, start polling with new delay */
  511. if (!cur_delay) {
  512. queue_delayed_work(devfreq_wq, &devfreq->work,
  513. msecs_to_jiffies(devfreq->profile->polling_ms));
  514. goto out;
  515. }
  516. /* if current delay is greater than new delay, restart polling */
  517. if (cur_delay > new_delay) {
  518. mutex_unlock(&devfreq->lock);
  519. cancel_delayed_work_sync(&devfreq->work);
  520. mutex_lock(&devfreq->lock);
  521. if (!devfreq->stop_polling)
  522. queue_delayed_work(devfreq_wq, &devfreq->work,
  523. msecs_to_jiffies(devfreq->profile->polling_ms));
  524. }
  525. out:
  526. mutex_unlock(&devfreq->lock);
  527. }
  528. EXPORT_SYMBOL(devfreq_update_interval);
  529. /**
  530. * devfreq_notifier_call() - Notify that the device frequency requirements
  531. * has been changed out of devfreq framework.
  532. * @nb: the notifier_block (supposed to be devfreq->nb)
  533. * @type: not used
  534. * @devp: not used
  535. *
  536. * Called by a notifier that uses devfreq->nb.
  537. */
  538. static int devfreq_notifier_call(struct notifier_block *nb, unsigned long type,
  539. void *devp)
  540. {
  541. struct devfreq *devfreq = container_of(nb, struct devfreq, nb);
  542. int err = -EINVAL;
  543. mutex_lock(&devfreq->lock);
  544. devfreq->scaling_min_freq = find_available_min_freq(devfreq);
  545. if (!devfreq->scaling_min_freq)
  546. goto out;
  547. devfreq->scaling_max_freq = find_available_max_freq(devfreq);
  548. if (!devfreq->scaling_max_freq) {
  549. devfreq->scaling_max_freq = ULONG_MAX;
  550. goto out;
  551. }
  552. err = update_devfreq(devfreq);
  553. out:
  554. mutex_unlock(&devfreq->lock);
  555. if (err)
  556. dev_err(devfreq->dev.parent,
  557. "failed to update frequency from OPP notifier (%d)\n",
  558. err);
  559. return NOTIFY_OK;
  560. }
  561. /**
  562. * qos_notifier_call() - Common handler for QoS constraints.
  563. * @devfreq: the devfreq instance.
  564. */
  565. static int qos_notifier_call(struct devfreq *devfreq)
  566. {
  567. int err;
  568. mutex_lock(&devfreq->lock);
  569. err = update_devfreq(devfreq);
  570. mutex_unlock(&devfreq->lock);
  571. if (err)
  572. dev_err(devfreq->dev.parent,
  573. "failed to update frequency from PM QoS (%d)\n",
  574. err);
  575. return NOTIFY_OK;
  576. }
  577. /**
  578. * qos_min_notifier_call() - Callback for QoS min_freq changes.
  579. * @nb: Should be devfreq->nb_min
  580. */
  581. static int qos_min_notifier_call(struct notifier_block *nb,
  582. unsigned long val, void *ptr)
  583. {
  584. return qos_notifier_call(container_of(nb, struct devfreq, nb_min));
  585. }
  586. /**
  587. * qos_max_notifier_call() - Callback for QoS max_freq changes.
  588. * @nb: Should be devfreq->nb_max
  589. */
  590. static int qos_max_notifier_call(struct notifier_block *nb,
  591. unsigned long val, void *ptr)
  592. {
  593. return qos_notifier_call(container_of(nb, struct devfreq, nb_max));
  594. }
  595. /**
  596. * devfreq_dev_release() - Callback for struct device to release the device.
  597. * @dev: the devfreq device
  598. *
  599. * Remove devfreq from the list and release its resources.
  600. */
  601. static void devfreq_dev_release(struct device *dev)
  602. {
  603. struct devfreq *devfreq = to_devfreq(dev);
  604. int err;
  605. mutex_lock(&devfreq_list_lock);
  606. list_del(&devfreq->node);
  607. mutex_unlock(&devfreq_list_lock);
  608. err = dev_pm_qos_remove_notifier(devfreq->dev.parent, &devfreq->nb_max,
  609. DEV_PM_QOS_MAX_FREQUENCY);
  610. if (err && err != -ENOENT)
  611. dev_warn(dev->parent,
  612. "Failed to remove max_freq notifier: %d\n", err);
  613. err = dev_pm_qos_remove_notifier(devfreq->dev.parent, &devfreq->nb_min,
  614. DEV_PM_QOS_MIN_FREQUENCY);
  615. if (err && err != -ENOENT)
  616. dev_warn(dev->parent,
  617. "Failed to remove min_freq notifier: %d\n", err);
  618. if (dev_pm_qos_request_active(&devfreq->user_max_freq_req)) {
  619. err = dev_pm_qos_remove_request(&devfreq->user_max_freq_req);
  620. if (err < 0)
  621. dev_warn(dev->parent,
  622. "Failed to remove max_freq request: %d\n", err);
  623. }
  624. if (dev_pm_qos_request_active(&devfreq->user_min_freq_req)) {
  625. err = dev_pm_qos_remove_request(&devfreq->user_min_freq_req);
  626. if (err < 0)
  627. dev_warn(dev->parent,
  628. "Failed to remove min_freq request: %d\n", err);
  629. }
  630. if (devfreq->profile->exit)
  631. devfreq->profile->exit(devfreq->dev.parent);
  632. mutex_destroy(&devfreq->lock);
  633. srcu_cleanup_notifier_head(&devfreq->transition_notifier_list);
  634. kfree(devfreq);
  635. }
  636. /**
  637. * devfreq_add_device() - Add devfreq feature to the device
  638. * @dev: the device to add devfreq feature.
  639. * @profile: device-specific profile to run devfreq.
  640. * @governor_name: name of the policy to choose frequency.
  641. * @data: private data for the governor. The devfreq framework does not
  642. * touch this value.
  643. */
  644. struct devfreq *devfreq_add_device(struct device *dev,
  645. struct devfreq_dev_profile *profile,
  646. const char *governor_name,
  647. void *data)
  648. {
  649. struct devfreq *devfreq;
  650. struct devfreq_governor *governor;
  651. int err = 0;
  652. if (!dev || !profile || !governor_name) {
  653. dev_err(dev, "%s: Invalid parameters.\n", __func__);
  654. return ERR_PTR(-EINVAL);
  655. }
  656. mutex_lock(&devfreq_list_lock);
  657. devfreq = find_device_devfreq(dev);
  658. mutex_unlock(&devfreq_list_lock);
  659. if (!IS_ERR(devfreq)) {
  660. dev_err(dev, "%s: devfreq device already exists!\n",
  661. __func__);
  662. err = -EINVAL;
  663. goto err_out;
  664. }
  665. devfreq = kzalloc(sizeof(struct devfreq), GFP_KERNEL);
  666. if (!devfreq) {
  667. err = -ENOMEM;
  668. goto err_out;
  669. }
  670. mutex_init(&devfreq->lock);
  671. mutex_lock(&devfreq->lock);
  672. devfreq->dev.parent = dev;
  673. devfreq->dev.class = devfreq_class;
  674. devfreq->dev.release = devfreq_dev_release;
  675. INIT_LIST_HEAD(&devfreq->node);
  676. devfreq->profile = profile;
  677. strscpy(devfreq->governor_name, governor_name, DEVFREQ_NAME_LEN);
  678. devfreq->previous_freq = profile->initial_freq;
  679. devfreq->last_status.current_frequency = profile->initial_freq;
  680. devfreq->data = data;
  681. devfreq->nb.notifier_call = devfreq_notifier_call;
  682. if (devfreq->profile->timer < 0
  683. || devfreq->profile->timer >= DEVFREQ_TIMER_NUM) {
  684. mutex_unlock(&devfreq->lock);
  685. err = -EINVAL;
  686. goto err_dev;
  687. }
  688. if (!devfreq->profile->max_state && !devfreq->profile->freq_table) {
  689. mutex_unlock(&devfreq->lock);
  690. err = set_freq_table(devfreq);
  691. if (err < 0)
  692. goto err_dev;
  693. mutex_lock(&devfreq->lock);
  694. }
  695. devfreq->scaling_min_freq = find_available_min_freq(devfreq);
  696. if (!devfreq->scaling_min_freq) {
  697. mutex_unlock(&devfreq->lock);
  698. err = -EINVAL;
  699. goto err_dev;
  700. }
  701. devfreq->scaling_max_freq = find_available_max_freq(devfreq);
  702. if (!devfreq->scaling_max_freq) {
  703. mutex_unlock(&devfreq->lock);
  704. err = -EINVAL;
  705. goto err_dev;
  706. }
  707. devfreq->suspend_freq = dev_pm_opp_get_suspend_opp_freq(dev);
  708. atomic_set(&devfreq->suspend_count, 0);
  709. dev_set_name(&devfreq->dev, "%s", dev_name(dev));
  710. err = device_register(&devfreq->dev);
  711. if (err) {
  712. mutex_unlock(&devfreq->lock);
  713. put_device(&devfreq->dev);
  714. goto err_out;
  715. }
  716. devfreq->stats.trans_table = devm_kzalloc(&devfreq->dev,
  717. array3_size(sizeof(unsigned int),
  718. devfreq->profile->max_state,
  719. devfreq->profile->max_state),
  720. GFP_KERNEL);
  721. if (!devfreq->stats.trans_table) {
  722. mutex_unlock(&devfreq->lock);
  723. err = -ENOMEM;
  724. goto err_devfreq;
  725. }
  726. devfreq->stats.time_in_state = devm_kcalloc(&devfreq->dev,
  727. devfreq->profile->max_state,
  728. sizeof(*devfreq->stats.time_in_state),
  729. GFP_KERNEL);
  730. if (!devfreq->stats.time_in_state) {
  731. mutex_unlock(&devfreq->lock);
  732. err = -ENOMEM;
  733. goto err_devfreq;
  734. }
  735. devfreq->stats.total_trans = 0;
  736. devfreq->stats.last_update = get_jiffies_64();
  737. srcu_init_notifier_head(&devfreq->transition_notifier_list);
  738. mutex_unlock(&devfreq->lock);
  739. err = dev_pm_qos_add_request(dev, &devfreq->user_min_freq_req,
  740. DEV_PM_QOS_MIN_FREQUENCY, 0);
  741. if (err < 0)
  742. goto err_devfreq;
  743. err = dev_pm_qos_add_request(dev, &devfreq->user_max_freq_req,
  744. DEV_PM_QOS_MAX_FREQUENCY,
  745. PM_QOS_MAX_FREQUENCY_DEFAULT_VALUE);
  746. if (err < 0)
  747. goto err_devfreq;
  748. devfreq->nb_min.notifier_call = qos_min_notifier_call;
  749. err = dev_pm_qos_add_notifier(devfreq->dev.parent, &devfreq->nb_min,
  750. DEV_PM_QOS_MIN_FREQUENCY);
  751. if (err)
  752. goto err_devfreq;
  753. devfreq->nb_max.notifier_call = qos_max_notifier_call;
  754. err = dev_pm_qos_add_notifier(devfreq->dev.parent, &devfreq->nb_max,
  755. DEV_PM_QOS_MAX_FREQUENCY);
  756. if (err)
  757. goto err_devfreq;
  758. mutex_lock(&devfreq_list_lock);
  759. governor = try_then_request_governor(devfreq->governor_name);
  760. if (IS_ERR(governor)) {
  761. dev_err(dev, "%s: Unable to find governor for the device\n",
  762. __func__);
  763. err = PTR_ERR(governor);
  764. goto err_init;
  765. }
  766. devfreq->governor = governor;
  767. err = devfreq->governor->event_handler(devfreq, DEVFREQ_GOV_START,
  768. NULL);
  769. if (err) {
  770. dev_err(dev, "%s: Unable to start governor for the device\n",
  771. __func__);
  772. goto err_init;
  773. }
  774. list_add(&devfreq->node, &devfreq_list);
  775. mutex_unlock(&devfreq_list_lock);
  776. return devfreq;
  777. err_init:
  778. mutex_unlock(&devfreq_list_lock);
  779. err_devfreq:
  780. devfreq_remove_device(devfreq);
  781. devfreq = NULL;
  782. err_dev:
  783. kfree(devfreq);
  784. err_out:
  785. return ERR_PTR(err);
  786. }
  787. EXPORT_SYMBOL(devfreq_add_device);
  788. /**
  789. * devfreq_remove_device() - Remove devfreq feature from a device.
  790. * @devfreq: the devfreq instance to be removed
  791. *
  792. * The opposite of devfreq_add_device().
  793. */
  794. int devfreq_remove_device(struct devfreq *devfreq)
  795. {
  796. if (!devfreq)
  797. return -EINVAL;
  798. if (devfreq->governor)
  799. devfreq->governor->event_handler(devfreq,
  800. DEVFREQ_GOV_STOP, NULL);
  801. device_unregister(&devfreq->dev);
  802. return 0;
  803. }
  804. EXPORT_SYMBOL(devfreq_remove_device);
  805. static int devm_devfreq_dev_match(struct device *dev, void *res, void *data)
  806. {
  807. struct devfreq **r = res;
  808. if (WARN_ON(!r || !*r))
  809. return 0;
  810. return *r == data;
  811. }
  812. static void devm_devfreq_dev_release(struct device *dev, void *res)
  813. {
  814. devfreq_remove_device(*(struct devfreq **)res);
  815. }
  816. /**
  817. * devm_devfreq_add_device() - Resource-managed devfreq_add_device()
  818. * @dev: the device to add devfreq feature.
  819. * @profile: device-specific profile to run devfreq.
  820. * @governor_name: name of the policy to choose frequency.
  821. * @data: private data for the governor. The devfreq framework does not
  822. * touch this value.
  823. *
  824. * This function manages automatically the memory of devfreq device using device
  825. * resource management and simplify the free operation for memory of devfreq
  826. * device.
  827. */
  828. struct devfreq *devm_devfreq_add_device(struct device *dev,
  829. struct devfreq_dev_profile *profile,
  830. const char *governor_name,
  831. void *data)
  832. {
  833. struct devfreq **ptr, *devfreq;
  834. ptr = devres_alloc(devm_devfreq_dev_release, sizeof(*ptr), GFP_KERNEL);
  835. if (!ptr)
  836. return ERR_PTR(-ENOMEM);
  837. devfreq = devfreq_add_device(dev, profile, governor_name, data);
  838. if (IS_ERR(devfreq)) {
  839. devres_free(ptr);
  840. return devfreq;
  841. }
  842. *ptr = devfreq;
  843. devres_add(dev, ptr);
  844. return devfreq;
  845. }
  846. EXPORT_SYMBOL(devm_devfreq_add_device);
  847. #ifdef CONFIG_OF
  848. /*
  849. * devfreq_get_devfreq_by_node - Get the devfreq device from devicetree
  850. * @node - pointer to device_node
  851. *
  852. * return the instance of devfreq device
  853. */
  854. struct devfreq *devfreq_get_devfreq_by_node(struct device_node *node)
  855. {
  856. struct devfreq *devfreq;
  857. if (!node)
  858. return ERR_PTR(-EINVAL);
  859. mutex_lock(&devfreq_list_lock);
  860. list_for_each_entry(devfreq, &devfreq_list, node) {
  861. if (devfreq->dev.parent
  862. && devfreq->dev.parent->of_node == node) {
  863. mutex_unlock(&devfreq_list_lock);
  864. return devfreq;
  865. }
  866. }
  867. mutex_unlock(&devfreq_list_lock);
  868. return ERR_PTR(-ENODEV);
  869. }
  870. /*
  871. * devfreq_get_devfreq_by_phandle - Get the devfreq device from devicetree
  872. * @dev - instance to the given device
  873. * @phandle_name - name of property holding a phandle value
  874. * @index - index into list of devfreq
  875. *
  876. * return the instance of devfreq device
  877. */
  878. struct devfreq *devfreq_get_devfreq_by_phandle(struct device *dev,
  879. const char *phandle_name, int index)
  880. {
  881. struct device_node *node;
  882. struct devfreq *devfreq;
  883. if (!dev || !phandle_name)
  884. return ERR_PTR(-EINVAL);
  885. if (!dev->of_node)
  886. return ERR_PTR(-EINVAL);
  887. node = of_parse_phandle(dev->of_node, phandle_name, index);
  888. if (!node)
  889. return ERR_PTR(-ENODEV);
  890. devfreq = devfreq_get_devfreq_by_node(node);
  891. of_node_put(node);
  892. return devfreq;
  893. }
  894. #else
  895. struct devfreq *devfreq_get_devfreq_by_node(struct device_node *node)
  896. {
  897. return ERR_PTR(-ENODEV);
  898. }
  899. struct devfreq *devfreq_get_devfreq_by_phandle(struct device *dev,
  900. const char *phandle_name, int index)
  901. {
  902. return ERR_PTR(-ENODEV);
  903. }
  904. #endif /* CONFIG_OF */
  905. EXPORT_SYMBOL_GPL(devfreq_get_devfreq_by_node);
  906. EXPORT_SYMBOL_GPL(devfreq_get_devfreq_by_phandle);
  907. /**
  908. * devm_devfreq_remove_device() - Resource-managed devfreq_remove_device()
  909. * @dev: the device from which to remove devfreq feature.
  910. * @devfreq: the devfreq instance to be removed
  911. */
  912. void devm_devfreq_remove_device(struct device *dev, struct devfreq *devfreq)
  913. {
  914. WARN_ON(devres_release(dev, devm_devfreq_dev_release,
  915. devm_devfreq_dev_match, devfreq));
  916. }
  917. EXPORT_SYMBOL(devm_devfreq_remove_device);
  918. /**
  919. * devfreq_suspend_device() - Suspend devfreq of a device.
  920. * @devfreq: the devfreq instance to be suspended
  921. *
  922. * This function is intended to be called by the pm callbacks
  923. * (e.g., runtime_suspend, suspend) of the device driver that
  924. * holds the devfreq.
  925. */
  926. int devfreq_suspend_device(struct devfreq *devfreq)
  927. {
  928. int ret;
  929. if (!devfreq)
  930. return -EINVAL;
  931. if (atomic_inc_return(&devfreq->suspend_count) > 1)
  932. return 0;
  933. if (devfreq->governor) {
  934. ret = devfreq->governor->event_handler(devfreq,
  935. DEVFREQ_GOV_SUSPEND, NULL);
  936. if (ret)
  937. return ret;
  938. }
  939. if (devfreq->suspend_freq) {
  940. mutex_lock(&devfreq->lock);
  941. ret = devfreq_set_target(devfreq, devfreq->suspend_freq, 0);
  942. mutex_unlock(&devfreq->lock);
  943. if (ret)
  944. return ret;
  945. }
  946. return 0;
  947. }
  948. EXPORT_SYMBOL(devfreq_suspend_device);
  949. /**
  950. * devfreq_resume_device() - Resume devfreq of a device.
  951. * @devfreq: the devfreq instance to be resumed
  952. *
  953. * This function is intended to be called by the pm callbacks
  954. * (e.g., runtime_resume, resume) of the device driver that
  955. * holds the devfreq.
  956. */
  957. int devfreq_resume_device(struct devfreq *devfreq)
  958. {
  959. int ret;
  960. if (!devfreq)
  961. return -EINVAL;
  962. if (atomic_dec_return(&devfreq->suspend_count) >= 1)
  963. return 0;
  964. if (devfreq->resume_freq) {
  965. mutex_lock(&devfreq->lock);
  966. ret = devfreq_set_target(devfreq, devfreq->resume_freq, 0);
  967. mutex_unlock(&devfreq->lock);
  968. if (ret)
  969. return ret;
  970. }
  971. if (devfreq->governor) {
  972. ret = devfreq->governor->event_handler(devfreq,
  973. DEVFREQ_GOV_RESUME, NULL);
  974. if (ret)
  975. return ret;
  976. }
  977. return 0;
  978. }
  979. EXPORT_SYMBOL(devfreq_resume_device);
  980. /**
  981. * devfreq_suspend() - Suspend devfreq governors and devices
  982. *
  983. * Called during system wide Suspend/Hibernate cycles for suspending governors
  984. * and devices preserving the state for resume. On some platforms the devfreq
  985. * device must have precise state (frequency) after resume in order to provide
  986. * fully operating setup.
  987. */
  988. void devfreq_suspend(void)
  989. {
  990. struct devfreq *devfreq;
  991. int ret;
  992. mutex_lock(&devfreq_list_lock);
  993. list_for_each_entry(devfreq, &devfreq_list, node) {
  994. ret = devfreq_suspend_device(devfreq);
  995. if (ret)
  996. dev_err(&devfreq->dev,
  997. "failed to suspend devfreq device\n");
  998. }
  999. mutex_unlock(&devfreq_list_lock);
  1000. }
  1001. /**
  1002. * devfreq_resume() - Resume devfreq governors and devices
  1003. *
  1004. * Called during system wide Suspend/Hibernate cycle for resuming governors and
  1005. * devices that are suspended with devfreq_suspend().
  1006. */
  1007. void devfreq_resume(void)
  1008. {
  1009. struct devfreq *devfreq;
  1010. int ret;
  1011. mutex_lock(&devfreq_list_lock);
  1012. list_for_each_entry(devfreq, &devfreq_list, node) {
  1013. ret = devfreq_resume_device(devfreq);
  1014. if (ret)
  1015. dev_warn(&devfreq->dev,
  1016. "failed to resume devfreq device\n");
  1017. }
  1018. mutex_unlock(&devfreq_list_lock);
  1019. }
  1020. /**
  1021. * devfreq_add_governor() - Add devfreq governor
  1022. * @governor: the devfreq governor to be added
  1023. */
  1024. int devfreq_add_governor(struct devfreq_governor *governor)
  1025. {
  1026. struct devfreq_governor *g;
  1027. struct devfreq *devfreq;
  1028. int err = 0;
  1029. if (!governor) {
  1030. pr_err("%s: Invalid parameters.\n", __func__);
  1031. return -EINVAL;
  1032. }
  1033. mutex_lock(&devfreq_list_lock);
  1034. g = find_devfreq_governor(governor->name);
  1035. if (!IS_ERR(g)) {
  1036. pr_err("%s: governor %s already registered\n", __func__,
  1037. g->name);
  1038. err = -EINVAL;
  1039. goto err_out;
  1040. }
  1041. list_add(&governor->node, &devfreq_governor_list);
  1042. list_for_each_entry(devfreq, &devfreq_list, node) {
  1043. int ret = 0;
  1044. struct device *dev = devfreq->dev.parent;
  1045. if (!strncmp(devfreq->governor_name, governor->name,
  1046. DEVFREQ_NAME_LEN)) {
  1047. /* The following should never occur */
  1048. if (devfreq->governor) {
  1049. dev_warn(dev,
  1050. "%s: Governor %s already present\n",
  1051. __func__, devfreq->governor->name);
  1052. ret = devfreq->governor->event_handler(devfreq,
  1053. DEVFREQ_GOV_STOP, NULL);
  1054. if (ret) {
  1055. dev_warn(dev,
  1056. "%s: Governor %s stop = %d\n",
  1057. __func__,
  1058. devfreq->governor->name, ret);
  1059. }
  1060. /* Fall through */
  1061. }
  1062. devfreq->governor = governor;
  1063. ret = devfreq->governor->event_handler(devfreq,
  1064. DEVFREQ_GOV_START, NULL);
  1065. if (ret) {
  1066. dev_warn(dev, "%s: Governor %s start=%d\n",
  1067. __func__, devfreq->governor->name,
  1068. ret);
  1069. }
  1070. }
  1071. }
  1072. err_out:
  1073. mutex_unlock(&devfreq_list_lock);
  1074. return err;
  1075. }
  1076. EXPORT_SYMBOL(devfreq_add_governor);
  1077. /**
  1078. * devfreq_remove_governor() - Remove devfreq feature from a device.
  1079. * @governor: the devfreq governor to be removed
  1080. */
  1081. int devfreq_remove_governor(struct devfreq_governor *governor)
  1082. {
  1083. struct devfreq_governor *g;
  1084. struct devfreq *devfreq;
  1085. int err = 0;
  1086. if (!governor) {
  1087. pr_err("%s: Invalid parameters.\n", __func__);
  1088. return -EINVAL;
  1089. }
  1090. mutex_lock(&devfreq_list_lock);
  1091. g = find_devfreq_governor(governor->name);
  1092. if (IS_ERR(g)) {
  1093. pr_err("%s: governor %s not registered\n", __func__,
  1094. governor->name);
  1095. err = PTR_ERR(g);
  1096. goto err_out;
  1097. }
  1098. list_for_each_entry(devfreq, &devfreq_list, node) {
  1099. int ret;
  1100. struct device *dev = devfreq->dev.parent;
  1101. if (!strncmp(devfreq->governor_name, governor->name,
  1102. DEVFREQ_NAME_LEN)) {
  1103. /* we should have a devfreq governor! */
  1104. if (!devfreq->governor) {
  1105. dev_warn(dev, "%s: Governor %s NOT present\n",
  1106. __func__, governor->name);
  1107. continue;
  1108. /* Fall through */
  1109. }
  1110. ret = devfreq->governor->event_handler(devfreq,
  1111. DEVFREQ_GOV_STOP, NULL);
  1112. if (ret) {
  1113. dev_warn(dev, "%s: Governor %s stop=%d\n",
  1114. __func__, devfreq->governor->name,
  1115. ret);
  1116. }
  1117. devfreq->governor = NULL;
  1118. }
  1119. }
  1120. list_del(&governor->node);
  1121. err_out:
  1122. mutex_unlock(&devfreq_list_lock);
  1123. return err;
  1124. }
  1125. EXPORT_SYMBOL(devfreq_remove_governor);
  1126. static ssize_t name_show(struct device *dev,
  1127. struct device_attribute *attr, char *buf)
  1128. {
  1129. struct devfreq *df = to_devfreq(dev);
  1130. return sprintf(buf, "%s\n", dev_name(df->dev.parent));
  1131. }
  1132. static DEVICE_ATTR_RO(name);
  1133. static ssize_t governor_show(struct device *dev,
  1134. struct device_attribute *attr, char *buf)
  1135. {
  1136. struct devfreq *df = to_devfreq(dev);
  1137. if (!df->governor)
  1138. return -EINVAL;
  1139. return sprintf(buf, "%s\n", df->governor->name);
  1140. }
  1141. static ssize_t governor_store(struct device *dev, struct device_attribute *attr,
  1142. const char *buf, size_t count)
  1143. {
  1144. struct devfreq *df = to_devfreq(dev);
  1145. int ret;
  1146. char str_governor[DEVFREQ_NAME_LEN + 1];
  1147. const struct devfreq_governor *governor, *prev_governor;
  1148. if (!df->governor)
  1149. return -EINVAL;
  1150. ret = sscanf(buf, "%" __stringify(DEVFREQ_NAME_LEN) "s", str_governor);
  1151. if (ret != 1)
  1152. return -EINVAL;
  1153. mutex_lock(&devfreq_list_lock);
  1154. governor = try_then_request_governor(str_governor);
  1155. if (IS_ERR(governor)) {
  1156. ret = PTR_ERR(governor);
  1157. goto out;
  1158. }
  1159. if (df->governor == governor) {
  1160. ret = 0;
  1161. goto out;
  1162. } else if (df->governor->immutable || governor->immutable) {
  1163. ret = -EINVAL;
  1164. goto out;
  1165. }
  1166. ret = df->governor->event_handler(df, DEVFREQ_GOV_STOP, NULL);
  1167. if (ret) {
  1168. dev_warn(dev, "%s: Governor %s not stopped(%d)\n",
  1169. __func__, df->governor->name, ret);
  1170. goto out;
  1171. }
  1172. prev_governor = df->governor;
  1173. df->governor = governor;
  1174. strncpy(df->governor_name, governor->name, DEVFREQ_NAME_LEN);
  1175. ret = df->governor->event_handler(df, DEVFREQ_GOV_START, NULL);
  1176. if (ret) {
  1177. dev_warn(dev, "%s: Governor %s not started(%d)\n",
  1178. __func__, df->governor->name, ret);
  1179. df->governor = prev_governor;
  1180. strncpy(df->governor_name, prev_governor->name,
  1181. DEVFREQ_NAME_LEN);
  1182. ret = df->governor->event_handler(df, DEVFREQ_GOV_START, NULL);
  1183. if (ret) {
  1184. dev_err(dev,
  1185. "%s: reverting to Governor %s failed (%d)\n",
  1186. __func__, df->governor_name, ret);
  1187. df->governor = NULL;
  1188. }
  1189. }
  1190. out:
  1191. mutex_unlock(&devfreq_list_lock);
  1192. if (!ret)
  1193. ret = count;
  1194. return ret;
  1195. }
  1196. static DEVICE_ATTR_RW(governor);
  1197. static ssize_t available_governors_show(struct device *d,
  1198. struct device_attribute *attr,
  1199. char *buf)
  1200. {
  1201. struct devfreq *df = to_devfreq(d);
  1202. ssize_t count = 0;
  1203. if (!df->governor)
  1204. return -EINVAL;
  1205. mutex_lock(&devfreq_list_lock);
  1206. /*
  1207. * The devfreq with immutable governor (e.g., passive) shows
  1208. * only own governor.
  1209. */
  1210. if (df->governor->immutable) {
  1211. count = scnprintf(&buf[count], DEVFREQ_NAME_LEN,
  1212. "%s ", df->governor_name);
  1213. /*
  1214. * The devfreq device shows the registered governor except for
  1215. * immutable governors such as passive governor .
  1216. */
  1217. } else {
  1218. struct devfreq_governor *governor;
  1219. list_for_each_entry(governor, &devfreq_governor_list, node) {
  1220. if (governor->immutable)
  1221. continue;
  1222. count += scnprintf(&buf[count], (PAGE_SIZE - count - 2),
  1223. "%s ", governor->name);
  1224. }
  1225. }
  1226. mutex_unlock(&devfreq_list_lock);
  1227. /* Truncate the trailing space */
  1228. if (count)
  1229. count--;
  1230. count += sprintf(&buf[count], "\n");
  1231. return count;
  1232. }
  1233. static DEVICE_ATTR_RO(available_governors);
  1234. static ssize_t cur_freq_show(struct device *dev, struct device_attribute *attr,
  1235. char *buf)
  1236. {
  1237. unsigned long freq;
  1238. struct devfreq *df = to_devfreq(dev);
  1239. if (!df->profile)
  1240. return -EINVAL;
  1241. if (df->profile->get_cur_freq &&
  1242. !df->profile->get_cur_freq(df->dev.parent, &freq))
  1243. return sprintf(buf, "%lu\n", freq);
  1244. return sprintf(buf, "%lu\n", df->previous_freq);
  1245. }
  1246. static DEVICE_ATTR_RO(cur_freq);
  1247. static ssize_t target_freq_show(struct device *dev,
  1248. struct device_attribute *attr, char *buf)
  1249. {
  1250. struct devfreq *df = to_devfreq(dev);
  1251. return sprintf(buf, "%lu\n", df->previous_freq);
  1252. }
  1253. static DEVICE_ATTR_RO(target_freq);
  1254. static ssize_t polling_interval_show(struct device *dev,
  1255. struct device_attribute *attr, char *buf)
  1256. {
  1257. struct devfreq *df = to_devfreq(dev);
  1258. if (!df->profile)
  1259. return -EINVAL;
  1260. return sprintf(buf, "%d\n", df->profile->polling_ms);
  1261. }
  1262. static ssize_t polling_interval_store(struct device *dev,
  1263. struct device_attribute *attr,
  1264. const char *buf, size_t count)
  1265. {
  1266. struct devfreq *df = to_devfreq(dev);
  1267. unsigned int value;
  1268. int ret;
  1269. if (!df->governor)
  1270. return -EINVAL;
  1271. ret = sscanf(buf, "%u", &value);
  1272. if (ret != 1)
  1273. return -EINVAL;
  1274. df->governor->event_handler(df, DEVFREQ_GOV_UPDATE_INTERVAL, &value);
  1275. ret = count;
  1276. return ret;
  1277. }
  1278. static DEVICE_ATTR_RW(polling_interval);
  1279. static ssize_t min_freq_store(struct device *dev, struct device_attribute *attr,
  1280. const char *buf, size_t count)
  1281. {
  1282. struct devfreq *df = to_devfreq(dev);
  1283. unsigned long value;
  1284. int ret;
  1285. /*
  1286. * Protect against theoretical sysfs writes between
  1287. * device_add and dev_pm_qos_add_request
  1288. */
  1289. if (!dev_pm_qos_request_active(&df->user_min_freq_req))
  1290. return -EAGAIN;
  1291. ret = sscanf(buf, "%lu", &value);
  1292. if (ret != 1)
  1293. return -EINVAL;
  1294. /* Round down to kHz for PM QoS */
  1295. ret = dev_pm_qos_update_request(&df->user_min_freq_req,
  1296. value / HZ_PER_KHZ);
  1297. if (ret < 0)
  1298. return ret;
  1299. return count;
  1300. }
  1301. static ssize_t min_freq_show(struct device *dev, struct device_attribute *attr,
  1302. char *buf)
  1303. {
  1304. struct devfreq *df = to_devfreq(dev);
  1305. unsigned long min_freq, max_freq;
  1306. mutex_lock(&df->lock);
  1307. get_freq_range(df, &min_freq, &max_freq);
  1308. mutex_unlock(&df->lock);
  1309. return sprintf(buf, "%lu\n", min_freq);
  1310. }
  1311. static DEVICE_ATTR_RW(min_freq);
  1312. static ssize_t max_freq_store(struct device *dev, struct device_attribute *attr,
  1313. const char *buf, size_t count)
  1314. {
  1315. struct devfreq *df = to_devfreq(dev);
  1316. unsigned long value;
  1317. int ret;
  1318. /*
  1319. * Protect against theoretical sysfs writes between
  1320. * device_add and dev_pm_qos_add_request
  1321. */
  1322. if (!dev_pm_qos_request_active(&df->user_max_freq_req))
  1323. return -EINVAL;
  1324. ret = sscanf(buf, "%lu", &value);
  1325. if (ret != 1)
  1326. return -EINVAL;
  1327. /*
  1328. * PM QoS frequencies are in kHz so we need to convert. Convert by
  1329. * rounding upwards so that the acceptable interval never shrinks.
  1330. *
  1331. * For example if the user writes "666666666" to sysfs this value will
  1332. * be converted to 666667 kHz and back to 666667000 Hz before an OPP
  1333. * lookup, this ensures that an OPP of 666666666Hz is still accepted.
  1334. *
  1335. * A value of zero means "no limit".
  1336. */
  1337. if (value)
  1338. value = DIV_ROUND_UP(value, HZ_PER_KHZ);
  1339. else
  1340. value = PM_QOS_MAX_FREQUENCY_DEFAULT_VALUE;
  1341. ret = dev_pm_qos_update_request(&df->user_max_freq_req, value);
  1342. if (ret < 0)
  1343. return ret;
  1344. return count;
  1345. }
  1346. static ssize_t max_freq_show(struct device *dev, struct device_attribute *attr,
  1347. char *buf)
  1348. {
  1349. struct devfreq *df = to_devfreq(dev);
  1350. unsigned long min_freq, max_freq;
  1351. mutex_lock(&df->lock);
  1352. get_freq_range(df, &min_freq, &max_freq);
  1353. mutex_unlock(&df->lock);
  1354. return sprintf(buf, "%lu\n", max_freq);
  1355. }
  1356. static DEVICE_ATTR_RW(max_freq);
  1357. static ssize_t available_frequencies_show(struct device *d,
  1358. struct device_attribute *attr,
  1359. char *buf)
  1360. {
  1361. struct devfreq *df = to_devfreq(d);
  1362. ssize_t count = 0;
  1363. int i;
  1364. if (!df->profile)
  1365. return -EINVAL;
  1366. mutex_lock(&df->lock);
  1367. for (i = 0; i < df->profile->max_state; i++)
  1368. count += scnprintf(&buf[count], (PAGE_SIZE - count - 2),
  1369. "%lu ", df->profile->freq_table[i]);
  1370. mutex_unlock(&df->lock);
  1371. /* Truncate the trailing space */
  1372. if (count)
  1373. count--;
  1374. count += sprintf(&buf[count], "\n");
  1375. return count;
  1376. }
  1377. static DEVICE_ATTR_RO(available_frequencies);
  1378. static ssize_t trans_stat_show(struct device *dev,
  1379. struct device_attribute *attr, char *buf)
  1380. {
  1381. struct devfreq *df = to_devfreq(dev);
  1382. ssize_t len;
  1383. int i, j;
  1384. unsigned int max_state;
  1385. if (!df->profile)
  1386. return -EINVAL;
  1387. max_state = df->profile->max_state;
  1388. if (max_state == 0)
  1389. return sprintf(buf, "Not Supported.\n");
  1390. mutex_lock(&df->lock);
  1391. if (!df->stop_polling &&
  1392. devfreq_update_status(df, df->previous_freq)) {
  1393. mutex_unlock(&df->lock);
  1394. return 0;
  1395. }
  1396. mutex_unlock(&df->lock);
  1397. len = sprintf(buf, " From : To\n");
  1398. len += sprintf(buf + len, " :");
  1399. for (i = 0; i < max_state; i++)
  1400. len += sprintf(buf + len, "%10lu",
  1401. df->profile->freq_table[i]);
  1402. len += sprintf(buf + len, " time(ms)\n");
  1403. for (i = 0; i < max_state; i++) {
  1404. if (df->profile->freq_table[i]
  1405. == df->previous_freq) {
  1406. len += sprintf(buf + len, "*");
  1407. } else {
  1408. len += sprintf(buf + len, " ");
  1409. }
  1410. len += sprintf(buf + len, "%10lu:",
  1411. df->profile->freq_table[i]);
  1412. for (j = 0; j < max_state; j++)
  1413. len += sprintf(buf + len, "%10u",
  1414. df->stats.trans_table[(i * max_state) + j]);
  1415. len += sprintf(buf + len, "%10llu\n", (u64)
  1416. jiffies64_to_msecs(df->stats.time_in_state[i]));
  1417. }
  1418. len += sprintf(buf + len, "Total transition : %u\n",
  1419. df->stats.total_trans);
  1420. return len;
  1421. }
  1422. static ssize_t trans_stat_store(struct device *dev,
  1423. struct device_attribute *attr,
  1424. const char *buf, size_t count)
  1425. {
  1426. struct devfreq *df = to_devfreq(dev);
  1427. int err, value;
  1428. if (!df->profile)
  1429. return -EINVAL;
  1430. if (df->profile->max_state == 0)
  1431. return count;
  1432. err = kstrtoint(buf, 10, &value);
  1433. if (err || value != 0)
  1434. return -EINVAL;
  1435. mutex_lock(&df->lock);
  1436. memset(df->stats.time_in_state, 0, (df->profile->max_state *
  1437. sizeof(*df->stats.time_in_state)));
  1438. memset(df->stats.trans_table, 0, array3_size(sizeof(unsigned int),
  1439. df->profile->max_state,
  1440. df->profile->max_state));
  1441. df->stats.total_trans = 0;
  1442. df->stats.last_update = get_jiffies_64();
  1443. mutex_unlock(&df->lock);
  1444. return count;
  1445. }
  1446. static DEVICE_ATTR_RW(trans_stat);
  1447. static ssize_t timer_show(struct device *dev,
  1448. struct device_attribute *attr, char *buf)
  1449. {
  1450. struct devfreq *df = to_devfreq(dev);
  1451. if (!df->profile)
  1452. return -EINVAL;
  1453. return sprintf(buf, "%s\n", timer_name[df->profile->timer]);
  1454. }
  1455. static ssize_t timer_store(struct device *dev, struct device_attribute *attr,
  1456. const char *buf, size_t count)
  1457. {
  1458. struct devfreq *df = to_devfreq(dev);
  1459. char str_timer[DEVFREQ_NAME_LEN + 1];
  1460. int timer = -1;
  1461. int ret = 0, i;
  1462. if (!df->governor || !df->profile)
  1463. return -EINVAL;
  1464. ret = sscanf(buf, "%16s", str_timer);
  1465. if (ret != 1)
  1466. return -EINVAL;
  1467. for (i = 0; i < DEVFREQ_TIMER_NUM; i++) {
  1468. if (!strncmp(timer_name[i], str_timer, DEVFREQ_NAME_LEN)) {
  1469. timer = i;
  1470. break;
  1471. }
  1472. }
  1473. if (timer < 0) {
  1474. ret = -EINVAL;
  1475. goto out;
  1476. }
  1477. if (df->profile->timer == timer) {
  1478. ret = 0;
  1479. goto out;
  1480. }
  1481. mutex_lock(&df->lock);
  1482. df->profile->timer = timer;
  1483. mutex_unlock(&df->lock);
  1484. ret = df->governor->event_handler(df, DEVFREQ_GOV_STOP, NULL);
  1485. if (ret) {
  1486. dev_warn(dev, "%s: Governor %s not stopped(%d)\n",
  1487. __func__, df->governor->name, ret);
  1488. goto out;
  1489. }
  1490. ret = df->governor->event_handler(df, DEVFREQ_GOV_START, NULL);
  1491. if (ret)
  1492. dev_warn(dev, "%s: Governor %s not started(%d)\n",
  1493. __func__, df->governor->name, ret);
  1494. out:
  1495. return ret ? ret : count;
  1496. }
  1497. static DEVICE_ATTR_RW(timer);
  1498. static struct attribute *devfreq_attrs[] = {
  1499. &dev_attr_name.attr,
  1500. &dev_attr_governor.attr,
  1501. &dev_attr_available_governors.attr,
  1502. &dev_attr_cur_freq.attr,
  1503. &dev_attr_available_frequencies.attr,
  1504. &dev_attr_target_freq.attr,
  1505. &dev_attr_polling_interval.attr,
  1506. &dev_attr_min_freq.attr,
  1507. &dev_attr_max_freq.attr,
  1508. &dev_attr_trans_stat.attr,
  1509. &dev_attr_timer.attr,
  1510. NULL,
  1511. };
  1512. ATTRIBUTE_GROUPS(devfreq);
  1513. /**
  1514. * devfreq_summary_show() - Show the summary of the devfreq devices
  1515. * @s: seq_file instance to show the summary of devfreq devices
  1516. * @data: not used
  1517. *
  1518. * Show the summary of the devfreq devices via 'devfreq_summary' debugfs file.
  1519. * It helps that user can know the detailed information of the devfreq devices.
  1520. *
  1521. * Return 0 always because it shows the information without any data change.
  1522. */
  1523. static int devfreq_summary_show(struct seq_file *s, void *data)
  1524. {
  1525. struct devfreq *devfreq;
  1526. struct devfreq *p_devfreq = NULL;
  1527. unsigned long cur_freq, min_freq, max_freq;
  1528. unsigned int polling_ms;
  1529. unsigned int timer;
  1530. seq_printf(s, "%-30s %-30s %-15s %-10s %10s %12s %12s %12s\n",
  1531. "dev",
  1532. "parent_dev",
  1533. "governor",
  1534. "timer",
  1535. "polling_ms",
  1536. "cur_freq_Hz",
  1537. "min_freq_Hz",
  1538. "max_freq_Hz");
  1539. seq_printf(s, "%30s %30s %15s %10s %10s %12s %12s %12s\n",
  1540. "------------------------------",
  1541. "------------------------------",
  1542. "---------------",
  1543. "----------",
  1544. "----------",
  1545. "------------",
  1546. "------------",
  1547. "------------");
  1548. mutex_lock(&devfreq_list_lock);
  1549. list_for_each_entry_reverse(devfreq, &devfreq_list, node) {
  1550. #if IS_ENABLED(CONFIG_DEVFREQ_GOV_PASSIVE)
  1551. if (!strncmp(devfreq->governor_name, DEVFREQ_GOV_PASSIVE,
  1552. DEVFREQ_NAME_LEN)) {
  1553. struct devfreq_passive_data *data = devfreq->data;
  1554. if (data)
  1555. p_devfreq = data->parent;
  1556. } else {
  1557. p_devfreq = NULL;
  1558. }
  1559. #endif
  1560. mutex_lock(&devfreq->lock);
  1561. cur_freq = devfreq->previous_freq;
  1562. get_freq_range(devfreq, &min_freq, &max_freq);
  1563. polling_ms = devfreq->profile->polling_ms;
  1564. timer = devfreq->profile->timer;
  1565. mutex_unlock(&devfreq->lock);
  1566. seq_printf(s,
  1567. "%-30s %-30s %-15s %-10s %10d %12ld %12ld %12ld\n",
  1568. dev_name(&devfreq->dev),
  1569. p_devfreq ? dev_name(&p_devfreq->dev) : "null",
  1570. devfreq->governor_name,
  1571. polling_ms ? timer_name[timer] : "null",
  1572. polling_ms,
  1573. cur_freq,
  1574. min_freq,
  1575. max_freq);
  1576. }
  1577. mutex_unlock(&devfreq_list_lock);
  1578. return 0;
  1579. }
  1580. DEFINE_SHOW_ATTRIBUTE(devfreq_summary);
  1581. static int __init devfreq_init(void)
  1582. {
  1583. devfreq_class = class_create(THIS_MODULE, "devfreq");
  1584. if (IS_ERR(devfreq_class)) {
  1585. pr_err("%s: couldn't create class\n", __FILE__);
  1586. return PTR_ERR(devfreq_class);
  1587. }
  1588. devfreq_wq = create_freezable_workqueue("devfreq_wq");
  1589. if (!devfreq_wq) {
  1590. class_destroy(devfreq_class);
  1591. pr_err("%s: couldn't create workqueue\n", __FILE__);
  1592. return -ENOMEM;
  1593. }
  1594. devfreq_class->dev_groups = devfreq_groups;
  1595. devfreq_debugfs = debugfs_create_dir("devfreq", NULL);
  1596. debugfs_create_file("devfreq_summary", 0444,
  1597. devfreq_debugfs, NULL,
  1598. &devfreq_summary_fops);
  1599. return 0;
  1600. }
  1601. subsys_initcall(devfreq_init);
  1602. /*
  1603. * The following are helper functions for devfreq user device drivers with
  1604. * OPP framework.
  1605. */
  1606. /**
  1607. * devfreq_recommended_opp() - Helper function to get proper OPP for the
  1608. * freq value given to target callback.
  1609. * @dev: The devfreq user device. (parent of devfreq)
  1610. * @freq: The frequency given to target function
  1611. * @flags: Flags handed from devfreq framework.
  1612. *
  1613. * The callers are required to call dev_pm_opp_put() for the returned OPP after
  1614. * use.
  1615. */
  1616. struct dev_pm_opp *devfreq_recommended_opp(struct device *dev,
  1617. unsigned long *freq,
  1618. u32 flags)
  1619. {
  1620. struct dev_pm_opp *opp;
  1621. if (flags & DEVFREQ_FLAG_LEAST_UPPER_BOUND) {
  1622. /* The freq is an upper bound. opp should be lower */
  1623. opp = dev_pm_opp_find_freq_floor(dev, freq);
  1624. /* If not available, use the closest opp */
  1625. if (opp == ERR_PTR(-ERANGE))
  1626. opp = dev_pm_opp_find_freq_ceil(dev, freq);
  1627. } else {
  1628. /* The freq is an lower bound. opp should be higher */
  1629. opp = dev_pm_opp_find_freq_ceil(dev, freq);
  1630. /* If not available, use the closest opp */
  1631. if (opp == ERR_PTR(-ERANGE))
  1632. opp = dev_pm_opp_find_freq_floor(dev, freq);
  1633. }
  1634. return opp;
  1635. }
  1636. EXPORT_SYMBOL(devfreq_recommended_opp);
  1637. /**
  1638. * devfreq_register_opp_notifier() - Helper function to get devfreq notified
  1639. * for any changes in the OPP availability
  1640. * changes
  1641. * @dev: The devfreq user device. (parent of devfreq)
  1642. * @devfreq: The devfreq object.
  1643. */
  1644. int devfreq_register_opp_notifier(struct device *dev, struct devfreq *devfreq)
  1645. {
  1646. return dev_pm_opp_register_notifier(dev, &devfreq->nb);
  1647. }
  1648. EXPORT_SYMBOL(devfreq_register_opp_notifier);
  1649. /**
  1650. * devfreq_unregister_opp_notifier() - Helper function to stop getting devfreq
  1651. * notified for any changes in the OPP
  1652. * availability changes anymore.
  1653. * @dev: The devfreq user device. (parent of devfreq)
  1654. * @devfreq: The devfreq object.
  1655. *
  1656. * At exit() callback of devfreq_dev_profile, this must be included if
  1657. * devfreq_recommended_opp is used.
  1658. */
  1659. int devfreq_unregister_opp_notifier(struct device *dev, struct devfreq *devfreq)
  1660. {
  1661. return dev_pm_opp_unregister_notifier(dev, &devfreq->nb);
  1662. }
  1663. EXPORT_SYMBOL(devfreq_unregister_opp_notifier);
  1664. static void devm_devfreq_opp_release(struct device *dev, void *res)
  1665. {
  1666. devfreq_unregister_opp_notifier(dev, *(struct devfreq **)res);
  1667. }
  1668. /**
  1669. * devm_devfreq_register_opp_notifier() - Resource-managed
  1670. * devfreq_register_opp_notifier()
  1671. * @dev: The devfreq user device. (parent of devfreq)
  1672. * @devfreq: The devfreq object.
  1673. */
  1674. int devm_devfreq_register_opp_notifier(struct device *dev,
  1675. struct devfreq *devfreq)
  1676. {
  1677. struct devfreq **ptr;
  1678. int ret;
  1679. ptr = devres_alloc(devm_devfreq_opp_release, sizeof(*ptr), GFP_KERNEL);
  1680. if (!ptr)
  1681. return -ENOMEM;
  1682. ret = devfreq_register_opp_notifier(dev, devfreq);
  1683. if (ret) {
  1684. devres_free(ptr);
  1685. return ret;
  1686. }
  1687. *ptr = devfreq;
  1688. devres_add(dev, ptr);
  1689. return 0;
  1690. }
  1691. EXPORT_SYMBOL(devm_devfreq_register_opp_notifier);
  1692. /**
  1693. * devm_devfreq_unregister_opp_notifier() - Resource-managed
  1694. * devfreq_unregister_opp_notifier()
  1695. * @dev: The devfreq user device. (parent of devfreq)
  1696. * @devfreq: The devfreq object.
  1697. */
  1698. void devm_devfreq_unregister_opp_notifier(struct device *dev,
  1699. struct devfreq *devfreq)
  1700. {
  1701. WARN_ON(devres_release(dev, devm_devfreq_opp_release,
  1702. devm_devfreq_dev_match, devfreq));
  1703. }
  1704. EXPORT_SYMBOL(devm_devfreq_unregister_opp_notifier);
  1705. /**
  1706. * devfreq_register_notifier() - Register a driver with devfreq
  1707. * @devfreq: The devfreq object.
  1708. * @nb: The notifier block to register.
  1709. * @list: DEVFREQ_TRANSITION_NOTIFIER.
  1710. */
  1711. int devfreq_register_notifier(struct devfreq *devfreq,
  1712. struct notifier_block *nb,
  1713. unsigned int list)
  1714. {
  1715. int ret = 0;
  1716. if (!devfreq)
  1717. return -EINVAL;
  1718. switch (list) {
  1719. case DEVFREQ_TRANSITION_NOTIFIER:
  1720. ret = srcu_notifier_chain_register(
  1721. &devfreq->transition_notifier_list, nb);
  1722. break;
  1723. default:
  1724. ret = -EINVAL;
  1725. }
  1726. return ret;
  1727. }
  1728. EXPORT_SYMBOL(devfreq_register_notifier);
  1729. /*
  1730. * devfreq_unregister_notifier() - Unregister a driver with devfreq
  1731. * @devfreq: The devfreq object.
  1732. * @nb: The notifier block to be unregistered.
  1733. * @list: DEVFREQ_TRANSITION_NOTIFIER.
  1734. */
  1735. int devfreq_unregister_notifier(struct devfreq *devfreq,
  1736. struct notifier_block *nb,
  1737. unsigned int list)
  1738. {
  1739. int ret = 0;
  1740. if (!devfreq)
  1741. return -EINVAL;
  1742. switch (list) {
  1743. case DEVFREQ_TRANSITION_NOTIFIER:
  1744. ret = srcu_notifier_chain_unregister(
  1745. &devfreq->transition_notifier_list, nb);
  1746. break;
  1747. default:
  1748. ret = -EINVAL;
  1749. }
  1750. return ret;
  1751. }
  1752. EXPORT_SYMBOL(devfreq_unregister_notifier);
  1753. struct devfreq_notifier_devres {
  1754. struct devfreq *devfreq;
  1755. struct notifier_block *nb;
  1756. unsigned int list;
  1757. };
  1758. static void devm_devfreq_notifier_release(struct device *dev, void *res)
  1759. {
  1760. struct devfreq_notifier_devres *this = res;
  1761. devfreq_unregister_notifier(this->devfreq, this->nb, this->list);
  1762. }
  1763. /**
  1764. * devm_devfreq_register_notifier()
  1765. * - Resource-managed devfreq_register_notifier()
  1766. * @dev: The devfreq user device. (parent of devfreq)
  1767. * @devfreq: The devfreq object.
  1768. * @nb: The notifier block to be unregistered.
  1769. * @list: DEVFREQ_TRANSITION_NOTIFIER.
  1770. */
  1771. int devm_devfreq_register_notifier(struct device *dev,
  1772. struct devfreq *devfreq,
  1773. struct notifier_block *nb,
  1774. unsigned int list)
  1775. {
  1776. struct devfreq_notifier_devres *ptr;
  1777. int ret;
  1778. ptr = devres_alloc(devm_devfreq_notifier_release, sizeof(*ptr),
  1779. GFP_KERNEL);
  1780. if (!ptr)
  1781. return -ENOMEM;
  1782. ret = devfreq_register_notifier(devfreq, nb, list);
  1783. if (ret) {
  1784. devres_free(ptr);
  1785. return ret;
  1786. }
  1787. ptr->devfreq = devfreq;
  1788. ptr->nb = nb;
  1789. ptr->list = list;
  1790. devres_add(dev, ptr);
  1791. return 0;
  1792. }
  1793. EXPORT_SYMBOL(devm_devfreq_register_notifier);
  1794. /**
  1795. * devm_devfreq_unregister_notifier()
  1796. * - Resource-managed devfreq_unregister_notifier()
  1797. * @dev: The devfreq user device. (parent of devfreq)
  1798. * @devfreq: The devfreq object.
  1799. * @nb: The notifier block to be unregistered.
  1800. * @list: DEVFREQ_TRANSITION_NOTIFIER.
  1801. */
  1802. void devm_devfreq_unregister_notifier(struct device *dev,
  1803. struct devfreq *devfreq,
  1804. struct notifier_block *nb,
  1805. unsigned int list)
  1806. {
  1807. WARN_ON(devres_release(dev, devm_devfreq_notifier_release,
  1808. devm_devfreq_dev_match, devfreq));
  1809. }
  1810. EXPORT_SYMBOL(devm_devfreq_unregister_notifier);