2 * acpi_pad.c ACPI Processor Aggregator Driver
4 * Copyright (c) 2009, Intel Corporation.
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
17 #include <linux/kernel.h>
18 #include <linux/cpumask.h>
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/types.h>
22 #include <linux/kthread.h>
23 #include <uapi/linux/sched/types.h>
24 #include <linux/freezer.h>
25 #include <linux/cpu.h>
26 #include <linux/tick.h>
27 #include <linux/slab.h>
28 #include <linux/acpi.h>
29 #include <asm/mwait.h>
32 #define ACPI_PROCESSOR_AGGREGATOR_CLASS "acpi_pad"
33 #define ACPI_PROCESSOR_AGGREGATOR_DEVICE_NAME "Processor Aggregator"
34 #define ACPI_PROCESSOR_AGGREGATOR_NOTIFY 0x80
35 static DEFINE_MUTEX(isolated_cpus_lock
);
36 static DEFINE_MUTEX(round_robin_lock
);
38 static unsigned long power_saving_mwait_eax
;
40 static unsigned char tsc_detected_unstable
;
41 static unsigned char tsc_marked_unstable
;
43 static void power_saving_mwait_init(void)
45 unsigned int eax
, ebx
, ecx
, edx
;
46 unsigned int highest_cstate
= 0;
47 unsigned int highest_subcstate
= 0;
50 if (!boot_cpu_has(X86_FEATURE_MWAIT
))
52 if (boot_cpu_data
.cpuid_level
< CPUID_MWAIT_LEAF
)
55 cpuid(CPUID_MWAIT_LEAF
, &eax
, &ebx
, &ecx
, &edx
);
57 if (!(ecx
& CPUID5_ECX_EXTENSIONS_SUPPORTED
) ||
58 !(ecx
& CPUID5_ECX_INTERRUPT_BREAK
))
61 edx
>>= MWAIT_SUBSTATE_SIZE
;
62 for (i
= 0; i
< 7 && edx
; i
++, edx
>>= MWAIT_SUBSTATE_SIZE
) {
63 if (edx
& MWAIT_SUBSTATE_MASK
) {
65 highest_subcstate
= edx
& MWAIT_SUBSTATE_MASK
;
68 power_saving_mwait_eax
= (highest_cstate
<< MWAIT_SUBSTATE_SIZE
) |
69 (highest_subcstate
- 1);
71 #if defined(CONFIG_X86)
72 switch (boot_cpu_data
.x86_vendor
) {
74 case X86_VENDOR_INTEL
:
76 * AMD Fam10h TSC will tick in all
77 * C/P/S0/S1 states when this bit is set.
79 if (!boot_cpu_has(X86_FEATURE_NONSTOP_TSC
))
80 tsc_detected_unstable
= 1;
83 /* TSC could halt in idle */
84 tsc_detected_unstable
= 1;
89 static unsigned long cpu_weight
[NR_CPUS
];
90 static int tsk_in_cpu
[NR_CPUS
] = {[0 ... NR_CPUS
-1] = -1};
91 static DECLARE_BITMAP(pad_busy_cpus_bits
, NR_CPUS
);
92 static void round_robin_cpu(unsigned int tsk_index
)
94 struct cpumask
*pad_busy_cpus
= to_cpumask(pad_busy_cpus_bits
);
97 unsigned long min_weight
= -1;
98 unsigned long uninitialized_var(preferred_cpu
);
100 if (!alloc_cpumask_var(&tmp
, GFP_KERNEL
))
103 mutex_lock(&round_robin_lock
);
105 for_each_cpu(cpu
, pad_busy_cpus
)
106 cpumask_or(tmp
, tmp
, topology_sibling_cpumask(cpu
));
107 cpumask_andnot(tmp
, cpu_online_mask
, tmp
);
108 /* avoid HT sibilings if possible */
109 if (cpumask_empty(tmp
))
110 cpumask_andnot(tmp
, cpu_online_mask
, pad_busy_cpus
);
111 if (cpumask_empty(tmp
)) {
112 mutex_unlock(&round_robin_lock
);
113 free_cpumask_var(tmp
);
116 for_each_cpu(cpu
, tmp
) {
117 if (cpu_weight
[cpu
] < min_weight
) {
118 min_weight
= cpu_weight
[cpu
];
123 if (tsk_in_cpu
[tsk_index
] != -1)
124 cpumask_clear_cpu(tsk_in_cpu
[tsk_index
], pad_busy_cpus
);
125 tsk_in_cpu
[tsk_index
] = preferred_cpu
;
126 cpumask_set_cpu(preferred_cpu
, pad_busy_cpus
);
127 cpu_weight
[preferred_cpu
]++;
128 mutex_unlock(&round_robin_lock
);
130 set_cpus_allowed_ptr(current
, cpumask_of(preferred_cpu
));
132 free_cpumask_var(tmp
);
135 static void exit_round_robin(unsigned int tsk_index
)
137 struct cpumask
*pad_busy_cpus
= to_cpumask(pad_busy_cpus_bits
);
138 cpumask_clear_cpu(tsk_in_cpu
[tsk_index
], pad_busy_cpus
);
139 tsk_in_cpu
[tsk_index
] = -1;
142 static unsigned int idle_pct
= 5; /* percentage */
143 static unsigned int round_robin_time
= 1; /* second */
144 static int power_saving_thread(void *data
)
146 struct sched_param param
= {.sched_priority
= 1};
148 unsigned int tsk_index
= (unsigned long)data
;
149 u64 last_jiffies
= 0;
151 sched_setscheduler(current
, SCHED_RR
, ¶m
);
153 while (!kthread_should_stop()) {
154 unsigned long expire_time
;
156 /* round robin to cpus */
157 expire_time
= last_jiffies
+ round_robin_time
* HZ
;
158 if (time_before(expire_time
, jiffies
)) {
159 last_jiffies
= jiffies
;
160 round_robin_cpu(tsk_index
);
165 expire_time
= jiffies
+ HZ
* (100 - idle_pct
) / 100;
167 while (!need_resched()) {
168 if (tsc_detected_unstable
&& !tsc_marked_unstable
) {
169 /* TSC could halt in idle, so notify users */
170 mark_tsc_unstable("TSC halts in idle");
171 tsc_marked_unstable
= 1;
174 tick_broadcast_enable();
175 tick_broadcast_enter();
176 stop_critical_timings();
178 mwait_idle_with_hints(power_saving_mwait_eax
, 1);
180 start_critical_timings();
181 tick_broadcast_exit();
184 if (time_before(expire_time
, jiffies
)) {
191 * current sched_rt has threshold for rt task running time.
192 * When a rt task uses 95% CPU time, the rt thread will be
193 * scheduled out for 5% CPU time to not starve other tasks. But
194 * the mechanism only works when all CPUs have RT task running,
195 * as if one CPU hasn't RT task, RT task from other CPUs will
196 * borrow CPU time from this CPU and cause RT task use > 95%
197 * CPU time. To make 'avoid starvation' work, takes a nap here.
199 if (unlikely(do_sleep
))
200 schedule_timeout_killable(HZ
* idle_pct
/ 100);
202 /* If an external event has set the need_resched flag, then
203 * we need to deal with it, or this loop will continue to
204 * spin without calling __mwait().
206 if (unlikely(need_resched()))
210 exit_round_robin(tsk_index
);
214 static struct task_struct
*ps_tsks
[NR_CPUS
];
215 static unsigned int ps_tsk_num
;
216 static int create_power_saving_task(void)
220 ps_tsks
[ps_tsk_num
] = kthread_run(power_saving_thread
,
221 (void *)(unsigned long)ps_tsk_num
,
222 "acpi_pad/%d", ps_tsk_num
);
224 if (IS_ERR(ps_tsks
[ps_tsk_num
])) {
225 rc
= PTR_ERR(ps_tsks
[ps_tsk_num
]);
226 ps_tsks
[ps_tsk_num
] = NULL
;
235 static void destroy_power_saving_task(void)
237 if (ps_tsk_num
> 0) {
239 kthread_stop(ps_tsks
[ps_tsk_num
]);
240 ps_tsks
[ps_tsk_num
] = NULL
;
244 static void set_power_saving_task_num(unsigned int num
)
246 if (num
> ps_tsk_num
) {
247 while (ps_tsk_num
< num
) {
248 if (create_power_saving_task())
251 } else if (num
< ps_tsk_num
) {
252 while (ps_tsk_num
> num
)
253 destroy_power_saving_task();
257 static void acpi_pad_idle_cpus(unsigned int num_cpus
)
261 num_cpus
= min_t(unsigned int, num_cpus
, num_online_cpus());
262 set_power_saving_task_num(num_cpus
);
267 static uint32_t acpi_pad_idle_cpus_num(void)
272 static ssize_t
acpi_pad_rrtime_store(struct device
*dev
,
273 struct device_attribute
*attr
, const char *buf
, size_t count
)
276 if (kstrtoul(buf
, 0, &num
))
278 if (num
< 1 || num
>= 100)
280 mutex_lock(&isolated_cpus_lock
);
281 round_robin_time
= num
;
282 mutex_unlock(&isolated_cpus_lock
);
286 static ssize_t
acpi_pad_rrtime_show(struct device
*dev
,
287 struct device_attribute
*attr
, char *buf
)
289 return scnprintf(buf
, PAGE_SIZE
, "%d\n", round_robin_time
);
291 static DEVICE_ATTR(rrtime
, S_IRUGO
|S_IWUSR
,
292 acpi_pad_rrtime_show
,
293 acpi_pad_rrtime_store
);
295 static ssize_t
acpi_pad_idlepct_store(struct device
*dev
,
296 struct device_attribute
*attr
, const char *buf
, size_t count
)
299 if (kstrtoul(buf
, 0, &num
))
301 if (num
< 1 || num
>= 100)
303 mutex_lock(&isolated_cpus_lock
);
305 mutex_unlock(&isolated_cpus_lock
);
309 static ssize_t
acpi_pad_idlepct_show(struct device
*dev
,
310 struct device_attribute
*attr
, char *buf
)
312 return scnprintf(buf
, PAGE_SIZE
, "%d\n", idle_pct
);
314 static DEVICE_ATTR(idlepct
, S_IRUGO
|S_IWUSR
,
315 acpi_pad_idlepct_show
,
316 acpi_pad_idlepct_store
);
318 static ssize_t
acpi_pad_idlecpus_store(struct device
*dev
,
319 struct device_attribute
*attr
, const char *buf
, size_t count
)
322 if (kstrtoul(buf
, 0, &num
))
324 mutex_lock(&isolated_cpus_lock
);
325 acpi_pad_idle_cpus(num
);
326 mutex_unlock(&isolated_cpus_lock
);
330 static ssize_t
acpi_pad_idlecpus_show(struct device
*dev
,
331 struct device_attribute
*attr
, char *buf
)
333 return cpumap_print_to_pagebuf(false, buf
,
334 to_cpumask(pad_busy_cpus_bits
));
337 static DEVICE_ATTR(idlecpus
, S_IRUGO
|S_IWUSR
,
338 acpi_pad_idlecpus_show
,
339 acpi_pad_idlecpus_store
);
341 static int acpi_pad_add_sysfs(struct acpi_device
*device
)
345 result
= device_create_file(&device
->dev
, &dev_attr_idlecpus
);
348 result
= device_create_file(&device
->dev
, &dev_attr_idlepct
);
350 device_remove_file(&device
->dev
, &dev_attr_idlecpus
);
353 result
= device_create_file(&device
->dev
, &dev_attr_rrtime
);
355 device_remove_file(&device
->dev
, &dev_attr_idlecpus
);
356 device_remove_file(&device
->dev
, &dev_attr_idlepct
);
362 static void acpi_pad_remove_sysfs(struct acpi_device
*device
)
364 device_remove_file(&device
->dev
, &dev_attr_idlecpus
);
365 device_remove_file(&device
->dev
, &dev_attr_idlepct
);
366 device_remove_file(&device
->dev
, &dev_attr_rrtime
);
370 * Query firmware how many CPUs should be idle
371 * return -1 on failure
373 static int acpi_pad_pur(acpi_handle handle
)
375 struct acpi_buffer buffer
= {ACPI_ALLOCATE_BUFFER
, NULL
};
376 union acpi_object
*package
;
379 if (ACPI_FAILURE(acpi_evaluate_object(handle
, "_PUR", NULL
, &buffer
)))
382 if (!buffer
.length
|| !buffer
.pointer
)
385 package
= buffer
.pointer
;
387 if (package
->type
== ACPI_TYPE_PACKAGE
&&
388 package
->package
.count
== 2 &&
389 package
->package
.elements
[0].integer
.value
== 1) /* rev 1 */
391 num
= package
->package
.elements
[1].integer
.value
;
393 kfree(buffer
.pointer
);
397 static void acpi_pad_handle_notify(acpi_handle handle
)
401 struct acpi_buffer param
= {
403 .pointer
= (void *)&idle_cpus
,
406 mutex_lock(&isolated_cpus_lock
);
407 num_cpus
= acpi_pad_pur(handle
);
409 mutex_unlock(&isolated_cpus_lock
);
412 acpi_pad_idle_cpus(num_cpus
);
413 idle_cpus
= acpi_pad_idle_cpus_num();
414 acpi_evaluate_ost(handle
, ACPI_PROCESSOR_AGGREGATOR_NOTIFY
, 0, ¶m
);
415 mutex_unlock(&isolated_cpus_lock
);
418 static void acpi_pad_notify(acpi_handle handle
, u32 event
,
421 struct acpi_device
*device
= data
;
424 case ACPI_PROCESSOR_AGGREGATOR_NOTIFY
:
425 acpi_pad_handle_notify(handle
);
426 acpi_bus_generate_netlink_event(device
->pnp
.device_class
,
427 dev_name(&device
->dev
), event
, 0);
430 pr_warn("Unsupported event [0x%x]\n", event
);
435 static int acpi_pad_add(struct acpi_device
*device
)
439 strcpy(acpi_device_name(device
), ACPI_PROCESSOR_AGGREGATOR_DEVICE_NAME
);
440 strcpy(acpi_device_class(device
), ACPI_PROCESSOR_AGGREGATOR_CLASS
);
442 if (acpi_pad_add_sysfs(device
))
445 status
= acpi_install_notify_handler(device
->handle
,
446 ACPI_DEVICE_NOTIFY
, acpi_pad_notify
, device
);
447 if (ACPI_FAILURE(status
)) {
448 acpi_pad_remove_sysfs(device
);
455 static int acpi_pad_remove(struct acpi_device
*device
)
457 mutex_lock(&isolated_cpus_lock
);
458 acpi_pad_idle_cpus(0);
459 mutex_unlock(&isolated_cpus_lock
);
461 acpi_remove_notify_handler(device
->handle
,
462 ACPI_DEVICE_NOTIFY
, acpi_pad_notify
);
463 acpi_pad_remove_sysfs(device
);
467 static const struct acpi_device_id pad_device_ids
[] = {
471 MODULE_DEVICE_TABLE(acpi
, pad_device_ids
);
473 static struct acpi_driver acpi_pad_driver
= {
474 .name
= "processor_aggregator",
475 .class = ACPI_PROCESSOR_AGGREGATOR_CLASS
,
476 .ids
= pad_device_ids
,
479 .remove
= acpi_pad_remove
,
483 static int __init
acpi_pad_init(void)
485 /* Xen ACPI PAD is used when running as Xen Dom0. */
486 if (xen_initial_domain())
489 power_saving_mwait_init();
490 if (power_saving_mwait_eax
== 0)
493 return acpi_bus_register_driver(&acpi_pad_driver
);
496 static void __exit
acpi_pad_exit(void)
498 acpi_bus_unregister_driver(&acpi_pad_driver
);
501 module_init(acpi_pad_init
);
502 module_exit(acpi_pad_exit
);
503 MODULE_AUTHOR("Shaohua Li<shaohua.li@intel.com>");
504 MODULE_DESCRIPTION("ACPI Processor Aggregator Driver");
505 MODULE_LICENSE("GPL");