2 * cpufreq driver for Enhanced SpeedStep, as found in Intel's Pentium
3 * M (part of the Centrino chipset).
5 * Despite the "SpeedStep" in the name, this is almost entirely unlike
6 * traditional SpeedStep.
8 * Modelled on speedstep.c
10 * Copyright (C) 2003 Jeremy Fitzhardinge <jeremy@goop.org>
12 * WARNING WARNING WARNING
14 * This driver manipulates the PERF_CTL MSR, which is only somewhat
15 * documented. While it seems to work on my laptop, it has not been
16 * tested anywhere else, and it may not work for you, do strange
17 * things or simply crash.
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/init.h>
23 #include <linux/cpufreq.h>
24 #include <linux/config.h>
25 #include <linux/sched.h> /* current */
26 #include <linux/delay.h>
27 #include <linux/compiler.h>
29 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI
30 #include <linux/acpi.h>
31 #include <acpi/processor.h>
35 #include <asm/processor.h>
36 #include <asm/cpufeature.h>
38 #define PFX "speedstep-centrino: "
39 #define MAINTAINER "Jeremy Fitzhardinge <jeremy@goop.org>"
41 #define dprintk(msg...) cpufreq_debug_printk(CPUFREQ_DEBUG_DRIVER, "speedstep-centrino", msg)
46 __u8 x86; /* CPU family */
47 __u8 x86_model; /* model */
48 __u8 x86_mask; /* stepping */
60 static const struct cpu_id cpu_ids[] = {
61 [CPU_BANIAS] = { 6, 9, 5 },
62 [CPU_DOTHAN_A1] = { 6, 13, 1 },
63 [CPU_DOTHAN_A2] = { 6, 13, 2 },
64 [CPU_DOTHAN_B0] = { 6, 13, 6 },
65 [CPU_MP4HT_D0] = {15, 3, 4 },
66 [CPU_MP4HT_E0] = {15, 4, 1 },
68 #define N_IDS ARRAY_SIZE(cpu_ids)
72 const struct cpu_id *cpu_id;
73 const char *model_name;
74 unsigned max_freq; /* max clock in kHz */
76 struct cpufreq_frequency_table *op_points; /* clock/voltage pairs */
78 static int centrino_verify_cpu_id(const struct cpuinfo_x86 *c, const struct cpu_id *x);
80 /* Operating points for current CPU */
81 static struct cpu_model *centrino_model[NR_CPUS];
82 static const struct cpu_id *centrino_cpu[NR_CPUS];
84 static struct cpufreq_driver centrino_driver;
86 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE
88 /* Computes the correct form for IA32_PERF_CTL MSR for a particular
89 frequency/voltage operating point; frequency in MHz, volts in mV.
90 This is stored as "index" in the structure. */
93 .frequency = (mhz) * 1000, \
94 .index = (((mhz)/100) << 8) | ((mv - 700) / 16) \
98 * These voltage tables were derived from the Intel Pentium M
99 * datasheet, document 25261202.pdf, Table 5. I have verified they
100 * are consistent with my IBM ThinkPad X31, which has a 1.3GHz Pentium
104 /* Ultra Low Voltage Intel Pentium M processor 900MHz (Banias) */
105 static struct cpufreq_frequency_table banias_900[] =
110 { .frequency = CPUFREQ_TABLE_END }
113 /* Ultra Low Voltage Intel Pentium M processor 1000MHz (Banias) */
114 static struct cpufreq_frequency_table banias_1000[] =
120 { .frequency = CPUFREQ_TABLE_END }
123 /* Low Voltage Intel Pentium M processor 1.10GHz (Banias) */
124 static struct cpufreq_frequency_table banias_1100[] =
131 { .frequency = CPUFREQ_TABLE_END }
135 /* Low Voltage Intel Pentium M processor 1.20GHz (Banias) */
136 static struct cpufreq_frequency_table banias_1200[] =
144 { .frequency = CPUFREQ_TABLE_END }
147 /* Intel Pentium M processor 1.30GHz (Banias) */
148 static struct cpufreq_frequency_table banias_1300[] =
155 { .frequency = CPUFREQ_TABLE_END }
158 /* Intel Pentium M processor 1.40GHz (Banias) */
159 static struct cpufreq_frequency_table banias_1400[] =
166 { .frequency = CPUFREQ_TABLE_END }
169 /* Intel Pentium M processor 1.50GHz (Banias) */
170 static struct cpufreq_frequency_table banias_1500[] =
178 { .frequency = CPUFREQ_TABLE_END }
181 /* Intel Pentium M processor 1.60GHz (Banias) */
182 static struct cpufreq_frequency_table banias_1600[] =
190 { .frequency = CPUFREQ_TABLE_END }
193 /* Intel Pentium M processor 1.70GHz (Banias) */
194 static struct cpufreq_frequency_table banias_1700[] =
202 { .frequency = CPUFREQ_TABLE_END }
206 #define _BANIAS(cpuid, max, name) \
208 .model_name = "Intel(R) Pentium(R) M processor " name "MHz", \
209 .max_freq = (max)*1000, \
210 .op_points = banias_##max, \
212 #define BANIAS(max) _BANIAS(&cpu_ids[CPU_BANIAS], max, #max)
214 /* CPU models, their operating frequency range, and freq/voltage
216 static struct cpu_model models[] =
218 _BANIAS(&cpu_ids[CPU_BANIAS], 900, " 900"),
228 /* NULL model_name is a wildcard */
229 { &cpu_ids[CPU_DOTHAN_A1], NULL, 0, NULL },
230 { &cpu_ids[CPU_DOTHAN_A2], NULL, 0, NULL },
231 { &cpu_ids[CPU_DOTHAN_B0], NULL, 0, NULL },
232 { &cpu_ids[CPU_MP4HT_D0], NULL, 0, NULL },
233 { &cpu_ids[CPU_MP4HT_E0], NULL, 0, NULL },
240 static int centrino_cpu_init_table(struct cpufreq_policy *policy)
242 struct cpuinfo_x86 *cpu = &cpu_data[policy->cpu];
243 struct cpu_model *model;
245 for(model = models; model->cpu_id != NULL; model++)
246 if (centrino_verify_cpu_id(cpu, model->cpu_id) &&
247 (model->model_name == NULL ||
248 strcmp(cpu->x86_model_id, model->model_name) == 0))
251 if (model->cpu_id == NULL) {
252 /* No match at all */
253 dprintk("no support for CPU model \"%s\": "
254 "send /proc/cpuinfo to " MAINTAINER "\n",
259 if (model->op_points == NULL) {
260 /* Matched a non-match */
261 dprintk("no table support for CPU model \"%s\"\n",
263 #ifndef CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI
264 dprintk("try compiling with CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI enabled\n");
269 centrino_model[policy->cpu] = model;
271 dprintk("found \"%s\": max frequency: %dkHz\n",
272 model->model_name, model->max_freq);
278 static inline int centrino_cpu_init_table(struct cpufreq_policy *policy) { return -ENODEV; }
279 #endif /* CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE */
281 static int centrino_verify_cpu_id(const struct cpuinfo_x86 *c, const struct cpu_id *x)
283 if ((c->x86 == x->x86) &&
284 (c->x86_model == x->x86_model) &&
285 (c->x86_mask == x->x86_mask))
290 /* To be called only after centrino_model is initialized */
291 static unsigned extract_clock(unsigned msr, unsigned int cpu, int failsafe)
296 * Extract clock in kHz from PERF_CTL value
297 * for centrino, as some DSDTs are buggy.
298 * Ideally, this can be done using the acpi_data structure.
300 if ((centrino_cpu[cpu] == &cpu_ids[CPU_BANIAS]) ||
301 (centrino_cpu[cpu] == &cpu_ids[CPU_DOTHAN_A1]) ||
302 (centrino_cpu[cpu] == &cpu_ids[CPU_DOTHAN_B0])) {
303 msr = (msr >> 8) & 0xff;
307 if ((!centrino_model[cpu]) || (!centrino_model[cpu]->op_points))
311 for (i=0;centrino_model[cpu]->op_points[i].frequency != CPUFREQ_TABLE_END; i++) {
312 if (msr == centrino_model[cpu]->op_points[i].index)
313 return centrino_model[cpu]->op_points[i].frequency;
316 return 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(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(current, saved_mask);
352 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI
354 static struct acpi_processor_performance p;
357 * centrino_cpu_init_acpi - register with ACPI P-States library
359 * Register with the ACPI P-States library (part of drivers/acpi/processor.c)
360 * in order to determine correct frequency and voltage pairings by reading
361 * the _PSS of the ACPI DSDT or SSDT tables.
363 static int centrino_cpu_init_acpi(struct cpufreq_policy *policy)
365 unsigned long cur_freq;
367 unsigned int cpu = policy->cpu;
369 /* register with ACPI core */
370 if (acpi_processor_register_performance(&p, cpu)) {
371 dprintk("obtaining ACPI data failed\n");
375 /* verify the acpi_data */
376 if (p.state_count <= 1) {
377 dprintk("No P-States\n");
382 if ((p.control_register.space_id != ACPI_ADR_SPACE_FIXED_HARDWARE) ||
383 (p.status_register.space_id != ACPI_ADR_SPACE_FIXED_HARDWARE)) {
384 dprintk("Invalid control/status registers (%x - %x)\n",
385 p.control_register.space_id, p.status_register.space_id);
390 for (i=0; i<p.state_count; i++) {
391 if (p.states[i].control != p.states[i].status) {
392 dprintk("Different control (%llu) and status values (%llu)\n",
393 p.states[i].control, p.states[i].status);
398 if (!p.states[i].core_frequency) {
399 dprintk("Zero core frequency for state %u\n", i);
404 if (p.states[i].core_frequency > p.states[0].core_frequency) {
405 dprintk("P%u has larger frequency (%llu) than P0 (%llu), skipping\n", i,
406 p.states[i].core_frequency, p.states[0].core_frequency);
407 p.states[i].core_frequency = 0;
412 centrino_model[cpu] = kzalloc(sizeof(struct cpu_model), GFP_KERNEL);
413 if (!centrino_model[cpu]) {
418 centrino_model[cpu]->model_name=NULL;
419 centrino_model[cpu]->max_freq = p.states[0].core_frequency * 1000;
420 centrino_model[cpu]->op_points = kmalloc(sizeof(struct cpufreq_frequency_table) *
421 (p.state_count + 1), GFP_KERNEL);
422 if (!centrino_model[cpu]->op_points) {
427 for (i=0; i<p.state_count; i++) {
428 centrino_model[cpu]->op_points[i].index = p.states[i].control;
429 centrino_model[cpu]->op_points[i].frequency = p.states[i].core_frequency * 1000;
430 dprintk("adding state %i with frequency %u and control value %04x\n",
431 i, centrino_model[cpu]->op_points[i].frequency, centrino_model[cpu]->op_points[i].index);
433 centrino_model[cpu]->op_points[p.state_count].frequency = CPUFREQ_TABLE_END;
435 cur_freq = get_cur_freq(cpu);
437 for (i=0; i<p.state_count; i++) {
438 if (!p.states[i].core_frequency) {
439 dprintk("skipping state %u\n", i);
440 centrino_model[cpu]->op_points[i].frequency = CPUFREQ_ENTRY_INVALID;
444 if (extract_clock(centrino_model[cpu]->op_points[i].index, cpu, 0) !=
445 (centrino_model[cpu]->op_points[i].frequency)) {
446 dprintk("Invalid encoded frequency (%u vs. %u)\n",
447 extract_clock(centrino_model[cpu]->op_points[i].index, cpu, 0),
448 centrino_model[cpu]->op_points[i].frequency);
453 if (cur_freq == centrino_model[cpu]->op_points[i].frequency)
457 /* notify BIOS that we exist */
458 acpi_processor_notify_smm(THIS_MODULE);
463 kfree(centrino_model[cpu]->op_points);
465 kfree(centrino_model[cpu]);
467 acpi_processor_unregister_performance(&p, cpu);
468 dprintk("invalid ACPI data\n");
472 static inline int centrino_cpu_init_acpi(struct cpufreq_policy *policy) { return -ENODEV; }
475 static int centrino_cpu_init(struct cpufreq_policy *policy)
477 struct cpuinfo_x86 *cpu = &cpu_data[policy->cpu];
483 /* Only Intel makes Enhanced Speedstep-capable CPUs */
484 if (cpu->x86_vendor != X86_VENDOR_INTEL || !cpu_has(cpu, X86_FEATURE_EST))
487 if (cpu_has(cpu, X86_FEATURE_CONSTANT_TSC))
488 centrino_driver.flags |= CPUFREQ_CONST_LOOPS;
490 if (centrino_cpu_init_acpi(policy)) {
491 if (policy->cpu != 0)
494 for (i = 0; i < N_IDS; i++)
495 if (centrino_verify_cpu_id(cpu, &cpu_ids[i]))
499 centrino_cpu[policy->cpu] = &cpu_ids[i];
501 if (!centrino_cpu[policy->cpu]) {
502 dprintk("found unsupported CPU with "
503 "Enhanced SpeedStep: send /proc/cpuinfo to "
508 if (centrino_cpu_init_table(policy)) {
513 /* Check to see if Enhanced SpeedStep is enabled, and try to
515 rdmsr(MSR_IA32_MISC_ENABLE, l, h);
517 if (!(l & (1<<16))) {
519 dprintk("trying to enable Enhanced SpeedStep (%x)\n", l);
520 wrmsr(MSR_IA32_MISC_ENABLE, l, h);
522 /* check to see if it stuck */
523 rdmsr(MSR_IA32_MISC_ENABLE, l, h);
524 if (!(l & (1<<16))) {
525 printk(KERN_INFO PFX "couldn't enable Enhanced SpeedStep\n");
530 freq = get_cur_freq(policy->cpu);
532 policy->governor = CPUFREQ_DEFAULT_GOVERNOR;
533 policy->cpuinfo.transition_latency = 10000; /* 10uS transition latency */
536 dprintk("centrino_cpu_init: cur=%dkHz\n", policy->cur);
538 ret = cpufreq_frequency_table_cpuinfo(policy, centrino_model[policy->cpu]->op_points);
542 cpufreq_frequency_table_get_attr(centrino_model[policy->cpu]->op_points, policy->cpu);
547 static int centrino_cpu_exit(struct cpufreq_policy *policy)
549 unsigned int cpu = policy->cpu;
551 if (!centrino_model[cpu])
554 cpufreq_frequency_table_put_attr(cpu);
556 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI
557 if (!centrino_model[cpu]->model_name) {
558 dprintk("unregistering and freeing ACPI data\n");
559 acpi_processor_unregister_performance(&p, cpu);
560 kfree(centrino_model[cpu]->op_points);
561 kfree(centrino_model[cpu]);
565 centrino_model[cpu] = NULL;
571 * centrino_verify - verifies a new CPUFreq policy
572 * @policy: new policy
574 * Limit must be within this model's frequency range at least one
577 static int centrino_verify (struct cpufreq_policy *policy)
579 return cpufreq_frequency_table_verify(policy, centrino_model[policy->cpu]->op_points);
583 * centrino_setpolicy - set a new CPUFreq policy
584 * @policy: new policy
585 * @target_freq: the target frequency
586 * @relation: how that frequency relates to achieved frequency (CPUFREQ_RELATION_L or CPUFREQ_RELATION_H)
588 * Sets a new CPUFreq policy.
590 static int centrino_target (struct cpufreq_policy *policy,
591 unsigned int target_freq,
592 unsigned int relation)
594 unsigned int newstate = 0;
595 unsigned int msr, oldmsr, h, cpu = policy->cpu;
596 struct cpufreq_freqs freqs;
597 cpumask_t saved_mask;
600 if (centrino_model[cpu] == NULL)
604 * Support for SMP systems.
605 * Make sure we are running on the CPU that wants to change frequency
607 saved_mask = current->cpus_allowed;
608 set_cpus_allowed(current, policy->cpus);
609 if (!cpu_isset(smp_processor_id(), policy->cpus)) {
610 dprintk("couldn't limit to CPUs in this domain\n");
614 if (cpufreq_frequency_table_target(policy, centrino_model[cpu]->op_points, target_freq,
615 relation, &newstate)) {
620 msr = centrino_model[cpu]->op_points[newstate].index;
621 rdmsr(MSR_IA32_PERF_CTL, oldmsr, h);
623 if (msr == (oldmsr & 0xffff)) {
625 dprintk("no change needed - msr was and needs to be %x\n", oldmsr);
630 freqs.old = extract_clock(oldmsr, cpu, 0);
631 freqs.new = extract_clock(msr, cpu, 0);
633 dprintk("target=%dkHz old=%d new=%d msr=%04x\n",
634 target_freq, freqs.old, freqs.new, msr);
636 cpufreq_notify_transition(&freqs, CPUFREQ_PRECHANGE);
638 /* all but 16 LSB are "reserved", so treat them with
644 wrmsr(MSR_IA32_PERF_CTL, oldmsr, h);
646 cpufreq_notify_transition(&freqs, CPUFREQ_POSTCHANGE);
650 set_cpus_allowed(current, saved_mask);
654 static struct freq_attr* centrino_attr[] = {
655 &cpufreq_freq_attr_scaling_available_freqs,
659 static struct cpufreq_driver centrino_driver = {
660 .name = "centrino", /* should be speedstep-centrino,
661 but there's a 16 char limit */
662 .init = centrino_cpu_init,
663 .exit = centrino_cpu_exit,
664 .verify = centrino_verify,
665 .target = centrino_target,
667 .attr = centrino_attr,
668 .owner = THIS_MODULE,
673 * centrino_init - initializes the Enhanced SpeedStep CPUFreq driver
675 * Initializes the Enhanced SpeedStep support. Returns -ENODEV on
676 * unsupported devices, -ENOENT if there's no voltage table for this
677 * particular CPU model, -EINVAL on problems during initiatization,
678 * and zero on success.
680 * This is quite picky. Not only does the CPU have to advertise the
681 * "est" flag in the cpuid capability flags, we look for a specific
682 * CPU model and stepping, and we need to have the exact model name in
683 * our voltage tables. That is, be paranoid about not releasing
684 * someone's valuable magic smoke.
686 static int __init centrino_init(void)
688 struct cpuinfo_x86 *cpu = cpu_data;
690 if (!cpu_has(cpu, X86_FEATURE_EST))
693 return cpufreq_register_driver(¢rino_driver);
696 static void __exit centrino_exit(void)
698 cpufreq_unregister_driver(¢rino_driver);
701 MODULE_AUTHOR ("Jeremy Fitzhardinge <jeremy@goop.org>");
702 MODULE_DESCRIPTION ("Enhanced SpeedStep driver for Intel Pentium M processors.");
703 MODULE_LICENSE ("GPL");
705 late_initcall(centrino_init);
706 module_exit(centrino_exit);