1
2
3
4
5
6
7
8
9
10
11#ifndef _LINUX_CPUFREQ_H
12#define _LINUX_CPUFREQ_H
13
14#include <linux/clk.h>
15#include <linux/cpumask.h>
16#include <linux/completion.h>
17#include <linux/kobject.h>
18#include <linux/notifier.h>
19#include <linux/spinlock.h>
20#include <linux/sysfs.h>
21
22
23
24
25
26
27
28
29
30
31
32#define CPUFREQ_ETERNAL (-1)
33#define CPUFREQ_NAME_LEN 16
34
35#define CPUFREQ_NAME_PLEN (CPUFREQ_NAME_LEN + 1)
36
37struct cpufreq_governor;
38
39struct cpufreq_freqs {
40 unsigned int cpu;
41 unsigned int old;
42 unsigned int new;
43 u8 flags;
44};
45
46struct cpufreq_cpuinfo {
47 unsigned int max_freq;
48 unsigned int min_freq;
49
50
51 unsigned int transition_latency;
52};
53
54struct cpufreq_user_policy {
55 unsigned int min;
56 unsigned int max;
57};
58
59struct cpufreq_policy {
60
61 cpumask_var_t cpus;
62 cpumask_var_t related_cpus;
63 cpumask_var_t real_cpus;
64
65 unsigned int shared_type;
66
67 unsigned int cpu;
68
69 struct clk *clk;
70 struct cpufreq_cpuinfo cpuinfo;
71
72 unsigned int min;
73 unsigned int max;
74 unsigned int cur;
75
76 unsigned int restore_freq;
77 unsigned int suspend_freq;
78
79 unsigned int policy;
80 unsigned int last_policy;
81 struct cpufreq_governor *governor;
82 void *governor_data;
83 char last_governor[CPUFREQ_NAME_LEN];
84
85 struct work_struct update;
86
87
88 struct cpufreq_user_policy user_policy;
89 struct cpufreq_frequency_table *freq_table;
90
91 struct list_head policy_list;
92 struct kobject kobj;
93 struct completion kobj_unregister;
94
95
96
97
98
99
100
101
102
103 struct rw_semaphore rwsem;
104
105
106 bool transition_ongoing;
107 spinlock_t transition_lock;
108 wait_queue_head_t transition_wait;
109 struct task_struct *transition_task;
110
111
112 struct cpufreq_stats *stats;
113
114
115 void *driver_data;
116};
117
118
119#define CPUFREQ_SHARED_TYPE_NONE (0)
120#define CPUFREQ_SHARED_TYPE_HW (1)
121#define CPUFREQ_SHARED_TYPE_ALL (2)
122#define CPUFREQ_SHARED_TYPE_ANY (3)
123
124#ifdef CONFIG_CPU_FREQ
125struct cpufreq_policy *cpufreq_cpu_get_raw(unsigned int cpu);
126struct cpufreq_policy *cpufreq_cpu_get(unsigned int cpu);
127void cpufreq_cpu_put(struct cpufreq_policy *policy);
128#else
129static inline struct cpufreq_policy *cpufreq_cpu_get_raw(unsigned int cpu)
130{
131 return NULL;
132}
133static inline struct cpufreq_policy *cpufreq_cpu_get(unsigned int cpu)
134{
135 return NULL;
136}
137static inline void cpufreq_cpu_put(struct cpufreq_policy *policy) { }
138#endif
139
140static inline bool policy_is_shared(struct cpufreq_policy *policy)
141{
142 return cpumask_weight(policy->cpus) > 1;
143}
144
145
146extern struct kobject *cpufreq_global_kobject;
147
148#ifdef CONFIG_CPU_FREQ
149unsigned int cpufreq_get(unsigned int cpu);
150unsigned int cpufreq_quick_get(unsigned int cpu);
151unsigned int cpufreq_quick_get_max(unsigned int cpu);
152void disable_cpufreq(void);
153
154u64 get_cpu_idle_time(unsigned int cpu, u64 *wall, int io_busy);
155int cpufreq_get_policy(struct cpufreq_policy *policy, unsigned int cpu);
156int cpufreq_update_policy(unsigned int cpu);
157bool have_governor_per_policy(void);
158struct kobject *get_governor_parent_kobj(struct cpufreq_policy *policy);
159#else
160static inline unsigned int cpufreq_get(unsigned int cpu)
161{
162 return 0;
163}
164static inline unsigned int cpufreq_quick_get(unsigned int cpu)
165{
166 return 0;
167}
168static inline unsigned int cpufreq_quick_get_max(unsigned int cpu)
169{
170 return 0;
171}
172static inline void disable_cpufreq(void) { }
173#endif
174
175
176
177
178
179#define CPUFREQ_RELATION_L 0
180#define CPUFREQ_RELATION_H 1
181#define CPUFREQ_RELATION_C 2
182
183struct freq_attr {
184 struct attribute attr;
185 ssize_t (*show)(struct cpufreq_policy *, char *);
186 ssize_t (*store)(struct cpufreq_policy *, const char *, size_t count);
187};
188
189#define cpufreq_freq_attr_ro(_name) \
190static struct freq_attr _name = \
191__ATTR(_name, 0444, show_##_name, NULL)
192
193#define cpufreq_freq_attr_ro_perm(_name, _perm) \
194static struct freq_attr _name = \
195__ATTR(_name, _perm, show_##_name, NULL)
196
197#define cpufreq_freq_attr_rw(_name) \
198static struct freq_attr _name = \
199__ATTR(_name, 0644, show_##_name, store_##_name)
200
201struct global_attr {
202 struct attribute attr;
203 ssize_t (*show)(struct kobject *kobj,
204 struct attribute *attr, char *buf);
205 ssize_t (*store)(struct kobject *a, struct attribute *b,
206 const char *c, size_t count);
207};
208
209#define define_one_global_ro(_name) \
210static struct global_attr _name = \
211__ATTR(_name, 0444, show_##_name, NULL)
212
213#define define_one_global_rw(_name) \
214static struct global_attr _name = \
215__ATTR(_name, 0644, show_##_name, store_##_name)
216
217
218struct cpufreq_driver {
219 char name[CPUFREQ_NAME_LEN];
220 u8 flags;
221 void *driver_data;
222
223
224 int (*init)(struct cpufreq_policy *policy);
225 int (*verify)(struct cpufreq_policy *policy);
226
227
228 int (*setpolicy)(struct cpufreq_policy *policy);
229
230
231
232
233
234 int (*target)(struct cpufreq_policy *policy,
235 unsigned int target_freq,
236 unsigned int relation);
237 int (*target_index)(struct cpufreq_policy *policy,
238 unsigned int index);
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254 unsigned int (*get_intermediate)(struct cpufreq_policy *policy,
255 unsigned int index);
256 int (*target_intermediate)(struct cpufreq_policy *policy,
257 unsigned int index);
258
259
260 unsigned int (*get)(unsigned int cpu);
261
262
263 int (*bios_limit)(int cpu, unsigned int *limit);
264
265 int (*exit)(struct cpufreq_policy *policy);
266 void (*stop_cpu)(struct cpufreq_policy *policy);
267 int (*suspend)(struct cpufreq_policy *policy);
268 int (*resume)(struct cpufreq_policy *policy);
269
270
271 void (*ready)(struct cpufreq_policy *policy);
272
273 struct freq_attr **attr;
274
275
276 bool boost_enabled;
277 int (*set_boost)(int state);
278};
279
280
281#define CPUFREQ_STICKY (1 << 0)
282
283#define CPUFREQ_CONST_LOOPS (1 << 1)
284
285
286
287#define CPUFREQ_PM_NO_WARN (1 << 2)
288
289
290
291
292
293
294
295
296#define CPUFREQ_HAVE_GOVERNOR_PER_POLICY (1 << 3)
297
298
299
300
301
302
303#define CPUFREQ_ASYNC_NOTIFICATION (1 << 4)
304
305
306
307
308
309
310
311
312#define CPUFREQ_NEED_INITIAL_FREQ_CHECK (1 << 5)
313
314int cpufreq_register_driver(struct cpufreq_driver *driver_data);
315int cpufreq_unregister_driver(struct cpufreq_driver *driver_data);
316
317const char *cpufreq_get_current_driver(void);
318void *cpufreq_get_driver_data(void);
319
320static inline void cpufreq_verify_within_limits(struct cpufreq_policy *policy,
321 unsigned int min, unsigned int max)
322{
323 if (policy->min < min)
324 policy->min = min;
325 if (policy->max < min)
326 policy->max = min;
327 if (policy->min > max)
328 policy->min = max;
329 if (policy->max > max)
330 policy->max = max;
331 if (policy->min > policy->max)
332 policy->min = policy->max;
333 return;
334}
335
336static inline void
337cpufreq_verify_within_cpu_limits(struct cpufreq_policy *policy)
338{
339 cpufreq_verify_within_limits(policy, policy->cpuinfo.min_freq,
340 policy->cpuinfo.max_freq);
341}
342
343#ifdef CONFIG_CPU_FREQ
344void cpufreq_suspend(void);
345void cpufreq_resume(void);
346int cpufreq_generic_suspend(struct cpufreq_policy *policy);
347#else
348static inline void cpufreq_suspend(void) {}
349static inline void cpufreq_resume(void) {}
350#endif
351
352
353
354
355
356#define CPUFREQ_TRANSITION_NOTIFIER (0)
357#define CPUFREQ_POLICY_NOTIFIER (1)
358
359
360#define CPUFREQ_PRECHANGE (0)
361#define CPUFREQ_POSTCHANGE (1)
362
363
364#define CPUFREQ_ADJUST (0)
365#define CPUFREQ_NOTIFY (1)
366#define CPUFREQ_START (2)
367#define CPUFREQ_CREATE_POLICY (3)
368#define CPUFREQ_REMOVE_POLICY (4)
369
370#ifdef CONFIG_CPU_FREQ
371int cpufreq_register_notifier(struct notifier_block *nb, unsigned int list);
372int cpufreq_unregister_notifier(struct notifier_block *nb, unsigned int list);
373
374void cpufreq_freq_transition_begin(struct cpufreq_policy *policy,
375 struct cpufreq_freqs *freqs);
376void cpufreq_freq_transition_end(struct cpufreq_policy *policy,
377 struct cpufreq_freqs *freqs, int transition_failed);
378
379#else
380static inline int cpufreq_register_notifier(struct notifier_block *nb,
381 unsigned int list)
382{
383 return 0;
384}
385static inline int cpufreq_unregister_notifier(struct notifier_block *nb,
386 unsigned int list)
387{
388 return 0;
389}
390#endif
391
392
393
394
395
396
397
398
399
400
401
402static inline unsigned long cpufreq_scale(unsigned long old, u_int div,
403 u_int mult)
404{
405#if BITS_PER_LONG == 32
406 u64 result = ((u64) old) * ((u64) mult);
407 do_div(result, div);
408 return (unsigned long) result;
409
410#elif BITS_PER_LONG == 64
411 unsigned long result = old * ((u64) mult);
412 result /= div;
413 return result;
414#endif
415}
416
417
418
419
420
421
422
423
424
425
426#define CPUFREQ_POLICY_POWERSAVE (1)
427#define CPUFREQ_POLICY_PERFORMANCE (2)
428
429
430#define CPUFREQ_GOV_START 1
431#define CPUFREQ_GOV_STOP 2
432#define CPUFREQ_GOV_LIMITS 3
433#define CPUFREQ_GOV_POLICY_INIT 4
434#define CPUFREQ_GOV_POLICY_EXIT 5
435
436struct cpufreq_governor {
437 char name[CPUFREQ_NAME_LEN];
438 int initialized;
439 int (*governor) (struct cpufreq_policy *policy,
440 unsigned int event);
441 ssize_t (*show_setspeed) (struct cpufreq_policy *policy,
442 char *buf);
443 int (*store_setspeed) (struct cpufreq_policy *policy,
444 unsigned int freq);
445 unsigned int max_transition_latency;
446
447
448 struct list_head governor_list;
449 struct module *owner;
450};
451
452
453int cpufreq_driver_target(struct cpufreq_policy *policy,
454 unsigned int target_freq,
455 unsigned int relation);
456int __cpufreq_driver_target(struct cpufreq_policy *policy,
457 unsigned int target_freq,
458 unsigned int relation);
459int cpufreq_register_governor(struct cpufreq_governor *governor);
460void cpufreq_unregister_governor(struct cpufreq_governor *governor);
461
462struct cpufreq_governor *cpufreq_default_governor(void);
463struct cpufreq_governor *cpufreq_fallback_governor(void);
464
465
466
467
468
469
470#define CPUFREQ_ENTRY_INVALID ~0u
471#define CPUFREQ_TABLE_END ~1u
472
473#define CPUFREQ_BOOST_FREQ (1 << 0)
474
475struct cpufreq_frequency_table {
476 unsigned int flags;
477 unsigned int driver_data;
478 unsigned int frequency;
479
480};
481
482#if defined(CONFIG_CPU_FREQ) && defined(CONFIG_PM_OPP)
483int dev_pm_opp_init_cpufreq_table(struct device *dev,
484 struct cpufreq_frequency_table **table);
485void dev_pm_opp_free_cpufreq_table(struct device *dev,
486 struct cpufreq_frequency_table **table);
487#else
488static inline int dev_pm_opp_init_cpufreq_table(struct device *dev,
489 struct cpufreq_frequency_table
490 **table)
491{
492 return -EINVAL;
493}
494
495static inline void dev_pm_opp_free_cpufreq_table(struct device *dev,
496 struct cpufreq_frequency_table
497 **table)
498{
499}
500#endif
501
502
503
504
505
506
507
508#define cpufreq_for_each_entry(pos, table) \
509 for (pos = table; pos->frequency != CPUFREQ_TABLE_END; pos++)
510
511
512
513
514
515
516
517
518#define cpufreq_for_each_valid_entry(pos, table) \
519 for (pos = table; pos->frequency != CPUFREQ_TABLE_END; pos++) \
520 if (pos->frequency == CPUFREQ_ENTRY_INVALID) \
521 continue; \
522 else
523
524int cpufreq_frequency_table_cpuinfo(struct cpufreq_policy *policy,
525 struct cpufreq_frequency_table *table);
526
527int cpufreq_frequency_table_verify(struct cpufreq_policy *policy,
528 struct cpufreq_frequency_table *table);
529int cpufreq_generic_frequency_table_verify(struct cpufreq_policy *policy);
530
531int cpufreq_frequency_table_target(struct cpufreq_policy *policy,
532 struct cpufreq_frequency_table *table,
533 unsigned int target_freq,
534 unsigned int relation,
535 unsigned int *index);
536int cpufreq_frequency_table_get_index(struct cpufreq_policy *policy,
537 unsigned int freq);
538
539ssize_t cpufreq_show_cpus(const struct cpumask *mask, char *buf);
540
541#ifdef CONFIG_CPU_FREQ
542int cpufreq_boost_trigger_state(int state);
543int cpufreq_boost_enabled(void);
544int cpufreq_enable_boost_support(void);
545bool policy_has_boost_freq(struct cpufreq_policy *policy);
546#else
547static inline int cpufreq_boost_trigger_state(int state)
548{
549 return 0;
550}
551static inline int cpufreq_boost_enabled(void)
552{
553 return 0;
554}
555
556static inline int cpufreq_enable_boost_support(void)
557{
558 return -EINVAL;
559}
560
561static inline bool policy_has_boost_freq(struct cpufreq_policy *policy)
562{
563 return false;
564}
565#endif
566
567struct cpufreq_frequency_table *cpufreq_frequency_get_table(unsigned int cpu);
568
569
570extern struct freq_attr cpufreq_freq_attr_scaling_available_freqs;
571extern struct freq_attr cpufreq_freq_attr_scaling_boost_freqs;
572extern struct freq_attr *cpufreq_generic_attr[];
573int cpufreq_table_validate_and_show(struct cpufreq_policy *policy,
574 struct cpufreq_frequency_table *table);
575
576unsigned int cpufreq_generic_get(unsigned int cpu);
577int cpufreq_generic_init(struct cpufreq_policy *policy,
578 struct cpufreq_frequency_table *table,
579 unsigned int transition_latency);
580#endif
581