gpio: rcar: Fix runtime PM imbalance on error
[linux/fpc-iii.git] / drivers / cpufreq / cpufreq.c
blob045f9fe157ce2cc638accc0a1a9eedc795ebf02a
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * linux/drivers/cpufreq/cpufreq.c
5 * Copyright (C) 2001 Russell King
6 * (C) 2002 - 2003 Dominik Brodowski <linux@brodo.de>
7 * (C) 2013 Viresh Kumar <viresh.kumar@linaro.org>
9 * Oct 2005 - Ashok Raj <ashok.raj@intel.com>
10 * Added handling for CPU hotplug
11 * Feb 2006 - Jacob Shin <jacob.shin@amd.com>
12 * Fix handling for CPU hotplug -- affected CPUs
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
17 #include <linux/cpu.h>
18 #include <linux/cpufreq.h>
19 #include <linux/cpu_cooling.h>
20 #include <linux/delay.h>
21 #include <linux/device.h>
22 #include <linux/init.h>
23 #include <linux/kernel_stat.h>
24 #include <linux/module.h>
25 #include <linux/mutex.h>
26 #include <linux/pm_qos.h>
27 #include <linux/slab.h>
28 #include <linux/suspend.h>
29 #include <linux/syscore_ops.h>
30 #include <linux/tick.h>
31 #include <trace/events/power.h>
33 static LIST_HEAD(cpufreq_policy_list);
35 /* Macros to iterate over CPU policies */
36 #define for_each_suitable_policy(__policy, __active) \
37 list_for_each_entry(__policy, &cpufreq_policy_list, policy_list) \
38 if ((__active) == !policy_is_inactive(__policy))
40 #define for_each_active_policy(__policy) \
41 for_each_suitable_policy(__policy, true)
42 #define for_each_inactive_policy(__policy) \
43 for_each_suitable_policy(__policy, false)
45 #define for_each_policy(__policy) \
46 list_for_each_entry(__policy, &cpufreq_policy_list, policy_list)
48 /* Iterate over governors */
49 static LIST_HEAD(cpufreq_governor_list);
50 #define for_each_governor(__governor) \
51 list_for_each_entry(__governor, &cpufreq_governor_list, governor_list)
53 /**
54 * The "cpufreq driver" - the arch- or hardware-dependent low
55 * level driver of CPUFreq support, and its spinlock. This lock
56 * also protects the cpufreq_cpu_data array.
58 static struct cpufreq_driver *cpufreq_driver;
59 static DEFINE_PER_CPU(struct cpufreq_policy *, cpufreq_cpu_data);
60 static DEFINE_RWLOCK(cpufreq_driver_lock);
62 /* Flag to suspend/resume CPUFreq governors */
63 static bool cpufreq_suspended;
65 static inline bool has_target(void)
67 return cpufreq_driver->target_index || cpufreq_driver->target;
70 /* internal prototypes */
71 static unsigned int __cpufreq_get(struct cpufreq_policy *policy);
72 static int cpufreq_init_governor(struct cpufreq_policy *policy);
73 static void cpufreq_exit_governor(struct cpufreq_policy *policy);
74 static int cpufreq_start_governor(struct cpufreq_policy *policy);
75 static void cpufreq_stop_governor(struct cpufreq_policy *policy);
76 static void cpufreq_governor_limits(struct cpufreq_policy *policy);
77 static int cpufreq_set_policy(struct cpufreq_policy *policy,
78 struct cpufreq_governor *new_gov,
79 unsigned int new_pol);
81 /**
82 * Two notifier lists: the "policy" list is involved in the
83 * validation process for a new CPU frequency policy; the
84 * "transition" list for kernel code that needs to handle
85 * changes to devices when the CPU clock speed changes.
86 * The mutex locks both lists.
88 static BLOCKING_NOTIFIER_HEAD(cpufreq_policy_notifier_list);
89 SRCU_NOTIFIER_HEAD_STATIC(cpufreq_transition_notifier_list);
91 static int off __read_mostly;
92 static int cpufreq_disabled(void)
94 return off;
96 void disable_cpufreq(void)
98 off = 1;
100 static DEFINE_MUTEX(cpufreq_governor_mutex);
102 bool have_governor_per_policy(void)
104 return !!(cpufreq_driver->flags & CPUFREQ_HAVE_GOVERNOR_PER_POLICY);
106 EXPORT_SYMBOL_GPL(have_governor_per_policy);
108 static struct kobject *cpufreq_global_kobject;
110 struct kobject *get_governor_parent_kobj(struct cpufreq_policy *policy)
112 if (have_governor_per_policy())
113 return &policy->kobj;
114 else
115 return cpufreq_global_kobject;
117 EXPORT_SYMBOL_GPL(get_governor_parent_kobj);
119 static inline u64 get_cpu_idle_time_jiffy(unsigned int cpu, u64 *wall)
121 struct kernel_cpustat kcpustat;
122 u64 cur_wall_time;
123 u64 idle_time;
124 u64 busy_time;
126 cur_wall_time = jiffies64_to_nsecs(get_jiffies_64());
128 kcpustat_cpu_fetch(&kcpustat, cpu);
130 busy_time = kcpustat.cpustat[CPUTIME_USER];
131 busy_time += kcpustat.cpustat[CPUTIME_SYSTEM];
132 busy_time += kcpustat.cpustat[CPUTIME_IRQ];
133 busy_time += kcpustat.cpustat[CPUTIME_SOFTIRQ];
134 busy_time += kcpustat.cpustat[CPUTIME_STEAL];
135 busy_time += kcpustat.cpustat[CPUTIME_NICE];
137 idle_time = cur_wall_time - busy_time;
138 if (wall)
139 *wall = div_u64(cur_wall_time, NSEC_PER_USEC);
141 return div_u64(idle_time, NSEC_PER_USEC);
144 u64 get_cpu_idle_time(unsigned int cpu, u64 *wall, int io_busy)
146 u64 idle_time = get_cpu_idle_time_us(cpu, io_busy ? wall : NULL);
148 if (idle_time == -1ULL)
149 return get_cpu_idle_time_jiffy(cpu, wall);
150 else if (!io_busy)
151 idle_time += get_cpu_iowait_time_us(cpu, wall);
153 return idle_time;
155 EXPORT_SYMBOL_GPL(get_cpu_idle_time);
157 __weak void arch_set_freq_scale(struct cpumask *cpus, unsigned long cur_freq,
158 unsigned long max_freq)
161 EXPORT_SYMBOL_GPL(arch_set_freq_scale);
164 * This is a generic cpufreq init() routine which can be used by cpufreq
165 * drivers of SMP systems. It will do following:
166 * - validate & show freq table passed
167 * - set policies transition latency
168 * - policy->cpus with all possible CPUs
170 void cpufreq_generic_init(struct cpufreq_policy *policy,
171 struct cpufreq_frequency_table *table,
172 unsigned int transition_latency)
174 policy->freq_table = table;
175 policy->cpuinfo.transition_latency = transition_latency;
178 * The driver only supports the SMP configuration where all processors
179 * share the clock and voltage and clock.
181 cpumask_setall(policy->cpus);
183 EXPORT_SYMBOL_GPL(cpufreq_generic_init);
185 struct cpufreq_policy *cpufreq_cpu_get_raw(unsigned int cpu)
187 struct cpufreq_policy *policy = per_cpu(cpufreq_cpu_data, cpu);
189 return policy && cpumask_test_cpu(cpu, policy->cpus) ? policy : NULL;
191 EXPORT_SYMBOL_GPL(cpufreq_cpu_get_raw);
193 unsigned int cpufreq_generic_get(unsigned int cpu)
195 struct cpufreq_policy *policy = cpufreq_cpu_get_raw(cpu);
197 if (!policy || IS_ERR(policy->clk)) {
198 pr_err("%s: No %s associated to cpu: %d\n",
199 __func__, policy ? "clk" : "policy", cpu);
200 return 0;
203 return clk_get_rate(policy->clk) / 1000;
205 EXPORT_SYMBOL_GPL(cpufreq_generic_get);
208 * cpufreq_cpu_get - Return policy for a CPU and mark it as busy.
209 * @cpu: CPU to find the policy for.
211 * Call cpufreq_cpu_get_raw() to obtain a cpufreq policy for @cpu and increment
212 * the kobject reference counter of that policy. Return a valid policy on
213 * success or NULL on failure.
215 * The policy returned by this function has to be released with the help of
216 * cpufreq_cpu_put() to balance its kobject reference counter properly.
218 struct cpufreq_policy *cpufreq_cpu_get(unsigned int cpu)
220 struct cpufreq_policy *policy = NULL;
221 unsigned long flags;
223 if (WARN_ON(cpu >= nr_cpu_ids))
224 return NULL;
226 /* get the cpufreq driver */
227 read_lock_irqsave(&cpufreq_driver_lock, flags);
229 if (cpufreq_driver) {
230 /* get the CPU */
231 policy = cpufreq_cpu_get_raw(cpu);
232 if (policy)
233 kobject_get(&policy->kobj);
236 read_unlock_irqrestore(&cpufreq_driver_lock, flags);
238 return policy;
240 EXPORT_SYMBOL_GPL(cpufreq_cpu_get);
243 * cpufreq_cpu_put - Decrement kobject usage counter for cpufreq policy.
244 * @policy: cpufreq policy returned by cpufreq_cpu_get().
246 void cpufreq_cpu_put(struct cpufreq_policy *policy)
248 kobject_put(&policy->kobj);
250 EXPORT_SYMBOL_GPL(cpufreq_cpu_put);
253 * cpufreq_cpu_release - Unlock a policy and decrement its usage counter.
254 * @policy: cpufreq policy returned by cpufreq_cpu_acquire().
256 void cpufreq_cpu_release(struct cpufreq_policy *policy)
258 if (WARN_ON(!policy))
259 return;
261 lockdep_assert_held(&policy->rwsem);
263 up_write(&policy->rwsem);
265 cpufreq_cpu_put(policy);
269 * cpufreq_cpu_acquire - Find policy for a CPU, mark it as busy and lock it.
270 * @cpu: CPU to find the policy for.
272 * Call cpufreq_cpu_get() to get a reference on the cpufreq policy for @cpu and
273 * if the policy returned by it is not NULL, acquire its rwsem for writing.
274 * Return the policy if it is active or release it and return NULL otherwise.
276 * The policy returned by this function has to be released with the help of
277 * cpufreq_cpu_release() in order to release its rwsem and balance its usage
278 * counter properly.
280 struct cpufreq_policy *cpufreq_cpu_acquire(unsigned int cpu)
282 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu);
284 if (!policy)
285 return NULL;
287 down_write(&policy->rwsem);
289 if (policy_is_inactive(policy)) {
290 cpufreq_cpu_release(policy);
291 return NULL;
294 return policy;
297 /*********************************************************************
298 * EXTERNALLY AFFECTING FREQUENCY CHANGES *
299 *********************************************************************/
302 * adjust_jiffies - adjust the system "loops_per_jiffy"
304 * This function alters the system "loops_per_jiffy" for the clock
305 * speed change. Note that loops_per_jiffy cannot be updated on SMP
306 * systems as each CPU might be scaled differently. So, use the arch
307 * per-CPU loops_per_jiffy value wherever possible.
309 static void adjust_jiffies(unsigned long val, struct cpufreq_freqs *ci)
311 #ifndef CONFIG_SMP
312 static unsigned long l_p_j_ref;
313 static unsigned int l_p_j_ref_freq;
315 if (ci->flags & CPUFREQ_CONST_LOOPS)
316 return;
318 if (!l_p_j_ref_freq) {
319 l_p_j_ref = loops_per_jiffy;
320 l_p_j_ref_freq = ci->old;
321 pr_debug("saving %lu as reference value for loops_per_jiffy; freq is %u kHz\n",
322 l_p_j_ref, l_p_j_ref_freq);
324 if (val == CPUFREQ_POSTCHANGE && ci->old != ci->new) {
325 loops_per_jiffy = cpufreq_scale(l_p_j_ref, l_p_j_ref_freq,
326 ci->new);
327 pr_debug("scaling loops_per_jiffy to %lu for frequency %u kHz\n",
328 loops_per_jiffy, ci->new);
330 #endif
334 * cpufreq_notify_transition - Notify frequency transition and adjust_jiffies.
335 * @policy: cpufreq policy to enable fast frequency switching for.
336 * @freqs: contain details of the frequency update.
337 * @state: set to CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
339 * This function calls the transition notifiers and the "adjust_jiffies"
340 * function. It is called twice on all CPU frequency changes that have
341 * external effects.
343 static void cpufreq_notify_transition(struct cpufreq_policy *policy,
344 struct cpufreq_freqs *freqs,
345 unsigned int state)
347 int cpu;
349 BUG_ON(irqs_disabled());
351 if (cpufreq_disabled())
352 return;
354 freqs->policy = policy;
355 freqs->flags = cpufreq_driver->flags;
356 pr_debug("notification %u of frequency transition to %u kHz\n",
357 state, freqs->new);
359 switch (state) {
360 case CPUFREQ_PRECHANGE:
362 * Detect if the driver reported a value as "old frequency"
363 * which is not equal to what the cpufreq core thinks is
364 * "old frequency".
366 if (policy->cur && policy->cur != freqs->old) {
367 pr_debug("Warning: CPU frequency is %u, cpufreq assumed %u kHz\n",
368 freqs->old, policy->cur);
369 freqs->old = policy->cur;
372 srcu_notifier_call_chain(&cpufreq_transition_notifier_list,
373 CPUFREQ_PRECHANGE, freqs);
375 adjust_jiffies(CPUFREQ_PRECHANGE, freqs);
376 break;
378 case CPUFREQ_POSTCHANGE:
379 adjust_jiffies(CPUFREQ_POSTCHANGE, freqs);
380 pr_debug("FREQ: %u - CPUs: %*pbl\n", freqs->new,
381 cpumask_pr_args(policy->cpus));
383 for_each_cpu(cpu, policy->cpus)
384 trace_cpu_frequency(freqs->new, cpu);
386 srcu_notifier_call_chain(&cpufreq_transition_notifier_list,
387 CPUFREQ_POSTCHANGE, freqs);
389 cpufreq_stats_record_transition(policy, freqs->new);
390 policy->cur = freqs->new;
394 /* Do post notifications when there are chances that transition has failed */
395 static void cpufreq_notify_post_transition(struct cpufreq_policy *policy,
396 struct cpufreq_freqs *freqs, int transition_failed)
398 cpufreq_notify_transition(policy, freqs, CPUFREQ_POSTCHANGE);
399 if (!transition_failed)
400 return;
402 swap(freqs->old, freqs->new);
403 cpufreq_notify_transition(policy, freqs, CPUFREQ_PRECHANGE);
404 cpufreq_notify_transition(policy, freqs, CPUFREQ_POSTCHANGE);
407 void cpufreq_freq_transition_begin(struct cpufreq_policy *policy,
408 struct cpufreq_freqs *freqs)
412 * Catch double invocations of _begin() which lead to self-deadlock.
413 * ASYNC_NOTIFICATION drivers are left out because the cpufreq core
414 * doesn't invoke _begin() on their behalf, and hence the chances of
415 * double invocations are very low. Moreover, there are scenarios
416 * where these checks can emit false-positive warnings in these
417 * drivers; so we avoid that by skipping them altogether.
419 WARN_ON(!(cpufreq_driver->flags & CPUFREQ_ASYNC_NOTIFICATION)
420 && current == policy->transition_task);
422 wait:
423 wait_event(policy->transition_wait, !policy->transition_ongoing);
425 spin_lock(&policy->transition_lock);
427 if (unlikely(policy->transition_ongoing)) {
428 spin_unlock(&policy->transition_lock);
429 goto wait;
432 policy->transition_ongoing = true;
433 policy->transition_task = current;
435 spin_unlock(&policy->transition_lock);
437 cpufreq_notify_transition(policy, freqs, CPUFREQ_PRECHANGE);
439 EXPORT_SYMBOL_GPL(cpufreq_freq_transition_begin);
441 void cpufreq_freq_transition_end(struct cpufreq_policy *policy,
442 struct cpufreq_freqs *freqs, int transition_failed)
444 if (WARN_ON(!policy->transition_ongoing))
445 return;
447 cpufreq_notify_post_transition(policy, freqs, transition_failed);
449 policy->transition_ongoing = false;
450 policy->transition_task = NULL;
452 wake_up(&policy->transition_wait);
454 EXPORT_SYMBOL_GPL(cpufreq_freq_transition_end);
457 * Fast frequency switching status count. Positive means "enabled", negative
458 * means "disabled" and 0 means "not decided yet".
460 static int cpufreq_fast_switch_count;
461 static DEFINE_MUTEX(cpufreq_fast_switch_lock);
463 static void cpufreq_list_transition_notifiers(void)
465 struct notifier_block *nb;
467 pr_info("Registered transition notifiers:\n");
469 mutex_lock(&cpufreq_transition_notifier_list.mutex);
471 for (nb = cpufreq_transition_notifier_list.head; nb; nb = nb->next)
472 pr_info("%pS\n", nb->notifier_call);
474 mutex_unlock(&cpufreq_transition_notifier_list.mutex);
478 * cpufreq_enable_fast_switch - Enable fast frequency switching for policy.
479 * @policy: cpufreq policy to enable fast frequency switching for.
481 * Try to enable fast frequency switching for @policy.
483 * The attempt will fail if there is at least one transition notifier registered
484 * at this point, as fast frequency switching is quite fundamentally at odds
485 * with transition notifiers. Thus if successful, it will make registration of
486 * transition notifiers fail going forward.
488 void cpufreq_enable_fast_switch(struct cpufreq_policy *policy)
490 lockdep_assert_held(&policy->rwsem);
492 if (!policy->fast_switch_possible)
493 return;
495 mutex_lock(&cpufreq_fast_switch_lock);
496 if (cpufreq_fast_switch_count >= 0) {
497 cpufreq_fast_switch_count++;
498 policy->fast_switch_enabled = true;
499 } else {
500 pr_warn("CPU%u: Fast frequency switching not enabled\n",
501 policy->cpu);
502 cpufreq_list_transition_notifiers();
504 mutex_unlock(&cpufreq_fast_switch_lock);
506 EXPORT_SYMBOL_GPL(cpufreq_enable_fast_switch);
509 * cpufreq_disable_fast_switch - Disable fast frequency switching for policy.
510 * @policy: cpufreq policy to disable fast frequency switching for.
512 void cpufreq_disable_fast_switch(struct cpufreq_policy *policy)
514 mutex_lock(&cpufreq_fast_switch_lock);
515 if (policy->fast_switch_enabled) {
516 policy->fast_switch_enabled = false;
517 if (!WARN_ON(cpufreq_fast_switch_count <= 0))
518 cpufreq_fast_switch_count--;
520 mutex_unlock(&cpufreq_fast_switch_lock);
522 EXPORT_SYMBOL_GPL(cpufreq_disable_fast_switch);
525 * cpufreq_driver_resolve_freq - Map a target frequency to a driver-supported
526 * one.
527 * @target_freq: target frequency to resolve.
529 * The target to driver frequency mapping is cached in the policy.
531 * Return: Lowest driver-supported frequency greater than or equal to the
532 * given target_freq, subject to policy (min/max) and driver limitations.
534 unsigned int cpufreq_driver_resolve_freq(struct cpufreq_policy *policy,
535 unsigned int target_freq)
537 target_freq = clamp_val(target_freq, policy->min, policy->max);
538 policy->cached_target_freq = target_freq;
540 if (cpufreq_driver->target_index) {
541 int idx;
543 idx = cpufreq_frequency_table_target(policy, target_freq,
544 CPUFREQ_RELATION_L);
545 policy->cached_resolved_idx = idx;
546 return policy->freq_table[idx].frequency;
549 if (cpufreq_driver->resolve_freq)
550 return cpufreq_driver->resolve_freq(policy, target_freq);
552 return target_freq;
554 EXPORT_SYMBOL_GPL(cpufreq_driver_resolve_freq);
556 unsigned int cpufreq_policy_transition_delay_us(struct cpufreq_policy *policy)
558 unsigned int latency;
560 if (policy->transition_delay_us)
561 return policy->transition_delay_us;
563 latency = policy->cpuinfo.transition_latency / NSEC_PER_USEC;
564 if (latency) {
566 * For platforms that can change the frequency very fast (< 10
567 * us), the above formula gives a decent transition delay. But
568 * for platforms where transition_latency is in milliseconds, it
569 * ends up giving unrealistic values.
571 * Cap the default transition delay to 10 ms, which seems to be
572 * a reasonable amount of time after which we should reevaluate
573 * the frequency.
575 return min(latency * LATENCY_MULTIPLIER, (unsigned int)10000);
578 return LATENCY_MULTIPLIER;
580 EXPORT_SYMBOL_GPL(cpufreq_policy_transition_delay_us);
582 /*********************************************************************
583 * SYSFS INTERFACE *
584 *********************************************************************/
585 static ssize_t show_boost(struct kobject *kobj,
586 struct kobj_attribute *attr, char *buf)
588 return sprintf(buf, "%d\n", cpufreq_driver->boost_enabled);
591 static ssize_t store_boost(struct kobject *kobj, struct kobj_attribute *attr,
592 const char *buf, size_t count)
594 int ret, enable;
596 ret = sscanf(buf, "%d", &enable);
597 if (ret != 1 || enable < 0 || enable > 1)
598 return -EINVAL;
600 if (cpufreq_boost_trigger_state(enable)) {
601 pr_err("%s: Cannot %s BOOST!\n",
602 __func__, enable ? "enable" : "disable");
603 return -EINVAL;
606 pr_debug("%s: cpufreq BOOST %s\n",
607 __func__, enable ? "enabled" : "disabled");
609 return count;
611 define_one_global_rw(boost);
613 static struct cpufreq_governor *find_governor(const char *str_governor)
615 struct cpufreq_governor *t;
617 for_each_governor(t)
618 if (!strncasecmp(str_governor, t->name, CPUFREQ_NAME_LEN))
619 return t;
621 return NULL;
624 static unsigned int cpufreq_parse_policy(char *str_governor)
626 if (!strncasecmp(str_governor, "performance", CPUFREQ_NAME_LEN))
627 return CPUFREQ_POLICY_PERFORMANCE;
629 if (!strncasecmp(str_governor, "powersave", CPUFREQ_NAME_LEN))
630 return CPUFREQ_POLICY_POWERSAVE;
632 return CPUFREQ_POLICY_UNKNOWN;
636 * cpufreq_parse_governor - parse a governor string only for has_target()
637 * @str_governor: Governor name.
639 static struct cpufreq_governor *cpufreq_parse_governor(char *str_governor)
641 struct cpufreq_governor *t;
643 mutex_lock(&cpufreq_governor_mutex);
645 t = find_governor(str_governor);
646 if (!t) {
647 int ret;
649 mutex_unlock(&cpufreq_governor_mutex);
651 ret = request_module("cpufreq_%s", str_governor);
652 if (ret)
653 return NULL;
655 mutex_lock(&cpufreq_governor_mutex);
657 t = find_governor(str_governor);
659 if (t && !try_module_get(t->owner))
660 t = NULL;
662 mutex_unlock(&cpufreq_governor_mutex);
664 return t;
668 * cpufreq_per_cpu_attr_read() / show_##file_name() -
669 * print out cpufreq information
671 * Write out information from cpufreq_driver->policy[cpu]; object must be
672 * "unsigned int".
675 #define show_one(file_name, object) \
676 static ssize_t show_##file_name \
677 (struct cpufreq_policy *policy, char *buf) \
679 return sprintf(buf, "%u\n", policy->object); \
682 show_one(cpuinfo_min_freq, cpuinfo.min_freq);
683 show_one(cpuinfo_max_freq, cpuinfo.max_freq);
684 show_one(cpuinfo_transition_latency, cpuinfo.transition_latency);
685 show_one(scaling_min_freq, min);
686 show_one(scaling_max_freq, max);
688 __weak unsigned int arch_freq_get_on_cpu(int cpu)
690 return 0;
693 static ssize_t show_scaling_cur_freq(struct cpufreq_policy *policy, char *buf)
695 ssize_t ret;
696 unsigned int freq;
698 freq = arch_freq_get_on_cpu(policy->cpu);
699 if (freq)
700 ret = sprintf(buf, "%u\n", freq);
701 else if (cpufreq_driver && cpufreq_driver->setpolicy &&
702 cpufreq_driver->get)
703 ret = sprintf(buf, "%u\n", cpufreq_driver->get(policy->cpu));
704 else
705 ret = sprintf(buf, "%u\n", policy->cur);
706 return ret;
710 * cpufreq_per_cpu_attr_write() / store_##file_name() - sysfs write access
712 #define store_one(file_name, object) \
713 static ssize_t store_##file_name \
714 (struct cpufreq_policy *policy, const char *buf, size_t count) \
716 unsigned long val; \
717 int ret; \
719 ret = sscanf(buf, "%lu", &val); \
720 if (ret != 1) \
721 return -EINVAL; \
723 ret = freq_qos_update_request(policy->object##_freq_req, val);\
724 return ret >= 0 ? count : ret; \
727 store_one(scaling_min_freq, min);
728 store_one(scaling_max_freq, max);
731 * show_cpuinfo_cur_freq - current CPU frequency as detected by hardware
733 static ssize_t show_cpuinfo_cur_freq(struct cpufreq_policy *policy,
734 char *buf)
736 unsigned int cur_freq = __cpufreq_get(policy);
738 if (cur_freq)
739 return sprintf(buf, "%u\n", cur_freq);
741 return sprintf(buf, "<unknown>\n");
745 * show_scaling_governor - show the current policy for the specified CPU
747 static ssize_t show_scaling_governor(struct cpufreq_policy *policy, char *buf)
749 if (policy->policy == CPUFREQ_POLICY_POWERSAVE)
750 return sprintf(buf, "powersave\n");
751 else if (policy->policy == CPUFREQ_POLICY_PERFORMANCE)
752 return sprintf(buf, "performance\n");
753 else if (policy->governor)
754 return scnprintf(buf, CPUFREQ_NAME_PLEN, "%s\n",
755 policy->governor->name);
756 return -EINVAL;
760 * store_scaling_governor - store policy for the specified CPU
762 static ssize_t store_scaling_governor(struct cpufreq_policy *policy,
763 const char *buf, size_t count)
765 char str_governor[16];
766 int ret;
768 ret = sscanf(buf, "%15s", str_governor);
769 if (ret != 1)
770 return -EINVAL;
772 if (cpufreq_driver->setpolicy) {
773 unsigned int new_pol;
775 new_pol = cpufreq_parse_policy(str_governor);
776 if (!new_pol)
777 return -EINVAL;
779 ret = cpufreq_set_policy(policy, NULL, new_pol);
780 } else {
781 struct cpufreq_governor *new_gov;
783 new_gov = cpufreq_parse_governor(str_governor);
784 if (!new_gov)
785 return -EINVAL;
787 ret = cpufreq_set_policy(policy, new_gov,
788 CPUFREQ_POLICY_UNKNOWN);
790 module_put(new_gov->owner);
793 return ret ? ret : count;
797 * show_scaling_driver - show the cpufreq driver currently loaded
799 static ssize_t show_scaling_driver(struct cpufreq_policy *policy, char *buf)
801 return scnprintf(buf, CPUFREQ_NAME_PLEN, "%s\n", cpufreq_driver->name);
805 * show_scaling_available_governors - show the available CPUfreq governors
807 static ssize_t show_scaling_available_governors(struct cpufreq_policy *policy,
808 char *buf)
810 ssize_t i = 0;
811 struct cpufreq_governor *t;
813 if (!has_target()) {
814 i += sprintf(buf, "performance powersave");
815 goto out;
818 for_each_governor(t) {
819 if (i >= (ssize_t) ((PAGE_SIZE / sizeof(char))
820 - (CPUFREQ_NAME_LEN + 2)))
821 goto out;
822 i += scnprintf(&buf[i], CPUFREQ_NAME_PLEN, "%s ", t->name);
824 out:
825 i += sprintf(&buf[i], "\n");
826 return i;
829 ssize_t cpufreq_show_cpus(const struct cpumask *mask, char *buf)
831 ssize_t i = 0;
832 unsigned int cpu;
834 for_each_cpu(cpu, mask) {
835 if (i)
836 i += scnprintf(&buf[i], (PAGE_SIZE - i - 2), " ");
837 i += scnprintf(&buf[i], (PAGE_SIZE - i - 2), "%u", cpu);
838 if (i >= (PAGE_SIZE - 5))
839 break;
841 i += sprintf(&buf[i], "\n");
842 return i;
844 EXPORT_SYMBOL_GPL(cpufreq_show_cpus);
847 * show_related_cpus - show the CPUs affected by each transition even if
848 * hw coordination is in use
850 static ssize_t show_related_cpus(struct cpufreq_policy *policy, char *buf)
852 return cpufreq_show_cpus(policy->related_cpus, buf);
856 * show_affected_cpus - show the CPUs affected by each transition
858 static ssize_t show_affected_cpus(struct cpufreq_policy *policy, char *buf)
860 return cpufreq_show_cpus(policy->cpus, buf);
863 static ssize_t store_scaling_setspeed(struct cpufreq_policy *policy,
864 const char *buf, size_t count)
866 unsigned int freq = 0;
867 unsigned int ret;
869 if (!policy->governor || !policy->governor->store_setspeed)
870 return -EINVAL;
872 ret = sscanf(buf, "%u", &freq);
873 if (ret != 1)
874 return -EINVAL;
876 policy->governor->store_setspeed(policy, freq);
878 return count;
881 static ssize_t show_scaling_setspeed(struct cpufreq_policy *policy, char *buf)
883 if (!policy->governor || !policy->governor->show_setspeed)
884 return sprintf(buf, "<unsupported>\n");
886 return policy->governor->show_setspeed(policy, buf);
890 * show_bios_limit - show the current cpufreq HW/BIOS limitation
892 static ssize_t show_bios_limit(struct cpufreq_policy *policy, char *buf)
894 unsigned int limit;
895 int ret;
896 ret = cpufreq_driver->bios_limit(policy->cpu, &limit);
897 if (!ret)
898 return sprintf(buf, "%u\n", limit);
899 return sprintf(buf, "%u\n", policy->cpuinfo.max_freq);
902 cpufreq_freq_attr_ro_perm(cpuinfo_cur_freq, 0400);
903 cpufreq_freq_attr_ro(cpuinfo_min_freq);
904 cpufreq_freq_attr_ro(cpuinfo_max_freq);
905 cpufreq_freq_attr_ro(cpuinfo_transition_latency);
906 cpufreq_freq_attr_ro(scaling_available_governors);
907 cpufreq_freq_attr_ro(scaling_driver);
908 cpufreq_freq_attr_ro(scaling_cur_freq);
909 cpufreq_freq_attr_ro(bios_limit);
910 cpufreq_freq_attr_ro(related_cpus);
911 cpufreq_freq_attr_ro(affected_cpus);
912 cpufreq_freq_attr_rw(scaling_min_freq);
913 cpufreq_freq_attr_rw(scaling_max_freq);
914 cpufreq_freq_attr_rw(scaling_governor);
915 cpufreq_freq_attr_rw(scaling_setspeed);
917 static struct attribute *default_attrs[] = {
918 &cpuinfo_min_freq.attr,
919 &cpuinfo_max_freq.attr,
920 &cpuinfo_transition_latency.attr,
921 &scaling_min_freq.attr,
922 &scaling_max_freq.attr,
923 &affected_cpus.attr,
924 &related_cpus.attr,
925 &scaling_governor.attr,
926 &scaling_driver.attr,
927 &scaling_available_governors.attr,
928 &scaling_setspeed.attr,
929 NULL
932 #define to_policy(k) container_of(k, struct cpufreq_policy, kobj)
933 #define to_attr(a) container_of(a, struct freq_attr, attr)
935 static ssize_t show(struct kobject *kobj, struct attribute *attr, char *buf)
937 struct cpufreq_policy *policy = to_policy(kobj);
938 struct freq_attr *fattr = to_attr(attr);
939 ssize_t ret;
941 if (!fattr->show)
942 return -EIO;
944 down_read(&policy->rwsem);
945 ret = fattr->show(policy, buf);
946 up_read(&policy->rwsem);
948 return ret;
951 static ssize_t store(struct kobject *kobj, struct attribute *attr,
952 const char *buf, size_t count)
954 struct cpufreq_policy *policy = to_policy(kobj);
955 struct freq_attr *fattr = to_attr(attr);
956 ssize_t ret = -EINVAL;
958 if (!fattr->store)
959 return -EIO;
962 * cpus_read_trylock() is used here to work around a circular lock
963 * dependency problem with respect to the cpufreq_register_driver().
965 if (!cpus_read_trylock())
966 return -EBUSY;
968 if (cpu_online(policy->cpu)) {
969 down_write(&policy->rwsem);
970 ret = fattr->store(policy, buf, count);
971 up_write(&policy->rwsem);
974 cpus_read_unlock();
976 return ret;
979 static void cpufreq_sysfs_release(struct kobject *kobj)
981 struct cpufreq_policy *policy = to_policy(kobj);
982 pr_debug("last reference is dropped\n");
983 complete(&policy->kobj_unregister);
986 static const struct sysfs_ops sysfs_ops = {
987 .show = show,
988 .store = store,
991 static struct kobj_type ktype_cpufreq = {
992 .sysfs_ops = &sysfs_ops,
993 .default_attrs = default_attrs,
994 .release = cpufreq_sysfs_release,
997 static void add_cpu_dev_symlink(struct cpufreq_policy *policy, unsigned int cpu)
999 struct device *dev = get_cpu_device(cpu);
1001 if (unlikely(!dev))
1002 return;
1004 if (cpumask_test_and_set_cpu(cpu, policy->real_cpus))
1005 return;
1007 dev_dbg(dev, "%s: Adding symlink\n", __func__);
1008 if (sysfs_create_link(&dev->kobj, &policy->kobj, "cpufreq"))
1009 dev_err(dev, "cpufreq symlink creation failed\n");
1012 static void remove_cpu_dev_symlink(struct cpufreq_policy *policy,
1013 struct device *dev)
1015 dev_dbg(dev, "%s: Removing symlink\n", __func__);
1016 sysfs_remove_link(&dev->kobj, "cpufreq");
1019 static int cpufreq_add_dev_interface(struct cpufreq_policy *policy)
1021 struct freq_attr **drv_attr;
1022 int ret = 0;
1024 /* set up files for this cpu device */
1025 drv_attr = cpufreq_driver->attr;
1026 while (drv_attr && *drv_attr) {
1027 ret = sysfs_create_file(&policy->kobj, &((*drv_attr)->attr));
1028 if (ret)
1029 return ret;
1030 drv_attr++;
1032 if (cpufreq_driver->get) {
1033 ret = sysfs_create_file(&policy->kobj, &cpuinfo_cur_freq.attr);
1034 if (ret)
1035 return ret;
1038 ret = sysfs_create_file(&policy->kobj, &scaling_cur_freq.attr);
1039 if (ret)
1040 return ret;
1042 if (cpufreq_driver->bios_limit) {
1043 ret = sysfs_create_file(&policy->kobj, &bios_limit.attr);
1044 if (ret)
1045 return ret;
1048 return 0;
1051 __weak struct cpufreq_governor *cpufreq_default_governor(void)
1053 return NULL;
1056 static int cpufreq_init_policy(struct cpufreq_policy *policy)
1058 struct cpufreq_governor *def_gov = cpufreq_default_governor();
1059 struct cpufreq_governor *gov = NULL;
1060 unsigned int pol = CPUFREQ_POLICY_UNKNOWN;
1062 if (has_target()) {
1063 /* Update policy governor to the one used before hotplug. */
1064 gov = find_governor(policy->last_governor);
1065 if (gov) {
1066 pr_debug("Restoring governor %s for cpu %d\n",
1067 policy->governor->name, policy->cpu);
1068 } else if (def_gov) {
1069 gov = def_gov;
1070 } else {
1071 return -ENODATA;
1073 } else {
1074 /* Use the default policy if there is no last_policy. */
1075 if (policy->last_policy) {
1076 pol = policy->last_policy;
1077 } else if (def_gov) {
1078 pol = cpufreq_parse_policy(def_gov->name);
1080 * In case the default governor is neiter "performance"
1081 * nor "powersave", fall back to the initial policy
1082 * value set by the driver.
1084 if (pol == CPUFREQ_POLICY_UNKNOWN)
1085 pol = policy->policy;
1087 if (pol != CPUFREQ_POLICY_PERFORMANCE &&
1088 pol != CPUFREQ_POLICY_POWERSAVE)
1089 return -ENODATA;
1092 return cpufreq_set_policy(policy, gov, pol);
1095 static int cpufreq_add_policy_cpu(struct cpufreq_policy *policy, unsigned int cpu)
1097 int ret = 0;
1099 /* Has this CPU been taken care of already? */
1100 if (cpumask_test_cpu(cpu, policy->cpus))
1101 return 0;
1103 down_write(&policy->rwsem);
1104 if (has_target())
1105 cpufreq_stop_governor(policy);
1107 cpumask_set_cpu(cpu, policy->cpus);
1109 if (has_target()) {
1110 ret = cpufreq_start_governor(policy);
1111 if (ret)
1112 pr_err("%s: Failed to start governor\n", __func__);
1114 up_write(&policy->rwsem);
1115 return ret;
1118 void refresh_frequency_limits(struct cpufreq_policy *policy)
1120 if (!policy_is_inactive(policy)) {
1121 pr_debug("updating policy for CPU %u\n", policy->cpu);
1123 cpufreq_set_policy(policy, policy->governor, policy->policy);
1126 EXPORT_SYMBOL(refresh_frequency_limits);
1128 static void handle_update(struct work_struct *work)
1130 struct cpufreq_policy *policy =
1131 container_of(work, struct cpufreq_policy, update);
1133 pr_debug("handle_update for cpu %u called\n", policy->cpu);
1134 down_write(&policy->rwsem);
1135 refresh_frequency_limits(policy);
1136 up_write(&policy->rwsem);
1139 static int cpufreq_notifier_min(struct notifier_block *nb, unsigned long freq,
1140 void *data)
1142 struct cpufreq_policy *policy = container_of(nb, struct cpufreq_policy, nb_min);
1144 schedule_work(&policy->update);
1145 return 0;
1148 static int cpufreq_notifier_max(struct notifier_block *nb, unsigned long freq,
1149 void *data)
1151 struct cpufreq_policy *policy = container_of(nb, struct cpufreq_policy, nb_max);
1153 schedule_work(&policy->update);
1154 return 0;
1157 static void cpufreq_policy_put_kobj(struct cpufreq_policy *policy)
1159 struct kobject *kobj;
1160 struct completion *cmp;
1162 down_write(&policy->rwsem);
1163 cpufreq_stats_free_table(policy);
1164 kobj = &policy->kobj;
1165 cmp = &policy->kobj_unregister;
1166 up_write(&policy->rwsem);
1167 kobject_put(kobj);
1170 * We need to make sure that the underlying kobj is
1171 * actually not referenced anymore by anybody before we
1172 * proceed with unloading.
1174 pr_debug("waiting for dropping of refcount\n");
1175 wait_for_completion(cmp);
1176 pr_debug("wait complete\n");
1179 static struct cpufreq_policy *cpufreq_policy_alloc(unsigned int cpu)
1181 struct cpufreq_policy *policy;
1182 struct device *dev = get_cpu_device(cpu);
1183 int ret;
1185 if (!dev)
1186 return NULL;
1188 policy = kzalloc(sizeof(*policy), GFP_KERNEL);
1189 if (!policy)
1190 return NULL;
1192 if (!alloc_cpumask_var(&policy->cpus, GFP_KERNEL))
1193 goto err_free_policy;
1195 if (!zalloc_cpumask_var(&policy->related_cpus, GFP_KERNEL))
1196 goto err_free_cpumask;
1198 if (!zalloc_cpumask_var(&policy->real_cpus, GFP_KERNEL))
1199 goto err_free_rcpumask;
1201 ret = kobject_init_and_add(&policy->kobj, &ktype_cpufreq,
1202 cpufreq_global_kobject, "policy%u", cpu);
1203 if (ret) {
1204 dev_err(dev, "%s: failed to init policy->kobj: %d\n", __func__, ret);
1206 * The entire policy object will be freed below, but the extra
1207 * memory allocated for the kobject name needs to be freed by
1208 * releasing the kobject.
1210 kobject_put(&policy->kobj);
1211 goto err_free_real_cpus;
1214 freq_constraints_init(&policy->constraints);
1216 policy->nb_min.notifier_call = cpufreq_notifier_min;
1217 policy->nb_max.notifier_call = cpufreq_notifier_max;
1219 ret = freq_qos_add_notifier(&policy->constraints, FREQ_QOS_MIN,
1220 &policy->nb_min);
1221 if (ret) {
1222 dev_err(dev, "Failed to register MIN QoS notifier: %d (%*pbl)\n",
1223 ret, cpumask_pr_args(policy->cpus));
1224 goto err_kobj_remove;
1227 ret = freq_qos_add_notifier(&policy->constraints, FREQ_QOS_MAX,
1228 &policy->nb_max);
1229 if (ret) {
1230 dev_err(dev, "Failed to register MAX QoS notifier: %d (%*pbl)\n",
1231 ret, cpumask_pr_args(policy->cpus));
1232 goto err_min_qos_notifier;
1235 INIT_LIST_HEAD(&policy->policy_list);
1236 init_rwsem(&policy->rwsem);
1237 spin_lock_init(&policy->transition_lock);
1238 init_waitqueue_head(&policy->transition_wait);
1239 init_completion(&policy->kobj_unregister);
1240 INIT_WORK(&policy->update, handle_update);
1242 policy->cpu = cpu;
1243 return policy;
1245 err_min_qos_notifier:
1246 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MIN,
1247 &policy->nb_min);
1248 err_kobj_remove:
1249 cpufreq_policy_put_kobj(policy);
1250 err_free_real_cpus:
1251 free_cpumask_var(policy->real_cpus);
1252 err_free_rcpumask:
1253 free_cpumask_var(policy->related_cpus);
1254 err_free_cpumask:
1255 free_cpumask_var(policy->cpus);
1256 err_free_policy:
1257 kfree(policy);
1259 return NULL;
1262 static void cpufreq_policy_free(struct cpufreq_policy *policy)
1264 unsigned long flags;
1265 int cpu;
1267 /* Remove policy from list */
1268 write_lock_irqsave(&cpufreq_driver_lock, flags);
1269 list_del(&policy->policy_list);
1271 for_each_cpu(cpu, policy->related_cpus)
1272 per_cpu(cpufreq_cpu_data, cpu) = NULL;
1273 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
1275 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MAX,
1276 &policy->nb_max);
1277 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MIN,
1278 &policy->nb_min);
1280 /* Cancel any pending policy->update work before freeing the policy. */
1281 cancel_work_sync(&policy->update);
1283 if (policy->max_freq_req) {
1285 * CPUFREQ_CREATE_POLICY notification is sent only after
1286 * successfully adding max_freq_req request.
1288 blocking_notifier_call_chain(&cpufreq_policy_notifier_list,
1289 CPUFREQ_REMOVE_POLICY, policy);
1290 freq_qos_remove_request(policy->max_freq_req);
1293 freq_qos_remove_request(policy->min_freq_req);
1294 kfree(policy->min_freq_req);
1296 cpufreq_policy_put_kobj(policy);
1297 free_cpumask_var(policy->real_cpus);
1298 free_cpumask_var(policy->related_cpus);
1299 free_cpumask_var(policy->cpus);
1300 kfree(policy);
1303 static int cpufreq_online(unsigned int cpu)
1305 struct cpufreq_policy *policy;
1306 bool new_policy;
1307 unsigned long flags;
1308 unsigned int j;
1309 int ret;
1311 pr_debug("%s: bringing CPU%u online\n", __func__, cpu);
1313 /* Check if this CPU already has a policy to manage it */
1314 policy = per_cpu(cpufreq_cpu_data, cpu);
1315 if (policy) {
1316 WARN_ON(!cpumask_test_cpu(cpu, policy->related_cpus));
1317 if (!policy_is_inactive(policy))
1318 return cpufreq_add_policy_cpu(policy, cpu);
1320 /* This is the only online CPU for the policy. Start over. */
1321 new_policy = false;
1322 down_write(&policy->rwsem);
1323 policy->cpu = cpu;
1324 policy->governor = NULL;
1325 up_write(&policy->rwsem);
1326 } else {
1327 new_policy = true;
1328 policy = cpufreq_policy_alloc(cpu);
1329 if (!policy)
1330 return -ENOMEM;
1333 if (!new_policy && cpufreq_driver->online) {
1334 ret = cpufreq_driver->online(policy);
1335 if (ret) {
1336 pr_debug("%s: %d: initialization failed\n", __func__,
1337 __LINE__);
1338 goto out_exit_policy;
1341 /* Recover policy->cpus using related_cpus */
1342 cpumask_copy(policy->cpus, policy->related_cpus);
1343 } else {
1344 cpumask_copy(policy->cpus, cpumask_of(cpu));
1347 * Call driver. From then on the cpufreq must be able
1348 * to accept all calls to ->verify and ->setpolicy for this CPU.
1350 ret = cpufreq_driver->init(policy);
1351 if (ret) {
1352 pr_debug("%s: %d: initialization failed\n", __func__,
1353 __LINE__);
1354 goto out_free_policy;
1357 ret = cpufreq_table_validate_and_sort(policy);
1358 if (ret)
1359 goto out_exit_policy;
1361 /* related_cpus should at least include policy->cpus. */
1362 cpumask_copy(policy->related_cpus, policy->cpus);
1365 down_write(&policy->rwsem);
1367 * affected cpus must always be the one, which are online. We aren't
1368 * managing offline cpus here.
1370 cpumask_and(policy->cpus, policy->cpus, cpu_online_mask);
1372 if (new_policy) {
1373 for_each_cpu(j, policy->related_cpus) {
1374 per_cpu(cpufreq_cpu_data, j) = policy;
1375 add_cpu_dev_symlink(policy, j);
1378 policy->min_freq_req = kzalloc(2 * sizeof(*policy->min_freq_req),
1379 GFP_KERNEL);
1380 if (!policy->min_freq_req)
1381 goto out_destroy_policy;
1383 ret = freq_qos_add_request(&policy->constraints,
1384 policy->min_freq_req, FREQ_QOS_MIN,
1385 policy->min);
1386 if (ret < 0) {
1388 * So we don't call freq_qos_remove_request() for an
1389 * uninitialized request.
1391 kfree(policy->min_freq_req);
1392 policy->min_freq_req = NULL;
1393 goto out_destroy_policy;
1397 * This must be initialized right here to avoid calling
1398 * freq_qos_remove_request() on uninitialized request in case
1399 * of errors.
1401 policy->max_freq_req = policy->min_freq_req + 1;
1403 ret = freq_qos_add_request(&policy->constraints,
1404 policy->max_freq_req, FREQ_QOS_MAX,
1405 policy->max);
1406 if (ret < 0) {
1407 policy->max_freq_req = NULL;
1408 goto out_destroy_policy;
1411 blocking_notifier_call_chain(&cpufreq_policy_notifier_list,
1412 CPUFREQ_CREATE_POLICY, policy);
1415 if (cpufreq_driver->get && has_target()) {
1416 policy->cur = cpufreq_driver->get(policy->cpu);
1417 if (!policy->cur) {
1418 pr_err("%s: ->get() failed\n", __func__);
1419 goto out_destroy_policy;
1424 * Sometimes boot loaders set CPU frequency to a value outside of
1425 * frequency table present with cpufreq core. In such cases CPU might be
1426 * unstable if it has to run on that frequency for long duration of time
1427 * and so its better to set it to a frequency which is specified in
1428 * freq-table. This also makes cpufreq stats inconsistent as
1429 * cpufreq-stats would fail to register because current frequency of CPU
1430 * isn't found in freq-table.
1432 * Because we don't want this change to effect boot process badly, we go
1433 * for the next freq which is >= policy->cur ('cur' must be set by now,
1434 * otherwise we will end up setting freq to lowest of the table as 'cur'
1435 * is initialized to zero).
1437 * We are passing target-freq as "policy->cur - 1" otherwise
1438 * __cpufreq_driver_target() would simply fail, as policy->cur will be
1439 * equal to target-freq.
1441 if ((cpufreq_driver->flags & CPUFREQ_NEED_INITIAL_FREQ_CHECK)
1442 && has_target()) {
1443 /* Are we running at unknown frequency ? */
1444 ret = cpufreq_frequency_table_get_index(policy, policy->cur);
1445 if (ret == -EINVAL) {
1446 /* Warn user and fix it */
1447 pr_warn("%s: CPU%d: Running at unlisted freq: %u KHz\n",
1448 __func__, policy->cpu, policy->cur);
1449 ret = __cpufreq_driver_target(policy, policy->cur - 1,
1450 CPUFREQ_RELATION_L);
1453 * Reaching here after boot in a few seconds may not
1454 * mean that system will remain stable at "unknown"
1455 * frequency for longer duration. Hence, a BUG_ON().
1457 BUG_ON(ret);
1458 pr_warn("%s: CPU%d: Unlisted initial frequency changed to: %u KHz\n",
1459 __func__, policy->cpu, policy->cur);
1463 if (new_policy) {
1464 ret = cpufreq_add_dev_interface(policy);
1465 if (ret)
1466 goto out_destroy_policy;
1468 cpufreq_stats_create_table(policy);
1470 write_lock_irqsave(&cpufreq_driver_lock, flags);
1471 list_add(&policy->policy_list, &cpufreq_policy_list);
1472 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
1475 ret = cpufreq_init_policy(policy);
1476 if (ret) {
1477 pr_err("%s: Failed to initialize policy for cpu: %d (%d)\n",
1478 __func__, cpu, ret);
1479 goto out_destroy_policy;
1482 up_write(&policy->rwsem);
1484 kobject_uevent(&policy->kobj, KOBJ_ADD);
1486 /* Callback for handling stuff after policy is ready */
1487 if (cpufreq_driver->ready)
1488 cpufreq_driver->ready(policy);
1490 if (cpufreq_thermal_control_enabled(cpufreq_driver))
1491 policy->cdev = of_cpufreq_cooling_register(policy);
1493 pr_debug("initialization complete\n");
1495 return 0;
1497 out_destroy_policy:
1498 for_each_cpu(j, policy->real_cpus)
1499 remove_cpu_dev_symlink(policy, get_cpu_device(j));
1501 up_write(&policy->rwsem);
1503 out_exit_policy:
1504 if (cpufreq_driver->exit)
1505 cpufreq_driver->exit(policy);
1507 out_free_policy:
1508 cpufreq_policy_free(policy);
1509 return ret;
1513 * cpufreq_add_dev - the cpufreq interface for a CPU device.
1514 * @dev: CPU device.
1515 * @sif: Subsystem interface structure pointer (not used)
1517 static int cpufreq_add_dev(struct device *dev, struct subsys_interface *sif)
1519 struct cpufreq_policy *policy;
1520 unsigned cpu = dev->id;
1521 int ret;
1523 dev_dbg(dev, "%s: adding CPU%u\n", __func__, cpu);
1525 if (cpu_online(cpu)) {
1526 ret = cpufreq_online(cpu);
1527 if (ret)
1528 return ret;
1531 /* Create sysfs link on CPU registration */
1532 policy = per_cpu(cpufreq_cpu_data, cpu);
1533 if (policy)
1534 add_cpu_dev_symlink(policy, cpu);
1536 return 0;
1539 static int cpufreq_offline(unsigned int cpu)
1541 struct cpufreq_policy *policy;
1542 int ret;
1544 pr_debug("%s: unregistering CPU %u\n", __func__, cpu);
1546 policy = cpufreq_cpu_get_raw(cpu);
1547 if (!policy) {
1548 pr_debug("%s: No cpu_data found\n", __func__);
1549 return 0;
1552 down_write(&policy->rwsem);
1553 if (has_target())
1554 cpufreq_stop_governor(policy);
1556 cpumask_clear_cpu(cpu, policy->cpus);
1558 if (policy_is_inactive(policy)) {
1559 if (has_target())
1560 strncpy(policy->last_governor, policy->governor->name,
1561 CPUFREQ_NAME_LEN);
1562 else
1563 policy->last_policy = policy->policy;
1564 } else if (cpu == policy->cpu) {
1565 /* Nominate new CPU */
1566 policy->cpu = cpumask_any(policy->cpus);
1569 /* Start governor again for active policy */
1570 if (!policy_is_inactive(policy)) {
1571 if (has_target()) {
1572 ret = cpufreq_start_governor(policy);
1573 if (ret)
1574 pr_err("%s: Failed to start governor\n", __func__);
1577 goto unlock;
1580 if (cpufreq_thermal_control_enabled(cpufreq_driver)) {
1581 cpufreq_cooling_unregister(policy->cdev);
1582 policy->cdev = NULL;
1585 if (cpufreq_driver->stop_cpu)
1586 cpufreq_driver->stop_cpu(policy);
1588 if (has_target())
1589 cpufreq_exit_governor(policy);
1592 * Perform the ->offline() during light-weight tear-down, as
1593 * that allows fast recovery when the CPU comes back.
1595 if (cpufreq_driver->offline) {
1596 cpufreq_driver->offline(policy);
1597 } else if (cpufreq_driver->exit) {
1598 cpufreq_driver->exit(policy);
1599 policy->freq_table = NULL;
1602 unlock:
1603 up_write(&policy->rwsem);
1604 return 0;
1608 * cpufreq_remove_dev - remove a CPU device
1610 * Removes the cpufreq interface for a CPU device.
1612 static void cpufreq_remove_dev(struct device *dev, struct subsys_interface *sif)
1614 unsigned int cpu = dev->id;
1615 struct cpufreq_policy *policy = per_cpu(cpufreq_cpu_data, cpu);
1617 if (!policy)
1618 return;
1620 if (cpu_online(cpu))
1621 cpufreq_offline(cpu);
1623 cpumask_clear_cpu(cpu, policy->real_cpus);
1624 remove_cpu_dev_symlink(policy, dev);
1626 if (cpumask_empty(policy->real_cpus)) {
1627 /* We did light-weight exit earlier, do full tear down now */
1628 if (cpufreq_driver->offline)
1629 cpufreq_driver->exit(policy);
1631 cpufreq_policy_free(policy);
1636 * cpufreq_out_of_sync - If actual and saved CPU frequency differs, we're
1637 * in deep trouble.
1638 * @policy: policy managing CPUs
1639 * @new_freq: CPU frequency the CPU actually runs at
1641 * We adjust to current frequency first, and need to clean up later.
1642 * So either call to cpufreq_update_policy() or schedule handle_update()).
1644 static void cpufreq_out_of_sync(struct cpufreq_policy *policy,
1645 unsigned int new_freq)
1647 struct cpufreq_freqs freqs;
1649 pr_debug("Warning: CPU frequency out of sync: cpufreq and timing core thinks of %u, is %u kHz\n",
1650 policy->cur, new_freq);
1652 freqs.old = policy->cur;
1653 freqs.new = new_freq;
1655 cpufreq_freq_transition_begin(policy, &freqs);
1656 cpufreq_freq_transition_end(policy, &freqs, 0);
1659 static unsigned int cpufreq_verify_current_freq(struct cpufreq_policy *policy, bool update)
1661 unsigned int new_freq;
1663 new_freq = cpufreq_driver->get(policy->cpu);
1664 if (!new_freq)
1665 return 0;
1668 * If fast frequency switching is used with the given policy, the check
1669 * against policy->cur is pointless, so skip it in that case.
1671 if (policy->fast_switch_enabled || !has_target())
1672 return new_freq;
1674 if (policy->cur != new_freq) {
1675 cpufreq_out_of_sync(policy, new_freq);
1676 if (update)
1677 schedule_work(&policy->update);
1680 return new_freq;
1684 * cpufreq_quick_get - get the CPU frequency (in kHz) from policy->cur
1685 * @cpu: CPU number
1687 * This is the last known freq, without actually getting it from the driver.
1688 * Return value will be same as what is shown in scaling_cur_freq in sysfs.
1690 unsigned int cpufreq_quick_get(unsigned int cpu)
1692 struct cpufreq_policy *policy;
1693 unsigned int ret_freq = 0;
1694 unsigned long flags;
1696 read_lock_irqsave(&cpufreq_driver_lock, flags);
1698 if (cpufreq_driver && cpufreq_driver->setpolicy && cpufreq_driver->get) {
1699 ret_freq = cpufreq_driver->get(cpu);
1700 read_unlock_irqrestore(&cpufreq_driver_lock, flags);
1701 return ret_freq;
1704 read_unlock_irqrestore(&cpufreq_driver_lock, flags);
1706 policy = cpufreq_cpu_get(cpu);
1707 if (policy) {
1708 ret_freq = policy->cur;
1709 cpufreq_cpu_put(policy);
1712 return ret_freq;
1714 EXPORT_SYMBOL(cpufreq_quick_get);
1717 * cpufreq_quick_get_max - get the max reported CPU frequency for this CPU
1718 * @cpu: CPU number
1720 * Just return the max possible frequency for a given CPU.
1722 unsigned int cpufreq_quick_get_max(unsigned int cpu)
1724 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu);
1725 unsigned int ret_freq = 0;
1727 if (policy) {
1728 ret_freq = policy->max;
1729 cpufreq_cpu_put(policy);
1732 return ret_freq;
1734 EXPORT_SYMBOL(cpufreq_quick_get_max);
1737 * cpufreq_get_hw_max_freq - get the max hardware frequency of the CPU
1738 * @cpu: CPU number
1740 * The default return value is the max_freq field of cpuinfo.
1742 __weak unsigned int cpufreq_get_hw_max_freq(unsigned int cpu)
1744 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu);
1745 unsigned int ret_freq = 0;
1747 if (policy) {
1748 ret_freq = policy->cpuinfo.max_freq;
1749 cpufreq_cpu_put(policy);
1752 return ret_freq;
1754 EXPORT_SYMBOL(cpufreq_get_hw_max_freq);
1756 static unsigned int __cpufreq_get(struct cpufreq_policy *policy)
1758 if (unlikely(policy_is_inactive(policy)))
1759 return 0;
1761 return cpufreq_verify_current_freq(policy, true);
1765 * cpufreq_get - get the current CPU frequency (in kHz)
1766 * @cpu: CPU number
1768 * Get the CPU current (static) CPU frequency
1770 unsigned int cpufreq_get(unsigned int cpu)
1772 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu);
1773 unsigned int ret_freq = 0;
1775 if (policy) {
1776 down_read(&policy->rwsem);
1777 if (cpufreq_driver->get)
1778 ret_freq = __cpufreq_get(policy);
1779 up_read(&policy->rwsem);
1781 cpufreq_cpu_put(policy);
1784 return ret_freq;
1786 EXPORT_SYMBOL(cpufreq_get);
1788 static struct subsys_interface cpufreq_interface = {
1789 .name = "cpufreq",
1790 .subsys = &cpu_subsys,
1791 .add_dev = cpufreq_add_dev,
1792 .remove_dev = cpufreq_remove_dev,
1796 * In case platform wants some specific frequency to be configured
1797 * during suspend..
1799 int cpufreq_generic_suspend(struct cpufreq_policy *policy)
1801 int ret;
1803 if (!policy->suspend_freq) {
1804 pr_debug("%s: suspend_freq not defined\n", __func__);
1805 return 0;
1808 pr_debug("%s: Setting suspend-freq: %u\n", __func__,
1809 policy->suspend_freq);
1811 ret = __cpufreq_driver_target(policy, policy->suspend_freq,
1812 CPUFREQ_RELATION_H);
1813 if (ret)
1814 pr_err("%s: unable to set suspend-freq: %u. err: %d\n",
1815 __func__, policy->suspend_freq, ret);
1817 return ret;
1819 EXPORT_SYMBOL(cpufreq_generic_suspend);
1822 * cpufreq_suspend() - Suspend CPUFreq governors
1824 * Called during system wide Suspend/Hibernate cycles for suspending governors
1825 * as some platforms can't change frequency after this point in suspend cycle.
1826 * Because some of the devices (like: i2c, regulators, etc) they use for
1827 * changing frequency are suspended quickly after this point.
1829 void cpufreq_suspend(void)
1831 struct cpufreq_policy *policy;
1833 if (!cpufreq_driver)
1834 return;
1836 if (!has_target() && !cpufreq_driver->suspend)
1837 goto suspend;
1839 pr_debug("%s: Suspending Governors\n", __func__);
1841 for_each_active_policy(policy) {
1842 if (has_target()) {
1843 down_write(&policy->rwsem);
1844 cpufreq_stop_governor(policy);
1845 up_write(&policy->rwsem);
1848 if (cpufreq_driver->suspend && cpufreq_driver->suspend(policy))
1849 pr_err("%s: Failed to suspend driver: %s\n", __func__,
1850 cpufreq_driver->name);
1853 suspend:
1854 cpufreq_suspended = true;
1858 * cpufreq_resume() - Resume CPUFreq governors
1860 * Called during system wide Suspend/Hibernate cycle for resuming governors that
1861 * are suspended with cpufreq_suspend().
1863 void cpufreq_resume(void)
1865 struct cpufreq_policy *policy;
1866 int ret;
1868 if (!cpufreq_driver)
1869 return;
1871 if (unlikely(!cpufreq_suspended))
1872 return;
1874 cpufreq_suspended = false;
1876 if (!has_target() && !cpufreq_driver->resume)
1877 return;
1879 pr_debug("%s: Resuming Governors\n", __func__);
1881 for_each_active_policy(policy) {
1882 if (cpufreq_driver->resume && cpufreq_driver->resume(policy)) {
1883 pr_err("%s: Failed to resume driver: %p\n", __func__,
1884 policy);
1885 } else if (has_target()) {
1886 down_write(&policy->rwsem);
1887 ret = cpufreq_start_governor(policy);
1888 up_write(&policy->rwsem);
1890 if (ret)
1891 pr_err("%s: Failed to start governor for policy: %p\n",
1892 __func__, policy);
1898 * cpufreq_get_current_driver - return current driver's name
1900 * Return the name string of the currently loaded cpufreq driver
1901 * or NULL, if none.
1903 const char *cpufreq_get_current_driver(void)
1905 if (cpufreq_driver)
1906 return cpufreq_driver->name;
1908 return NULL;
1910 EXPORT_SYMBOL_GPL(cpufreq_get_current_driver);
1913 * cpufreq_get_driver_data - return current driver data
1915 * Return the private data of the currently loaded cpufreq
1916 * driver, or NULL if no cpufreq driver is loaded.
1918 void *cpufreq_get_driver_data(void)
1920 if (cpufreq_driver)
1921 return cpufreq_driver->driver_data;
1923 return NULL;
1925 EXPORT_SYMBOL_GPL(cpufreq_get_driver_data);
1927 /*********************************************************************
1928 * NOTIFIER LISTS INTERFACE *
1929 *********************************************************************/
1932 * cpufreq_register_notifier - register a driver with cpufreq
1933 * @nb: notifier function to register
1934 * @list: CPUFREQ_TRANSITION_NOTIFIER or CPUFREQ_POLICY_NOTIFIER
1936 * Add a driver to one of two lists: either a list of drivers that
1937 * are notified about clock rate changes (once before and once after
1938 * the transition), or a list of drivers that are notified about
1939 * changes in cpufreq policy.
1941 * This function may sleep, and has the same return conditions as
1942 * blocking_notifier_chain_register.
1944 int cpufreq_register_notifier(struct notifier_block *nb, unsigned int list)
1946 int ret;
1948 if (cpufreq_disabled())
1949 return -EINVAL;
1951 switch (list) {
1952 case CPUFREQ_TRANSITION_NOTIFIER:
1953 mutex_lock(&cpufreq_fast_switch_lock);
1955 if (cpufreq_fast_switch_count > 0) {
1956 mutex_unlock(&cpufreq_fast_switch_lock);
1957 return -EBUSY;
1959 ret = srcu_notifier_chain_register(
1960 &cpufreq_transition_notifier_list, nb);
1961 if (!ret)
1962 cpufreq_fast_switch_count--;
1964 mutex_unlock(&cpufreq_fast_switch_lock);
1965 break;
1966 case CPUFREQ_POLICY_NOTIFIER:
1967 ret = blocking_notifier_chain_register(
1968 &cpufreq_policy_notifier_list, nb);
1969 break;
1970 default:
1971 ret = -EINVAL;
1974 return ret;
1976 EXPORT_SYMBOL(cpufreq_register_notifier);
1979 * cpufreq_unregister_notifier - unregister a driver with cpufreq
1980 * @nb: notifier block to be unregistered
1981 * @list: CPUFREQ_TRANSITION_NOTIFIER or CPUFREQ_POLICY_NOTIFIER
1983 * Remove a driver from the CPU frequency notifier list.
1985 * This function may sleep, and has the same return conditions as
1986 * blocking_notifier_chain_unregister.
1988 int cpufreq_unregister_notifier(struct notifier_block *nb, unsigned int list)
1990 int ret;
1992 if (cpufreq_disabled())
1993 return -EINVAL;
1995 switch (list) {
1996 case CPUFREQ_TRANSITION_NOTIFIER:
1997 mutex_lock(&cpufreq_fast_switch_lock);
1999 ret = srcu_notifier_chain_unregister(
2000 &cpufreq_transition_notifier_list, nb);
2001 if (!ret && !WARN_ON(cpufreq_fast_switch_count >= 0))
2002 cpufreq_fast_switch_count++;
2004 mutex_unlock(&cpufreq_fast_switch_lock);
2005 break;
2006 case CPUFREQ_POLICY_NOTIFIER:
2007 ret = blocking_notifier_chain_unregister(
2008 &cpufreq_policy_notifier_list, nb);
2009 break;
2010 default:
2011 ret = -EINVAL;
2014 return ret;
2016 EXPORT_SYMBOL(cpufreq_unregister_notifier);
2019 /*********************************************************************
2020 * GOVERNORS *
2021 *********************************************************************/
2024 * cpufreq_driver_fast_switch - Carry out a fast CPU frequency switch.
2025 * @policy: cpufreq policy to switch the frequency for.
2026 * @target_freq: New frequency to set (may be approximate).
2028 * Carry out a fast frequency switch without sleeping.
2030 * The driver's ->fast_switch() callback invoked by this function must be
2031 * suitable for being called from within RCU-sched read-side critical sections
2032 * and it is expected to select the minimum available frequency greater than or
2033 * equal to @target_freq (CPUFREQ_RELATION_L).
2035 * This function must not be called if policy->fast_switch_enabled is unset.
2037 * Governors calling this function must guarantee that it will never be invoked
2038 * twice in parallel for the same policy and that it will never be called in
2039 * parallel with either ->target() or ->target_index() for the same policy.
2041 * Returns the actual frequency set for the CPU.
2043 * If 0 is returned by the driver's ->fast_switch() callback to indicate an
2044 * error condition, the hardware configuration must be preserved.
2046 unsigned int cpufreq_driver_fast_switch(struct cpufreq_policy *policy,
2047 unsigned int target_freq)
2049 target_freq = clamp_val(target_freq, policy->min, policy->max);
2051 return cpufreq_driver->fast_switch(policy, target_freq);
2053 EXPORT_SYMBOL_GPL(cpufreq_driver_fast_switch);
2055 /* Must set freqs->new to intermediate frequency */
2056 static int __target_intermediate(struct cpufreq_policy *policy,
2057 struct cpufreq_freqs *freqs, int index)
2059 int ret;
2061 freqs->new = cpufreq_driver->get_intermediate(policy, index);
2063 /* We don't need to switch to intermediate freq */
2064 if (!freqs->new)
2065 return 0;
2067 pr_debug("%s: cpu: %d, switching to intermediate freq: oldfreq: %u, intermediate freq: %u\n",
2068 __func__, policy->cpu, freqs->old, freqs->new);
2070 cpufreq_freq_transition_begin(policy, freqs);
2071 ret = cpufreq_driver->target_intermediate(policy, index);
2072 cpufreq_freq_transition_end(policy, freqs, ret);
2074 if (ret)
2075 pr_err("%s: Failed to change to intermediate frequency: %d\n",
2076 __func__, ret);
2078 return ret;
2081 static int __target_index(struct cpufreq_policy *policy, int index)
2083 struct cpufreq_freqs freqs = {.old = policy->cur, .flags = 0};
2084 unsigned int intermediate_freq = 0;
2085 unsigned int newfreq = policy->freq_table[index].frequency;
2086 int retval = -EINVAL;
2087 bool notify;
2089 if (newfreq == policy->cur)
2090 return 0;
2092 notify = !(cpufreq_driver->flags & CPUFREQ_ASYNC_NOTIFICATION);
2093 if (notify) {
2094 /* Handle switching to intermediate frequency */
2095 if (cpufreq_driver->get_intermediate) {
2096 retval = __target_intermediate(policy, &freqs, index);
2097 if (retval)
2098 return retval;
2100 intermediate_freq = freqs.new;
2101 /* Set old freq to intermediate */
2102 if (intermediate_freq)
2103 freqs.old = freqs.new;
2106 freqs.new = newfreq;
2107 pr_debug("%s: cpu: %d, oldfreq: %u, new freq: %u\n",
2108 __func__, policy->cpu, freqs.old, freqs.new);
2110 cpufreq_freq_transition_begin(policy, &freqs);
2113 retval = cpufreq_driver->target_index(policy, index);
2114 if (retval)
2115 pr_err("%s: Failed to change cpu frequency: %d\n", __func__,
2116 retval);
2118 if (notify) {
2119 cpufreq_freq_transition_end(policy, &freqs, retval);
2122 * Failed after setting to intermediate freq? Driver should have
2123 * reverted back to initial frequency and so should we. Check
2124 * here for intermediate_freq instead of get_intermediate, in
2125 * case we haven't switched to intermediate freq at all.
2127 if (unlikely(retval && intermediate_freq)) {
2128 freqs.old = intermediate_freq;
2129 freqs.new = policy->restore_freq;
2130 cpufreq_freq_transition_begin(policy, &freqs);
2131 cpufreq_freq_transition_end(policy, &freqs, 0);
2135 return retval;
2138 int __cpufreq_driver_target(struct cpufreq_policy *policy,
2139 unsigned int target_freq,
2140 unsigned int relation)
2142 unsigned int old_target_freq = target_freq;
2143 int index;
2145 if (cpufreq_disabled())
2146 return -ENODEV;
2148 /* Make sure that target_freq is within supported range */
2149 target_freq = clamp_val(target_freq, policy->min, policy->max);
2151 pr_debug("target for CPU %u: %u kHz, relation %u, requested %u kHz\n",
2152 policy->cpu, target_freq, relation, old_target_freq);
2155 * This might look like a redundant call as we are checking it again
2156 * after finding index. But it is left intentionally for cases where
2157 * exactly same freq is called again and so we can save on few function
2158 * calls.
2160 if (target_freq == policy->cur)
2161 return 0;
2163 /* Save last value to restore later on errors */
2164 policy->restore_freq = policy->cur;
2166 if (cpufreq_driver->target)
2167 return cpufreq_driver->target(policy, target_freq, relation);
2169 if (!cpufreq_driver->target_index)
2170 return -EINVAL;
2172 index = cpufreq_frequency_table_target(policy, target_freq, relation);
2174 return __target_index(policy, index);
2176 EXPORT_SYMBOL_GPL(__cpufreq_driver_target);
2178 int cpufreq_driver_target(struct cpufreq_policy *policy,
2179 unsigned int target_freq,
2180 unsigned int relation)
2182 int ret;
2184 down_write(&policy->rwsem);
2186 ret = __cpufreq_driver_target(policy, target_freq, relation);
2188 up_write(&policy->rwsem);
2190 return ret;
2192 EXPORT_SYMBOL_GPL(cpufreq_driver_target);
2194 __weak struct cpufreq_governor *cpufreq_fallback_governor(void)
2196 return NULL;
2199 static int cpufreq_init_governor(struct cpufreq_policy *policy)
2201 int ret;
2203 /* Don't start any governor operations if we are entering suspend */
2204 if (cpufreq_suspended)
2205 return 0;
2207 * Governor might not be initiated here if ACPI _PPC changed
2208 * notification happened, so check it.
2210 if (!policy->governor)
2211 return -EINVAL;
2213 /* Platform doesn't want dynamic frequency switching ? */
2214 if (policy->governor->dynamic_switching &&
2215 cpufreq_driver->flags & CPUFREQ_NO_AUTO_DYNAMIC_SWITCHING) {
2216 struct cpufreq_governor *gov = cpufreq_fallback_governor();
2218 if (gov) {
2219 pr_warn("Can't use %s governor as dynamic switching is disallowed. Fallback to %s governor\n",
2220 policy->governor->name, gov->name);
2221 policy->governor = gov;
2222 } else {
2223 return -EINVAL;
2227 if (!try_module_get(policy->governor->owner))
2228 return -EINVAL;
2230 pr_debug("%s: for CPU %u\n", __func__, policy->cpu);
2232 if (policy->governor->init) {
2233 ret = policy->governor->init(policy);
2234 if (ret) {
2235 module_put(policy->governor->owner);
2236 return ret;
2240 return 0;
2243 static void cpufreq_exit_governor(struct cpufreq_policy *policy)
2245 if (cpufreq_suspended || !policy->governor)
2246 return;
2248 pr_debug("%s: for CPU %u\n", __func__, policy->cpu);
2250 if (policy->governor->exit)
2251 policy->governor->exit(policy);
2253 module_put(policy->governor->owner);
2256 static int cpufreq_start_governor(struct cpufreq_policy *policy)
2258 int ret;
2260 if (cpufreq_suspended)
2261 return 0;
2263 if (!policy->governor)
2264 return -EINVAL;
2266 pr_debug("%s: for CPU %u\n", __func__, policy->cpu);
2268 if (cpufreq_driver->get)
2269 cpufreq_verify_current_freq(policy, false);
2271 if (policy->governor->start) {
2272 ret = policy->governor->start(policy);
2273 if (ret)
2274 return ret;
2277 if (policy->governor->limits)
2278 policy->governor->limits(policy);
2280 return 0;
2283 static void cpufreq_stop_governor(struct cpufreq_policy *policy)
2285 if (cpufreq_suspended || !policy->governor)
2286 return;
2288 pr_debug("%s: for CPU %u\n", __func__, policy->cpu);
2290 if (policy->governor->stop)
2291 policy->governor->stop(policy);
2294 static void cpufreq_governor_limits(struct cpufreq_policy *policy)
2296 if (cpufreq_suspended || !policy->governor)
2297 return;
2299 pr_debug("%s: for CPU %u\n", __func__, policy->cpu);
2301 if (policy->governor->limits)
2302 policy->governor->limits(policy);
2305 int cpufreq_register_governor(struct cpufreq_governor *governor)
2307 int err;
2309 if (!governor)
2310 return -EINVAL;
2312 if (cpufreq_disabled())
2313 return -ENODEV;
2315 mutex_lock(&cpufreq_governor_mutex);
2317 err = -EBUSY;
2318 if (!find_governor(governor->name)) {
2319 err = 0;
2320 list_add(&governor->governor_list, &cpufreq_governor_list);
2323 mutex_unlock(&cpufreq_governor_mutex);
2324 return err;
2326 EXPORT_SYMBOL_GPL(cpufreq_register_governor);
2328 void cpufreq_unregister_governor(struct cpufreq_governor *governor)
2330 struct cpufreq_policy *policy;
2331 unsigned long flags;
2333 if (!governor)
2334 return;
2336 if (cpufreq_disabled())
2337 return;
2339 /* clear last_governor for all inactive policies */
2340 read_lock_irqsave(&cpufreq_driver_lock, flags);
2341 for_each_inactive_policy(policy) {
2342 if (!strcmp(policy->last_governor, governor->name)) {
2343 policy->governor = NULL;
2344 strcpy(policy->last_governor, "\0");
2347 read_unlock_irqrestore(&cpufreq_driver_lock, flags);
2349 mutex_lock(&cpufreq_governor_mutex);
2350 list_del(&governor->governor_list);
2351 mutex_unlock(&cpufreq_governor_mutex);
2353 EXPORT_SYMBOL_GPL(cpufreq_unregister_governor);
2356 /*********************************************************************
2357 * POLICY INTERFACE *
2358 *********************************************************************/
2361 * cpufreq_get_policy - get the current cpufreq_policy
2362 * @policy: struct cpufreq_policy into which the current cpufreq_policy
2363 * is written
2365 * Reads the current cpufreq policy.
2367 int cpufreq_get_policy(struct cpufreq_policy *policy, unsigned int cpu)
2369 struct cpufreq_policy *cpu_policy;
2370 if (!policy)
2371 return -EINVAL;
2373 cpu_policy = cpufreq_cpu_get(cpu);
2374 if (!cpu_policy)
2375 return -EINVAL;
2377 memcpy(policy, cpu_policy, sizeof(*policy));
2379 cpufreq_cpu_put(cpu_policy);
2380 return 0;
2382 EXPORT_SYMBOL(cpufreq_get_policy);
2385 * cpufreq_set_policy - Modify cpufreq policy parameters.
2386 * @policy: Policy object to modify.
2387 * @new_gov: Policy governor pointer.
2388 * @new_pol: Policy value (for drivers with built-in governors).
2390 * Invoke the cpufreq driver's ->verify() callback to sanity-check the frequency
2391 * limits to be set for the policy, update @policy with the verified limits
2392 * values and either invoke the driver's ->setpolicy() callback (if present) or
2393 * carry out a governor update for @policy. That is, run the current governor's
2394 * ->limits() callback (if @new_gov points to the same object as the one in
2395 * @policy) or replace the governor for @policy with @new_gov.
2397 * The cpuinfo part of @policy is not updated by this function.
2399 static int cpufreq_set_policy(struct cpufreq_policy *policy,
2400 struct cpufreq_governor *new_gov,
2401 unsigned int new_pol)
2403 struct cpufreq_policy_data new_data;
2404 struct cpufreq_governor *old_gov;
2405 int ret;
2407 memcpy(&new_data.cpuinfo, &policy->cpuinfo, sizeof(policy->cpuinfo));
2408 new_data.freq_table = policy->freq_table;
2409 new_data.cpu = policy->cpu;
2411 * PM QoS framework collects all the requests from users and provide us
2412 * the final aggregated value here.
2414 new_data.min = freq_qos_read_value(&policy->constraints, FREQ_QOS_MIN);
2415 new_data.max = freq_qos_read_value(&policy->constraints, FREQ_QOS_MAX);
2417 pr_debug("setting new policy for CPU %u: %u - %u kHz\n",
2418 new_data.cpu, new_data.min, new_data.max);
2421 * Verify that the CPU speed can be set within these limits and make sure
2422 * that min <= max.
2424 ret = cpufreq_driver->verify(&new_data);
2425 if (ret)
2426 return ret;
2428 policy->min = new_data.min;
2429 policy->max = new_data.max;
2430 trace_cpu_frequency_limits(policy);
2432 policy->cached_target_freq = UINT_MAX;
2434 pr_debug("new min and max freqs are %u - %u kHz\n",
2435 policy->min, policy->max);
2437 if (cpufreq_driver->setpolicy) {
2438 policy->policy = new_pol;
2439 pr_debug("setting range\n");
2440 return cpufreq_driver->setpolicy(policy);
2443 if (new_gov == policy->governor) {
2444 pr_debug("governor limits update\n");
2445 cpufreq_governor_limits(policy);
2446 return 0;
2449 pr_debug("governor switch\n");
2451 /* save old, working values */
2452 old_gov = policy->governor;
2453 /* end old governor */
2454 if (old_gov) {
2455 cpufreq_stop_governor(policy);
2456 cpufreq_exit_governor(policy);
2459 /* start new governor */
2460 policy->governor = new_gov;
2461 ret = cpufreq_init_governor(policy);
2462 if (!ret) {
2463 ret = cpufreq_start_governor(policy);
2464 if (!ret) {
2465 pr_debug("governor change\n");
2466 sched_cpufreq_governor_change(policy, old_gov);
2467 return 0;
2469 cpufreq_exit_governor(policy);
2472 /* new governor failed, so re-start old one */
2473 pr_debug("starting governor %s failed\n", policy->governor->name);
2474 if (old_gov) {
2475 policy->governor = old_gov;
2476 if (cpufreq_init_governor(policy))
2477 policy->governor = NULL;
2478 else
2479 cpufreq_start_governor(policy);
2482 return ret;
2486 * cpufreq_update_policy - Re-evaluate an existing cpufreq policy.
2487 * @cpu: CPU to re-evaluate the policy for.
2489 * Update the current frequency for the cpufreq policy of @cpu and use
2490 * cpufreq_set_policy() to re-apply the min and max limits, which triggers the
2491 * evaluation of policy notifiers and the cpufreq driver's ->verify() callback
2492 * for the policy in question, among other things.
2494 void cpufreq_update_policy(unsigned int cpu)
2496 struct cpufreq_policy *policy = cpufreq_cpu_acquire(cpu);
2498 if (!policy)
2499 return;
2502 * BIOS might change freq behind our back
2503 * -> ask driver for current freq and notify governors about a change
2505 if (cpufreq_driver->get && has_target() &&
2506 (cpufreq_suspended || WARN_ON(!cpufreq_verify_current_freq(policy, false))))
2507 goto unlock;
2509 refresh_frequency_limits(policy);
2511 unlock:
2512 cpufreq_cpu_release(policy);
2514 EXPORT_SYMBOL(cpufreq_update_policy);
2517 * cpufreq_update_limits - Update policy limits for a given CPU.
2518 * @cpu: CPU to update the policy limits for.
2520 * Invoke the driver's ->update_limits callback if present or call
2521 * cpufreq_update_policy() for @cpu.
2523 void cpufreq_update_limits(unsigned int cpu)
2525 if (cpufreq_driver->update_limits)
2526 cpufreq_driver->update_limits(cpu);
2527 else
2528 cpufreq_update_policy(cpu);
2530 EXPORT_SYMBOL_GPL(cpufreq_update_limits);
2532 /*********************************************************************
2533 * BOOST *
2534 *********************************************************************/
2535 static int cpufreq_boost_set_sw(int state)
2537 struct cpufreq_policy *policy;
2538 int ret = -EINVAL;
2540 for_each_active_policy(policy) {
2541 if (!policy->freq_table)
2542 continue;
2544 ret = cpufreq_frequency_table_cpuinfo(policy,
2545 policy->freq_table);
2546 if (ret) {
2547 pr_err("%s: Policy frequency update failed\n",
2548 __func__);
2549 break;
2552 ret = freq_qos_update_request(policy->max_freq_req, policy->max);
2553 if (ret < 0)
2554 break;
2557 return ret;
2560 int cpufreq_boost_trigger_state(int state)
2562 unsigned long flags;
2563 int ret = 0;
2565 if (cpufreq_driver->boost_enabled == state)
2566 return 0;
2568 write_lock_irqsave(&cpufreq_driver_lock, flags);
2569 cpufreq_driver->boost_enabled = state;
2570 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2572 ret = cpufreq_driver->set_boost(state);
2573 if (ret) {
2574 write_lock_irqsave(&cpufreq_driver_lock, flags);
2575 cpufreq_driver->boost_enabled = !state;
2576 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2578 pr_err("%s: Cannot %s BOOST\n",
2579 __func__, state ? "enable" : "disable");
2582 return ret;
2585 static bool cpufreq_boost_supported(void)
2587 return cpufreq_driver->set_boost;
2590 static int create_boost_sysfs_file(void)
2592 int ret;
2594 ret = sysfs_create_file(cpufreq_global_kobject, &boost.attr);
2595 if (ret)
2596 pr_err("%s: cannot register global BOOST sysfs file\n",
2597 __func__);
2599 return ret;
2602 static void remove_boost_sysfs_file(void)
2604 if (cpufreq_boost_supported())
2605 sysfs_remove_file(cpufreq_global_kobject, &boost.attr);
2608 int cpufreq_enable_boost_support(void)
2610 if (!cpufreq_driver)
2611 return -EINVAL;
2613 if (cpufreq_boost_supported())
2614 return 0;
2616 cpufreq_driver->set_boost = cpufreq_boost_set_sw;
2618 /* This will get removed on driver unregister */
2619 return create_boost_sysfs_file();
2621 EXPORT_SYMBOL_GPL(cpufreq_enable_boost_support);
2623 int cpufreq_boost_enabled(void)
2625 return cpufreq_driver->boost_enabled;
2627 EXPORT_SYMBOL_GPL(cpufreq_boost_enabled);
2629 /*********************************************************************
2630 * REGISTER / UNREGISTER CPUFREQ DRIVER *
2631 *********************************************************************/
2632 static enum cpuhp_state hp_online;
2634 static int cpuhp_cpufreq_online(unsigned int cpu)
2636 cpufreq_online(cpu);
2638 return 0;
2641 static int cpuhp_cpufreq_offline(unsigned int cpu)
2643 cpufreq_offline(cpu);
2645 return 0;
2649 * cpufreq_register_driver - register a CPU Frequency driver
2650 * @driver_data: A struct cpufreq_driver containing the values#
2651 * submitted by the CPU Frequency driver.
2653 * Registers a CPU Frequency driver to this core code. This code
2654 * returns zero on success, -EEXIST when another driver got here first
2655 * (and isn't unregistered in the meantime).
2658 int cpufreq_register_driver(struct cpufreq_driver *driver_data)
2660 unsigned long flags;
2661 int ret;
2663 if (cpufreq_disabled())
2664 return -ENODEV;
2667 * The cpufreq core depends heavily on the availability of device
2668 * structure, make sure they are available before proceeding further.
2670 if (!get_cpu_device(0))
2671 return -EPROBE_DEFER;
2673 if (!driver_data || !driver_data->verify || !driver_data->init ||
2674 !(driver_data->setpolicy || driver_data->target_index ||
2675 driver_data->target) ||
2676 (driver_data->setpolicy && (driver_data->target_index ||
2677 driver_data->target)) ||
2678 (!driver_data->get_intermediate != !driver_data->target_intermediate) ||
2679 (!driver_data->online != !driver_data->offline))
2680 return -EINVAL;
2682 pr_debug("trying to register driver %s\n", driver_data->name);
2684 /* Protect against concurrent CPU online/offline. */
2685 cpus_read_lock();
2687 write_lock_irqsave(&cpufreq_driver_lock, flags);
2688 if (cpufreq_driver) {
2689 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2690 ret = -EEXIST;
2691 goto out;
2693 cpufreq_driver = driver_data;
2694 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2696 if (driver_data->setpolicy)
2697 driver_data->flags |= CPUFREQ_CONST_LOOPS;
2699 if (cpufreq_boost_supported()) {
2700 ret = create_boost_sysfs_file();
2701 if (ret)
2702 goto err_null_driver;
2705 ret = subsys_interface_register(&cpufreq_interface);
2706 if (ret)
2707 goto err_boost_unreg;
2709 if (!(cpufreq_driver->flags & CPUFREQ_STICKY) &&
2710 list_empty(&cpufreq_policy_list)) {
2711 /* if all ->init() calls failed, unregister */
2712 ret = -ENODEV;
2713 pr_debug("%s: No CPU initialized for driver %s\n", __func__,
2714 driver_data->name);
2715 goto err_if_unreg;
2718 ret = cpuhp_setup_state_nocalls_cpuslocked(CPUHP_AP_ONLINE_DYN,
2719 "cpufreq:online",
2720 cpuhp_cpufreq_online,
2721 cpuhp_cpufreq_offline);
2722 if (ret < 0)
2723 goto err_if_unreg;
2724 hp_online = ret;
2725 ret = 0;
2727 pr_debug("driver %s up and running\n", driver_data->name);
2728 goto out;
2730 err_if_unreg:
2731 subsys_interface_unregister(&cpufreq_interface);
2732 err_boost_unreg:
2733 remove_boost_sysfs_file();
2734 err_null_driver:
2735 write_lock_irqsave(&cpufreq_driver_lock, flags);
2736 cpufreq_driver = NULL;
2737 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2738 out:
2739 cpus_read_unlock();
2740 return ret;
2742 EXPORT_SYMBOL_GPL(cpufreq_register_driver);
2745 * cpufreq_unregister_driver - unregister the current CPUFreq driver
2747 * Unregister the current CPUFreq driver. Only call this if you have
2748 * the right to do so, i.e. if you have succeeded in initialising before!
2749 * Returns zero if successful, and -EINVAL if the cpufreq_driver is
2750 * currently not initialised.
2752 int cpufreq_unregister_driver(struct cpufreq_driver *driver)
2754 unsigned long flags;
2756 if (!cpufreq_driver || (driver != cpufreq_driver))
2757 return -EINVAL;
2759 pr_debug("unregistering driver %s\n", driver->name);
2761 /* Protect against concurrent cpu hotplug */
2762 cpus_read_lock();
2763 subsys_interface_unregister(&cpufreq_interface);
2764 remove_boost_sysfs_file();
2765 cpuhp_remove_state_nocalls_cpuslocked(hp_online);
2767 write_lock_irqsave(&cpufreq_driver_lock, flags);
2769 cpufreq_driver = NULL;
2771 write_unlock_irqrestore(&cpufreq_driver_lock, flags);
2772 cpus_read_unlock();
2774 return 0;
2776 EXPORT_SYMBOL_GPL(cpufreq_unregister_driver);
2778 static int __init cpufreq_core_init(void)
2780 if (cpufreq_disabled())
2781 return -ENODEV;
2783 cpufreq_global_kobject = kobject_create_and_add("cpufreq", &cpu_subsys.dev_root->kobj);
2784 BUG_ON(!cpufreq_global_kobject);
2786 return 0;
2788 module_param(off, int, 0444);
2789 core_initcall(cpufreq_core_init);