1 // SPDX-License-Identifier: GPL-2.0-only
3 * x86_pkg_temp_thermal driver
4 * Copyright (c) 2013, Intel Corporation.
6 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
8 #include <linux/module.h>
9 #include <linux/init.h>
10 #include <linux/intel_tcc.h>
11 #include <linux/err.h>
12 #include <linux/param.h>
13 #include <linux/device.h>
14 #include <linux/platform_device.h>
15 #include <linux/cpu.h>
16 #include <linux/smp.h>
17 #include <linux/slab.h>
19 #include <linux/thermal.h>
20 #include <linux/debugfs.h>
22 #include <asm/cpu_device_id.h>
24 #include "thermal_interrupt.h"
27 * Rate control delay: Idea is to introduce denounce effect
28 * This should be long enough to avoid reduce events, when
29 * threshold is set to a temperature, which is constantly
30 * violated, but at the short enough to take any action.
31 * The action can be remove threshold or change it to next
32 * interesting setting. Based on experiments, in around
33 * every 5 seconds under load will give us a significant
36 #define PKG_TEMP_THERMAL_NOTIFY_DELAY 5000
37 static int notify_delay_ms = PKG_TEMP_THERMAL_NOTIFY_DELAY;
38 module_param(notify_delay_ms, int, 0644);
39 MODULE_PARM_DESC(notify_delay_ms,
40 "User space notification delay in milli seconds.");
42 /* Number of trip points in thermal zone. Currently it can't
43 * be more than 2. MSR can allow setting and getting notifications
44 * for only 2 thresholds. This define enforces this, if there
45 * is some wrong values returned by cpuid for number of thresholds.
47 #define MAX_NUMBER_OF_TRIPS 2
52 u32 msr_pkg_therm_low;
53 u32 msr_pkg_therm_high;
54 struct delayed_work work;
55 struct thermal_zone_device *tzone;
56 struct thermal_trip *trips;
57 struct cpumask cpumask;
60 static struct thermal_zone_params pkg_temp_tz_params = {
64 /* Keep track of how many zone pointers we allocated in init() */
65 static int max_id __read_mostly;
66 /* Array of zone pointers */
67 static struct zone_device **zones;
68 /* Serializes interrupt notification, work and hotplug */
69 static DEFINE_RAW_SPINLOCK(pkg_temp_lock);
70 /* Protects zone operation in the work function against hotplug removal */
71 static DEFINE_MUTEX(thermal_zone_mutex);
73 /* The dynamically assigned cpu hotplug state for module_exit() */
74 static enum cpuhp_state pkg_thermal_hp_state __read_mostly;
76 /* Debug counters to show using debugfs */
77 static struct dentry *debugfs;
78 static unsigned int pkg_interrupt_cnt;
79 static unsigned int pkg_work_cnt;
81 static void pkg_temp_debugfs_init(void)
83 debugfs = debugfs_create_dir("pkg_temp_thermal", NULL);
85 debugfs_create_u32("pkg_thres_interrupt", S_IRUGO, debugfs,
87 debugfs_create_u32("pkg_thres_work", S_IRUGO, debugfs,
94 * - cpu hotplug: Read serialized by cpu hotplug lock
95 * Write must hold pkg_temp_lock
97 * - Other callsites: Must hold pkg_temp_lock
99 static struct zone_device *pkg_temp_thermal_get_dev(unsigned int cpu)
101 int id = topology_logical_die_id(cpu);
103 if (id >= 0 && id < max_id)
108 static int sys_get_curr_temp(struct thermal_zone_device *tzd, int *temp)
110 struct zone_device *zonedev = thermal_zone_device_priv(tzd);
113 val = intel_tcc_get_temp(zonedev->cpu, true);
118 pr_debug("sys_get_curr_temp %d\n", *temp);
123 sys_set_trip_temp(struct thermal_zone_device *tzd, int trip, int temp)
125 struct zone_device *zonedev = thermal_zone_device_priv(tzd);
126 u32 l, h, mask, shift, intr;
127 int tj_max, val, ret;
129 tj_max = intel_tcc_get_tjmax(zonedev->cpu);
134 val = (tj_max - temp)/1000;
136 if (trip >= MAX_NUMBER_OF_TRIPS || val < 0 || val > 0x7f)
139 ret = rdmsr_on_cpu(zonedev->cpu, MSR_IA32_PACKAGE_THERM_INTERRUPT,
145 mask = THERM_MASK_THRESHOLD1;
146 shift = THERM_SHIFT_THRESHOLD1;
147 intr = THERM_INT_THRESHOLD1_ENABLE;
149 mask = THERM_MASK_THRESHOLD0;
150 shift = THERM_SHIFT_THRESHOLD0;
151 intr = THERM_INT_THRESHOLD0_ENABLE;
155 * When users space sets a trip temperature == 0, which is indication
156 * that, it is no longer interested in receiving notifications.
165 return wrmsr_on_cpu(zonedev->cpu, MSR_IA32_PACKAGE_THERM_INTERRUPT,
169 /* Thermal zone callback registry */
170 static struct thermal_zone_device_ops tzone_ops = {
171 .get_temp = sys_get_curr_temp,
172 .set_trip_temp = sys_set_trip_temp,
175 static bool pkg_thermal_rate_control(void)
180 /* Enable threshold interrupt on local package/cpu */
181 static inline void enable_pkg_thres_interrupt(void)
186 rdmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
187 /* only enable/disable if it had valid threshold value */
188 thres_0 = (l & THERM_MASK_THRESHOLD0) >> THERM_SHIFT_THRESHOLD0;
189 thres_1 = (l & THERM_MASK_THRESHOLD1) >> THERM_SHIFT_THRESHOLD1;
191 l |= THERM_INT_THRESHOLD0_ENABLE;
193 l |= THERM_INT_THRESHOLD1_ENABLE;
194 wrmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
197 /* Disable threshold interrupt on local package/cpu */
198 static inline void disable_pkg_thres_interrupt(void)
202 rdmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
204 l &= ~(THERM_INT_THRESHOLD0_ENABLE | THERM_INT_THRESHOLD1_ENABLE);
205 wrmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT, l, h);
208 static void pkg_temp_thermal_threshold_work_fn(struct work_struct *work)
210 struct thermal_zone_device *tzone = NULL;
211 int cpu = smp_processor_id();
212 struct zone_device *zonedev;
214 mutex_lock(&thermal_zone_mutex);
215 raw_spin_lock_irq(&pkg_temp_lock);
218 zonedev = pkg_temp_thermal_get_dev(cpu);
220 raw_spin_unlock_irq(&pkg_temp_lock);
221 mutex_unlock(&thermal_zone_mutex);
224 zonedev->work_scheduled = false;
226 thermal_clear_package_intr_status(PACKAGE_LEVEL, THERM_LOG_THRESHOLD0 | THERM_LOG_THRESHOLD1);
227 tzone = zonedev->tzone;
229 enable_pkg_thres_interrupt();
230 raw_spin_unlock_irq(&pkg_temp_lock);
233 * If tzone is not NULL, then thermal_zone_mutex will prevent the
234 * concurrent removal in the cpu offline callback.
237 thermal_zone_device_update(tzone, THERMAL_EVENT_UNSPECIFIED);
239 mutex_unlock(&thermal_zone_mutex);
242 static void pkg_thermal_schedule_work(int cpu, struct delayed_work *work)
244 unsigned long ms = msecs_to_jiffies(notify_delay_ms);
246 schedule_delayed_work_on(cpu, work, ms);
249 static int pkg_thermal_notify(u64 msr_val)
251 int cpu = smp_processor_id();
252 struct zone_device *zonedev;
255 raw_spin_lock_irqsave(&pkg_temp_lock, flags);
258 disable_pkg_thres_interrupt();
260 /* Work is per package, so scheduling it once is enough. */
261 zonedev = pkg_temp_thermal_get_dev(cpu);
262 if (zonedev && !zonedev->work_scheduled) {
263 zonedev->work_scheduled = true;
264 pkg_thermal_schedule_work(zonedev->cpu, &zonedev->work);
267 raw_spin_unlock_irqrestore(&pkg_temp_lock, flags);
271 static struct thermal_trip *pkg_temp_thermal_trips_init(int cpu, int tj_max, int num_trips)
273 struct thermal_trip *trips;
274 unsigned long thres_reg_value;
275 u32 mask, shift, eax, edx;
278 trips = kzalloc(sizeof(*trips) * num_trips, GFP_KERNEL);
280 return ERR_PTR(-ENOMEM);
282 for (i = 0; i < num_trips; i++) {
285 mask = THERM_MASK_THRESHOLD1;
286 shift = THERM_SHIFT_THRESHOLD1;
288 mask = THERM_MASK_THRESHOLD0;
289 shift = THERM_SHIFT_THRESHOLD0;
292 ret = rdmsr_on_cpu(cpu, MSR_IA32_PACKAGE_THERM_INTERRUPT,
299 thres_reg_value = (eax & mask) >> shift;
301 trips[i].temperature = thres_reg_value ?
302 tj_max - thres_reg_value * 1000 : THERMAL_TEMP_INVALID;
304 trips[i].type = THERMAL_TRIP_PASSIVE;
306 pr_debug("%s: cpu=%d, trip=%d, temp=%d\n",
307 __func__, cpu, i, trips[i].temperature);
313 static int pkg_temp_thermal_device_add(unsigned int cpu)
315 int id = topology_logical_die_id(cpu);
316 u32 eax, ebx, ecx, edx;
317 struct zone_device *zonedev;
318 int thres_count, err;
324 cpuid(6, &eax, &ebx, &ecx, &edx);
325 thres_count = ebx & 0x07;
329 thres_count = clamp_val(thres_count, 0, MAX_NUMBER_OF_TRIPS);
331 tj_max = intel_tcc_get_tjmax(cpu);
335 zonedev = kzalloc(sizeof(*zonedev), GFP_KERNEL);
339 zonedev->trips = pkg_temp_thermal_trips_init(cpu, tj_max, thres_count);
340 if (IS_ERR(zonedev->trips)) {
341 err = PTR_ERR(zonedev->trips);
342 goto out_kfree_zonedev;
345 INIT_DELAYED_WORK(&zonedev->work, pkg_temp_thermal_threshold_work_fn);
347 zonedev->tzone = thermal_zone_device_register_with_trips("x86_pkg_temp",
348 zonedev->trips, thres_count,
349 (thres_count == MAX_NUMBER_OF_TRIPS) ? 0x03 : 0x01,
350 zonedev, &tzone_ops, &pkg_temp_tz_params, 0, 0);
351 if (IS_ERR(zonedev->tzone)) {
352 err = PTR_ERR(zonedev->tzone);
353 goto out_kfree_trips;
355 err = thermal_zone_device_enable(zonedev->tzone);
357 goto out_unregister_tz;
359 /* Store MSR value for package thermal interrupt, to restore at exit */
360 rdmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT, zonedev->msr_pkg_therm_low,
361 zonedev->msr_pkg_therm_high);
363 cpumask_set_cpu(cpu, &zonedev->cpumask);
364 raw_spin_lock_irq(&pkg_temp_lock);
366 raw_spin_unlock_irq(&pkg_temp_lock);
371 thermal_zone_device_unregister(zonedev->tzone);
373 kfree(zonedev->trips);
379 static int pkg_thermal_cpu_offline(unsigned int cpu)
381 struct zone_device *zonedev = pkg_temp_thermal_get_dev(cpu);
382 bool lastcpu, was_target;
388 target = cpumask_any_but(&zonedev->cpumask, cpu);
389 cpumask_clear_cpu(cpu, &zonedev->cpumask);
390 lastcpu = target >= nr_cpu_ids;
392 * Remove the sysfs files, if this is the last cpu in the package
393 * before doing further cleanups.
396 struct thermal_zone_device *tzone = zonedev->tzone;
399 * We must protect against a work function calling
400 * thermal_zone_update, after/while unregister. We null out
401 * the pointer under the zone mutex, so the worker function
404 mutex_lock(&thermal_zone_mutex);
405 zonedev->tzone = NULL;
406 mutex_unlock(&thermal_zone_mutex);
408 thermal_zone_device_unregister(tzone);
411 /* Protect against work and interrupts */
412 raw_spin_lock_irq(&pkg_temp_lock);
415 * Check whether this cpu was the current target and store the new
416 * one. When we drop the lock, then the interrupt notify function
417 * will see the new target.
419 was_target = zonedev->cpu == cpu;
420 zonedev->cpu = target;
423 * If this is the last CPU in the package remove the package
424 * reference from the array and restore the interrupt MSR. When we
425 * drop the lock neither the interrupt notify function nor the
426 * worker will see the package anymore.
429 zones[topology_logical_die_id(cpu)] = NULL;
430 /* After this point nothing touches the MSR anymore. */
431 wrmsr(MSR_IA32_PACKAGE_THERM_INTERRUPT,
432 zonedev->msr_pkg_therm_low, zonedev->msr_pkg_therm_high);
436 * Check whether there is work scheduled and whether the work is
437 * targeted at the outgoing CPU.
439 if (zonedev->work_scheduled && was_target) {
441 * To cancel the work we need to drop the lock, otherwise
442 * we might deadlock if the work needs to be flushed.
444 raw_spin_unlock_irq(&pkg_temp_lock);
445 cancel_delayed_work_sync(&zonedev->work);
446 raw_spin_lock_irq(&pkg_temp_lock);
448 * If this is not the last cpu in the package and the work
449 * did not run after we dropped the lock above, then we
450 * need to reschedule the work, otherwise the interrupt
451 * stays disabled forever.
453 if (!lastcpu && zonedev->work_scheduled)
454 pkg_thermal_schedule_work(target, &zonedev->work);
457 raw_spin_unlock_irq(&pkg_temp_lock);
459 /* Final cleanup if this is the last cpu */
461 kfree(zonedev->trips);
467 static int pkg_thermal_cpu_online(unsigned int cpu)
469 struct zone_device *zonedev = pkg_temp_thermal_get_dev(cpu);
470 struct cpuinfo_x86 *c = &cpu_data(cpu);
473 if (!cpu_has(c, X86_FEATURE_DTHERM) || !cpu_has(c, X86_FEATURE_PTS))
476 /* If the package exists, nothing to do */
478 cpumask_set_cpu(cpu, &zonedev->cpumask);
481 return pkg_temp_thermal_device_add(cpu);
484 static const struct x86_cpu_id __initconst pkg_temp_thermal_ids[] = {
485 X86_MATCH_VENDOR_FEATURE(INTEL, X86_FEATURE_PTS, NULL),
488 MODULE_DEVICE_TABLE(x86cpu, pkg_temp_thermal_ids);
490 static int __init pkg_temp_thermal_init(void)
494 if (!x86_match_cpu(pkg_temp_thermal_ids))
497 max_id = topology_max_packages() * topology_max_die_per_package();
498 zones = kcalloc(max_id, sizeof(struct zone_device *),
503 ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN, "thermal/x86_pkg:online",
504 pkg_thermal_cpu_online, pkg_thermal_cpu_offline);
508 /* Store the state for module exit */
509 pkg_thermal_hp_state = ret;
511 platform_thermal_package_notify = pkg_thermal_notify;
512 platform_thermal_package_rate_control = pkg_thermal_rate_control;
514 /* Don't care if it fails */
515 pkg_temp_debugfs_init();
522 module_init(pkg_temp_thermal_init)
524 static void __exit pkg_temp_thermal_exit(void)
526 platform_thermal_package_notify = NULL;
527 platform_thermal_package_rate_control = NULL;
529 cpuhp_remove_state(pkg_thermal_hp_state);
530 debugfs_remove_recursive(debugfs);
533 module_exit(pkg_temp_thermal_exit)
535 MODULE_IMPORT_NS(INTEL_TCC);
536 MODULE_DESCRIPTION("X86 PKG TEMP Thermal Driver");
538 MODULE_LICENSE("GPL v2");