2 * processor_throttling.c - Throttling submodule of the ACPI processor driver
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
6 * Copyright (C) 2004 Dominik Brodowski <linux@brodo.de>
7 * Copyright (C) 2004 Anil S Keshavamurthy <anil.s.keshavamurthy@intel.com>
8 * - Added processor hotplug support
10 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or (at
15 * your option) any later version.
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
22 * You should have received a copy of the GNU General Public License along
23 * with this program; if not, write to the Free Software Foundation, Inc.,
24 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
26 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
29 #include <linux/kernel.h>
30 #include <linux/module.h>
31 #include <linux/init.h>
32 #include <linux/cpufreq.h>
33 #include <linux/proc_fs.h>
34 #include <linux/seq_file.h>
37 #include <asm/uaccess.h>
39 #include <acpi/acpi_bus.h>
40 #include <acpi/processor.h>
42 #define ACPI_PROCESSOR_COMPONENT 0x01000000
43 #define ACPI_PROCESSOR_CLASS "processor"
44 #define _COMPONENT ACPI_PROCESSOR_COMPONENT
45 ACPI_MODULE_NAME("processor_throttling");
47 static int acpi_processor_get_throttling(struct acpi_processor *pr);
48 int acpi_processor_set_throttling(struct acpi_processor *pr, int state);
51 * _TPC - Throttling Present Capabilities
53 static int acpi_processor_get_platform_limit(struct acpi_processor *pr)
55 acpi_status status = 0;
56 unsigned long tpc = 0;
60 status = acpi_evaluate_integer(pr->handle, "_TPC", NULL, &tpc);
61 if (ACPI_FAILURE(status)) {
62 if (status != AE_NOT_FOUND) {
63 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _TPC"));
67 pr->throttling_platform_limit = (int)tpc;
71 int acpi_processor_tstate_has_changed(struct acpi_processor *pr)
76 struct acpi_processor_limit *limit;
79 result = acpi_processor_get_platform_limit(pr);
81 /* Throttling Limit is unsupported */
85 throttling_limit = pr->throttling_platform_limit;
86 if (throttling_limit >= pr->throttling.state_count) {
87 /* Uncorrect Throttling Limit */
91 current_state = pr->throttling.state;
92 if (current_state > throttling_limit) {
94 * The current state can meet the requirement of
95 * _TPC limit. But it is reasonable that OSPM changes
96 * t-states from high to low for better performance.
97 * Of course the limit condition of thermal
98 * and user should be considered.
101 target_state = throttling_limit;
102 if (limit->thermal.tx > target_state)
103 target_state = limit->thermal.tx;
104 if (limit->user.tx > target_state)
105 target_state = limit->user.tx;
106 } else if (current_state == throttling_limit) {
108 * Unnecessary to change the throttling state
113 * If the current state is lower than the limit of _TPC, it
114 * will be forced to switch to the throttling state defined
115 * by throttling_platfor_limit.
116 * Because the previous state meets with the limit condition
117 * of thermal and user, it is unnecessary to check it again.
119 target_state = throttling_limit;
121 return acpi_processor_set_throttling(pr, target_state);
125 * _PTC - Processor Throttling Control (and status) register location
127 static int acpi_processor_get_throttling_control(struct acpi_processor *pr)
130 acpi_status status = 0;
131 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
132 union acpi_object *ptc = NULL;
133 union acpi_object obj = { 0 };
134 struct acpi_processor_throttling *throttling;
136 status = acpi_evaluate_object(pr->handle, "_PTC", NULL, &buffer);
137 if (ACPI_FAILURE(status)) {
138 if (status != AE_NOT_FOUND) {
139 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PTC"));
144 ptc = (union acpi_object *)buffer.pointer;
145 if (!ptc || (ptc->type != ACPI_TYPE_PACKAGE)
146 || (ptc->package.count != 2)) {
147 printk(KERN_ERR PREFIX "Invalid _PTC data\n");
156 obj = ptc->package.elements[0];
158 if ((obj.type != ACPI_TYPE_BUFFER)
159 || (obj.buffer.length < sizeof(struct acpi_ptc_register))
160 || (obj.buffer.pointer == NULL)) {
161 printk(KERN_ERR PREFIX
162 "Invalid _PTC data (control_register)\n");
166 memcpy(&pr->throttling.control_register, obj.buffer.pointer,
167 sizeof(struct acpi_ptc_register));
173 obj = ptc->package.elements[1];
175 if ((obj.type != ACPI_TYPE_BUFFER)
176 || (obj.buffer.length < sizeof(struct acpi_ptc_register))
177 || (obj.buffer.pointer == NULL)) {
178 printk(KERN_ERR PREFIX "Invalid _PTC data (status_register)\n");
183 memcpy(&pr->throttling.status_register, obj.buffer.pointer,
184 sizeof(struct acpi_ptc_register));
186 throttling = &pr->throttling;
188 if ((throttling->control_register.bit_width +
189 throttling->control_register.bit_offset) > 32) {
190 printk(KERN_ERR PREFIX "Invalid _PTC control register\n");
195 if ((throttling->status_register.bit_width +
196 throttling->status_register.bit_offset) > 32) {
197 printk(KERN_ERR PREFIX "Invalid _PTC status register\n");
203 kfree(buffer.pointer);
209 * _TSS - Throttling Supported States
211 static int acpi_processor_get_throttling_states(struct acpi_processor *pr)
214 acpi_status status = AE_OK;
215 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
216 struct acpi_buffer format = { sizeof("NNNNN"), "NNNNN" };
217 struct acpi_buffer state = { 0, NULL };
218 union acpi_object *tss = NULL;
221 status = acpi_evaluate_object(pr->handle, "_TSS", NULL, &buffer);
222 if (ACPI_FAILURE(status)) {
223 if (status != AE_NOT_FOUND) {
224 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _TSS"));
229 tss = buffer.pointer;
230 if (!tss || (tss->type != ACPI_TYPE_PACKAGE)) {
231 printk(KERN_ERR PREFIX "Invalid _TSS data\n");
236 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found %d throttling states\n",
237 tss->package.count));
239 pr->throttling.state_count = tss->package.count;
240 pr->throttling.states_tss =
241 kmalloc(sizeof(struct acpi_processor_tx_tss) * tss->package.count,
243 if (!pr->throttling.states_tss) {
248 for (i = 0; i < pr->throttling.state_count; i++) {
250 struct acpi_processor_tx_tss *tx =
251 (struct acpi_processor_tx_tss *)&(pr->throttling.
254 state.length = sizeof(struct acpi_processor_tx_tss);
257 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Extracting state %d\n", i));
259 status = acpi_extract_package(&(tss->package.elements[i]),
261 if (ACPI_FAILURE(status)) {
262 ACPI_EXCEPTION((AE_INFO, status, "Invalid _TSS data"));
264 kfree(pr->throttling.states_tss);
268 if (!tx->freqpercentage) {
269 printk(KERN_ERR PREFIX
270 "Invalid _TSS data: freq is zero\n");
272 kfree(pr->throttling.states_tss);
278 kfree(buffer.pointer);
284 * _TSD - T-State Dependencies
286 static int acpi_processor_get_tsd(struct acpi_processor *pr)
289 acpi_status status = AE_OK;
290 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
291 struct acpi_buffer format = { sizeof("NNNNN"), "NNNNN" };
292 struct acpi_buffer state = { 0, NULL };
293 union acpi_object *tsd = NULL;
294 struct acpi_tsd_package *pdomain;
296 status = acpi_evaluate_object(pr->handle, "_TSD", NULL, &buffer);
297 if (ACPI_FAILURE(status)) {
298 if (status != AE_NOT_FOUND) {
299 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _TSD"));
304 tsd = buffer.pointer;
305 if (!tsd || (tsd->type != ACPI_TYPE_PACKAGE)) {
306 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Invalid _TSD data\n"));
311 if (tsd->package.count != 1) {
312 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Invalid _TSD data\n"));
317 pdomain = &(pr->throttling.domain_info);
319 state.length = sizeof(struct acpi_tsd_package);
320 state.pointer = pdomain;
322 status = acpi_extract_package(&(tsd->package.elements[0]),
324 if (ACPI_FAILURE(status)) {
325 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Invalid _TSD data\n"));
330 if (pdomain->num_entries != ACPI_TSD_REV0_ENTRIES) {
331 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Unknown _TSD:num_entries\n"));
336 if (pdomain->revision != ACPI_TSD_REV0_REVISION) {
337 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Unknown _TSD:revision\n"));
343 kfree(buffer.pointer);
347 /* --------------------------------------------------------------------------
349 -------------------------------------------------------------------------- */
350 static int acpi_processor_get_throttling_fadt(struct acpi_processor *pr)
360 if (!pr->flags.throttling)
363 pr->throttling.state = 0;
365 duty_mask = pr->throttling.state_count - 1;
367 duty_mask <<= pr->throttling.duty_offset;
371 value = inl(pr->throttling.address);
374 * Compute the current throttling state when throttling is enabled
378 duty_value = value & duty_mask;
379 duty_value >>= pr->throttling.duty_offset;
382 state = pr->throttling.state_count - duty_value;
385 pr->throttling.state = state;
389 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
390 "Throttling state is T%d (%d%% throttling applied)\n",
391 state, pr->throttling.states[state].performance));
396 static int acpi_read_throttling_status(struct acpi_processor *pr,
399 u32 bit_width, bit_offset;
402 struct acpi_processor_throttling *throttling;
405 throttling = &pr->throttling;
406 switch (throttling->status_register.space_id) {
407 case ACPI_ADR_SPACE_SYSTEM_IO:
409 bit_width = throttling->status_register.bit_width;
410 bit_offset = throttling->status_register.bit_offset;
412 acpi_os_read_port((acpi_io_address) throttling->status_register.
413 address, (u32 *) &ptc_value,
414 (u32) (bit_width + bit_offset));
415 ptc_mask = (1 << bit_width) - 1;
416 *value = (acpi_integer) ((ptc_value >> bit_offset) & ptc_mask);
419 case ACPI_ADR_SPACE_FIXED_HARDWARE:
420 printk(KERN_ERR PREFIX
421 "HARDWARE addr space,NOT supported yet\n");
424 printk(KERN_ERR PREFIX "Unknown addr space %d\n",
425 (u32) (throttling->status_register.space_id));
430 static int acpi_write_throttling_state(struct acpi_processor *pr,
433 u32 bit_width, bit_offset;
436 struct acpi_processor_throttling *throttling;
439 throttling = &pr->throttling;
440 switch (throttling->control_register.space_id) {
441 case ACPI_ADR_SPACE_SYSTEM_IO:
442 bit_width = throttling->control_register.bit_width;
443 bit_offset = throttling->control_register.bit_offset;
444 ptc_mask = (1 << bit_width) - 1;
445 ptc_value = value & ptc_mask;
447 acpi_os_write_port((acpi_io_address) throttling->
448 control_register.address,
449 (u32) (ptc_value << bit_offset),
450 (u32) (bit_width + bit_offset));
453 case ACPI_ADR_SPACE_FIXED_HARDWARE:
454 printk(KERN_ERR PREFIX
455 "HARDWARE addr space,NOT supported yet\n");
458 printk(KERN_ERR PREFIX "Unknown addr space %d\n",
459 (u32) (throttling->control_register.space_id));
464 static int acpi_get_throttling_state(struct acpi_processor *pr,
469 for (i = 0; i < pr->throttling.state_count; i++) {
470 struct acpi_processor_tx_tss *tx =
471 (struct acpi_processor_tx_tss *)&(pr->throttling.
473 if (tx->control == value)
476 if (i > pr->throttling.state_count)
481 static int acpi_get_throttling_value(struct acpi_processor *pr,
482 int state, acpi_integer *value)
486 if (state >= 0 && state <= pr->throttling.state_count) {
487 struct acpi_processor_tx_tss *tx =
488 (struct acpi_processor_tx_tss *)&(pr->throttling.
490 *value = tx->control;
496 static int acpi_processor_get_throttling_ptc(struct acpi_processor *pr)
505 if (!pr->flags.throttling)
508 pr->throttling.state = 0;
511 ret = acpi_read_throttling_status(pr, &value);
513 state = acpi_get_throttling_state(pr, value);
514 pr->throttling.state = state;
521 static int acpi_processor_get_throttling(struct acpi_processor *pr)
523 return pr->throttling.acpi_processor_get_throttling(pr);
526 static int acpi_processor_get_fadt_info(struct acpi_processor *pr)
530 if (!pr->throttling.address) {
531 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "No throttling register\n"));
533 } else if (!pr->throttling.duty_width) {
534 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "No throttling states\n"));
537 /* TBD: Support duty_cycle values that span bit 4. */
538 else if ((pr->throttling.duty_offset + pr->throttling.duty_width) > 4) {
539 printk(KERN_WARNING PREFIX "duty_cycle spans bit 4\n");
543 pr->throttling.state_count = 1 << acpi_gbl_FADT.duty_width;
546 * Compute state values. Note that throttling displays a linear power
547 * performance relationship (at 50% performance the CPU will consume
548 * 50% power). Values are in 1/10th of a percent to preserve accuracy.
551 step = (1000 / pr->throttling.state_count);
553 for (i = 0; i < pr->throttling.state_count; i++) {
554 pr->throttling.states[i].performance = 1000 - step * i;
555 pr->throttling.states[i].power = 1000 - step * i;
560 static int acpi_processor_set_throttling_fadt(struct acpi_processor *pr,
570 if ((state < 0) || (state > (pr->throttling.state_count - 1)))
573 if (!pr->flags.throttling)
576 if (state == pr->throttling.state)
579 if (state < pr->throttling_platform_limit)
582 * Calculate the duty_value and duty_mask.
585 duty_value = pr->throttling.state_count - state;
587 duty_value <<= pr->throttling.duty_offset;
589 /* Used to clear all duty_value bits */
590 duty_mask = pr->throttling.state_count - 1;
592 duty_mask <<= acpi_gbl_FADT.duty_offset;
593 duty_mask = ~duty_mask;
599 * Disable throttling by writing a 0 to bit 4. Note that we must
600 * turn it off before you can change the duty_value.
602 value = inl(pr->throttling.address);
605 outl(value, pr->throttling.address);
609 * Write the new duty_value and then enable throttling. Note
610 * that a state value of 0 leaves throttling disabled.
615 outl(value, pr->throttling.address);
618 outl(value, pr->throttling.address);
621 pr->throttling.state = state;
625 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
626 "Throttling state set to T%d (%d%%)\n", state,
627 (pr->throttling.states[state].performance ? pr->
628 throttling.states[state].performance / 10 : 0)));
633 static int acpi_processor_set_throttling_ptc(struct acpi_processor *pr,
642 if ((state < 0) || (state > (pr->throttling.state_count - 1)))
645 if (!pr->flags.throttling)
648 if (state == pr->throttling.state)
651 if (state < pr->throttling_platform_limit)
656 ret = acpi_get_throttling_value(pr, state, &value);
658 acpi_write_throttling_state(pr, value);
659 pr->throttling.state = state;
666 int acpi_processor_set_throttling(struct acpi_processor *pr, int state)
668 return pr->throttling.acpi_processor_set_throttling(pr, state);
671 int acpi_processor_get_throttling_info(struct acpi_processor *pr)
675 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
676 "pblk_address[0x%08x] duty_offset[%d] duty_width[%d]\n",
677 pr->throttling.address,
678 pr->throttling.duty_offset,
679 pr->throttling.duty_width));
685 * Evaluate _PTC, _TSS and _TPC
686 * They must all be present or none of them can be used.
688 if (acpi_processor_get_throttling_control(pr) ||
689 acpi_processor_get_throttling_states(pr) ||
690 acpi_processor_get_platform_limit(pr))
692 if (acpi_processor_get_fadt_info(pr))
694 pr->throttling.acpi_processor_get_throttling =
695 &acpi_processor_get_throttling_fadt;
696 pr->throttling.acpi_processor_set_throttling =
697 &acpi_processor_set_throttling_fadt;
699 pr->throttling.acpi_processor_get_throttling =
700 &acpi_processor_get_throttling_ptc;
701 pr->throttling.acpi_processor_set_throttling =
702 &acpi_processor_set_throttling_ptc;
705 acpi_processor_get_tsd(pr);
708 * PIIX4 Errata: We don't support throttling on the original PIIX4.
709 * This shouldn't be an issue as few (if any) mobile systems ever
712 if (errata.piix4.throttle) {
713 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
714 "Throttling not supported on PIIX4 A- or B-step\n"));
718 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found %d throttling states\n",
719 pr->throttling.state_count));
721 pr->flags.throttling = 1;
724 * Disable throttling (if enabled). We'll let subsequent policy (e.g.
725 * thermal) decide to lower performance if it so chooses, but for now
726 * we'll crank up the speed.
729 result = acpi_processor_get_throttling(pr);
733 if (pr->throttling.state) {
734 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
735 "Disabling throttling (was T%d)\n",
736 pr->throttling.state));
737 result = acpi_processor_set_throttling(pr, 0);
744 pr->flags.throttling = 0;
751 static int acpi_processor_throttling_seq_show(struct seq_file *seq,
754 struct acpi_processor *pr = seq->private;
761 if (!(pr->throttling.state_count > 0)) {
762 seq_puts(seq, "<not supported>\n");
766 result = acpi_processor_get_throttling(pr);
770 "Could not determine current throttling state.\n");
774 seq_printf(seq, "state count: %d\n"
775 "active state: T%d\n"
776 "state available: T%d to T%d\n",
777 pr->throttling.state_count, pr->throttling.state,
778 pr->throttling_platform_limit,
779 pr->throttling.state_count - 1);
781 seq_puts(seq, "states:\n");
782 if (pr->throttling.acpi_processor_get_throttling ==
783 acpi_processor_get_throttling_fadt) {
784 for (i = 0; i < pr->throttling.state_count; i++)
785 seq_printf(seq, " %cT%d: %02d%%\n",
786 (i == pr->throttling.state ? '*' : ' '), i,
787 (pr->throttling.states[i].performance ? pr->
788 throttling.states[i].performance / 10 : 0));
790 for (i = 0; i < pr->throttling.state_count; i++)
791 seq_printf(seq, " %cT%d: %02d%%\n",
792 (i == pr->throttling.state ? '*' : ' '), i,
793 (int)pr->throttling.states_tss[i].
801 static int acpi_processor_throttling_open_fs(struct inode *inode,
804 return single_open(file, acpi_processor_throttling_seq_show,
808 static ssize_t acpi_processor_write_throttling(struct file *file,
809 const char __user * buffer,
810 size_t count, loff_t * data)
813 struct seq_file *m = file->private_data;
814 struct acpi_processor *pr = m->private;
815 char state_string[12] = { '\0' };
817 if (!pr || (count > sizeof(state_string) - 1))
820 if (copy_from_user(state_string, buffer, count))
823 state_string[count] = '\0';
825 result = acpi_processor_set_throttling(pr,
826 simple_strtoul(state_string,
834 struct file_operations acpi_processor_throttling_fops = {
835 .open = acpi_processor_throttling_open_fs,
837 .write = acpi_processor_write_throttling,
839 .release = single_release,