2 * drivers/cpufreq/cpufreq_ondemand.c
4 * Copyright (C) 2001 Russell King
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
15 #include <linux/cpufreq.h>
16 #include <linux/init.h>
17 #include <linux/kernel.h>
18 #include <linux/kernel_stat.h>
19 #include <linux/kobject.h>
20 #include <linux/module.h>
21 #include <linux/mutex.h>
22 #include <linux/percpu-defs.h>
23 #include <linux/sysfs.h>
24 #include <linux/tick.h>
25 #include <linux/types.h>
27 #include "cpufreq_governor.h"
29 /* On-demand governor macros */
30 #define DEF_FREQUENCY_DOWN_DIFFERENTIAL (10)
31 #define DEF_FREQUENCY_UP_THRESHOLD (80)
32 #define DEF_SAMPLING_DOWN_FACTOR (1)
33 #define MAX_SAMPLING_DOWN_FACTOR (100000)
34 #define MICRO_FREQUENCY_DOWN_DIFFERENTIAL (3)
35 #define MICRO_FREQUENCY_UP_THRESHOLD (95)
36 #define MICRO_FREQUENCY_MIN_SAMPLE_RATE (10000)
37 #define MIN_FREQUENCY_UP_THRESHOLD (11)
38 #define MAX_FREQUENCY_UP_THRESHOLD (100)
40 static struct dbs_data od_dbs_data;
41 static DEFINE_PER_CPU(struct od_cpu_dbs_info_s, od_cpu_dbs_info);
43 #ifndef CONFIG_CPU_FREQ_DEFAULT_GOV_ONDEMAND
44 static struct cpufreq_governor cpufreq_gov_ondemand;
47 static struct od_dbs_tuners od_tuners = {
48 .up_threshold = DEF_FREQUENCY_UP_THRESHOLD,
49 .sampling_down_factor = DEF_SAMPLING_DOWN_FACTOR,
50 .adj_up_threshold = DEF_FREQUENCY_UP_THRESHOLD -
51 DEF_FREQUENCY_DOWN_DIFFERENTIAL,
56 static void ondemand_powersave_bias_init_cpu(int cpu)
58 struct od_cpu_dbs_info_s *dbs_info = &per_cpu(od_cpu_dbs_info, cpu);
60 dbs_info->freq_table = cpufreq_frequency_get_table(cpu);
61 dbs_info->freq_lo = 0;
65 * Not all CPUs want IO time to be accounted as busy; this depends on how
66 * efficient idling at a higher frequency/voltage is.
67 * Pavel Machek says this is not so for various generations of AMD and old
69 * Mike Chan (android.com) claims this is also not true for ARM.
70 * Because of this, whitelist specific known (series) of CPUs by default, and
71 * leave all others up to the user.
73 static int should_io_be_busy(void)
75 #if defined(CONFIG_X86)
77 * For Intel, Core 2 (model 15) and later have an efficient idle.
79 if (boot_cpu_data.x86_vendor == X86_VENDOR_INTEL &&
80 boot_cpu_data.x86 == 6 &&
81 boot_cpu_data.x86_model >= 15)
88 * Find right freq to be set now with powersave_bias on.
89 * Returns the freq_hi to be used right now and will set freq_hi_jiffies,
90 * freq_lo, and freq_lo_jiffies in percpu area for averaging freqs.
92 static unsigned int powersave_bias_target(struct cpufreq_policy *policy,
93 unsigned int freq_next, unsigned int relation)
95 unsigned int freq_req, freq_reduc, freq_avg;
96 unsigned int freq_hi, freq_lo;
97 unsigned int index = 0;
98 unsigned int jiffies_total, jiffies_hi, jiffies_lo;
99 struct od_cpu_dbs_info_s *dbs_info = &per_cpu(od_cpu_dbs_info,
102 if (!dbs_info->freq_table) {
103 dbs_info->freq_lo = 0;
104 dbs_info->freq_lo_jiffies = 0;
108 cpufreq_frequency_table_target(policy, dbs_info->freq_table, freq_next,
110 freq_req = dbs_info->freq_table[index].frequency;
111 freq_reduc = freq_req * od_tuners.powersave_bias / 1000;
112 freq_avg = freq_req - freq_reduc;
114 /* Find freq bounds for freq_avg in freq_table */
116 cpufreq_frequency_table_target(policy, dbs_info->freq_table, freq_avg,
117 CPUFREQ_RELATION_H, &index);
118 freq_lo = dbs_info->freq_table[index].frequency;
120 cpufreq_frequency_table_target(policy, dbs_info->freq_table, freq_avg,
121 CPUFREQ_RELATION_L, &index);
122 freq_hi = dbs_info->freq_table[index].frequency;
124 /* Find out how long we have to be in hi and lo freqs */
125 if (freq_hi == freq_lo) {
126 dbs_info->freq_lo = 0;
127 dbs_info->freq_lo_jiffies = 0;
130 jiffies_total = usecs_to_jiffies(od_tuners.sampling_rate);
131 jiffies_hi = (freq_avg - freq_lo) * jiffies_total;
132 jiffies_hi += ((freq_hi - freq_lo) / 2);
133 jiffies_hi /= (freq_hi - freq_lo);
134 jiffies_lo = jiffies_total - jiffies_hi;
135 dbs_info->freq_lo = freq_lo;
136 dbs_info->freq_lo_jiffies = jiffies_lo;
137 dbs_info->freq_hi_jiffies = jiffies_hi;
141 static void ondemand_powersave_bias_init(void)
144 for_each_online_cpu(i) {
145 ondemand_powersave_bias_init_cpu(i);
149 static void dbs_freq_increase(struct cpufreq_policy *p, unsigned int freq)
151 if (od_tuners.powersave_bias)
152 freq = powersave_bias_target(p, freq, CPUFREQ_RELATION_H);
153 else if (p->cur == p->max)
156 __cpufreq_driver_target(p, freq, od_tuners.powersave_bias ?
157 CPUFREQ_RELATION_L : CPUFREQ_RELATION_H);
161 * Every sampling_rate, we check, if current idle time is less than 20%
162 * (default), then we try to increase frequency. Every sampling_rate, we look
163 * for the lowest frequency which can sustain the load while keeping idle time
164 * over 30%. If such a frequency exist, we try to decrease to this frequency.
166 * Any frequency increase takes it to the maximum frequency. Frequency reduction
167 * happens at minimum steps of 5% (default) of current frequency
169 static void od_check_cpu(int cpu, unsigned int load_freq)
171 struct od_cpu_dbs_info_s *dbs_info = &per_cpu(od_cpu_dbs_info, cpu);
172 struct cpufreq_policy *policy = dbs_info->cdbs.cur_policy;
174 dbs_info->freq_lo = 0;
176 /* Check for frequency increase */
177 if (load_freq > od_tuners.up_threshold * policy->cur) {
178 /* If switching to max speed, apply sampling_down_factor */
179 if (policy->cur < policy->max)
180 dbs_info->rate_mult =
181 od_tuners.sampling_down_factor;
182 dbs_freq_increase(policy, policy->max);
186 /* Check for frequency decrease */
187 /* if we cannot reduce the frequency anymore, break out early */
188 if (policy->cur == policy->min)
192 * The optimal frequency is the frequency that is the lowest that can
193 * support the current CPU usage without triggering the up policy. To be
194 * safe, we focus 10 points under the threshold.
196 if (load_freq < od_tuners.adj_up_threshold * policy->cur) {
197 unsigned int freq_next;
198 freq_next = load_freq / od_tuners.adj_up_threshold;
200 /* No longer fully busy, reset rate_mult */
201 dbs_info->rate_mult = 1;
203 if (freq_next < policy->min)
204 freq_next = policy->min;
206 if (!od_tuners.powersave_bias) {
207 __cpufreq_driver_target(policy, freq_next,
210 int freq = powersave_bias_target(policy, freq_next,
212 __cpufreq_driver_target(policy, freq,
218 static void od_dbs_timer(struct work_struct *work)
220 struct delayed_work *dw = to_delayed_work(work);
221 struct od_cpu_dbs_info_s *dbs_info =
222 container_of(work, struct od_cpu_dbs_info_s, cdbs.work.work);
223 unsigned int cpu = dbs_info->cdbs.cur_policy->cpu;
224 struct od_cpu_dbs_info_s *core_dbs_info = &per_cpu(od_cpu_dbs_info,
226 int delay, sample_type = core_dbs_info->sample_type;
229 mutex_lock(&core_dbs_info->cdbs.timer_mutex);
230 eval_load = need_load_eval(&core_dbs_info->cdbs,
231 od_tuners.sampling_rate);
233 /* Common NORMAL_SAMPLE setup */
234 core_dbs_info->sample_type = OD_NORMAL_SAMPLE;
235 if (sample_type == OD_SUB_SAMPLE) {
236 delay = core_dbs_info->freq_lo_jiffies;
238 __cpufreq_driver_target(core_dbs_info->cdbs.cur_policy,
239 core_dbs_info->freq_lo,
243 dbs_check_cpu(&od_dbs_data, cpu);
244 if (core_dbs_info->freq_lo) {
245 /* Setup timer for SUB_SAMPLE */
246 core_dbs_info->sample_type = OD_SUB_SAMPLE;
247 delay = core_dbs_info->freq_hi_jiffies;
249 delay = delay_for_sampling_rate(od_tuners.sampling_rate
250 * core_dbs_info->rate_mult);
254 schedule_delayed_work_on(smp_processor_id(), dw, delay);
255 mutex_unlock(&core_dbs_info->cdbs.timer_mutex);
258 /************************** sysfs interface ************************/
260 static ssize_t show_sampling_rate_min(struct kobject *kobj,
261 struct attribute *attr, char *buf)
263 return sprintf(buf, "%u\n", od_dbs_data.min_sampling_rate);
267 * update_sampling_rate - update sampling rate effective immediately if needed.
268 * @new_rate: new sampling rate
270 * If new rate is smaller than the old, simply updating
271 * dbs_tuners_int.sampling_rate might not be appropriate. For example, if the
272 * original sampling_rate was 1 second and the requested new sampling rate is 10
273 * ms because the user needs immediate reaction from ondemand governor, but not
274 * sure if higher frequency will be required or not, then, the governor may
275 * change the sampling rate too late; up to 1 second later. Thus, if we are
276 * reducing the sampling rate, we need to make the new value effective
279 static void update_sampling_rate(unsigned int new_rate)
283 od_tuners.sampling_rate = new_rate = max(new_rate,
284 od_dbs_data.min_sampling_rate);
286 for_each_online_cpu(cpu) {
287 struct cpufreq_policy *policy;
288 struct od_cpu_dbs_info_s *dbs_info;
289 unsigned long next_sampling, appointed_at;
291 policy = cpufreq_cpu_get(cpu);
294 if (policy->governor != &cpufreq_gov_ondemand) {
295 cpufreq_cpu_put(policy);
298 dbs_info = &per_cpu(od_cpu_dbs_info, cpu);
299 cpufreq_cpu_put(policy);
301 mutex_lock(&dbs_info->cdbs.timer_mutex);
303 if (!delayed_work_pending(&dbs_info->cdbs.work)) {
304 mutex_unlock(&dbs_info->cdbs.timer_mutex);
308 next_sampling = jiffies + usecs_to_jiffies(new_rate);
309 appointed_at = dbs_info->cdbs.work.timer.expires;
311 if (time_before(next_sampling, appointed_at)) {
313 mutex_unlock(&dbs_info->cdbs.timer_mutex);
314 cancel_delayed_work_sync(&dbs_info->cdbs.work);
315 mutex_lock(&dbs_info->cdbs.timer_mutex);
317 schedule_delayed_work_on(cpu, &dbs_info->cdbs.work,
318 usecs_to_jiffies(new_rate));
321 mutex_unlock(&dbs_info->cdbs.timer_mutex);
325 static ssize_t store_sampling_rate(struct kobject *a, struct attribute *b,
326 const char *buf, size_t count)
330 ret = sscanf(buf, "%u", &input);
333 update_sampling_rate(input);
337 static ssize_t store_io_is_busy(struct kobject *a, struct attribute *b,
338 const char *buf, size_t count)
343 ret = sscanf(buf, "%u", &input);
346 od_tuners.io_is_busy = !!input;
350 static ssize_t store_up_threshold(struct kobject *a, struct attribute *b,
351 const char *buf, size_t count)
355 ret = sscanf(buf, "%u", &input);
357 if (ret != 1 || input > MAX_FREQUENCY_UP_THRESHOLD ||
358 input < MIN_FREQUENCY_UP_THRESHOLD) {
361 /* Calculate the new adj_up_threshold */
362 od_tuners.adj_up_threshold += input;
363 od_tuners.adj_up_threshold -= od_tuners.up_threshold;
365 od_tuners.up_threshold = input;
369 static ssize_t store_sampling_down_factor(struct kobject *a,
370 struct attribute *b, const char *buf, size_t count)
372 unsigned int input, j;
374 ret = sscanf(buf, "%u", &input);
376 if (ret != 1 || input > MAX_SAMPLING_DOWN_FACTOR || input < 1)
378 od_tuners.sampling_down_factor = input;
380 /* Reset down sampling multiplier in case it was active */
381 for_each_online_cpu(j) {
382 struct od_cpu_dbs_info_s *dbs_info = &per_cpu(od_cpu_dbs_info,
384 dbs_info->rate_mult = 1;
389 static ssize_t store_ignore_nice_load(struct kobject *a, struct attribute *b,
390 const char *buf, size_t count)
397 ret = sscanf(buf, "%u", &input);
404 if (input == od_tuners.ignore_nice) { /* nothing to do */
407 od_tuners.ignore_nice = input;
409 /* we need to re-evaluate prev_cpu_idle */
410 for_each_online_cpu(j) {
411 struct od_cpu_dbs_info_s *dbs_info;
412 dbs_info = &per_cpu(od_cpu_dbs_info, j);
413 dbs_info->cdbs.prev_cpu_idle = get_cpu_idle_time(j,
414 &dbs_info->cdbs.prev_cpu_wall);
415 if (od_tuners.ignore_nice)
416 dbs_info->cdbs.prev_cpu_nice =
417 kcpustat_cpu(j).cpustat[CPUTIME_NICE];
423 static ssize_t store_powersave_bias(struct kobject *a, struct attribute *b,
424 const char *buf, size_t count)
428 ret = sscanf(buf, "%u", &input);
436 od_tuners.powersave_bias = input;
437 ondemand_powersave_bias_init();
441 show_one(od, sampling_rate, sampling_rate);
442 show_one(od, io_is_busy, io_is_busy);
443 show_one(od, up_threshold, up_threshold);
444 show_one(od, sampling_down_factor, sampling_down_factor);
445 show_one(od, ignore_nice_load, ignore_nice);
446 show_one(od, powersave_bias, powersave_bias);
448 define_one_global_rw(sampling_rate);
449 define_one_global_rw(io_is_busy);
450 define_one_global_rw(up_threshold);
451 define_one_global_rw(sampling_down_factor);
452 define_one_global_rw(ignore_nice_load);
453 define_one_global_rw(powersave_bias);
454 define_one_global_ro(sampling_rate_min);
456 static struct attribute *dbs_attributes[] = {
457 &sampling_rate_min.attr,
460 &sampling_down_factor.attr,
461 &ignore_nice_load.attr,
462 &powersave_bias.attr,
467 static struct attribute_group od_attr_group = {
468 .attrs = dbs_attributes,
472 /************************** sysfs end ************************/
474 define_get_cpu_dbs_routines(od_cpu_dbs_info);
476 static struct od_ops od_ops = {
477 .io_busy = should_io_be_busy,
478 .powersave_bias_init_cpu = ondemand_powersave_bias_init_cpu,
479 .powersave_bias_target = powersave_bias_target,
480 .freq_increase = dbs_freq_increase,
483 static struct dbs_data od_dbs_data = {
484 .governor = GOV_ONDEMAND,
485 .attr_group = &od_attr_group,
486 .tuners = &od_tuners,
487 .get_cpu_cdbs = get_cpu_cdbs,
488 .get_cpu_dbs_info_s = get_cpu_dbs_info_s,
489 .gov_dbs_timer = od_dbs_timer,
490 .gov_check_cpu = od_check_cpu,
494 static int od_cpufreq_governor_dbs(struct cpufreq_policy *policy,
497 return cpufreq_governor_dbs(&od_dbs_data, policy, event);
500 #ifndef CONFIG_CPU_FREQ_DEFAULT_GOV_ONDEMAND
503 struct cpufreq_governor cpufreq_gov_ondemand = {
505 .governor = od_cpufreq_governor_dbs,
506 .max_transition_latency = TRANSITION_LATENCY_LIMIT,
507 .owner = THIS_MODULE,
510 static int __init cpufreq_gov_dbs_init(void)
515 mutex_init(&od_dbs_data.mutex);
516 idle_time = get_cpu_idle_time_us(cpu, NULL);
518 if (idle_time != -1ULL) {
519 /* Idle micro accounting is supported. Use finer thresholds */
520 od_tuners.up_threshold = MICRO_FREQUENCY_UP_THRESHOLD;
521 od_tuners.adj_up_threshold = MICRO_FREQUENCY_UP_THRESHOLD -
522 MICRO_FREQUENCY_DOWN_DIFFERENTIAL;
524 * In nohz/micro accounting case we set the minimum frequency
525 * not depending on HZ, but fixed (very low). The deferred
526 * timer might skip some samples if idle/sleeping as needed.
528 od_dbs_data.min_sampling_rate = MICRO_FREQUENCY_MIN_SAMPLE_RATE;
530 /* For correct statistics, we need 10 ticks for each measure */
531 od_dbs_data.min_sampling_rate = MIN_SAMPLING_RATE_RATIO *
532 jiffies_to_usecs(10);
535 return cpufreq_register_governor(&cpufreq_gov_ondemand);
538 static void __exit cpufreq_gov_dbs_exit(void)
540 cpufreq_unregister_governor(&cpufreq_gov_ondemand);
545 MODULE_DESCRIPTION("'cpufreq_ondemand' - A dynamic cpufreq governor for "
546 "Low Latency Frequency Transition capable processors");
547 MODULE_LICENSE("GPL");
549 #ifdef CONFIG_CPU_FREQ_DEFAULT_GOV_ONDEMAND
550 fs_initcall(cpufreq_gov_dbs_init);
552 module_init(cpufreq_gov_dbs_init);
554 module_exit(cpufreq_gov_dbs_exit);