2 * thermal.c - Generic Thermal Management Sysfs support.
4 * Copyright (C) 2008 Intel Corp
5 * Copyright (C) 2008 Zhang Rui <rui.zhang@intel.com>
6 * Copyright (C) 2008 Sujith Thomas <sujith.thomas@intel.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; version 2 of the License.
13 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
15 #include <linux/module.h>
16 #include <linux/device.h>
17 #include <linux/err.h>
18 #include <linux/slab.h>
19 #include <linux/kdev_t.h>
20 #include <linux/idr.h>
21 #include <linux/thermal.h>
22 #include <linux/reboot.h>
23 #include <linux/string.h>
25 #include <net/netlink.h>
26 #include <net/genetlink.h>
27 #include <linux/suspend.h>
29 #define CREATE_TRACE_POINTS
30 #include <trace/events/thermal.h>
32 #include "thermal_core.h"
33 #include "thermal_hwmon.h"
35 MODULE_AUTHOR("Zhang Rui");
36 MODULE_DESCRIPTION("Generic thermal management sysfs support");
37 MODULE_LICENSE("GPL v2");
39 static DEFINE_IDA(thermal_tz_ida
);
40 static DEFINE_IDA(thermal_cdev_ida
);
42 static LIST_HEAD(thermal_tz_list
);
43 static LIST_HEAD(thermal_cdev_list
);
44 static LIST_HEAD(thermal_governor_list
);
46 static DEFINE_MUTEX(thermal_list_lock
);
47 static DEFINE_MUTEX(thermal_governor_lock
);
48 static DEFINE_MUTEX(poweroff_lock
);
50 static atomic_t in_suspend
;
51 static bool power_off_triggered
;
53 static struct thermal_governor
*def_governor
;
56 * Governor section: set of functions to handle thermal governors
58 * Functions to help in the life cycle of thermal governors within
59 * the thermal core and by the thermal governor code.
62 static struct thermal_governor
*__find_governor(const char *name
)
64 struct thermal_governor
*pos
;
66 if (!name
|| !name
[0])
69 list_for_each_entry(pos
, &thermal_governor_list
, governor_list
)
70 if (!strncasecmp(name
, pos
->name
, THERMAL_NAME_LENGTH
))
77 * bind_previous_governor() - bind the previous governor of the thermal zone
78 * @tz: a valid pointer to a struct thermal_zone_device
79 * @failed_gov_name: the name of the governor that failed to register
81 * Register the previous governor of the thermal zone after a new
82 * governor has failed to be bound.
84 static void bind_previous_governor(struct thermal_zone_device
*tz
,
85 const char *failed_gov_name
)
87 if (tz
->governor
&& tz
->governor
->bind_to_tz
) {
88 if (tz
->governor
->bind_to_tz(tz
)) {
90 "governor %s failed to bind and the previous one (%s) failed to bind again, thermal zone %s has no governor\n",
91 failed_gov_name
, tz
->governor
->name
, tz
->type
);
98 * thermal_set_governor() - Switch to another governor
99 * @tz: a valid pointer to a struct thermal_zone_device
100 * @new_gov: pointer to the new governor
102 * Change the governor of thermal zone @tz.
104 * Return: 0 on success, an error if the new governor's bind_to_tz() failed.
106 static int thermal_set_governor(struct thermal_zone_device
*tz
,
107 struct thermal_governor
*new_gov
)
111 if (tz
->governor
&& tz
->governor
->unbind_from_tz
)
112 tz
->governor
->unbind_from_tz(tz
);
114 if (new_gov
&& new_gov
->bind_to_tz
) {
115 ret
= new_gov
->bind_to_tz(tz
);
117 bind_previous_governor(tz
, new_gov
->name
);
123 tz
->governor
= new_gov
;
128 int thermal_register_governor(struct thermal_governor
*governor
)
132 struct thermal_zone_device
*pos
;
137 mutex_lock(&thermal_governor_lock
);
140 if (!__find_governor(governor
->name
)) {
144 list_add(&governor
->governor_list
, &thermal_governor_list
);
145 match_default
= !strncmp(governor
->name
,
146 DEFAULT_THERMAL_GOVERNOR
,
147 THERMAL_NAME_LENGTH
);
149 if (!def_governor
&& match_default
)
150 def_governor
= governor
;
153 mutex_lock(&thermal_list_lock
);
155 list_for_each_entry(pos
, &thermal_tz_list
, node
) {
157 * only thermal zones with specified tz->tzp->governor_name
158 * may run with tz->govenor unset
163 name
= pos
->tzp
->governor_name
;
165 if (!strncasecmp(name
, governor
->name
, THERMAL_NAME_LENGTH
)) {
168 ret
= thermal_set_governor(pos
, governor
);
170 dev_err(&pos
->device
,
171 "Failed to set governor %s for thermal zone %s: %d\n",
172 governor
->name
, pos
->type
, ret
);
176 mutex_unlock(&thermal_list_lock
);
177 mutex_unlock(&thermal_governor_lock
);
182 void thermal_unregister_governor(struct thermal_governor
*governor
)
184 struct thermal_zone_device
*pos
;
189 mutex_lock(&thermal_governor_lock
);
191 if (!__find_governor(governor
->name
))
194 mutex_lock(&thermal_list_lock
);
196 list_for_each_entry(pos
, &thermal_tz_list
, node
) {
197 if (!strncasecmp(pos
->governor
->name
, governor
->name
,
198 THERMAL_NAME_LENGTH
))
199 thermal_set_governor(pos
, NULL
);
202 mutex_unlock(&thermal_list_lock
);
203 list_del(&governor
->governor_list
);
205 mutex_unlock(&thermal_governor_lock
);
208 int thermal_zone_device_set_policy(struct thermal_zone_device
*tz
,
211 struct thermal_governor
*gov
;
214 mutex_lock(&thermal_governor_lock
);
215 mutex_lock(&tz
->lock
);
217 gov
= __find_governor(strim(policy
));
221 ret
= thermal_set_governor(tz
, gov
);
224 mutex_unlock(&tz
->lock
);
225 mutex_unlock(&thermal_governor_lock
);
230 int thermal_build_list_of_policies(char *buf
)
232 struct thermal_governor
*pos
;
234 ssize_t size
= PAGE_SIZE
;
236 mutex_lock(&thermal_governor_lock
);
238 list_for_each_entry(pos
, &thermal_governor_list
, governor_list
) {
239 size
= PAGE_SIZE
- count
;
240 count
+= scnprintf(buf
+ count
, size
, "%s ", pos
->name
);
242 count
+= scnprintf(buf
+ count
, size
, "\n");
244 mutex_unlock(&thermal_governor_lock
);
249 static int __init
thermal_register_governors(void)
253 result
= thermal_gov_step_wise_register();
257 result
= thermal_gov_fair_share_register();
261 result
= thermal_gov_bang_bang_register();
265 result
= thermal_gov_user_space_register();
269 return thermal_gov_power_allocator_register();
272 static void thermal_unregister_governors(void)
274 thermal_gov_step_wise_unregister();
275 thermal_gov_fair_share_unregister();
276 thermal_gov_bang_bang_unregister();
277 thermal_gov_user_space_unregister();
278 thermal_gov_power_allocator_unregister();
282 * Zone update section: main control loop applied to each zone while monitoring
284 * in polling mode. The monitoring is done using a workqueue.
285 * Same update may be done on a zone by calling thermal_zone_device_update().
288 * - Non-critical trips will invoke the governor responsible for that zone;
289 * - Hot trips will produce a notification to userspace;
290 * - Critical trip point will cause a system shutdown.
292 static void thermal_zone_device_set_polling(struct thermal_zone_device
*tz
,
296 mod_delayed_work(system_freezable_wq
, &tz
->poll_queue
,
297 round_jiffies(msecs_to_jiffies(delay
)));
299 mod_delayed_work(system_freezable_wq
, &tz
->poll_queue
,
300 msecs_to_jiffies(delay
));
302 cancel_delayed_work(&tz
->poll_queue
);
305 static void monitor_thermal_zone(struct thermal_zone_device
*tz
)
307 mutex_lock(&tz
->lock
);
310 thermal_zone_device_set_polling(tz
, tz
->passive_delay
);
311 else if (tz
->polling_delay
)
312 thermal_zone_device_set_polling(tz
, tz
->polling_delay
);
314 thermal_zone_device_set_polling(tz
, 0);
316 mutex_unlock(&tz
->lock
);
319 static void handle_non_critical_trips(struct thermal_zone_device
*tz
,
321 enum thermal_trip_type trip_type
)
323 tz
->governor
? tz
->governor
->throttle(tz
, trip
) :
324 def_governor
->throttle(tz
, trip
);
328 * thermal_emergency_poweroff_func - emergency poweroff work after a known delay
329 * @work: work_struct associated with the emergency poweroff function
331 * This function is called in very critical situations to force
332 * a kernel poweroff after a configurable timeout value.
334 static void thermal_emergency_poweroff_func(struct work_struct
*work
)
337 * We have reached here after the emergency thermal shutdown
338 * Waiting period has expired. This means orderly_poweroff has
339 * not been able to shut off the system for some reason.
340 * Try to shut down the system immediately using kernel_power_off
343 WARN(1, "Attempting kernel_power_off: Temperature too high\n");
347 * Worst of the worst case trigger emergency restart
349 WARN(1, "Attempting emergency_restart: Temperature too high\n");
353 static DECLARE_DELAYED_WORK(thermal_emergency_poweroff_work
,
354 thermal_emergency_poweroff_func
);
357 * thermal_emergency_poweroff - Trigger an emergency system poweroff
359 * This may be called from any critical situation to trigger a system shutdown
360 * after a known period of time. By default this is not scheduled.
362 static void thermal_emergency_poweroff(void)
364 int poweroff_delay_ms
= CONFIG_THERMAL_EMERGENCY_POWEROFF_DELAY_MS
;
366 * poweroff_delay_ms must be a carefully profiled positive value.
367 * Its a must for thermal_emergency_poweroff_work to be scheduled
369 if (poweroff_delay_ms
<= 0)
371 schedule_delayed_work(&thermal_emergency_poweroff_work
,
372 msecs_to_jiffies(poweroff_delay_ms
));
375 static void handle_critical_trips(struct thermal_zone_device
*tz
,
376 int trip
, enum thermal_trip_type trip_type
)
380 tz
->ops
->get_trip_temp(tz
, trip
, &trip_temp
);
382 /* If we have not crossed the trip_temp, we do not care. */
383 if (trip_temp
<= 0 || tz
->temperature
< trip_temp
)
386 trace_thermal_zone_trip(tz
, trip
, trip_type
);
389 tz
->ops
->notify(tz
, trip
, trip_type
);
391 if (trip_type
== THERMAL_TRIP_CRITICAL
) {
392 dev_emerg(&tz
->device
,
393 "critical temperature reached(%d C),shutting down\n",
394 tz
->temperature
/ 1000);
395 mutex_lock(&poweroff_lock
);
396 if (!power_off_triggered
) {
398 * Queue a backup emergency shutdown in the event of
399 * orderly_poweroff failure
401 thermal_emergency_poweroff();
402 orderly_poweroff(true);
403 power_off_triggered
= true;
405 mutex_unlock(&poweroff_lock
);
409 static void handle_thermal_trip(struct thermal_zone_device
*tz
, int trip
)
411 enum thermal_trip_type type
;
413 /* Ignore disabled trip points */
414 if (test_bit(trip
, &tz
->trips_disabled
))
417 tz
->ops
->get_trip_type(tz
, trip
, &type
);
419 if (type
== THERMAL_TRIP_CRITICAL
|| type
== THERMAL_TRIP_HOT
)
420 handle_critical_trips(tz
, trip
, type
);
422 handle_non_critical_trips(tz
, trip
, type
);
424 * Alright, we handled this trip successfully.
425 * So, start monitoring again.
427 monitor_thermal_zone(tz
);
430 static void update_temperature(struct thermal_zone_device
*tz
)
434 ret
= thermal_zone_get_temp(tz
, &temp
);
437 dev_warn(&tz
->device
,
438 "failed to read out thermal zone (%d)\n",
443 mutex_lock(&tz
->lock
);
444 tz
->last_temperature
= tz
->temperature
;
445 tz
->temperature
= temp
;
446 mutex_unlock(&tz
->lock
);
448 trace_thermal_temperature(tz
);
449 if (tz
->last_temperature
== THERMAL_TEMP_INVALID
)
450 dev_dbg(&tz
->device
, "last_temperature N/A, current_temperature=%d\n",
453 dev_dbg(&tz
->device
, "last_temperature=%d, current_temperature=%d\n",
454 tz
->last_temperature
, tz
->temperature
);
457 static void thermal_zone_device_reset(struct thermal_zone_device
*tz
)
459 struct thermal_instance
*pos
;
461 tz
->temperature
= THERMAL_TEMP_INVALID
;
463 list_for_each_entry(pos
, &tz
->thermal_instances
, tz_node
)
464 pos
->initialized
= false;
467 void thermal_zone_device_update(struct thermal_zone_device
*tz
,
468 enum thermal_notify_event event
)
472 if (atomic_read(&in_suspend
))
475 if (!tz
->ops
->get_temp
)
478 update_temperature(tz
);
480 thermal_zone_set_trips(tz
);
482 tz
->notify_event
= event
;
484 for (count
= 0; count
< tz
->trips
; count
++)
485 handle_thermal_trip(tz
, count
);
487 EXPORT_SYMBOL_GPL(thermal_zone_device_update
);
490 * thermal_notify_framework - Sensor drivers use this API to notify framework
491 * @tz: thermal zone device
492 * @trip: indicates which trip point has been crossed
494 * This function handles the trip events from sensor drivers. It starts
495 * throttling the cooling devices according to the policy configured.
496 * For CRITICAL and HOT trip points, this notifies the respective drivers,
497 * and does actual throttling for other trip points i.e ACTIVE and PASSIVE.
498 * The throttling policy is based on the configured platform data; if no
499 * platform data is provided, this uses the step_wise throttling policy.
501 void thermal_notify_framework(struct thermal_zone_device
*tz
, int trip
)
503 handle_thermal_trip(tz
, trip
);
505 EXPORT_SYMBOL_GPL(thermal_notify_framework
);
507 static void thermal_zone_device_check(struct work_struct
*work
)
509 struct thermal_zone_device
*tz
= container_of(work
, struct
512 thermal_zone_device_update(tz
, THERMAL_EVENT_UNSPECIFIED
);
516 * Power actor section: interface to power actors to estimate power
518 * Set of functions used to interact to cooling devices that know
519 * how to estimate their devices power consumption.
523 * power_actor_get_max_power() - get the maximum power that a cdev can consume
524 * @cdev: pointer to &thermal_cooling_device
525 * @tz: a valid thermal zone device pointer
526 * @max_power: pointer in which to store the maximum power
528 * Calculate the maximum power consumption in milliwats that the
529 * cooling device can currently consume and store it in @max_power.
531 * Return: 0 on success, -EINVAL if @cdev doesn't support the
532 * power_actor API or -E* on other error.
534 int power_actor_get_max_power(struct thermal_cooling_device
*cdev
,
535 struct thermal_zone_device
*tz
, u32
*max_power
)
537 if (!cdev_is_power_actor(cdev
))
540 return cdev
->ops
->state2power(cdev
, tz
, 0, max_power
);
544 * power_actor_get_min_power() - get the mainimum power that a cdev can consume
545 * @cdev: pointer to &thermal_cooling_device
546 * @tz: a valid thermal zone device pointer
547 * @min_power: pointer in which to store the minimum power
549 * Calculate the minimum power consumption in milliwatts that the
550 * cooling device can currently consume and store it in @min_power.
552 * Return: 0 on success, -EINVAL if @cdev doesn't support the
553 * power_actor API or -E* on other error.
555 int power_actor_get_min_power(struct thermal_cooling_device
*cdev
,
556 struct thermal_zone_device
*tz
, u32
*min_power
)
558 unsigned long max_state
;
561 if (!cdev_is_power_actor(cdev
))
564 ret
= cdev
->ops
->get_max_state(cdev
, &max_state
);
568 return cdev
->ops
->state2power(cdev
, tz
, max_state
, min_power
);
572 * power_actor_set_power() - limit the maximum power a cooling device consumes
573 * @cdev: pointer to &thermal_cooling_device
574 * @instance: thermal instance to update
575 * @power: the power in milliwatts
577 * Set the cooling device to consume at most @power milliwatts. The limit is
578 * expected to be a cap at the maximum power consumption.
580 * Return: 0 on success, -EINVAL if the cooling device does not
581 * implement the power actor API or -E* for other failures.
583 int power_actor_set_power(struct thermal_cooling_device
*cdev
,
584 struct thermal_instance
*instance
, u32 power
)
589 if (!cdev_is_power_actor(cdev
))
592 ret
= cdev
->ops
->power2state(cdev
, instance
->tz
, power
, &state
);
596 instance
->target
= state
;
597 mutex_lock(&cdev
->lock
);
598 cdev
->updated
= false;
599 mutex_unlock(&cdev
->lock
);
600 thermal_cdev_update(cdev
);
605 void thermal_zone_device_rebind_exception(struct thermal_zone_device
*tz
,
606 const char *cdev_type
, size_t size
)
608 struct thermal_cooling_device
*cdev
= NULL
;
610 mutex_lock(&thermal_list_lock
);
611 list_for_each_entry(cdev
, &thermal_cdev_list
, node
) {
612 /* skip non matching cdevs */
613 if (strncmp(cdev_type
, cdev
->type
, size
))
616 /* re binding the exception matching the type pattern */
617 thermal_zone_bind_cooling_device(tz
, THERMAL_TRIPS_NONE
, cdev
,
620 THERMAL_WEIGHT_DEFAULT
);
622 mutex_unlock(&thermal_list_lock
);
625 void thermal_zone_device_unbind_exception(struct thermal_zone_device
*tz
,
626 const char *cdev_type
, size_t size
)
628 struct thermal_cooling_device
*cdev
= NULL
;
630 mutex_lock(&thermal_list_lock
);
631 list_for_each_entry(cdev
, &thermal_cdev_list
, node
) {
632 /* skip non matching cdevs */
633 if (strncmp(cdev_type
, cdev
->type
, size
))
635 /* unbinding the exception matching the type pattern */
636 thermal_zone_unbind_cooling_device(tz
, THERMAL_TRIPS_NONE
,
639 mutex_unlock(&thermal_list_lock
);
643 * Device management section: cooling devices, zones devices, and binding
645 * Set of functions provided by the thermal core for:
646 * - cooling devices lifecycle: registration, unregistration,
647 * binding, and unbinding.
648 * - thermal zone devices lifecycle: registration, unregistration,
649 * binding, and unbinding.
653 * thermal_zone_bind_cooling_device() - bind a cooling device to a thermal zone
654 * @tz: pointer to struct thermal_zone_device
655 * @trip: indicates which trip point the cooling devices is
656 * associated with in this thermal zone.
657 * @cdev: pointer to struct thermal_cooling_device
658 * @upper: the Maximum cooling state for this trip point.
659 * THERMAL_NO_LIMIT means no upper limit,
660 * and the cooling device can be in max_state.
661 * @lower: the Minimum cooling state can be used for this trip point.
662 * THERMAL_NO_LIMIT means no lower limit,
663 * and the cooling device can be in cooling state 0.
664 * @weight: The weight of the cooling device to be bound to the
665 * thermal zone. Use THERMAL_WEIGHT_DEFAULT for the
668 * This interface function bind a thermal cooling device to the certain trip
669 * point of a thermal zone device.
670 * This function is usually called in the thermal zone device .bind callback.
672 * Return: 0 on success, the proper error value otherwise.
674 int thermal_zone_bind_cooling_device(struct thermal_zone_device
*tz
,
676 struct thermal_cooling_device
*cdev
,
677 unsigned long upper
, unsigned long lower
,
680 struct thermal_instance
*dev
;
681 struct thermal_instance
*pos
;
682 struct thermal_zone_device
*pos1
;
683 struct thermal_cooling_device
*pos2
;
684 unsigned long max_state
;
687 if (trip
>= tz
->trips
|| (trip
< 0 && trip
!= THERMAL_TRIPS_NONE
))
690 list_for_each_entry(pos1
, &thermal_tz_list
, node
) {
694 list_for_each_entry(pos2
, &thermal_cdev_list
, node
) {
699 if (tz
!= pos1
|| cdev
!= pos2
)
702 ret
= cdev
->ops
->get_max_state(cdev
, &max_state
);
706 /* lower default 0, upper default max_state */
707 lower
= lower
== THERMAL_NO_LIMIT
? 0 : lower
;
708 upper
= upper
== THERMAL_NO_LIMIT
? max_state
: upper
;
710 if (lower
> upper
|| upper
> max_state
)
713 dev
= kzalloc(sizeof(*dev
), GFP_KERNEL
);
721 dev
->target
= THERMAL_NO_TARGET
;
722 dev
->weight
= weight
;
724 result
= ida_simple_get(&tz
->ida
, 0, 0, GFP_KERNEL
);
729 sprintf(dev
->name
, "cdev%d", dev
->id
);
731 sysfs_create_link(&tz
->device
.kobj
, &cdev
->device
.kobj
, dev
->name
);
735 sprintf(dev
->attr_name
, "cdev%d_trip_point", dev
->id
);
736 sysfs_attr_init(&dev
->attr
.attr
);
737 dev
->attr
.attr
.name
= dev
->attr_name
;
738 dev
->attr
.attr
.mode
= 0444;
739 dev
->attr
.show
= thermal_cooling_device_trip_point_show
;
740 result
= device_create_file(&tz
->device
, &dev
->attr
);
742 goto remove_symbol_link
;
744 sprintf(dev
->weight_attr_name
, "cdev%d_weight", dev
->id
);
745 sysfs_attr_init(&dev
->weight_attr
.attr
);
746 dev
->weight_attr
.attr
.name
= dev
->weight_attr_name
;
747 dev
->weight_attr
.attr
.mode
= S_IWUSR
| S_IRUGO
;
748 dev
->weight_attr
.show
= thermal_cooling_device_weight_show
;
749 dev
->weight_attr
.store
= thermal_cooling_device_weight_store
;
750 result
= device_create_file(&tz
->device
, &dev
->weight_attr
);
752 goto remove_trip_file
;
754 mutex_lock(&tz
->lock
);
755 mutex_lock(&cdev
->lock
);
756 list_for_each_entry(pos
, &tz
->thermal_instances
, tz_node
)
757 if (pos
->tz
== tz
&& pos
->trip
== trip
&& pos
->cdev
== cdev
) {
762 list_add_tail(&dev
->tz_node
, &tz
->thermal_instances
);
763 list_add_tail(&dev
->cdev_node
, &cdev
->thermal_instances
);
764 atomic_set(&tz
->need_update
, 1);
766 mutex_unlock(&cdev
->lock
);
767 mutex_unlock(&tz
->lock
);
772 device_remove_file(&tz
->device
, &dev
->weight_attr
);
774 device_remove_file(&tz
->device
, &dev
->attr
);
776 sysfs_remove_link(&tz
->device
.kobj
, dev
->name
);
778 ida_simple_remove(&tz
->ida
, dev
->id
);
783 EXPORT_SYMBOL_GPL(thermal_zone_bind_cooling_device
);
786 * thermal_zone_unbind_cooling_device() - unbind a cooling device from a
788 * @tz: pointer to a struct thermal_zone_device.
789 * @trip: indicates which trip point the cooling devices is
790 * associated with in this thermal zone.
791 * @cdev: pointer to a struct thermal_cooling_device.
793 * This interface function unbind a thermal cooling device from the certain
794 * trip point of a thermal zone device.
795 * This function is usually called in the thermal zone device .unbind callback.
797 * Return: 0 on success, the proper error value otherwise.
799 int thermal_zone_unbind_cooling_device(struct thermal_zone_device
*tz
,
801 struct thermal_cooling_device
*cdev
)
803 struct thermal_instance
*pos
, *next
;
805 mutex_lock(&tz
->lock
);
806 mutex_lock(&cdev
->lock
);
807 list_for_each_entry_safe(pos
, next
, &tz
->thermal_instances
, tz_node
) {
808 if (pos
->tz
== tz
&& pos
->trip
== trip
&& pos
->cdev
== cdev
) {
809 list_del(&pos
->tz_node
);
810 list_del(&pos
->cdev_node
);
811 mutex_unlock(&cdev
->lock
);
812 mutex_unlock(&tz
->lock
);
816 mutex_unlock(&cdev
->lock
);
817 mutex_unlock(&tz
->lock
);
822 device_remove_file(&tz
->device
, &pos
->weight_attr
);
823 device_remove_file(&tz
->device
, &pos
->attr
);
824 sysfs_remove_link(&tz
->device
.kobj
, pos
->name
);
825 ida_simple_remove(&tz
->ida
, pos
->id
);
829 EXPORT_SYMBOL_GPL(thermal_zone_unbind_cooling_device
);
831 static void thermal_release(struct device
*dev
)
833 struct thermal_zone_device
*tz
;
834 struct thermal_cooling_device
*cdev
;
836 if (!strncmp(dev_name(dev
), "thermal_zone",
837 sizeof("thermal_zone") - 1)) {
838 tz
= to_thermal_zone(dev
);
839 kfree(tz
->trip_type_attrs
);
840 kfree(tz
->trip_temp_attrs
);
841 kfree(tz
->trip_hyst_attrs
);
842 kfree(tz
->trips_attribute_group
.attrs
);
843 kfree(tz
->device
.groups
);
845 } else if (!strncmp(dev_name(dev
), "cooling_device",
846 sizeof("cooling_device") - 1)) {
847 cdev
= to_cooling_device(dev
);
852 static struct class thermal_class
= {
854 .dev_release
= thermal_release
,
858 void print_bind_err_msg(struct thermal_zone_device
*tz
,
859 struct thermal_cooling_device
*cdev
, int ret
)
861 dev_err(&tz
->device
, "binding zone %s with cdev %s failed:%d\n",
862 tz
->type
, cdev
->type
, ret
);
865 static void __bind(struct thermal_zone_device
*tz
, int mask
,
866 struct thermal_cooling_device
*cdev
,
867 unsigned long *limits
,
872 for (i
= 0; i
< tz
->trips
; i
++) {
873 if (mask
& (1 << i
)) {
874 unsigned long upper
, lower
;
876 upper
= THERMAL_NO_LIMIT
;
877 lower
= THERMAL_NO_LIMIT
;
879 lower
= limits
[i
* 2];
880 upper
= limits
[i
* 2 + 1];
882 ret
= thermal_zone_bind_cooling_device(tz
, i
, cdev
,
886 print_bind_err_msg(tz
, cdev
, ret
);
891 static void bind_cdev(struct thermal_cooling_device
*cdev
)
894 const struct thermal_zone_params
*tzp
;
895 struct thermal_zone_device
*pos
= NULL
;
897 mutex_lock(&thermal_list_lock
);
899 list_for_each_entry(pos
, &thermal_tz_list
, node
) {
900 if (!pos
->tzp
&& !pos
->ops
->bind
)
903 if (pos
->ops
->bind
) {
904 ret
= pos
->ops
->bind(pos
, cdev
);
906 print_bind_err_msg(pos
, cdev
, ret
);
911 if (!tzp
|| !tzp
->tbp
)
914 for (i
= 0; i
< tzp
->num_tbps
; i
++) {
915 if (tzp
->tbp
[i
].cdev
|| !tzp
->tbp
[i
].match
)
917 if (tzp
->tbp
[i
].match(pos
, cdev
))
919 tzp
->tbp
[i
].cdev
= cdev
;
920 __bind(pos
, tzp
->tbp
[i
].trip_mask
, cdev
,
921 tzp
->tbp
[i
].binding_limits
,
926 mutex_unlock(&thermal_list_lock
);
930 * __thermal_cooling_device_register() - register a new thermal cooling device
931 * @np: a pointer to a device tree node.
932 * @type: the thermal cooling device type.
933 * @devdata: device private data.
934 * @ops: standard thermal cooling devices callbacks.
936 * This interface function adds a new thermal cooling device (fan/processor/...)
937 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
938 * to all the thermal zone devices registered at the same time.
939 * It also gives the opportunity to link the cooling device to a device tree
940 * node, so that it can be bound to a thermal zone created out of device tree.
942 * Return: a pointer to the created struct thermal_cooling_device or an
943 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
945 static struct thermal_cooling_device
*
946 __thermal_cooling_device_register(struct device_node
*np
,
947 char *type
, void *devdata
,
948 const struct thermal_cooling_device_ops
*ops
)
950 struct thermal_cooling_device
*cdev
;
951 struct thermal_zone_device
*pos
= NULL
;
954 if (type
&& strlen(type
) >= THERMAL_NAME_LENGTH
)
955 return ERR_PTR(-EINVAL
);
957 if (!ops
|| !ops
->get_max_state
|| !ops
->get_cur_state
||
959 return ERR_PTR(-EINVAL
);
961 cdev
= kzalloc(sizeof(*cdev
), GFP_KERNEL
);
963 return ERR_PTR(-ENOMEM
);
965 result
= ida_simple_get(&thermal_cdev_ida
, 0, 0, GFP_KERNEL
);
968 return ERR_PTR(result
);
972 strlcpy(cdev
->type
, type
? : "", sizeof(cdev
->type
));
973 mutex_init(&cdev
->lock
);
974 INIT_LIST_HEAD(&cdev
->thermal_instances
);
977 cdev
->updated
= false;
978 cdev
->device
.class = &thermal_class
;
979 thermal_cooling_device_setup_sysfs(cdev
);
980 cdev
->devdata
= devdata
;
981 dev_set_name(&cdev
->device
, "cooling_device%d", cdev
->id
);
982 result
= device_register(&cdev
->device
);
984 ida_simple_remove(&thermal_cdev_ida
, cdev
->id
);
986 return ERR_PTR(result
);
989 /* Add 'this' new cdev to the global cdev list */
990 mutex_lock(&thermal_list_lock
);
991 list_add(&cdev
->node
, &thermal_cdev_list
);
992 mutex_unlock(&thermal_list_lock
);
994 /* Update binding information for 'this' new cdev */
997 mutex_lock(&thermal_list_lock
);
998 list_for_each_entry(pos
, &thermal_tz_list
, node
)
999 if (atomic_cmpxchg(&pos
->need_update
, 1, 0))
1000 thermal_zone_device_update(pos
,
1001 THERMAL_EVENT_UNSPECIFIED
);
1002 mutex_unlock(&thermal_list_lock
);
1008 * thermal_cooling_device_register() - register a new thermal cooling device
1009 * @type: the thermal cooling device type.
1010 * @devdata: device private data.
1011 * @ops: standard thermal cooling devices callbacks.
1013 * This interface function adds a new thermal cooling device (fan/processor/...)
1014 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1015 * to all the thermal zone devices registered at the same time.
1017 * Return: a pointer to the created struct thermal_cooling_device or an
1018 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1020 struct thermal_cooling_device
*
1021 thermal_cooling_device_register(char *type
, void *devdata
,
1022 const struct thermal_cooling_device_ops
*ops
)
1024 return __thermal_cooling_device_register(NULL
, type
, devdata
, ops
);
1026 EXPORT_SYMBOL_GPL(thermal_cooling_device_register
);
1029 * thermal_of_cooling_device_register() - register an OF thermal cooling device
1030 * @np: a pointer to a device tree node.
1031 * @type: the thermal cooling device type.
1032 * @devdata: device private data.
1033 * @ops: standard thermal cooling devices callbacks.
1035 * This function will register a cooling device with device tree node reference.
1036 * This interface function adds a new thermal cooling device (fan/processor/...)
1037 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1038 * to all the thermal zone devices registered at the same time.
1040 * Return: a pointer to the created struct thermal_cooling_device or an
1041 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1043 struct thermal_cooling_device
*
1044 thermal_of_cooling_device_register(struct device_node
*np
,
1045 char *type
, void *devdata
,
1046 const struct thermal_cooling_device_ops
*ops
)
1048 return __thermal_cooling_device_register(np
, type
, devdata
, ops
);
1050 EXPORT_SYMBOL_GPL(thermal_of_cooling_device_register
);
1052 static void __unbind(struct thermal_zone_device
*tz
, int mask
,
1053 struct thermal_cooling_device
*cdev
)
1057 for (i
= 0; i
< tz
->trips
; i
++)
1058 if (mask
& (1 << i
))
1059 thermal_zone_unbind_cooling_device(tz
, i
, cdev
);
1063 * thermal_cooling_device_unregister - removes a thermal cooling device
1064 * @cdev: the thermal cooling device to remove.
1066 * thermal_cooling_device_unregister() must be called when a registered
1067 * thermal cooling device is no longer needed.
1069 void thermal_cooling_device_unregister(struct thermal_cooling_device
*cdev
)
1072 const struct thermal_zone_params
*tzp
;
1073 struct thermal_zone_device
*tz
;
1074 struct thermal_cooling_device
*pos
= NULL
;
1079 mutex_lock(&thermal_list_lock
);
1080 list_for_each_entry(pos
, &thermal_cdev_list
, node
)
1084 /* thermal cooling device not found */
1085 mutex_unlock(&thermal_list_lock
);
1088 list_del(&cdev
->node
);
1090 /* Unbind all thermal zones associated with 'this' cdev */
1091 list_for_each_entry(tz
, &thermal_tz_list
, node
) {
1092 if (tz
->ops
->unbind
) {
1093 tz
->ops
->unbind(tz
, cdev
);
1097 if (!tz
->tzp
|| !tz
->tzp
->tbp
)
1101 for (i
= 0; i
< tzp
->num_tbps
; i
++) {
1102 if (tzp
->tbp
[i
].cdev
== cdev
) {
1103 __unbind(tz
, tzp
->tbp
[i
].trip_mask
, cdev
);
1104 tzp
->tbp
[i
].cdev
= NULL
;
1109 mutex_unlock(&thermal_list_lock
);
1111 ida_simple_remove(&thermal_cdev_ida
, cdev
->id
);
1112 device_unregister(&cdev
->device
);
1114 EXPORT_SYMBOL_GPL(thermal_cooling_device_unregister
);
1116 static void bind_tz(struct thermal_zone_device
*tz
)
1119 struct thermal_cooling_device
*pos
= NULL
;
1120 const struct thermal_zone_params
*tzp
= tz
->tzp
;
1122 if (!tzp
&& !tz
->ops
->bind
)
1125 mutex_lock(&thermal_list_lock
);
1127 /* If there is ops->bind, try to use ops->bind */
1128 if (tz
->ops
->bind
) {
1129 list_for_each_entry(pos
, &thermal_cdev_list
, node
) {
1130 ret
= tz
->ops
->bind(tz
, pos
);
1132 print_bind_err_msg(tz
, pos
, ret
);
1137 if (!tzp
|| !tzp
->tbp
)
1140 list_for_each_entry(pos
, &thermal_cdev_list
, node
) {
1141 for (i
= 0; i
< tzp
->num_tbps
; i
++) {
1142 if (tzp
->tbp
[i
].cdev
|| !tzp
->tbp
[i
].match
)
1144 if (tzp
->tbp
[i
].match(tz
, pos
))
1146 tzp
->tbp
[i
].cdev
= pos
;
1147 __bind(tz
, tzp
->tbp
[i
].trip_mask
, pos
,
1148 tzp
->tbp
[i
].binding_limits
,
1149 tzp
->tbp
[i
].weight
);
1153 mutex_unlock(&thermal_list_lock
);
1157 * thermal_zone_device_register() - register a new thermal zone device
1158 * @type: the thermal zone device type
1159 * @trips: the number of trip points the thermal zone support
1160 * @mask: a bit string indicating the writeablility of trip points
1161 * @devdata: private device data
1162 * @ops: standard thermal zone device callbacks
1163 * @tzp: thermal zone platform parameters
1164 * @passive_delay: number of milliseconds to wait between polls when
1165 * performing passive cooling
1166 * @polling_delay: number of milliseconds to wait between polls when checking
1167 * whether trip points have been crossed (0 for interrupt
1170 * This interface function adds a new thermal zone device (sensor) to
1171 * /sys/class/thermal folder as thermal_zone[0-*]. It tries to bind all the
1172 * thermal cooling devices registered at the same time.
1173 * thermal_zone_device_unregister() must be called when the device is no
1174 * longer needed. The passive cooling depends on the .get_trend() return value.
1176 * Return: a pointer to the created struct thermal_zone_device or an
1177 * in case of error, an ERR_PTR. Caller must check return value with
1178 * IS_ERR*() helpers.
1180 struct thermal_zone_device
*
1181 thermal_zone_device_register(const char *type
, int trips
, int mask
,
1182 void *devdata
, struct thermal_zone_device_ops
*ops
,
1183 struct thermal_zone_params
*tzp
, int passive_delay
,
1186 struct thermal_zone_device
*tz
;
1187 enum thermal_trip_type trip_type
;
1191 struct thermal_governor
*governor
;
1193 if (!type
|| strlen(type
) == 0)
1194 return ERR_PTR(-EINVAL
);
1196 if (type
&& strlen(type
) >= THERMAL_NAME_LENGTH
)
1197 return ERR_PTR(-EINVAL
);
1199 if (trips
> THERMAL_MAX_TRIPS
|| trips
< 0 || mask
>> trips
)
1200 return ERR_PTR(-EINVAL
);
1203 return ERR_PTR(-EINVAL
);
1205 if (trips
> 0 && (!ops
->get_trip_type
|| !ops
->get_trip_temp
))
1206 return ERR_PTR(-EINVAL
);
1208 tz
= kzalloc(sizeof(*tz
), GFP_KERNEL
);
1210 return ERR_PTR(-ENOMEM
);
1212 INIT_LIST_HEAD(&tz
->thermal_instances
);
1214 mutex_init(&tz
->lock
);
1215 result
= ida_simple_get(&thermal_tz_ida
, 0, 0, GFP_KERNEL
);
1218 return ERR_PTR(result
);
1222 strlcpy(tz
->type
, type
, sizeof(tz
->type
));
1225 tz
->device
.class = &thermal_class
;
1226 tz
->devdata
= devdata
;
1228 tz
->passive_delay
= passive_delay
;
1229 tz
->polling_delay
= polling_delay
;
1232 /* Add nodes that are always present via .groups */
1233 result
= thermal_zone_create_device_groups(tz
, mask
);
1237 /* A new thermal zone needs to be updated anyway. */
1238 atomic_set(&tz
->need_update
, 1);
1240 dev_set_name(&tz
->device
, "thermal_zone%d", tz
->id
);
1241 result
= device_register(&tz
->device
);
1243 ida_simple_remove(&thermal_tz_ida
, tz
->id
);
1245 return ERR_PTR(result
);
1248 for (count
= 0; count
< trips
; count
++) {
1249 if (tz
->ops
->get_trip_type(tz
, count
, &trip_type
))
1250 set_bit(count
, &tz
->trips_disabled
);
1251 if (tz
->ops
->get_trip_temp(tz
, count
, &trip_temp
))
1252 set_bit(count
, &tz
->trips_disabled
);
1253 /* Check for bogus trip points */
1255 set_bit(count
, &tz
->trips_disabled
);
1258 /* Update 'this' zone's governor information */
1259 mutex_lock(&thermal_governor_lock
);
1262 governor
= __find_governor(tz
->tzp
->governor_name
);
1264 governor
= def_governor
;
1266 result
= thermal_set_governor(tz
, governor
);
1268 mutex_unlock(&thermal_governor_lock
);
1272 mutex_unlock(&thermal_governor_lock
);
1274 if (!tz
->tzp
|| !tz
->tzp
->no_hwmon
) {
1275 result
= thermal_add_hwmon_sysfs(tz
);
1280 mutex_lock(&thermal_list_lock
);
1281 list_add_tail(&tz
->node
, &thermal_tz_list
);
1282 mutex_unlock(&thermal_list_lock
);
1284 /* Bind cooling devices for this zone */
1287 INIT_DELAYED_WORK(&tz
->poll_queue
, thermal_zone_device_check
);
1289 thermal_zone_device_reset(tz
);
1290 /* Update the new thermal zone and mark it as already updated. */
1291 if (atomic_cmpxchg(&tz
->need_update
, 1, 0))
1292 thermal_zone_device_update(tz
, THERMAL_EVENT_UNSPECIFIED
);
1297 ida_simple_remove(&thermal_tz_ida
, tz
->id
);
1298 device_unregister(&tz
->device
);
1299 return ERR_PTR(result
);
1301 EXPORT_SYMBOL_GPL(thermal_zone_device_register
);
1304 * thermal_device_unregister - removes the registered thermal zone device
1305 * @tz: the thermal zone device to remove
1307 void thermal_zone_device_unregister(struct thermal_zone_device
*tz
)
1310 const struct thermal_zone_params
*tzp
;
1311 struct thermal_cooling_device
*cdev
;
1312 struct thermal_zone_device
*pos
= NULL
;
1319 mutex_lock(&thermal_list_lock
);
1320 list_for_each_entry(pos
, &thermal_tz_list
, node
)
1324 /* thermal zone device not found */
1325 mutex_unlock(&thermal_list_lock
);
1328 list_del(&tz
->node
);
1330 /* Unbind all cdevs associated with 'this' thermal zone */
1331 list_for_each_entry(cdev
, &thermal_cdev_list
, node
) {
1332 if (tz
->ops
->unbind
) {
1333 tz
->ops
->unbind(tz
, cdev
);
1337 if (!tzp
|| !tzp
->tbp
)
1340 for (i
= 0; i
< tzp
->num_tbps
; i
++) {
1341 if (tzp
->tbp
[i
].cdev
== cdev
) {
1342 __unbind(tz
, tzp
->tbp
[i
].trip_mask
, cdev
);
1343 tzp
->tbp
[i
].cdev
= NULL
;
1348 mutex_unlock(&thermal_list_lock
);
1350 thermal_zone_device_set_polling(tz
, 0);
1352 thermal_set_governor(tz
, NULL
);
1354 thermal_remove_hwmon_sysfs(tz
);
1355 ida_simple_remove(&thermal_tz_ida
, tz
->id
);
1356 ida_destroy(&tz
->ida
);
1357 mutex_destroy(&tz
->lock
);
1358 device_unregister(&tz
->device
);
1360 EXPORT_SYMBOL_GPL(thermal_zone_device_unregister
);
1363 * thermal_zone_get_zone_by_name() - search for a zone and returns its ref
1364 * @name: thermal zone name to fetch the temperature
1366 * When only one zone is found with the passed name, returns a reference to it.
1368 * Return: On success returns a reference to an unique thermal zone with
1369 * matching name equals to @name, an ERR_PTR otherwise (-EINVAL for invalid
1370 * paramenters, -ENODEV for not found and -EEXIST for multiple matches).
1372 struct thermal_zone_device
*thermal_zone_get_zone_by_name(const char *name
)
1374 struct thermal_zone_device
*pos
= NULL
, *ref
= ERR_PTR(-EINVAL
);
1375 unsigned int found
= 0;
1380 mutex_lock(&thermal_list_lock
);
1381 list_for_each_entry(pos
, &thermal_tz_list
, node
)
1382 if (!strncasecmp(name
, pos
->type
, THERMAL_NAME_LENGTH
)) {
1386 mutex_unlock(&thermal_list_lock
);
1388 /* nothing has been found, thus an error code for it */
1390 ref
= ERR_PTR(-ENODEV
);
1392 /* Success only when an unique zone is found */
1393 ref
= ERR_PTR(-EEXIST
);
1398 EXPORT_SYMBOL_GPL(thermal_zone_get_zone_by_name
);
1401 static const struct genl_multicast_group thermal_event_mcgrps
[] = {
1402 { .name
= THERMAL_GENL_MCAST_GROUP_NAME
, },
1405 static struct genl_family thermal_event_genl_family __ro_after_init
= {
1406 .module
= THIS_MODULE
,
1407 .name
= THERMAL_GENL_FAMILY_NAME
,
1408 .version
= THERMAL_GENL_VERSION
,
1409 .maxattr
= THERMAL_GENL_ATTR_MAX
,
1410 .mcgrps
= thermal_event_mcgrps
,
1411 .n_mcgrps
= ARRAY_SIZE(thermal_event_mcgrps
),
1414 int thermal_generate_netlink_event(struct thermal_zone_device
*tz
,
1417 struct sk_buff
*skb
;
1418 struct nlattr
*attr
;
1419 struct thermal_genl_event
*thermal_event
;
1423 static unsigned int thermal_event_seqnum
;
1428 /* allocate memory */
1429 size
= nla_total_size(sizeof(struct thermal_genl_event
)) +
1432 skb
= genlmsg_new(size
, GFP_ATOMIC
);
1436 /* add the genetlink message header */
1437 msg_header
= genlmsg_put(skb
, 0, thermal_event_seqnum
++,
1438 &thermal_event_genl_family
, 0,
1439 THERMAL_GENL_CMD_EVENT
);
1446 attr
= nla_reserve(skb
, THERMAL_GENL_ATTR_EVENT
,
1447 sizeof(struct thermal_genl_event
));
1454 thermal_event
= nla_data(attr
);
1455 if (!thermal_event
) {
1460 memset(thermal_event
, 0, sizeof(struct thermal_genl_event
));
1462 thermal_event
->orig
= tz
->id
;
1463 thermal_event
->event
= event
;
1465 /* send multicast genetlink message */
1466 genlmsg_end(skb
, msg_header
);
1468 result
= genlmsg_multicast(&thermal_event_genl_family
, skb
, 0,
1471 dev_err(&tz
->device
, "Failed to send netlink event:%d", result
);
1475 EXPORT_SYMBOL_GPL(thermal_generate_netlink_event
);
1477 static int __init
genetlink_init(void)
1479 return genl_register_family(&thermal_event_genl_family
);
1482 static void genetlink_exit(void)
1484 genl_unregister_family(&thermal_event_genl_family
);
1486 #else /* !CONFIG_NET */
1487 static inline int genetlink_init(void) { return 0; }
1488 static inline void genetlink_exit(void) {}
1489 #endif /* !CONFIG_NET */
1491 static int thermal_pm_notify(struct notifier_block
*nb
,
1492 unsigned long mode
, void *_unused
)
1494 struct thermal_zone_device
*tz
;
1497 case PM_HIBERNATION_PREPARE
:
1498 case PM_RESTORE_PREPARE
:
1499 case PM_SUSPEND_PREPARE
:
1500 atomic_set(&in_suspend
, 1);
1502 case PM_POST_HIBERNATION
:
1503 case PM_POST_RESTORE
:
1504 case PM_POST_SUSPEND
:
1505 atomic_set(&in_suspend
, 0);
1506 list_for_each_entry(tz
, &thermal_tz_list
, node
) {
1507 thermal_zone_device_reset(tz
);
1508 thermal_zone_device_update(tz
,
1509 THERMAL_EVENT_UNSPECIFIED
);
1518 static struct notifier_block thermal_pm_nb
= {
1519 .notifier_call
= thermal_pm_notify
,
1522 static int __init
thermal_init(void)
1526 mutex_init(&poweroff_lock
);
1527 result
= thermal_register_governors();
1531 result
= class_register(&thermal_class
);
1533 goto unregister_governors
;
1535 result
= genetlink_init();
1537 goto unregister_class
;
1539 result
= of_parse_thermal_zones();
1543 result
= register_pm_notifier(&thermal_pm_nb
);
1545 pr_warn("Thermal: Can not register suspend notifier, return %d\n",
1553 class_unregister(&thermal_class
);
1554 unregister_governors
:
1555 thermal_unregister_governors();
1557 ida_destroy(&thermal_tz_ida
);
1558 ida_destroy(&thermal_cdev_ida
);
1559 mutex_destroy(&thermal_list_lock
);
1560 mutex_destroy(&thermal_governor_lock
);
1561 mutex_destroy(&poweroff_lock
);
1565 static void __exit
thermal_exit(void)
1567 unregister_pm_notifier(&thermal_pm_nb
);
1568 of_thermal_destroy_zones();
1570 class_unregister(&thermal_class
);
1571 thermal_unregister_governors();
1572 ida_destroy(&thermal_tz_ida
);
1573 ida_destroy(&thermal_cdev_ida
);
1574 mutex_destroy(&thermal_list_lock
);
1575 mutex_destroy(&thermal_governor_lock
);
1578 fs_initcall(thermal_init
);
1579 module_exit(thermal_exit
);