2 * cpufreq driver for Enhanced SpeedStep, as found in Intel's Pentium
3 * M (part of the Centrino chipset).
5 * Since the original Pentium M, most new Intel CPUs support Enhanced
8 * Despite the "SpeedStep" in the name, this is almost entirely unlike
9 * traditional SpeedStep.
11 * Modelled on speedstep.c
13 * Copyright (C) 2003 Jeremy Fitzhardinge <jeremy@goop.org>
16 #include <linux/kernel.h>
17 #include <linux/module.h>
18 #include <linux/init.h>
19 #include <linux/cpufreq.h>
20 #include <linux/sched.h> /* current */
21 #include <linux/delay.h>
22 #include <linux/compiler.h>
25 #include <asm/processor.h>
26 #include <asm/cpufeature.h>
28 #define PFX "speedstep-centrino: "
29 #define MAINTAINER "cpufreq@lists.linux.org.uk"
31 #define dprintk(msg...) \
32 cpufreq_debug_printk(CPUFREQ_DEBUG_DRIVER, "speedstep-centrino", msg)
34 #define INTEL_MSR_RANGE (0xffff)
38 __u8 x86; /* CPU family */
39 __u8 x86_model; /* model */
40 __u8 x86_mask; /* stepping */
52 static const struct cpu_id cpu_ids[] = {
53 [CPU_BANIAS] = { 6, 9, 5 },
54 [CPU_DOTHAN_A1] = { 6, 13, 1 },
55 [CPU_DOTHAN_A2] = { 6, 13, 2 },
56 [CPU_DOTHAN_B0] = { 6, 13, 6 },
57 [CPU_MP4HT_D0] = {15, 3, 4 },
58 [CPU_MP4HT_E0] = {15, 4, 1 },
60 #define N_IDS ARRAY_SIZE(cpu_ids)
64 const struct cpu_id *cpu_id;
65 const char *model_name;
66 unsigned max_freq; /* max clock in kHz */
68 struct cpufreq_frequency_table *op_points; /* clock/voltage pairs */
70 static int centrino_verify_cpu_id(const struct cpuinfo_x86 *c,
71 const struct cpu_id *x);
73 /* Operating points for current CPU */
74 static DEFINE_PER_CPU(struct cpu_model *, centrino_model);
75 static DEFINE_PER_CPU(const struct cpu_id *, centrino_cpu);
77 static struct cpufreq_driver centrino_driver;
79 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE
81 /* Computes the correct form for IA32_PERF_CTL MSR for a particular
82 frequency/voltage operating point; frequency in MHz, volts in mV.
83 This is stored as "index" in the structure. */
86 .frequency = (mhz) * 1000, \
87 .index = (((mhz)/100) << 8) | ((mv - 700) / 16) \
91 * These voltage tables were derived from the Intel Pentium M
92 * datasheet, document 25261202.pdf, Table 5. I have verified they
93 * are consistent with my IBM ThinkPad X31, which has a 1.3GHz Pentium
97 /* Ultra Low Voltage Intel Pentium M processor 900MHz (Banias) */
98 static struct cpufreq_frequency_table banias_900[] =
103 { .frequency = CPUFREQ_TABLE_END }
106 /* Ultra Low Voltage Intel Pentium M processor 1000MHz (Banias) */
107 static struct cpufreq_frequency_table banias_1000[] =
113 { .frequency = CPUFREQ_TABLE_END }
116 /* Low Voltage Intel Pentium M processor 1.10GHz (Banias) */
117 static struct cpufreq_frequency_table banias_1100[] =
124 { .frequency = CPUFREQ_TABLE_END }
128 /* Low Voltage Intel Pentium M processor 1.20GHz (Banias) */
129 static struct cpufreq_frequency_table banias_1200[] =
137 { .frequency = CPUFREQ_TABLE_END }
140 /* Intel Pentium M processor 1.30GHz (Banias) */
141 static struct cpufreq_frequency_table banias_1300[] =
148 { .frequency = CPUFREQ_TABLE_END }
151 /* Intel Pentium M processor 1.40GHz (Banias) */
152 static struct cpufreq_frequency_table banias_1400[] =
159 { .frequency = CPUFREQ_TABLE_END }
162 /* Intel Pentium M processor 1.50GHz (Banias) */
163 static struct cpufreq_frequency_table banias_1500[] =
171 { .frequency = CPUFREQ_TABLE_END }
174 /* Intel Pentium M processor 1.60GHz (Banias) */
175 static struct cpufreq_frequency_table banias_1600[] =
183 { .frequency = CPUFREQ_TABLE_END }
186 /* Intel Pentium M processor 1.70GHz (Banias) */
187 static struct cpufreq_frequency_table banias_1700[] =
195 { .frequency = CPUFREQ_TABLE_END }
199 #define _BANIAS(cpuid, max, name) \
201 .model_name = "Intel(R) Pentium(R) M processor " name "MHz", \
202 .max_freq = (max)*1000, \
203 .op_points = banias_##max, \
205 #define BANIAS(max) _BANIAS(&cpu_ids[CPU_BANIAS], max, #max)
207 /* CPU models, their operating frequency range, and freq/voltage
209 static struct cpu_model models[] =
211 _BANIAS(&cpu_ids[CPU_BANIAS], 900, " 900"),
221 /* NULL model_name is a wildcard */
222 { &cpu_ids[CPU_DOTHAN_A1], NULL, 0, NULL },
223 { &cpu_ids[CPU_DOTHAN_A2], NULL, 0, NULL },
224 { &cpu_ids[CPU_DOTHAN_B0], NULL, 0, NULL },
225 { &cpu_ids[CPU_MP4HT_D0], NULL, 0, NULL },
226 { &cpu_ids[CPU_MP4HT_E0], NULL, 0, NULL },
233 static int centrino_cpu_init_table(struct cpufreq_policy *policy)
235 struct cpuinfo_x86 *cpu = &cpu_data(policy->cpu);
236 struct cpu_model *model;
238 for(model = models; model->cpu_id != NULL; model++)
239 if (centrino_verify_cpu_id(cpu, model->cpu_id) &&
240 (model->model_name == NULL ||
241 strcmp(cpu->x86_model_id, model->model_name) == 0))
244 if (model->cpu_id == NULL) {
245 /* No match at all */
246 dprintk("no support for CPU model \"%s\": "
247 "send /proc/cpuinfo to " MAINTAINER "\n",
252 if (model->op_points == NULL) {
253 /* Matched a non-match */
254 dprintk("no table support for CPU model \"%s\"\n",
256 dprintk("try using the acpi-cpufreq driver\n");
260 per_cpu(centrino_model, policy->cpu) = model;
262 dprintk("found \"%s\": max frequency: %dkHz\n",
263 model->model_name, model->max_freq);
269 static inline int centrino_cpu_init_table(struct cpufreq_policy *policy)
273 #endif /* CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE */
275 static int centrino_verify_cpu_id(const struct cpuinfo_x86 *c,
276 const struct cpu_id *x)
278 if ((c->x86 == x->x86) &&
279 (c->x86_model == x->x86_model) &&
280 (c->x86_mask == x->x86_mask))
285 /* To be called only after centrino_model is initialized */
286 static unsigned extract_clock(unsigned msr, unsigned int cpu, int failsafe)
291 * Extract clock in kHz from PERF_CTL value
292 * for centrino, as some DSDTs are buggy.
293 * Ideally, this can be done using the acpi_data structure.
295 if ((per_cpu(centrino_cpu, cpu) == &cpu_ids[CPU_BANIAS]) ||
296 (per_cpu(centrino_cpu, cpu) == &cpu_ids[CPU_DOTHAN_A1]) ||
297 (per_cpu(centrino_cpu, cpu) == &cpu_ids[CPU_DOTHAN_B0])) {
298 msr = (msr >> 8) & 0xff;
302 if ((!per_cpu(centrino_model, cpu)) ||
303 (!per_cpu(centrino_model, cpu)->op_points))
308 per_cpu(centrino_model, cpu)->op_points[i].frequency
309 != CPUFREQ_TABLE_END;
311 if (msr == per_cpu(centrino_model, cpu)->op_points[i].index)
312 return per_cpu(centrino_model, cpu)->
313 op_points[i].frequency;
316 return per_cpu(centrino_model, cpu)->op_points[i-1].frequency;
321 /* Return the current CPU frequency in kHz */
322 static unsigned int get_cur_freq(unsigned int cpu)
326 cpumask_t saved_mask;
328 saved_mask = current->cpus_allowed;
329 set_cpus_allowed_ptr(current, &cpumask_of_cpu(cpu));
330 if (smp_processor_id() != cpu)
333 rdmsr(MSR_IA32_PERF_STATUS, l, h);
334 clock_freq = extract_clock(l, cpu, 0);
336 if (unlikely(clock_freq == 0)) {
338 * On some CPUs, we can see transient MSR values (which are
339 * not present in _PSS), while CPU is doing some automatic
340 * P-state transition (like TM2). Get the last freq set
343 rdmsr(MSR_IA32_PERF_CTL, l, h);
344 clock_freq = extract_clock(l, cpu, 1);
347 set_cpus_allowed_ptr(current, &saved_mask);
352 static int centrino_cpu_init(struct cpufreq_policy *policy)
354 struct cpuinfo_x86 *cpu = &cpu_data(policy->cpu);
360 /* Only Intel makes Enhanced Speedstep-capable CPUs */
361 if (cpu->x86_vendor != X86_VENDOR_INTEL ||
362 !cpu_has(cpu, X86_FEATURE_EST))
365 if (cpu_has(cpu, X86_FEATURE_CONSTANT_TSC))
366 centrino_driver.flags |= CPUFREQ_CONST_LOOPS;
368 if (policy->cpu != 0)
371 for (i = 0; i < N_IDS; i++)
372 if (centrino_verify_cpu_id(cpu, &cpu_ids[i]))
376 per_cpu(centrino_cpu, policy->cpu) = &cpu_ids[i];
378 if (!per_cpu(centrino_cpu, policy->cpu)) {
379 dprintk("found unsupported CPU with "
380 "Enhanced SpeedStep: send /proc/cpuinfo to "
385 if (centrino_cpu_init_table(policy)) {
389 /* Check to see if Enhanced SpeedStep is enabled, and try to
391 rdmsr(MSR_IA32_MISC_ENABLE, l, h);
393 if (!(l & (1<<16))) {
395 dprintk("trying to enable Enhanced SpeedStep (%x)\n", l);
396 wrmsr(MSR_IA32_MISC_ENABLE, l, h);
398 /* check to see if it stuck */
399 rdmsr(MSR_IA32_MISC_ENABLE, l, h);
400 if (!(l & (1<<16))) {
402 "couldn't enable Enhanced SpeedStep\n");
407 freq = get_cur_freq(policy->cpu);
408 policy->cpuinfo.transition_latency = 10000;
409 /* 10uS transition latency */
412 dprintk("centrino_cpu_init: cur=%dkHz\n", policy->cur);
414 ret = cpufreq_frequency_table_cpuinfo(policy,
415 per_cpu(centrino_model, policy->cpu)->op_points);
419 cpufreq_frequency_table_get_attr(
420 per_cpu(centrino_model, policy->cpu)->op_points, policy->cpu);
425 static int centrino_cpu_exit(struct cpufreq_policy *policy)
427 unsigned int cpu = policy->cpu;
429 if (!per_cpu(centrino_model, cpu))
432 cpufreq_frequency_table_put_attr(cpu);
434 per_cpu(centrino_model, cpu) = NULL;
440 * centrino_verify - verifies a new CPUFreq policy
441 * @policy: new policy
443 * Limit must be within this model's frequency range at least one
446 static int centrino_verify (struct cpufreq_policy *policy)
448 return cpufreq_frequency_table_verify(policy,
449 per_cpu(centrino_model, policy->cpu)->op_points);
453 * centrino_setpolicy - set a new CPUFreq policy
454 * @policy: new policy
455 * @target_freq: the target frequency
456 * @relation: how that frequency relates to achieved frequency
457 * (CPUFREQ_RELATION_L or CPUFREQ_RELATION_H)
459 * Sets a new CPUFreq policy.
462 cpumask_t online_policy_cpus;
463 cpumask_t saved_mask;
465 cpumask_t covered_cpus;
468 static int centrino_target (struct cpufreq_policy *policy,
469 unsigned int target_freq,
470 unsigned int relation)
472 unsigned int newstate = 0;
473 unsigned int msr, oldmsr = 0, h = 0, cpu = policy->cpu;
474 struct cpufreq_freqs freqs;
476 unsigned int j, k, first_cpu, tmp;
477 CPUMASK_ALLOC(allmasks);
478 CPUMASK_PTR(online_policy_cpus, allmasks);
479 CPUMASK_PTR(saved_mask, allmasks);
480 CPUMASK_PTR(set_mask, allmasks);
481 CPUMASK_PTR(covered_cpus, allmasks);
483 if (unlikely(allmasks == NULL))
486 if (unlikely(per_cpu(centrino_model, cpu) == NULL)) {
491 if (unlikely(cpufreq_frequency_table_target(policy,
492 per_cpu(centrino_model, cpu)->op_points,
500 #ifdef CONFIG_HOTPLUG_CPU
501 /* cpufreq holds the hotplug lock, so we are safe from here on */
502 cpus_and(*online_policy_cpus, cpu_online_map, policy->cpus);
504 *online_policy_cpus = policy->cpus;
507 *saved_mask = current->cpus_allowed;
509 cpus_clear(*covered_cpus);
510 for_each_cpu_mask_nr(j, *online_policy_cpus) {
512 * Support for SMP systems.
513 * Make sure we are running on CPU that wants to change freq
515 cpus_clear(*set_mask);
516 if (policy->shared_type == CPUFREQ_SHARED_TYPE_ANY)
517 cpus_or(*set_mask, *set_mask, *online_policy_cpus);
519 cpu_set(j, *set_mask);
521 set_cpus_allowed_ptr(current, set_mask);
523 if (unlikely(!cpu_isset(smp_processor_id(), *set_mask))) {
524 dprintk("couldn't limit to CPUs in this domain\n");
527 /* We haven't started the transition yet. */
534 msr = per_cpu(centrino_model, cpu)->op_points[newstate].index;
537 rdmsr(MSR_IA32_PERF_CTL, oldmsr, h);
538 if (msr == (oldmsr & 0xffff)) {
539 dprintk("no change needed - msr was and needs "
540 "to be %x\n", oldmsr);
545 freqs.old = extract_clock(oldmsr, cpu, 0);
546 freqs.new = extract_clock(msr, cpu, 0);
548 dprintk("target=%dkHz old=%d new=%d msr=%04x\n",
549 target_freq, freqs.old, freqs.new, msr);
551 for_each_cpu_mask_nr(k, *online_policy_cpus) {
553 cpufreq_notify_transition(&freqs,
558 /* all but 16 LSB are reserved, treat them with care */
564 wrmsr(MSR_IA32_PERF_CTL, oldmsr, h);
565 if (policy->shared_type == CPUFREQ_SHARED_TYPE_ANY) {
570 cpu_set(j, *covered_cpus);
574 for_each_cpu_mask_nr(k, *online_policy_cpus) {
576 cpufreq_notify_transition(&freqs, CPUFREQ_POSTCHANGE);
579 if (unlikely(retval)) {
581 * We have failed halfway through the frequency change.
582 * We have sent callbacks to policy->cpus and
583 * MSRs have already been written on coverd_cpus.
587 if (!cpus_empty(*covered_cpus))
588 for_each_cpu_mask_nr(j, *covered_cpus) {
589 set_cpus_allowed_ptr(current,
591 wrmsr(MSR_IA32_PERF_CTL, oldmsr, h);
595 freqs.new = freqs.old;
597 for_each_cpu_mask_nr(j, *online_policy_cpus) {
599 cpufreq_notify_transition(&freqs, CPUFREQ_PRECHANGE);
600 cpufreq_notify_transition(&freqs, CPUFREQ_POSTCHANGE);
603 set_cpus_allowed_ptr(current, saved_mask);
609 set_cpus_allowed_ptr(current, saved_mask);
611 CPUMASK_FREE(allmasks);
615 static struct freq_attr* centrino_attr[] = {
616 &cpufreq_freq_attr_scaling_available_freqs,
620 static struct cpufreq_driver centrino_driver = {
621 .name = "centrino", /* should be speedstep-centrino,
622 but there's a 16 char limit */
623 .init = centrino_cpu_init,
624 .exit = centrino_cpu_exit,
625 .verify = centrino_verify,
626 .target = centrino_target,
628 .attr = centrino_attr,
629 .owner = THIS_MODULE,
634 * centrino_init - initializes the Enhanced SpeedStep CPUFreq driver
636 * Initializes the Enhanced SpeedStep support. Returns -ENODEV on
637 * unsupported devices, -ENOENT if there's no voltage table for this
638 * particular CPU model, -EINVAL on problems during initiatization,
639 * and zero on success.
641 * This is quite picky. Not only does the CPU have to advertise the
642 * "est" flag in the cpuid capability flags, we look for a specific
643 * CPU model and stepping, and we need to have the exact model name in
644 * our voltage tables. That is, be paranoid about not releasing
645 * someone's valuable magic smoke.
647 static int __init centrino_init(void)
649 struct cpuinfo_x86 *cpu = &cpu_data(0);
651 if (!cpu_has(cpu, X86_FEATURE_EST))
654 return cpufreq_register_driver(¢rino_driver);
657 static void __exit centrino_exit(void)
659 cpufreq_unregister_driver(¢rino_driver);
662 MODULE_AUTHOR ("Jeremy Fitzhardinge <jeremy@goop.org>");
663 MODULE_DESCRIPTION ("Enhanced SpeedStep driver for Intel Pentium M processors.");
664 MODULE_LICENSE ("GPL");
666 late_initcall(centrino_init);
667 module_exit(centrino_exit);