11da177e4SLinus Torvalds /* 21da177e4SLinus Torvalds * linux/drivers/cpufreq/cpufreq.c 31da177e4SLinus Torvalds * 41da177e4SLinus Torvalds * Copyright (C) 2001 Russell King 51da177e4SLinus Torvalds * (C) 2002 - 2003 Dominik Brodowski <linux@brodo.de> 6bb176f7dSViresh Kumar * (C) 2013 Viresh Kumar <viresh.kumar@linaro.org> 71da177e4SLinus Torvalds * 8c32b6b8eSAshok Raj * Oct 2005 - Ashok Raj <ashok.raj@intel.com> 9c32b6b8eSAshok Raj * Added handling for CPU hotplug 108ff69732SDave Jones * Feb 2006 - Jacob Shin <jacob.shin@amd.com> 118ff69732SDave Jones * Fix handling for CPU hotplug -- affected CPUs 12c32b6b8eSAshok Raj * 131da177e4SLinus Torvalds * This program is free software; you can redistribute it and/or modify 141da177e4SLinus Torvalds * it under the terms of the GNU General Public License version 2 as 151da177e4SLinus Torvalds * published by the Free Software Foundation. 161da177e4SLinus Torvalds */ 171da177e4SLinus Torvalds 18db701151SViresh Kumar #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 19db701151SViresh Kumar 205ff0a268SViresh Kumar #include <linux/cpu.h> 211da177e4SLinus Torvalds #include <linux/cpufreq.h> 221da177e4SLinus Torvalds #include <linux/delay.h> 231da177e4SLinus Torvalds #include <linux/device.h> 245ff0a268SViresh Kumar #include <linux/init.h> 255ff0a268SViresh Kumar #include <linux/kernel_stat.h> 265ff0a268SViresh Kumar #include <linux/module.h> 273fc54d37Sakpm@osdl.org #include <linux/mutex.h> 285ff0a268SViresh Kumar #include <linux/slab.h> 29e00e56dfSRafael J. Wysocki #include <linux/syscore_ops.h> 305ff0a268SViresh Kumar #include <linux/tick.h> 316f4f2723SThomas Renninger #include <trace/events/power.h> 326f4f2723SThomas Renninger 331da177e4SLinus Torvalds /** 34cd878479SDave Jones * The "cpufreq driver" - the arch- or hardware-dependent low 351da177e4SLinus Torvalds * level driver of CPUFreq support, and its spinlock. This lock 361da177e4SLinus Torvalds * also protects the cpufreq_cpu_data array. 371da177e4SLinus Torvalds */ 381c3d85ddSRafael J. Wysocki static struct cpufreq_driver *cpufreq_driver; 397a6aedfaSMike Travis static DEFINE_PER_CPU(struct cpufreq_policy *, cpufreq_cpu_data); 408414809cSSrivatsa S. Bhat static DEFINE_PER_CPU(struct cpufreq_policy *, cpufreq_cpu_data_fallback); 41bb176f7dSViresh Kumar static DEFINE_RWLOCK(cpufreq_driver_lock); 42bb176f7dSViresh Kumar static DEFINE_MUTEX(cpufreq_governor_lock); 43c88a1f8bSLukasz Majewski static LIST_HEAD(cpufreq_policy_list); 44bb176f7dSViresh Kumar 45084f3493SThomas Renninger #ifdef CONFIG_HOTPLUG_CPU 46084f3493SThomas Renninger /* This one keeps track of the previously set governor of a removed CPU */ 47e77b89f1SDmitry Monakhov static DEFINE_PER_CPU(char[CPUFREQ_NAME_LEN], cpufreq_cpu_governor); 48084f3493SThomas Renninger #endif 491da177e4SLinus Torvalds 505a01f2e8SVenkatesh Pallipadi /* 515a01f2e8SVenkatesh Pallipadi * cpu_policy_rwsem is a per CPU reader-writer semaphore designed to cure 525a01f2e8SVenkatesh Pallipadi * all cpufreq/hotplug/workqueue/etc related lock issues. 535a01f2e8SVenkatesh Pallipadi * 545a01f2e8SVenkatesh Pallipadi * The rules for this semaphore: 555a01f2e8SVenkatesh Pallipadi * - Any routine that wants to read from the policy structure will 565a01f2e8SVenkatesh Pallipadi * do a down_read on this semaphore. 575a01f2e8SVenkatesh Pallipadi * - Any routine that will write to the policy structure and/or may take away 585a01f2e8SVenkatesh Pallipadi * the policy altogether (eg. CPU hotplug), will hold this lock in write 595a01f2e8SVenkatesh Pallipadi * mode before doing so. 605a01f2e8SVenkatesh Pallipadi * 615a01f2e8SVenkatesh Pallipadi * Additional rules: 625a01f2e8SVenkatesh Pallipadi * - Governor routines that can be called in cpufreq hotplug path should not 635a01f2e8SVenkatesh Pallipadi * take this sem as top level hotplug notifier handler takes this. 64395913d0SMathieu Desnoyers * - Lock should not be held across 65395913d0SMathieu Desnoyers * __cpufreq_governor(data, CPUFREQ_GOV_STOP); 665a01f2e8SVenkatesh Pallipadi */ 67f1625066STejun Heo static DEFINE_PER_CPU(int, cpufreq_policy_cpu); 685a01f2e8SVenkatesh Pallipadi static DEFINE_PER_CPU(struct rw_semaphore, cpu_policy_rwsem); 695a01f2e8SVenkatesh Pallipadi 705a01f2e8SVenkatesh Pallipadi #define lock_policy_rwsem(mode, cpu) \ 71fa1d8af4SViresh Kumar static int lock_policy_rwsem_##mode(int cpu) \ 725a01f2e8SVenkatesh Pallipadi { \ 73f1625066STejun Heo int policy_cpu = per_cpu(cpufreq_policy_cpu, cpu); \ 745a01f2e8SVenkatesh Pallipadi BUG_ON(policy_cpu == -1); \ 755a01f2e8SVenkatesh Pallipadi down_##mode(&per_cpu(cpu_policy_rwsem, policy_cpu)); \ 765a01f2e8SVenkatesh Pallipadi \ 775a01f2e8SVenkatesh Pallipadi return 0; \ 785a01f2e8SVenkatesh Pallipadi } 795a01f2e8SVenkatesh Pallipadi 805a01f2e8SVenkatesh Pallipadi lock_policy_rwsem(read, cpu); 815a01f2e8SVenkatesh Pallipadi lock_policy_rwsem(write, cpu); 825a01f2e8SVenkatesh Pallipadi 83fa1d8af4SViresh Kumar #define unlock_policy_rwsem(mode, cpu) \ 84fa1d8af4SViresh Kumar static void unlock_policy_rwsem_##mode(int cpu) \ 85fa1d8af4SViresh Kumar { \ 86fa1d8af4SViresh Kumar int policy_cpu = per_cpu(cpufreq_policy_cpu, cpu); \ 87fa1d8af4SViresh Kumar BUG_ON(policy_cpu == -1); \ 88fa1d8af4SViresh Kumar up_##mode(&per_cpu(cpu_policy_rwsem, policy_cpu)); \ 895a01f2e8SVenkatesh Pallipadi } 905a01f2e8SVenkatesh Pallipadi 91fa1d8af4SViresh Kumar unlock_policy_rwsem(read, cpu); 92fa1d8af4SViresh Kumar unlock_policy_rwsem(write, cpu); 935a01f2e8SVenkatesh Pallipadi 94*6eed9404SViresh Kumar /* 95*6eed9404SViresh Kumar * rwsem to guarantee that cpufreq driver module doesn't unload during critical 96*6eed9404SViresh Kumar * sections 97*6eed9404SViresh Kumar */ 98*6eed9404SViresh Kumar static DECLARE_RWSEM(cpufreq_rwsem); 99*6eed9404SViresh Kumar 1001da177e4SLinus Torvalds /* internal prototypes */ 10129464f28SDave Jones static int __cpufreq_governor(struct cpufreq_policy *policy, 10229464f28SDave Jones unsigned int event); 1035a01f2e8SVenkatesh Pallipadi static unsigned int __cpufreq_get(unsigned int cpu); 10465f27f38SDavid Howells static void handle_update(struct work_struct *work); 1051da177e4SLinus Torvalds 1061da177e4SLinus Torvalds /** 1071da177e4SLinus Torvalds * Two notifier lists: the "policy" list is involved in the 1081da177e4SLinus Torvalds * validation process for a new CPU frequency policy; the 1091da177e4SLinus Torvalds * "transition" list for kernel code that needs to handle 1101da177e4SLinus Torvalds * changes to devices when the CPU clock speed changes. 1111da177e4SLinus Torvalds * The mutex locks both lists. 1121da177e4SLinus Torvalds */ 113e041c683SAlan Stern static BLOCKING_NOTIFIER_HEAD(cpufreq_policy_notifier_list); 114b4dfdbb3SAlan Stern static struct srcu_notifier_head cpufreq_transition_notifier_list; 1151da177e4SLinus Torvalds 11674212ca4SCesar Eduardo Barros static bool init_cpufreq_transition_notifier_list_called; 117b4dfdbb3SAlan Stern static int __init init_cpufreq_transition_notifier_list(void) 118b4dfdbb3SAlan Stern { 119b4dfdbb3SAlan Stern srcu_init_notifier_head(&cpufreq_transition_notifier_list); 12074212ca4SCesar Eduardo Barros init_cpufreq_transition_notifier_list_called = true; 121b4dfdbb3SAlan Stern return 0; 122b4dfdbb3SAlan Stern } 123b3438f82SLinus Torvalds pure_initcall(init_cpufreq_transition_notifier_list); 1241da177e4SLinus Torvalds 125a7b422cdSKonrad Rzeszutek Wilk static int off __read_mostly; 126da584455SViresh Kumar static int cpufreq_disabled(void) 127a7b422cdSKonrad Rzeszutek Wilk { 128a7b422cdSKonrad Rzeszutek Wilk return off; 129a7b422cdSKonrad Rzeszutek Wilk } 130a7b422cdSKonrad Rzeszutek Wilk void disable_cpufreq(void) 131a7b422cdSKonrad Rzeszutek Wilk { 132a7b422cdSKonrad Rzeszutek Wilk off = 1; 133a7b422cdSKonrad Rzeszutek Wilk } 1341da177e4SLinus Torvalds static LIST_HEAD(cpufreq_governor_list); 1353fc54d37Sakpm@osdl.org static DEFINE_MUTEX(cpufreq_governor_mutex); 1361da177e4SLinus Torvalds 1374d5dcc42SViresh Kumar bool have_governor_per_policy(void) 1384d5dcc42SViresh Kumar { 1391c3d85ddSRafael J. Wysocki return cpufreq_driver->have_governor_per_policy; 1404d5dcc42SViresh Kumar } 1413f869d6dSViresh Kumar EXPORT_SYMBOL_GPL(have_governor_per_policy); 1424d5dcc42SViresh Kumar 143944e9a03SViresh Kumar struct kobject *get_governor_parent_kobj(struct cpufreq_policy *policy) 144944e9a03SViresh Kumar { 145944e9a03SViresh Kumar if (have_governor_per_policy()) 146944e9a03SViresh Kumar return &policy->kobj; 147944e9a03SViresh Kumar else 148944e9a03SViresh Kumar return cpufreq_global_kobject; 149944e9a03SViresh Kumar } 150944e9a03SViresh Kumar EXPORT_SYMBOL_GPL(get_governor_parent_kobj); 151944e9a03SViresh Kumar 15272a4ce34SViresh Kumar static inline u64 get_cpu_idle_time_jiffy(unsigned int cpu, u64 *wall) 15372a4ce34SViresh Kumar { 15472a4ce34SViresh Kumar u64 idle_time; 15572a4ce34SViresh Kumar u64 cur_wall_time; 15672a4ce34SViresh Kumar u64 busy_time; 15772a4ce34SViresh Kumar 15872a4ce34SViresh Kumar cur_wall_time = jiffies64_to_cputime64(get_jiffies_64()); 15972a4ce34SViresh Kumar 16072a4ce34SViresh Kumar busy_time = kcpustat_cpu(cpu).cpustat[CPUTIME_USER]; 16172a4ce34SViresh Kumar busy_time += kcpustat_cpu(cpu).cpustat[CPUTIME_SYSTEM]; 16272a4ce34SViresh Kumar busy_time += kcpustat_cpu(cpu).cpustat[CPUTIME_IRQ]; 16372a4ce34SViresh Kumar busy_time += kcpustat_cpu(cpu).cpustat[CPUTIME_SOFTIRQ]; 16472a4ce34SViresh Kumar busy_time += kcpustat_cpu(cpu).cpustat[CPUTIME_STEAL]; 16572a4ce34SViresh Kumar busy_time += kcpustat_cpu(cpu).cpustat[CPUTIME_NICE]; 16672a4ce34SViresh Kumar 16772a4ce34SViresh Kumar idle_time = cur_wall_time - busy_time; 16872a4ce34SViresh Kumar if (wall) 16972a4ce34SViresh Kumar *wall = cputime_to_usecs(cur_wall_time); 17072a4ce34SViresh Kumar 17172a4ce34SViresh Kumar return cputime_to_usecs(idle_time); 17272a4ce34SViresh Kumar } 17372a4ce34SViresh Kumar 17472a4ce34SViresh Kumar u64 get_cpu_idle_time(unsigned int cpu, u64 *wall, int io_busy) 17572a4ce34SViresh Kumar { 17672a4ce34SViresh Kumar u64 idle_time = get_cpu_idle_time_us(cpu, io_busy ? wall : NULL); 17772a4ce34SViresh Kumar 17872a4ce34SViresh Kumar if (idle_time == -1ULL) 17972a4ce34SViresh Kumar return get_cpu_idle_time_jiffy(cpu, wall); 18072a4ce34SViresh Kumar else if (!io_busy) 18172a4ce34SViresh Kumar idle_time += get_cpu_iowait_time_us(cpu, wall); 18272a4ce34SViresh Kumar 18372a4ce34SViresh Kumar return idle_time; 18472a4ce34SViresh Kumar } 18572a4ce34SViresh Kumar EXPORT_SYMBOL_GPL(get_cpu_idle_time); 18672a4ce34SViresh Kumar 187*6eed9404SViresh Kumar struct cpufreq_policy *cpufreq_cpu_get(unsigned int cpu) 1881da177e4SLinus Torvalds { 189*6eed9404SViresh Kumar struct cpufreq_policy *policy = NULL; 1901da177e4SLinus Torvalds unsigned long flags; 1911da177e4SLinus Torvalds 192*6eed9404SViresh Kumar if (cpufreq_disabled() || (cpu >= nr_cpu_ids)) 193*6eed9404SViresh Kumar return NULL; 194*6eed9404SViresh Kumar 195*6eed9404SViresh Kumar if (!down_read_trylock(&cpufreq_rwsem)) 196*6eed9404SViresh Kumar return NULL; 1971da177e4SLinus Torvalds 1981da177e4SLinus Torvalds /* get the cpufreq driver */ 1990d1857a1SNathan Zimmer read_lock_irqsave(&cpufreq_driver_lock, flags); 2001da177e4SLinus Torvalds 201*6eed9404SViresh Kumar if (cpufreq_driver) { 2021da177e4SLinus Torvalds /* get the CPU */ 2033a3e9e06SViresh Kumar policy = per_cpu(cpufreq_cpu_data, cpu); 204*6eed9404SViresh Kumar if (policy) 205*6eed9404SViresh Kumar kobject_get(&policy->kobj); 206*6eed9404SViresh Kumar } 207*6eed9404SViresh Kumar 208*6eed9404SViresh Kumar read_unlock_irqrestore(&cpufreq_driver_lock, flags); 2091da177e4SLinus Torvalds 2103a3e9e06SViresh Kumar if (!policy) 211*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 2121da177e4SLinus Torvalds 2133a3e9e06SViresh Kumar return policy; 214a9144436SStephen Boyd } 2151da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_cpu_get); 2161da177e4SLinus Torvalds 2173a3e9e06SViresh Kumar void cpufreq_cpu_put(struct cpufreq_policy *policy) 218a9144436SStephen Boyd { 219d5aaffa9SDirk Brandewie if (cpufreq_disabled()) 220d5aaffa9SDirk Brandewie return; 221d5aaffa9SDirk Brandewie 222*6eed9404SViresh Kumar kobject_put(&policy->kobj); 223*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 224a9144436SStephen Boyd } 2251da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_cpu_put); 2261da177e4SLinus Torvalds 2271da177e4SLinus Torvalds /********************************************************************* 2281da177e4SLinus Torvalds * EXTERNALLY AFFECTING FREQUENCY CHANGES * 2291da177e4SLinus Torvalds *********************************************************************/ 2301da177e4SLinus Torvalds 2311da177e4SLinus Torvalds /** 2321da177e4SLinus Torvalds * adjust_jiffies - adjust the system "loops_per_jiffy" 2331da177e4SLinus Torvalds * 2341da177e4SLinus Torvalds * This function alters the system "loops_per_jiffy" for the clock 2351da177e4SLinus Torvalds * speed change. Note that loops_per_jiffy cannot be updated on SMP 2361da177e4SLinus Torvalds * systems as each CPU might be scaled differently. So, use the arch 2371da177e4SLinus Torvalds * per-CPU loops_per_jiffy value wherever possible. 2381da177e4SLinus Torvalds */ 2391da177e4SLinus Torvalds #ifndef CONFIG_SMP 2401da177e4SLinus Torvalds static unsigned long l_p_j_ref; 2411da177e4SLinus Torvalds static unsigned int l_p_j_ref_freq; 2421da177e4SLinus Torvalds 243858119e1SArjan van de Ven static void adjust_jiffies(unsigned long val, struct cpufreq_freqs *ci) 2441da177e4SLinus Torvalds { 2451da177e4SLinus Torvalds if (ci->flags & CPUFREQ_CONST_LOOPS) 2461da177e4SLinus Torvalds return; 2471da177e4SLinus Torvalds 2481da177e4SLinus Torvalds if (!l_p_j_ref_freq) { 2491da177e4SLinus Torvalds l_p_j_ref = loops_per_jiffy; 2501da177e4SLinus Torvalds l_p_j_ref_freq = ci->old; 2512d06d8c4SDominik Brodowski pr_debug("saving %lu as reference value for loops_per_jiffy; " 252e08f5f5bSGautham R Shenoy "freq is %u kHz\n", l_p_j_ref, l_p_j_ref_freq); 2531da177e4SLinus Torvalds } 254d08de0c1SAfzal Mohammed if ((val == CPUFREQ_POSTCHANGE && ci->old != ci->new) || 25542d4dc3fSBenjamin Herrenschmidt (val == CPUFREQ_RESUMECHANGE || val == CPUFREQ_SUSPENDCHANGE)) { 256e08f5f5bSGautham R Shenoy loops_per_jiffy = cpufreq_scale(l_p_j_ref, l_p_j_ref_freq, 257e08f5f5bSGautham R Shenoy ci->new); 2582d06d8c4SDominik Brodowski pr_debug("scaling loops_per_jiffy to %lu " 259e08f5f5bSGautham R Shenoy "for frequency %u kHz\n", loops_per_jiffy, ci->new); 2601da177e4SLinus Torvalds } 2611da177e4SLinus Torvalds } 2621da177e4SLinus Torvalds #else 263e08f5f5bSGautham R Shenoy static inline void adjust_jiffies(unsigned long val, struct cpufreq_freqs *ci) 264e08f5f5bSGautham R Shenoy { 265e08f5f5bSGautham R Shenoy return; 266e08f5f5bSGautham R Shenoy } 2671da177e4SLinus Torvalds #endif 2681da177e4SLinus Torvalds 2690956df9cSViresh Kumar static void __cpufreq_notify_transition(struct cpufreq_policy *policy, 270b43a7ffbSViresh Kumar struct cpufreq_freqs *freqs, unsigned int state) 2711da177e4SLinus Torvalds { 2721da177e4SLinus Torvalds BUG_ON(irqs_disabled()); 2731da177e4SLinus Torvalds 274d5aaffa9SDirk Brandewie if (cpufreq_disabled()) 275d5aaffa9SDirk Brandewie return; 276d5aaffa9SDirk Brandewie 2771c3d85ddSRafael J. Wysocki freqs->flags = cpufreq_driver->flags; 2782d06d8c4SDominik Brodowski pr_debug("notification %u of frequency transition to %u kHz\n", 279e4472cb3SDave Jones state, freqs->new); 2801da177e4SLinus Torvalds 2811da177e4SLinus Torvalds switch (state) { 282e4472cb3SDave Jones 2831da177e4SLinus Torvalds case CPUFREQ_PRECHANGE: 284266c13d7SViresh Kumar if (WARN(policy->transition_ongoing == 285266c13d7SViresh Kumar cpumask_weight(policy->cpus), 2867c30ed53SViresh Kumar "In middle of another frequency transition\n")) 2877c30ed53SViresh Kumar return; 2887c30ed53SViresh Kumar 289266c13d7SViresh Kumar policy->transition_ongoing++; 2907c30ed53SViresh Kumar 291e4472cb3SDave Jones /* detect if the driver reported a value as "old frequency" 292e4472cb3SDave Jones * which is not equal to what the cpufreq core thinks is 293e4472cb3SDave Jones * "old frequency". 2941da177e4SLinus Torvalds */ 2951c3d85ddSRafael J. Wysocki if (!(cpufreq_driver->flags & CPUFREQ_CONST_LOOPS)) { 296e4472cb3SDave Jones if ((policy) && (policy->cpu == freqs->cpu) && 297e4472cb3SDave Jones (policy->cur) && (policy->cur != freqs->old)) { 2982d06d8c4SDominik Brodowski pr_debug("Warning: CPU frequency is" 299e4472cb3SDave Jones " %u, cpufreq assumed %u kHz.\n", 300e4472cb3SDave Jones freqs->old, policy->cur); 301e4472cb3SDave Jones freqs->old = policy->cur; 3021da177e4SLinus Torvalds } 3031da177e4SLinus Torvalds } 304b4dfdbb3SAlan Stern srcu_notifier_call_chain(&cpufreq_transition_notifier_list, 305e4472cb3SDave Jones CPUFREQ_PRECHANGE, freqs); 3061da177e4SLinus Torvalds adjust_jiffies(CPUFREQ_PRECHANGE, freqs); 3071da177e4SLinus Torvalds break; 308e4472cb3SDave Jones 3091da177e4SLinus Torvalds case CPUFREQ_POSTCHANGE: 3107c30ed53SViresh Kumar if (WARN(!policy->transition_ongoing, 3117c30ed53SViresh Kumar "No frequency transition in progress\n")) 3127c30ed53SViresh Kumar return; 3137c30ed53SViresh Kumar 314266c13d7SViresh Kumar policy->transition_ongoing--; 3157c30ed53SViresh Kumar 3161da177e4SLinus Torvalds adjust_jiffies(CPUFREQ_POSTCHANGE, freqs); 3172d06d8c4SDominik Brodowski pr_debug("FREQ: %lu - CPU: %lu", (unsigned long)freqs->new, 3186f4f2723SThomas Renninger (unsigned long)freqs->cpu); 31925e41933SThomas Renninger trace_cpu_frequency(freqs->new, freqs->cpu); 320b4dfdbb3SAlan Stern srcu_notifier_call_chain(&cpufreq_transition_notifier_list, 321e4472cb3SDave Jones CPUFREQ_POSTCHANGE, freqs); 322e4472cb3SDave Jones if (likely(policy) && likely(policy->cpu == freqs->cpu)) 323e4472cb3SDave Jones policy->cur = freqs->new; 3241da177e4SLinus Torvalds break; 3251da177e4SLinus Torvalds } 3261da177e4SLinus Torvalds } 327bb176f7dSViresh Kumar 328b43a7ffbSViresh Kumar /** 329b43a7ffbSViresh Kumar * cpufreq_notify_transition - call notifier chain and adjust_jiffies 330b43a7ffbSViresh Kumar * on frequency transition. 331b43a7ffbSViresh Kumar * 332b43a7ffbSViresh Kumar * This function calls the transition notifiers and the "adjust_jiffies" 333b43a7ffbSViresh Kumar * function. It is called twice on all CPU frequency changes that have 334b43a7ffbSViresh Kumar * external effects. 335b43a7ffbSViresh Kumar */ 336b43a7ffbSViresh Kumar void cpufreq_notify_transition(struct cpufreq_policy *policy, 337b43a7ffbSViresh Kumar struct cpufreq_freqs *freqs, unsigned int state) 338b43a7ffbSViresh Kumar { 339b43a7ffbSViresh Kumar for_each_cpu(freqs->cpu, policy->cpus) 340b43a7ffbSViresh Kumar __cpufreq_notify_transition(policy, freqs, state); 341b43a7ffbSViresh Kumar } 3421da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_notify_transition); 3431da177e4SLinus Torvalds 3441da177e4SLinus Torvalds 3451da177e4SLinus Torvalds /********************************************************************* 3461da177e4SLinus Torvalds * SYSFS INTERFACE * 3471da177e4SLinus Torvalds *********************************************************************/ 3481da177e4SLinus Torvalds 3493bcb09a3SJeremy Fitzhardinge static struct cpufreq_governor *__find_governor(const char *str_governor) 3503bcb09a3SJeremy Fitzhardinge { 3513bcb09a3SJeremy Fitzhardinge struct cpufreq_governor *t; 3523bcb09a3SJeremy Fitzhardinge 3533bcb09a3SJeremy Fitzhardinge list_for_each_entry(t, &cpufreq_governor_list, governor_list) 3543bcb09a3SJeremy Fitzhardinge if (!strnicmp(str_governor, t->name, CPUFREQ_NAME_LEN)) 3553bcb09a3SJeremy Fitzhardinge return t; 3563bcb09a3SJeremy Fitzhardinge 3573bcb09a3SJeremy Fitzhardinge return NULL; 3583bcb09a3SJeremy Fitzhardinge } 3593bcb09a3SJeremy Fitzhardinge 3601da177e4SLinus Torvalds /** 3611da177e4SLinus Torvalds * cpufreq_parse_governor - parse a governor string 3621da177e4SLinus Torvalds */ 3631da177e4SLinus Torvalds static int cpufreq_parse_governor(char *str_governor, unsigned int *policy, 3641da177e4SLinus Torvalds struct cpufreq_governor **governor) 3651da177e4SLinus Torvalds { 3663bcb09a3SJeremy Fitzhardinge int err = -EINVAL; 3673bcb09a3SJeremy Fitzhardinge 3681c3d85ddSRafael J. Wysocki if (!cpufreq_driver) 3693bcb09a3SJeremy Fitzhardinge goto out; 3703bcb09a3SJeremy Fitzhardinge 3711c3d85ddSRafael J. Wysocki if (cpufreq_driver->setpolicy) { 3721da177e4SLinus Torvalds if (!strnicmp(str_governor, "performance", CPUFREQ_NAME_LEN)) { 3731da177e4SLinus Torvalds *policy = CPUFREQ_POLICY_PERFORMANCE; 3743bcb09a3SJeremy Fitzhardinge err = 0; 375e08f5f5bSGautham R Shenoy } else if (!strnicmp(str_governor, "powersave", 376e08f5f5bSGautham R Shenoy CPUFREQ_NAME_LEN)) { 3771da177e4SLinus Torvalds *policy = CPUFREQ_POLICY_POWERSAVE; 3783bcb09a3SJeremy Fitzhardinge err = 0; 3791da177e4SLinus Torvalds } 3801c3d85ddSRafael J. Wysocki } else if (cpufreq_driver->target) { 3811da177e4SLinus Torvalds struct cpufreq_governor *t; 3823bcb09a3SJeremy Fitzhardinge 3833fc54d37Sakpm@osdl.org mutex_lock(&cpufreq_governor_mutex); 3843bcb09a3SJeremy Fitzhardinge 3853bcb09a3SJeremy Fitzhardinge t = __find_governor(str_governor); 3863bcb09a3SJeremy Fitzhardinge 387ea714970SJeremy Fitzhardinge if (t == NULL) { 388ea714970SJeremy Fitzhardinge int ret; 389ea714970SJeremy Fitzhardinge 390ea714970SJeremy Fitzhardinge mutex_unlock(&cpufreq_governor_mutex); 3911a8e1463SKees Cook ret = request_module("cpufreq_%s", str_governor); 392ea714970SJeremy Fitzhardinge mutex_lock(&cpufreq_governor_mutex); 393ea714970SJeremy Fitzhardinge 394ea714970SJeremy Fitzhardinge if (ret == 0) 395ea714970SJeremy Fitzhardinge t = __find_governor(str_governor); 396ea714970SJeremy Fitzhardinge } 397ea714970SJeremy Fitzhardinge 3983bcb09a3SJeremy Fitzhardinge if (t != NULL) { 3991da177e4SLinus Torvalds *governor = t; 4003bcb09a3SJeremy Fitzhardinge err = 0; 4011da177e4SLinus Torvalds } 4023bcb09a3SJeremy Fitzhardinge 4033bcb09a3SJeremy Fitzhardinge mutex_unlock(&cpufreq_governor_mutex); 4041da177e4SLinus Torvalds } 4051da177e4SLinus Torvalds out: 4063bcb09a3SJeremy Fitzhardinge return err; 4071da177e4SLinus Torvalds } 4081da177e4SLinus Torvalds 4091da177e4SLinus Torvalds /** 410e08f5f5bSGautham R Shenoy * cpufreq_per_cpu_attr_read() / show_##file_name() - 411e08f5f5bSGautham R Shenoy * print out cpufreq information 4121da177e4SLinus Torvalds * 4131da177e4SLinus Torvalds * Write out information from cpufreq_driver->policy[cpu]; object must be 4141da177e4SLinus Torvalds * "unsigned int". 4151da177e4SLinus Torvalds */ 4161da177e4SLinus Torvalds 4171da177e4SLinus Torvalds #define show_one(file_name, object) \ 4181da177e4SLinus Torvalds static ssize_t show_##file_name \ 4191da177e4SLinus Torvalds (struct cpufreq_policy *policy, char *buf) \ 4201da177e4SLinus Torvalds { \ 4211da177e4SLinus Torvalds return sprintf(buf, "%u\n", policy->object); \ 4221da177e4SLinus Torvalds } 4231da177e4SLinus Torvalds 4241da177e4SLinus Torvalds show_one(cpuinfo_min_freq, cpuinfo.min_freq); 4251da177e4SLinus Torvalds show_one(cpuinfo_max_freq, cpuinfo.max_freq); 426ed129784SThomas Renninger show_one(cpuinfo_transition_latency, cpuinfo.transition_latency); 4271da177e4SLinus Torvalds show_one(scaling_min_freq, min); 4281da177e4SLinus Torvalds show_one(scaling_max_freq, max); 4291da177e4SLinus Torvalds show_one(scaling_cur_freq, cur); 4301da177e4SLinus Torvalds 4313a3e9e06SViresh Kumar static int __cpufreq_set_policy(struct cpufreq_policy *policy, 4323a3e9e06SViresh Kumar struct cpufreq_policy *new_policy); 4337970e08bSThomas Renninger 4341da177e4SLinus Torvalds /** 4351da177e4SLinus Torvalds * cpufreq_per_cpu_attr_write() / store_##file_name() - sysfs write access 4361da177e4SLinus Torvalds */ 4371da177e4SLinus Torvalds #define store_one(file_name, object) \ 4381da177e4SLinus Torvalds static ssize_t store_##file_name \ 4391da177e4SLinus Torvalds (struct cpufreq_policy *policy, const char *buf, size_t count) \ 4401da177e4SLinus Torvalds { \ 441f55c9c26SJingoo Han unsigned int ret; \ 4421da177e4SLinus Torvalds struct cpufreq_policy new_policy; \ 4431da177e4SLinus Torvalds \ 4441da177e4SLinus Torvalds ret = cpufreq_get_policy(&new_policy, policy->cpu); \ 4451da177e4SLinus Torvalds if (ret) \ 4461da177e4SLinus Torvalds return -EINVAL; \ 4471da177e4SLinus Torvalds \ 4481da177e4SLinus Torvalds ret = sscanf(buf, "%u", &new_policy.object); \ 4491da177e4SLinus Torvalds if (ret != 1) \ 4501da177e4SLinus Torvalds return -EINVAL; \ 4511da177e4SLinus Torvalds \ 4527970e08bSThomas Renninger ret = __cpufreq_set_policy(policy, &new_policy); \ 4537970e08bSThomas Renninger policy->user_policy.object = policy->object; \ 4541da177e4SLinus Torvalds \ 4551da177e4SLinus Torvalds return ret ? ret : count; \ 4561da177e4SLinus Torvalds } 4571da177e4SLinus Torvalds 4581da177e4SLinus Torvalds store_one(scaling_min_freq, min); 4591da177e4SLinus Torvalds store_one(scaling_max_freq, max); 4601da177e4SLinus Torvalds 4611da177e4SLinus Torvalds /** 4621da177e4SLinus Torvalds * show_cpuinfo_cur_freq - current CPU frequency as detected by hardware 4631da177e4SLinus Torvalds */ 464e08f5f5bSGautham R Shenoy static ssize_t show_cpuinfo_cur_freq(struct cpufreq_policy *policy, 465e08f5f5bSGautham R Shenoy char *buf) 4661da177e4SLinus Torvalds { 4675a01f2e8SVenkatesh Pallipadi unsigned int cur_freq = __cpufreq_get(policy->cpu); 4681da177e4SLinus Torvalds if (!cur_freq) 4691da177e4SLinus Torvalds return sprintf(buf, "<unknown>"); 4701da177e4SLinus Torvalds return sprintf(buf, "%u\n", cur_freq); 4711da177e4SLinus Torvalds } 4721da177e4SLinus Torvalds 4731da177e4SLinus Torvalds /** 4741da177e4SLinus Torvalds * show_scaling_governor - show the current policy for the specified CPU 4751da177e4SLinus Torvalds */ 476905d77cdSDave Jones static ssize_t show_scaling_governor(struct cpufreq_policy *policy, char *buf) 4771da177e4SLinus Torvalds { 4781da177e4SLinus Torvalds if (policy->policy == CPUFREQ_POLICY_POWERSAVE) 4791da177e4SLinus Torvalds return sprintf(buf, "powersave\n"); 4801da177e4SLinus Torvalds else if (policy->policy == CPUFREQ_POLICY_PERFORMANCE) 4811da177e4SLinus Torvalds return sprintf(buf, "performance\n"); 4821da177e4SLinus Torvalds else if (policy->governor) 4834b972f0bSviresh kumar return scnprintf(buf, CPUFREQ_NAME_PLEN, "%s\n", 48429464f28SDave Jones policy->governor->name); 4851da177e4SLinus Torvalds return -EINVAL; 4861da177e4SLinus Torvalds } 4871da177e4SLinus Torvalds 4881da177e4SLinus Torvalds /** 4891da177e4SLinus Torvalds * store_scaling_governor - store policy for the specified CPU 4901da177e4SLinus Torvalds */ 4911da177e4SLinus Torvalds static ssize_t store_scaling_governor(struct cpufreq_policy *policy, 4921da177e4SLinus Torvalds const char *buf, size_t count) 4931da177e4SLinus Torvalds { 494f55c9c26SJingoo Han unsigned int ret; 4951da177e4SLinus Torvalds char str_governor[16]; 4961da177e4SLinus Torvalds struct cpufreq_policy new_policy; 4971da177e4SLinus Torvalds 4981da177e4SLinus Torvalds ret = cpufreq_get_policy(&new_policy, policy->cpu); 4991da177e4SLinus Torvalds if (ret) 5001da177e4SLinus Torvalds return ret; 5011da177e4SLinus Torvalds 5021da177e4SLinus Torvalds ret = sscanf(buf, "%15s", str_governor); 5031da177e4SLinus Torvalds if (ret != 1) 5041da177e4SLinus Torvalds return -EINVAL; 5051da177e4SLinus Torvalds 506e08f5f5bSGautham R Shenoy if (cpufreq_parse_governor(str_governor, &new_policy.policy, 507e08f5f5bSGautham R Shenoy &new_policy.governor)) 5081da177e4SLinus Torvalds return -EINVAL; 5091da177e4SLinus Torvalds 510bb176f7dSViresh Kumar /* 511bb176f7dSViresh Kumar * Do not use cpufreq_set_policy here or the user_policy.max 512bb176f7dSViresh Kumar * will be wrongly overridden 513bb176f7dSViresh Kumar */ 5147970e08bSThomas Renninger ret = __cpufreq_set_policy(policy, &new_policy); 5157970e08bSThomas Renninger 5167970e08bSThomas Renninger policy->user_policy.policy = policy->policy; 5177970e08bSThomas Renninger policy->user_policy.governor = policy->governor; 5187970e08bSThomas Renninger 519e08f5f5bSGautham R Shenoy if (ret) 520e08f5f5bSGautham R Shenoy return ret; 521e08f5f5bSGautham R Shenoy else 522e08f5f5bSGautham R Shenoy return count; 5231da177e4SLinus Torvalds } 5241da177e4SLinus Torvalds 5251da177e4SLinus Torvalds /** 5261da177e4SLinus Torvalds * show_scaling_driver - show the cpufreq driver currently loaded 5271da177e4SLinus Torvalds */ 5281da177e4SLinus Torvalds static ssize_t show_scaling_driver(struct cpufreq_policy *policy, char *buf) 5291da177e4SLinus Torvalds { 5301c3d85ddSRafael J. Wysocki return scnprintf(buf, CPUFREQ_NAME_PLEN, "%s\n", cpufreq_driver->name); 5311da177e4SLinus Torvalds } 5321da177e4SLinus Torvalds 5331da177e4SLinus Torvalds /** 5341da177e4SLinus Torvalds * show_scaling_available_governors - show the available CPUfreq governors 5351da177e4SLinus Torvalds */ 5361da177e4SLinus Torvalds static ssize_t show_scaling_available_governors(struct cpufreq_policy *policy, 5371da177e4SLinus Torvalds char *buf) 5381da177e4SLinus Torvalds { 5391da177e4SLinus Torvalds ssize_t i = 0; 5401da177e4SLinus Torvalds struct cpufreq_governor *t; 5411da177e4SLinus Torvalds 5421c3d85ddSRafael J. Wysocki if (!cpufreq_driver->target) { 5431da177e4SLinus Torvalds i += sprintf(buf, "performance powersave"); 5441da177e4SLinus Torvalds goto out; 5451da177e4SLinus Torvalds } 5461da177e4SLinus Torvalds 5471da177e4SLinus Torvalds list_for_each_entry(t, &cpufreq_governor_list, governor_list) { 54829464f28SDave Jones if (i >= (ssize_t) ((PAGE_SIZE / sizeof(char)) 54929464f28SDave Jones - (CPUFREQ_NAME_LEN + 2))) 5501da177e4SLinus Torvalds goto out; 5514b972f0bSviresh kumar i += scnprintf(&buf[i], CPUFREQ_NAME_PLEN, "%s ", t->name); 5521da177e4SLinus Torvalds } 5531da177e4SLinus Torvalds out: 5541da177e4SLinus Torvalds i += sprintf(&buf[i], "\n"); 5551da177e4SLinus Torvalds return i; 5561da177e4SLinus Torvalds } 557e8628dd0SDarrick J. Wong 558f4fd3797SLan Tianyu ssize_t cpufreq_show_cpus(const struct cpumask *mask, char *buf) 5591da177e4SLinus Torvalds { 5601da177e4SLinus Torvalds ssize_t i = 0; 5611da177e4SLinus Torvalds unsigned int cpu; 5621da177e4SLinus Torvalds 563835481d9SRusty Russell for_each_cpu(cpu, mask) { 5641da177e4SLinus Torvalds if (i) 5651da177e4SLinus Torvalds i += scnprintf(&buf[i], (PAGE_SIZE - i - 2), " "); 5661da177e4SLinus Torvalds i += scnprintf(&buf[i], (PAGE_SIZE - i - 2), "%u", cpu); 5671da177e4SLinus Torvalds if (i >= (PAGE_SIZE - 5)) 5681da177e4SLinus Torvalds break; 5691da177e4SLinus Torvalds } 5701da177e4SLinus Torvalds i += sprintf(&buf[i], "\n"); 5711da177e4SLinus Torvalds return i; 5721da177e4SLinus Torvalds } 573f4fd3797SLan Tianyu EXPORT_SYMBOL_GPL(cpufreq_show_cpus); 5741da177e4SLinus Torvalds 575e8628dd0SDarrick J. Wong /** 576e8628dd0SDarrick J. Wong * show_related_cpus - show the CPUs affected by each transition even if 577e8628dd0SDarrick J. Wong * hw coordination is in use 578e8628dd0SDarrick J. Wong */ 579e8628dd0SDarrick J. Wong static ssize_t show_related_cpus(struct cpufreq_policy *policy, char *buf) 580e8628dd0SDarrick J. Wong { 581f4fd3797SLan Tianyu return cpufreq_show_cpus(policy->related_cpus, buf); 582e8628dd0SDarrick J. Wong } 583e8628dd0SDarrick J. Wong 584e8628dd0SDarrick J. Wong /** 585e8628dd0SDarrick J. Wong * show_affected_cpus - show the CPUs affected by each transition 586e8628dd0SDarrick J. Wong */ 587e8628dd0SDarrick J. Wong static ssize_t show_affected_cpus(struct cpufreq_policy *policy, char *buf) 588e8628dd0SDarrick J. Wong { 589f4fd3797SLan Tianyu return cpufreq_show_cpus(policy->cpus, buf); 590e8628dd0SDarrick J. Wong } 591e8628dd0SDarrick J. Wong 5929e76988eSVenki Pallipadi static ssize_t store_scaling_setspeed(struct cpufreq_policy *policy, 5939e76988eSVenki Pallipadi const char *buf, size_t count) 5949e76988eSVenki Pallipadi { 5959e76988eSVenki Pallipadi unsigned int freq = 0; 5969e76988eSVenki Pallipadi unsigned int ret; 5979e76988eSVenki Pallipadi 598879000f9SCHIKAMA masaki if (!policy->governor || !policy->governor->store_setspeed) 5999e76988eSVenki Pallipadi return -EINVAL; 6009e76988eSVenki Pallipadi 6019e76988eSVenki Pallipadi ret = sscanf(buf, "%u", &freq); 6029e76988eSVenki Pallipadi if (ret != 1) 6039e76988eSVenki Pallipadi return -EINVAL; 6049e76988eSVenki Pallipadi 6059e76988eSVenki Pallipadi policy->governor->store_setspeed(policy, freq); 6069e76988eSVenki Pallipadi 6079e76988eSVenki Pallipadi return count; 6089e76988eSVenki Pallipadi } 6099e76988eSVenki Pallipadi 6109e76988eSVenki Pallipadi static ssize_t show_scaling_setspeed(struct cpufreq_policy *policy, char *buf) 6119e76988eSVenki Pallipadi { 612879000f9SCHIKAMA masaki if (!policy->governor || !policy->governor->show_setspeed) 6139e76988eSVenki Pallipadi return sprintf(buf, "<unsupported>\n"); 6149e76988eSVenki Pallipadi 6159e76988eSVenki Pallipadi return policy->governor->show_setspeed(policy, buf); 6169e76988eSVenki Pallipadi } 6171da177e4SLinus Torvalds 618e2f74f35SThomas Renninger /** 6198bf1ac72Sviresh kumar * show_bios_limit - show the current cpufreq HW/BIOS limitation 620e2f74f35SThomas Renninger */ 621e2f74f35SThomas Renninger static ssize_t show_bios_limit(struct cpufreq_policy *policy, char *buf) 622e2f74f35SThomas Renninger { 623e2f74f35SThomas Renninger unsigned int limit; 624e2f74f35SThomas Renninger int ret; 6251c3d85ddSRafael J. Wysocki if (cpufreq_driver->bios_limit) { 6261c3d85ddSRafael J. Wysocki ret = cpufreq_driver->bios_limit(policy->cpu, &limit); 627e2f74f35SThomas Renninger if (!ret) 628e2f74f35SThomas Renninger return sprintf(buf, "%u\n", limit); 629e2f74f35SThomas Renninger } 630e2f74f35SThomas Renninger return sprintf(buf, "%u\n", policy->cpuinfo.max_freq); 631e2f74f35SThomas Renninger } 632e2f74f35SThomas Renninger 6336dad2a29SBorislav Petkov cpufreq_freq_attr_ro_perm(cpuinfo_cur_freq, 0400); 6346dad2a29SBorislav Petkov cpufreq_freq_attr_ro(cpuinfo_min_freq); 6356dad2a29SBorislav Petkov cpufreq_freq_attr_ro(cpuinfo_max_freq); 6366dad2a29SBorislav Petkov cpufreq_freq_attr_ro(cpuinfo_transition_latency); 6376dad2a29SBorislav Petkov cpufreq_freq_attr_ro(scaling_available_governors); 6386dad2a29SBorislav Petkov cpufreq_freq_attr_ro(scaling_driver); 6396dad2a29SBorislav Petkov cpufreq_freq_attr_ro(scaling_cur_freq); 6406dad2a29SBorislav Petkov cpufreq_freq_attr_ro(bios_limit); 6416dad2a29SBorislav Petkov cpufreq_freq_attr_ro(related_cpus); 6426dad2a29SBorislav Petkov cpufreq_freq_attr_ro(affected_cpus); 6436dad2a29SBorislav Petkov cpufreq_freq_attr_rw(scaling_min_freq); 6446dad2a29SBorislav Petkov cpufreq_freq_attr_rw(scaling_max_freq); 6456dad2a29SBorislav Petkov cpufreq_freq_attr_rw(scaling_governor); 6466dad2a29SBorislav Petkov cpufreq_freq_attr_rw(scaling_setspeed); 6471da177e4SLinus Torvalds 6481da177e4SLinus Torvalds static struct attribute *default_attrs[] = { 6491da177e4SLinus Torvalds &cpuinfo_min_freq.attr, 6501da177e4SLinus Torvalds &cpuinfo_max_freq.attr, 651ed129784SThomas Renninger &cpuinfo_transition_latency.attr, 6521da177e4SLinus Torvalds &scaling_min_freq.attr, 6531da177e4SLinus Torvalds &scaling_max_freq.attr, 6541da177e4SLinus Torvalds &affected_cpus.attr, 655e8628dd0SDarrick J. Wong &related_cpus.attr, 6561da177e4SLinus Torvalds &scaling_governor.attr, 6571da177e4SLinus Torvalds &scaling_driver.attr, 6581da177e4SLinus Torvalds &scaling_available_governors.attr, 6599e76988eSVenki Pallipadi &scaling_setspeed.attr, 6601da177e4SLinus Torvalds NULL 6611da177e4SLinus Torvalds }; 6621da177e4SLinus Torvalds 6631da177e4SLinus Torvalds #define to_policy(k) container_of(k, struct cpufreq_policy, kobj) 6641da177e4SLinus Torvalds #define to_attr(a) container_of(a, struct freq_attr, attr) 6651da177e4SLinus Torvalds 6661da177e4SLinus Torvalds static ssize_t show(struct kobject *kobj, struct attribute *attr, char *buf) 6671da177e4SLinus Torvalds { 6681da177e4SLinus Torvalds struct cpufreq_policy *policy = to_policy(kobj); 6691da177e4SLinus Torvalds struct freq_attr *fattr = to_attr(attr); 6700db4a8a9SDave Jones ssize_t ret = -EINVAL; 671*6eed9404SViresh Kumar 672*6eed9404SViresh Kumar if (!down_read_trylock(&cpufreq_rwsem)) 673*6eed9404SViresh Kumar goto exit; 6745a01f2e8SVenkatesh Pallipadi 6755a01f2e8SVenkatesh Pallipadi if (lock_policy_rwsem_read(policy->cpu) < 0) 676*6eed9404SViresh Kumar goto up_read; 6775a01f2e8SVenkatesh Pallipadi 678e08f5f5bSGautham R Shenoy if (fattr->show) 679e08f5f5bSGautham R Shenoy ret = fattr->show(policy, buf); 680e08f5f5bSGautham R Shenoy else 681e08f5f5bSGautham R Shenoy ret = -EIO; 682e08f5f5bSGautham R Shenoy 6835a01f2e8SVenkatesh Pallipadi unlock_policy_rwsem_read(policy->cpu); 684*6eed9404SViresh Kumar 685*6eed9404SViresh Kumar up_read: 686*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 687*6eed9404SViresh Kumar exit: 6881da177e4SLinus Torvalds return ret; 6891da177e4SLinus Torvalds } 6901da177e4SLinus Torvalds 6911da177e4SLinus Torvalds static ssize_t store(struct kobject *kobj, struct attribute *attr, 6921da177e4SLinus Torvalds const char *buf, size_t count) 6931da177e4SLinus Torvalds { 6941da177e4SLinus Torvalds struct cpufreq_policy *policy = to_policy(kobj); 6951da177e4SLinus Torvalds struct freq_attr *fattr = to_attr(attr); 696a07530b4SDave Jones ssize_t ret = -EINVAL; 697*6eed9404SViresh Kumar 698*6eed9404SViresh Kumar if (!down_read_trylock(&cpufreq_rwsem)) 699*6eed9404SViresh Kumar goto exit; 7005a01f2e8SVenkatesh Pallipadi 7015a01f2e8SVenkatesh Pallipadi if (lock_policy_rwsem_write(policy->cpu) < 0) 702*6eed9404SViresh Kumar goto up_read; 7035a01f2e8SVenkatesh Pallipadi 704e08f5f5bSGautham R Shenoy if (fattr->store) 705e08f5f5bSGautham R Shenoy ret = fattr->store(policy, buf, count); 706e08f5f5bSGautham R Shenoy else 707e08f5f5bSGautham R Shenoy ret = -EIO; 708e08f5f5bSGautham R Shenoy 7095a01f2e8SVenkatesh Pallipadi unlock_policy_rwsem_write(policy->cpu); 710*6eed9404SViresh Kumar 711*6eed9404SViresh Kumar up_read: 712*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 713*6eed9404SViresh Kumar exit: 7141da177e4SLinus Torvalds return ret; 7151da177e4SLinus Torvalds } 7161da177e4SLinus Torvalds 7171da177e4SLinus Torvalds static void cpufreq_sysfs_release(struct kobject *kobj) 7181da177e4SLinus Torvalds { 7191da177e4SLinus Torvalds struct cpufreq_policy *policy = to_policy(kobj); 7202d06d8c4SDominik Brodowski pr_debug("last reference is dropped\n"); 7211da177e4SLinus Torvalds complete(&policy->kobj_unregister); 7221da177e4SLinus Torvalds } 7231da177e4SLinus Torvalds 72452cf25d0SEmese Revfy static const struct sysfs_ops sysfs_ops = { 7251da177e4SLinus Torvalds .show = show, 7261da177e4SLinus Torvalds .store = store, 7271da177e4SLinus Torvalds }; 7281da177e4SLinus Torvalds 7291da177e4SLinus Torvalds static struct kobj_type ktype_cpufreq = { 7301da177e4SLinus Torvalds .sysfs_ops = &sysfs_ops, 7311da177e4SLinus Torvalds .default_attrs = default_attrs, 7321da177e4SLinus Torvalds .release = cpufreq_sysfs_release, 7331da177e4SLinus Torvalds }; 7341da177e4SLinus Torvalds 7352361be23SViresh Kumar struct kobject *cpufreq_global_kobject; 7362361be23SViresh Kumar EXPORT_SYMBOL(cpufreq_global_kobject); 7372361be23SViresh Kumar 7382361be23SViresh Kumar static int cpufreq_global_kobject_usage; 7392361be23SViresh Kumar 7402361be23SViresh Kumar int cpufreq_get_global_kobject(void) 7412361be23SViresh Kumar { 7422361be23SViresh Kumar if (!cpufreq_global_kobject_usage++) 7432361be23SViresh Kumar return kobject_add(cpufreq_global_kobject, 7442361be23SViresh Kumar &cpu_subsys.dev_root->kobj, "%s", "cpufreq"); 7452361be23SViresh Kumar 7462361be23SViresh Kumar return 0; 7472361be23SViresh Kumar } 7482361be23SViresh Kumar EXPORT_SYMBOL(cpufreq_get_global_kobject); 7492361be23SViresh Kumar 7502361be23SViresh Kumar void cpufreq_put_global_kobject(void) 7512361be23SViresh Kumar { 7522361be23SViresh Kumar if (!--cpufreq_global_kobject_usage) 7532361be23SViresh Kumar kobject_del(cpufreq_global_kobject); 7542361be23SViresh Kumar } 7552361be23SViresh Kumar EXPORT_SYMBOL(cpufreq_put_global_kobject); 7562361be23SViresh Kumar 7572361be23SViresh Kumar int cpufreq_sysfs_create_file(const struct attribute *attr) 7582361be23SViresh Kumar { 7592361be23SViresh Kumar int ret = cpufreq_get_global_kobject(); 7602361be23SViresh Kumar 7612361be23SViresh Kumar if (!ret) { 7622361be23SViresh Kumar ret = sysfs_create_file(cpufreq_global_kobject, attr); 7632361be23SViresh Kumar if (ret) 7642361be23SViresh Kumar cpufreq_put_global_kobject(); 7652361be23SViresh Kumar } 7662361be23SViresh Kumar 7672361be23SViresh Kumar return ret; 7682361be23SViresh Kumar } 7692361be23SViresh Kumar EXPORT_SYMBOL(cpufreq_sysfs_create_file); 7702361be23SViresh Kumar 7712361be23SViresh Kumar void cpufreq_sysfs_remove_file(const struct attribute *attr) 7722361be23SViresh Kumar { 7732361be23SViresh Kumar sysfs_remove_file(cpufreq_global_kobject, attr); 7742361be23SViresh Kumar cpufreq_put_global_kobject(); 7752361be23SViresh Kumar } 7762361be23SViresh Kumar EXPORT_SYMBOL(cpufreq_sysfs_remove_file); 7772361be23SViresh Kumar 77819d6f7ecSDave Jones /* symlink affected CPUs */ 779308b60e7SViresh Kumar static int cpufreq_add_dev_symlink(struct cpufreq_policy *policy) 78019d6f7ecSDave Jones { 78119d6f7ecSDave Jones unsigned int j; 78219d6f7ecSDave Jones int ret = 0; 78319d6f7ecSDave Jones 78419d6f7ecSDave Jones for_each_cpu(j, policy->cpus) { 7858a25a2fdSKay Sievers struct device *cpu_dev; 78619d6f7ecSDave Jones 787308b60e7SViresh Kumar if (j == policy->cpu) 78819d6f7ecSDave Jones continue; 78919d6f7ecSDave Jones 790e8fdde10SViresh Kumar pr_debug("Adding link for CPU: %u\n", j); 7918a25a2fdSKay Sievers cpu_dev = get_cpu_device(j); 7928a25a2fdSKay Sievers ret = sysfs_create_link(&cpu_dev->kobj, &policy->kobj, 79319d6f7ecSDave Jones "cpufreq"); 79471c3461eSRafael J. Wysocki if (ret) 79571c3461eSRafael J. Wysocki break; 79619d6f7ecSDave Jones } 79719d6f7ecSDave Jones return ret; 79819d6f7ecSDave Jones } 79919d6f7ecSDave Jones 800308b60e7SViresh Kumar static int cpufreq_add_dev_interface(struct cpufreq_policy *policy, 8018a25a2fdSKay Sievers struct device *dev) 802909a694eSDave Jones { 803909a694eSDave Jones struct freq_attr **drv_attr; 804909a694eSDave Jones int ret = 0; 805909a694eSDave Jones 806909a694eSDave Jones /* prepare interface data */ 807909a694eSDave Jones ret = kobject_init_and_add(&policy->kobj, &ktype_cpufreq, 8088a25a2fdSKay Sievers &dev->kobj, "cpufreq"); 809909a694eSDave Jones if (ret) 810909a694eSDave Jones return ret; 811909a694eSDave Jones 812909a694eSDave Jones /* set up files for this cpu device */ 8131c3d85ddSRafael J. Wysocki drv_attr = cpufreq_driver->attr; 814909a694eSDave Jones while ((drv_attr) && (*drv_attr)) { 815909a694eSDave Jones ret = sysfs_create_file(&policy->kobj, &((*drv_attr)->attr)); 816909a694eSDave Jones if (ret) 8171c3d85ddSRafael J. Wysocki goto err_out_kobj_put; 818909a694eSDave Jones drv_attr++; 819909a694eSDave Jones } 8201c3d85ddSRafael J. Wysocki if (cpufreq_driver->get) { 821909a694eSDave Jones ret = sysfs_create_file(&policy->kobj, &cpuinfo_cur_freq.attr); 822909a694eSDave Jones if (ret) 8231c3d85ddSRafael J. Wysocki goto err_out_kobj_put; 824909a694eSDave Jones } 8251c3d85ddSRafael J. Wysocki if (cpufreq_driver->target) { 826909a694eSDave Jones ret = sysfs_create_file(&policy->kobj, &scaling_cur_freq.attr); 827909a694eSDave Jones if (ret) 8281c3d85ddSRafael J. Wysocki goto err_out_kobj_put; 829909a694eSDave Jones } 8301c3d85ddSRafael J. Wysocki if (cpufreq_driver->bios_limit) { 831e2f74f35SThomas Renninger ret = sysfs_create_file(&policy->kobj, &bios_limit.attr); 832e2f74f35SThomas Renninger if (ret) 8331c3d85ddSRafael J. Wysocki goto err_out_kobj_put; 834e2f74f35SThomas Renninger } 835909a694eSDave Jones 836308b60e7SViresh Kumar ret = cpufreq_add_dev_symlink(policy); 837ecf7e461SDave Jones if (ret) 838ecf7e461SDave Jones goto err_out_kobj_put; 839ecf7e461SDave Jones 840e18f1682SSrivatsa S. Bhat return ret; 841e18f1682SSrivatsa S. Bhat 842e18f1682SSrivatsa S. Bhat err_out_kobj_put: 843e18f1682SSrivatsa S. Bhat kobject_put(&policy->kobj); 844e18f1682SSrivatsa S. Bhat wait_for_completion(&policy->kobj_unregister); 845e18f1682SSrivatsa S. Bhat return ret; 846e18f1682SSrivatsa S. Bhat } 847e18f1682SSrivatsa S. Bhat 848e18f1682SSrivatsa S. Bhat static void cpufreq_init_policy(struct cpufreq_policy *policy) 849e18f1682SSrivatsa S. Bhat { 850e18f1682SSrivatsa S. Bhat struct cpufreq_policy new_policy; 851e18f1682SSrivatsa S. Bhat int ret = 0; 852e18f1682SSrivatsa S. Bhat 853d5b73cd8SViresh Kumar memcpy(&new_policy, policy, sizeof(*policy)); 854ecf7e461SDave Jones /* assure that the starting sequence is run in __cpufreq_set_policy */ 855ecf7e461SDave Jones policy->governor = NULL; 856ecf7e461SDave Jones 857ecf7e461SDave Jones /* set default policy */ 858ecf7e461SDave Jones ret = __cpufreq_set_policy(policy, &new_policy); 859ecf7e461SDave Jones policy->user_policy.policy = policy->policy; 860ecf7e461SDave Jones policy->user_policy.governor = policy->governor; 861ecf7e461SDave Jones 862ecf7e461SDave Jones if (ret) { 8632d06d8c4SDominik Brodowski pr_debug("setting policy failed\n"); 8641c3d85ddSRafael J. Wysocki if (cpufreq_driver->exit) 8651c3d85ddSRafael J. Wysocki cpufreq_driver->exit(policy); 866ecf7e461SDave Jones } 867909a694eSDave Jones } 868909a694eSDave Jones 869fcf80582SViresh Kumar #ifdef CONFIG_HOTPLUG_CPU 870d8d3b471SViresh Kumar static int cpufreq_add_policy_cpu(struct cpufreq_policy *policy, 871d8d3b471SViresh Kumar unsigned int cpu, struct device *dev, 872d8d3b471SViresh Kumar bool frozen) 873fcf80582SViresh Kumar { 8741c3d85ddSRafael J. Wysocki int ret = 0, has_target = !!cpufreq_driver->target; 875fcf80582SViresh Kumar unsigned long flags; 876fcf80582SViresh Kumar 877820c6ca2SViresh Kumar if (has_target) 878fcf80582SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_STOP); 879fcf80582SViresh Kumar 880d8d3b471SViresh Kumar lock_policy_rwsem_write(policy->cpu); 8812eaa3e2dSViresh Kumar 8820d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 8832eaa3e2dSViresh Kumar 884fcf80582SViresh Kumar cpumask_set_cpu(cpu, policy->cpus); 8852eaa3e2dSViresh Kumar per_cpu(cpufreq_policy_cpu, cpu) = policy->cpu; 886fcf80582SViresh Kumar per_cpu(cpufreq_cpu_data, cpu) = policy; 8870d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 888fcf80582SViresh Kumar 889d8d3b471SViresh Kumar unlock_policy_rwsem_write(policy->cpu); 8902eaa3e2dSViresh Kumar 891820c6ca2SViresh Kumar if (has_target) { 892fcf80582SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_START); 893fcf80582SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_LIMITS); 894820c6ca2SViresh Kumar } 895fcf80582SViresh Kumar 896a82fab29SSrivatsa S. Bhat /* Don't touch sysfs links during light-weight init */ 89771c3461eSRafael J. Wysocki if (!frozen) 898a82fab29SSrivatsa S. Bhat ret = sysfs_create_link(&dev->kobj, &policy->kobj, "cpufreq"); 899a82fab29SSrivatsa S. Bhat 900a82fab29SSrivatsa S. Bhat return ret; 901fcf80582SViresh Kumar } 902fcf80582SViresh Kumar #endif 9031da177e4SLinus Torvalds 9048414809cSSrivatsa S. Bhat static struct cpufreq_policy *cpufreq_policy_restore(unsigned int cpu) 9058414809cSSrivatsa S. Bhat { 9068414809cSSrivatsa S. Bhat struct cpufreq_policy *policy; 9078414809cSSrivatsa S. Bhat unsigned long flags; 9088414809cSSrivatsa S. Bhat 9098414809cSSrivatsa S. Bhat write_lock_irqsave(&cpufreq_driver_lock, flags); 9108414809cSSrivatsa S. Bhat 9118414809cSSrivatsa S. Bhat policy = per_cpu(cpufreq_cpu_data_fallback, cpu); 9128414809cSSrivatsa S. Bhat 9138414809cSSrivatsa S. Bhat write_unlock_irqrestore(&cpufreq_driver_lock, flags); 9148414809cSSrivatsa S. Bhat 9158414809cSSrivatsa S. Bhat return policy; 9168414809cSSrivatsa S. Bhat } 9178414809cSSrivatsa S. Bhat 918e9698cc5SSrivatsa S. Bhat static struct cpufreq_policy *cpufreq_policy_alloc(void) 919e9698cc5SSrivatsa S. Bhat { 920e9698cc5SSrivatsa S. Bhat struct cpufreq_policy *policy; 921e9698cc5SSrivatsa S. Bhat 922e9698cc5SSrivatsa S. Bhat policy = kzalloc(sizeof(*policy), GFP_KERNEL); 923e9698cc5SSrivatsa S. Bhat if (!policy) 924e9698cc5SSrivatsa S. Bhat return NULL; 925e9698cc5SSrivatsa S. Bhat 926e9698cc5SSrivatsa S. Bhat if (!alloc_cpumask_var(&policy->cpus, GFP_KERNEL)) 927e9698cc5SSrivatsa S. Bhat goto err_free_policy; 928e9698cc5SSrivatsa S. Bhat 929e9698cc5SSrivatsa S. Bhat if (!zalloc_cpumask_var(&policy->related_cpus, GFP_KERNEL)) 930e9698cc5SSrivatsa S. Bhat goto err_free_cpumask; 931e9698cc5SSrivatsa S. Bhat 932c88a1f8bSLukasz Majewski INIT_LIST_HEAD(&policy->policy_list); 933e9698cc5SSrivatsa S. Bhat return policy; 934e9698cc5SSrivatsa S. Bhat 935e9698cc5SSrivatsa S. Bhat err_free_cpumask: 936e9698cc5SSrivatsa S. Bhat free_cpumask_var(policy->cpus); 937e9698cc5SSrivatsa S. Bhat err_free_policy: 938e9698cc5SSrivatsa S. Bhat kfree(policy); 939e9698cc5SSrivatsa S. Bhat 940e9698cc5SSrivatsa S. Bhat return NULL; 941e9698cc5SSrivatsa S. Bhat } 942e9698cc5SSrivatsa S. Bhat 943e9698cc5SSrivatsa S. Bhat static void cpufreq_policy_free(struct cpufreq_policy *policy) 944e9698cc5SSrivatsa S. Bhat { 945c88a1f8bSLukasz Majewski unsigned long flags; 946c88a1f8bSLukasz Majewski 947c88a1f8bSLukasz Majewski write_lock_irqsave(&cpufreq_driver_lock, flags); 948c88a1f8bSLukasz Majewski list_del(&policy->policy_list); 949c88a1f8bSLukasz Majewski write_unlock_irqrestore(&cpufreq_driver_lock, flags); 950c88a1f8bSLukasz Majewski 951e9698cc5SSrivatsa S. Bhat free_cpumask_var(policy->related_cpus); 952e9698cc5SSrivatsa S. Bhat free_cpumask_var(policy->cpus); 953e9698cc5SSrivatsa S. Bhat kfree(policy); 954e9698cc5SSrivatsa S. Bhat } 955e9698cc5SSrivatsa S. Bhat 956a82fab29SSrivatsa S. Bhat static int __cpufreq_add_dev(struct device *dev, struct subsys_interface *sif, 957a82fab29SSrivatsa S. Bhat bool frozen) 9581da177e4SLinus Torvalds { 959fcf80582SViresh Kumar unsigned int j, cpu = dev->id; 96065922465SViresh Kumar int ret = -ENOMEM; 9611da177e4SLinus Torvalds struct cpufreq_policy *policy; 9621da177e4SLinus Torvalds unsigned long flags; 96390e41bacSPrarit Bhargava #ifdef CONFIG_HOTPLUG_CPU 964eb608521SViresh Kumar struct cpufreq_policy *tpolicy; 965fcf80582SViresh Kumar struct cpufreq_governor *gov; 96690e41bacSPrarit Bhargava #endif 9671da177e4SLinus Torvalds 968c32b6b8eSAshok Raj if (cpu_is_offline(cpu)) 969c32b6b8eSAshok Raj return 0; 970c32b6b8eSAshok Raj 9712d06d8c4SDominik Brodowski pr_debug("adding CPU %u\n", cpu); 9721da177e4SLinus Torvalds 9731da177e4SLinus Torvalds #ifdef CONFIG_SMP 9741da177e4SLinus Torvalds /* check whether a different CPU already registered this 9751da177e4SLinus Torvalds * CPU because it is in the same boat. */ 9761da177e4SLinus Torvalds policy = cpufreq_cpu_get(cpu); 9771da177e4SLinus Torvalds if (unlikely(policy)) { 9788ff69732SDave Jones cpufreq_cpu_put(policy); 9791da177e4SLinus Torvalds return 0; 9801da177e4SLinus Torvalds } 981fcf80582SViresh Kumar 982*6eed9404SViresh Kumar if (!down_read_trylock(&cpufreq_rwsem)) 983*6eed9404SViresh Kumar return 0; 984*6eed9404SViresh Kumar 985fcf80582SViresh Kumar #ifdef CONFIG_HOTPLUG_CPU 986fcf80582SViresh Kumar /* Check if this cpu was hot-unplugged earlier and has siblings */ 9870d1857a1SNathan Zimmer read_lock_irqsave(&cpufreq_driver_lock, flags); 988eb608521SViresh Kumar list_for_each_entry(tpolicy, &cpufreq_policy_list, policy_list) { 989eb608521SViresh Kumar if (cpumask_test_cpu(cpu, tpolicy->related_cpus)) { 9900d1857a1SNathan Zimmer read_unlock_irqrestore(&cpufreq_driver_lock, flags); 991*6eed9404SViresh Kumar ret = cpufreq_add_policy_cpu(tpolicy, cpu, dev, frozen); 992*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 993*6eed9404SViresh Kumar return ret; 994fcf80582SViresh Kumar } 9952eaa3e2dSViresh Kumar } 9960d1857a1SNathan Zimmer read_unlock_irqrestore(&cpufreq_driver_lock, flags); 997fcf80582SViresh Kumar #endif 9981da177e4SLinus Torvalds #endif 9991da177e4SLinus Torvalds 10008414809cSSrivatsa S. Bhat if (frozen) 10018414809cSSrivatsa S. Bhat /* Restore the saved policy when doing light-weight init */ 10028414809cSSrivatsa S. Bhat policy = cpufreq_policy_restore(cpu); 10038414809cSSrivatsa S. Bhat else 1004e9698cc5SSrivatsa S. Bhat policy = cpufreq_policy_alloc(); 10058414809cSSrivatsa S. Bhat 1006059019a3SDave Jones if (!policy) 10071da177e4SLinus Torvalds goto nomem_out; 1008059019a3SDave Jones 10091da177e4SLinus Torvalds policy->cpu = cpu; 101065922465SViresh Kumar policy->governor = CPUFREQ_DEFAULT_GOVERNOR; 1011835481d9SRusty Russell cpumask_copy(policy->cpus, cpumask_of(cpu)); 10121da177e4SLinus Torvalds 10135a01f2e8SVenkatesh Pallipadi /* Initially set CPU itself as the policy_cpu */ 1014f1625066STejun Heo per_cpu(cpufreq_policy_cpu, cpu) = cpu; 10155a01f2e8SVenkatesh Pallipadi 10161da177e4SLinus Torvalds init_completion(&policy->kobj_unregister); 101765f27f38SDavid Howells INIT_WORK(&policy->update, handle_update); 10181da177e4SLinus Torvalds 10191da177e4SLinus Torvalds /* call driver. From then on the cpufreq must be able 10201da177e4SLinus Torvalds * to accept all calls to ->verify and ->setpolicy for this CPU 10211da177e4SLinus Torvalds */ 10221c3d85ddSRafael J. Wysocki ret = cpufreq_driver->init(policy); 10231da177e4SLinus Torvalds if (ret) { 10242d06d8c4SDominik Brodowski pr_debug("initialization failed\n"); 10252eaa3e2dSViresh Kumar goto err_set_policy_cpu; 10261da177e4SLinus Torvalds } 1027643ae6e8SViresh Kumar 1028fcf80582SViresh Kumar /* related cpus should atleast have policy->cpus */ 1029fcf80582SViresh Kumar cpumask_or(policy->related_cpus, policy->related_cpus, policy->cpus); 1030fcf80582SViresh Kumar 1031643ae6e8SViresh Kumar /* 1032643ae6e8SViresh Kumar * affected cpus must always be the one, which are online. We aren't 1033643ae6e8SViresh Kumar * managing offline cpus here. 1034643ae6e8SViresh Kumar */ 1035643ae6e8SViresh Kumar cpumask_and(policy->cpus, policy->cpus, cpu_online_mask); 1036643ae6e8SViresh Kumar 1037187d9f4eSMike Chan policy->user_policy.min = policy->min; 1038187d9f4eSMike Chan policy->user_policy.max = policy->max; 10391da177e4SLinus Torvalds 1040a1531acdSThomas Renninger blocking_notifier_call_chain(&cpufreq_policy_notifier_list, 1041a1531acdSThomas Renninger CPUFREQ_START, policy); 1042a1531acdSThomas Renninger 1043fcf80582SViresh Kumar #ifdef CONFIG_HOTPLUG_CPU 1044fcf80582SViresh Kumar gov = __find_governor(per_cpu(cpufreq_cpu_governor, cpu)); 1045fcf80582SViresh Kumar if (gov) { 1046fcf80582SViresh Kumar policy->governor = gov; 1047fcf80582SViresh Kumar pr_debug("Restoring governor %s for cpu %d\n", 1048fcf80582SViresh Kumar policy->governor->name, cpu); 10494bfa042cSThomas Renninger } 1050fcf80582SViresh Kumar #endif 10511da177e4SLinus Torvalds 1052e18f1682SSrivatsa S. Bhat write_lock_irqsave(&cpufreq_driver_lock, flags); 1053e18f1682SSrivatsa S. Bhat for_each_cpu(j, policy->cpus) { 1054e18f1682SSrivatsa S. Bhat per_cpu(cpufreq_cpu_data, j) = policy; 1055e18f1682SSrivatsa S. Bhat per_cpu(cpufreq_policy_cpu, j) = policy->cpu; 1056e18f1682SSrivatsa S. Bhat } 1057e18f1682SSrivatsa S. Bhat write_unlock_irqrestore(&cpufreq_driver_lock, flags); 1058e18f1682SSrivatsa S. Bhat 1059a82fab29SSrivatsa S. Bhat if (!frozen) { 1060308b60e7SViresh Kumar ret = cpufreq_add_dev_interface(policy, dev); 106119d6f7ecSDave Jones if (ret) 10620142f9dcSAhmed S. Darwish goto err_out_unregister; 1063c88a1f8bSLukasz Majewski 1064c88a1f8bSLukasz Majewski write_lock_irqsave(&cpufreq_driver_lock, flags); 1065c88a1f8bSLukasz Majewski list_add(&policy->policy_list, &cpufreq_policy_list); 1066c88a1f8bSLukasz Majewski write_unlock_irqrestore(&cpufreq_driver_lock, flags); 1067a82fab29SSrivatsa S. Bhat } 10688ff69732SDave Jones 1069e18f1682SSrivatsa S. Bhat cpufreq_init_policy(policy); 1070e18f1682SSrivatsa S. Bhat 1071038c5b3eSGreg Kroah-Hartman kobject_uevent(&policy->kobj, KOBJ_ADD); 1072*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 1073*6eed9404SViresh Kumar 10742d06d8c4SDominik Brodowski pr_debug("initialization complete\n"); 10751da177e4SLinus Torvalds 10761da177e4SLinus Torvalds return 0; 10771da177e4SLinus Torvalds 10781da177e4SLinus Torvalds err_out_unregister: 10790d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 1080e18f1682SSrivatsa S. Bhat for_each_cpu(j, policy->cpus) { 10817a6aedfaSMike Travis per_cpu(cpufreq_cpu_data, j) = NULL; 1082e18f1682SSrivatsa S. Bhat if (j != cpu) 1083e18f1682SSrivatsa S. Bhat per_cpu(cpufreq_policy_cpu, j) = -1; 1084e18f1682SSrivatsa S. Bhat } 10850d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 10861da177e4SLinus Torvalds 10872eaa3e2dSViresh Kumar err_set_policy_cpu: 10882eaa3e2dSViresh Kumar per_cpu(cpufreq_policy_cpu, cpu) = -1; 1089e9698cc5SSrivatsa S. Bhat cpufreq_policy_free(policy); 10901da177e4SLinus Torvalds nomem_out: 1091*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 1092*6eed9404SViresh Kumar 10931da177e4SLinus Torvalds return ret; 10941da177e4SLinus Torvalds } 10951da177e4SLinus Torvalds 1096a82fab29SSrivatsa S. Bhat /** 1097a82fab29SSrivatsa S. Bhat * cpufreq_add_dev - add a CPU device 1098a82fab29SSrivatsa S. Bhat * 1099a82fab29SSrivatsa S. Bhat * Adds the cpufreq interface for a CPU device. 1100a82fab29SSrivatsa S. Bhat * 1101a82fab29SSrivatsa S. Bhat * The Oracle says: try running cpufreq registration/unregistration concurrently 1102a82fab29SSrivatsa S. Bhat * with with cpu hotplugging and all hell will break loose. Tried to clean this 1103a82fab29SSrivatsa S. Bhat * mess up, but more thorough testing is needed. - Mathieu 1104a82fab29SSrivatsa S. Bhat */ 1105a82fab29SSrivatsa S. Bhat static int cpufreq_add_dev(struct device *dev, struct subsys_interface *sif) 1106a82fab29SSrivatsa S. Bhat { 1107a82fab29SSrivatsa S. Bhat return __cpufreq_add_dev(dev, sif, false); 1108a82fab29SSrivatsa S. Bhat } 1109a82fab29SSrivatsa S. Bhat 1110b8eed8afSViresh Kumar static void update_policy_cpu(struct cpufreq_policy *policy, unsigned int cpu) 1111b8eed8afSViresh Kumar { 1112b8eed8afSViresh Kumar int j; 1113b8eed8afSViresh Kumar 1114b8eed8afSViresh Kumar policy->last_cpu = policy->cpu; 1115b8eed8afSViresh Kumar policy->cpu = cpu; 1116b8eed8afSViresh Kumar 11173361b7b1SViresh Kumar for_each_cpu(j, policy->cpus) 1118b8eed8afSViresh Kumar per_cpu(cpufreq_policy_cpu, j) = cpu; 1119b8eed8afSViresh Kumar 1120b8eed8afSViresh Kumar #ifdef CONFIG_CPU_FREQ_TABLE 1121b8eed8afSViresh Kumar cpufreq_frequency_table_update_policy_cpu(policy); 1122b8eed8afSViresh Kumar #endif 1123b8eed8afSViresh Kumar blocking_notifier_call_chain(&cpufreq_policy_notifier_list, 1124b8eed8afSViresh Kumar CPUFREQ_UPDATE_POLICY_CPU, policy); 1125b8eed8afSViresh Kumar } 11261da177e4SLinus Torvalds 11273a3e9e06SViresh Kumar static int cpufreq_nominate_new_policy_cpu(struct cpufreq_policy *policy, 1128a82fab29SSrivatsa S. Bhat unsigned int old_cpu, bool frozen) 1129f9ba680dSSrivatsa S. Bhat { 1130f9ba680dSSrivatsa S. Bhat struct device *cpu_dev; 1131f9ba680dSSrivatsa S. Bhat unsigned long flags; 1132f9ba680dSSrivatsa S. Bhat int ret; 1133f9ba680dSSrivatsa S. Bhat 1134f9ba680dSSrivatsa S. Bhat /* first sibling now owns the new sysfs dir */ 11353a3e9e06SViresh Kumar cpu_dev = get_cpu_device(cpumask_first(policy->cpus)); 1136a82fab29SSrivatsa S. Bhat 1137a82fab29SSrivatsa S. Bhat /* Don't touch sysfs files during light-weight tear-down */ 1138a82fab29SSrivatsa S. Bhat if (frozen) 1139a82fab29SSrivatsa S. Bhat return cpu_dev->id; 1140a82fab29SSrivatsa S. Bhat 1141f9ba680dSSrivatsa S. Bhat sysfs_remove_link(&cpu_dev->kobj, "cpufreq"); 11423a3e9e06SViresh Kumar ret = kobject_move(&policy->kobj, &cpu_dev->kobj); 1143f9ba680dSSrivatsa S. Bhat if (ret) { 1144f9ba680dSSrivatsa S. Bhat pr_err("%s: Failed to move kobj: %d", __func__, ret); 1145f9ba680dSSrivatsa S. Bhat 1146f9ba680dSSrivatsa S. Bhat WARN_ON(lock_policy_rwsem_write(old_cpu)); 11473a3e9e06SViresh Kumar cpumask_set_cpu(old_cpu, policy->cpus); 1148f9ba680dSSrivatsa S. Bhat 1149f9ba680dSSrivatsa S. Bhat write_lock_irqsave(&cpufreq_driver_lock, flags); 11503a3e9e06SViresh Kumar per_cpu(cpufreq_cpu_data, old_cpu) = policy; 1151f9ba680dSSrivatsa S. Bhat write_unlock_irqrestore(&cpufreq_driver_lock, flags); 1152f9ba680dSSrivatsa S. Bhat 1153f9ba680dSSrivatsa S. Bhat unlock_policy_rwsem_write(old_cpu); 1154f9ba680dSSrivatsa S. Bhat 11553a3e9e06SViresh Kumar ret = sysfs_create_link(&cpu_dev->kobj, &policy->kobj, 1156f9ba680dSSrivatsa S. Bhat "cpufreq"); 1157f9ba680dSSrivatsa S. Bhat 1158f9ba680dSSrivatsa S. Bhat return -EINVAL; 1159f9ba680dSSrivatsa S. Bhat } 1160f9ba680dSSrivatsa S. Bhat 1161f9ba680dSSrivatsa S. Bhat return cpu_dev->id; 1162f9ba680dSSrivatsa S. Bhat } 1163f9ba680dSSrivatsa S. Bhat 11641da177e4SLinus Torvalds /** 11655a01f2e8SVenkatesh Pallipadi * __cpufreq_remove_dev - remove a CPU device 11661da177e4SLinus Torvalds * 11671da177e4SLinus Torvalds * Removes the cpufreq interface for a CPU device. 11685a01f2e8SVenkatesh Pallipadi * Caller should already have policy_rwsem in write mode for this CPU. 11695a01f2e8SVenkatesh Pallipadi * This routine frees the rwsem before returning. 11701da177e4SLinus Torvalds */ 1171bb176f7dSViresh Kumar static int __cpufreq_remove_dev(struct device *dev, 1172a82fab29SSrivatsa S. Bhat struct subsys_interface *sif, bool frozen) 11731da177e4SLinus Torvalds { 1174f9ba680dSSrivatsa S. Bhat unsigned int cpu = dev->id, cpus; 1175f9ba680dSSrivatsa S. Bhat int new_cpu; 11761da177e4SLinus Torvalds unsigned long flags; 11773a3e9e06SViresh Kumar struct cpufreq_policy *policy; 1178499bca9bSAmerigo Wang struct kobject *kobj; 1179499bca9bSAmerigo Wang struct completion *cmp; 11801da177e4SLinus Torvalds 1181b8eed8afSViresh Kumar pr_debug("%s: unregistering CPU %u\n", __func__, cpu); 11821da177e4SLinus Torvalds 11830d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 11841da177e4SLinus Torvalds 11853a3e9e06SViresh Kumar policy = per_cpu(cpufreq_cpu_data, cpu); 11867a6aedfaSMike Travis per_cpu(cpufreq_cpu_data, cpu) = NULL; 11871da177e4SLinus Torvalds 11888414809cSSrivatsa S. Bhat /* Save the policy somewhere when doing a light-weight tear-down */ 11898414809cSSrivatsa S. Bhat if (frozen) 11903a3e9e06SViresh Kumar per_cpu(cpufreq_cpu_data_fallback, cpu) = policy; 11918414809cSSrivatsa S. Bhat 11920d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 11931da177e4SLinus Torvalds 11943a3e9e06SViresh Kumar if (!policy) { 1195b8eed8afSViresh Kumar pr_debug("%s: No cpu_data found\n", __func__); 11961da177e4SLinus Torvalds return -EINVAL; 11971da177e4SLinus Torvalds } 11981da177e4SLinus Torvalds 11991c3d85ddSRafael J. Wysocki if (cpufreq_driver->target) 12003a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_STOP); 12015a01f2e8SVenkatesh Pallipadi 12021da177e4SLinus Torvalds #ifdef CONFIG_HOTPLUG_CPU 12031c3d85ddSRafael J. Wysocki if (!cpufreq_driver->setpolicy) 1204fa69e33fSDirk Brandewie strncpy(per_cpu(cpufreq_cpu_governor, cpu), 12053a3e9e06SViresh Kumar policy->governor->name, CPUFREQ_NAME_LEN); 12061da177e4SLinus Torvalds #endif 12071da177e4SLinus Torvalds 12082eaa3e2dSViresh Kumar WARN_ON(lock_policy_rwsem_write(cpu)); 12093a3e9e06SViresh Kumar cpus = cpumask_weight(policy->cpus); 1210e4969ebaSViresh Kumar 1211e4969ebaSViresh Kumar if (cpus > 1) 12123a3e9e06SViresh Kumar cpumask_clear_cpu(cpu, policy->cpus); 12132eaa3e2dSViresh Kumar unlock_policy_rwsem_write(cpu); 12141da177e4SLinus Torvalds 12153a3e9e06SViresh Kumar if (cpu != policy->cpu && !frozen) { 121673bf0fc2SViresh Kumar sysfs_remove_link(&dev->kobj, "cpufreq"); 121773bf0fc2SViresh Kumar } else if (cpus > 1) { 12182eaa3e2dSViresh Kumar 12193a3e9e06SViresh Kumar new_cpu = cpufreq_nominate_new_policy_cpu(policy, cpu, frozen); 1220f9ba680dSSrivatsa S. Bhat if (new_cpu >= 0) { 12212eaa3e2dSViresh Kumar WARN_ON(lock_policy_rwsem_write(cpu)); 12223a3e9e06SViresh Kumar update_policy_cpu(policy, new_cpu); 12232eaa3e2dSViresh Kumar unlock_policy_rwsem_write(cpu); 1224a82fab29SSrivatsa S. Bhat 1225a82fab29SSrivatsa S. Bhat if (!frozen) { 1226f9ba680dSSrivatsa S. Bhat pr_debug("%s: policy Kobject moved to cpu: %d " 1227f9ba680dSSrivatsa S. Bhat "from: %d\n",__func__, new_cpu, cpu); 12281da177e4SLinus Torvalds } 12291da177e4SLinus Torvalds } 1230a82fab29SSrivatsa S. Bhat } 1231b8eed8afSViresh Kumar 1232b8eed8afSViresh Kumar /* If cpu is last user of policy, free policy */ 1233b8eed8afSViresh Kumar if (cpus == 1) { 12342a998599SRafael J. Wysocki if (cpufreq_driver->target) 12353a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_POLICY_EXIT); 12362a998599SRafael J. Wysocki 12378414809cSSrivatsa S. Bhat if (!frozen) { 12382eaa3e2dSViresh Kumar lock_policy_rwsem_read(cpu); 12393a3e9e06SViresh Kumar kobj = &policy->kobj; 12403a3e9e06SViresh Kumar cmp = &policy->kobj_unregister; 12412eaa3e2dSViresh Kumar unlock_policy_rwsem_read(cpu); 1242499bca9bSAmerigo Wang kobject_put(kobj); 12431da177e4SLinus Torvalds 12448414809cSSrivatsa S. Bhat /* 12458414809cSSrivatsa S. Bhat * We need to make sure that the underlying kobj is 12468414809cSSrivatsa S. Bhat * actually not referenced anymore by anybody before we 12478414809cSSrivatsa S. Bhat * proceed with unloading. 12481da177e4SLinus Torvalds */ 12492d06d8c4SDominik Brodowski pr_debug("waiting for dropping of refcount\n"); 1250499bca9bSAmerigo Wang wait_for_completion(cmp); 12512d06d8c4SDominik Brodowski pr_debug("wait complete\n"); 12528414809cSSrivatsa S. Bhat } 12531da177e4SLinus Torvalds 12548414809cSSrivatsa S. Bhat /* 12558414809cSSrivatsa S. Bhat * Perform the ->exit() even during light-weight tear-down, 12568414809cSSrivatsa S. Bhat * since this is a core component, and is essential for the 12578414809cSSrivatsa S. Bhat * subsequent light-weight ->init() to succeed. 12588414809cSSrivatsa S. Bhat */ 12591c3d85ddSRafael J. Wysocki if (cpufreq_driver->exit) 12603a3e9e06SViresh Kumar cpufreq_driver->exit(policy); 126127ecddc2SJacob Shin 12628414809cSSrivatsa S. Bhat if (!frozen) 12633a3e9e06SViresh Kumar cpufreq_policy_free(policy); 12642a998599SRafael J. Wysocki } else { 12652a998599SRafael J. Wysocki if (cpufreq_driver->target) { 12663a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_START); 12673a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_LIMITS); 1268b8eed8afSViresh Kumar } 12692a998599SRafael J. Wysocki } 12701da177e4SLinus Torvalds 12712eaa3e2dSViresh Kumar per_cpu(cpufreq_policy_cpu, cpu) = -1; 12721da177e4SLinus Torvalds return 0; 12731da177e4SLinus Torvalds } 12741da177e4SLinus Torvalds 12758a25a2fdSKay Sievers static int cpufreq_remove_dev(struct device *dev, struct subsys_interface *sif) 12765a01f2e8SVenkatesh Pallipadi { 12778a25a2fdSKay Sievers unsigned int cpu = dev->id; 12785a01f2e8SVenkatesh Pallipadi int retval; 1279ec28297aSVenki Pallipadi 1280ec28297aSVenki Pallipadi if (cpu_is_offline(cpu)) 1281ec28297aSVenki Pallipadi return 0; 1282ec28297aSVenki Pallipadi 1283a82fab29SSrivatsa S. Bhat retval = __cpufreq_remove_dev(dev, sif, false); 12845a01f2e8SVenkatesh Pallipadi return retval; 12855a01f2e8SVenkatesh Pallipadi } 12865a01f2e8SVenkatesh Pallipadi 128765f27f38SDavid Howells static void handle_update(struct work_struct *work) 12881da177e4SLinus Torvalds { 128965f27f38SDavid Howells struct cpufreq_policy *policy = 129065f27f38SDavid Howells container_of(work, struct cpufreq_policy, update); 129165f27f38SDavid Howells unsigned int cpu = policy->cpu; 12922d06d8c4SDominik Brodowski pr_debug("handle_update for cpu %u called\n", cpu); 12931da177e4SLinus Torvalds cpufreq_update_policy(cpu); 12941da177e4SLinus Torvalds } 12951da177e4SLinus Torvalds 12961da177e4SLinus Torvalds /** 1297bb176f7dSViresh Kumar * cpufreq_out_of_sync - If actual and saved CPU frequency differs, we're 1298bb176f7dSViresh Kumar * in deep trouble. 12991da177e4SLinus Torvalds * @cpu: cpu number 13001da177e4SLinus Torvalds * @old_freq: CPU frequency the kernel thinks the CPU runs at 13011da177e4SLinus Torvalds * @new_freq: CPU frequency the CPU actually runs at 13021da177e4SLinus Torvalds * 130329464f28SDave Jones * We adjust to current frequency first, and need to clean up later. 130429464f28SDave Jones * So either call to cpufreq_update_policy() or schedule handle_update()). 13051da177e4SLinus Torvalds */ 1306e08f5f5bSGautham R Shenoy static void cpufreq_out_of_sync(unsigned int cpu, unsigned int old_freq, 1307e08f5f5bSGautham R Shenoy unsigned int new_freq) 13081da177e4SLinus Torvalds { 1309b43a7ffbSViresh Kumar struct cpufreq_policy *policy; 13101da177e4SLinus Torvalds struct cpufreq_freqs freqs; 1311b43a7ffbSViresh Kumar unsigned long flags; 1312b43a7ffbSViresh Kumar 13132d06d8c4SDominik Brodowski pr_debug("Warning: CPU frequency out of sync: cpufreq and timing " 13141da177e4SLinus Torvalds "core thinks of %u, is %u kHz.\n", old_freq, new_freq); 13151da177e4SLinus Torvalds 13161da177e4SLinus Torvalds freqs.old = old_freq; 13171da177e4SLinus Torvalds freqs.new = new_freq; 1318b43a7ffbSViresh Kumar 1319b43a7ffbSViresh Kumar read_lock_irqsave(&cpufreq_driver_lock, flags); 1320b43a7ffbSViresh Kumar policy = per_cpu(cpufreq_cpu_data, cpu); 1321b43a7ffbSViresh Kumar read_unlock_irqrestore(&cpufreq_driver_lock, flags); 1322b43a7ffbSViresh Kumar 1323b43a7ffbSViresh Kumar cpufreq_notify_transition(policy, &freqs, CPUFREQ_PRECHANGE); 1324b43a7ffbSViresh Kumar cpufreq_notify_transition(policy, &freqs, CPUFREQ_POSTCHANGE); 13251da177e4SLinus Torvalds } 13261da177e4SLinus Torvalds 13271da177e4SLinus Torvalds /** 13284ab70df4SDhaval Giani * cpufreq_quick_get - get the CPU frequency (in kHz) from policy->cur 132995235ca2SVenkatesh Pallipadi * @cpu: CPU number 133095235ca2SVenkatesh Pallipadi * 133195235ca2SVenkatesh Pallipadi * This is the last known freq, without actually getting it from the driver. 133295235ca2SVenkatesh Pallipadi * Return value will be same as what is shown in scaling_cur_freq in sysfs. 133395235ca2SVenkatesh Pallipadi */ 133495235ca2SVenkatesh Pallipadi unsigned int cpufreq_quick_get(unsigned int cpu) 133595235ca2SVenkatesh Pallipadi { 13369e21ba8bSDirk Brandewie struct cpufreq_policy *policy; 1337e08f5f5bSGautham R Shenoy unsigned int ret_freq = 0; 133895235ca2SVenkatesh Pallipadi 13391c3d85ddSRafael J. Wysocki if (cpufreq_driver && cpufreq_driver->setpolicy && cpufreq_driver->get) 13401c3d85ddSRafael J. Wysocki return cpufreq_driver->get(cpu); 13419e21ba8bSDirk Brandewie 13429e21ba8bSDirk Brandewie policy = cpufreq_cpu_get(cpu); 134395235ca2SVenkatesh Pallipadi if (policy) { 1344e08f5f5bSGautham R Shenoy ret_freq = policy->cur; 134595235ca2SVenkatesh Pallipadi cpufreq_cpu_put(policy); 134695235ca2SVenkatesh Pallipadi } 134795235ca2SVenkatesh Pallipadi 13484d34a67dSDave Jones return ret_freq; 134995235ca2SVenkatesh Pallipadi } 135095235ca2SVenkatesh Pallipadi EXPORT_SYMBOL(cpufreq_quick_get); 135195235ca2SVenkatesh Pallipadi 13523d737108SJesse Barnes /** 13533d737108SJesse Barnes * cpufreq_quick_get_max - get the max reported CPU frequency for this CPU 13543d737108SJesse Barnes * @cpu: CPU number 13553d737108SJesse Barnes * 13563d737108SJesse Barnes * Just return the max possible frequency for a given CPU. 13573d737108SJesse Barnes */ 13583d737108SJesse Barnes unsigned int cpufreq_quick_get_max(unsigned int cpu) 13593d737108SJesse Barnes { 13603d737108SJesse Barnes struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); 13613d737108SJesse Barnes unsigned int ret_freq = 0; 13623d737108SJesse Barnes 13633d737108SJesse Barnes if (policy) { 13643d737108SJesse Barnes ret_freq = policy->max; 13653d737108SJesse Barnes cpufreq_cpu_put(policy); 13663d737108SJesse Barnes } 13673d737108SJesse Barnes 13683d737108SJesse Barnes return ret_freq; 13693d737108SJesse Barnes } 13703d737108SJesse Barnes EXPORT_SYMBOL(cpufreq_quick_get_max); 13713d737108SJesse Barnes 13725a01f2e8SVenkatesh Pallipadi static unsigned int __cpufreq_get(unsigned int cpu) 13731da177e4SLinus Torvalds { 13747a6aedfaSMike Travis struct cpufreq_policy *policy = per_cpu(cpufreq_cpu_data, cpu); 1375e08f5f5bSGautham R Shenoy unsigned int ret_freq = 0; 13761da177e4SLinus Torvalds 13771c3d85ddSRafael J. Wysocki if (!cpufreq_driver->get) 13784d34a67dSDave Jones return ret_freq; 13791da177e4SLinus Torvalds 13801c3d85ddSRafael J. Wysocki ret_freq = cpufreq_driver->get(cpu); 13811da177e4SLinus Torvalds 1382e08f5f5bSGautham R Shenoy if (ret_freq && policy->cur && 13831c3d85ddSRafael J. Wysocki !(cpufreq_driver->flags & CPUFREQ_CONST_LOOPS)) { 1384e08f5f5bSGautham R Shenoy /* verify no discrepancy between actual and 1385e08f5f5bSGautham R Shenoy saved value exists */ 1386e08f5f5bSGautham R Shenoy if (unlikely(ret_freq != policy->cur)) { 1387e08f5f5bSGautham R Shenoy cpufreq_out_of_sync(cpu, policy->cur, ret_freq); 13881da177e4SLinus Torvalds schedule_work(&policy->update); 13891da177e4SLinus Torvalds } 13901da177e4SLinus Torvalds } 13911da177e4SLinus Torvalds 13924d34a67dSDave Jones return ret_freq; 13935a01f2e8SVenkatesh Pallipadi } 13941da177e4SLinus Torvalds 13955a01f2e8SVenkatesh Pallipadi /** 13965a01f2e8SVenkatesh Pallipadi * cpufreq_get - get the current CPU frequency (in kHz) 13975a01f2e8SVenkatesh Pallipadi * @cpu: CPU number 13985a01f2e8SVenkatesh Pallipadi * 13995a01f2e8SVenkatesh Pallipadi * Get the CPU current (static) CPU frequency 14005a01f2e8SVenkatesh Pallipadi */ 14015a01f2e8SVenkatesh Pallipadi unsigned int cpufreq_get(unsigned int cpu) 14025a01f2e8SVenkatesh Pallipadi { 14035a01f2e8SVenkatesh Pallipadi unsigned int ret_freq = 0; 14045a01f2e8SVenkatesh Pallipadi 1405*6eed9404SViresh Kumar if (!down_read_trylock(&cpufreq_rwsem)) 1406*6eed9404SViresh Kumar return 0; 14075a01f2e8SVenkatesh Pallipadi 14085a01f2e8SVenkatesh Pallipadi if (unlikely(lock_policy_rwsem_read(cpu))) 14095a01f2e8SVenkatesh Pallipadi goto out_policy; 14105a01f2e8SVenkatesh Pallipadi 14115a01f2e8SVenkatesh Pallipadi ret_freq = __cpufreq_get(cpu); 14125a01f2e8SVenkatesh Pallipadi 14135a01f2e8SVenkatesh Pallipadi unlock_policy_rwsem_read(cpu); 14145a01f2e8SVenkatesh Pallipadi 14155a01f2e8SVenkatesh Pallipadi out_policy: 1416*6eed9404SViresh Kumar up_read(&cpufreq_rwsem); 1417*6eed9404SViresh Kumar 14184d34a67dSDave Jones return ret_freq; 14191da177e4SLinus Torvalds } 14201da177e4SLinus Torvalds EXPORT_SYMBOL(cpufreq_get); 14211da177e4SLinus Torvalds 14228a25a2fdSKay Sievers static struct subsys_interface cpufreq_interface = { 14238a25a2fdSKay Sievers .name = "cpufreq", 14248a25a2fdSKay Sievers .subsys = &cpu_subsys, 14258a25a2fdSKay Sievers .add_dev = cpufreq_add_dev, 14268a25a2fdSKay Sievers .remove_dev = cpufreq_remove_dev, 1427e00e56dfSRafael J. Wysocki }; 1428e00e56dfSRafael J. Wysocki 14291da177e4SLinus Torvalds /** 1430e00e56dfSRafael J. Wysocki * cpufreq_bp_suspend - Prepare the boot CPU for system suspend. 1431e00e56dfSRafael J. Wysocki * 1432e00e56dfSRafael J. Wysocki * This function is only executed for the boot processor. The other CPUs 1433e00e56dfSRafael J. Wysocki * have been put offline by means of CPU hotplug. 143442d4dc3fSBenjamin Herrenschmidt */ 1435e00e56dfSRafael J. Wysocki static int cpufreq_bp_suspend(void) 143642d4dc3fSBenjamin Herrenschmidt { 1437e08f5f5bSGautham R Shenoy int ret = 0; 14384bc5d341SDave Jones 1439e00e56dfSRafael J. Wysocki int cpu = smp_processor_id(); 14403a3e9e06SViresh Kumar struct cpufreq_policy *policy; 144142d4dc3fSBenjamin Herrenschmidt 14422d06d8c4SDominik Brodowski pr_debug("suspending cpu %u\n", cpu); 144342d4dc3fSBenjamin Herrenschmidt 1444e00e56dfSRafael J. Wysocki /* If there's no policy for the boot CPU, we have nothing to do. */ 14453a3e9e06SViresh Kumar policy = cpufreq_cpu_get(cpu); 14463a3e9e06SViresh Kumar if (!policy) 1447e00e56dfSRafael J. Wysocki return 0; 144842d4dc3fSBenjamin Herrenschmidt 14491c3d85ddSRafael J. Wysocki if (cpufreq_driver->suspend) { 14503a3e9e06SViresh Kumar ret = cpufreq_driver->suspend(policy); 1451ce6c3997SDominik Brodowski if (ret) 145242d4dc3fSBenjamin Herrenschmidt printk(KERN_ERR "cpufreq: suspend failed in ->suspend " 14533a3e9e06SViresh Kumar "step on CPU %u\n", policy->cpu); 145442d4dc3fSBenjamin Herrenschmidt } 145542d4dc3fSBenjamin Herrenschmidt 14563a3e9e06SViresh Kumar cpufreq_cpu_put(policy); 1457c9060494SDave Jones return ret; 145842d4dc3fSBenjamin Herrenschmidt } 145942d4dc3fSBenjamin Herrenschmidt 146042d4dc3fSBenjamin Herrenschmidt /** 1461e00e56dfSRafael J. Wysocki * cpufreq_bp_resume - Restore proper frequency handling of the boot CPU. 14621da177e4SLinus Torvalds * 14631da177e4SLinus Torvalds * 1.) resume CPUfreq hardware support (cpufreq_driver->resume()) 1464ce6c3997SDominik Brodowski * 2.) schedule call cpufreq_update_policy() ASAP as interrupts are 1465ce6c3997SDominik Brodowski * restored. It will verify that the current freq is in sync with 1466ce6c3997SDominik Brodowski * what we believe it to be. This is a bit later than when it 1467ce6c3997SDominik Brodowski * should be, but nonethteless it's better than calling 1468ce6c3997SDominik Brodowski * cpufreq_driver->get() here which might re-enable interrupts... 1469e00e56dfSRafael J. Wysocki * 1470e00e56dfSRafael J. Wysocki * This function is only executed for the boot CPU. The other CPUs have not 1471e00e56dfSRafael J. Wysocki * been turned on yet. 14721da177e4SLinus Torvalds */ 1473e00e56dfSRafael J. Wysocki static void cpufreq_bp_resume(void) 14741da177e4SLinus Torvalds { 1475e08f5f5bSGautham R Shenoy int ret = 0; 14764bc5d341SDave Jones 1477e00e56dfSRafael J. Wysocki int cpu = smp_processor_id(); 14783a3e9e06SViresh Kumar struct cpufreq_policy *policy; 14791da177e4SLinus Torvalds 14802d06d8c4SDominik Brodowski pr_debug("resuming cpu %u\n", cpu); 14811da177e4SLinus Torvalds 1482e00e56dfSRafael J. Wysocki /* If there's no policy for the boot CPU, we have nothing to do. */ 14833a3e9e06SViresh Kumar policy = cpufreq_cpu_get(cpu); 14843a3e9e06SViresh Kumar if (!policy) 1485e00e56dfSRafael J. Wysocki return; 14861da177e4SLinus Torvalds 14871c3d85ddSRafael J. Wysocki if (cpufreq_driver->resume) { 14883a3e9e06SViresh Kumar ret = cpufreq_driver->resume(policy); 14891da177e4SLinus Torvalds if (ret) { 14901da177e4SLinus Torvalds printk(KERN_ERR "cpufreq: resume failed in ->resume " 14913a3e9e06SViresh Kumar "step on CPU %u\n", policy->cpu); 1492c9060494SDave Jones goto fail; 14931da177e4SLinus Torvalds } 14941da177e4SLinus Torvalds } 14951da177e4SLinus Torvalds 14963a3e9e06SViresh Kumar schedule_work(&policy->update); 1497ce6c3997SDominik Brodowski 1498c9060494SDave Jones fail: 14993a3e9e06SViresh Kumar cpufreq_cpu_put(policy); 15001da177e4SLinus Torvalds } 15011da177e4SLinus Torvalds 1502e00e56dfSRafael J. Wysocki static struct syscore_ops cpufreq_syscore_ops = { 1503e00e56dfSRafael J. Wysocki .suspend = cpufreq_bp_suspend, 1504e00e56dfSRafael J. Wysocki .resume = cpufreq_bp_resume, 15051da177e4SLinus Torvalds }; 15061da177e4SLinus Torvalds 15079d95046eSBorislav Petkov /** 15089d95046eSBorislav Petkov * cpufreq_get_current_driver - return current driver's name 15099d95046eSBorislav Petkov * 15109d95046eSBorislav Petkov * Return the name string of the currently loaded cpufreq driver 15119d95046eSBorislav Petkov * or NULL, if none. 15129d95046eSBorislav Petkov */ 15139d95046eSBorislav Petkov const char *cpufreq_get_current_driver(void) 15149d95046eSBorislav Petkov { 15151c3d85ddSRafael J. Wysocki if (cpufreq_driver) 15161c3d85ddSRafael J. Wysocki return cpufreq_driver->name; 15171c3d85ddSRafael J. Wysocki 15181c3d85ddSRafael J. Wysocki return NULL; 15199d95046eSBorislav Petkov } 15209d95046eSBorislav Petkov EXPORT_SYMBOL_GPL(cpufreq_get_current_driver); 15211da177e4SLinus Torvalds 15221da177e4SLinus Torvalds /********************************************************************* 15231da177e4SLinus Torvalds * NOTIFIER LISTS INTERFACE * 15241da177e4SLinus Torvalds *********************************************************************/ 15251da177e4SLinus Torvalds 15261da177e4SLinus Torvalds /** 15271da177e4SLinus Torvalds * cpufreq_register_notifier - register a driver with cpufreq 15281da177e4SLinus Torvalds * @nb: notifier function to register 15291da177e4SLinus Torvalds * @list: CPUFREQ_TRANSITION_NOTIFIER or CPUFREQ_POLICY_NOTIFIER 15301da177e4SLinus Torvalds * 15311da177e4SLinus Torvalds * Add a driver to one of two lists: either a list of drivers that 15321da177e4SLinus Torvalds * are notified about clock rate changes (once before and once after 15331da177e4SLinus Torvalds * the transition), or a list of drivers that are notified about 15341da177e4SLinus Torvalds * changes in cpufreq policy. 15351da177e4SLinus Torvalds * 15361da177e4SLinus Torvalds * This function may sleep, and has the same return conditions as 1537e041c683SAlan Stern * blocking_notifier_chain_register. 15381da177e4SLinus Torvalds */ 15391da177e4SLinus Torvalds int cpufreq_register_notifier(struct notifier_block *nb, unsigned int list) 15401da177e4SLinus Torvalds { 15411da177e4SLinus Torvalds int ret; 15421da177e4SLinus Torvalds 1543d5aaffa9SDirk Brandewie if (cpufreq_disabled()) 1544d5aaffa9SDirk Brandewie return -EINVAL; 1545d5aaffa9SDirk Brandewie 154674212ca4SCesar Eduardo Barros WARN_ON(!init_cpufreq_transition_notifier_list_called); 154774212ca4SCesar Eduardo Barros 15481da177e4SLinus Torvalds switch (list) { 15491da177e4SLinus Torvalds case CPUFREQ_TRANSITION_NOTIFIER: 1550b4dfdbb3SAlan Stern ret = srcu_notifier_chain_register( 1551e041c683SAlan Stern &cpufreq_transition_notifier_list, nb); 15521da177e4SLinus Torvalds break; 15531da177e4SLinus Torvalds case CPUFREQ_POLICY_NOTIFIER: 1554e041c683SAlan Stern ret = blocking_notifier_chain_register( 1555e041c683SAlan Stern &cpufreq_policy_notifier_list, nb); 15561da177e4SLinus Torvalds break; 15571da177e4SLinus Torvalds default: 15581da177e4SLinus Torvalds ret = -EINVAL; 15591da177e4SLinus Torvalds } 15601da177e4SLinus Torvalds 15611da177e4SLinus Torvalds return ret; 15621da177e4SLinus Torvalds } 15631da177e4SLinus Torvalds EXPORT_SYMBOL(cpufreq_register_notifier); 15641da177e4SLinus Torvalds 15651da177e4SLinus Torvalds /** 15661da177e4SLinus Torvalds * cpufreq_unregister_notifier - unregister a driver with cpufreq 15671da177e4SLinus Torvalds * @nb: notifier block to be unregistered 15681da177e4SLinus Torvalds * @list: CPUFREQ_TRANSITION_NOTIFIER or CPUFREQ_POLICY_NOTIFIER 15691da177e4SLinus Torvalds * 15701da177e4SLinus Torvalds * Remove a driver from the CPU frequency notifier list. 15711da177e4SLinus Torvalds * 15721da177e4SLinus Torvalds * This function may sleep, and has the same return conditions as 1573e041c683SAlan Stern * blocking_notifier_chain_unregister. 15741da177e4SLinus Torvalds */ 15751da177e4SLinus Torvalds int cpufreq_unregister_notifier(struct notifier_block *nb, unsigned int list) 15761da177e4SLinus Torvalds { 15771da177e4SLinus Torvalds int ret; 15781da177e4SLinus Torvalds 1579d5aaffa9SDirk Brandewie if (cpufreq_disabled()) 1580d5aaffa9SDirk Brandewie return -EINVAL; 1581d5aaffa9SDirk Brandewie 15821da177e4SLinus Torvalds switch (list) { 15831da177e4SLinus Torvalds case CPUFREQ_TRANSITION_NOTIFIER: 1584b4dfdbb3SAlan Stern ret = srcu_notifier_chain_unregister( 1585e041c683SAlan Stern &cpufreq_transition_notifier_list, nb); 15861da177e4SLinus Torvalds break; 15871da177e4SLinus Torvalds case CPUFREQ_POLICY_NOTIFIER: 1588e041c683SAlan Stern ret = blocking_notifier_chain_unregister( 1589e041c683SAlan Stern &cpufreq_policy_notifier_list, nb); 15901da177e4SLinus Torvalds break; 15911da177e4SLinus Torvalds default: 15921da177e4SLinus Torvalds ret = -EINVAL; 15931da177e4SLinus Torvalds } 15941da177e4SLinus Torvalds 15951da177e4SLinus Torvalds return ret; 15961da177e4SLinus Torvalds } 15971da177e4SLinus Torvalds EXPORT_SYMBOL(cpufreq_unregister_notifier); 15981da177e4SLinus Torvalds 15991da177e4SLinus Torvalds 16001da177e4SLinus Torvalds /********************************************************************* 16011da177e4SLinus Torvalds * GOVERNORS * 16021da177e4SLinus Torvalds *********************************************************************/ 16031da177e4SLinus Torvalds 16041da177e4SLinus Torvalds int __cpufreq_driver_target(struct cpufreq_policy *policy, 16051da177e4SLinus Torvalds unsigned int target_freq, 16061da177e4SLinus Torvalds unsigned int relation) 16071da177e4SLinus Torvalds { 16081da177e4SLinus Torvalds int retval = -EINVAL; 16097249924eSViresh Kumar unsigned int old_target_freq = target_freq; 1610c32b6b8eSAshok Raj 1611a7b422cdSKonrad Rzeszutek Wilk if (cpufreq_disabled()) 1612a7b422cdSKonrad Rzeszutek Wilk return -ENODEV; 16137c30ed53SViresh Kumar if (policy->transition_ongoing) 16147c30ed53SViresh Kumar return -EBUSY; 1615a7b422cdSKonrad Rzeszutek Wilk 16167249924eSViresh Kumar /* Make sure that target_freq is within supported range */ 16177249924eSViresh Kumar if (target_freq > policy->max) 16187249924eSViresh Kumar target_freq = policy->max; 16197249924eSViresh Kumar if (target_freq < policy->min) 16207249924eSViresh Kumar target_freq = policy->min; 16217249924eSViresh Kumar 16227249924eSViresh Kumar pr_debug("target for CPU %u: %u kHz, relation %u, requested %u kHz\n", 16237249924eSViresh Kumar policy->cpu, target_freq, relation, old_target_freq); 16245a1c0228SViresh Kumar 16255a1c0228SViresh Kumar if (target_freq == policy->cur) 16265a1c0228SViresh Kumar return 0; 16275a1c0228SViresh Kumar 16281c3d85ddSRafael J. Wysocki if (cpufreq_driver->target) 16291c3d85ddSRafael J. Wysocki retval = cpufreq_driver->target(policy, target_freq, relation); 163090d45d17SAshok Raj 16311da177e4SLinus Torvalds return retval; 16321da177e4SLinus Torvalds } 16331da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(__cpufreq_driver_target); 16341da177e4SLinus Torvalds 16351da177e4SLinus Torvalds int cpufreq_driver_target(struct cpufreq_policy *policy, 16361da177e4SLinus Torvalds unsigned int target_freq, 16371da177e4SLinus Torvalds unsigned int relation) 16381da177e4SLinus Torvalds { 1639f1829e4aSJulia Lawall int ret = -EINVAL; 16401da177e4SLinus Torvalds 16415a01f2e8SVenkatesh Pallipadi if (unlikely(lock_policy_rwsem_write(policy->cpu))) 1642f1829e4aSJulia Lawall goto fail; 16431da177e4SLinus Torvalds 16441da177e4SLinus Torvalds ret = __cpufreq_driver_target(policy, target_freq, relation); 16451da177e4SLinus Torvalds 16465a01f2e8SVenkatesh Pallipadi unlock_policy_rwsem_write(policy->cpu); 16471da177e4SLinus Torvalds 1648f1829e4aSJulia Lawall fail: 16491da177e4SLinus Torvalds return ret; 16501da177e4SLinus Torvalds } 16511da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_driver_target); 16521da177e4SLinus Torvalds 1653153d7f3fSArjan van de Ven /* 1654153d7f3fSArjan van de Ven * when "event" is CPUFREQ_GOV_LIMITS 1655153d7f3fSArjan van de Ven */ 16561da177e4SLinus Torvalds 1657e08f5f5bSGautham R Shenoy static int __cpufreq_governor(struct cpufreq_policy *policy, 1658e08f5f5bSGautham R Shenoy unsigned int event) 16591da177e4SLinus Torvalds { 1660cc993cabSDave Jones int ret; 16616afde10cSThomas Renninger 16626afde10cSThomas Renninger /* Only must be defined when default governor is known to have latency 16636afde10cSThomas Renninger restrictions, like e.g. conservative or ondemand. 16646afde10cSThomas Renninger That this is the case is already ensured in Kconfig 16656afde10cSThomas Renninger */ 16666afde10cSThomas Renninger #ifdef CONFIG_CPU_FREQ_GOV_PERFORMANCE 16676afde10cSThomas Renninger struct cpufreq_governor *gov = &cpufreq_gov_performance; 16686afde10cSThomas Renninger #else 16696afde10cSThomas Renninger struct cpufreq_governor *gov = NULL; 16706afde10cSThomas Renninger #endif 16711c256245SThomas Renninger 16721c256245SThomas Renninger if (policy->governor->max_transition_latency && 16731c256245SThomas Renninger policy->cpuinfo.transition_latency > 16741c256245SThomas Renninger policy->governor->max_transition_latency) { 16756afde10cSThomas Renninger if (!gov) 16766afde10cSThomas Renninger return -EINVAL; 16776afde10cSThomas Renninger else { 16781c256245SThomas Renninger printk(KERN_WARNING "%s governor failed, too long" 16791c256245SThomas Renninger " transition latency of HW, fallback" 16801c256245SThomas Renninger " to %s governor\n", 16811c256245SThomas Renninger policy->governor->name, 16821c256245SThomas Renninger gov->name); 16831c256245SThomas Renninger policy->governor = gov; 16841c256245SThomas Renninger } 16856afde10cSThomas Renninger } 16861da177e4SLinus Torvalds 1687fe492f3fSViresh Kumar if (event == CPUFREQ_GOV_POLICY_INIT) 16881da177e4SLinus Torvalds if (!try_module_get(policy->governor->owner)) 16891da177e4SLinus Torvalds return -EINVAL; 16901da177e4SLinus Torvalds 16912d06d8c4SDominik Brodowski pr_debug("__cpufreq_governor for CPU %u, event %u\n", 1692e08f5f5bSGautham R Shenoy policy->cpu, event); 169395731ebbSXiaoguang Chen 169495731ebbSXiaoguang Chen mutex_lock(&cpufreq_governor_lock); 169595731ebbSXiaoguang Chen if ((!policy->governor_enabled && (event == CPUFREQ_GOV_STOP)) || 169695731ebbSXiaoguang Chen (policy->governor_enabled && (event == CPUFREQ_GOV_START))) { 169795731ebbSXiaoguang Chen mutex_unlock(&cpufreq_governor_lock); 1698fe492f3fSViresh Kumar if (event == CPUFREQ_GOV_POLICY_INIT) 1699fe492f3fSViresh Kumar module_put(policy->governor->owner); 170095731ebbSXiaoguang Chen return -EBUSY; 170195731ebbSXiaoguang Chen } 170295731ebbSXiaoguang Chen 170395731ebbSXiaoguang Chen if (event == CPUFREQ_GOV_STOP) 170495731ebbSXiaoguang Chen policy->governor_enabled = false; 170595731ebbSXiaoguang Chen else if (event == CPUFREQ_GOV_START) 170695731ebbSXiaoguang Chen policy->governor_enabled = true; 170795731ebbSXiaoguang Chen 170895731ebbSXiaoguang Chen mutex_unlock(&cpufreq_governor_lock); 170995731ebbSXiaoguang Chen 17101da177e4SLinus Torvalds ret = policy->governor->governor(policy, event); 17111da177e4SLinus Torvalds 17124d5dcc42SViresh Kumar if (!ret) { 17134d5dcc42SViresh Kumar if (event == CPUFREQ_GOV_POLICY_INIT) 17148e53695fSViresh Kumar policy->governor->initialized++; 17154d5dcc42SViresh Kumar else if (event == CPUFREQ_GOV_POLICY_EXIT) 17168e53695fSViresh Kumar policy->governor->initialized--; 171795731ebbSXiaoguang Chen } else { 171895731ebbSXiaoguang Chen /* Restore original values */ 171995731ebbSXiaoguang Chen mutex_lock(&cpufreq_governor_lock); 172095731ebbSXiaoguang Chen if (event == CPUFREQ_GOV_STOP) 172195731ebbSXiaoguang Chen policy->governor_enabled = true; 172295731ebbSXiaoguang Chen else if (event == CPUFREQ_GOV_START) 172395731ebbSXiaoguang Chen policy->governor_enabled = false; 172495731ebbSXiaoguang Chen mutex_unlock(&cpufreq_governor_lock); 17254d5dcc42SViresh Kumar } 1726b394058fSViresh Kumar 1727fe492f3fSViresh Kumar if (((event == CPUFREQ_GOV_POLICY_INIT) && ret) || 1728fe492f3fSViresh Kumar ((event == CPUFREQ_GOV_POLICY_EXIT) && !ret)) 17291da177e4SLinus Torvalds module_put(policy->governor->owner); 17301da177e4SLinus Torvalds 17311da177e4SLinus Torvalds return ret; 17321da177e4SLinus Torvalds } 17331da177e4SLinus Torvalds 17341da177e4SLinus Torvalds int cpufreq_register_governor(struct cpufreq_governor *governor) 17351da177e4SLinus Torvalds { 17363bcb09a3SJeremy Fitzhardinge int err; 17371da177e4SLinus Torvalds 17381da177e4SLinus Torvalds if (!governor) 17391da177e4SLinus Torvalds return -EINVAL; 17401da177e4SLinus Torvalds 1741a7b422cdSKonrad Rzeszutek Wilk if (cpufreq_disabled()) 1742a7b422cdSKonrad Rzeszutek Wilk return -ENODEV; 1743a7b422cdSKonrad Rzeszutek Wilk 17443fc54d37Sakpm@osdl.org mutex_lock(&cpufreq_governor_mutex); 17451da177e4SLinus Torvalds 1746b394058fSViresh Kumar governor->initialized = 0; 17473bcb09a3SJeremy Fitzhardinge err = -EBUSY; 17483bcb09a3SJeremy Fitzhardinge if (__find_governor(governor->name) == NULL) { 17493bcb09a3SJeremy Fitzhardinge err = 0; 17501da177e4SLinus Torvalds list_add(&governor->governor_list, &cpufreq_governor_list); 17513bcb09a3SJeremy Fitzhardinge } 17521da177e4SLinus Torvalds 17533fc54d37Sakpm@osdl.org mutex_unlock(&cpufreq_governor_mutex); 17543bcb09a3SJeremy Fitzhardinge return err; 17551da177e4SLinus Torvalds } 17561da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_register_governor); 17571da177e4SLinus Torvalds 17581da177e4SLinus Torvalds void cpufreq_unregister_governor(struct cpufreq_governor *governor) 17591da177e4SLinus Torvalds { 176090e41bacSPrarit Bhargava #ifdef CONFIG_HOTPLUG_CPU 176190e41bacSPrarit Bhargava int cpu; 176290e41bacSPrarit Bhargava #endif 176390e41bacSPrarit Bhargava 17641da177e4SLinus Torvalds if (!governor) 17651da177e4SLinus Torvalds return; 17661da177e4SLinus Torvalds 1767a7b422cdSKonrad Rzeszutek Wilk if (cpufreq_disabled()) 1768a7b422cdSKonrad Rzeszutek Wilk return; 1769a7b422cdSKonrad Rzeszutek Wilk 177090e41bacSPrarit Bhargava #ifdef CONFIG_HOTPLUG_CPU 177190e41bacSPrarit Bhargava for_each_present_cpu(cpu) { 177290e41bacSPrarit Bhargava if (cpu_online(cpu)) 177390e41bacSPrarit Bhargava continue; 177490e41bacSPrarit Bhargava if (!strcmp(per_cpu(cpufreq_cpu_governor, cpu), governor->name)) 177590e41bacSPrarit Bhargava strcpy(per_cpu(cpufreq_cpu_governor, cpu), "\0"); 177690e41bacSPrarit Bhargava } 177790e41bacSPrarit Bhargava #endif 177890e41bacSPrarit Bhargava 17793fc54d37Sakpm@osdl.org mutex_lock(&cpufreq_governor_mutex); 17801da177e4SLinus Torvalds list_del(&governor->governor_list); 17813fc54d37Sakpm@osdl.org mutex_unlock(&cpufreq_governor_mutex); 17821da177e4SLinus Torvalds return; 17831da177e4SLinus Torvalds } 17841da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_unregister_governor); 17851da177e4SLinus Torvalds 17861da177e4SLinus Torvalds 17871da177e4SLinus Torvalds /********************************************************************* 17881da177e4SLinus Torvalds * POLICY INTERFACE * 17891da177e4SLinus Torvalds *********************************************************************/ 17901da177e4SLinus Torvalds 17911da177e4SLinus Torvalds /** 17921da177e4SLinus Torvalds * cpufreq_get_policy - get the current cpufreq_policy 179329464f28SDave Jones * @policy: struct cpufreq_policy into which the current cpufreq_policy 179429464f28SDave Jones * is written 17951da177e4SLinus Torvalds * 17961da177e4SLinus Torvalds * Reads the current cpufreq policy. 17971da177e4SLinus Torvalds */ 17981da177e4SLinus Torvalds int cpufreq_get_policy(struct cpufreq_policy *policy, unsigned int cpu) 17991da177e4SLinus Torvalds { 18001da177e4SLinus Torvalds struct cpufreq_policy *cpu_policy; 18011da177e4SLinus Torvalds if (!policy) 18021da177e4SLinus Torvalds return -EINVAL; 18031da177e4SLinus Torvalds 18041da177e4SLinus Torvalds cpu_policy = cpufreq_cpu_get(cpu); 18051da177e4SLinus Torvalds if (!cpu_policy) 18061da177e4SLinus Torvalds return -EINVAL; 18071da177e4SLinus Torvalds 1808d5b73cd8SViresh Kumar memcpy(policy, cpu_policy, sizeof(*policy)); 18091da177e4SLinus Torvalds 18101da177e4SLinus Torvalds cpufreq_cpu_put(cpu_policy); 18111da177e4SLinus Torvalds return 0; 18121da177e4SLinus Torvalds } 18131da177e4SLinus Torvalds EXPORT_SYMBOL(cpufreq_get_policy); 18141da177e4SLinus Torvalds 1815153d7f3fSArjan van de Ven /* 1816e08f5f5bSGautham R Shenoy * data : current policy. 1817e08f5f5bSGautham R Shenoy * policy : policy to be set. 1818153d7f3fSArjan van de Ven */ 18193a3e9e06SViresh Kumar static int __cpufreq_set_policy(struct cpufreq_policy *policy, 18203a3e9e06SViresh Kumar struct cpufreq_policy *new_policy) 18211da177e4SLinus Torvalds { 18227bd353a9SViresh Kumar int ret = 0, failed = 1; 18231da177e4SLinus Torvalds 18243a3e9e06SViresh Kumar pr_debug("setting new policy for CPU %u: %u - %u kHz\n", new_policy->cpu, 18253a3e9e06SViresh Kumar new_policy->min, new_policy->max); 18261da177e4SLinus Torvalds 1827d5b73cd8SViresh Kumar memcpy(&new_policy->cpuinfo, &policy->cpuinfo, sizeof(policy->cpuinfo)); 18281da177e4SLinus Torvalds 18293a3e9e06SViresh Kumar if (new_policy->min > policy->max || new_policy->max < policy->min) { 18309c9a43edSMattia Dongili ret = -EINVAL; 18319c9a43edSMattia Dongili goto error_out; 18329c9a43edSMattia Dongili } 18339c9a43edSMattia Dongili 18341da177e4SLinus Torvalds /* verify the cpu speed can be set within this limit */ 18353a3e9e06SViresh Kumar ret = cpufreq_driver->verify(new_policy); 18361da177e4SLinus Torvalds if (ret) 18371da177e4SLinus Torvalds goto error_out; 18381da177e4SLinus Torvalds 18391da177e4SLinus Torvalds /* adjust if necessary - all reasons */ 1840e041c683SAlan Stern blocking_notifier_call_chain(&cpufreq_policy_notifier_list, 18413a3e9e06SViresh Kumar CPUFREQ_ADJUST, new_policy); 18421da177e4SLinus Torvalds 18431da177e4SLinus Torvalds /* adjust if necessary - hardware incompatibility*/ 1844e041c683SAlan Stern blocking_notifier_call_chain(&cpufreq_policy_notifier_list, 18453a3e9e06SViresh Kumar CPUFREQ_INCOMPATIBLE, new_policy); 18461da177e4SLinus Torvalds 1847bb176f7dSViresh Kumar /* 1848bb176f7dSViresh Kumar * verify the cpu speed can be set within this limit, which might be 1849bb176f7dSViresh Kumar * different to the first one 1850bb176f7dSViresh Kumar */ 18513a3e9e06SViresh Kumar ret = cpufreq_driver->verify(new_policy); 1852e041c683SAlan Stern if (ret) 18531da177e4SLinus Torvalds goto error_out; 18541da177e4SLinus Torvalds 18551da177e4SLinus Torvalds /* notification of the new policy */ 1856e041c683SAlan Stern blocking_notifier_call_chain(&cpufreq_policy_notifier_list, 18573a3e9e06SViresh Kumar CPUFREQ_NOTIFY, new_policy); 18581da177e4SLinus Torvalds 18593a3e9e06SViresh Kumar policy->min = new_policy->min; 18603a3e9e06SViresh Kumar policy->max = new_policy->max; 18611da177e4SLinus Torvalds 18622d06d8c4SDominik Brodowski pr_debug("new min and max freqs are %u - %u kHz\n", 18633a3e9e06SViresh Kumar policy->min, policy->max); 18641da177e4SLinus Torvalds 18651c3d85ddSRafael J. Wysocki if (cpufreq_driver->setpolicy) { 18663a3e9e06SViresh Kumar policy->policy = new_policy->policy; 18672d06d8c4SDominik Brodowski pr_debug("setting range\n"); 18683a3e9e06SViresh Kumar ret = cpufreq_driver->setpolicy(new_policy); 18691da177e4SLinus Torvalds } else { 18703a3e9e06SViresh Kumar if (new_policy->governor != policy->governor) { 18711da177e4SLinus Torvalds /* save old, working values */ 18723a3e9e06SViresh Kumar struct cpufreq_governor *old_gov = policy->governor; 18731da177e4SLinus Torvalds 18742d06d8c4SDominik Brodowski pr_debug("governor switch\n"); 18751da177e4SLinus Torvalds 18761da177e4SLinus Torvalds /* end old governor */ 18773a3e9e06SViresh Kumar if (policy->governor) { 18783a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_STOP); 18793a3e9e06SViresh Kumar unlock_policy_rwsem_write(new_policy->cpu); 18803a3e9e06SViresh Kumar __cpufreq_governor(policy, 18817bd353a9SViresh Kumar CPUFREQ_GOV_POLICY_EXIT); 18823a3e9e06SViresh Kumar lock_policy_rwsem_write(new_policy->cpu); 18837bd353a9SViresh Kumar } 18841da177e4SLinus Torvalds 18851da177e4SLinus Torvalds /* start new governor */ 18863a3e9e06SViresh Kumar policy->governor = new_policy->governor; 18873a3e9e06SViresh Kumar if (!__cpufreq_governor(policy, CPUFREQ_GOV_POLICY_INIT)) { 18883a3e9e06SViresh Kumar if (!__cpufreq_governor(policy, CPUFREQ_GOV_START)) { 18897bd353a9SViresh Kumar failed = 0; 1890955ef483SViresh Kumar } else { 18913a3e9e06SViresh Kumar unlock_policy_rwsem_write(new_policy->cpu); 18923a3e9e06SViresh Kumar __cpufreq_governor(policy, 18937bd353a9SViresh Kumar CPUFREQ_GOV_POLICY_EXIT); 18943a3e9e06SViresh Kumar lock_policy_rwsem_write(new_policy->cpu); 1895955ef483SViresh Kumar } 18967bd353a9SViresh Kumar } 18977bd353a9SViresh Kumar 18987bd353a9SViresh Kumar if (failed) { 18991da177e4SLinus Torvalds /* new governor failed, so re-start old one */ 19002d06d8c4SDominik Brodowski pr_debug("starting governor %s failed\n", 19013a3e9e06SViresh Kumar policy->governor->name); 19021da177e4SLinus Torvalds if (old_gov) { 19033a3e9e06SViresh Kumar policy->governor = old_gov; 19043a3e9e06SViresh Kumar __cpufreq_governor(policy, 19057bd353a9SViresh Kumar CPUFREQ_GOV_POLICY_INIT); 19063a3e9e06SViresh Kumar __cpufreq_governor(policy, 1907e08f5f5bSGautham R Shenoy CPUFREQ_GOV_START); 19081da177e4SLinus Torvalds } 19091da177e4SLinus Torvalds ret = -EINVAL; 19101da177e4SLinus Torvalds goto error_out; 19111da177e4SLinus Torvalds } 19121da177e4SLinus Torvalds /* might be a policy change, too, so fall through */ 19131da177e4SLinus Torvalds } 19142d06d8c4SDominik Brodowski pr_debug("governor: change or update limits\n"); 19153a3e9e06SViresh Kumar __cpufreq_governor(policy, CPUFREQ_GOV_LIMITS); 19161da177e4SLinus Torvalds } 19171da177e4SLinus Torvalds 19181da177e4SLinus Torvalds error_out: 19191da177e4SLinus Torvalds return ret; 19201da177e4SLinus Torvalds } 19211da177e4SLinus Torvalds 19221da177e4SLinus Torvalds /** 19231da177e4SLinus Torvalds * cpufreq_update_policy - re-evaluate an existing cpufreq policy 19241da177e4SLinus Torvalds * @cpu: CPU which shall be re-evaluated 19251da177e4SLinus Torvalds * 192625985edcSLucas De Marchi * Useful for policy notifiers which have different necessities 19271da177e4SLinus Torvalds * at different times. 19281da177e4SLinus Torvalds */ 19291da177e4SLinus Torvalds int cpufreq_update_policy(unsigned int cpu) 19301da177e4SLinus Torvalds { 19313a3e9e06SViresh Kumar struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); 19323a3e9e06SViresh Kumar struct cpufreq_policy new_policy; 1933f1829e4aSJulia Lawall int ret; 19341da177e4SLinus Torvalds 19353a3e9e06SViresh Kumar if (!policy) { 1936f1829e4aSJulia Lawall ret = -ENODEV; 1937f1829e4aSJulia Lawall goto no_policy; 1938f1829e4aSJulia Lawall } 19391da177e4SLinus Torvalds 1940f1829e4aSJulia Lawall if (unlikely(lock_policy_rwsem_write(cpu))) { 1941f1829e4aSJulia Lawall ret = -EINVAL; 1942f1829e4aSJulia Lawall goto fail; 1943f1829e4aSJulia Lawall } 19441da177e4SLinus Torvalds 19452d06d8c4SDominik Brodowski pr_debug("updating policy for CPU %u\n", cpu); 1946d5b73cd8SViresh Kumar memcpy(&new_policy, policy, sizeof(*policy)); 19473a3e9e06SViresh Kumar new_policy.min = policy->user_policy.min; 19483a3e9e06SViresh Kumar new_policy.max = policy->user_policy.max; 19493a3e9e06SViresh Kumar new_policy.policy = policy->user_policy.policy; 19503a3e9e06SViresh Kumar new_policy.governor = policy->user_policy.governor; 19511da177e4SLinus Torvalds 1952bb176f7dSViresh Kumar /* 1953bb176f7dSViresh Kumar * BIOS might change freq behind our back 1954bb176f7dSViresh Kumar * -> ask driver for current freq and notify governors about a change 1955bb176f7dSViresh Kumar */ 19561c3d85ddSRafael J. Wysocki if (cpufreq_driver->get) { 19573a3e9e06SViresh Kumar new_policy.cur = cpufreq_driver->get(cpu); 19583a3e9e06SViresh Kumar if (!policy->cur) { 19592d06d8c4SDominik Brodowski pr_debug("Driver did not initialize current freq"); 19603a3e9e06SViresh Kumar policy->cur = new_policy.cur; 1961a85f7bd3SThomas Renninger } else { 19623a3e9e06SViresh Kumar if (policy->cur != new_policy.cur && cpufreq_driver->target) 19633a3e9e06SViresh Kumar cpufreq_out_of_sync(cpu, policy->cur, 19643a3e9e06SViresh Kumar new_policy.cur); 19650961dd0dSThomas Renninger } 1966a85f7bd3SThomas Renninger } 19670961dd0dSThomas Renninger 19683a3e9e06SViresh Kumar ret = __cpufreq_set_policy(policy, &new_policy); 19691da177e4SLinus Torvalds 19705a01f2e8SVenkatesh Pallipadi unlock_policy_rwsem_write(cpu); 19715a01f2e8SVenkatesh Pallipadi 1972f1829e4aSJulia Lawall fail: 19733a3e9e06SViresh Kumar cpufreq_cpu_put(policy); 1974f1829e4aSJulia Lawall no_policy: 19751da177e4SLinus Torvalds return ret; 19761da177e4SLinus Torvalds } 19771da177e4SLinus Torvalds EXPORT_SYMBOL(cpufreq_update_policy); 19781da177e4SLinus Torvalds 19792760984fSPaul Gortmaker static int cpufreq_cpu_callback(struct notifier_block *nfb, 1980c32b6b8eSAshok Raj unsigned long action, void *hcpu) 1981c32b6b8eSAshok Raj { 1982c32b6b8eSAshok Raj unsigned int cpu = (unsigned long)hcpu; 19838a25a2fdSKay Sievers struct device *dev; 19845302c3fbSSrivatsa S. Bhat bool frozen = false; 1985c32b6b8eSAshok Raj 19868a25a2fdSKay Sievers dev = get_cpu_device(cpu); 19878a25a2fdSKay Sievers if (dev) { 19885302c3fbSSrivatsa S. Bhat 19895302c3fbSSrivatsa S. Bhat if (action & CPU_TASKS_FROZEN) 19905302c3fbSSrivatsa S. Bhat frozen = true; 19915302c3fbSSrivatsa S. Bhat 19925302c3fbSSrivatsa S. Bhat switch (action & ~CPU_TASKS_FROZEN) { 1993c32b6b8eSAshok Raj case CPU_ONLINE: 19945302c3fbSSrivatsa S. Bhat __cpufreq_add_dev(dev, NULL, frozen); 199523d32899SSrivatsa S. Bhat cpufreq_update_policy(cpu); 1996c32b6b8eSAshok Raj break; 19975302c3fbSSrivatsa S. Bhat 1998c32b6b8eSAshok Raj case CPU_DOWN_PREPARE: 19995302c3fbSSrivatsa S. Bhat __cpufreq_remove_dev(dev, NULL, frozen); 2000c32b6b8eSAshok Raj break; 20015302c3fbSSrivatsa S. Bhat 20025a01f2e8SVenkatesh Pallipadi case CPU_DOWN_FAILED: 20035302c3fbSSrivatsa S. Bhat __cpufreq_add_dev(dev, NULL, frozen); 2004c32b6b8eSAshok Raj break; 2005c32b6b8eSAshok Raj } 2006c32b6b8eSAshok Raj } 2007c32b6b8eSAshok Raj return NOTIFY_OK; 2008c32b6b8eSAshok Raj } 2009c32b6b8eSAshok Raj 20109c36f746SNeal Buckendahl static struct notifier_block __refdata cpufreq_cpu_notifier = { 2011c32b6b8eSAshok Raj .notifier_call = cpufreq_cpu_callback, 2012c32b6b8eSAshok Raj }; 20131da177e4SLinus Torvalds 20141da177e4SLinus Torvalds /********************************************************************* 20151da177e4SLinus Torvalds * REGISTER / UNREGISTER CPUFREQ DRIVER * 20161da177e4SLinus Torvalds *********************************************************************/ 20171da177e4SLinus Torvalds 20181da177e4SLinus Torvalds /** 20191da177e4SLinus Torvalds * cpufreq_register_driver - register a CPU Frequency driver 20201da177e4SLinus Torvalds * @driver_data: A struct cpufreq_driver containing the values# 20211da177e4SLinus Torvalds * submitted by the CPU Frequency driver. 20221da177e4SLinus Torvalds * 20231da177e4SLinus Torvalds * Registers a CPU Frequency driver to this core code. This code 20241da177e4SLinus Torvalds * returns zero on success, -EBUSY when another driver got here first 20251da177e4SLinus Torvalds * (and isn't unregistered in the meantime). 20261da177e4SLinus Torvalds * 20271da177e4SLinus Torvalds */ 2028221dee28SLinus Torvalds int cpufreq_register_driver(struct cpufreq_driver *driver_data) 20291da177e4SLinus Torvalds { 20301da177e4SLinus Torvalds unsigned long flags; 20311da177e4SLinus Torvalds int ret; 20321da177e4SLinus Torvalds 2033a7b422cdSKonrad Rzeszutek Wilk if (cpufreq_disabled()) 2034a7b422cdSKonrad Rzeszutek Wilk return -ENODEV; 2035a7b422cdSKonrad Rzeszutek Wilk 20361da177e4SLinus Torvalds if (!driver_data || !driver_data->verify || !driver_data->init || 20371da177e4SLinus Torvalds ((!driver_data->setpolicy) && (!driver_data->target))) 20381da177e4SLinus Torvalds return -EINVAL; 20391da177e4SLinus Torvalds 20402d06d8c4SDominik Brodowski pr_debug("trying to register driver %s\n", driver_data->name); 20411da177e4SLinus Torvalds 20421da177e4SLinus Torvalds if (driver_data->setpolicy) 20431da177e4SLinus Torvalds driver_data->flags |= CPUFREQ_CONST_LOOPS; 20441da177e4SLinus Torvalds 20450d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 20461c3d85ddSRafael J. Wysocki if (cpufreq_driver) { 20470d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 20481da177e4SLinus Torvalds return -EBUSY; 20491da177e4SLinus Torvalds } 20501c3d85ddSRafael J. Wysocki cpufreq_driver = driver_data; 20510d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 20521da177e4SLinus Torvalds 20538a25a2fdSKay Sievers ret = subsys_interface_register(&cpufreq_interface); 20548f5bc2abSJiri Slaby if (ret) 20558f5bc2abSJiri Slaby goto err_null_driver; 20561da177e4SLinus Torvalds 20571c3d85ddSRafael J. Wysocki if (!(cpufreq_driver->flags & CPUFREQ_STICKY)) { 20581da177e4SLinus Torvalds int i; 20591da177e4SLinus Torvalds ret = -ENODEV; 20601da177e4SLinus Torvalds 20611da177e4SLinus Torvalds /* check for at least one working CPU */ 20627a6aedfaSMike Travis for (i = 0; i < nr_cpu_ids; i++) 20637a6aedfaSMike Travis if (cpu_possible(i) && per_cpu(cpufreq_cpu_data, i)) { 20641da177e4SLinus Torvalds ret = 0; 20657a6aedfaSMike Travis break; 20667a6aedfaSMike Travis } 20671da177e4SLinus Torvalds 20681da177e4SLinus Torvalds /* if all ->init() calls failed, unregister */ 20691da177e4SLinus Torvalds if (ret) { 20702d06d8c4SDominik Brodowski pr_debug("no CPU initialized for driver %s\n", 2071e08f5f5bSGautham R Shenoy driver_data->name); 20728a25a2fdSKay Sievers goto err_if_unreg; 20731da177e4SLinus Torvalds } 20741da177e4SLinus Torvalds } 20751da177e4SLinus Torvalds 207665edc68cSChandra Seetharaman register_hotcpu_notifier(&cpufreq_cpu_notifier); 20772d06d8c4SDominik Brodowski pr_debug("driver %s up and running\n", driver_data->name); 20781da177e4SLinus Torvalds 20798f5bc2abSJiri Slaby return 0; 20808a25a2fdSKay Sievers err_if_unreg: 20818a25a2fdSKay Sievers subsys_interface_unregister(&cpufreq_interface); 20828f5bc2abSJiri Slaby err_null_driver: 20830d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 20841c3d85ddSRafael J. Wysocki cpufreq_driver = NULL; 20850d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 20864d34a67dSDave Jones return ret; 20871da177e4SLinus Torvalds } 20881da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_register_driver); 20891da177e4SLinus Torvalds 20901da177e4SLinus Torvalds /** 20911da177e4SLinus Torvalds * cpufreq_unregister_driver - unregister the current CPUFreq driver 20921da177e4SLinus Torvalds * 20931da177e4SLinus Torvalds * Unregister the current CPUFreq driver. Only call this if you have 20941da177e4SLinus Torvalds * the right to do so, i.e. if you have succeeded in initialising before! 20951da177e4SLinus Torvalds * Returns zero if successful, and -EINVAL if the cpufreq_driver is 20961da177e4SLinus Torvalds * currently not initialised. 20971da177e4SLinus Torvalds */ 2098221dee28SLinus Torvalds int cpufreq_unregister_driver(struct cpufreq_driver *driver) 20991da177e4SLinus Torvalds { 21001da177e4SLinus Torvalds unsigned long flags; 21011da177e4SLinus Torvalds 21021c3d85ddSRafael J. Wysocki if (!cpufreq_driver || (driver != cpufreq_driver)) 21031da177e4SLinus Torvalds return -EINVAL; 21041da177e4SLinus Torvalds 21052d06d8c4SDominik Brodowski pr_debug("unregistering driver %s\n", driver->name); 21061da177e4SLinus Torvalds 21078a25a2fdSKay Sievers subsys_interface_unregister(&cpufreq_interface); 210865edc68cSChandra Seetharaman unregister_hotcpu_notifier(&cpufreq_cpu_notifier); 21091da177e4SLinus Torvalds 2110*6eed9404SViresh Kumar down_write(&cpufreq_rwsem); 21110d1857a1SNathan Zimmer write_lock_irqsave(&cpufreq_driver_lock, flags); 2112*6eed9404SViresh Kumar 21131c3d85ddSRafael J. Wysocki cpufreq_driver = NULL; 2114*6eed9404SViresh Kumar 21150d1857a1SNathan Zimmer write_unlock_irqrestore(&cpufreq_driver_lock, flags); 2116*6eed9404SViresh Kumar up_write(&cpufreq_rwsem); 21171da177e4SLinus Torvalds 21181da177e4SLinus Torvalds return 0; 21191da177e4SLinus Torvalds } 21201da177e4SLinus Torvalds EXPORT_SYMBOL_GPL(cpufreq_unregister_driver); 21215a01f2e8SVenkatesh Pallipadi 21225a01f2e8SVenkatesh Pallipadi static int __init cpufreq_core_init(void) 21235a01f2e8SVenkatesh Pallipadi { 21245a01f2e8SVenkatesh Pallipadi int cpu; 21255a01f2e8SVenkatesh Pallipadi 2126a7b422cdSKonrad Rzeszutek Wilk if (cpufreq_disabled()) 2127a7b422cdSKonrad Rzeszutek Wilk return -ENODEV; 2128a7b422cdSKonrad Rzeszutek Wilk 21295a01f2e8SVenkatesh Pallipadi for_each_possible_cpu(cpu) { 2130f1625066STejun Heo per_cpu(cpufreq_policy_cpu, cpu) = -1; 21315a01f2e8SVenkatesh Pallipadi init_rwsem(&per_cpu(cpu_policy_rwsem, cpu)); 21325a01f2e8SVenkatesh Pallipadi } 21338aa84ad8SThomas Renninger 21342361be23SViresh Kumar cpufreq_global_kobject = kobject_create(); 21358aa84ad8SThomas Renninger BUG_ON(!cpufreq_global_kobject); 2136e00e56dfSRafael J. Wysocki register_syscore_ops(&cpufreq_syscore_ops); 21378aa84ad8SThomas Renninger 21385a01f2e8SVenkatesh Pallipadi return 0; 21395a01f2e8SVenkatesh Pallipadi } 21405a01f2e8SVenkatesh Pallipadi core_initcall(cpufreq_core_init); 2141