1 // SPDX-License-Identifier: GPL-2.0-only
3 * cpufreq driver for Enhanced SpeedStep, as found in Intel's Pentium
4 * M (part of the Centrino chipset).
6 * Since the original Pentium M, most new Intel CPUs support Enhanced
9 * Despite the "SpeedStep" in the name, this is almost entirely unlike
10 * traditional SpeedStep.
12 * Modelled on speedstep.c
14 * Copyright (C) 2003 Jeremy Fitzhardinge <jeremy@goop.org>
17 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
19 #include <linux/kernel.h>
20 #include <linux/module.h>
21 #include <linux/init.h>
22 #include <linux/cpufreq.h>
23 #include <linux/sched.h> /* current */
24 #include <linux/delay.h>
25 #include <linux/compiler.h>
26 #include <linux/gfp.h>
29 #include <asm/processor.h>
30 #include <asm/cpufeature.h>
31 #include <asm/cpu_device_id.h>
33 #define MAINTAINER "linux-pm@vger.kernel.org"
35 #define INTEL_MSR_RANGE (0xffff)
39 __u8 x86
; /* CPU family */
40 __u8 x86_model
; /* model */
41 __u8 x86_stepping
; /* stepping */
53 static const struct cpu_id cpu_ids
[] = {
54 [CPU_BANIAS
] = { 6, 9, 5 },
55 [CPU_DOTHAN_A1
] = { 6, 13, 1 },
56 [CPU_DOTHAN_A2
] = { 6, 13, 2 },
57 [CPU_DOTHAN_B0
] = { 6, 13, 6 },
58 [CPU_MP4HT_D0
] = {15, 3, 4 },
59 [CPU_MP4HT_E0
] = {15, 4, 1 },
61 #define N_IDS ARRAY_SIZE(cpu_ids)
65 const struct cpu_id
*cpu_id
;
66 const char *model_name
;
67 unsigned max_freq
; /* max clock in kHz */
69 struct cpufreq_frequency_table
*op_points
; /* clock/voltage pairs */
71 static int centrino_verify_cpu_id(const struct cpuinfo_x86
*c
,
72 const struct cpu_id
*x
);
74 /* Operating points for current CPU */
75 static DEFINE_PER_CPU(struct cpu_model
*, centrino_model
);
76 static DEFINE_PER_CPU(const struct cpu_id
*, centrino_cpu
);
78 static struct cpufreq_driver centrino_driver
;
80 #ifdef CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE
82 /* Computes the correct form for IA32_PERF_CTL MSR for a particular
83 frequency/voltage operating point; frequency in MHz, volts in mV.
84 This is stored as "driver_data" in the structure. */
87 .frequency = (mhz) * 1000, \
88 .driver_data = (((mhz)/100) << 8) | ((mv - 700) / 16) \
92 * These voltage tables were derived from the Intel Pentium M
93 * datasheet, document 25261202.pdf, Table 5. I have verified they
94 * are consistent with my IBM ThinkPad X31, which has a 1.3GHz Pentium
98 /* Ultra Low Voltage Intel Pentium M processor 900MHz (Banias) */
99 static struct cpufreq_frequency_table banias_900
[] =
104 { .frequency
= CPUFREQ_TABLE_END
}
107 /* Ultra Low Voltage Intel Pentium M processor 1000MHz (Banias) */
108 static struct cpufreq_frequency_table banias_1000
[] =
114 { .frequency
= CPUFREQ_TABLE_END
}
117 /* Low Voltage Intel Pentium M processor 1.10GHz (Banias) */
118 static struct cpufreq_frequency_table banias_1100
[] =
125 { .frequency
= CPUFREQ_TABLE_END
}
129 /* Low Voltage Intel Pentium M processor 1.20GHz (Banias) */
130 static struct cpufreq_frequency_table banias_1200
[] =
138 { .frequency
= CPUFREQ_TABLE_END
}
141 /* Intel Pentium M processor 1.30GHz (Banias) */
142 static struct cpufreq_frequency_table banias_1300
[] =
149 { .frequency
= CPUFREQ_TABLE_END
}
152 /* Intel Pentium M processor 1.40GHz (Banias) */
153 static struct cpufreq_frequency_table banias_1400
[] =
160 { .frequency
= CPUFREQ_TABLE_END
}
163 /* Intel Pentium M processor 1.50GHz (Banias) */
164 static struct cpufreq_frequency_table banias_1500
[] =
172 { .frequency
= CPUFREQ_TABLE_END
}
175 /* Intel Pentium M processor 1.60GHz (Banias) */
176 static struct cpufreq_frequency_table banias_1600
[] =
184 { .frequency
= CPUFREQ_TABLE_END
}
187 /* Intel Pentium M processor 1.70GHz (Banias) */
188 static struct cpufreq_frequency_table banias_1700
[] =
196 { .frequency
= CPUFREQ_TABLE_END
}
200 #define _BANIAS(cpuid, max, name) \
202 .model_name = "Intel(R) Pentium(R) M processor " name "MHz", \
203 .max_freq = (max)*1000, \
204 .op_points = banias_##max, \
206 #define BANIAS(max) _BANIAS(&cpu_ids[CPU_BANIAS], max, #max)
208 /* CPU models, their operating frequency range, and freq/voltage
210 static struct cpu_model models
[] =
212 _BANIAS(&cpu_ids
[CPU_BANIAS
], 900, " 900"),
222 /* NULL model_name is a wildcard */
223 { &cpu_ids
[CPU_DOTHAN_A1
], NULL
, 0, NULL
},
224 { &cpu_ids
[CPU_DOTHAN_A2
], NULL
, 0, NULL
},
225 { &cpu_ids
[CPU_DOTHAN_B0
], NULL
, 0, NULL
},
226 { &cpu_ids
[CPU_MP4HT_D0
], NULL
, 0, NULL
},
227 { &cpu_ids
[CPU_MP4HT_E0
], NULL
, 0, NULL
},
234 static int centrino_cpu_init_table(struct cpufreq_policy
*policy
)
236 struct cpuinfo_x86
*cpu
= &cpu_data(policy
->cpu
);
237 struct cpu_model
*model
;
239 for(model
= models
; model
->cpu_id
!= NULL
; model
++)
240 if (centrino_verify_cpu_id(cpu
, model
->cpu_id
) &&
241 (model
->model_name
== NULL
||
242 strcmp(cpu
->x86_model_id
, model
->model_name
) == 0))
245 if (model
->cpu_id
== NULL
) {
246 /* No match at all */
247 pr_debug("no support for CPU model \"%s\": "
248 "send /proc/cpuinfo to " MAINTAINER
"\n",
253 if (model
->op_points
== NULL
) {
254 /* Matched a non-match */
255 pr_debug("no table support for CPU model \"%s\"\n",
257 pr_debug("try using the acpi-cpufreq driver\n");
261 per_cpu(centrino_model
, policy
->cpu
) = model
;
263 pr_debug("found \"%s\": max frequency: %dkHz\n",
264 model
->model_name
, model
->max_freq
);
270 static inline int centrino_cpu_init_table(struct cpufreq_policy
*policy
)
274 #endif /* CONFIG_X86_SPEEDSTEP_CENTRINO_TABLE */
276 static int centrino_verify_cpu_id(const struct cpuinfo_x86
*c
,
277 const struct cpu_id
*x
)
279 if ((c
->x86
== x
->x86
) &&
280 (c
->x86_model
== x
->x86_model
) &&
281 (c
->x86_stepping
== x
->x86_stepping
))
286 /* To be called only after centrino_model is initialized */
287 static unsigned extract_clock(unsigned msr
, unsigned int cpu
, int failsafe
)
292 * Extract clock in kHz from PERF_CTL value
293 * for centrino, as some DSDTs are buggy.
294 * Ideally, this can be done using the acpi_data structure.
296 if ((per_cpu(centrino_cpu
, cpu
) == &cpu_ids
[CPU_BANIAS
]) ||
297 (per_cpu(centrino_cpu
, cpu
) == &cpu_ids
[CPU_DOTHAN_A1
]) ||
298 (per_cpu(centrino_cpu
, cpu
) == &cpu_ids
[CPU_DOTHAN_B0
])) {
299 msr
= (msr
>> 8) & 0xff;
303 if ((!per_cpu(centrino_model
, cpu
)) ||
304 (!per_cpu(centrino_model
, cpu
)->op_points
))
309 per_cpu(centrino_model
, cpu
)->op_points
[i
].frequency
310 != CPUFREQ_TABLE_END
;
312 if (msr
== per_cpu(centrino_model
, cpu
)->op_points
[i
].driver_data
)
313 return per_cpu(centrino_model
, cpu
)->
314 op_points
[i
].frequency
;
317 return per_cpu(centrino_model
, cpu
)->op_points
[i
-1].frequency
;
322 /* Return the current CPU frequency in kHz */
323 static unsigned int get_cur_freq(unsigned int cpu
)
328 rdmsr_on_cpu(cpu
, MSR_IA32_PERF_STATUS
, &l
, &h
);
329 clock_freq
= extract_clock(l
, cpu
, 0);
331 if (unlikely(clock_freq
== 0)) {
333 * On some CPUs, we can see transient MSR values (which are
334 * not present in _PSS), while CPU is doing some automatic
335 * P-state transition (like TM2). Get the last freq set
338 rdmsr_on_cpu(cpu
, MSR_IA32_PERF_CTL
, &l
, &h
);
339 clock_freq
= extract_clock(l
, cpu
, 1);
345 static int centrino_cpu_init(struct cpufreq_policy
*policy
)
347 struct cpuinfo_x86
*cpu
= &cpu_data(policy
->cpu
);
351 /* Only Intel makes Enhanced Speedstep-capable CPUs */
352 if (cpu
->x86_vendor
!= X86_VENDOR_INTEL
||
353 !cpu_has(cpu
, X86_FEATURE_EST
))
356 if (cpu_has(cpu
, X86_FEATURE_CONSTANT_TSC
))
357 centrino_driver
.flags
|= CPUFREQ_CONST_LOOPS
;
359 if (policy
->cpu
!= 0)
362 for (i
= 0; i
< N_IDS
; i
++)
363 if (centrino_verify_cpu_id(cpu
, &cpu_ids
[i
]))
367 per_cpu(centrino_cpu
, policy
->cpu
) = &cpu_ids
[i
];
369 if (!per_cpu(centrino_cpu
, policy
->cpu
)) {
370 pr_debug("found unsupported CPU with "
371 "Enhanced SpeedStep: send /proc/cpuinfo to "
376 if (centrino_cpu_init_table(policy
))
379 /* Check to see if Enhanced SpeedStep is enabled, and try to
381 rdmsr(MSR_IA32_MISC_ENABLE
, l
, h
);
383 if (!(l
& MSR_IA32_MISC_ENABLE_ENHANCED_SPEEDSTEP
)) {
384 l
|= MSR_IA32_MISC_ENABLE_ENHANCED_SPEEDSTEP
;
385 pr_debug("trying to enable Enhanced SpeedStep (%x)\n", l
);
386 wrmsr(MSR_IA32_MISC_ENABLE
, l
, h
);
388 /* check to see if it stuck */
389 rdmsr(MSR_IA32_MISC_ENABLE
, l
, h
);
390 if (!(l
& MSR_IA32_MISC_ENABLE_ENHANCED_SPEEDSTEP
)) {
391 pr_info("couldn't enable Enhanced SpeedStep\n");
396 policy
->cpuinfo
.transition_latency
= 10000;
397 /* 10uS transition latency */
398 policy
->freq_table
= per_cpu(centrino_model
, policy
->cpu
)->op_points
;
403 static int centrino_cpu_exit(struct cpufreq_policy
*policy
)
405 unsigned int cpu
= policy
->cpu
;
407 if (!per_cpu(centrino_model
, cpu
))
410 per_cpu(centrino_model
, cpu
) = NULL
;
416 * centrino_target - set a new CPUFreq policy
417 * @policy: new policy
418 * @index: index of target frequency
420 * Sets a new CPUFreq policy.
422 static int centrino_target(struct cpufreq_policy
*policy
, unsigned int index
)
424 unsigned int msr
, oldmsr
= 0, h
= 0, cpu
= policy
->cpu
;
426 unsigned int j
, first_cpu
;
427 struct cpufreq_frequency_table
*op_points
;
428 cpumask_var_t covered_cpus
;
430 if (unlikely(!zalloc_cpumask_var(&covered_cpus
, GFP_KERNEL
)))
433 if (unlikely(per_cpu(centrino_model
, cpu
) == NULL
)) {
439 op_points
= &per_cpu(centrino_model
, cpu
)->op_points
[index
];
440 for_each_cpu(j
, policy
->cpus
) {
444 * Support for SMP systems.
445 * Make sure we are running on CPU that wants to change freq
447 if (policy
->shared_type
== CPUFREQ_SHARED_TYPE_ANY
)
448 good_cpu
= cpumask_any_and(policy
->cpus
,
453 if (good_cpu
>= nr_cpu_ids
) {
454 pr_debug("couldn't limit to CPUs in this domain\n");
457 /* We haven't started the transition yet. */
463 msr
= op_points
->driver_data
;
466 rdmsr_on_cpu(good_cpu
, MSR_IA32_PERF_CTL
, &oldmsr
, &h
);
467 if (msr
== (oldmsr
& 0xffff)) {
468 pr_debug("no change needed - msr was and needs "
469 "to be %x\n", oldmsr
);
475 /* all but 16 LSB are reserved, treat them with care */
481 wrmsr_on_cpu(good_cpu
, MSR_IA32_PERF_CTL
, oldmsr
, h
);
482 if (policy
->shared_type
== CPUFREQ_SHARED_TYPE_ANY
)
485 cpumask_set_cpu(j
, covered_cpus
);
488 if (unlikely(retval
)) {
490 * We have failed halfway through the frequency change.
491 * We have sent callbacks to policy->cpus and
492 * MSRs have already been written on coverd_cpus.
496 for_each_cpu(j
, covered_cpus
)
497 wrmsr_on_cpu(j
, MSR_IA32_PERF_CTL
, oldmsr
, h
);
502 free_cpumask_var(covered_cpus
);
506 static struct cpufreq_driver centrino_driver
= {
507 .name
= "centrino", /* should be speedstep-centrino,
508 but there's a 16 char limit */
509 .init
= centrino_cpu_init
,
510 .exit
= centrino_cpu_exit
,
511 .verify
= cpufreq_generic_frequency_table_verify
,
512 .target_index
= centrino_target
,
514 .attr
= cpufreq_generic_attr
,
518 * This doesn't replace the detailed checks above because
519 * the generic CPU IDs don't have a way to match for steppings
520 * or ASCII model IDs.
522 static const struct x86_cpu_id centrino_ids
[] = {
523 X86_MATCH_VENDOR_FAM_MODEL_FEATURE(INTEL
, 6, 9, X86_FEATURE_EST
, NULL
),
524 X86_MATCH_VENDOR_FAM_MODEL_FEATURE(INTEL
, 6, 13, X86_FEATURE_EST
, NULL
),
525 X86_MATCH_VENDOR_FAM_MODEL_FEATURE(INTEL
, 15, 3, X86_FEATURE_EST
, NULL
),
526 X86_MATCH_VENDOR_FAM_MODEL_FEATURE(INTEL
, 15, 4, X86_FEATURE_EST
, NULL
),
531 * centrino_init - initializes the Enhanced SpeedStep CPUFreq driver
533 * Initializes the Enhanced SpeedStep support. Returns -ENODEV on
534 * unsupported devices, -ENOENT if there's no voltage table for this
535 * particular CPU model, -EINVAL on problems during initiatization,
536 * and zero on success.
538 * This is quite picky. Not only does the CPU have to advertise the
539 * "est" flag in the cpuid capability flags, we look for a specific
540 * CPU model and stepping, and we need to have the exact model name in
541 * our voltage tables. That is, be paranoid about not releasing
542 * someone's valuable magic smoke.
544 static int __init
centrino_init(void)
546 if (!x86_match_cpu(centrino_ids
))
548 return cpufreq_register_driver(¢rino_driver
);
551 static void __exit
centrino_exit(void)
553 cpufreq_unregister_driver(¢rino_driver
);
556 MODULE_AUTHOR ("Jeremy Fitzhardinge <jeremy@goop.org>");
557 MODULE_DESCRIPTION ("Enhanced SpeedStep driver for Intel Pentium M processors.");
558 MODULE_LICENSE ("GPL");
560 late_initcall(centrino_init
);
561 module_exit(centrino_exit
);