2 * drivers/cpufreq/cpufreq_ondemand.c
4 * Copyright (C) 2001 Russell King
5 * (C) 2003 Venkatesh Pallipadi <venkatesh.pallipadi@intel.com>.
6 * Jun Nakajima <jun.nakajima@intel.com>
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/cpu.h>
16 #include <linux/percpu-defs.h>
17 #include <linux/slab.h>
18 #include <linux/tick.h>
20 #include "cpufreq_ondemand.h"
22 /* On-demand governor macros */
23 #define DEF_FREQUENCY_UP_THRESHOLD (80)
24 #define DEF_SAMPLING_DOWN_FACTOR (1)
25 #define MAX_SAMPLING_DOWN_FACTOR (100000)
26 #define MICRO_FREQUENCY_UP_THRESHOLD (95)
27 #define MICRO_FREQUENCY_MIN_SAMPLE_RATE (10000)
28 #define MIN_FREQUENCY_UP_THRESHOLD (11)
29 #define MAX_FREQUENCY_UP_THRESHOLD (100)
31 static struct od_ops od_ops
;
33 static unsigned int default_powersave_bias
;
36 * Not all CPUs want IO time to be accounted as busy; this depends on how
37 * efficient idling at a higher frequency/voltage is.
38 * Pavel Machek says this is not so for various generations of AMD and old
40 * Mike Chan (android.com) claims this is also not true for ARM.
41 * Because of this, whitelist specific known (series) of CPUs by default, and
42 * leave all others up to the user.
44 static int should_io_be_busy(void)
46 #if defined(CONFIG_X86)
48 * For Intel, Core 2 (model 15) and later have an efficient idle.
50 if (boot_cpu_data
.x86_vendor
== X86_VENDOR_INTEL
&&
51 boot_cpu_data
.x86
== 6 &&
52 boot_cpu_data
.x86_model
>= 15)
59 * Find right freq to be set now with powersave_bias on.
60 * Returns the freq_hi to be used right now and will set freq_hi_delay_us,
61 * freq_lo, and freq_lo_delay_us in percpu area for averaging freqs.
63 static unsigned int generic_powersave_bias_target(struct cpufreq_policy
*policy
,
64 unsigned int freq_next
, unsigned int relation
)
66 unsigned int freq_req
, freq_reduc
, freq_avg
;
67 unsigned int freq_hi
, freq_lo
;
69 unsigned int delay_hi_us
;
70 struct policy_dbs_info
*policy_dbs
= policy
->governor_data
;
71 struct od_policy_dbs_info
*dbs_info
= to_dbs_info(policy_dbs
);
72 struct dbs_data
*dbs_data
= policy_dbs
->dbs_data
;
73 struct od_dbs_tuners
*od_tuners
= dbs_data
->tuners
;
74 struct cpufreq_frequency_table
*freq_table
= policy
->freq_table
;
77 dbs_info
->freq_lo
= 0;
78 dbs_info
->freq_lo_delay_us
= 0;
82 index
= cpufreq_frequency_table_target(policy
, freq_next
, relation
);
83 freq_req
= freq_table
[index
].frequency
;
84 freq_reduc
= freq_req
* od_tuners
->powersave_bias
/ 1000;
85 freq_avg
= freq_req
- freq_reduc
;
87 /* Find freq bounds for freq_avg in freq_table */
88 index
= cpufreq_table_find_index_h(policy
, freq_avg
);
89 freq_lo
= freq_table
[index
].frequency
;
90 index
= cpufreq_table_find_index_l(policy
, freq_avg
);
91 freq_hi
= freq_table
[index
].frequency
;
93 /* Find out how long we have to be in hi and lo freqs */
94 if (freq_hi
== freq_lo
) {
95 dbs_info
->freq_lo
= 0;
96 dbs_info
->freq_lo_delay_us
= 0;
99 delay_hi_us
= (freq_avg
- freq_lo
) * dbs_data
->sampling_rate
;
100 delay_hi_us
+= (freq_hi
- freq_lo
) / 2;
101 delay_hi_us
/= freq_hi
- freq_lo
;
102 dbs_info
->freq_hi_delay_us
= delay_hi_us
;
103 dbs_info
->freq_lo
= freq_lo
;
104 dbs_info
->freq_lo_delay_us
= dbs_data
->sampling_rate
- delay_hi_us
;
108 static void ondemand_powersave_bias_init(struct cpufreq_policy
*policy
)
110 struct od_policy_dbs_info
*dbs_info
= to_dbs_info(policy
->governor_data
);
112 dbs_info
->freq_lo
= 0;
115 static void dbs_freq_increase(struct cpufreq_policy
*policy
, unsigned int freq
)
117 struct policy_dbs_info
*policy_dbs
= policy
->governor_data
;
118 struct dbs_data
*dbs_data
= policy_dbs
->dbs_data
;
119 struct od_dbs_tuners
*od_tuners
= dbs_data
->tuners
;
121 if (od_tuners
->powersave_bias
)
122 freq
= od_ops
.powersave_bias_target(policy
, freq
,
124 else if (policy
->cur
== policy
->max
)
127 __cpufreq_driver_target(policy
, freq
, od_tuners
->powersave_bias
?
128 CPUFREQ_RELATION_L
: CPUFREQ_RELATION_H
);
132 * Every sampling_rate, we check, if current idle time is less than 20%
133 * (default), then we try to increase frequency. Else, we adjust the frequency
134 * proportional to load.
136 static void od_update(struct cpufreq_policy
*policy
)
138 struct policy_dbs_info
*policy_dbs
= policy
->governor_data
;
139 struct od_policy_dbs_info
*dbs_info
= to_dbs_info(policy_dbs
);
140 struct dbs_data
*dbs_data
= policy_dbs
->dbs_data
;
141 struct od_dbs_tuners
*od_tuners
= dbs_data
->tuners
;
142 unsigned int load
= dbs_update(policy
);
144 dbs_info
->freq_lo
= 0;
146 /* Check for frequency increase */
147 if (load
> dbs_data
->up_threshold
) {
148 /* If switching to max speed, apply sampling_down_factor */
149 if (policy
->cur
< policy
->max
)
150 policy_dbs
->rate_mult
= dbs_data
->sampling_down_factor
;
151 dbs_freq_increase(policy
, policy
->max
);
153 /* Calculate the next frequency proportional to load */
154 unsigned int freq_next
, min_f
, max_f
;
156 min_f
= policy
->cpuinfo
.min_freq
;
157 max_f
= policy
->cpuinfo
.max_freq
;
158 freq_next
= min_f
+ load
* (max_f
- min_f
) / 100;
160 /* No longer fully busy, reset rate_mult */
161 policy_dbs
->rate_mult
= 1;
163 if (od_tuners
->powersave_bias
)
164 freq_next
= od_ops
.powersave_bias_target(policy
,
168 __cpufreq_driver_target(policy
, freq_next
, CPUFREQ_RELATION_C
);
172 static unsigned int od_dbs_timer(struct cpufreq_policy
*policy
)
174 struct policy_dbs_info
*policy_dbs
= policy
->governor_data
;
175 struct dbs_data
*dbs_data
= policy_dbs
->dbs_data
;
176 struct od_policy_dbs_info
*dbs_info
= to_dbs_info(policy_dbs
);
177 int sample_type
= dbs_info
->sample_type
;
179 /* Common NORMAL_SAMPLE setup */
180 dbs_info
->sample_type
= OD_NORMAL_SAMPLE
;
182 * OD_SUB_SAMPLE doesn't make sense if sample_delay_ns is 0, so ignore
185 if (sample_type
== OD_SUB_SAMPLE
&& policy_dbs
->sample_delay_ns
> 0) {
186 __cpufreq_driver_target(policy
, dbs_info
->freq_lo
,
188 return dbs_info
->freq_lo_delay_us
;
193 if (dbs_info
->freq_lo
) {
194 /* Setup timer for SUB_SAMPLE */
195 dbs_info
->sample_type
= OD_SUB_SAMPLE
;
196 return dbs_info
->freq_hi_delay_us
;
199 return dbs_data
->sampling_rate
* policy_dbs
->rate_mult
;
202 /************************** sysfs interface ************************/
203 static struct dbs_governor od_dbs_gov
;
205 static ssize_t
store_io_is_busy(struct gov_attr_set
*attr_set
, const char *buf
,
208 struct dbs_data
*dbs_data
= to_dbs_data(attr_set
);
212 ret
= sscanf(buf
, "%u", &input
);
215 dbs_data
->io_is_busy
= !!input
;
217 /* we need to re-evaluate prev_cpu_idle */
218 gov_update_cpu_data(dbs_data
);
223 static ssize_t
store_up_threshold(struct gov_attr_set
*attr_set
,
224 const char *buf
, size_t count
)
226 struct dbs_data
*dbs_data
= to_dbs_data(attr_set
);
229 ret
= sscanf(buf
, "%u", &input
);
231 if (ret
!= 1 || input
> MAX_FREQUENCY_UP_THRESHOLD
||
232 input
< MIN_FREQUENCY_UP_THRESHOLD
) {
236 dbs_data
->up_threshold
= input
;
240 static ssize_t
store_sampling_down_factor(struct gov_attr_set
*attr_set
,
241 const char *buf
, size_t count
)
243 struct dbs_data
*dbs_data
= to_dbs_data(attr_set
);
244 struct policy_dbs_info
*policy_dbs
;
247 ret
= sscanf(buf
, "%u", &input
);
249 if (ret
!= 1 || input
> MAX_SAMPLING_DOWN_FACTOR
|| input
< 1)
252 dbs_data
->sampling_down_factor
= input
;
254 /* Reset down sampling multiplier in case it was active */
255 list_for_each_entry(policy_dbs
, &attr_set
->policy_list
, list
) {
257 * Doing this without locking might lead to using different
258 * rate_mult values in od_update() and od_dbs_timer().
260 mutex_lock(&policy_dbs
->timer_mutex
);
261 policy_dbs
->rate_mult
= 1;
262 mutex_unlock(&policy_dbs
->timer_mutex
);
268 static ssize_t
store_ignore_nice_load(struct gov_attr_set
*attr_set
,
269 const char *buf
, size_t count
)
271 struct dbs_data
*dbs_data
= to_dbs_data(attr_set
);
275 ret
= sscanf(buf
, "%u", &input
);
282 if (input
== dbs_data
->ignore_nice_load
) { /* nothing to do */
285 dbs_data
->ignore_nice_load
= input
;
287 /* we need to re-evaluate prev_cpu_idle */
288 gov_update_cpu_data(dbs_data
);
293 static ssize_t
store_powersave_bias(struct gov_attr_set
*attr_set
,
294 const char *buf
, size_t count
)
296 struct dbs_data
*dbs_data
= to_dbs_data(attr_set
);
297 struct od_dbs_tuners
*od_tuners
= dbs_data
->tuners
;
298 struct policy_dbs_info
*policy_dbs
;
301 ret
= sscanf(buf
, "%u", &input
);
309 od_tuners
->powersave_bias
= input
;
311 list_for_each_entry(policy_dbs
, &attr_set
->policy_list
, list
)
312 ondemand_powersave_bias_init(policy_dbs
->policy
);
317 gov_show_one_common(sampling_rate
);
318 gov_show_one_common(up_threshold
);
319 gov_show_one_common(sampling_down_factor
);
320 gov_show_one_common(ignore_nice_load
);
321 gov_show_one_common(min_sampling_rate
);
322 gov_show_one_common(io_is_busy
);
323 gov_show_one(od
, powersave_bias
);
325 gov_attr_rw(sampling_rate
);
326 gov_attr_rw(io_is_busy
);
327 gov_attr_rw(up_threshold
);
328 gov_attr_rw(sampling_down_factor
);
329 gov_attr_rw(ignore_nice_load
);
330 gov_attr_rw(powersave_bias
);
331 gov_attr_ro(min_sampling_rate
);
333 static struct attribute
*od_attributes
[] = {
334 &min_sampling_rate
.attr
,
337 &sampling_down_factor
.attr
,
338 &ignore_nice_load
.attr
,
339 &powersave_bias
.attr
,
344 /************************** sysfs end ************************/
346 static struct policy_dbs_info
*od_alloc(void)
348 struct od_policy_dbs_info
*dbs_info
;
350 dbs_info
= kzalloc(sizeof(*dbs_info
), GFP_KERNEL
);
351 return dbs_info
? &dbs_info
->policy_dbs
: NULL
;
354 static void od_free(struct policy_dbs_info
*policy_dbs
)
356 kfree(to_dbs_info(policy_dbs
));
359 static int od_init(struct dbs_data
*dbs_data
)
361 struct od_dbs_tuners
*tuners
;
365 tuners
= kzalloc(sizeof(*tuners
), GFP_KERNEL
);
370 idle_time
= get_cpu_idle_time_us(cpu
, NULL
);
372 if (idle_time
!= -1ULL) {
373 /* Idle micro accounting is supported. Use finer thresholds */
374 dbs_data
->up_threshold
= MICRO_FREQUENCY_UP_THRESHOLD
;
376 * In nohz/micro accounting case we set the minimum frequency
377 * not depending on HZ, but fixed (very low). The deferred
378 * timer might skip some samples if idle/sleeping as needed.
380 dbs_data
->min_sampling_rate
= MICRO_FREQUENCY_MIN_SAMPLE_RATE
;
382 dbs_data
->up_threshold
= DEF_FREQUENCY_UP_THRESHOLD
;
384 /* For correct statistics, we need 10 ticks for each measure */
385 dbs_data
->min_sampling_rate
= MIN_SAMPLING_RATE_RATIO
*
386 jiffies_to_usecs(10);
389 dbs_data
->sampling_down_factor
= DEF_SAMPLING_DOWN_FACTOR
;
390 dbs_data
->ignore_nice_load
= 0;
391 tuners
->powersave_bias
= default_powersave_bias
;
392 dbs_data
->io_is_busy
= should_io_be_busy();
394 dbs_data
->tuners
= tuners
;
398 static void od_exit(struct dbs_data
*dbs_data
)
400 kfree(dbs_data
->tuners
);
403 static void od_start(struct cpufreq_policy
*policy
)
405 struct od_policy_dbs_info
*dbs_info
= to_dbs_info(policy
->governor_data
);
407 dbs_info
->sample_type
= OD_NORMAL_SAMPLE
;
408 ondemand_powersave_bias_init(policy
);
411 static struct od_ops od_ops
= {
412 .powersave_bias_target
= generic_powersave_bias_target
,
415 static struct dbs_governor od_dbs_gov
= {
416 .gov
= CPUFREQ_DBS_GOVERNOR_INITIALIZER("ondemand"),
417 .kobj_type
= { .default_attrs
= od_attributes
},
418 .gov_dbs_timer
= od_dbs_timer
,
426 #define CPU_FREQ_GOV_ONDEMAND (&od_dbs_gov.gov)
428 static void od_set_powersave_bias(unsigned int powersave_bias
)
433 default_powersave_bias
= powersave_bias
;
434 cpumask_clear(&done
);
437 for_each_online_cpu(cpu
) {
438 struct cpufreq_policy
*policy
;
439 struct policy_dbs_info
*policy_dbs
;
440 struct dbs_data
*dbs_data
;
441 struct od_dbs_tuners
*od_tuners
;
443 if (cpumask_test_cpu(cpu
, &done
))
446 policy
= cpufreq_cpu_get_raw(cpu
);
447 if (!policy
|| policy
->governor
!= CPU_FREQ_GOV_ONDEMAND
)
450 policy_dbs
= policy
->governor_data
;
454 cpumask_or(&done
, &done
, policy
->cpus
);
456 dbs_data
= policy_dbs
->dbs_data
;
457 od_tuners
= dbs_data
->tuners
;
458 od_tuners
->powersave_bias
= default_powersave_bias
;
463 void od_register_powersave_bias_handler(unsigned int (*f
)
464 (struct cpufreq_policy
*, unsigned int, unsigned int),
465 unsigned int powersave_bias
)
467 od_ops
.powersave_bias_target
= f
;
468 od_set_powersave_bias(powersave_bias
);
470 EXPORT_SYMBOL_GPL(od_register_powersave_bias_handler
);
472 void od_unregister_powersave_bias_handler(void)
474 od_ops
.powersave_bias_target
= generic_powersave_bias_target
;
475 od_set_powersave_bias(0);
477 EXPORT_SYMBOL_GPL(od_unregister_powersave_bias_handler
);
479 static int __init
cpufreq_gov_dbs_init(void)
481 return cpufreq_register_governor(CPU_FREQ_GOV_ONDEMAND
);
484 static void __exit
cpufreq_gov_dbs_exit(void)
486 cpufreq_unregister_governor(CPU_FREQ_GOV_ONDEMAND
);
489 MODULE_AUTHOR("Venkatesh Pallipadi <venkatesh.pallipadi@intel.com>");
490 MODULE_AUTHOR("Alexey Starikovskiy <alexey.y.starikovskiy@intel.com>");
491 MODULE_DESCRIPTION("'cpufreq_ondemand' - A dynamic cpufreq governor for "
492 "Low Latency Frequency Transition capable processors");
493 MODULE_LICENSE("GPL");
495 #ifdef CONFIG_CPU_FREQ_DEFAULT_GOV_ONDEMAND
496 struct cpufreq_governor
*cpufreq_default_governor(void)
498 return CPU_FREQ_GOV_ONDEMAND
;
501 fs_initcall(cpufreq_gov_dbs_init
);
503 module_init(cpufreq_gov_dbs_init
);
505 module_exit(cpufreq_gov_dbs_exit
);