2 * acpi_thermal.c - ACPI Thermal Zone Driver ($Revision: 41 $)
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or (at
12 * your option) any later version.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
25 * This driver fully implements the ACPI thermal policy as described in the
26 * ACPI 2.0 Specification.
28 * TBD: 1. Implement passive cooling hysteresis.
29 * 2. Enhance passive cooling (CPU) states/limit interface to support
30 * concepts of 'multiple limiters', upper/lower limits, etc.
34 #include <linux/kernel.h>
35 #include <linux/module.h>
36 #include <linux/init.h>
37 #include <linux/types.h>
38 #include <linux/proc_fs.h>
39 #include <linux/sched.h>
40 #include <linux/kmod.h>
41 #include <linux/seq_file.h>
42 #include <asm/uaccess.h>
44 #include <acpi/acpi_bus.h>
45 #include <acpi/acpi_drivers.h>
47 #define ACPI_THERMAL_COMPONENT 0x04000000
48 #define ACPI_THERMAL_CLASS "thermal_zone"
49 #define ACPI_THERMAL_DRIVER_NAME "ACPI Thermal Zone Driver"
50 #define ACPI_THERMAL_DEVICE_NAME "Thermal Zone"
51 #define ACPI_THERMAL_FILE_STATE "state"
52 #define ACPI_THERMAL_FILE_TEMPERATURE "temperature"
53 #define ACPI_THERMAL_FILE_TRIP_POINTS "trip_points"
54 #define ACPI_THERMAL_FILE_COOLING_MODE "cooling_mode"
55 #define ACPI_THERMAL_FILE_POLLING_FREQ "polling_frequency"
56 #define ACPI_THERMAL_NOTIFY_TEMPERATURE 0x80
57 #define ACPI_THERMAL_NOTIFY_THRESHOLDS 0x81
58 #define ACPI_THERMAL_NOTIFY_DEVICES 0x82
59 #define ACPI_THERMAL_NOTIFY_CRITICAL 0xF0
60 #define ACPI_THERMAL_NOTIFY_HOT 0xF1
61 #define ACPI_THERMAL_MODE_ACTIVE 0x00
62 #define ACPI_THERMAL_MODE_PASSIVE 0x01
63 #define ACPI_THERMAL_MODE_CRITICAL 0xff
64 #define ACPI_THERMAL_PATH_POWEROFF "/sbin/poweroff"
66 #define ACPI_THERMAL_MAX_ACTIVE 10
67 #define ACPI_THERMAL_MAX_LIMIT_STR_LEN 65
69 #define KELVIN_TO_CELSIUS(t) (long)(((long)t-2732>=0) ? ((long)t-2732+5)/10 : ((long)t-2732-5)/10)
70 #define CELSIUS_TO_KELVIN(t) ((t+273)*10)
72 #define _COMPONENT ACPI_THERMAL_COMPONENT
73 ACPI_MODULE_NAME("acpi_thermal")
75 MODULE_AUTHOR("Paul Diefenbaugh");
76 MODULE_DESCRIPTION(ACPI_THERMAL_DRIVER_NAME
);
77 MODULE_LICENSE("GPL");
80 module_param(tzp
, int, 0);
81 MODULE_PARM_DESC(tzp
, "Thermal zone polling frequency, in 1/10 seconds.\n");
83 static int acpi_thermal_add(struct acpi_device
*device
);
84 static int acpi_thermal_remove(struct acpi_device
*device
, int type
);
85 static int acpi_thermal_resume(struct acpi_device
*device
, int state
);
86 static int acpi_thermal_state_open_fs(struct inode
*inode
, struct file
*file
);
87 static int acpi_thermal_temp_open_fs(struct inode
*inode
, struct file
*file
);
88 static int acpi_thermal_trip_open_fs(struct inode
*inode
, struct file
*file
);
89 static ssize_t
acpi_thermal_write_trip_points(struct file
*,
90 const char __user
*, size_t,
92 static int acpi_thermal_cooling_open_fs(struct inode
*inode
, struct file
*file
);
93 static ssize_t
acpi_thermal_write_cooling_mode(struct file
*,
94 const char __user
*, size_t,
96 static int acpi_thermal_polling_open_fs(struct inode
*inode
, struct file
*file
);
97 static ssize_t
acpi_thermal_write_polling(struct file
*, const char __user
*,
100 static struct acpi_driver acpi_thermal_driver
= {
101 .name
= ACPI_THERMAL_DRIVER_NAME
,
102 .class = ACPI_THERMAL_CLASS
,
103 .ids
= ACPI_THERMAL_HID
,
105 .add
= acpi_thermal_add
,
106 .remove
= acpi_thermal_remove
,
107 .resume
= acpi_thermal_resume
,
111 struct acpi_thermal_state
{
120 struct acpi_thermal_state_flags
{
126 struct acpi_thermal_critical
{
127 struct acpi_thermal_state_flags flags
;
128 unsigned long temperature
;
131 struct acpi_thermal_hot
{
132 struct acpi_thermal_state_flags flags
;
133 unsigned long temperature
;
136 struct acpi_thermal_passive
{
137 struct acpi_thermal_state_flags flags
;
138 unsigned long temperature
;
142 struct acpi_handle_list devices
;
145 struct acpi_thermal_active
{
146 struct acpi_thermal_state_flags flags
;
147 unsigned long temperature
;
148 struct acpi_handle_list devices
;
151 struct acpi_thermal_trips
{
152 struct acpi_thermal_critical critical
;
153 struct acpi_thermal_hot hot
;
154 struct acpi_thermal_passive passive
;
155 struct acpi_thermal_active active
[ACPI_THERMAL_MAX_ACTIVE
];
158 struct acpi_thermal_flags
{
159 u8 cooling_mode
:1; /* _SCP */
160 u8 devices
:1; /* _TZD */
164 struct acpi_thermal
{
167 unsigned long temperature
;
168 unsigned long last_temperature
;
169 unsigned long polling_frequency
;
172 struct acpi_thermal_flags flags
;
173 struct acpi_thermal_state state
;
174 struct acpi_thermal_trips trips
;
175 struct acpi_handle_list devices
;
176 struct timer_list timer
;
179 static struct file_operations acpi_thermal_state_fops
= {
180 .open
= acpi_thermal_state_open_fs
,
183 .release
= single_release
,
186 static struct file_operations acpi_thermal_temp_fops
= {
187 .open
= acpi_thermal_temp_open_fs
,
190 .release
= single_release
,
193 static struct file_operations acpi_thermal_trip_fops
= {
194 .open
= acpi_thermal_trip_open_fs
,
196 .write
= acpi_thermal_write_trip_points
,
198 .release
= single_release
,
201 static struct file_operations acpi_thermal_cooling_fops
= {
202 .open
= acpi_thermal_cooling_open_fs
,
204 .write
= acpi_thermal_write_cooling_mode
,
206 .release
= single_release
,
209 static struct file_operations acpi_thermal_polling_fops
= {
210 .open
= acpi_thermal_polling_open_fs
,
212 .write
= acpi_thermal_write_polling
,
214 .release
= single_release
,
217 /* --------------------------------------------------------------------------
218 Thermal Zone Management
219 -------------------------------------------------------------------------- */
221 static int acpi_thermal_get_temperature(struct acpi_thermal
*tz
)
223 acpi_status status
= AE_OK
;
225 ACPI_FUNCTION_TRACE("acpi_thermal_get_temperature");
228 return_VALUE(-EINVAL
);
230 tz
->last_temperature
= tz
->temperature
;
233 acpi_evaluate_integer(tz
->handle
, "_TMP", NULL
, &tz
->temperature
);
234 if (ACPI_FAILURE(status
))
235 return_VALUE(-ENODEV
);
237 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Temperature is %lu dK\n",
243 static int acpi_thermal_get_polling_frequency(struct acpi_thermal
*tz
)
245 acpi_status status
= AE_OK
;
247 ACPI_FUNCTION_TRACE("acpi_thermal_get_polling_frequency");
250 return_VALUE(-EINVAL
);
253 acpi_evaluate_integer(tz
->handle
, "_TZP", NULL
,
254 &tz
->polling_frequency
);
255 if (ACPI_FAILURE(status
))
256 return_VALUE(-ENODEV
);
258 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Polling frequency is %lu dS\n",
259 tz
->polling_frequency
));
264 static int acpi_thermal_set_polling(struct acpi_thermal
*tz
, int seconds
)
266 ACPI_FUNCTION_TRACE("acpi_thermal_set_polling");
269 return_VALUE(-EINVAL
);
271 tz
->polling_frequency
= seconds
* 10; /* Convert value to deci-seconds */
273 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
274 "Polling frequency set to %lu seconds\n",
275 tz
->polling_frequency
));
280 static int acpi_thermal_set_cooling_mode(struct acpi_thermal
*tz
, int mode
)
282 acpi_status status
= AE_OK
;
283 union acpi_object arg0
= { ACPI_TYPE_INTEGER
};
284 struct acpi_object_list arg_list
= { 1, &arg0
};
285 acpi_handle handle
= NULL
;
287 ACPI_FUNCTION_TRACE("acpi_thermal_set_cooling_mode");
290 return_VALUE(-EINVAL
);
292 status
= acpi_get_handle(tz
->handle
, "_SCP", &handle
);
293 if (ACPI_FAILURE(status
)) {
294 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "_SCP not present\n"));
295 return_VALUE(-ENODEV
);
298 arg0
.integer
.value
= mode
;
300 status
= acpi_evaluate_object(handle
, NULL
, &arg_list
, NULL
);
301 if (ACPI_FAILURE(status
))
302 return_VALUE(-ENODEV
);
304 tz
->cooling_mode
= mode
;
306 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Cooling mode [%s]\n",
307 mode
? "passive" : "active"));
312 static int acpi_thermal_get_trip_points(struct acpi_thermal
*tz
)
314 acpi_status status
= AE_OK
;
317 ACPI_FUNCTION_TRACE("acpi_thermal_get_trip_points");
320 return_VALUE(-EINVAL
);
322 /* Critical Shutdown (required) */
324 status
= acpi_evaluate_integer(tz
->handle
, "_CRT", NULL
,
325 &tz
->trips
.critical
.temperature
);
326 if (ACPI_FAILURE(status
)) {
327 tz
->trips
.critical
.flags
.valid
= 0;
328 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "No critical threshold\n"));
329 return_VALUE(-ENODEV
);
331 tz
->trips
.critical
.flags
.valid
= 1;
332 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
333 "Found critical threshold [%lu]\n",
334 tz
->trips
.critical
.temperature
));
337 /* Critical Sleep (optional) */
340 acpi_evaluate_integer(tz
->handle
, "_HOT", NULL
,
341 &tz
->trips
.hot
.temperature
);
342 if (ACPI_FAILURE(status
)) {
343 tz
->trips
.hot
.flags
.valid
= 0;
344 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "No hot threshold\n"));
346 tz
->trips
.hot
.flags
.valid
= 1;
347 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Found hot threshold [%lu]\n",
348 tz
->trips
.hot
.temperature
));
351 /* Passive: Processors (optional) */
354 acpi_evaluate_integer(tz
->handle
, "_PSV", NULL
,
355 &tz
->trips
.passive
.temperature
);
356 if (ACPI_FAILURE(status
)) {
357 tz
->trips
.passive
.flags
.valid
= 0;
358 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "No passive threshold\n"));
360 tz
->trips
.passive
.flags
.valid
= 1;
363 acpi_evaluate_integer(tz
->handle
, "_TC1", NULL
,
364 &tz
->trips
.passive
.tc1
);
365 if (ACPI_FAILURE(status
))
366 tz
->trips
.passive
.flags
.valid
= 0;
369 acpi_evaluate_integer(tz
->handle
, "_TC2", NULL
,
370 &tz
->trips
.passive
.tc2
);
371 if (ACPI_FAILURE(status
))
372 tz
->trips
.passive
.flags
.valid
= 0;
375 acpi_evaluate_integer(tz
->handle
, "_TSP", NULL
,
376 &tz
->trips
.passive
.tsp
);
377 if (ACPI_FAILURE(status
))
378 tz
->trips
.passive
.flags
.valid
= 0;
381 acpi_evaluate_reference(tz
->handle
, "_PSL", NULL
,
382 &tz
->trips
.passive
.devices
);
383 if (ACPI_FAILURE(status
))
384 tz
->trips
.passive
.flags
.valid
= 0;
386 if (!tz
->trips
.passive
.flags
.valid
)
387 ACPI_DEBUG_PRINT((ACPI_DB_WARN
,
388 "Invalid passive threshold\n"));
390 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
391 "Found passive threshold [%lu]\n",
392 tz
->trips
.passive
.temperature
));
395 /* Active: Fans, etc. (optional) */
397 for (i
= 0; i
< ACPI_THERMAL_MAX_ACTIVE
; i
++) {
399 char name
[5] = { '_', 'A', 'C', ('0' + i
), '\0' };
402 acpi_evaluate_integer(tz
->handle
, name
, NULL
,
403 &tz
->trips
.active
[i
].temperature
);
404 if (ACPI_FAILURE(status
))
409 acpi_evaluate_reference(tz
->handle
, name
, NULL
,
410 &tz
->trips
.active
[i
].devices
);
411 if (ACPI_SUCCESS(status
)) {
412 tz
->trips
.active
[i
].flags
.valid
= 1;
413 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
414 "Found active threshold [%d]:[%lu]\n",
415 i
, tz
->trips
.active
[i
].temperature
));
417 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
418 "Invalid active threshold [%d]\n",
425 static int acpi_thermal_get_devices(struct acpi_thermal
*tz
)
427 acpi_status status
= AE_OK
;
429 ACPI_FUNCTION_TRACE("acpi_thermal_get_devices");
432 return_VALUE(-EINVAL
);
435 acpi_evaluate_reference(tz
->handle
, "_TZD", NULL
, &tz
->devices
);
436 if (ACPI_FAILURE(status
))
437 return_VALUE(-ENODEV
);
442 static int acpi_thermal_call_usermode(char *path
)
444 char *argv
[2] = { NULL
, NULL
};
445 char *envp
[3] = { NULL
, NULL
, NULL
};
447 ACPI_FUNCTION_TRACE("acpi_thermal_call_usermode");
450 return_VALUE(-EINVAL
);
454 /* minimal command environment */
456 envp
[1] = "PATH=/sbin:/bin:/usr/sbin:/usr/bin";
458 call_usermodehelper(argv
[0], argv
, envp
, 0);
463 static int acpi_thermal_critical(struct acpi_thermal
*tz
)
466 struct acpi_device
*device
= NULL
;
468 ACPI_FUNCTION_TRACE("acpi_thermal_critical");
470 if (!tz
|| !tz
->trips
.critical
.flags
.valid
)
471 return_VALUE(-EINVAL
);
473 if (tz
->temperature
>= tz
->trips
.critical
.temperature
) {
474 ACPI_DEBUG_PRINT((ACPI_DB_WARN
, "Critical trip point\n"));
475 tz
->trips
.critical
.flags
.enabled
= 1;
476 } else if (tz
->trips
.critical
.flags
.enabled
)
477 tz
->trips
.critical
.flags
.enabled
= 0;
479 result
= acpi_bus_get_device(tz
->handle
, &device
);
481 return_VALUE(result
);
484 "Critical temperature reached (%ld C), shutting down.\n",
485 KELVIN_TO_CELSIUS(tz
->temperature
));
486 acpi_bus_generate_event(device
, ACPI_THERMAL_NOTIFY_CRITICAL
,
487 tz
->trips
.critical
.flags
.enabled
);
489 acpi_thermal_call_usermode(ACPI_THERMAL_PATH_POWEROFF
);
494 static int acpi_thermal_hot(struct acpi_thermal
*tz
)
497 struct acpi_device
*device
= NULL
;
499 ACPI_FUNCTION_TRACE("acpi_thermal_hot");
501 if (!tz
|| !tz
->trips
.hot
.flags
.valid
)
502 return_VALUE(-EINVAL
);
504 if (tz
->temperature
>= tz
->trips
.hot
.temperature
) {
505 ACPI_DEBUG_PRINT((ACPI_DB_WARN
, "Hot trip point\n"));
506 tz
->trips
.hot
.flags
.enabled
= 1;
507 } else if (tz
->trips
.hot
.flags
.enabled
)
508 tz
->trips
.hot
.flags
.enabled
= 0;
510 result
= acpi_bus_get_device(tz
->handle
, &device
);
512 return_VALUE(result
);
514 acpi_bus_generate_event(device
, ACPI_THERMAL_NOTIFY_HOT
,
515 tz
->trips
.hot
.flags
.enabled
);
517 /* TBD: Call user-mode "sleep(S4)" function */
522 static void acpi_thermal_passive(struct acpi_thermal
*tz
)
525 struct acpi_thermal_passive
*passive
= NULL
;
529 ACPI_FUNCTION_TRACE("acpi_thermal_passive");
531 if (!tz
|| !tz
->trips
.passive
.flags
.valid
)
534 passive
= &(tz
->trips
.passive
);
539 * Calculate the thermal trend (using the passive cooling equation)
540 * and modify the performance limit for all passive cooling devices
541 * accordingly. Note that we assume symmetry.
543 if (tz
->temperature
>= passive
->temperature
) {
545 (passive
->tc1
* (tz
->temperature
- tz
->last_temperature
)) +
546 (passive
->tc2
* (tz
->temperature
- passive
->temperature
));
547 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
548 "trend[%d]=(tc1[%lu]*(tmp[%lu]-last[%lu]))+(tc2[%lu]*(tmp[%lu]-psv[%lu]))\n",
549 trend
, passive
->tc1
, tz
->temperature
,
550 tz
->last_temperature
, passive
->tc2
,
551 tz
->temperature
, passive
->temperature
));
552 passive
->flags
.enabled
= 1;
555 for (i
= 0; i
< passive
->devices
.count
; i
++)
556 acpi_processor_set_thermal_limit(passive
->
559 ACPI_PROCESSOR_LIMIT_INCREMENT
);
561 else if (trend
< 0) {
562 for (i
= 0; i
< passive
->devices
.count
; i
++)
564 * assume that we are on highest
565 * freq/lowest thrott and can leave
566 * passive mode, even in error case
568 if (!acpi_processor_set_thermal_limit
569 (passive
->devices
.handles
[i
],
570 ACPI_PROCESSOR_LIMIT_DECREMENT
))
573 * Leave cooling mode, even if the temp might
574 * higher than trip point This is because some
575 * machines might have long thermal polling
576 * frequencies (tsp) defined. We will fall back
577 * into passive mode in next cycle (probably quicker)
580 passive
->flags
.enabled
= 0;
581 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
582 "Disabling passive cooling, still above threshold,"
583 " but we are cooling down\n"));
592 * Implement passive cooling hysteresis to slowly increase performance
593 * and avoid thrashing around the passive trip point. Note that we
596 if (!passive
->flags
.enabled
)
598 for (i
= 0; i
< passive
->devices
.count
; i
++)
599 if (!acpi_processor_set_thermal_limit
600 (passive
->devices
.handles
[i
],
601 ACPI_PROCESSOR_LIMIT_DECREMENT
))
604 passive
->flags
.enabled
= 0;
605 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
606 "Disabling passive cooling (zone is cool)\n"));
610 static void acpi_thermal_active(struct acpi_thermal
*tz
)
613 struct acpi_thermal_active
*active
= NULL
;
616 unsigned long maxtemp
= 0;
618 ACPI_FUNCTION_TRACE("acpi_thermal_active");
623 for (i
= 0; i
< ACPI_THERMAL_MAX_ACTIVE
; i
++) {
624 active
= &(tz
->trips
.active
[i
]);
625 if (!active
|| !active
->flags
.valid
)
627 if (tz
->temperature
>= active
->temperature
) {
631 * If not already enabled, turn ON all cooling devices
632 * associated with this active threshold.
634 if (active
->temperature
> maxtemp
)
635 tz
->state
.active_index
= i
;
636 maxtemp
= active
->temperature
;
637 if (active
->flags
.enabled
)
639 for (j
= 0; j
< active
->devices
.count
; j
++) {
641 acpi_bus_set_power(active
->devices
.
645 ACPI_DEBUG_PRINT((ACPI_DB_WARN
,
646 "Unable to turn cooling device [%p] 'on'\n",
651 active
->flags
.enabled
= 1;
652 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
653 "Cooling device [%p] now 'on'\n",
654 active
->devices
.handles
[j
]));
658 if (!active
->flags
.enabled
)
663 * Turn OFF all cooling devices associated with this
666 for (j
= 0; j
< active
->devices
.count
; j
++) {
667 result
= acpi_bus_set_power(active
->devices
.handles
[j
],
670 ACPI_DEBUG_PRINT((ACPI_DB_WARN
,
671 "Unable to turn cooling device [%p] 'off'\n",
672 active
->devices
.handles
[j
]));
675 active
->flags
.enabled
= 0;
676 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
677 "Cooling device [%p] now 'off'\n",
678 active
->devices
.handles
[j
]));
683 static void acpi_thermal_check(void *context
);
685 static void acpi_thermal_run(unsigned long data
)
687 struct acpi_thermal
*tz
= (struct acpi_thermal
*)data
;
689 acpi_os_execute(OSL_GPE_HANDLER
, acpi_thermal_check
, (void *)data
);
692 static void acpi_thermal_check(void *data
)
695 struct acpi_thermal
*tz
= (struct acpi_thermal
*)data
;
696 unsigned long sleep_time
= 0;
698 struct acpi_thermal_state state
;
700 ACPI_FUNCTION_TRACE("acpi_thermal_check");
703 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "Invalid (NULL) context.\n"));
709 result
= acpi_thermal_get_temperature(tz
);
713 memset(&tz
->state
, 0, sizeof(tz
->state
));
718 * Compare the current temperature to the trip point values to see
719 * if we've entered one of the thermal policy states. Note that
720 * this function determines when a state is entered, but the
721 * individual policy decides when it is exited (e.g. hysteresis).
723 if (tz
->trips
.critical
.flags
.valid
)
725 (tz
->temperature
>= tz
->trips
.critical
.temperature
);
726 if (tz
->trips
.hot
.flags
.valid
)
727 state
.hot
|= (tz
->temperature
>= tz
->trips
.hot
.temperature
);
728 if (tz
->trips
.passive
.flags
.valid
)
730 (tz
->temperature
>= tz
->trips
.passive
.temperature
);
731 for (i
= 0; i
< ACPI_THERMAL_MAX_ACTIVE
; i
++)
732 if (tz
->trips
.active
[i
].flags
.valid
)
735 tz
->trips
.active
[i
].temperature
);
740 * Separated from the above check to allow individual policy to
741 * determine when to exit a given state.
744 acpi_thermal_critical(tz
);
746 acpi_thermal_hot(tz
);
748 acpi_thermal_passive(tz
);
750 acpi_thermal_active(tz
);
755 * Again, separated from the above two to allow independent policy
758 tz
->state
.critical
= tz
->trips
.critical
.flags
.enabled
;
759 tz
->state
.hot
= tz
->trips
.hot
.flags
.enabled
;
760 tz
->state
.passive
= tz
->trips
.passive
.flags
.enabled
;
761 tz
->state
.active
= 0;
762 for (i
= 0; i
< ACPI_THERMAL_MAX_ACTIVE
; i
++)
763 tz
->state
.active
|= tz
->trips
.active
[i
].flags
.enabled
;
766 * Calculate Sleep Time
767 * --------------------
768 * If we're in the passive state, use _TSP's value. Otherwise
769 * use the default polling frequency (e.g. _TZP). If no polling
770 * frequency is specified then we'll wait forever (at least until
771 * a thermal event occurs). Note that _TSP and _TZD values are
772 * given in 1/10th seconds (we must covert to milliseconds).
774 if (tz
->state
.passive
)
775 sleep_time
= tz
->trips
.passive
.tsp
* 100;
776 else if (tz
->polling_frequency
> 0)
777 sleep_time
= tz
->polling_frequency
* 100;
779 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "%s: temperature[%lu] sleep[%lu]\n",
780 tz
->name
, tz
->temperature
, sleep_time
));
787 if (timer_pending(&(tz
->timer
)))
788 del_timer(&(tz
->timer
));
790 if (timer_pending(&(tz
->timer
)))
791 mod_timer(&(tz
->timer
), (HZ
* sleep_time
) / 1000);
793 tz
->timer
.data
= (unsigned long)tz
;
794 tz
->timer
.function
= acpi_thermal_run
;
795 tz
->timer
.expires
= jiffies
+ (HZ
* sleep_time
) / 1000;
796 add_timer(&(tz
->timer
));
803 /* --------------------------------------------------------------------------
805 -------------------------------------------------------------------------- */
807 static struct proc_dir_entry
*acpi_thermal_dir
;
809 static int acpi_thermal_state_seq_show(struct seq_file
*seq
, void *offset
)
811 struct acpi_thermal
*tz
= (struct acpi_thermal
*)seq
->private;
813 ACPI_FUNCTION_TRACE("acpi_thermal_state_seq_show");
818 seq_puts(seq
, "state: ");
820 if (!tz
->state
.critical
&& !tz
->state
.hot
&& !tz
->state
.passive
821 && !tz
->state
.active
)
822 seq_puts(seq
, "ok\n");
824 if (tz
->state
.critical
)
825 seq_puts(seq
, "critical ");
827 seq_puts(seq
, "hot ");
828 if (tz
->state
.passive
)
829 seq_puts(seq
, "passive ");
830 if (tz
->state
.active
)
831 seq_printf(seq
, "active[%d]", tz
->state
.active_index
);
839 static int acpi_thermal_state_open_fs(struct inode
*inode
, struct file
*file
)
841 return single_open(file
, acpi_thermal_state_seq_show
, PDE(inode
)->data
);
844 static int acpi_thermal_temp_seq_show(struct seq_file
*seq
, void *offset
)
847 struct acpi_thermal
*tz
= (struct acpi_thermal
*)seq
->private;
849 ACPI_FUNCTION_TRACE("acpi_thermal_temp_seq_show");
854 result
= acpi_thermal_get_temperature(tz
);
858 seq_printf(seq
, "temperature: %ld C\n",
859 KELVIN_TO_CELSIUS(tz
->temperature
));
865 static int acpi_thermal_temp_open_fs(struct inode
*inode
, struct file
*file
)
867 return single_open(file
, acpi_thermal_temp_seq_show
, PDE(inode
)->data
);
870 static int acpi_thermal_trip_seq_show(struct seq_file
*seq
, void *offset
)
872 struct acpi_thermal
*tz
= (struct acpi_thermal
*)seq
->private;
876 ACPI_FUNCTION_TRACE("acpi_thermal_trip_seq_show");
881 if (tz
->trips
.critical
.flags
.valid
)
882 seq_printf(seq
, "critical (S5): %ld C\n",
883 KELVIN_TO_CELSIUS(tz
->trips
.critical
.temperature
));
885 if (tz
->trips
.hot
.flags
.valid
)
886 seq_printf(seq
, "hot (S4): %ld C\n",
887 KELVIN_TO_CELSIUS(tz
->trips
.hot
.temperature
));
889 if (tz
->trips
.passive
.flags
.valid
) {
891 "passive: %ld C: tc1=%lu tc2=%lu tsp=%lu devices=",
892 KELVIN_TO_CELSIUS(tz
->trips
.passive
.temperature
),
893 tz
->trips
.passive
.tc1
, tz
->trips
.passive
.tc2
,
894 tz
->trips
.passive
.tsp
);
895 for (j
= 0; j
< tz
->trips
.passive
.devices
.count
; j
++) {
897 seq_printf(seq
, "0x%p ",
898 tz
->trips
.passive
.devices
.handles
[j
]);
903 for (i
= 0; i
< ACPI_THERMAL_MAX_ACTIVE
; i
++) {
904 if (!(tz
->trips
.active
[i
].flags
.valid
))
906 seq_printf(seq
, "active[%d]: %ld C: devices=",
908 KELVIN_TO_CELSIUS(tz
->trips
.active
[i
].temperature
));
909 for (j
= 0; j
< tz
->trips
.active
[i
].devices
.count
; j
++)
910 seq_printf(seq
, "0x%p ",
911 tz
->trips
.active
[i
].devices
.handles
[j
]);
919 static int acpi_thermal_trip_open_fs(struct inode
*inode
, struct file
*file
)
921 return single_open(file
, acpi_thermal_trip_seq_show
, PDE(inode
)->data
);
925 acpi_thermal_write_trip_points(struct file
*file
,
926 const char __user
* buffer
,
927 size_t count
, loff_t
* ppos
)
929 struct seq_file
*m
= (struct seq_file
*)file
->private_data
;
930 struct acpi_thermal
*tz
= (struct acpi_thermal
*)m
->private;
933 int num
, critical
, hot
, passive
;
937 ACPI_FUNCTION_TRACE("acpi_thermal_write_trip_points");
939 limit_string
= kmalloc(ACPI_THERMAL_MAX_LIMIT_STR_LEN
, GFP_KERNEL
);
941 return_VALUE(-ENOMEM
);
943 memset(limit_string
, 0, ACPI_THERMAL_MAX_LIMIT_STR_LEN
);
945 active
= kmalloc(ACPI_THERMAL_MAX_ACTIVE
* sizeof(int), GFP_KERNEL
);
948 return_VALUE(-ENOMEM
);
951 if (!tz
|| (count
> ACPI_THERMAL_MAX_LIMIT_STR_LEN
- 1)) {
952 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "Invalid argument\n"));
957 if (copy_from_user(limit_string
, buffer
, count
)) {
958 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "Invalid data\n"));
963 limit_string
[count
] = '\0';
965 num
= sscanf(limit_string
, "%d:%d:%d:%d:%d:%d:%d:%d:%d:%d:%d:%d:%d",
966 &critical
, &hot
, &passive
,
967 &active
[0], &active
[1], &active
[2], &active
[3], &active
[4],
968 &active
[5], &active
[6], &active
[7], &active
[8],
970 if (!(num
>= 5 && num
< (ACPI_THERMAL_MAX_ACTIVE
+ 3))) {
971 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
, "Invalid data format\n"));
976 tz
->trips
.critical
.temperature
= CELSIUS_TO_KELVIN(critical
);
977 tz
->trips
.hot
.temperature
= CELSIUS_TO_KELVIN(hot
);
978 tz
->trips
.passive
.temperature
= CELSIUS_TO_KELVIN(passive
);
979 for (i
= 0; i
< num
- 3; i
++) {
980 if (!(tz
->trips
.active
[i
].flags
.valid
))
982 tz
->trips
.active
[i
].temperature
= CELSIUS_TO_KELVIN(active
[i
]);
991 static int acpi_thermal_cooling_seq_show(struct seq_file
*seq
, void *offset
)
993 struct acpi_thermal
*tz
= (struct acpi_thermal
*)seq
->private;
995 ACPI_FUNCTION_TRACE("acpi_thermal_cooling_seq_show");
1000 if (!tz
->flags
.cooling_mode
) {
1001 seq_puts(seq
, "<setting not supported>\n");
1004 if (tz
->cooling_mode
== ACPI_THERMAL_MODE_CRITICAL
)
1005 seq_printf(seq
, "cooling mode: critical\n");
1007 seq_printf(seq
, "cooling mode: %s\n",
1008 tz
->cooling_mode
? "passive" : "active");
1014 static int acpi_thermal_cooling_open_fs(struct inode
*inode
, struct file
*file
)
1016 return single_open(file
, acpi_thermal_cooling_seq_show
,
1021 acpi_thermal_write_cooling_mode(struct file
*file
,
1022 const char __user
* buffer
,
1023 size_t count
, loff_t
* ppos
)
1025 struct seq_file
*m
= (struct seq_file
*)file
->private_data
;
1026 struct acpi_thermal
*tz
= (struct acpi_thermal
*)m
->private;
1028 char mode_string
[12] = { '\0' };
1030 ACPI_FUNCTION_TRACE("acpi_thermal_write_cooling_mode");
1032 if (!tz
|| (count
> sizeof(mode_string
) - 1))
1033 return_VALUE(-EINVAL
);
1035 if (!tz
->flags
.cooling_mode
)
1036 return_VALUE(-ENODEV
);
1038 if (copy_from_user(mode_string
, buffer
, count
))
1039 return_VALUE(-EFAULT
);
1041 mode_string
[count
] = '\0';
1043 result
= acpi_thermal_set_cooling_mode(tz
,
1044 simple_strtoul(mode_string
, NULL
,
1047 return_VALUE(result
);
1049 acpi_thermal_check(tz
);
1051 return_VALUE(count
);
1054 static int acpi_thermal_polling_seq_show(struct seq_file
*seq
, void *offset
)
1056 struct acpi_thermal
*tz
= (struct acpi_thermal
*)seq
->private;
1058 ACPI_FUNCTION_TRACE("acpi_thermal_polling_seq_show");
1063 if (!tz
->polling_frequency
) {
1064 seq_puts(seq
, "<polling disabled>\n");
1068 seq_printf(seq
, "polling frequency: %lu seconds\n",
1069 (tz
->polling_frequency
/ 10));
1075 static int acpi_thermal_polling_open_fs(struct inode
*inode
, struct file
*file
)
1077 return single_open(file
, acpi_thermal_polling_seq_show
,
1082 acpi_thermal_write_polling(struct file
*file
,
1083 const char __user
* buffer
,
1084 size_t count
, loff_t
* ppos
)
1086 struct seq_file
*m
= (struct seq_file
*)file
->private_data
;
1087 struct acpi_thermal
*tz
= (struct acpi_thermal
*)m
->private;
1089 char polling_string
[12] = { '\0' };
1092 ACPI_FUNCTION_TRACE("acpi_thermal_write_polling");
1094 if (!tz
|| (count
> sizeof(polling_string
) - 1))
1095 return_VALUE(-EINVAL
);
1097 if (copy_from_user(polling_string
, buffer
, count
))
1098 return_VALUE(-EFAULT
);
1100 polling_string
[count
] = '\0';
1102 seconds
= simple_strtoul(polling_string
, NULL
, 0);
1104 result
= acpi_thermal_set_polling(tz
, seconds
);
1106 return_VALUE(result
);
1108 acpi_thermal_check(tz
);
1110 return_VALUE(count
);
1113 static int acpi_thermal_add_fs(struct acpi_device
*device
)
1115 struct proc_dir_entry
*entry
= NULL
;
1117 ACPI_FUNCTION_TRACE("acpi_thermal_add_fs");
1119 if (!acpi_device_dir(device
)) {
1120 acpi_device_dir(device
) = proc_mkdir(acpi_device_bid(device
),
1122 if (!acpi_device_dir(device
))
1123 return_VALUE(-ENODEV
);
1124 acpi_device_dir(device
)->owner
= THIS_MODULE
;
1128 entry
= create_proc_entry(ACPI_THERMAL_FILE_STATE
,
1129 S_IRUGO
, acpi_device_dir(device
));
1131 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1132 "Unable to create '%s' fs entry\n",
1133 ACPI_THERMAL_FILE_STATE
));
1135 entry
->proc_fops
= &acpi_thermal_state_fops
;
1136 entry
->data
= acpi_driver_data(device
);
1137 entry
->owner
= THIS_MODULE
;
1140 /* 'temperature' [R] */
1141 entry
= create_proc_entry(ACPI_THERMAL_FILE_TEMPERATURE
,
1142 S_IRUGO
, acpi_device_dir(device
));
1144 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1145 "Unable to create '%s' fs entry\n",
1146 ACPI_THERMAL_FILE_TEMPERATURE
));
1148 entry
->proc_fops
= &acpi_thermal_temp_fops
;
1149 entry
->data
= acpi_driver_data(device
);
1150 entry
->owner
= THIS_MODULE
;
1153 /* 'trip_points' [R/W] */
1154 entry
= create_proc_entry(ACPI_THERMAL_FILE_TRIP_POINTS
,
1155 S_IFREG
| S_IRUGO
| S_IWUSR
,
1156 acpi_device_dir(device
));
1158 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1159 "Unable to create '%s' fs entry\n",
1160 ACPI_THERMAL_FILE_TRIP_POINTS
));
1162 entry
->proc_fops
= &acpi_thermal_trip_fops
;
1163 entry
->data
= acpi_driver_data(device
);
1164 entry
->owner
= THIS_MODULE
;
1167 /* 'cooling_mode' [R/W] */
1168 entry
= create_proc_entry(ACPI_THERMAL_FILE_COOLING_MODE
,
1169 S_IFREG
| S_IRUGO
| S_IWUSR
,
1170 acpi_device_dir(device
));
1172 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1173 "Unable to create '%s' fs entry\n",
1174 ACPI_THERMAL_FILE_COOLING_MODE
));
1176 entry
->proc_fops
= &acpi_thermal_cooling_fops
;
1177 entry
->data
= acpi_driver_data(device
);
1178 entry
->owner
= THIS_MODULE
;
1181 /* 'polling_frequency' [R/W] */
1182 entry
= create_proc_entry(ACPI_THERMAL_FILE_POLLING_FREQ
,
1183 S_IFREG
| S_IRUGO
| S_IWUSR
,
1184 acpi_device_dir(device
));
1186 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1187 "Unable to create '%s' fs entry\n",
1188 ACPI_THERMAL_FILE_POLLING_FREQ
));
1190 entry
->proc_fops
= &acpi_thermal_polling_fops
;
1191 entry
->data
= acpi_driver_data(device
);
1192 entry
->owner
= THIS_MODULE
;
1198 static int acpi_thermal_remove_fs(struct acpi_device
*device
)
1200 ACPI_FUNCTION_TRACE("acpi_thermal_remove_fs");
1202 if (acpi_device_dir(device
)) {
1203 remove_proc_entry(ACPI_THERMAL_FILE_POLLING_FREQ
,
1204 acpi_device_dir(device
));
1205 remove_proc_entry(ACPI_THERMAL_FILE_COOLING_MODE
,
1206 acpi_device_dir(device
));
1207 remove_proc_entry(ACPI_THERMAL_FILE_TRIP_POINTS
,
1208 acpi_device_dir(device
));
1209 remove_proc_entry(ACPI_THERMAL_FILE_TEMPERATURE
,
1210 acpi_device_dir(device
));
1211 remove_proc_entry(ACPI_THERMAL_FILE_STATE
,
1212 acpi_device_dir(device
));
1213 remove_proc_entry(acpi_device_bid(device
), acpi_thermal_dir
);
1214 acpi_device_dir(device
) = NULL
;
1220 /* --------------------------------------------------------------------------
1222 -------------------------------------------------------------------------- */
1224 static void acpi_thermal_notify(acpi_handle handle
, u32 event
, void *data
)
1226 struct acpi_thermal
*tz
= (struct acpi_thermal
*)data
;
1227 struct acpi_device
*device
= NULL
;
1229 ACPI_FUNCTION_TRACE("acpi_thermal_notify");
1234 if (acpi_bus_get_device(tz
->handle
, &device
))
1238 case ACPI_THERMAL_NOTIFY_TEMPERATURE
:
1239 acpi_thermal_check(tz
);
1241 case ACPI_THERMAL_NOTIFY_THRESHOLDS
:
1242 acpi_thermal_get_trip_points(tz
);
1243 acpi_thermal_check(tz
);
1244 acpi_bus_generate_event(device
, event
, 0);
1246 case ACPI_THERMAL_NOTIFY_DEVICES
:
1247 if (tz
->flags
.devices
)
1248 acpi_thermal_get_devices(tz
);
1249 acpi_bus_generate_event(device
, event
, 0);
1252 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
1253 "Unsupported event [0x%x]\n", event
));
1260 static int acpi_thermal_get_info(struct acpi_thermal
*tz
)
1264 ACPI_FUNCTION_TRACE("acpi_thermal_get_info");
1267 return_VALUE(-EINVAL
);
1269 /* Get temperature [_TMP] (required) */
1270 result
= acpi_thermal_get_temperature(tz
);
1272 return_VALUE(result
);
1274 /* Get trip points [_CRT, _PSV, etc.] (required) */
1275 result
= acpi_thermal_get_trip_points(tz
);
1277 return_VALUE(result
);
1279 /* Set the cooling mode [_SCP] to active cooling (default) */
1280 result
= acpi_thermal_set_cooling_mode(tz
, ACPI_THERMAL_MODE_ACTIVE
);
1282 tz
->flags
.cooling_mode
= 1;
1284 /* Oh,we have not _SCP method.
1285 Generally show cooling_mode by _ACx, _PSV,spec 12.2 */
1286 tz
->flags
.cooling_mode
= 0;
1287 if (tz
->trips
.active
[0].flags
.valid
1288 && tz
->trips
.passive
.flags
.valid
) {
1289 if (tz
->trips
.passive
.temperature
>
1290 tz
->trips
.active
[0].temperature
)
1291 tz
->cooling_mode
= ACPI_THERMAL_MODE_ACTIVE
;
1293 tz
->cooling_mode
= ACPI_THERMAL_MODE_PASSIVE
;
1294 } else if (!tz
->trips
.active
[0].flags
.valid
1295 && tz
->trips
.passive
.flags
.valid
) {
1296 tz
->cooling_mode
= ACPI_THERMAL_MODE_PASSIVE
;
1297 } else if (tz
->trips
.active
[0].flags
.valid
1298 && !tz
->trips
.passive
.flags
.valid
) {
1299 tz
->cooling_mode
= ACPI_THERMAL_MODE_ACTIVE
;
1301 /* _ACx and _PSV are optional, but _CRT is required */
1302 tz
->cooling_mode
= ACPI_THERMAL_MODE_CRITICAL
;
1306 /* Get default polling frequency [_TZP] (optional) */
1308 tz
->polling_frequency
= tzp
;
1310 acpi_thermal_get_polling_frequency(tz
);
1312 /* Get devices in this thermal zone [_TZD] (optional) */
1313 result
= acpi_thermal_get_devices(tz
);
1315 tz
->flags
.devices
= 1;
1320 static int acpi_thermal_add(struct acpi_device
*device
)
1323 acpi_status status
= AE_OK
;
1324 struct acpi_thermal
*tz
= NULL
;
1326 ACPI_FUNCTION_TRACE("acpi_thermal_add");
1329 return_VALUE(-EINVAL
);
1331 tz
= kmalloc(sizeof(struct acpi_thermal
), GFP_KERNEL
);
1333 return_VALUE(-ENOMEM
);
1334 memset(tz
, 0, sizeof(struct acpi_thermal
));
1336 tz
->handle
= device
->handle
;
1337 strcpy(tz
->name
, device
->pnp
.bus_id
);
1338 strcpy(acpi_device_name(device
), ACPI_THERMAL_DEVICE_NAME
);
1339 strcpy(acpi_device_class(device
), ACPI_THERMAL_CLASS
);
1340 acpi_driver_data(device
) = tz
;
1342 result
= acpi_thermal_get_info(tz
);
1346 result
= acpi_thermal_add_fs(device
);
1350 init_timer(&tz
->timer
);
1352 acpi_thermal_check(tz
);
1354 status
= acpi_install_notify_handler(tz
->handle
,
1356 acpi_thermal_notify
, tz
);
1357 if (ACPI_FAILURE(status
)) {
1358 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1359 "Error installing notify handler\n"));
1364 printk(KERN_INFO PREFIX
"%s [%s] (%ld C)\n",
1365 acpi_device_name(device
), acpi_device_bid(device
),
1366 KELVIN_TO_CELSIUS(tz
->temperature
));
1370 acpi_thermal_remove_fs(device
);
1374 return_VALUE(result
);
1377 static int acpi_thermal_remove(struct acpi_device
*device
, int type
)
1379 acpi_status status
= AE_OK
;
1380 struct acpi_thermal
*tz
= NULL
;
1382 ACPI_FUNCTION_TRACE("acpi_thermal_remove");
1384 if (!device
|| !acpi_driver_data(device
))
1385 return_VALUE(-EINVAL
);
1387 tz
= (struct acpi_thermal
*)acpi_driver_data(device
);
1389 /* avoid timer adding new defer task */
1391 /* wait for running timer (on other CPUs) finish */
1392 del_timer_sync(&(tz
->timer
));
1393 /* synchronize deferred task */
1394 acpi_os_wait_events_complete(NULL
);
1395 /* deferred task may reinsert timer */
1396 del_timer_sync(&(tz
->timer
));
1398 status
= acpi_remove_notify_handler(tz
->handle
,
1400 acpi_thermal_notify
);
1401 if (ACPI_FAILURE(status
))
1402 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
1403 "Error removing notify handler\n"));
1405 /* Terminate policy */
1406 if (tz
->trips
.passive
.flags
.valid
&& tz
->trips
.passive
.flags
.enabled
) {
1407 tz
->trips
.passive
.flags
.enabled
= 0;
1408 acpi_thermal_passive(tz
);
1410 if (tz
->trips
.active
[0].flags
.valid
1411 && tz
->trips
.active
[0].flags
.enabled
) {
1412 tz
->trips
.active
[0].flags
.enabled
= 0;
1413 acpi_thermal_active(tz
);
1416 acpi_thermal_remove_fs(device
);
1422 static int acpi_thermal_resume(struct acpi_device
*device
, int state
)
1424 struct acpi_thermal
*tz
= NULL
;
1426 if (!device
|| !acpi_driver_data(device
))
1427 return_VALUE(-EINVAL
);
1429 tz
= (struct acpi_thermal
*)acpi_driver_data(device
);
1431 acpi_thermal_check(tz
);
1436 static int __init
acpi_thermal_init(void)
1440 ACPI_FUNCTION_TRACE("acpi_thermal_init");
1442 acpi_thermal_dir
= proc_mkdir(ACPI_THERMAL_CLASS
, acpi_root_dir
);
1443 if (!acpi_thermal_dir
)
1444 return_VALUE(-ENODEV
);
1445 acpi_thermal_dir
->owner
= THIS_MODULE
;
1447 result
= acpi_bus_register_driver(&acpi_thermal_driver
);
1449 remove_proc_entry(ACPI_THERMAL_CLASS
, acpi_root_dir
);
1450 return_VALUE(-ENODEV
);
1456 static void __exit
acpi_thermal_exit(void)
1458 ACPI_FUNCTION_TRACE("acpi_thermal_exit");
1460 acpi_bus_unregister_driver(&acpi_thermal_driver
);
1462 remove_proc_entry(ACPI_THERMAL_CLASS
, acpi_root_dir
);
1467 module_init(acpi_thermal_init
);
1468 module_exit(acpi_thermal_exit
);