Linux Audio

Check our new training course

Loading...
v4.6
 
   1/*
   2 *  thermal.c - Generic Thermal Management Sysfs support.
   3 *
   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>
   7 *
   8 *  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   9 *
  10 *  This program is free software; you can redistribute it and/or modify
  11 *  it under the terms of the GNU General Public License as published by
  12 *  the Free Software Foundation; version 2 of the License.
  13 *
  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.
  18 *
  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.
  22 *
  23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24 */
  25
  26#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  27
  28#include <linux/module.h>
  29#include <linux/device.h>
  30#include <linux/err.h>
  31#include <linux/slab.h>
  32#include <linux/kdev_t.h>
  33#include <linux/idr.h>
  34#include <linux/thermal.h>
  35#include <linux/reboot.h>
  36#include <linux/string.h>
  37#include <linux/of.h>
  38#include <net/netlink.h>
  39#include <net/genetlink.h>
  40#include <linux/suspend.h>
  41
  42#define CREATE_TRACE_POINTS
  43#include <trace/events/thermal.h>
  44
  45#include "thermal_core.h"
  46#include "thermal_hwmon.h"
  47
  48MODULE_AUTHOR("Zhang Rui");
  49MODULE_DESCRIPTION("Generic thermal management sysfs support");
  50MODULE_LICENSE("GPL v2");
  51
  52static DEFINE_IDR(thermal_tz_idr);
  53static DEFINE_IDR(thermal_cdev_idr);
  54static DEFINE_MUTEX(thermal_idr_lock);
  55
  56static LIST_HEAD(thermal_tz_list);
  57static LIST_HEAD(thermal_cdev_list);
  58static LIST_HEAD(thermal_governor_list);
  59
  60static DEFINE_MUTEX(thermal_list_lock);
  61static DEFINE_MUTEX(thermal_governor_lock);
 
  62
  63static atomic_t in_suspend;
 
  64
  65static struct thermal_governor *def_governor;
  66
 
 
 
 
 
 
 
  67static struct thermal_governor *__find_governor(const char *name)
  68{
  69	struct thermal_governor *pos;
  70
  71	if (!name || !name[0])
  72		return def_governor;
  73
  74	list_for_each_entry(pos, &thermal_governor_list, governor_list)
  75		if (!strncasecmp(name, pos->name, THERMAL_NAME_LENGTH))
  76			return pos;
  77
  78	return NULL;
  79}
  80
  81/**
  82 * bind_previous_governor() - bind the previous governor of the thermal zone
  83 * @tz:		a valid pointer to a struct thermal_zone_device
  84 * @failed_gov_name:	the name of the governor that failed to register
  85 *
  86 * Register the previous governor of the thermal zone after a new
  87 * governor has failed to be bound.
  88 */
  89static void bind_previous_governor(struct thermal_zone_device *tz,
  90				   const char *failed_gov_name)
  91{
  92	if (tz->governor && tz->governor->bind_to_tz) {
  93		if (tz->governor->bind_to_tz(tz)) {
  94			dev_err(&tz->device,
  95				"governor %s failed to bind and the previous one (%s) failed to bind again, thermal zone %s has no governor\n",
  96				failed_gov_name, tz->governor->name, tz->type);
  97			tz->governor = NULL;
  98		}
  99	}
 100}
 101
 102/**
 103 * thermal_set_governor() - Switch to another governor
 104 * @tz:		a valid pointer to a struct thermal_zone_device
 105 * @new_gov:	pointer to the new governor
 106 *
 107 * Change the governor of thermal zone @tz.
 108 *
 109 * Return: 0 on success, an error if the new governor's bind_to_tz() failed.
 110 */
 111static int thermal_set_governor(struct thermal_zone_device *tz,
 112				struct thermal_governor *new_gov)
 113{
 114	int ret = 0;
 115
 116	if (tz->governor && tz->governor->unbind_from_tz)
 117		tz->governor->unbind_from_tz(tz);
 118
 119	if (new_gov && new_gov->bind_to_tz) {
 120		ret = new_gov->bind_to_tz(tz);
 121		if (ret) {
 122			bind_previous_governor(tz, new_gov->name);
 123
 124			return ret;
 125		}
 126	}
 127
 128	tz->governor = new_gov;
 129
 130	return ret;
 131}
 132
 133int thermal_register_governor(struct thermal_governor *governor)
 134{
 135	int err;
 136	const char *name;
 137	struct thermal_zone_device *pos;
 138
 139	if (!governor)
 140		return -EINVAL;
 141
 142	mutex_lock(&thermal_governor_lock);
 143
 144	err = -EBUSY;
 145	if (__find_governor(governor->name) == NULL) {
 
 
 146		err = 0;
 147		list_add(&governor->governor_list, &thermal_governor_list);
 148		if (!def_governor && !strncmp(governor->name,
 149			DEFAULT_THERMAL_GOVERNOR, THERMAL_NAME_LENGTH))
 
 
 
 150			def_governor = governor;
 151	}
 152
 153	mutex_lock(&thermal_list_lock);
 154
 155	list_for_each_entry(pos, &thermal_tz_list, node) {
 156		/*
 157		 * only thermal zones with specified tz->tzp->governor_name
 158		 * may run with tz->govenor unset
 159		 */
 160		if (pos->governor)
 161			continue;
 162
 163		name = pos->tzp->governor_name;
 164
 165		if (!strncasecmp(name, governor->name, THERMAL_NAME_LENGTH)) {
 166			int ret;
 167
 168			ret = thermal_set_governor(pos, governor);
 169			if (ret)
 170				dev_err(&pos->device,
 171					"Failed to set governor %s for thermal zone %s: %d\n",
 172					governor->name, pos->type, ret);
 173		}
 174	}
 175
 176	mutex_unlock(&thermal_list_lock);
 177	mutex_unlock(&thermal_governor_lock);
 178
 179	return err;
 180}
 181
 182void thermal_unregister_governor(struct thermal_governor *governor)
 183{
 184	struct thermal_zone_device *pos;
 185
 186	if (!governor)
 187		return;
 188
 189	mutex_lock(&thermal_governor_lock);
 190
 191	if (__find_governor(governor->name) == NULL)
 192		goto exit;
 193
 194	mutex_lock(&thermal_list_lock);
 195
 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);
 200	}
 201
 202	mutex_unlock(&thermal_list_lock);
 203	list_del(&governor->governor_list);
 204exit:
 205	mutex_unlock(&thermal_governor_lock);
 206	return;
 207}
 208
 209static int get_idr(struct idr *idr, struct mutex *lock, int *id)
 
 210{
 211	int ret;
 
 212
 213	if (lock)
 214		mutex_lock(lock);
 215	ret = idr_alloc(idr, NULL, 0, 0, GFP_KERNEL);
 216	if (lock)
 217		mutex_unlock(lock);
 218	if (unlikely(ret < 0))
 219		return ret;
 220	*id = ret;
 221	return 0;
 222}
 223
 224static void release_idr(struct idr *idr, struct mutex *lock, int id)
 225{
 226	if (lock)
 227		mutex_lock(lock);
 228	idr_remove(idr, id);
 229	if (lock)
 230		mutex_unlock(lock);
 231}
 232
 233int get_tz_trend(struct thermal_zone_device *tz, int trip)
 234{
 235	enum thermal_trend trend;
 236
 237	if (tz->emul_temperature || !tz->ops->get_trend ||
 238	    tz->ops->get_trend(tz, trip, &trend)) {
 239		if (tz->temperature > tz->last_temperature)
 240			trend = THERMAL_TREND_RAISING;
 241		else if (tz->temperature < tz->last_temperature)
 242			trend = THERMAL_TREND_DROPPING;
 243		else
 244			trend = THERMAL_TREND_STABLE;
 245	}
 246
 247	return trend;
 248}
 249EXPORT_SYMBOL(get_tz_trend);
 250
 251struct thermal_instance *get_thermal_instance(struct thermal_zone_device *tz,
 252			struct thermal_cooling_device *cdev, int trip)
 253{
 254	struct thermal_instance *pos = NULL;
 255	struct thermal_instance *target_instance = NULL;
 
 256
 257	mutex_lock(&tz->lock);
 258	mutex_lock(&cdev->lock);
 259
 260	list_for_each_entry(pos, &tz->thermal_instances, tz_node) {
 261		if (pos->tz == tz && pos->trip == trip && pos->cdev == cdev) {
 262			target_instance = pos;
 263			break;
 264		}
 265	}
 
 266
 267	mutex_unlock(&cdev->lock);
 268	mutex_unlock(&tz->lock);
 269
 270	return target_instance;
 271}
 272EXPORT_SYMBOL(get_thermal_instance);
 273
 274static void print_bind_err_msg(struct thermal_zone_device *tz,
 275			struct thermal_cooling_device *cdev, int ret)
 276{
 277	dev_err(&tz->device, "binding zone %s with cdev %s failed:%d\n",
 278				tz->type, cdev->type, ret);
 279}
 280
 281static void __bind(struct thermal_zone_device *tz, int mask,
 282			struct thermal_cooling_device *cdev,
 283			unsigned long *limits,
 284			unsigned int weight)
 285{
 286	int i, ret;
 287
 288	for (i = 0; i < tz->trips; i++) {
 289		if (mask & (1 << i)) {
 290			unsigned long upper, lower;
 291
 292			upper = THERMAL_NO_LIMIT;
 293			lower = THERMAL_NO_LIMIT;
 294			if (limits) {
 295				lower = limits[i * 2];
 296				upper = limits[i * 2 + 1];
 297			}
 298			ret = thermal_zone_bind_cooling_device(tz, i, cdev,
 299							       upper, lower,
 300							       weight);
 301			if (ret)
 302				print_bind_err_msg(tz, cdev, ret);
 303		}
 304	}
 305}
 306
 307static void __unbind(struct thermal_zone_device *tz, int mask,
 308			struct thermal_cooling_device *cdev)
 309{
 310	int i;
 311
 312	for (i = 0; i < tz->trips; i++)
 313		if (mask & (1 << i))
 314			thermal_zone_unbind_cooling_device(tz, i, cdev);
 315}
 316
 317static void bind_cdev(struct thermal_cooling_device *cdev)
 318{
 319	int i, ret;
 320	const struct thermal_zone_params *tzp;
 321	struct thermal_zone_device *pos = NULL;
 322
 323	mutex_lock(&thermal_list_lock);
 324
 325	list_for_each_entry(pos, &thermal_tz_list, node) {
 326		if (!pos->tzp && !pos->ops->bind)
 327			continue;
 328
 329		if (pos->ops->bind) {
 330			ret = pos->ops->bind(pos, cdev);
 331			if (ret)
 332				print_bind_err_msg(pos, cdev, ret);
 333			continue;
 
 334		}
 335
 336		tzp = pos->tzp;
 337		if (!tzp || !tzp->tbp)
 338			continue;
 339
 340		for (i = 0; i < tzp->num_tbps; i++) {
 341			if (tzp->tbp[i].cdev || !tzp->tbp[i].match)
 342				continue;
 343			if (tzp->tbp[i].match(pos, cdev))
 344				continue;
 345			tzp->tbp[i].cdev = cdev;
 346			__bind(pos, tzp->tbp[i].trip_mask, cdev,
 347			       tzp->tbp[i].binding_limits,
 348			       tzp->tbp[i].weight);
 349		}
 350	}
 351
 352	mutex_unlock(&thermal_list_lock);
 353}
 354
 355static void bind_tz(struct thermal_zone_device *tz)
 356{
 357	int i, ret;
 358	struct thermal_cooling_device *pos = NULL;
 359	const struct thermal_zone_params *tzp = tz->tzp;
 360
 361	if (!tzp && !tz->ops->bind)
 362		return;
 363
 364	mutex_lock(&thermal_list_lock);
 365
 366	/* If there is ops->bind, try to use ops->bind */
 367	if (tz->ops->bind) {
 368		list_for_each_entry(pos, &thermal_cdev_list, node) {
 369			ret = tz->ops->bind(tz, pos);
 370			if (ret)
 371				print_bind_err_msg(tz, pos, ret);
 372		}
 373		goto exit;
 374	}
 375
 376	if (!tzp || !tzp->tbp)
 377		goto exit;
 378
 379	list_for_each_entry(pos, &thermal_cdev_list, node) {
 380		for (i = 0; i < tzp->num_tbps; i++) {
 381			if (tzp->tbp[i].cdev || !tzp->tbp[i].match)
 382				continue;
 383			if (tzp->tbp[i].match(tz, pos))
 384				continue;
 385			tzp->tbp[i].cdev = pos;
 386			__bind(tz, tzp->tbp[i].trip_mask, pos,
 387			       tzp->tbp[i].binding_limits,
 388			       tzp->tbp[i].weight);
 389		}
 390	}
 391exit:
 392	mutex_unlock(&thermal_list_lock);
 393}
 394
 
 
 
 
 
 
 
 
 
 
 
 395static void thermal_zone_device_set_polling(struct thermal_zone_device *tz,
 396					    int delay)
 397{
 398	if (delay > 1000)
 399		mod_delayed_work(system_freezable_wq, &tz->poll_queue,
 
 400				 round_jiffies(msecs_to_jiffies(delay)));
 401	else if (delay)
 402		mod_delayed_work(system_freezable_wq, &tz->poll_queue,
 
 403				 msecs_to_jiffies(delay));
 404	else
 405		cancel_delayed_work(&tz->poll_queue);
 406}
 407
 408static void monitor_thermal_zone(struct thermal_zone_device *tz)
 409{
 410	mutex_lock(&tz->lock);
 411
 412	if (tz->passive)
 413		thermal_zone_device_set_polling(tz, tz->passive_delay);
 414	else if (tz->polling_delay)
 415		thermal_zone_device_set_polling(tz, tz->polling_delay);
 416	else
 417		thermal_zone_device_set_polling(tz, 0);
 418
 419	mutex_unlock(&tz->lock);
 420}
 421
 422static void handle_non_critical_trips(struct thermal_zone_device *tz,
 423			int trip, enum thermal_trip_type trip_type)
 424{
 425	tz->governor ? tz->governor->throttle(tz, trip) :
 426		       def_governor->throttle(tz, trip);
 427}
 428
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 429static void handle_critical_trips(struct thermal_zone_device *tz,
 430				int trip, enum thermal_trip_type trip_type)
 431{
 432	int trip_temp;
 433
 434	tz->ops->get_trip_temp(tz, trip, &trip_temp);
 435
 436	/* If we have not crossed the trip_temp, we do not care. */
 437	if (trip_temp <= 0 || tz->temperature < trip_temp)
 438		return;
 439
 440	trace_thermal_zone_trip(tz, trip, trip_type);
 441
 442	if (tz->ops->notify)
 443		tz->ops->notify(tz, trip, trip_type);
 444
 445	if (trip_type == THERMAL_TRIP_CRITICAL) {
 446		dev_emerg(&tz->device,
 447			  "critical temperature reached(%d C),shutting down\n",
 448			  tz->temperature / 1000);
 449		orderly_poweroff(true);
 
 
 
 
 
 
 
 
 
 
 450	}
 451}
 452
 453static void handle_thermal_trip(struct thermal_zone_device *tz, int trip)
 454{
 455	enum thermal_trip_type type;
 456
 457	/* Ignore disabled trip points */
 458	if (test_bit(trip, &tz->trips_disabled))
 459		return;
 460
 461	tz->ops->get_trip_type(tz, trip, &type);
 462
 463	if (type == THERMAL_TRIP_CRITICAL || type == THERMAL_TRIP_HOT)
 464		handle_critical_trips(tz, trip, type);
 465	else
 466		handle_non_critical_trips(tz, trip, type);
 467	/*
 468	 * Alright, we handled this trip successfully.
 469	 * So, start monitoring again.
 470	 */
 471	monitor_thermal_zone(tz);
 472}
 473
 474/**
 475 * thermal_zone_get_temp() - returns the temperature of a thermal zone
 476 * @tz: a valid pointer to a struct thermal_zone_device
 477 * @temp: a valid pointer to where to store the resulting temperature.
 478 *
 479 * When a valid thermal zone reference is passed, it will fetch its
 480 * temperature and fill @temp.
 481 *
 482 * Return: On success returns 0, an error code otherwise
 483 */
 484int thermal_zone_get_temp(struct thermal_zone_device *tz, int *temp)
 485{
 486	int ret = -EINVAL;
 487	int count;
 488	int crit_temp = INT_MAX;
 489	enum thermal_trip_type type;
 490
 491	if (!tz || IS_ERR(tz) || !tz->ops->get_temp)
 492		goto exit;
 493
 494	mutex_lock(&tz->lock);
 495
 496	ret = tz->ops->get_temp(tz, temp);
 497
 498	if (IS_ENABLED(CONFIG_THERMAL_EMULATION) && tz->emul_temperature) {
 499		for (count = 0; count < tz->trips; count++) {
 500			ret = tz->ops->get_trip_type(tz, count, &type);
 501			if (!ret && type == THERMAL_TRIP_CRITICAL) {
 502				ret = tz->ops->get_trip_temp(tz, count,
 503						&crit_temp);
 504				break;
 505			}
 506		}
 507
 508		/*
 509		 * Only allow emulating a temperature when the real temperature
 510		 * is below the critical temperature so that the emulation code
 511		 * cannot hide critical conditions.
 512		 */
 513		if (!ret && *temp < crit_temp)
 514			*temp = tz->emul_temperature;
 515	}
 516 
 517	mutex_unlock(&tz->lock);
 518exit:
 519	return ret;
 520}
 521EXPORT_SYMBOL_GPL(thermal_zone_get_temp);
 522
 523static void update_temperature(struct thermal_zone_device *tz)
 524{
 525	int temp, ret;
 526
 527	ret = thermal_zone_get_temp(tz, &temp);
 528	if (ret) {
 529		if (ret != -EAGAIN)
 530			dev_warn(&tz->device,
 531				 "failed to read out thermal zone (%d)\n",
 532				 ret);
 533		return;
 534	}
 535
 536	mutex_lock(&tz->lock);
 537	tz->last_temperature = tz->temperature;
 538	tz->temperature = temp;
 539	mutex_unlock(&tz->lock);
 540
 541	trace_thermal_temperature(tz);
 542	if (tz->last_temperature == THERMAL_TEMP_INVALID)
 543		dev_dbg(&tz->device, "last_temperature N/A, current_temperature=%d\n",
 544			tz->temperature);
 545	else
 546		dev_dbg(&tz->device, "last_temperature=%d, current_temperature=%d\n",
 547			tz->last_temperature, tz->temperature);
 548}
 549
 550static void thermal_zone_device_reset(struct thermal_zone_device *tz)
 551{
 552	struct thermal_instance *pos;
 553
 554	tz->temperature = THERMAL_TEMP_INVALID;
 555	tz->passive = 0;
 556	list_for_each_entry(pos, &tz->thermal_instances, tz_node)
 557		pos->initialized = false;
 558}
 559
 560void thermal_zone_device_update(struct thermal_zone_device *tz)
 
 
 
 
 
 
 
 561{
 562	int count;
 563
 564	if (atomic_read(&in_suspend))
 565		return;
 566
 567	if (!tz->ops->get_temp)
 568		return;
 569
 570	update_temperature(tz);
 571
 
 
 
 
 572	for (count = 0; count < tz->trips; count++)
 573		handle_thermal_trip(tz, count);
 574}
 575EXPORT_SYMBOL_GPL(thermal_zone_device_update);
 576
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 577static void thermal_zone_device_check(struct work_struct *work)
 578{
 579	struct thermal_zone_device *tz = container_of(work, struct
 580						      thermal_zone_device,
 581						      poll_queue.work);
 582	thermal_zone_device_update(tz);
 583}
 584
 585/* sys I/F for thermal zone */
 586
 587#define to_thermal_zone(_dev) \
 588	container_of(_dev, struct thermal_zone_device, device)
 589
 590static ssize_t
 591type_show(struct device *dev, struct device_attribute *attr, char *buf)
 592{
 593	struct thermal_zone_device *tz = to_thermal_zone(dev);
 594
 595	return sprintf(buf, "%s\n", tz->type);
 596}
 597
 598static ssize_t
 599temp_show(struct device *dev, struct device_attribute *attr, char *buf)
 600{
 601	struct thermal_zone_device *tz = to_thermal_zone(dev);
 602	int temperature, ret;
 603
 604	ret = thermal_zone_get_temp(tz, &temperature);
 605
 606	if (ret)
 607		return ret;
 608
 609	return sprintf(buf, "%d\n", temperature);
 610}
 611
 612static ssize_t
 613mode_show(struct device *dev, struct device_attribute *attr, char *buf)
 614{
 615	struct thermal_zone_device *tz = to_thermal_zone(dev);
 616	enum thermal_device_mode mode;
 617	int result;
 618
 619	if (!tz->ops->get_mode)
 620		return -EPERM;
 621
 622	result = tz->ops->get_mode(tz, &mode);
 623	if (result)
 624		return result;
 625
 626	return sprintf(buf, "%s\n", mode == THERMAL_DEVICE_ENABLED ? "enabled"
 627		       : "disabled");
 628}
 629
 630static ssize_t
 631mode_store(struct device *dev, struct device_attribute *attr,
 632	   const char *buf, size_t count)
 633{
 634	struct thermal_zone_device *tz = to_thermal_zone(dev);
 635	int result;
 636
 637	if (!tz->ops->set_mode)
 638		return -EPERM;
 639
 640	if (!strncmp(buf, "enabled", sizeof("enabled") - 1))
 641		result = tz->ops->set_mode(tz, THERMAL_DEVICE_ENABLED);
 642	else if (!strncmp(buf, "disabled", sizeof("disabled") - 1))
 643		result = tz->ops->set_mode(tz, THERMAL_DEVICE_DISABLED);
 644	else
 645		result = -EINVAL;
 646
 647	if (result)
 648		return result;
 649
 650	return count;
 651}
 652
 653static ssize_t
 654trip_point_type_show(struct device *dev, struct device_attribute *attr,
 655		     char *buf)
 656{
 657	struct thermal_zone_device *tz = to_thermal_zone(dev);
 658	enum thermal_trip_type type;
 659	int trip, result;
 660
 661	if (!tz->ops->get_trip_type)
 662		return -EPERM;
 663
 664	if (!sscanf(attr->attr.name, "trip_point_%d_type", &trip))
 665		return -EINVAL;
 666
 667	result = tz->ops->get_trip_type(tz, trip, &type);
 668	if (result)
 669		return result;
 670
 671	switch (type) {
 672	case THERMAL_TRIP_CRITICAL:
 673		return sprintf(buf, "critical\n");
 674	case THERMAL_TRIP_HOT:
 675		return sprintf(buf, "hot\n");
 676	case THERMAL_TRIP_PASSIVE:
 677		return sprintf(buf, "passive\n");
 678	case THERMAL_TRIP_ACTIVE:
 679		return sprintf(buf, "active\n");
 680	default:
 681		return sprintf(buf, "unknown\n");
 682	}
 683}
 684
 685static ssize_t
 686trip_point_temp_store(struct device *dev, struct device_attribute *attr,
 687		     const char *buf, size_t count)
 688{
 689	struct thermal_zone_device *tz = to_thermal_zone(dev);
 690	int trip, ret;
 691	int temperature;
 692
 693	if (!tz->ops->set_trip_temp)
 694		return -EPERM;
 695
 696	if (!sscanf(attr->attr.name, "trip_point_%d_temp", &trip))
 697		return -EINVAL;
 698
 699	if (kstrtoint(buf, 10, &temperature))
 700		return -EINVAL;
 701
 702	ret = tz->ops->set_trip_temp(tz, trip, temperature);
 703	if (ret)
 704		return ret;
 705
 706	thermal_zone_device_update(tz);
 707
 708	return count;
 709}
 710
 711static ssize_t
 712trip_point_temp_show(struct device *dev, struct device_attribute *attr,
 713		     char *buf)
 714{
 715	struct thermal_zone_device *tz = to_thermal_zone(dev);
 716	int trip, ret;
 717	int temperature;
 718
 719	if (!tz->ops->get_trip_temp)
 720		return -EPERM;
 721
 722	if (!sscanf(attr->attr.name, "trip_point_%d_temp", &trip))
 723		return -EINVAL;
 724
 725	ret = tz->ops->get_trip_temp(tz, trip, &temperature);
 726
 727	if (ret)
 728		return ret;
 729
 730	return sprintf(buf, "%d\n", temperature);
 731}
 732
 733static ssize_t
 734trip_point_hyst_store(struct device *dev, struct device_attribute *attr,
 735			const char *buf, size_t count)
 736{
 737	struct thermal_zone_device *tz = to_thermal_zone(dev);
 738	int trip, ret;
 739	int temperature;
 740
 741	if (!tz->ops->set_trip_hyst)
 742		return -EPERM;
 743
 744	if (!sscanf(attr->attr.name, "trip_point_%d_hyst", &trip))
 745		return -EINVAL;
 746
 747	if (kstrtoint(buf, 10, &temperature))
 748		return -EINVAL;
 749
 750	/*
 751	 * We are not doing any check on the 'temperature' value
 752	 * here. The driver implementing 'set_trip_hyst' has to
 753	 * take care of this.
 754	 */
 755	ret = tz->ops->set_trip_hyst(tz, trip, temperature);
 756
 757	return ret ? ret : count;
 758}
 759
 760static ssize_t
 761trip_point_hyst_show(struct device *dev, struct device_attribute *attr,
 762			char *buf)
 763{
 764	struct thermal_zone_device *tz = to_thermal_zone(dev);
 765	int trip, ret;
 766	int temperature;
 767
 768	if (!tz->ops->get_trip_hyst)
 769		return -EPERM;
 770
 771	if (!sscanf(attr->attr.name, "trip_point_%d_hyst", &trip))
 772		return -EINVAL;
 773
 774	ret = tz->ops->get_trip_hyst(tz, trip, &temperature);
 775
 776	return ret ? ret : sprintf(buf, "%d\n", temperature);
 777}
 778
 779static ssize_t
 780passive_store(struct device *dev, struct device_attribute *attr,
 781		    const char *buf, size_t count)
 782{
 783	struct thermal_zone_device *tz = to_thermal_zone(dev);
 784	struct thermal_cooling_device *cdev = NULL;
 785	int state;
 786
 787	if (!sscanf(buf, "%d\n", &state))
 788		return -EINVAL;
 789
 790	/* sanity check: values below 1000 millicelcius don't make sense
 791	 * and can cause the system to go into a thermal heart attack
 792	 */
 793	if (state && state < 1000)
 794		return -EINVAL;
 795
 796	if (state && !tz->forced_passive) {
 797		mutex_lock(&thermal_list_lock);
 798		list_for_each_entry(cdev, &thermal_cdev_list, node) {
 799			if (!strncmp("Processor", cdev->type,
 800				     sizeof("Processor")))
 801				thermal_zone_bind_cooling_device(tz,
 802						THERMAL_TRIPS_NONE, cdev,
 803						THERMAL_NO_LIMIT,
 804						THERMAL_NO_LIMIT,
 805						THERMAL_WEIGHT_DEFAULT);
 806		}
 807		mutex_unlock(&thermal_list_lock);
 808		if (!tz->passive_delay)
 809			tz->passive_delay = 1000;
 810	} else if (!state && tz->forced_passive) {
 811		mutex_lock(&thermal_list_lock);
 812		list_for_each_entry(cdev, &thermal_cdev_list, node) {
 813			if (!strncmp("Processor", cdev->type,
 814				     sizeof("Processor")))
 815				thermal_zone_unbind_cooling_device(tz,
 816								   THERMAL_TRIPS_NONE,
 817								   cdev);
 818		}
 819		mutex_unlock(&thermal_list_lock);
 820		tz->passive_delay = 0;
 821	}
 822
 823	tz->forced_passive = state;
 824
 825	thermal_zone_device_update(tz);
 826
 827	return count;
 828}
 829
 830static ssize_t
 831passive_show(struct device *dev, struct device_attribute *attr,
 832		   char *buf)
 833{
 834	struct thermal_zone_device *tz = to_thermal_zone(dev);
 835
 836	return sprintf(buf, "%d\n", tz->forced_passive);
 837}
 838
 839static ssize_t
 840policy_store(struct device *dev, struct device_attribute *attr,
 841		    const char *buf, size_t count)
 842{
 843	int ret = -EINVAL;
 844	struct thermal_zone_device *tz = to_thermal_zone(dev);
 845	struct thermal_governor *gov;
 846	char name[THERMAL_NAME_LENGTH];
 847
 848	snprintf(name, sizeof(name), "%s", buf);
 849
 850	mutex_lock(&thermal_governor_lock);
 851	mutex_lock(&tz->lock);
 852
 853	gov = __find_governor(strim(name));
 854	if (!gov)
 855		goto exit;
 856
 857	ret = thermal_set_governor(tz, gov);
 858	if (!ret)
 859		ret = count;
 860
 861exit:
 862	mutex_unlock(&tz->lock);
 863	mutex_unlock(&thermal_governor_lock);
 864	return ret;
 865}
 866
 867static ssize_t
 868policy_show(struct device *dev, struct device_attribute *devattr, char *buf)
 869{
 870	struct thermal_zone_device *tz = to_thermal_zone(dev);
 871
 872	return sprintf(buf, "%s\n", tz->governor->name);
 873}
 874
 875static ssize_t
 876available_policies_show(struct device *dev, struct device_attribute *devattr,
 877			char *buf)
 878{
 879	struct thermal_governor *pos;
 880	ssize_t count = 0;
 881	ssize_t size = PAGE_SIZE;
 882
 883	mutex_lock(&thermal_governor_lock);
 884
 885	list_for_each_entry(pos, &thermal_governor_list, governor_list) {
 886		size = PAGE_SIZE - count;
 887		count += scnprintf(buf + count, size, "%s ", pos->name);
 888	}
 889	count += scnprintf(buf + count, size, "\n");
 890
 891	mutex_unlock(&thermal_governor_lock);
 892
 893	return count;
 894}
 895
 896static ssize_t
 897emul_temp_store(struct device *dev, struct device_attribute *attr,
 898		     const char *buf, size_t count)
 899{
 900	struct thermal_zone_device *tz = to_thermal_zone(dev);
 901	int ret = 0;
 902	int temperature;
 903
 904	if (kstrtoint(buf, 10, &temperature))
 905		return -EINVAL;
 906
 907	if (!tz->ops->set_emul_temp) {
 908		mutex_lock(&tz->lock);
 909		tz->emul_temperature = temperature;
 910		mutex_unlock(&tz->lock);
 911	} else {
 912		ret = tz->ops->set_emul_temp(tz, temperature);
 913	}
 914
 915	if (!ret)
 916		thermal_zone_device_update(tz);
 917
 918	return ret ? ret : count;
 919}
 920static DEVICE_ATTR(emul_temp, S_IWUSR, NULL, emul_temp_store);
 921
 922static ssize_t
 923sustainable_power_show(struct device *dev, struct device_attribute *devattr,
 924		       char *buf)
 925{
 926	struct thermal_zone_device *tz = to_thermal_zone(dev);
 927
 928	if (tz->tzp)
 929		return sprintf(buf, "%u\n", tz->tzp->sustainable_power);
 930	else
 931		return -EIO;
 932}
 933
 934static ssize_t
 935sustainable_power_store(struct device *dev, struct device_attribute *devattr,
 936			const char *buf, size_t count)
 937{
 938	struct thermal_zone_device *tz = to_thermal_zone(dev);
 939	u32 sustainable_power;
 940
 941	if (!tz->tzp)
 942		return -EIO;
 943
 944	if (kstrtou32(buf, 10, &sustainable_power))
 945		return -EINVAL;
 946
 947	tz->tzp->sustainable_power = sustainable_power;
 948
 949	return count;
 950}
 951static DEVICE_ATTR(sustainable_power, S_IWUSR | S_IRUGO, sustainable_power_show,
 952		sustainable_power_store);
 953
 954#define create_s32_tzp_attr(name)					\
 955	static ssize_t							\
 956	name##_show(struct device *dev, struct device_attribute *devattr, \
 957		char *buf)						\
 958	{								\
 959	struct thermal_zone_device *tz = to_thermal_zone(dev);		\
 960									\
 961	if (tz->tzp)							\
 962		return sprintf(buf, "%d\n", tz->tzp->name);		\
 963	else								\
 964		return -EIO;						\
 965	}								\
 966									\
 967	static ssize_t							\
 968	name##_store(struct device *dev, struct device_attribute *devattr, \
 969		const char *buf, size_t count)				\
 970	{								\
 971		struct thermal_zone_device *tz = to_thermal_zone(dev);	\
 972		s32 value;						\
 973									\
 974		if (!tz->tzp)						\
 975			return -EIO;					\
 976									\
 977		if (kstrtos32(buf, 10, &value))				\
 978			return -EINVAL;					\
 979									\
 980		tz->tzp->name = value;					\
 981									\
 982		return count;						\
 983	}								\
 984	static DEVICE_ATTR(name, S_IWUSR | S_IRUGO, name##_show, name##_store)
 985
 986create_s32_tzp_attr(k_po);
 987create_s32_tzp_attr(k_pu);
 988create_s32_tzp_attr(k_i);
 989create_s32_tzp_attr(k_d);
 990create_s32_tzp_attr(integral_cutoff);
 991create_s32_tzp_attr(slope);
 992create_s32_tzp_attr(offset);
 993#undef create_s32_tzp_attr
 994
 995static struct device_attribute *dev_tzp_attrs[] = {
 996	&dev_attr_sustainable_power,
 997	&dev_attr_k_po,
 998	&dev_attr_k_pu,
 999	&dev_attr_k_i,
1000	&dev_attr_k_d,
1001	&dev_attr_integral_cutoff,
1002	&dev_attr_slope,
1003	&dev_attr_offset,
1004};
1005
1006static int create_tzp_attrs(struct device *dev)
1007{
1008	int i;
1009
1010	for (i = 0; i < ARRAY_SIZE(dev_tzp_attrs); i++) {
1011		int ret;
1012		struct device_attribute *dev_attr = dev_tzp_attrs[i];
1013
1014		ret = device_create_file(dev, dev_attr);
1015		if (ret)
1016			return ret;
1017	}
1018
1019	return 0;
1020}
1021
1022/**
1023 * power_actor_get_max_power() - get the maximum power that a cdev can consume
1024 * @cdev:	pointer to &thermal_cooling_device
1025 * @tz:		a valid thermal zone device pointer
1026 * @max_power:	pointer in which to store the maximum power
1027 *
1028 * Calculate the maximum power consumption in milliwats that the
1029 * cooling device can currently consume and store it in @max_power.
1030 *
1031 * Return: 0 on success, -EINVAL if @cdev doesn't support the
1032 * power_actor API or -E* on other error.
1033 */
1034int power_actor_get_max_power(struct thermal_cooling_device *cdev,
1035			      struct thermal_zone_device *tz, u32 *max_power)
1036{
1037	if (!cdev_is_power_actor(cdev))
1038		return -EINVAL;
1039
1040	return cdev->ops->state2power(cdev, tz, 0, max_power);
1041}
1042
1043/**
1044 * power_actor_get_min_power() - get the mainimum power that a cdev can consume
1045 * @cdev:	pointer to &thermal_cooling_device
1046 * @tz:		a valid thermal zone device pointer
1047 * @min_power:	pointer in which to store the minimum power
1048 *
1049 * Calculate the minimum power consumption in milliwatts that the
1050 * cooling device can currently consume and store it in @min_power.
1051 *
1052 * Return: 0 on success, -EINVAL if @cdev doesn't support the
1053 * power_actor API or -E* on other error.
1054 */
1055int power_actor_get_min_power(struct thermal_cooling_device *cdev,
1056			      struct thermal_zone_device *tz, u32 *min_power)
1057{
1058	unsigned long max_state;
1059	int ret;
1060
1061	if (!cdev_is_power_actor(cdev))
1062		return -EINVAL;
1063
1064	ret = cdev->ops->get_max_state(cdev, &max_state);
1065	if (ret)
1066		return ret;
1067
1068	return cdev->ops->state2power(cdev, tz, max_state, min_power);
1069}
1070
1071/**
1072 * power_actor_set_power() - limit the maximum power that a cooling device can consume
1073 * @cdev:	pointer to &thermal_cooling_device
1074 * @instance:	thermal instance to update
1075 * @power:	the power in milliwatts
1076 *
1077 * Set the cooling device to consume at most @power milliwatts.
 
1078 *
1079 * Return: 0 on success, -EINVAL if the cooling device does not
1080 * implement the power actor API or -E* for other failures.
1081 */
1082int power_actor_set_power(struct thermal_cooling_device *cdev,
1083			  struct thermal_instance *instance, u32 power)
1084{
1085	unsigned long state;
1086	int ret;
1087
1088	if (!cdev_is_power_actor(cdev))
1089		return -EINVAL;
1090
1091	ret = cdev->ops->power2state(cdev, instance->tz, power, &state);
1092	if (ret)
1093		return ret;
1094
1095	instance->target = state;
 
1096	cdev->updated = false;
 
1097	thermal_cdev_update(cdev);
1098
1099	return 0;
1100}
1101
1102static DEVICE_ATTR(type, 0444, type_show, NULL);
1103static DEVICE_ATTR(temp, 0444, temp_show, NULL);
1104static DEVICE_ATTR(mode, 0644, mode_show, mode_store);
1105static DEVICE_ATTR(passive, S_IRUGO | S_IWUSR, passive_show, passive_store);
1106static DEVICE_ATTR(policy, S_IRUGO | S_IWUSR, policy_show, policy_store);
1107static DEVICE_ATTR(available_policies, S_IRUGO, available_policies_show, NULL);
1108
1109/* sys I/F for cooling device */
1110#define to_cooling_device(_dev)	\
1111	container_of(_dev, struct thermal_cooling_device, device)
1112
1113static ssize_t
1114thermal_cooling_device_type_show(struct device *dev,
1115				 struct device_attribute *attr, char *buf)
1116{
1117	struct thermal_cooling_device *cdev = to_cooling_device(dev);
1118
1119	return sprintf(buf, "%s\n", cdev->type);
1120}
1121
1122static ssize_t
1123thermal_cooling_device_max_state_show(struct device *dev,
1124				      struct device_attribute *attr, char *buf)
1125{
1126	struct thermal_cooling_device *cdev = to_cooling_device(dev);
1127	unsigned long state;
1128	int ret;
1129
1130	ret = cdev->ops->get_max_state(cdev, &state);
1131	if (ret)
1132		return ret;
1133	return sprintf(buf, "%ld\n", state);
1134}
1135
1136static ssize_t
1137thermal_cooling_device_cur_state_show(struct device *dev,
1138				      struct device_attribute *attr, char *buf)
1139{
1140	struct thermal_cooling_device *cdev = to_cooling_device(dev);
1141	unsigned long state;
1142	int ret;
1143
1144	ret = cdev->ops->get_cur_state(cdev, &state);
1145	if (ret)
1146		return ret;
1147	return sprintf(buf, "%ld\n", state);
1148}
1149
1150static ssize_t
1151thermal_cooling_device_cur_state_store(struct device *dev,
1152				       struct device_attribute *attr,
1153				       const char *buf, size_t count)
1154{
1155	struct thermal_cooling_device *cdev = to_cooling_device(dev);
1156	unsigned long state;
1157	int result;
1158
1159	if (!sscanf(buf, "%ld\n", &state))
1160		return -EINVAL;
1161
1162	if ((long)state < 0)
1163		return -EINVAL;
1164
1165	result = cdev->ops->set_cur_state(cdev, state);
1166	if (result)
1167		return result;
1168	return count;
1169}
1170
1171static struct device_attribute dev_attr_cdev_type =
1172__ATTR(type, 0444, thermal_cooling_device_type_show, NULL);
1173static DEVICE_ATTR(max_state, 0444,
1174		   thermal_cooling_device_max_state_show, NULL);
1175static DEVICE_ATTR(cur_state, 0644,
1176		   thermal_cooling_device_cur_state_show,
1177		   thermal_cooling_device_cur_state_store);
1178
1179static ssize_t
1180thermal_cooling_device_trip_point_show(struct device *dev,
1181				       struct device_attribute *attr, char *buf)
1182{
1183	struct thermal_instance *instance;
1184
1185	instance =
1186	    container_of(attr, struct thermal_instance, attr);
 
 
 
1187
1188	if (instance->trip == THERMAL_TRIPS_NONE)
1189		return sprintf(buf, "-1\n");
1190	else
1191		return sprintf(buf, "%d\n", instance->trip);
 
 
 
1192}
1193
1194static struct attribute *cooling_device_attrs[] = {
1195	&dev_attr_cdev_type.attr,
1196	&dev_attr_max_state.attr,
1197	&dev_attr_cur_state.attr,
1198	NULL,
1199};
1200
1201static const struct attribute_group cooling_device_attr_group = {
1202	.attrs = cooling_device_attrs,
1203};
1204
1205static const struct attribute_group *cooling_device_attr_groups[] = {
1206	&cooling_device_attr_group,
1207	NULL,
1208};
1209
1210static ssize_t
1211thermal_cooling_device_weight_show(struct device *dev,
1212				   struct device_attribute *attr, char *buf)
1213{
1214	struct thermal_instance *instance;
1215
1216	instance = container_of(attr, struct thermal_instance, weight_attr);
1217
1218	return sprintf(buf, "%d\n", instance->weight);
 
 
 
 
 
 
 
 
 
1219}
1220
1221static ssize_t
1222thermal_cooling_device_weight_store(struct device *dev,
1223				    struct device_attribute *attr,
1224				    const char *buf, size_t count)
1225{
1226	struct thermal_instance *instance;
1227	int ret, weight;
1228
1229	ret = kstrtoint(buf, 0, &weight);
1230	if (ret)
1231		return ret;
1232
1233	instance = container_of(attr, struct thermal_instance, weight_attr);
1234	instance->weight = weight;
1235
1236	return count;
1237}
1238/* Device management */
1239
1240/**
1241 * thermal_zone_bind_cooling_device() - bind a cooling device to a thermal zone
1242 * @tz:		pointer to struct thermal_zone_device
1243 * @trip:	indicates which trip point the cooling devices is
1244 *		associated with in this thermal zone.
1245 * @cdev:	pointer to struct thermal_cooling_device
1246 * @upper:	the Maximum cooling state for this trip point.
1247 *		THERMAL_NO_LIMIT means no upper limit,
1248 *		and the cooling device can be in max_state.
1249 * @lower:	the Minimum cooling state can be used for this trip point.
1250 *		THERMAL_NO_LIMIT means no lower limit,
1251 *		and the cooling device can be in cooling state 0.
1252 * @weight:	The weight of the cooling device to be bound to the
1253 *		thermal zone. Use THERMAL_WEIGHT_DEFAULT for the
1254 *		default value
1255 *
1256 * This interface function bind a thermal cooling device to the certain trip
1257 * point of a thermal zone device.
1258 * This function is usually called in the thermal zone device .bind callback.
1259 *
1260 * Return: 0 on success, the proper error value otherwise.
1261 */
1262int thermal_zone_bind_cooling_device(struct thermal_zone_device *tz,
1263				     int trip,
1264				     struct thermal_cooling_device *cdev,
1265				     unsigned long upper, unsigned long lower,
1266				     unsigned int weight)
1267{
1268	struct thermal_instance *dev;
1269	struct thermal_instance *pos;
1270	struct thermal_zone_device *pos1;
1271	struct thermal_cooling_device *pos2;
1272	unsigned long max_state;
1273	int result, ret;
1274
1275	if (trip >= tz->trips || (trip < 0 && trip != THERMAL_TRIPS_NONE))
1276		return -EINVAL;
1277
1278	list_for_each_entry(pos1, &thermal_tz_list, node) {
1279		if (pos1 == tz)
1280			break;
1281	}
1282	list_for_each_entry(pos2, &thermal_cdev_list, node) {
1283		if (pos2 == cdev)
1284			break;
1285	}
1286
1287	if (tz != pos1 || cdev != pos2)
1288		return -EINVAL;
1289
1290	ret = cdev->ops->get_max_state(cdev, &max_state);
1291	if (ret)
1292		return ret;
1293
1294	/* lower default 0, upper default max_state */
1295	lower = lower == THERMAL_NO_LIMIT ? 0 : lower;
1296	upper = upper == THERMAL_NO_LIMIT ? max_state : upper;
1297
1298	if (lower > upper || upper > max_state)
1299		return -EINVAL;
1300
1301	dev =
1302	    kzalloc(sizeof(struct thermal_instance), GFP_KERNEL);
1303	if (!dev)
1304		return -ENOMEM;
1305	dev->tz = tz;
1306	dev->cdev = cdev;
1307	dev->trip = trip;
1308	dev->upper = upper;
1309	dev->lower = lower;
1310	dev->target = THERMAL_NO_TARGET;
1311	dev->weight = weight;
1312
1313	result = get_idr(&tz->idr, &tz->lock, &dev->id);
1314	if (result)
1315		goto free_mem;
1316
 
1317	sprintf(dev->name, "cdev%d", dev->id);
1318	result =
1319	    sysfs_create_link(&tz->device.kobj, &cdev->device.kobj, dev->name);
1320	if (result)
1321		goto release_idr;
1322
1323	sprintf(dev->attr_name, "cdev%d_trip_point", dev->id);
1324	sysfs_attr_init(&dev->attr.attr);
1325	dev->attr.attr.name = dev->attr_name;
1326	dev->attr.attr.mode = 0444;
1327	dev->attr.show = thermal_cooling_device_trip_point_show;
1328	result = device_create_file(&tz->device, &dev->attr);
1329	if (result)
1330		goto remove_symbol_link;
1331
1332	sprintf(dev->weight_attr_name, "cdev%d_weight", dev->id);
1333	sysfs_attr_init(&dev->weight_attr.attr);
1334	dev->weight_attr.attr.name = dev->weight_attr_name;
1335	dev->weight_attr.attr.mode = S_IWUSR | S_IRUGO;
1336	dev->weight_attr.show = thermal_cooling_device_weight_show;
1337	dev->weight_attr.store = thermal_cooling_device_weight_store;
1338	result = device_create_file(&tz->device, &dev->weight_attr);
1339	if (result)
1340		goto remove_trip_file;
1341
1342	mutex_lock(&tz->lock);
1343	mutex_lock(&cdev->lock);
1344	list_for_each_entry(pos, &tz->thermal_instances, tz_node)
1345	    if (pos->tz == tz && pos->trip == trip && pos->cdev == cdev) {
1346		result = -EEXIST;
1347		break;
1348	}
1349	if (!result) {
1350		list_add_tail(&dev->tz_node, &tz->thermal_instances);
1351		list_add_tail(&dev->cdev_node, &cdev->thermal_instances);
1352		atomic_set(&tz->need_update, 1);
1353	}
1354	mutex_unlock(&cdev->lock);
1355	mutex_unlock(&tz->lock);
1356
1357	if (!result)
1358		return 0;
1359
1360	device_remove_file(&tz->device, &dev->weight_attr);
1361remove_trip_file:
1362	device_remove_file(&tz->device, &dev->attr);
1363remove_symbol_link:
1364	sysfs_remove_link(&tz->device.kobj, dev->name);
1365release_idr:
1366	release_idr(&tz->idr, &tz->lock, dev->id);
1367free_mem:
1368	kfree(dev);
1369	return result;
1370}
1371EXPORT_SYMBOL_GPL(thermal_zone_bind_cooling_device);
1372
1373/**
1374 * thermal_zone_unbind_cooling_device() - unbind a cooling device from a
1375 *					  thermal zone.
1376 * @tz:		pointer to a struct thermal_zone_device.
1377 * @trip:	indicates which trip point the cooling devices is
1378 *		associated with in this thermal zone.
1379 * @cdev:	pointer to a struct thermal_cooling_device.
1380 *
1381 * This interface function unbind a thermal cooling device from the certain
1382 * trip point of a thermal zone device.
1383 * This function is usually called in the thermal zone device .unbind callback.
1384 *
1385 * Return: 0 on success, the proper error value otherwise.
1386 */
1387int thermal_zone_unbind_cooling_device(struct thermal_zone_device *tz,
1388				       int trip,
1389				       struct thermal_cooling_device *cdev)
1390{
1391	struct thermal_instance *pos, *next;
1392
1393	mutex_lock(&tz->lock);
1394	mutex_lock(&cdev->lock);
1395	list_for_each_entry_safe(pos, next, &tz->thermal_instances, tz_node) {
1396		if (pos->tz == tz && pos->trip == trip && pos->cdev == cdev) {
1397			list_del(&pos->tz_node);
1398			list_del(&pos->cdev_node);
1399			mutex_unlock(&cdev->lock);
1400			mutex_unlock(&tz->lock);
1401			goto unbind;
1402		}
1403	}
1404	mutex_unlock(&cdev->lock);
1405	mutex_unlock(&tz->lock);
1406
1407	return -ENODEV;
1408
1409unbind:
1410	device_remove_file(&tz->device, &pos->weight_attr);
1411	device_remove_file(&tz->device, &pos->attr);
1412	sysfs_remove_link(&tz->device.kobj, pos->name);
1413	release_idr(&tz->idr, &tz->lock, pos->id);
1414	kfree(pos);
1415	return 0;
1416}
1417EXPORT_SYMBOL_GPL(thermal_zone_unbind_cooling_device);
1418
1419static void thermal_release(struct device *dev)
1420{
1421	struct thermal_zone_device *tz;
1422	struct thermal_cooling_device *cdev;
1423
1424	if (!strncmp(dev_name(dev), "thermal_zone",
1425		     sizeof("thermal_zone") - 1)) {
1426		tz = to_thermal_zone(dev);
 
1427		kfree(tz);
1428	} else if(!strncmp(dev_name(dev), "cooling_device",
1429			sizeof("cooling_device") - 1)){
1430		cdev = to_cooling_device(dev);
1431		kfree(cdev);
1432	}
1433}
1434
1435static struct class thermal_class = {
1436	.name = "thermal",
1437	.dev_release = thermal_release,
1438};
1439
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1440/**
1441 * __thermal_cooling_device_register() - register a new thermal cooling device
1442 * @np:		a pointer to a device tree node.
1443 * @type:	the thermal cooling device type.
1444 * @devdata:	device private data.
1445 * @ops:		standard thermal cooling devices callbacks.
1446 *
1447 * This interface function adds a new thermal cooling device (fan/processor/...)
1448 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1449 * to all the thermal zone devices registered at the same time.
1450 * It also gives the opportunity to link the cooling device to a device tree
1451 * node, so that it can be bound to a thermal zone created out of device tree.
1452 *
1453 * Return: a pointer to the created struct thermal_cooling_device or an
1454 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1455 */
1456static struct thermal_cooling_device *
1457__thermal_cooling_device_register(struct device_node *np,
1458				  char *type, void *devdata,
1459				  const struct thermal_cooling_device_ops *ops)
1460{
1461	struct thermal_cooling_device *cdev;
1462	struct thermal_zone_device *pos = NULL;
1463	int result;
1464
1465	if (type && strlen(type) >= THERMAL_NAME_LENGTH)
1466		return ERR_PTR(-EINVAL);
1467
1468	if (!ops || !ops->get_max_state || !ops->get_cur_state ||
1469	    !ops->set_cur_state)
1470		return ERR_PTR(-EINVAL);
1471
1472	cdev = kzalloc(sizeof(struct thermal_cooling_device), GFP_KERNEL);
1473	if (!cdev)
1474		return ERR_PTR(-ENOMEM);
1475
1476	result = get_idr(&thermal_cdev_idr, &thermal_idr_lock, &cdev->id);
1477	if (result) {
1478		kfree(cdev);
1479		return ERR_PTR(result);
1480	}
1481
 
1482	strlcpy(cdev->type, type ? : "", sizeof(cdev->type));
1483	mutex_init(&cdev->lock);
1484	INIT_LIST_HEAD(&cdev->thermal_instances);
1485	cdev->np = np;
1486	cdev->ops = ops;
1487	cdev->updated = false;
1488	cdev->device.class = &thermal_class;
1489	cdev->device.groups = cooling_device_attr_groups;
1490	cdev->devdata = devdata;
 
1491	dev_set_name(&cdev->device, "cooling_device%d", cdev->id);
1492	result = device_register(&cdev->device);
1493	if (result) {
1494		release_idr(&thermal_cdev_idr, &thermal_idr_lock, cdev->id);
1495		kfree(cdev);
1496		return ERR_PTR(result);
1497	}
1498
1499	/* Add 'this' new cdev to the global cdev list */
1500	mutex_lock(&thermal_list_lock);
1501	list_add(&cdev->node, &thermal_cdev_list);
1502	mutex_unlock(&thermal_list_lock);
1503
1504	/* Update binding information for 'this' new cdev */
1505	bind_cdev(cdev);
1506
1507	mutex_lock(&thermal_list_lock);
1508	list_for_each_entry(pos, &thermal_tz_list, node)
1509		if (atomic_cmpxchg(&pos->need_update, 1, 0))
1510			thermal_zone_device_update(pos);
 
1511	mutex_unlock(&thermal_list_lock);
1512
1513	return cdev;
1514}
1515
1516/**
1517 * thermal_cooling_device_register() - register a new thermal cooling device
1518 * @type:	the thermal cooling device type.
1519 * @devdata:	device private data.
1520 * @ops:		standard thermal cooling devices callbacks.
1521 *
1522 * This interface function adds a new thermal cooling device (fan/processor/...)
1523 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1524 * to all the thermal zone devices registered at the same time.
1525 *
1526 * Return: a pointer to the created struct thermal_cooling_device or an
1527 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1528 */
1529struct thermal_cooling_device *
1530thermal_cooling_device_register(char *type, void *devdata,
1531				const struct thermal_cooling_device_ops *ops)
1532{
1533	return __thermal_cooling_device_register(NULL, type, devdata, ops);
1534}
1535EXPORT_SYMBOL_GPL(thermal_cooling_device_register);
1536
1537/**
1538 * thermal_of_cooling_device_register() - register an OF thermal cooling device
1539 * @np:		a pointer to a device tree node.
1540 * @type:	the thermal cooling device type.
1541 * @devdata:	device private data.
1542 * @ops:		standard thermal cooling devices callbacks.
1543 *
1544 * This function will register a cooling device with device tree node reference.
1545 * This interface function adds a new thermal cooling device (fan/processor/...)
1546 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1547 * to all the thermal zone devices registered at the same time.
1548 *
1549 * Return: a pointer to the created struct thermal_cooling_device or an
1550 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1551 */
1552struct thermal_cooling_device *
1553thermal_of_cooling_device_register(struct device_node *np,
1554				   char *type, void *devdata,
1555				   const struct thermal_cooling_device_ops *ops)
1556{
1557	return __thermal_cooling_device_register(np, type, devdata, ops);
1558}
1559EXPORT_SYMBOL_GPL(thermal_of_cooling_device_register);
1560
 
 
 
 
 
 
1561/**
1562 * thermal_cooling_device_unregister - removes the registered thermal cooling device
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1563 * @cdev:	the thermal cooling device to remove.
1564 *
1565 * thermal_cooling_device_unregister() must be called when the device is no
1566 * longer needed.
1567 */
1568void thermal_cooling_device_unregister(struct thermal_cooling_device *cdev)
1569{
1570	int i;
1571	const struct thermal_zone_params *tzp;
1572	struct thermal_zone_device *tz;
1573	struct thermal_cooling_device *pos = NULL;
1574
1575	if (!cdev)
1576		return;
1577
1578	mutex_lock(&thermal_list_lock);
1579	list_for_each_entry(pos, &thermal_cdev_list, node)
1580	    if (pos == cdev)
1581		break;
1582	if (pos != cdev) {
1583		/* thermal cooling device not found */
1584		mutex_unlock(&thermal_list_lock);
1585		return;
1586	}
1587	list_del(&cdev->node);
1588
1589	/* Unbind all thermal zones associated with 'this' cdev */
1590	list_for_each_entry(tz, &thermal_tz_list, node) {
1591		if (tz->ops->unbind) {
1592			tz->ops->unbind(tz, cdev);
1593			continue;
1594		}
1595
1596		if (!tz->tzp || !tz->tzp->tbp)
1597			continue;
1598
1599		tzp = tz->tzp;
1600		for (i = 0; i < tzp->num_tbps; i++) {
1601			if (tzp->tbp[i].cdev == cdev) {
1602				__unbind(tz, tzp->tbp[i].trip_mask, cdev);
1603				tzp->tbp[i].cdev = NULL;
1604			}
1605		}
1606	}
1607
1608	mutex_unlock(&thermal_list_lock);
1609
1610	if (cdev->type[0])
1611		device_remove_file(&cdev->device, &dev_attr_cdev_type);
1612	device_remove_file(&cdev->device, &dev_attr_max_state);
1613	device_remove_file(&cdev->device, &dev_attr_cur_state);
1614
1615	release_idr(&thermal_cdev_idr, &thermal_idr_lock, cdev->id);
1616	device_unregister(&cdev->device);
1617	return;
1618}
1619EXPORT_SYMBOL_GPL(thermal_cooling_device_unregister);
1620
1621void thermal_cdev_update(struct thermal_cooling_device *cdev)
1622{
1623	struct thermal_instance *instance;
1624	unsigned long target = 0;
 
1625
1626	/* cooling device is updated*/
1627	if (cdev->updated)
1628		return;
1629
1630	mutex_lock(&cdev->lock);
1631	/* Make sure cdev enters the deepest cooling state */
1632	list_for_each_entry(instance, &cdev->thermal_instances, cdev_node) {
1633		dev_dbg(&cdev->device, "zone%d->target=%lu\n",
1634				instance->tz->id, instance->target);
1635		if (instance->target == THERMAL_NO_TARGET)
1636			continue;
1637		if (instance->target > target)
1638			target = instance->target;
1639	}
1640	mutex_unlock(&cdev->lock);
1641	cdev->ops->set_cur_state(cdev, target);
1642	cdev->updated = true;
1643	trace_cdev_update(cdev, target);
1644	dev_dbg(&cdev->device, "set to state %lu\n", target);
1645}
1646EXPORT_SYMBOL(thermal_cdev_update);
1647
1648/**
1649 * thermal_notify_framework - Sensor drivers use this API to notify framework
1650 * @tz:		thermal zone device
1651 * @trip:	indicates which trip point has been crossed
1652 *
1653 * This function handles the trip events from sensor drivers. It starts
1654 * throttling the cooling devices according to the policy configured.
1655 * For CRITICAL and HOT trip points, this notifies the respective drivers,
1656 * and does actual throttling for other trip points i.e ACTIVE and PASSIVE.
1657 * The throttling policy is based on the configured platform data; if no
1658 * platform data is provided, this uses the step_wise throttling policy.
1659 */
1660void thermal_notify_framework(struct thermal_zone_device *tz, int trip)
1661{
1662	handle_thermal_trip(tz, trip);
1663}
1664EXPORT_SYMBOL_GPL(thermal_notify_framework);
1665
1666/**
1667 * create_trip_attrs() - create attributes for trip points
1668 * @tz:		the thermal zone device
1669 * @mask:	Writeable trip point bitmap.
1670 *
1671 * helper function to instantiate sysfs entries for every trip
1672 * point and its properties of a struct thermal_zone_device.
1673 *
1674 * Return: 0 on success, the proper error value otherwise.
1675 */
1676static int create_trip_attrs(struct thermal_zone_device *tz, int mask)
1677{
1678	int indx;
1679	int size = sizeof(struct thermal_attr) * tz->trips;
1680
1681	tz->trip_type_attrs = kzalloc(size, GFP_KERNEL);
1682	if (!tz->trip_type_attrs)
1683		return -ENOMEM;
1684
1685	tz->trip_temp_attrs = kzalloc(size, GFP_KERNEL);
1686	if (!tz->trip_temp_attrs) {
1687		kfree(tz->trip_type_attrs);
1688		return -ENOMEM;
1689	}
1690
1691	if (tz->ops->get_trip_hyst) {
1692		tz->trip_hyst_attrs = kzalloc(size, GFP_KERNEL);
1693		if (!tz->trip_hyst_attrs) {
1694			kfree(tz->trip_type_attrs);
1695			kfree(tz->trip_temp_attrs);
1696			return -ENOMEM;
1697		}
 
1698	}
1699
 
 
1700
1701	for (indx = 0; indx < tz->trips; indx++) {
1702		/* create trip type attribute */
1703		snprintf(tz->trip_type_attrs[indx].name, THERMAL_NAME_LENGTH,
1704			 "trip_point_%d_type", indx);
1705
1706		sysfs_attr_init(&tz->trip_type_attrs[indx].attr.attr);
1707		tz->trip_type_attrs[indx].attr.attr.name =
1708						tz->trip_type_attrs[indx].name;
1709		tz->trip_type_attrs[indx].attr.attr.mode = S_IRUGO;
1710		tz->trip_type_attrs[indx].attr.show = trip_point_type_show;
1711
1712		device_create_file(&tz->device,
1713				   &tz->trip_type_attrs[indx].attr);
1714
1715		/* create trip temp attribute */
1716		snprintf(tz->trip_temp_attrs[indx].name, THERMAL_NAME_LENGTH,
1717			 "trip_point_%d_temp", indx);
1718
1719		sysfs_attr_init(&tz->trip_temp_attrs[indx].attr.attr);
1720		tz->trip_temp_attrs[indx].attr.attr.name =
1721						tz->trip_temp_attrs[indx].name;
1722		tz->trip_temp_attrs[indx].attr.attr.mode = S_IRUGO;
1723		tz->trip_temp_attrs[indx].attr.show = trip_point_temp_show;
1724		if (IS_ENABLED(CONFIG_THERMAL_WRITABLE_TRIPS) &&
1725		    mask & (1 << indx)) {
1726			tz->trip_temp_attrs[indx].attr.attr.mode |= S_IWUSR;
1727			tz->trip_temp_attrs[indx].attr.store =
1728							trip_point_temp_store;
1729		}
1730
1731		device_create_file(&tz->device,
1732				   &tz->trip_temp_attrs[indx].attr);
1733
1734		/* create Optional trip hyst attribute */
1735		if (!tz->ops->get_trip_hyst)
1736			continue;
1737		snprintf(tz->trip_hyst_attrs[indx].name, THERMAL_NAME_LENGTH,
1738			 "trip_point_%d_hyst", indx);
1739
1740		sysfs_attr_init(&tz->trip_hyst_attrs[indx].attr.attr);
1741		tz->trip_hyst_attrs[indx].attr.attr.name =
1742					tz->trip_hyst_attrs[indx].name;
1743		tz->trip_hyst_attrs[indx].attr.attr.mode = S_IRUGO;
1744		tz->trip_hyst_attrs[indx].attr.show = trip_point_hyst_show;
1745		if (tz->ops->set_trip_hyst) {
1746			tz->trip_hyst_attrs[indx].attr.attr.mode |= S_IWUSR;
1747			tz->trip_hyst_attrs[indx].attr.store =
1748					trip_point_hyst_store;
1749		}
1750
1751		device_create_file(&tz->device,
1752				   &tz->trip_hyst_attrs[indx].attr);
1753	}
1754	return 0;
1755}
1756
1757static void remove_trip_attrs(struct thermal_zone_device *tz)
1758{
1759	int indx;
1760
1761	for (indx = 0; indx < tz->trips; indx++) {
1762		device_remove_file(&tz->device,
1763				   &tz->trip_type_attrs[indx].attr);
1764		device_remove_file(&tz->device,
1765				   &tz->trip_temp_attrs[indx].attr);
1766		if (tz->ops->get_trip_hyst)
1767			device_remove_file(&tz->device,
1768				  &tz->trip_hyst_attrs[indx].attr);
1769	}
1770	kfree(tz->trip_type_attrs);
1771	kfree(tz->trip_temp_attrs);
1772	kfree(tz->trip_hyst_attrs);
1773}
1774
1775/**
1776 * thermal_zone_device_register() - register a new thermal zone device
1777 * @type:	the thermal zone device type
1778 * @trips:	the number of trip points the thermal zone support
1779 * @mask:	a bit string indicating the writeablility of trip points
1780 * @devdata:	private device data
1781 * @ops:	standard thermal zone device callbacks
1782 * @tzp:	thermal zone platform parameters
1783 * @passive_delay: number of milliseconds to wait between polls when
1784 *		   performing passive cooling
1785 * @polling_delay: number of milliseconds to wait between polls when checking
1786 *		   whether trip points have been crossed (0 for interrupt
1787 *		   driven systems)
1788 *
1789 * This interface function adds a new thermal zone device (sensor) to
1790 * /sys/class/thermal folder as thermal_zone[0-*]. It tries to bind all the
1791 * thermal cooling devices registered at the same time.
1792 * thermal_zone_device_unregister() must be called when the device is no
1793 * longer needed. The passive cooling depends on the .get_trend() return value.
1794 *
1795 * Return: a pointer to the created struct thermal_zone_device or an
1796 * in case of error, an ERR_PTR. Caller must check return value with
1797 * IS_ERR*() helpers.
1798 */
1799struct thermal_zone_device *thermal_zone_device_register(const char *type,
1800	int trips, int mask, void *devdata,
1801	struct thermal_zone_device_ops *ops,
1802	struct thermal_zone_params *tzp,
1803	int passive_delay, int polling_delay)
1804{
1805	struct thermal_zone_device *tz;
1806	enum thermal_trip_type trip_type;
1807	int trip_temp;
 
1808	int result;
1809	int count;
1810	int passive = 0;
1811	struct thermal_governor *governor;
1812
1813	if (type && strlen(type) >= THERMAL_NAME_LENGTH)
 
 
 
 
 
 
 
1814		return ERR_PTR(-EINVAL);
 
1815
1816	if (trips > THERMAL_MAX_TRIPS || trips < 0 || mask >> trips)
 
1817		return ERR_PTR(-EINVAL);
 
1818
1819	if (!ops)
 
1820		return ERR_PTR(-EINVAL);
 
1821
1822	if (trips > 0 && (!ops->get_trip_type || !ops->get_trip_temp))
1823		return ERR_PTR(-EINVAL);
1824
1825	tz = kzalloc(sizeof(struct thermal_zone_device), GFP_KERNEL);
1826	if (!tz)
1827		return ERR_PTR(-ENOMEM);
1828
1829	INIT_LIST_HEAD(&tz->thermal_instances);
1830	idr_init(&tz->idr);
1831	mutex_init(&tz->lock);
1832	result = get_idr(&thermal_tz_idr, &thermal_idr_lock, &tz->id);
1833	if (result) {
1834		kfree(tz);
1835		return ERR_PTR(result);
1836	}
1837
1838	strlcpy(tz->type, type ? : "", sizeof(tz->type));
 
1839	tz->ops = ops;
1840	tz->tzp = tzp;
1841	tz->device.class = &thermal_class;
1842	tz->devdata = devdata;
1843	tz->trips = trips;
1844	tz->passive_delay = passive_delay;
1845	tz->polling_delay = polling_delay;
1846	/* A new thermal zone needs to be updated anyway. */
1847	atomic_set(&tz->need_update, 1);
1848
1849	dev_set_name(&tz->device, "thermal_zone%d", tz->id);
1850	result = device_register(&tz->device);
1851	if (result) {
1852		release_idr(&thermal_tz_idr, &thermal_idr_lock, tz->id);
1853		kfree(tz);
1854		return ERR_PTR(result);
1855	}
1856
1857	/* sys I/F */
1858	if (type) {
1859		result = device_create_file(&tz->device, &dev_attr_type);
1860		if (result)
1861			goto unregister;
1862	}
1863
1864	result = device_create_file(&tz->device, &dev_attr_temp);
1865	if (result)
1866		goto unregister;
1867
1868	if (ops->get_mode) {
1869		result = device_create_file(&tz->device, &dev_attr_mode);
1870		if (result)
1871			goto unregister;
1872	}
1873
1874	result = create_trip_attrs(tz, mask);
 
1875	if (result)
1876		goto unregister;
1877
1878	for (count = 0; count < trips; count++) {
1879		if (tz->ops->get_trip_type(tz, count, &trip_type))
1880			set_bit(count, &tz->trips_disabled);
1881		if (trip_type == THERMAL_TRIP_PASSIVE)
1882			passive = 1;
1883		if (tz->ops->get_trip_temp(tz, count, &trip_temp))
1884			set_bit(count, &tz->trips_disabled);
1885		/* Check for bogus trip points */
1886		if (trip_temp == 0)
1887			set_bit(count, &tz->trips_disabled);
1888	}
1889
1890	if (!passive) {
1891		result = device_create_file(&tz->device, &dev_attr_passive);
1892		if (result)
1893			goto unregister;
1894	}
1895
1896	if (IS_ENABLED(CONFIG_THERMAL_EMULATION)) {
1897		result = device_create_file(&tz->device, &dev_attr_emul_temp);
1898		if (result)
1899			goto unregister;
1900	}
1901
1902	/* Create policy attribute */
1903	result = device_create_file(&tz->device, &dev_attr_policy);
1904	if (result)
1905		goto unregister;
1906
1907	/* Add thermal zone params */
1908	result = create_tzp_attrs(&tz->device);
1909	if (result)
1910		goto unregister;
1911
1912	/* Create available_policies attribute */
1913	result = device_create_file(&tz->device, &dev_attr_available_policies);
1914	if (result)
1915		goto unregister;
1916
1917	/* Update 'this' zone's governor information */
1918	mutex_lock(&thermal_governor_lock);
1919
1920	if (tz->tzp)
1921		governor = __find_governor(tz->tzp->governor_name);
1922	else
1923		governor = def_governor;
1924
1925	result = thermal_set_governor(tz, governor);
1926	if (result) {
1927		mutex_unlock(&thermal_governor_lock);
1928		goto unregister;
1929	}
1930
1931	mutex_unlock(&thermal_governor_lock);
1932
1933	if (!tz->tzp || !tz->tzp->no_hwmon) {
1934		result = thermal_add_hwmon_sysfs(tz);
1935		if (result)
1936			goto unregister;
1937	}
1938
1939	mutex_lock(&thermal_list_lock);
1940	list_add_tail(&tz->node, &thermal_tz_list);
1941	mutex_unlock(&thermal_list_lock);
1942
1943	/* Bind cooling devices for this zone */
1944	bind_tz(tz);
1945
1946	INIT_DELAYED_WORK(&(tz->poll_queue), thermal_zone_device_check);
1947
1948	thermal_zone_device_reset(tz);
1949	/* Update the new thermal zone and mark it as already updated. */
1950	if (atomic_cmpxchg(&tz->need_update, 1, 0))
1951		thermal_zone_device_update(tz);
1952
1953	return tz;
1954
1955unregister:
1956	release_idr(&thermal_tz_idr, &thermal_idr_lock, tz->id);
1957	device_unregister(&tz->device);
 
 
 
 
 
 
1958	return ERR_PTR(result);
1959}
1960EXPORT_SYMBOL_GPL(thermal_zone_device_register);
1961
1962/**
1963 * thermal_device_unregister - removes the registered thermal zone device
1964 * @tz: the thermal zone device to remove
1965 */
1966void thermal_zone_device_unregister(struct thermal_zone_device *tz)
1967{
1968	int i;
1969	const struct thermal_zone_params *tzp;
1970	struct thermal_cooling_device *cdev;
1971	struct thermal_zone_device *pos = NULL;
1972
1973	if (!tz)
1974		return;
1975
1976	tzp = tz->tzp;
1977
1978	mutex_lock(&thermal_list_lock);
1979	list_for_each_entry(pos, &thermal_tz_list, node)
1980	    if (pos == tz)
1981		break;
1982	if (pos != tz) {
1983		/* thermal zone device not found */
1984		mutex_unlock(&thermal_list_lock);
1985		return;
1986	}
1987	list_del(&tz->node);
1988
1989	/* Unbind all cdevs associated with 'this' thermal zone */
1990	list_for_each_entry(cdev, &thermal_cdev_list, node) {
1991		if (tz->ops->unbind) {
1992			tz->ops->unbind(tz, cdev);
1993			continue;
1994		}
1995
1996		if (!tzp || !tzp->tbp)
1997			break;
1998
1999		for (i = 0; i < tzp->num_tbps; i++) {
2000			if (tzp->tbp[i].cdev == cdev) {
2001				__unbind(tz, tzp->tbp[i].trip_mask, cdev);
2002				tzp->tbp[i].cdev = NULL;
2003			}
2004		}
2005	}
2006
2007	mutex_unlock(&thermal_list_lock);
2008
2009	thermal_zone_device_set_polling(tz, 0);
2010
2011	if (tz->type[0])
2012		device_remove_file(&tz->device, &dev_attr_type);
2013	device_remove_file(&tz->device, &dev_attr_temp);
2014	if (tz->ops->get_mode)
2015		device_remove_file(&tz->device, &dev_attr_mode);
2016	device_remove_file(&tz->device, &dev_attr_policy);
2017	device_remove_file(&tz->device, &dev_attr_available_policies);
2018	remove_trip_attrs(tz);
2019	thermal_set_governor(tz, NULL);
2020
2021	thermal_remove_hwmon_sysfs(tz);
2022	release_idr(&thermal_tz_idr, &thermal_idr_lock, tz->id);
2023	idr_destroy(&tz->idr);
2024	mutex_destroy(&tz->lock);
2025	device_unregister(&tz->device);
2026	return;
2027}
2028EXPORT_SYMBOL_GPL(thermal_zone_device_unregister);
2029
2030/**
2031 * thermal_zone_get_zone_by_name() - search for a zone and returns its ref
2032 * @name: thermal zone name to fetch the temperature
2033 *
2034 * When only one zone is found with the passed name, returns a reference to it.
2035 *
2036 * Return: On success returns a reference to an unique thermal zone with
2037 * matching name equals to @name, an ERR_PTR otherwise (-EINVAL for invalid
2038 * paramenters, -ENODEV for not found and -EEXIST for multiple matches).
2039 */
2040struct thermal_zone_device *thermal_zone_get_zone_by_name(const char *name)
2041{
2042	struct thermal_zone_device *pos = NULL, *ref = ERR_PTR(-EINVAL);
2043	unsigned int found = 0;
2044
2045	if (!name)
2046		goto exit;
2047
2048	mutex_lock(&thermal_list_lock);
2049	list_for_each_entry(pos, &thermal_tz_list, node)
2050		if (!strncasecmp(name, pos->type, THERMAL_NAME_LENGTH)) {
2051			found++;
2052			ref = pos;
2053		}
2054	mutex_unlock(&thermal_list_lock);
2055
2056	/* nothing has been found, thus an error code for it */
2057	if (found == 0)
2058		ref = ERR_PTR(-ENODEV);
2059	else if (found > 1)
2060	/* Success only when an unique zone is found */
2061		ref = ERR_PTR(-EEXIST);
2062
2063exit:
2064	return ref;
2065}
2066EXPORT_SYMBOL_GPL(thermal_zone_get_zone_by_name);
2067
2068#ifdef CONFIG_NET
2069static const struct genl_multicast_group thermal_event_mcgrps[] = {
2070	{ .name = THERMAL_GENL_MCAST_GROUP_NAME, },
2071};
2072
2073static struct genl_family thermal_event_genl_family = {
2074	.id = GENL_ID_GENERATE,
2075	.name = THERMAL_GENL_FAMILY_NAME,
2076	.version = THERMAL_GENL_VERSION,
2077	.maxattr = THERMAL_GENL_ATTR_MAX,
2078	.mcgrps = thermal_event_mcgrps,
2079	.n_mcgrps = ARRAY_SIZE(thermal_event_mcgrps),
2080};
2081
2082int thermal_generate_netlink_event(struct thermal_zone_device *tz,
2083					enum events event)
2084{
2085	struct sk_buff *skb;
2086	struct nlattr *attr;
2087	struct thermal_genl_event *thermal_event;
2088	void *msg_header;
2089	int size;
2090	int result;
2091	static unsigned int thermal_event_seqnum;
2092
2093	if (!tz)
2094		return -EINVAL;
2095
2096	/* allocate memory */
2097	size = nla_total_size(sizeof(struct thermal_genl_event)) +
2098	       nla_total_size(0);
2099
2100	skb = genlmsg_new(size, GFP_ATOMIC);
2101	if (!skb)
2102		return -ENOMEM;
2103
2104	/* add the genetlink message header */
2105	msg_header = genlmsg_put(skb, 0, thermal_event_seqnum++,
2106				 &thermal_event_genl_family, 0,
2107				 THERMAL_GENL_CMD_EVENT);
2108	if (!msg_header) {
2109		nlmsg_free(skb);
2110		return -ENOMEM;
2111	}
2112
2113	/* fill the data */
2114	attr = nla_reserve(skb, THERMAL_GENL_ATTR_EVENT,
2115			   sizeof(struct thermal_genl_event));
2116
2117	if (!attr) {
2118		nlmsg_free(skb);
2119		return -EINVAL;
2120	}
2121
2122	thermal_event = nla_data(attr);
2123	if (!thermal_event) {
2124		nlmsg_free(skb);
2125		return -EINVAL;
2126	}
2127
2128	memset(thermal_event, 0, sizeof(struct thermal_genl_event));
2129
2130	thermal_event->orig = tz->id;
2131	thermal_event->event = event;
2132
2133	/* send multicast genetlink message */
2134	genlmsg_end(skb, msg_header);
2135
2136	result = genlmsg_multicast(&thermal_event_genl_family, skb, 0,
2137				   0, GFP_ATOMIC);
2138	if (result)
2139		dev_err(&tz->device, "Failed to send netlink event:%d", result);
2140
2141	return result;
2142}
2143EXPORT_SYMBOL_GPL(thermal_generate_netlink_event);
2144
2145static int genetlink_init(void)
2146{
2147	return genl_register_family(&thermal_event_genl_family);
2148}
2149
2150static void genetlink_exit(void)
2151{
2152	genl_unregister_family(&thermal_event_genl_family);
2153}
2154#else /* !CONFIG_NET */
2155static inline int genetlink_init(void) { return 0; }
2156static inline void genetlink_exit(void) {}
2157#endif /* !CONFIG_NET */
2158
2159static int __init thermal_register_governors(void)
2160{
2161	int result;
2162
2163	result = thermal_gov_step_wise_register();
2164	if (result)
2165		return result;
2166
2167	result = thermal_gov_fair_share_register();
2168	if (result)
2169		return result;
2170
2171	result = thermal_gov_bang_bang_register();
2172	if (result)
2173		return result;
2174
2175	result = thermal_gov_user_space_register();
2176	if (result)
2177		return result;
2178
2179	return thermal_gov_power_allocator_register();
2180}
2181
2182static void thermal_unregister_governors(void)
2183{
2184	thermal_gov_step_wise_unregister();
2185	thermal_gov_fair_share_unregister();
2186	thermal_gov_bang_bang_unregister();
2187	thermal_gov_user_space_unregister();
2188	thermal_gov_power_allocator_unregister();
2189}
2190
2191static int thermal_pm_notify(struct notifier_block *nb,
2192				unsigned long mode, void *_unused)
2193{
2194	struct thermal_zone_device *tz;
 
2195
2196	switch (mode) {
2197	case PM_HIBERNATION_PREPARE:
2198	case PM_RESTORE_PREPARE:
2199	case PM_SUSPEND_PREPARE:
2200		atomic_set(&in_suspend, 1);
2201		break;
2202	case PM_POST_HIBERNATION:
2203	case PM_POST_RESTORE:
2204	case PM_POST_SUSPEND:
2205		atomic_set(&in_suspend, 0);
2206		list_for_each_entry(tz, &thermal_tz_list, node) {
2207			thermal_zone_device_reset(tz);
2208			thermal_zone_device_update(tz);
 
 
 
 
 
 
 
 
2209		}
2210		break;
2211	default:
2212		break;
2213	}
2214	return 0;
2215}
2216
2217static struct notifier_block thermal_pm_nb = {
2218	.notifier_call = thermal_pm_notify,
2219};
2220
2221static int __init thermal_init(void)
2222{
2223	int result;
2224
 
2225	result = thermal_register_governors();
2226	if (result)
2227		goto error;
2228
2229	result = class_register(&thermal_class);
2230	if (result)
2231		goto unregister_governors;
2232
2233	result = genetlink_init();
2234	if (result)
2235		goto unregister_class;
2236
2237	result = of_parse_thermal_zones();
2238	if (result)
2239		goto exit_netlink;
2240
2241	result = register_pm_notifier(&thermal_pm_nb);
2242	if (result)
2243		pr_warn("Thermal: Can not register suspend notifier, return %d\n",
2244			result);
2245
2246	return 0;
2247
2248exit_netlink:
2249	genetlink_exit();
2250unregister_class:
2251	class_unregister(&thermal_class);
2252unregister_governors:
2253	thermal_unregister_governors();
2254error:
2255	idr_destroy(&thermal_tz_idr);
2256	idr_destroy(&thermal_cdev_idr);
2257	mutex_destroy(&thermal_idr_lock);
2258	mutex_destroy(&thermal_list_lock);
2259	mutex_destroy(&thermal_governor_lock);
 
2260	return result;
2261}
2262
2263static void __exit thermal_exit(void)
2264{
2265	unregister_pm_notifier(&thermal_pm_nb);
2266	of_thermal_destroy_zones();
2267	genetlink_exit();
2268	class_unregister(&thermal_class);
2269	thermal_unregister_governors();
2270	idr_destroy(&thermal_tz_idr);
2271	idr_destroy(&thermal_cdev_idr);
2272	mutex_destroy(&thermal_idr_lock);
2273	mutex_destroy(&thermal_list_lock);
2274	mutex_destroy(&thermal_governor_lock);
2275}
2276
2277fs_initcall(thermal_init);
2278module_exit(thermal_exit);
v5.4
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 *  thermal.c - Generic Thermal Management Sysfs support.
   4 *
   5 *  Copyright (C) 2008 Intel Corp
   6 *  Copyright (C) 2008 Zhang Rui <rui.zhang@intel.com>
   7 *  Copyright (C) 2008 Sujith Thomas <sujith.thomas@intel.com>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
   8 */
   9
  10#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  11
  12#include <linux/module.h>
  13#include <linux/device.h>
  14#include <linux/err.h>
  15#include <linux/slab.h>
  16#include <linux/kdev_t.h>
  17#include <linux/idr.h>
  18#include <linux/thermal.h>
  19#include <linux/reboot.h>
  20#include <linux/string.h>
  21#include <linux/of.h>
  22#include <net/netlink.h>
  23#include <net/genetlink.h>
  24#include <linux/suspend.h>
  25
  26#define CREATE_TRACE_POINTS
  27#include <trace/events/thermal.h>
  28
  29#include "thermal_core.h"
  30#include "thermal_hwmon.h"
  31
  32MODULE_AUTHOR("Zhang Rui");
  33MODULE_DESCRIPTION("Generic thermal management sysfs support");
  34MODULE_LICENSE("GPL v2");
  35
  36static DEFINE_IDA(thermal_tz_ida);
  37static DEFINE_IDA(thermal_cdev_ida);
 
  38
  39static LIST_HEAD(thermal_tz_list);
  40static LIST_HEAD(thermal_cdev_list);
  41static LIST_HEAD(thermal_governor_list);
  42
  43static DEFINE_MUTEX(thermal_list_lock);
  44static DEFINE_MUTEX(thermal_governor_lock);
  45static DEFINE_MUTEX(poweroff_lock);
  46
  47static atomic_t in_suspend;
  48static bool power_off_triggered;
  49
  50static struct thermal_governor *def_governor;
  51
  52/*
  53 * Governor section: set of functions to handle thermal governors
  54 *
  55 * Functions to help in the life cycle of thermal governors within
  56 * the thermal core and by the thermal governor code.
  57 */
  58
  59static struct thermal_governor *__find_governor(const char *name)
  60{
  61	struct thermal_governor *pos;
  62
  63	if (!name || !name[0])
  64		return def_governor;
  65
  66	list_for_each_entry(pos, &thermal_governor_list, governor_list)
  67		if (!strncasecmp(name, pos->name, THERMAL_NAME_LENGTH))
  68			return pos;
  69
  70	return NULL;
  71}
  72
  73/**
  74 * bind_previous_governor() - bind the previous governor of the thermal zone
  75 * @tz:		a valid pointer to a struct thermal_zone_device
  76 * @failed_gov_name:	the name of the governor that failed to register
  77 *
  78 * Register the previous governor of the thermal zone after a new
  79 * governor has failed to be bound.
  80 */
  81static void bind_previous_governor(struct thermal_zone_device *tz,
  82				   const char *failed_gov_name)
  83{
  84	if (tz->governor && tz->governor->bind_to_tz) {
  85		if (tz->governor->bind_to_tz(tz)) {
  86			dev_err(&tz->device,
  87				"governor %s failed to bind and the previous one (%s) failed to bind again, thermal zone %s has no governor\n",
  88				failed_gov_name, tz->governor->name, tz->type);
  89			tz->governor = NULL;
  90		}
  91	}
  92}
  93
  94/**
  95 * thermal_set_governor() - Switch to another governor
  96 * @tz:		a valid pointer to a struct thermal_zone_device
  97 * @new_gov:	pointer to the new governor
  98 *
  99 * Change the governor of thermal zone @tz.
 100 *
 101 * Return: 0 on success, an error if the new governor's bind_to_tz() failed.
 102 */
 103static int thermal_set_governor(struct thermal_zone_device *tz,
 104				struct thermal_governor *new_gov)
 105{
 106	int ret = 0;
 107
 108	if (tz->governor && tz->governor->unbind_from_tz)
 109		tz->governor->unbind_from_tz(tz);
 110
 111	if (new_gov && new_gov->bind_to_tz) {
 112		ret = new_gov->bind_to_tz(tz);
 113		if (ret) {
 114			bind_previous_governor(tz, new_gov->name);
 115
 116			return ret;
 117		}
 118	}
 119
 120	tz->governor = new_gov;
 121
 122	return ret;
 123}
 124
 125int thermal_register_governor(struct thermal_governor *governor)
 126{
 127	int err;
 128	const char *name;
 129	struct thermal_zone_device *pos;
 130
 131	if (!governor)
 132		return -EINVAL;
 133
 134	mutex_lock(&thermal_governor_lock);
 135
 136	err = -EBUSY;
 137	if (!__find_governor(governor->name)) {
 138		bool match_default;
 139
 140		err = 0;
 141		list_add(&governor->governor_list, &thermal_governor_list);
 142		match_default = !strncmp(governor->name,
 143					 DEFAULT_THERMAL_GOVERNOR,
 144					 THERMAL_NAME_LENGTH);
 145
 146		if (!def_governor && match_default)
 147			def_governor = governor;
 148	}
 149
 150	mutex_lock(&thermal_list_lock);
 151
 152	list_for_each_entry(pos, &thermal_tz_list, node) {
 153		/*
 154		 * only thermal zones with specified tz->tzp->governor_name
 155		 * may run with tz->govenor unset
 156		 */
 157		if (pos->governor)
 158			continue;
 159
 160		name = pos->tzp->governor_name;
 161
 162		if (!strncasecmp(name, governor->name, THERMAL_NAME_LENGTH)) {
 163			int ret;
 164
 165			ret = thermal_set_governor(pos, governor);
 166			if (ret)
 167				dev_err(&pos->device,
 168					"Failed to set governor %s for thermal zone %s: %d\n",
 169					governor->name, pos->type, ret);
 170		}
 171	}
 172
 173	mutex_unlock(&thermal_list_lock);
 174	mutex_unlock(&thermal_governor_lock);
 175
 176	return err;
 177}
 178
 179void thermal_unregister_governor(struct thermal_governor *governor)
 180{
 181	struct thermal_zone_device *pos;
 182
 183	if (!governor)
 184		return;
 185
 186	mutex_lock(&thermal_governor_lock);
 187
 188	if (!__find_governor(governor->name))
 189		goto exit;
 190
 191	mutex_lock(&thermal_list_lock);
 192
 193	list_for_each_entry(pos, &thermal_tz_list, node) {
 194		if (!strncasecmp(pos->governor->name, governor->name,
 195				 THERMAL_NAME_LENGTH))
 196			thermal_set_governor(pos, NULL);
 197	}
 198
 199	mutex_unlock(&thermal_list_lock);
 200	list_del(&governor->governor_list);
 201exit:
 202	mutex_unlock(&thermal_governor_lock);
 
 203}
 204
 205int thermal_zone_device_set_policy(struct thermal_zone_device *tz,
 206				   char *policy)
 207{
 208	struct thermal_governor *gov;
 209	int ret = -EINVAL;
 210
 211	mutex_lock(&thermal_governor_lock);
 212	mutex_lock(&tz->lock);
 
 
 
 
 
 
 
 
 213
 214	gov = __find_governor(strim(policy));
 215	if (!gov)
 216		goto exit;
 
 
 
 
 
 217
 218	ret = thermal_set_governor(tz, gov);
 
 
 219
 220exit:
 221	mutex_unlock(&tz->lock);
 222	mutex_unlock(&thermal_governor_lock);
 
 
 
 
 
 
 223
 224	return ret;
 225}
 
 226
 227int thermal_build_list_of_policies(char *buf)
 
 228{
 229	struct thermal_governor *pos;
 230	ssize_t count = 0;
 231	ssize_t size = PAGE_SIZE;
 232
 233	mutex_lock(&thermal_governor_lock);
 
 234
 235	list_for_each_entry(pos, &thermal_governor_list, governor_list) {
 236		size = PAGE_SIZE - count;
 237		count += scnprintf(buf + count, size, "%s ", pos->name);
 
 
 238	}
 239	count += scnprintf(buf + count, size, "\n");
 240
 241	mutex_unlock(&thermal_governor_lock);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 242
 243	return count;
 
 
 
 
 
 
 
 
 
 
 
 
 244}
 245
 246static void __init thermal_unregister_governors(void)
 
 247{
 248	struct thermal_governor **governor;
 249
 250	for_each_governor_table(governor)
 251		thermal_unregister_governor(*governor);
 
 252}
 253
 254static int __init thermal_register_governors(void)
 255{
 256	int ret = 0;
 257	struct thermal_governor **governor;
 
 
 
 
 
 
 
 258
 259	for_each_governor_table(governor) {
 260		ret = thermal_register_governor(*governor);
 261		if (ret) {
 262			pr_err("Failed to register governor: '%s'",
 263			       (*governor)->name);
 264			break;
 265		}
 266
 267		pr_info("Registered thermal governor '%s'",
 268			(*governor)->name);
 
 
 
 
 
 
 
 
 
 
 
 
 269	}
 270
 271	if (ret) {
 272		struct thermal_governor **gov;
 
 
 
 
 
 
 
 
 
 
 
 273
 274		for_each_governor_table(gov) {
 275			if (gov == governor)
 276				break;
 277			thermal_unregister_governor(*gov);
 
 
 278		}
 
 279	}
 280
 281	return ret;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 282}
 283
 284/*
 285 * Zone update section: main control loop applied to each zone while monitoring
 286 *
 287 * in polling mode. The monitoring is done using a workqueue.
 288 * Same update may be done on a zone by calling thermal_zone_device_update().
 289 *
 290 * An update means:
 291 * - Non-critical trips will invoke the governor responsible for that zone;
 292 * - Hot trips will produce a notification to userspace;
 293 * - Critical trip point will cause a system shutdown.
 294 */
 295static void thermal_zone_device_set_polling(struct thermal_zone_device *tz,
 296					    int delay)
 297{
 298	if (delay > 1000)
 299		mod_delayed_work(system_freezable_power_efficient_wq,
 300				 &tz->poll_queue,
 301				 round_jiffies(msecs_to_jiffies(delay)));
 302	else if (delay)
 303		mod_delayed_work(system_freezable_power_efficient_wq,
 304				 &tz->poll_queue,
 305				 msecs_to_jiffies(delay));
 306	else
 307		cancel_delayed_work_sync(&tz->poll_queue);
 308}
 309
 310static void monitor_thermal_zone(struct thermal_zone_device *tz)
 311{
 312	mutex_lock(&tz->lock);
 313
 314	if (tz->passive)
 315		thermal_zone_device_set_polling(tz, tz->passive_delay);
 316	else if (tz->polling_delay)
 317		thermal_zone_device_set_polling(tz, tz->polling_delay);
 318	else
 319		thermal_zone_device_set_polling(tz, 0);
 320
 321	mutex_unlock(&tz->lock);
 322}
 323
 324static void handle_non_critical_trips(struct thermal_zone_device *tz, int trip)
 
 325{
 326	tz->governor ? tz->governor->throttle(tz, trip) :
 327		       def_governor->throttle(tz, trip);
 328}
 329
 330/**
 331 * thermal_emergency_poweroff_func - emergency poweroff work after a known delay
 332 * @work: work_struct associated with the emergency poweroff function
 333 *
 334 * This function is called in very critical situations to force
 335 * a kernel poweroff after a configurable timeout value.
 336 */
 337static void thermal_emergency_poweroff_func(struct work_struct *work)
 338{
 339	/*
 340	 * We have reached here after the emergency thermal shutdown
 341	 * Waiting period has expired. This means orderly_poweroff has
 342	 * not been able to shut off the system for some reason.
 343	 * Try to shut down the system immediately using kernel_power_off
 344	 * if populated
 345	 */
 346	WARN(1, "Attempting kernel_power_off: Temperature too high\n");
 347	kernel_power_off();
 348
 349	/*
 350	 * Worst of the worst case trigger emergency restart
 351	 */
 352	WARN(1, "Attempting emergency_restart: Temperature too high\n");
 353	emergency_restart();
 354}
 355
 356static DECLARE_DELAYED_WORK(thermal_emergency_poweroff_work,
 357			    thermal_emergency_poweroff_func);
 358
 359/**
 360 * thermal_emergency_poweroff - Trigger an emergency system poweroff
 361 *
 362 * This may be called from any critical situation to trigger a system shutdown
 363 * after a known period of time. By default this is not scheduled.
 364 */
 365static void thermal_emergency_poweroff(void)
 366{
 367	int poweroff_delay_ms = CONFIG_THERMAL_EMERGENCY_POWEROFF_DELAY_MS;
 368	/*
 369	 * poweroff_delay_ms must be a carefully profiled positive value.
 370	 * Its a must for thermal_emergency_poweroff_work to be scheduled
 371	 */
 372	if (poweroff_delay_ms <= 0)
 373		return;
 374	schedule_delayed_work(&thermal_emergency_poweroff_work,
 375			      msecs_to_jiffies(poweroff_delay_ms));
 376}
 377
 378static void handle_critical_trips(struct thermal_zone_device *tz,
 379				  int trip, enum thermal_trip_type trip_type)
 380{
 381	int trip_temp;
 382
 383	tz->ops->get_trip_temp(tz, trip, &trip_temp);
 384
 385	/* If we have not crossed the trip_temp, we do not care. */
 386	if (trip_temp <= 0 || tz->temperature < trip_temp)
 387		return;
 388
 389	trace_thermal_zone_trip(tz, trip, trip_type);
 390
 391	if (tz->ops->notify)
 392		tz->ops->notify(tz, trip, trip_type);
 393
 394	if (trip_type == THERMAL_TRIP_CRITICAL) {
 395		dev_emerg(&tz->device,
 396			  "critical temperature reached (%d C), shutting down\n",
 397			  tz->temperature / 1000);
 398		mutex_lock(&poweroff_lock);
 399		if (!power_off_triggered) {
 400			/*
 401			 * Queue a backup emergency shutdown in the event of
 402			 * orderly_poweroff failure
 403			 */
 404			thermal_emergency_poweroff();
 405			orderly_poweroff(true);
 406			power_off_triggered = true;
 407		}
 408		mutex_unlock(&poweroff_lock);
 409	}
 410}
 411
 412static void handle_thermal_trip(struct thermal_zone_device *tz, int trip)
 413{
 414	enum thermal_trip_type type;
 415
 416	/* Ignore disabled trip points */
 417	if (test_bit(trip, &tz->trips_disabled))
 418		return;
 419
 420	tz->ops->get_trip_type(tz, trip, &type);
 421
 422	if (type == THERMAL_TRIP_CRITICAL || type == THERMAL_TRIP_HOT)
 423		handle_critical_trips(tz, trip, type);
 424	else
 425		handle_non_critical_trips(tz, trip);
 426	/*
 427	 * Alright, we handled this trip successfully.
 428	 * So, start monitoring again.
 429	 */
 430	monitor_thermal_zone(tz);
 431}
 432
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 433static void update_temperature(struct thermal_zone_device *tz)
 434{
 435	int temp, ret;
 436
 437	ret = thermal_zone_get_temp(tz, &temp);
 438	if (ret) {
 439		if (ret != -EAGAIN)
 440			dev_warn(&tz->device,
 441				 "failed to read out thermal zone (%d)\n",
 442				 ret);
 443		return;
 444	}
 445
 446	mutex_lock(&tz->lock);
 447	tz->last_temperature = tz->temperature;
 448	tz->temperature = temp;
 449	mutex_unlock(&tz->lock);
 450
 451	trace_thermal_temperature(tz);
 452	if (tz->last_temperature == THERMAL_TEMP_INVALID)
 453		dev_dbg(&tz->device, "last_temperature N/A, current_temperature=%d\n",
 454			tz->temperature);
 455	else
 456		dev_dbg(&tz->device, "last_temperature=%d, current_temperature=%d\n",
 457			tz->last_temperature, tz->temperature);
 458}
 459
 460static void thermal_zone_device_init(struct thermal_zone_device *tz)
 461{
 462	struct thermal_instance *pos;
 
 463	tz->temperature = THERMAL_TEMP_INVALID;
 
 464	list_for_each_entry(pos, &tz->thermal_instances, tz_node)
 465		pos->initialized = false;
 466}
 467
 468static void thermal_zone_device_reset(struct thermal_zone_device *tz)
 469{
 470	tz->passive = 0;
 471	thermal_zone_device_init(tz);
 472}
 473
 474void thermal_zone_device_update(struct thermal_zone_device *tz,
 475				enum thermal_notify_event event)
 476{
 477	int count;
 478
 479	if (atomic_read(&in_suspend))
 480		return;
 481
 482	if (!tz->ops->get_temp)
 483		return;
 484
 485	update_temperature(tz);
 486
 487	thermal_zone_set_trips(tz);
 488
 489	tz->notify_event = event;
 490
 491	for (count = 0; count < tz->trips; count++)
 492		handle_thermal_trip(tz, count);
 493}
 494EXPORT_SYMBOL_GPL(thermal_zone_device_update);
 495
 496/**
 497 * thermal_notify_framework - Sensor drivers use this API to notify framework
 498 * @tz:		thermal zone device
 499 * @trip:	indicates which trip point has been crossed
 500 *
 501 * This function handles the trip events from sensor drivers. It starts
 502 * throttling the cooling devices according to the policy configured.
 503 * For CRITICAL and HOT trip points, this notifies the respective drivers,
 504 * and does actual throttling for other trip points i.e ACTIVE and PASSIVE.
 505 * The throttling policy is based on the configured platform data; if no
 506 * platform data is provided, this uses the step_wise throttling policy.
 507 */
 508void thermal_notify_framework(struct thermal_zone_device *tz, int trip)
 509{
 510	handle_thermal_trip(tz, trip);
 511}
 512EXPORT_SYMBOL_GPL(thermal_notify_framework);
 513
 514static void thermal_zone_device_check(struct work_struct *work)
 515{
 516	struct thermal_zone_device *tz = container_of(work, struct
 517						      thermal_zone_device,
 518						      poll_queue.work);
 519	thermal_zone_device_update(tz, THERMAL_EVENT_UNSPECIFIED);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 520}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 521
 522/*
 523 * Power actor section: interface to power actors to estimate power
 524 *
 525 * Set of functions used to interact to cooling devices that know
 526 * how to estimate their devices power consumption.
 527 */
 
 
 
 
 
 528
 529/**
 530 * power_actor_get_max_power() - get the maximum power that a cdev can consume
 531 * @cdev:	pointer to &thermal_cooling_device
 532 * @tz:		a valid thermal zone device pointer
 533 * @max_power:	pointer in which to store the maximum power
 534 *
 535 * Calculate the maximum power consumption in milliwats that the
 536 * cooling device can currently consume and store it in @max_power.
 537 *
 538 * Return: 0 on success, -EINVAL if @cdev doesn't support the
 539 * power_actor API or -E* on other error.
 540 */
 541int power_actor_get_max_power(struct thermal_cooling_device *cdev,
 542			      struct thermal_zone_device *tz, u32 *max_power)
 543{
 544	if (!cdev_is_power_actor(cdev))
 545		return -EINVAL;
 546
 547	return cdev->ops->state2power(cdev, tz, 0, max_power);
 548}
 549
 550/**
 551 * power_actor_get_min_power() - get the mainimum power that a cdev can consume
 552 * @cdev:	pointer to &thermal_cooling_device
 553 * @tz:		a valid thermal zone device pointer
 554 * @min_power:	pointer in which to store the minimum power
 555 *
 556 * Calculate the minimum power consumption in milliwatts that the
 557 * cooling device can currently consume and store it in @min_power.
 558 *
 559 * Return: 0 on success, -EINVAL if @cdev doesn't support the
 560 * power_actor API or -E* on other error.
 561 */
 562int power_actor_get_min_power(struct thermal_cooling_device *cdev,
 563			      struct thermal_zone_device *tz, u32 *min_power)
 564{
 565	unsigned long max_state;
 566	int ret;
 567
 568	if (!cdev_is_power_actor(cdev))
 569		return -EINVAL;
 570
 571	ret = cdev->ops->get_max_state(cdev, &max_state);
 572	if (ret)
 573		return ret;
 574
 575	return cdev->ops->state2power(cdev, tz, max_state, min_power);
 576}
 577
 578/**
 579 * power_actor_set_power() - limit the maximum power a cooling device consumes
 580 * @cdev:	pointer to &thermal_cooling_device
 581 * @instance:	thermal instance to update
 582 * @power:	the power in milliwatts
 583 *
 584 * Set the cooling device to consume at most @power milliwatts. The limit is
 585 * expected to be a cap at the maximum power consumption.
 586 *
 587 * Return: 0 on success, -EINVAL if the cooling device does not
 588 * implement the power actor API or -E* for other failures.
 589 */
 590int power_actor_set_power(struct thermal_cooling_device *cdev,
 591			  struct thermal_instance *instance, u32 power)
 592{
 593	unsigned long state;
 594	int ret;
 595
 596	if (!cdev_is_power_actor(cdev))
 597		return -EINVAL;
 598
 599	ret = cdev->ops->power2state(cdev, instance->tz, power, &state);
 600	if (ret)
 601		return ret;
 602
 603	instance->target = state;
 604	mutex_lock(&cdev->lock);
 605	cdev->updated = false;
 606	mutex_unlock(&cdev->lock);
 607	thermal_cdev_update(cdev);
 608
 609	return 0;
 610}
 611
 612void thermal_zone_device_rebind_exception(struct thermal_zone_device *tz,
 613					  const char *cdev_type, size_t size)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 614{
 615	struct thermal_cooling_device *cdev = NULL;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 616
 617	mutex_lock(&thermal_list_lock);
 618	list_for_each_entry(cdev, &thermal_cdev_list, node) {
 619		/* skip non matching cdevs */
 620		if (strncmp(cdev_type, cdev->type, size))
 621			continue;
 622
 623		/* re binding the exception matching the type pattern */
 624		thermal_zone_bind_cooling_device(tz, THERMAL_TRIPS_NONE, cdev,
 625						 THERMAL_NO_LIMIT,
 626						 THERMAL_NO_LIMIT,
 627						 THERMAL_WEIGHT_DEFAULT);
 628	}
 629	mutex_unlock(&thermal_list_lock);
 630}
 631
 632void thermal_zone_device_unbind_exception(struct thermal_zone_device *tz,
 633					  const char *cdev_type, size_t size)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 634{
 635	struct thermal_cooling_device *cdev = NULL;
 
 
 636
 637	mutex_lock(&thermal_list_lock);
 638	list_for_each_entry(cdev, &thermal_cdev_list, node) {
 639		/* skip non matching cdevs */
 640		if (strncmp(cdev_type, cdev->type, size))
 641			continue;
 642		/* unbinding the exception matching the type pattern */
 643		thermal_zone_unbind_cooling_device(tz, THERMAL_TRIPS_NONE,
 644						   cdev);
 645	}
 646	mutex_unlock(&thermal_list_lock);
 647}
 648
 649/*
 650 * Device management section: cooling devices, zones devices, and binding
 651 *
 652 * Set of functions provided by the thermal core for:
 653 * - cooling devices lifecycle: registration, unregistration,
 654 *				binding, and unbinding.
 655 * - thermal zone devices lifecycle: registration, unregistration,
 656 *				     binding, and unbinding.
 657 */
 
 
 
 
 
 
 
 
 
 658
 659/**
 660 * thermal_zone_bind_cooling_device() - bind a cooling device to a thermal zone
 661 * @tz:		pointer to struct thermal_zone_device
 662 * @trip:	indicates which trip point the cooling devices is
 663 *		associated with in this thermal zone.
 664 * @cdev:	pointer to struct thermal_cooling_device
 665 * @upper:	the Maximum cooling state for this trip point.
 666 *		THERMAL_NO_LIMIT means no upper limit,
 667 *		and the cooling device can be in max_state.
 668 * @lower:	the Minimum cooling state can be used for this trip point.
 669 *		THERMAL_NO_LIMIT means no lower limit,
 670 *		and the cooling device can be in cooling state 0.
 671 * @weight:	The weight of the cooling device to be bound to the
 672 *		thermal zone. Use THERMAL_WEIGHT_DEFAULT for the
 673 *		default value
 674 *
 675 * This interface function bind a thermal cooling device to the certain trip
 676 * point of a thermal zone device.
 677 * This function is usually called in the thermal zone device .bind callback.
 678 *
 679 * Return: 0 on success, the proper error value otherwise.
 680 */
 681int thermal_zone_bind_cooling_device(struct thermal_zone_device *tz,
 682				     int trip,
 683				     struct thermal_cooling_device *cdev,
 684				     unsigned long upper, unsigned long lower,
 685				     unsigned int weight)
 686{
 687	struct thermal_instance *dev;
 688	struct thermal_instance *pos;
 689	struct thermal_zone_device *pos1;
 690	struct thermal_cooling_device *pos2;
 691	unsigned long max_state;
 692	int result, ret;
 693
 694	if (trip >= tz->trips || (trip < 0 && trip != THERMAL_TRIPS_NONE))
 695		return -EINVAL;
 696
 697	list_for_each_entry(pos1, &thermal_tz_list, node) {
 698		if (pos1 == tz)
 699			break;
 700	}
 701	list_for_each_entry(pos2, &thermal_cdev_list, node) {
 702		if (pos2 == cdev)
 703			break;
 704	}
 705
 706	if (tz != pos1 || cdev != pos2)
 707		return -EINVAL;
 708
 709	ret = cdev->ops->get_max_state(cdev, &max_state);
 710	if (ret)
 711		return ret;
 712
 713	/* lower default 0, upper default max_state */
 714	lower = lower == THERMAL_NO_LIMIT ? 0 : lower;
 715	upper = upper == THERMAL_NO_LIMIT ? max_state : upper;
 716
 717	if (lower > upper || upper > max_state)
 718		return -EINVAL;
 719
 720	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
 
 721	if (!dev)
 722		return -ENOMEM;
 723	dev->tz = tz;
 724	dev->cdev = cdev;
 725	dev->trip = trip;
 726	dev->upper = upper;
 727	dev->lower = lower;
 728	dev->target = THERMAL_NO_TARGET;
 729	dev->weight = weight;
 730
 731	result = ida_simple_get(&tz->ida, 0, 0, GFP_KERNEL);
 732	if (result < 0)
 733		goto free_mem;
 734
 735	dev->id = result;
 736	sprintf(dev->name, "cdev%d", dev->id);
 737	result =
 738	    sysfs_create_link(&tz->device.kobj, &cdev->device.kobj, dev->name);
 739	if (result)
 740		goto release_ida;
 741
 742	sprintf(dev->attr_name, "cdev%d_trip_point", dev->id);
 743	sysfs_attr_init(&dev->attr.attr);
 744	dev->attr.attr.name = dev->attr_name;
 745	dev->attr.attr.mode = 0444;
 746	dev->attr.show = trip_point_show;
 747	result = device_create_file(&tz->device, &dev->attr);
 748	if (result)
 749		goto remove_symbol_link;
 750
 751	sprintf(dev->weight_attr_name, "cdev%d_weight", dev->id);
 752	sysfs_attr_init(&dev->weight_attr.attr);
 753	dev->weight_attr.attr.name = dev->weight_attr_name;
 754	dev->weight_attr.attr.mode = S_IWUSR | S_IRUGO;
 755	dev->weight_attr.show = weight_show;
 756	dev->weight_attr.store = weight_store;
 757	result = device_create_file(&tz->device, &dev->weight_attr);
 758	if (result)
 759		goto remove_trip_file;
 760
 761	mutex_lock(&tz->lock);
 762	mutex_lock(&cdev->lock);
 763	list_for_each_entry(pos, &tz->thermal_instances, tz_node)
 764		if (pos->tz == tz && pos->trip == trip && pos->cdev == cdev) {
 765			result = -EEXIST;
 766			break;
 767		}
 768	if (!result) {
 769		list_add_tail(&dev->tz_node, &tz->thermal_instances);
 770		list_add_tail(&dev->cdev_node, &cdev->thermal_instances);
 771		atomic_set(&tz->need_update, 1);
 772	}
 773	mutex_unlock(&cdev->lock);
 774	mutex_unlock(&tz->lock);
 775
 776	if (!result)
 777		return 0;
 778
 779	device_remove_file(&tz->device, &dev->weight_attr);
 780remove_trip_file:
 781	device_remove_file(&tz->device, &dev->attr);
 782remove_symbol_link:
 783	sysfs_remove_link(&tz->device.kobj, dev->name);
 784release_ida:
 785	ida_simple_remove(&tz->ida, dev->id);
 786free_mem:
 787	kfree(dev);
 788	return result;
 789}
 790EXPORT_SYMBOL_GPL(thermal_zone_bind_cooling_device);
 791
 792/**
 793 * thermal_zone_unbind_cooling_device() - unbind a cooling device from a
 794 *					  thermal zone.
 795 * @tz:		pointer to a struct thermal_zone_device.
 796 * @trip:	indicates which trip point the cooling devices is
 797 *		associated with in this thermal zone.
 798 * @cdev:	pointer to a struct thermal_cooling_device.
 799 *
 800 * This interface function unbind a thermal cooling device from the certain
 801 * trip point of a thermal zone device.
 802 * This function is usually called in the thermal zone device .unbind callback.
 803 *
 804 * Return: 0 on success, the proper error value otherwise.
 805 */
 806int thermal_zone_unbind_cooling_device(struct thermal_zone_device *tz,
 807				       int trip,
 808				       struct thermal_cooling_device *cdev)
 809{
 810	struct thermal_instance *pos, *next;
 811
 812	mutex_lock(&tz->lock);
 813	mutex_lock(&cdev->lock);
 814	list_for_each_entry_safe(pos, next, &tz->thermal_instances, tz_node) {
 815		if (pos->tz == tz && pos->trip == trip && pos->cdev == cdev) {
 816			list_del(&pos->tz_node);
 817			list_del(&pos->cdev_node);
 818			mutex_unlock(&cdev->lock);
 819			mutex_unlock(&tz->lock);
 820			goto unbind;
 821		}
 822	}
 823	mutex_unlock(&cdev->lock);
 824	mutex_unlock(&tz->lock);
 825
 826	return -ENODEV;
 827
 828unbind:
 829	device_remove_file(&tz->device, &pos->weight_attr);
 830	device_remove_file(&tz->device, &pos->attr);
 831	sysfs_remove_link(&tz->device.kobj, pos->name);
 832	ida_simple_remove(&tz->ida, pos->id);
 833	kfree(pos);
 834	return 0;
 835}
 836EXPORT_SYMBOL_GPL(thermal_zone_unbind_cooling_device);
 837
 838static void thermal_release(struct device *dev)
 839{
 840	struct thermal_zone_device *tz;
 841	struct thermal_cooling_device *cdev;
 842
 843	if (!strncmp(dev_name(dev), "thermal_zone",
 844		     sizeof("thermal_zone") - 1)) {
 845		tz = to_thermal_zone(dev);
 846		thermal_zone_destroy_device_groups(tz);
 847		kfree(tz);
 848	} else if (!strncmp(dev_name(dev), "cooling_device",
 849			    sizeof("cooling_device") - 1)) {
 850		cdev = to_cooling_device(dev);
 851		kfree(cdev);
 852	}
 853}
 854
 855static struct class thermal_class = {
 856	.name = "thermal",
 857	.dev_release = thermal_release,
 858};
 859
 860static inline
 861void print_bind_err_msg(struct thermal_zone_device *tz,
 862			struct thermal_cooling_device *cdev, int ret)
 863{
 864	dev_err(&tz->device, "binding zone %s with cdev %s failed:%d\n",
 865		tz->type, cdev->type, ret);
 866}
 867
 868static void __bind(struct thermal_zone_device *tz, int mask,
 869		   struct thermal_cooling_device *cdev,
 870		   unsigned long *limits,
 871		   unsigned int weight)
 872{
 873	int i, ret;
 874
 875	for (i = 0; i < tz->trips; i++) {
 876		if (mask & (1 << i)) {
 877			unsigned long upper, lower;
 878
 879			upper = THERMAL_NO_LIMIT;
 880			lower = THERMAL_NO_LIMIT;
 881			if (limits) {
 882				lower = limits[i * 2];
 883				upper = limits[i * 2 + 1];
 884			}
 885			ret = thermal_zone_bind_cooling_device(tz, i, cdev,
 886							       upper, lower,
 887							       weight);
 888			if (ret)
 889				print_bind_err_msg(tz, cdev, ret);
 890		}
 891	}
 892}
 893
 894static void bind_cdev(struct thermal_cooling_device *cdev)
 895{
 896	int i, ret;
 897	const struct thermal_zone_params *tzp;
 898	struct thermal_zone_device *pos = NULL;
 899
 900	mutex_lock(&thermal_list_lock);
 901
 902	list_for_each_entry(pos, &thermal_tz_list, node) {
 903		if (!pos->tzp && !pos->ops->bind)
 904			continue;
 905
 906		if (pos->ops->bind) {
 907			ret = pos->ops->bind(pos, cdev);
 908			if (ret)
 909				print_bind_err_msg(pos, cdev, ret);
 910			continue;
 911		}
 912
 913		tzp = pos->tzp;
 914		if (!tzp || !tzp->tbp)
 915			continue;
 916
 917		for (i = 0; i < tzp->num_tbps; i++) {
 918			if (tzp->tbp[i].cdev || !tzp->tbp[i].match)
 919				continue;
 920			if (tzp->tbp[i].match(pos, cdev))
 921				continue;
 922			tzp->tbp[i].cdev = cdev;
 923			__bind(pos, tzp->tbp[i].trip_mask, cdev,
 924			       tzp->tbp[i].binding_limits,
 925			       tzp->tbp[i].weight);
 926		}
 927	}
 928
 929	mutex_unlock(&thermal_list_lock);
 930}
 931
 932/**
 933 * __thermal_cooling_device_register() - register a new thermal cooling device
 934 * @np:		a pointer to a device tree node.
 935 * @type:	the thermal cooling device type.
 936 * @devdata:	device private data.
 937 * @ops:		standard thermal cooling devices callbacks.
 938 *
 939 * This interface function adds a new thermal cooling device (fan/processor/...)
 940 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
 941 * to all the thermal zone devices registered at the same time.
 942 * It also gives the opportunity to link the cooling device to a device tree
 943 * node, so that it can be bound to a thermal zone created out of device tree.
 944 *
 945 * Return: a pointer to the created struct thermal_cooling_device or an
 946 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
 947 */
 948static struct thermal_cooling_device *
 949__thermal_cooling_device_register(struct device_node *np,
 950				  const char *type, void *devdata,
 951				  const struct thermal_cooling_device_ops *ops)
 952{
 953	struct thermal_cooling_device *cdev;
 954	struct thermal_zone_device *pos = NULL;
 955	int result;
 956
 957	if (type && strlen(type) >= THERMAL_NAME_LENGTH)
 958		return ERR_PTR(-EINVAL);
 959
 960	if (!ops || !ops->get_max_state || !ops->get_cur_state ||
 961	    !ops->set_cur_state)
 962		return ERR_PTR(-EINVAL);
 963
 964	cdev = kzalloc(sizeof(*cdev), GFP_KERNEL);
 965	if (!cdev)
 966		return ERR_PTR(-ENOMEM);
 967
 968	result = ida_simple_get(&thermal_cdev_ida, 0, 0, GFP_KERNEL);
 969	if (result < 0) {
 970		kfree(cdev);
 971		return ERR_PTR(result);
 972	}
 973
 974	cdev->id = result;
 975	strlcpy(cdev->type, type ? : "", sizeof(cdev->type));
 976	mutex_init(&cdev->lock);
 977	INIT_LIST_HEAD(&cdev->thermal_instances);
 978	cdev->np = np;
 979	cdev->ops = ops;
 980	cdev->updated = false;
 981	cdev->device.class = &thermal_class;
 
 982	cdev->devdata = devdata;
 983	thermal_cooling_device_setup_sysfs(cdev);
 984	dev_set_name(&cdev->device, "cooling_device%d", cdev->id);
 985	result = device_register(&cdev->device);
 986	if (result) {
 987		ida_simple_remove(&thermal_cdev_ida, cdev->id);
 988		put_device(&cdev->device);
 989		return ERR_PTR(result);
 990	}
 991
 992	/* Add 'this' new cdev to the global cdev list */
 993	mutex_lock(&thermal_list_lock);
 994	list_add(&cdev->node, &thermal_cdev_list);
 995	mutex_unlock(&thermal_list_lock);
 996
 997	/* Update binding information for 'this' new cdev */
 998	bind_cdev(cdev);
 999
1000	mutex_lock(&thermal_list_lock);
1001	list_for_each_entry(pos, &thermal_tz_list, node)
1002		if (atomic_cmpxchg(&pos->need_update, 1, 0))
1003			thermal_zone_device_update(pos,
1004						   THERMAL_EVENT_UNSPECIFIED);
1005	mutex_unlock(&thermal_list_lock);
1006
1007	return cdev;
1008}
1009
1010/**
1011 * thermal_cooling_device_register() - register a new thermal cooling device
1012 * @type:	the thermal cooling device type.
1013 * @devdata:	device private data.
1014 * @ops:		standard thermal cooling devices callbacks.
1015 *
1016 * This interface function adds a new thermal cooling device (fan/processor/...)
1017 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1018 * to all the thermal zone devices registered at the same time.
1019 *
1020 * Return: a pointer to the created struct thermal_cooling_device or an
1021 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1022 */
1023struct thermal_cooling_device *
1024thermal_cooling_device_register(const char *type, void *devdata,
1025				const struct thermal_cooling_device_ops *ops)
1026{
1027	return __thermal_cooling_device_register(NULL, type, devdata, ops);
1028}
1029EXPORT_SYMBOL_GPL(thermal_cooling_device_register);
1030
1031/**
1032 * thermal_of_cooling_device_register() - register an OF thermal cooling device
1033 * @np:		a pointer to a device tree node.
1034 * @type:	the thermal cooling device type.
1035 * @devdata:	device private data.
1036 * @ops:		standard thermal cooling devices callbacks.
1037 *
1038 * This function will register a cooling device with device tree node reference.
1039 * This interface function adds a new thermal cooling device (fan/processor/...)
1040 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1041 * to all the thermal zone devices registered at the same time.
1042 *
1043 * Return: a pointer to the created struct thermal_cooling_device or an
1044 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1045 */
1046struct thermal_cooling_device *
1047thermal_of_cooling_device_register(struct device_node *np,
1048				   const char *type, void *devdata,
1049				   const struct thermal_cooling_device_ops *ops)
1050{
1051	return __thermal_cooling_device_register(np, type, devdata, ops);
1052}
1053EXPORT_SYMBOL_GPL(thermal_of_cooling_device_register);
1054
1055static void thermal_cooling_device_release(struct device *dev, void *res)
1056{
1057	thermal_cooling_device_unregister(
1058				*(struct thermal_cooling_device **)res);
1059}
1060
1061/**
1062 * devm_thermal_of_cooling_device_register() - register an OF thermal cooling
1063 *					       device
1064 * @dev:	a valid struct device pointer of a sensor device.
1065 * @np:		a pointer to a device tree node.
1066 * @type:	the thermal cooling device type.
1067 * @devdata:	device private data.
1068 * @ops:	standard thermal cooling devices callbacks.
1069 *
1070 * This function will register a cooling device with device tree node reference.
1071 * This interface function adds a new thermal cooling device (fan/processor/...)
1072 * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
1073 * to all the thermal zone devices registered at the same time.
1074 *
1075 * Return: a pointer to the created struct thermal_cooling_device or an
1076 * ERR_PTR. Caller must check return value with IS_ERR*() helpers.
1077 */
1078struct thermal_cooling_device *
1079devm_thermal_of_cooling_device_register(struct device *dev,
1080				struct device_node *np,
1081				char *type, void *devdata,
1082				const struct thermal_cooling_device_ops *ops)
1083{
1084	struct thermal_cooling_device **ptr, *tcd;
1085
1086	ptr = devres_alloc(thermal_cooling_device_release, sizeof(*ptr),
1087			   GFP_KERNEL);
1088	if (!ptr)
1089		return ERR_PTR(-ENOMEM);
1090
1091	tcd = __thermal_cooling_device_register(np, type, devdata, ops);
1092	if (IS_ERR(tcd)) {
1093		devres_free(ptr);
1094		return tcd;
1095	}
1096
1097	*ptr = tcd;
1098	devres_add(dev, ptr);
1099
1100	return tcd;
1101}
1102EXPORT_SYMBOL_GPL(devm_thermal_of_cooling_device_register);
1103
1104static void __unbind(struct thermal_zone_device *tz, int mask,
1105		     struct thermal_cooling_device *cdev)
1106{
1107	int i;
1108
1109	for (i = 0; i < tz->trips; i++)
1110		if (mask & (1 << i))
1111			thermal_zone_unbind_cooling_device(tz, i, cdev);
1112}
1113
1114/**
1115 * thermal_cooling_device_unregister - removes a thermal cooling device
1116 * @cdev:	the thermal cooling device to remove.
1117 *
1118 * thermal_cooling_device_unregister() must be called when a registered
1119 * thermal cooling device is no longer needed.
1120 */
1121void thermal_cooling_device_unregister(struct thermal_cooling_device *cdev)
1122{
1123	int i;
1124	const struct thermal_zone_params *tzp;
1125	struct thermal_zone_device *tz;
1126	struct thermal_cooling_device *pos = NULL;
1127
1128	if (!cdev)
1129		return;
1130
1131	mutex_lock(&thermal_list_lock);
1132	list_for_each_entry(pos, &thermal_cdev_list, node)
1133		if (pos == cdev)
1134			break;
1135	if (pos != cdev) {
1136		/* thermal cooling device not found */
1137		mutex_unlock(&thermal_list_lock);
1138		return;
1139	}
1140	list_del(&cdev->node);
1141
1142	/* Unbind all thermal zones associated with 'this' cdev */
1143	list_for_each_entry(tz, &thermal_tz_list, node) {
1144		if (tz->ops->unbind) {
1145			tz->ops->unbind(tz, cdev);
1146			continue;
1147		}
1148
1149		if (!tz->tzp || !tz->tzp->tbp)
1150			continue;
1151
1152		tzp = tz->tzp;
1153		for (i = 0; i < tzp->num_tbps; i++) {
1154			if (tzp->tbp[i].cdev == cdev) {
1155				__unbind(tz, tzp->tbp[i].trip_mask, cdev);
1156				tzp->tbp[i].cdev = NULL;
1157			}
1158		}
1159	}
1160
1161	mutex_unlock(&thermal_list_lock);
1162
1163	ida_simple_remove(&thermal_cdev_ida, cdev->id);
1164	device_del(&cdev->device);
1165	thermal_cooling_device_destroy_sysfs(cdev);
1166	put_device(&cdev->device);
 
 
 
 
1167}
1168EXPORT_SYMBOL_GPL(thermal_cooling_device_unregister);
1169
1170static void bind_tz(struct thermal_zone_device *tz)
1171{
1172	int i, ret;
1173	struct thermal_cooling_device *pos = NULL;
1174	const struct thermal_zone_params *tzp = tz->tzp;
1175
1176	if (!tzp && !tz->ops->bind)
 
1177		return;
1178
1179	mutex_lock(&thermal_list_lock);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1180
1181	/* If there is ops->bind, try to use ops->bind */
1182	if (tz->ops->bind) {
1183		list_for_each_entry(pos, &thermal_cdev_list, node) {
1184			ret = tz->ops->bind(tz, pos);
1185			if (ret)
1186				print_bind_err_msg(tz, pos, ret);
1187		}
1188		goto exit;
1189	}
1190
1191	if (!tzp || !tzp->tbp)
1192		goto exit;
1193
1194	list_for_each_entry(pos, &thermal_cdev_list, node) {
1195		for (i = 0; i < tzp->num_tbps; i++) {
1196			if (tzp->tbp[i].cdev || !tzp->tbp[i].match)
1197				continue;
1198			if (tzp->tbp[i].match(tz, pos))
1199				continue;
1200			tzp->tbp[i].cdev = pos;
1201			__bind(tz, tzp->tbp[i].trip_mask, pos,
1202			       tzp->tbp[i].binding_limits,
1203			       tzp->tbp[i].weight);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1204		}
 
 
 
1205	}
1206exit:
1207	mutex_unlock(&thermal_list_lock);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1208}
1209
1210/**
1211 * thermal_zone_device_register() - register a new thermal zone device
1212 * @type:	the thermal zone device type
1213 * @trips:	the number of trip points the thermal zone support
1214 * @mask:	a bit string indicating the writeablility of trip points
1215 * @devdata:	private device data
1216 * @ops:	standard thermal zone device callbacks
1217 * @tzp:	thermal zone platform parameters
1218 * @passive_delay: number of milliseconds to wait between polls when
1219 *		   performing passive cooling
1220 * @polling_delay: number of milliseconds to wait between polls when checking
1221 *		   whether trip points have been crossed (0 for interrupt
1222 *		   driven systems)
1223 *
1224 * This interface function adds a new thermal zone device (sensor) to
1225 * /sys/class/thermal folder as thermal_zone[0-*]. It tries to bind all the
1226 * thermal cooling devices registered at the same time.
1227 * thermal_zone_device_unregister() must be called when the device is no
1228 * longer needed. The passive cooling depends on the .get_trend() return value.
1229 *
1230 * Return: a pointer to the created struct thermal_zone_device or an
1231 * in case of error, an ERR_PTR. Caller must check return value with
1232 * IS_ERR*() helpers.
1233 */
1234struct thermal_zone_device *
1235thermal_zone_device_register(const char *type, int trips, int mask,
1236			     void *devdata, struct thermal_zone_device_ops *ops,
1237			     struct thermal_zone_params *tzp, int passive_delay,
1238			     int polling_delay)
1239{
1240	struct thermal_zone_device *tz;
1241	enum thermal_trip_type trip_type;
1242	int trip_temp;
1243	int id;
1244	int result;
1245	int count;
 
1246	struct thermal_governor *governor;
1247
1248	if (!type || strlen(type) == 0) {
1249		pr_err("Error: No thermal zone type defined\n");
1250		return ERR_PTR(-EINVAL);
1251	}
1252
1253	if (type && strlen(type) >= THERMAL_NAME_LENGTH) {
1254		pr_err("Error: Thermal zone name (%s) too long, should be under %d chars\n",
1255		       type, THERMAL_NAME_LENGTH);
1256		return ERR_PTR(-EINVAL);
1257	}
1258
1259	if (trips > THERMAL_MAX_TRIPS || trips < 0 || mask >> trips) {
1260		pr_err("Error: Incorrect number of thermal trips\n");
1261		return ERR_PTR(-EINVAL);
1262	}
1263
1264	if (!ops) {
1265		pr_err("Error: Thermal zone device ops not defined\n");
1266		return ERR_PTR(-EINVAL);
1267	}
1268
1269	if (trips > 0 && (!ops->get_trip_type || !ops->get_trip_temp))
1270		return ERR_PTR(-EINVAL);
1271
1272	tz = kzalloc(sizeof(*tz), GFP_KERNEL);
1273	if (!tz)
1274		return ERR_PTR(-ENOMEM);
1275
1276	INIT_LIST_HEAD(&tz->thermal_instances);
1277	ida_init(&tz->ida);
1278	mutex_init(&tz->lock);
1279	id = ida_simple_get(&thermal_tz_ida, 0, 0, GFP_KERNEL);
1280	if (id < 0) {
1281		result = id;
1282		goto free_tz;
1283	}
1284
1285	tz->id = id;
1286	strlcpy(tz->type, type, sizeof(tz->type));
1287	tz->ops = ops;
1288	tz->tzp = tzp;
1289	tz->device.class = &thermal_class;
1290	tz->devdata = devdata;
1291	tz->trips = trips;
1292	tz->passive_delay = passive_delay;
1293	tz->polling_delay = polling_delay;
 
 
 
 
 
 
 
 
 
 
1294
1295	/* sys I/F */
1296	/* Add nodes that are always present via .groups */
1297	result = thermal_zone_create_device_groups(tz, mask);
 
 
 
 
 
1298	if (result)
1299		goto remove_id;
1300
1301	/* A new thermal zone needs to be updated anyway. */
1302	atomic_set(&tz->need_update, 1);
 
 
 
1303
1304	dev_set_name(&tz->device, "thermal_zone%d", tz->id);
1305	result = device_register(&tz->device);
1306	if (result)
1307		goto release_device;
1308
1309	for (count = 0; count < trips; count++) {
1310		if (tz->ops->get_trip_type(tz, count, &trip_type))
1311			set_bit(count, &tz->trips_disabled);
 
 
1312		if (tz->ops->get_trip_temp(tz, count, &trip_temp))
1313			set_bit(count, &tz->trips_disabled);
1314		/* Check for bogus trip points */
1315		if (trip_temp == 0)
1316			set_bit(count, &tz->trips_disabled);
1317	}
1318
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1319	/* Update 'this' zone's governor information */
1320	mutex_lock(&thermal_governor_lock);
1321
1322	if (tz->tzp)
1323		governor = __find_governor(tz->tzp->governor_name);
1324	else
1325		governor = def_governor;
1326
1327	result = thermal_set_governor(tz, governor);
1328	if (result) {
1329		mutex_unlock(&thermal_governor_lock);
1330		goto unregister;
1331	}
1332
1333	mutex_unlock(&thermal_governor_lock);
1334
1335	if (!tz->tzp || !tz->tzp->no_hwmon) {
1336		result = thermal_add_hwmon_sysfs(tz);
1337		if (result)
1338			goto unregister;
1339	}
1340
1341	mutex_lock(&thermal_list_lock);
1342	list_add_tail(&tz->node, &thermal_tz_list);
1343	mutex_unlock(&thermal_list_lock);
1344
1345	/* Bind cooling devices for this zone */
1346	bind_tz(tz);
1347
1348	INIT_DELAYED_WORK(&tz->poll_queue, thermal_zone_device_check);
1349
1350	thermal_zone_device_reset(tz);
1351	/* Update the new thermal zone and mark it as already updated. */
1352	if (atomic_cmpxchg(&tz->need_update, 1, 0))
1353		thermal_zone_device_update(tz, THERMAL_EVENT_UNSPECIFIED);
1354
1355	return tz;
1356
1357unregister:
1358	device_del(&tz->device);
1359release_device:
1360	put_device(&tz->device);
1361	tz = NULL;
1362remove_id:
1363	ida_simple_remove(&thermal_tz_ida, id);
1364free_tz:
1365	kfree(tz);
1366	return ERR_PTR(result);
1367}
1368EXPORT_SYMBOL_GPL(thermal_zone_device_register);
1369
1370/**
1371 * thermal_device_unregister - removes the registered thermal zone device
1372 * @tz: the thermal zone device to remove
1373 */
1374void thermal_zone_device_unregister(struct thermal_zone_device *tz)
1375{
1376	int i;
1377	const struct thermal_zone_params *tzp;
1378	struct thermal_cooling_device *cdev;
1379	struct thermal_zone_device *pos = NULL;
1380
1381	if (!tz)
1382		return;
1383
1384	tzp = tz->tzp;
1385
1386	mutex_lock(&thermal_list_lock);
1387	list_for_each_entry(pos, &thermal_tz_list, node)
1388		if (pos == tz)
1389			break;
1390	if (pos != tz) {
1391		/* thermal zone device not found */
1392		mutex_unlock(&thermal_list_lock);
1393		return;
1394	}
1395	list_del(&tz->node);
1396
1397	/* Unbind all cdevs associated with 'this' thermal zone */
1398	list_for_each_entry(cdev, &thermal_cdev_list, node) {
1399		if (tz->ops->unbind) {
1400			tz->ops->unbind(tz, cdev);
1401			continue;
1402		}
1403
1404		if (!tzp || !tzp->tbp)
1405			break;
1406
1407		for (i = 0; i < tzp->num_tbps; i++) {
1408			if (tzp->tbp[i].cdev == cdev) {
1409				__unbind(tz, tzp->tbp[i].trip_mask, cdev);
1410				tzp->tbp[i].cdev = NULL;
1411			}
1412		}
1413	}
1414
1415	mutex_unlock(&thermal_list_lock);
1416
1417	thermal_zone_device_set_polling(tz, 0);
1418
 
 
 
 
 
 
 
 
1419	thermal_set_governor(tz, NULL);
1420
1421	thermal_remove_hwmon_sysfs(tz);
1422	ida_simple_remove(&thermal_tz_ida, tz->id);
1423	ida_destroy(&tz->ida);
1424	mutex_destroy(&tz->lock);
1425	device_unregister(&tz->device);
 
1426}
1427EXPORT_SYMBOL_GPL(thermal_zone_device_unregister);
1428
1429/**
1430 * thermal_zone_get_zone_by_name() - search for a zone and returns its ref
1431 * @name: thermal zone name to fetch the temperature
1432 *
1433 * When only one zone is found with the passed name, returns a reference to it.
1434 *
1435 * Return: On success returns a reference to an unique thermal zone with
1436 * matching name equals to @name, an ERR_PTR otherwise (-EINVAL for invalid
1437 * paramenters, -ENODEV for not found and -EEXIST for multiple matches).
1438 */
1439struct thermal_zone_device *thermal_zone_get_zone_by_name(const char *name)
1440{
1441	struct thermal_zone_device *pos = NULL, *ref = ERR_PTR(-EINVAL);
1442	unsigned int found = 0;
1443
1444	if (!name)
1445		goto exit;
1446
1447	mutex_lock(&thermal_list_lock);
1448	list_for_each_entry(pos, &thermal_tz_list, node)
1449		if (!strncasecmp(name, pos->type, THERMAL_NAME_LENGTH)) {
1450			found++;
1451			ref = pos;
1452		}
1453	mutex_unlock(&thermal_list_lock);
1454
1455	/* nothing has been found, thus an error code for it */
1456	if (found == 0)
1457		ref = ERR_PTR(-ENODEV);
1458	else if (found > 1)
1459	/* Success only when an unique zone is found */
1460		ref = ERR_PTR(-EEXIST);
1461
1462exit:
1463	return ref;
1464}
1465EXPORT_SYMBOL_GPL(thermal_zone_get_zone_by_name);
1466
1467#ifdef CONFIG_NET
1468static const struct genl_multicast_group thermal_event_mcgrps[] = {
1469	{ .name = THERMAL_GENL_MCAST_GROUP_NAME, },
1470};
1471
1472static struct genl_family thermal_event_genl_family __ro_after_init = {
1473	.module = THIS_MODULE,
1474	.name = THERMAL_GENL_FAMILY_NAME,
1475	.version = THERMAL_GENL_VERSION,
1476	.maxattr = THERMAL_GENL_ATTR_MAX,
1477	.mcgrps = thermal_event_mcgrps,
1478	.n_mcgrps = ARRAY_SIZE(thermal_event_mcgrps),
1479};
1480
1481int thermal_generate_netlink_event(struct thermal_zone_device *tz,
1482				   enum events event)
1483{
1484	struct sk_buff *skb;
1485	struct nlattr *attr;
1486	struct thermal_genl_event *thermal_event;
1487	void *msg_header;
1488	int size;
1489	int result;
1490	static unsigned int thermal_event_seqnum;
1491
1492	if (!tz)
1493		return -EINVAL;
1494
1495	/* allocate memory */
1496	size = nla_total_size(sizeof(struct thermal_genl_event)) +
1497	       nla_total_size(0);
1498
1499	skb = genlmsg_new(size, GFP_ATOMIC);
1500	if (!skb)
1501		return -ENOMEM;
1502
1503	/* add the genetlink message header */
1504	msg_header = genlmsg_put(skb, 0, thermal_event_seqnum++,
1505				 &thermal_event_genl_family, 0,
1506				 THERMAL_GENL_CMD_EVENT);
1507	if (!msg_header) {
1508		nlmsg_free(skb);
1509		return -ENOMEM;
1510	}
1511
1512	/* fill the data */
1513	attr = nla_reserve(skb, THERMAL_GENL_ATTR_EVENT,
1514			   sizeof(struct thermal_genl_event));
1515
1516	if (!attr) {
1517		nlmsg_free(skb);
1518		return -EINVAL;
1519	}
1520
1521	thermal_event = nla_data(attr);
1522	if (!thermal_event) {
1523		nlmsg_free(skb);
1524		return -EINVAL;
1525	}
1526
1527	memset(thermal_event, 0, sizeof(struct thermal_genl_event));
1528
1529	thermal_event->orig = tz->id;
1530	thermal_event->event = event;
1531
1532	/* send multicast genetlink message */
1533	genlmsg_end(skb, msg_header);
1534
1535	result = genlmsg_multicast(&thermal_event_genl_family, skb, 0,
1536				   0, GFP_ATOMIC);
1537	if (result)
1538		dev_err(&tz->device, "Failed to send netlink event:%d", result);
1539
1540	return result;
1541}
1542EXPORT_SYMBOL_GPL(thermal_generate_netlink_event);
1543
1544static int __init genetlink_init(void)
1545{
1546	return genl_register_family(&thermal_event_genl_family);
1547}
1548
1549static void genetlink_exit(void)
1550{
1551	genl_unregister_family(&thermal_event_genl_family);
1552}
1553#else /* !CONFIG_NET */
1554static inline int genetlink_init(void) { return 0; }
1555static inline void genetlink_exit(void) {}
1556#endif /* !CONFIG_NET */
1557
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1558static int thermal_pm_notify(struct notifier_block *nb,
1559			     unsigned long mode, void *_unused)
1560{
1561	struct thermal_zone_device *tz;
1562	enum thermal_device_mode tz_mode;
1563
1564	switch (mode) {
1565	case PM_HIBERNATION_PREPARE:
1566	case PM_RESTORE_PREPARE:
1567	case PM_SUSPEND_PREPARE:
1568		atomic_set(&in_suspend, 1);
1569		break;
1570	case PM_POST_HIBERNATION:
1571	case PM_POST_RESTORE:
1572	case PM_POST_SUSPEND:
1573		atomic_set(&in_suspend, 0);
1574		list_for_each_entry(tz, &thermal_tz_list, node) {
1575			tz_mode = THERMAL_DEVICE_ENABLED;
1576			if (tz->ops->get_mode)
1577				tz->ops->get_mode(tz, &tz_mode);
1578
1579			if (tz_mode == THERMAL_DEVICE_DISABLED)
1580				continue;
1581
1582			thermal_zone_device_init(tz);
1583			thermal_zone_device_update(tz,
1584						   THERMAL_EVENT_UNSPECIFIED);
1585		}
1586		break;
1587	default:
1588		break;
1589	}
1590	return 0;
1591}
1592
1593static struct notifier_block thermal_pm_nb = {
1594	.notifier_call = thermal_pm_notify,
1595};
1596
1597static int __init thermal_init(void)
1598{
1599	int result;
1600
1601	mutex_init(&poweroff_lock);
1602	result = thermal_register_governors();
1603	if (result)
1604		goto error;
1605
1606	result = class_register(&thermal_class);
1607	if (result)
1608		goto unregister_governors;
1609
1610	result = genetlink_init();
1611	if (result)
1612		goto unregister_class;
1613
1614	result = of_parse_thermal_zones();
1615	if (result)
1616		goto exit_netlink;
1617
1618	result = register_pm_notifier(&thermal_pm_nb);
1619	if (result)
1620		pr_warn("Thermal: Can not register suspend notifier, return %d\n",
1621			result);
1622
1623	return 0;
1624
1625exit_netlink:
1626	genetlink_exit();
1627unregister_class:
1628	class_unregister(&thermal_class);
1629unregister_governors:
1630	thermal_unregister_governors();
1631error:
1632	ida_destroy(&thermal_tz_ida);
1633	ida_destroy(&thermal_cdev_ida);
 
1634	mutex_destroy(&thermal_list_lock);
1635	mutex_destroy(&thermal_governor_lock);
1636	mutex_destroy(&poweroff_lock);
1637	return result;
1638}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1639fs_initcall(thermal_init);