Linux Audio

Check our new training course

Loading...
v3.15
   1/*
   2 * drivers/base/power/domain.c - Common code related to device power domains.
   3 *
   4 * Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, Renesas Electronics Corp.
   5 *
   6 * This file is released under the GPLv2.
   7 */
   8
 
   9#include <linux/kernel.h>
  10#include <linux/io.h>
  11#include <linux/pm_runtime.h>
  12#include <linux/pm_domain.h>
  13#include <linux/pm_qos.h>
  14#include <linux/slab.h>
  15#include <linux/err.h>
  16#include <linux/sched.h>
  17#include <linux/suspend.h>
  18#include <linux/export.h>
  19
  20#define GENPD_DEV_CALLBACK(genpd, type, callback, dev)		\
  21({								\
  22	type (*__routine)(struct device *__d); 			\
  23	type __ret = (type)0;					\
  24								\
  25	__routine = genpd->dev_ops.callback; 			\
  26	if (__routine) {					\
  27		__ret = __routine(dev); 			\
  28	} else {						\
  29		__routine = dev_gpd_data(dev)->ops.callback;	\
  30		if (__routine) 					\
  31			__ret = __routine(dev);			\
  32	}							\
  33	__ret;							\
  34})
  35
  36#define GENPD_DEV_TIMED_CALLBACK(genpd, type, callback, dev, field, name)	\
  37({										\
  38	ktime_t __start = ktime_get();						\
  39	type __retval = GENPD_DEV_CALLBACK(genpd, type, callback, dev);		\
  40	s64 __elapsed = ktime_to_ns(ktime_sub(ktime_get(), __start));		\
  41	struct gpd_timing_data *__td = &dev_gpd_data(dev)->td;			\
  42	if (!__retval && __elapsed > __td->field) {				\
  43		__td->field = __elapsed;					\
  44		dev_dbg(dev, name " latency exceeded, new value %lld ns\n",	\
  45			__elapsed);						\
  46		genpd->max_off_time_changed = true;				\
  47		__td->constraint_changed = true;				\
  48	}									\
  49	__retval;								\
  50})
  51
  52static LIST_HEAD(gpd_list);
  53static DEFINE_MUTEX(gpd_list_lock);
  54
  55static struct generic_pm_domain *pm_genpd_lookup_name(const char *domain_name)
  56{
  57	struct generic_pm_domain *genpd = NULL, *gpd;
  58
  59	if (IS_ERR_OR_NULL(domain_name))
  60		return NULL;
  61
  62	mutex_lock(&gpd_list_lock);
  63	list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
  64		if (!strcmp(gpd->name, domain_name)) {
  65			genpd = gpd;
  66			break;
  67		}
  68	}
  69	mutex_unlock(&gpd_list_lock);
  70	return genpd;
  71}
  72
  73#ifdef CONFIG_PM
  74
  75struct generic_pm_domain *dev_to_genpd(struct device *dev)
  76{
  77	if (IS_ERR_OR_NULL(dev->pm_domain))
  78		return ERR_PTR(-EINVAL);
  79
  80	return pd_to_genpd(dev->pm_domain);
  81}
  82
  83static int genpd_stop_dev(struct generic_pm_domain *genpd, struct device *dev)
  84{
  85	return GENPD_DEV_TIMED_CALLBACK(genpd, int, stop, dev,
  86					stop_latency_ns, "stop");
  87}
  88
  89static int genpd_start_dev(struct generic_pm_domain *genpd, struct device *dev)
  90{
  91	return GENPD_DEV_TIMED_CALLBACK(genpd, int, start, dev,
  92					start_latency_ns, "start");
  93}
  94
  95static bool genpd_sd_counter_dec(struct generic_pm_domain *genpd)
  96{
  97	bool ret = false;
  98
  99	if (!WARN_ON(atomic_read(&genpd->sd_count) == 0))
 100		ret = !!atomic_dec_and_test(&genpd->sd_count);
 101
 102	return ret;
 103}
 104
 105static void genpd_sd_counter_inc(struct generic_pm_domain *genpd)
 106{
 107	atomic_inc(&genpd->sd_count);
 108	smp_mb__after_atomic_inc();
 109}
 110
 111static void genpd_acquire_lock(struct generic_pm_domain *genpd)
 112{
 113	DEFINE_WAIT(wait);
 114
 115	mutex_lock(&genpd->lock);
 116	/*
 117	 * Wait for the domain to transition into either the active,
 118	 * or the power off state.
 119	 */
 120	for (;;) {
 121		prepare_to_wait(&genpd->status_wait_queue, &wait,
 122				TASK_UNINTERRUPTIBLE);
 123		if (genpd->status == GPD_STATE_ACTIVE
 124		    || genpd->status == GPD_STATE_POWER_OFF)
 125			break;
 126		mutex_unlock(&genpd->lock);
 127
 128		schedule();
 129
 130		mutex_lock(&genpd->lock);
 131	}
 132	finish_wait(&genpd->status_wait_queue, &wait);
 133}
 134
 135static void genpd_release_lock(struct generic_pm_domain *genpd)
 136{
 137	mutex_unlock(&genpd->lock);
 138}
 139
 140static void genpd_set_active(struct generic_pm_domain *genpd)
 141{
 142	if (genpd->resume_count == 0)
 143		genpd->status = GPD_STATE_ACTIVE;
 144}
 145
 146static void genpd_recalc_cpu_exit_latency(struct generic_pm_domain *genpd)
 147{
 148	s64 usecs64;
 149
 150	if (!genpd->cpu_data)
 151		return;
 152
 153	usecs64 = genpd->power_on_latency_ns;
 154	do_div(usecs64, NSEC_PER_USEC);
 155	usecs64 += genpd->cpu_data->saved_exit_latency;
 156	genpd->cpu_data->idle_state->exit_latency = usecs64;
 157}
 158
 159/**
 160 * __pm_genpd_poweron - Restore power to a given PM domain and its masters.
 161 * @genpd: PM domain to power up.
 162 *
 163 * Restore power to @genpd and all of its masters so that it is possible to
 164 * resume a device belonging to it.
 165 */
 166static int __pm_genpd_poweron(struct generic_pm_domain *genpd)
 167	__releases(&genpd->lock) __acquires(&genpd->lock)
 168{
 169	struct gpd_link *link;
 170	DEFINE_WAIT(wait);
 171	int ret = 0;
 172
 173	/* If the domain's master is being waited for, we have to wait too. */
 174	for (;;) {
 175		prepare_to_wait(&genpd->status_wait_queue, &wait,
 176				TASK_UNINTERRUPTIBLE);
 177		if (genpd->status != GPD_STATE_WAIT_MASTER)
 178			break;
 179		mutex_unlock(&genpd->lock);
 180
 181		schedule();
 182
 183		mutex_lock(&genpd->lock);
 184	}
 185	finish_wait(&genpd->status_wait_queue, &wait);
 186
 187	if (genpd->status == GPD_STATE_ACTIVE
 188	    || (genpd->prepared_count > 0 && genpd->suspend_power_off))
 189		return 0;
 190
 191	if (genpd->status != GPD_STATE_POWER_OFF) {
 192		genpd_set_active(genpd);
 193		return 0;
 194	}
 195
 196	if (genpd->cpu_data) {
 197		cpuidle_pause_and_lock();
 198		genpd->cpu_data->idle_state->disabled = true;
 199		cpuidle_resume_and_unlock();
 200		goto out;
 201	}
 202
 203	/*
 204	 * The list is guaranteed not to change while the loop below is being
 205	 * executed, unless one of the masters' .power_on() callbacks fiddles
 206	 * with it.
 207	 */
 208	list_for_each_entry(link, &genpd->slave_links, slave_node) {
 209		genpd_sd_counter_inc(link->master);
 210		genpd->status = GPD_STATE_WAIT_MASTER;
 211
 212		mutex_unlock(&genpd->lock);
 
 213
 214		ret = pm_genpd_poweron(link->master);
 215
 216		mutex_lock(&genpd->lock);
 217
 218		/*
 219		 * The "wait for parent" status is guaranteed not to change
 220		 * while the master is powering on.
 221		 */
 222		genpd->status = GPD_STATE_POWER_OFF;
 223		wake_up_all(&genpd->status_wait_queue);
 224		if (ret) {
 225			genpd_sd_counter_dec(link->master);
 226			goto err;
 227		}
 228	}
 229
 230	if (genpd->power_on) {
 231		ktime_t time_start = ktime_get();
 232		s64 elapsed_ns;
 233
 234		ret = genpd->power_on(genpd);
 235		if (ret)
 236			goto err;
 237
 238		elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
 239		if (elapsed_ns > genpd->power_on_latency_ns) {
 240			genpd->power_on_latency_ns = elapsed_ns;
 241			genpd->max_off_time_changed = true;
 242			genpd_recalc_cpu_exit_latency(genpd);
 243			if (genpd->name)
 244				pr_warning("%s: Power-on latency exceeded, "
 245					"new value %lld ns\n", genpd->name,
 246					elapsed_ns);
 247		}
 248	}
 249
 250 out:
 251	genpd_set_active(genpd);
 
 
 252
 253	return 0;
 254
 255 err:
 256	list_for_each_entry_continue_reverse(link, &genpd->slave_links, slave_node)
 257		genpd_sd_counter_dec(link->master);
 258
 259	return ret;
 260}
 261
 262/**
 263 * pm_genpd_poweron - Restore power to a given PM domain and its masters.
 264 * @genpd: PM domain to power up.
 265 */
 266int pm_genpd_poweron(struct generic_pm_domain *genpd)
 267{
 268	int ret;
 269
 270	mutex_lock(&genpd->lock);
 271	ret = __pm_genpd_poweron(genpd);
 272	mutex_unlock(&genpd->lock);
 273	return ret;
 274}
 275
 276/**
 277 * pm_genpd_name_poweron - Restore power to a given PM domain and its masters.
 278 * @domain_name: Name of the PM domain to power up.
 279 */
 280int pm_genpd_name_poweron(const char *domain_name)
 281{
 282	struct generic_pm_domain *genpd;
 283
 284	genpd = pm_genpd_lookup_name(domain_name);
 285	return genpd ? pm_genpd_poweron(genpd) : -EINVAL;
 286}
 287
 288#endif /* CONFIG_PM */
 289
 290#ifdef CONFIG_PM_RUNTIME
 291
 292static int genpd_start_dev_no_timing(struct generic_pm_domain *genpd,
 293				     struct device *dev)
 294{
 295	return GENPD_DEV_CALLBACK(genpd, int, start, dev);
 296}
 297
 298static int genpd_save_dev(struct generic_pm_domain *genpd, struct device *dev)
 299{
 300	return GENPD_DEV_TIMED_CALLBACK(genpd, int, save_state, dev,
 301					save_state_latency_ns, "state save");
 302}
 303
 304static int genpd_restore_dev(struct generic_pm_domain *genpd, struct device *dev)
 305{
 306	return GENPD_DEV_TIMED_CALLBACK(genpd, int, restore_state, dev,
 307					restore_state_latency_ns,
 308					"state restore");
 309}
 310
 311static int genpd_dev_pm_qos_notifier(struct notifier_block *nb,
 312				     unsigned long val, void *ptr)
 313{
 314	struct generic_pm_domain_data *gpd_data;
 315	struct device *dev;
 316
 317	gpd_data = container_of(nb, struct generic_pm_domain_data, nb);
 318
 319	mutex_lock(&gpd_data->lock);
 320	dev = gpd_data->base.dev;
 321	if (!dev) {
 322		mutex_unlock(&gpd_data->lock);
 323		return NOTIFY_DONE;
 324	}
 325	mutex_unlock(&gpd_data->lock);
 326
 327	for (;;) {
 328		struct generic_pm_domain *genpd;
 329		struct pm_domain_data *pdd;
 330
 331		spin_lock_irq(&dev->power.lock);
 332
 333		pdd = dev->power.subsys_data ?
 334				dev->power.subsys_data->domain_data : NULL;
 335		if (pdd && pdd->dev) {
 336			to_gpd_data(pdd)->td.constraint_changed = true;
 337			genpd = dev_to_genpd(dev);
 338		} else {
 339			genpd = ERR_PTR(-ENODATA);
 340		}
 341
 342		spin_unlock_irq(&dev->power.lock);
 343
 344		if (!IS_ERR(genpd)) {
 345			mutex_lock(&genpd->lock);
 346			genpd->max_off_time_changed = true;
 347			mutex_unlock(&genpd->lock);
 348		}
 349
 350		dev = dev->parent;
 351		if (!dev || dev->power.ignore_children)
 352			break;
 353	}
 354
 355	return NOTIFY_DONE;
 356}
 357
 358/**
 359 * __pm_genpd_save_device - Save the pre-suspend state of a device.
 360 * @pdd: Domain data of the device to save the state of.
 361 * @genpd: PM domain the device belongs to.
 362 */
 363static int __pm_genpd_save_device(struct pm_domain_data *pdd,
 364				  struct generic_pm_domain *genpd)
 365	__releases(&genpd->lock) __acquires(&genpd->lock)
 366{
 367	struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
 368	struct device *dev = pdd->dev;
 369	int ret = 0;
 370
 371	if (gpd_data->need_restore)
 372		return 0;
 373
 374	mutex_unlock(&genpd->lock);
 375
 376	genpd_start_dev(genpd, dev);
 377	ret = genpd_save_dev(genpd, dev);
 378	genpd_stop_dev(genpd, dev);
 
 
 
 
 
 
 379
 380	mutex_lock(&genpd->lock);
 381
 382	if (!ret)
 383		gpd_data->need_restore = true;
 384
 385	return ret;
 386}
 387
 388/**
 389 * __pm_genpd_restore_device - Restore the pre-suspend state of a device.
 390 * @pdd: Domain data of the device to restore the state of.
 391 * @genpd: PM domain the device belongs to.
 392 */
 393static void __pm_genpd_restore_device(struct pm_domain_data *pdd,
 394				      struct generic_pm_domain *genpd)
 395	__releases(&genpd->lock) __acquires(&genpd->lock)
 396{
 397	struct generic_pm_domain_data *gpd_data = to_gpd_data(pdd);
 398	struct device *dev = pdd->dev;
 399	bool need_restore = gpd_data->need_restore;
 
 
 400
 401	gpd_data->need_restore = false;
 402	mutex_unlock(&genpd->lock);
 403
 404	genpd_start_dev(genpd, dev);
 405	if (need_restore)
 406		genpd_restore_dev(genpd, dev);
 
 
 
 
 
 
 407
 408	mutex_lock(&genpd->lock);
 
 
 409}
 410
 411/**
 412 * genpd_abort_poweroff - Check if a PM domain power off should be aborted.
 413 * @genpd: PM domain to check.
 414 *
 415 * Return true if a PM domain's status changed to GPD_STATE_ACTIVE during
 416 * a "power off" operation, which means that a "power on" has occured in the
 417 * meantime, or if its resume_count field is different from zero, which means
 418 * that one of its devices has been resumed in the meantime.
 419 */
 420static bool genpd_abort_poweroff(struct generic_pm_domain *genpd)
 421{
 422	return genpd->status == GPD_STATE_WAIT_MASTER
 423		|| genpd->status == GPD_STATE_ACTIVE || genpd->resume_count > 0;
 424}
 425
 426/**
 427 * genpd_queue_power_off_work - Queue up the execution of pm_genpd_poweroff().
 428 * @genpd: PM domait to power off.
 429 *
 430 * Queue up the execution of pm_genpd_poweroff() unless it's already been done
 431 * before.
 432 */
 433void genpd_queue_power_off_work(struct generic_pm_domain *genpd)
 434{
 435	queue_work(pm_wq, &genpd->power_off_work);
 
 436}
 437
 438/**
 439 * pm_genpd_poweroff - Remove power from a given PM domain.
 440 * @genpd: PM domain to power down.
 441 *
 442 * If all of the @genpd's devices have been suspended and all of its subdomains
 443 * have been powered down, run the runtime suspend callbacks provided by all of
 444 * the @genpd's devices' drivers and remove power from @genpd.
 445 */
 446static int pm_genpd_poweroff(struct generic_pm_domain *genpd)
 447	__releases(&genpd->lock) __acquires(&genpd->lock)
 448{
 449	struct pm_domain_data *pdd;
 450	struct gpd_link *link;
 451	unsigned int not_suspended;
 452	int ret = 0;
 453
 454 start:
 455	/*
 456	 * Do not try to power off the domain in the following situations:
 457	 * (1) The domain is already in the "power off" state.
 458	 * (2) The domain is waiting for its master to power up.
 459	 * (3) One of the domain's devices is being resumed right now.
 460	 * (4) System suspend is in progress.
 461	 */
 462	if (genpd->status == GPD_STATE_POWER_OFF
 463	    || genpd->status == GPD_STATE_WAIT_MASTER
 464	    || genpd->resume_count > 0 || genpd->prepared_count > 0)
 465		return 0;
 466
 467	if (atomic_read(&genpd->sd_count) > 0)
 468		return -EBUSY;
 469
 470	not_suspended = 0;
 471	list_for_each_entry(pdd, &genpd->dev_list, list_node) {
 472		enum pm_qos_flags_status stat;
 473
 474		stat = dev_pm_qos_flags(pdd->dev,
 475					PM_QOS_FLAG_NO_POWER_OFF
 476						| PM_QOS_FLAG_REMOTE_WAKEUP);
 477		if (stat > PM_QOS_FLAGS_NONE)
 478			return -EBUSY;
 479
 480		if (pdd->dev->driver && (!pm_runtime_suspended(pdd->dev)
 481		    || pdd->dev->power.irq_safe))
 482			not_suspended++;
 483	}
 484
 485	if (not_suspended > genpd->in_progress)
 486		return -EBUSY;
 487
 488	if (genpd->poweroff_task) {
 489		/*
 490		 * Another instance of pm_genpd_poweroff() is executing
 491		 * callbacks, so tell it to start over and return.
 492		 */
 493		genpd->status = GPD_STATE_REPEAT;
 494		return 0;
 495	}
 496
 497	if (genpd->gov && genpd->gov->power_down_ok) {
 498		if (!genpd->gov->power_down_ok(&genpd->domain))
 499			return -EAGAIN;
 500	}
 501
 502	genpd->status = GPD_STATE_BUSY;
 503	genpd->poweroff_task = current;
 504
 505	list_for_each_entry_reverse(pdd, &genpd->dev_list, list_node) {
 506		ret = atomic_read(&genpd->sd_count) == 0 ?
 507			__pm_genpd_save_device(pdd, genpd) : -EBUSY;
 508
 509		if (genpd_abort_poweroff(genpd))
 510			goto out;
 511
 512		if (ret) {
 513			genpd_set_active(genpd);
 514			goto out;
 515		}
 516
 
 
 
 517		if (genpd->status == GPD_STATE_REPEAT) {
 518			genpd->poweroff_task = NULL;
 519			goto start;
 520		}
 521	}
 522
 523	if (genpd->cpu_data) {
 524		/*
 525		 * If cpu_data is set, cpuidle should turn the domain off when
 526		 * the CPU in it is idle.  In that case we don't decrement the
 527		 * subdomain counts of the master domains, so that power is not
 528		 * removed from the current domain prematurely as a result of
 529		 * cutting off the masters' power.
 530		 */
 531		genpd->status = GPD_STATE_POWER_OFF;
 532		cpuidle_pause_and_lock();
 533		genpd->cpu_data->idle_state->disabled = false;
 534		cpuidle_resume_and_unlock();
 535		goto out;
 536	}
 537
 538	if (genpd->power_off) {
 539		ktime_t time_start;
 540		s64 elapsed_ns;
 541
 542		if (atomic_read(&genpd->sd_count) > 0) {
 543			ret = -EBUSY;
 544			goto out;
 545		}
 
 546
 547		time_start = ktime_get();
 548
 549		/*
 550		 * If sd_count > 0 at this point, one of the subdomains hasn't
 551		 * managed to call pm_genpd_poweron() for the master yet after
 552		 * incrementing it.  In that case pm_genpd_poweron() will wait
 553		 * for us to drop the lock, so we can call .power_off() and let
 554		 * the pm_genpd_poweron() restore power for us (this shouldn't
 555		 * happen very often).
 556		 */
 557		ret = genpd->power_off(genpd);
 558		if (ret == -EBUSY) {
 559			genpd_set_active(genpd);
 560			goto out;
 561		}
 562
 563		elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
 564		if (elapsed_ns > genpd->power_off_latency_ns) {
 565			genpd->power_off_latency_ns = elapsed_ns;
 566			genpd->max_off_time_changed = true;
 567			if (genpd->name)
 568				pr_warning("%s: Power-off latency exceeded, "
 569					"new value %lld ns\n", genpd->name,
 570					elapsed_ns);
 571		}
 572	}
 573
 574	genpd->status = GPD_STATE_POWER_OFF;
 575
 576	list_for_each_entry(link, &genpd->slave_links, slave_node) {
 577		genpd_sd_counter_dec(link->master);
 578		genpd_queue_power_off_work(link->master);
 
 
 
 579	}
 580
 581 out:
 582	genpd->poweroff_task = NULL;
 583	wake_up_all(&genpd->status_wait_queue);
 584	return ret;
 585}
 586
 587/**
 588 * genpd_power_off_work_fn - Power off PM domain whose subdomain count is 0.
 589 * @work: Work structure used for scheduling the execution of this function.
 590 */
 591static void genpd_power_off_work_fn(struct work_struct *work)
 592{
 593	struct generic_pm_domain *genpd;
 594
 595	genpd = container_of(work, struct generic_pm_domain, power_off_work);
 596
 597	genpd_acquire_lock(genpd);
 598	pm_genpd_poweroff(genpd);
 599	genpd_release_lock(genpd);
 600}
 601
 602/**
 603 * pm_genpd_runtime_suspend - Suspend a device belonging to I/O PM domain.
 604 * @dev: Device to suspend.
 605 *
 606 * Carry out a runtime suspend of a device under the assumption that its
 607 * pm_domain field points to the domain member of an object of type
 608 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 609 */
 610static int pm_genpd_runtime_suspend(struct device *dev)
 611{
 612	struct generic_pm_domain *genpd;
 613	bool (*stop_ok)(struct device *__dev);
 614	int ret;
 615
 616	dev_dbg(dev, "%s()\n", __func__);
 617
 618	genpd = dev_to_genpd(dev);
 619	if (IS_ERR(genpd))
 620		return -EINVAL;
 621
 622	might_sleep_if(!genpd->dev_irq_safe);
 623
 624	stop_ok = genpd->gov ? genpd->gov->stop_ok : NULL;
 625	if (stop_ok && !stop_ok(dev))
 626		return -EBUSY;
 627
 628	ret = genpd_stop_dev(genpd, dev);
 629	if (ret)
 630		return ret;
 631
 632	/*
 633	 * If power.irq_safe is set, this routine will be run with interrupts
 634	 * off, so it can't use mutexes.
 635	 */
 636	if (dev->power.irq_safe)
 637		return 0;
 638
 639	mutex_lock(&genpd->lock);
 640	genpd->in_progress++;
 641	pm_genpd_poweroff(genpd);
 642	genpd->in_progress--;
 643	mutex_unlock(&genpd->lock);
 644
 645	return 0;
 646}
 647
 648/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 649 * pm_genpd_runtime_resume - Resume a device belonging to I/O PM domain.
 650 * @dev: Device to resume.
 651 *
 652 * Carry out a runtime resume of a device under the assumption that its
 653 * pm_domain field points to the domain member of an object of type
 654 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 655 */
 656static int pm_genpd_runtime_resume(struct device *dev)
 657{
 658	struct generic_pm_domain *genpd;
 659	DEFINE_WAIT(wait);
 660	int ret;
 661
 662	dev_dbg(dev, "%s()\n", __func__);
 663
 664	genpd = dev_to_genpd(dev);
 665	if (IS_ERR(genpd))
 666		return -EINVAL;
 667
 668	might_sleep_if(!genpd->dev_irq_safe);
 669
 670	/* If power.irq_safe, the PM domain is never powered off. */
 671	if (dev->power.irq_safe)
 672		return genpd_start_dev_no_timing(genpd, dev);
 673
 674	mutex_lock(&genpd->lock);
 675	ret = __pm_genpd_poweron(genpd);
 676	if (ret) {
 677		mutex_unlock(&genpd->lock);
 678		return ret;
 679	}
 680	genpd->status = GPD_STATE_BUSY;
 681	genpd->resume_count++;
 682	for (;;) {
 683		prepare_to_wait(&genpd->status_wait_queue, &wait,
 684				TASK_UNINTERRUPTIBLE);
 685		/*
 686		 * If current is the powering off task, we have been called
 687		 * reentrantly from one of the device callbacks, so we should
 688		 * not wait.
 689		 */
 690		if (!genpd->poweroff_task || genpd->poweroff_task == current)
 691			break;
 692		mutex_unlock(&genpd->lock);
 693
 694		schedule();
 695
 696		mutex_lock(&genpd->lock);
 697	}
 698	finish_wait(&genpd->status_wait_queue, &wait);
 699	__pm_genpd_restore_device(dev->power.subsys_data->domain_data, genpd);
 700	genpd->resume_count--;
 701	genpd_set_active(genpd);
 702	wake_up_all(&genpd->status_wait_queue);
 703	mutex_unlock(&genpd->lock);
 704
 705	return 0;
 706}
 707
 708static bool pd_ignore_unused;
 709static int __init pd_ignore_unused_setup(char *__unused)
 710{
 711	pd_ignore_unused = true;
 712	return 1;
 713}
 714__setup("pd_ignore_unused", pd_ignore_unused_setup);
 715
 716/**
 717 * pm_genpd_poweroff_unused - Power off all PM domains with no devices in use.
 718 */
 719void pm_genpd_poweroff_unused(void)
 720{
 721	struct generic_pm_domain *genpd;
 722
 723	if (pd_ignore_unused) {
 724		pr_warn("genpd: Not disabling unused power domains\n");
 725		return;
 726	}
 727
 728	mutex_lock(&gpd_list_lock);
 729
 730	list_for_each_entry(genpd, &gpd_list, gpd_list_node)
 731		genpd_queue_power_off_work(genpd);
 732
 733	mutex_unlock(&gpd_list_lock);
 734}
 735
 736#else
 737
 738static inline int genpd_dev_pm_qos_notifier(struct notifier_block *nb,
 739					    unsigned long val, void *ptr)
 740{
 741	return NOTIFY_DONE;
 742}
 743
 744static inline void genpd_power_off_work_fn(struct work_struct *work) {}
 
 
 745
 746#define pm_genpd_runtime_suspend	NULL
 747#define pm_genpd_runtime_resume		NULL
 748
 749#endif /* CONFIG_PM_RUNTIME */
 750
 751#ifdef CONFIG_PM_SLEEP
 752
 753/**
 754 * pm_genpd_present - Check if the given PM domain has been initialized.
 755 * @genpd: PM domain to check.
 756 */
 757static bool pm_genpd_present(struct generic_pm_domain *genpd)
 758{
 759	struct generic_pm_domain *gpd;
 760
 761	if (IS_ERR_OR_NULL(genpd))
 762		return false;
 763
 764	list_for_each_entry(gpd, &gpd_list, gpd_list_node)
 765		if (gpd == genpd)
 766			return true;
 767
 768	return false;
 769}
 770
 771static bool genpd_dev_active_wakeup(struct generic_pm_domain *genpd,
 772				    struct device *dev)
 773{
 774	return GENPD_DEV_CALLBACK(genpd, bool, active_wakeup, dev);
 775}
 776
 777static int genpd_suspend_dev(struct generic_pm_domain *genpd, struct device *dev)
 778{
 779	return GENPD_DEV_CALLBACK(genpd, int, suspend, dev);
 780}
 781
 782static int genpd_suspend_late(struct generic_pm_domain *genpd, struct device *dev)
 783{
 784	return GENPD_DEV_CALLBACK(genpd, int, suspend_late, dev);
 785}
 786
 787static int genpd_resume_early(struct generic_pm_domain *genpd, struct device *dev)
 788{
 789	return GENPD_DEV_CALLBACK(genpd, int, resume_early, dev);
 790}
 791
 792static int genpd_resume_dev(struct generic_pm_domain *genpd, struct device *dev)
 793{
 794	return GENPD_DEV_CALLBACK(genpd, int, resume, dev);
 795}
 796
 797static int genpd_freeze_dev(struct generic_pm_domain *genpd, struct device *dev)
 798{
 799	return GENPD_DEV_CALLBACK(genpd, int, freeze, dev);
 800}
 801
 802static int genpd_freeze_late(struct generic_pm_domain *genpd, struct device *dev)
 803{
 804	return GENPD_DEV_CALLBACK(genpd, int, freeze_late, dev);
 805}
 806
 807static int genpd_thaw_early(struct generic_pm_domain *genpd, struct device *dev)
 808{
 809	return GENPD_DEV_CALLBACK(genpd, int, thaw_early, dev);
 810}
 811
 812static int genpd_thaw_dev(struct generic_pm_domain *genpd, struct device *dev)
 813{
 814	return GENPD_DEV_CALLBACK(genpd, int, thaw, dev);
 815}
 816
 817/**
 818 * pm_genpd_sync_poweroff - Synchronously power off a PM domain and its masters.
 819 * @genpd: PM domain to power off, if possible.
 820 *
 821 * Check if the given PM domain can be powered off (during system suspend or
 822 * hibernation) and do that if so.  Also, in that case propagate to its masters.
 823 *
 824 * This function is only called in "noirq" and "syscore" stages of system power
 825 * transitions, so it need not acquire locks (all of the "noirq" callbacks are
 826 * executed sequentially, so it is guaranteed that it will never run twice in
 827 * parallel).
 828 */
 829static void pm_genpd_sync_poweroff(struct generic_pm_domain *genpd)
 830{
 831	struct gpd_link *link;
 832
 833	if (genpd->status == GPD_STATE_POWER_OFF)
 834		return;
 835
 836	if (genpd->suspended_count != genpd->device_count
 837	    || atomic_read(&genpd->sd_count) > 0)
 838		return;
 839
 840	if (genpd->power_off)
 841		genpd->power_off(genpd);
 842
 843	genpd->status = GPD_STATE_POWER_OFF;
 844
 845	list_for_each_entry(link, &genpd->slave_links, slave_node) {
 846		genpd_sd_counter_dec(link->master);
 847		pm_genpd_sync_poweroff(link->master);
 848	}
 849}
 850
 851/**
 852 * pm_genpd_sync_poweron - Synchronously power on a PM domain and its masters.
 853 * @genpd: PM domain to power on.
 854 *
 855 * This function is only called in "noirq" and "syscore" stages of system power
 856 * transitions, so it need not acquire locks (all of the "noirq" callbacks are
 857 * executed sequentially, so it is guaranteed that it will never run twice in
 858 * parallel).
 859 */
 860static void pm_genpd_sync_poweron(struct generic_pm_domain *genpd)
 861{
 862	struct gpd_link *link;
 863
 864	if (genpd->status != GPD_STATE_POWER_OFF)
 865		return;
 866
 867	list_for_each_entry(link, &genpd->slave_links, slave_node) {
 868		pm_genpd_sync_poweron(link->master);
 869		genpd_sd_counter_inc(link->master);
 870	}
 871
 872	if (genpd->power_on)
 873		genpd->power_on(genpd);
 874
 875	genpd->status = GPD_STATE_ACTIVE;
 876}
 877
 878/**
 879 * resume_needed - Check whether to resume a device before system suspend.
 880 * @dev: Device to check.
 881 * @genpd: PM domain the device belongs to.
 882 *
 883 * There are two cases in which a device that can wake up the system from sleep
 884 * states should be resumed by pm_genpd_prepare(): (1) if the device is enabled
 885 * to wake up the system and it has to remain active for this purpose while the
 886 * system is in the sleep state and (2) if the device is not enabled to wake up
 887 * the system from sleep states and it generally doesn't generate wakeup signals
 888 * by itself (those signals are generated on its behalf by other parts of the
 889 * system).  In the latter case it may be necessary to reconfigure the device's
 890 * wakeup settings during system suspend, because it may have been set up to
 891 * signal remote wakeup from the system's working state as needed by runtime PM.
 892 * Return 'true' in either of the above cases.
 893 */
 894static bool resume_needed(struct device *dev, struct generic_pm_domain *genpd)
 895{
 896	bool active_wakeup;
 897
 898	if (!device_can_wakeup(dev))
 899		return false;
 900
 901	active_wakeup = genpd_dev_active_wakeup(genpd, dev);
 902	return device_may_wakeup(dev) ? active_wakeup : !active_wakeup;
 903}
 904
 905/**
 906 * pm_genpd_prepare - Start power transition of a device in a PM domain.
 907 * @dev: Device to start the transition of.
 908 *
 909 * Start a power transition of a device (during a system-wide power transition)
 910 * under the assumption that its pm_domain field points to the domain member of
 911 * an object of type struct generic_pm_domain representing a PM domain
 912 * consisting of I/O devices.
 913 */
 914static int pm_genpd_prepare(struct device *dev)
 915{
 916	struct generic_pm_domain *genpd;
 917	int ret;
 918
 919	dev_dbg(dev, "%s()\n", __func__);
 920
 921	genpd = dev_to_genpd(dev);
 922	if (IS_ERR(genpd))
 923		return -EINVAL;
 924
 925	/*
 926	 * If a wakeup request is pending for the device, it should be woken up
 927	 * at this point and a system wakeup event should be reported if it's
 928	 * set up to wake up the system from sleep states.
 929	 */
 930	pm_runtime_get_noresume(dev);
 931	if (pm_runtime_barrier(dev) && device_may_wakeup(dev))
 932		pm_wakeup_event(dev, 0);
 933
 934	if (pm_wakeup_pending()) {
 935		pm_runtime_put(dev);
 936		return -EBUSY;
 937	}
 938
 939	if (resume_needed(dev, genpd))
 940		pm_runtime_resume(dev);
 941
 942	genpd_acquire_lock(genpd);
 943
 944	if (genpd->prepared_count++ == 0) {
 945		genpd->suspended_count = 0;
 946		genpd->suspend_power_off = genpd->status == GPD_STATE_POWER_OFF;
 947	}
 948
 949	genpd_release_lock(genpd);
 950
 951	if (genpd->suspend_power_off) {
 952		pm_runtime_put_noidle(dev);
 953		return 0;
 954	}
 955
 956	/*
 957	 * The PM domain must be in the GPD_STATE_ACTIVE state at this point,
 958	 * so pm_genpd_poweron() will return immediately, but if the device
 959	 * is suspended (e.g. it's been stopped by genpd_stop_dev()), we need
 960	 * to make it operational.
 961	 */
 962	pm_runtime_resume(dev);
 963	__pm_runtime_disable(dev, false);
 964
 965	ret = pm_generic_prepare(dev);
 966	if (ret) {
 967		mutex_lock(&genpd->lock);
 968
 969		if (--genpd->prepared_count == 0)
 970			genpd->suspend_power_off = false;
 971
 972		mutex_unlock(&genpd->lock);
 973		pm_runtime_enable(dev);
 974	}
 975
 976	pm_runtime_put(dev);
 977	return ret;
 978}
 979
 980/**
 981 * pm_genpd_suspend - Suspend a device belonging to an I/O PM domain.
 982 * @dev: Device to suspend.
 983 *
 984 * Suspend a device under the assumption that its pm_domain field points to the
 985 * domain member of an object of type struct generic_pm_domain representing
 986 * a PM domain consisting of I/O devices.
 987 */
 988static int pm_genpd_suspend(struct device *dev)
 989{
 990	struct generic_pm_domain *genpd;
 991
 992	dev_dbg(dev, "%s()\n", __func__);
 993
 994	genpd = dev_to_genpd(dev);
 995	if (IS_ERR(genpd))
 996		return -EINVAL;
 997
 998	return genpd->suspend_power_off ? 0 : genpd_suspend_dev(genpd, dev);
 999}
1000
1001/**
1002 * pm_genpd_suspend_late - Late suspend of a device from an I/O PM domain.
1003 * @dev: Device to suspend.
1004 *
1005 * Carry out a late suspend of a device under the assumption that its
1006 * pm_domain field points to the domain member of an object of type
1007 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
1008 */
1009static int pm_genpd_suspend_late(struct device *dev)
1010{
1011	struct generic_pm_domain *genpd;
 
1012
1013	dev_dbg(dev, "%s()\n", __func__);
1014
1015	genpd = dev_to_genpd(dev);
1016	if (IS_ERR(genpd))
1017		return -EINVAL;
1018
1019	return genpd->suspend_power_off ? 0 : genpd_suspend_late(genpd, dev);
1020}
1021
1022/**
1023 * pm_genpd_suspend_noirq - Completion of suspend of device in an I/O PM domain.
1024 * @dev: Device to suspend.
1025 *
1026 * Stop the device and remove power from the domain if all devices in it have
1027 * been stopped.
1028 */
1029static int pm_genpd_suspend_noirq(struct device *dev)
1030{
1031	struct generic_pm_domain *genpd;
1032
1033	dev_dbg(dev, "%s()\n", __func__);
1034
1035	genpd = dev_to_genpd(dev);
1036	if (IS_ERR(genpd))
1037		return -EINVAL;
1038
1039	if (genpd->suspend_power_off
1040	    || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
1041		return 0;
1042
1043	genpd_stop_dev(genpd, dev);
 
1044
1045	/*
1046	 * Since all of the "noirq" callbacks are executed sequentially, it is
1047	 * guaranteed that this function will never run twice in parallel for
1048	 * the same PM domain, so it is not necessary to use locking here.
1049	 */
1050	genpd->suspended_count++;
1051	pm_genpd_sync_poweroff(genpd);
1052
1053	return 0;
1054}
1055
1056/**
1057 * pm_genpd_resume_noirq - Start of resume of device in an I/O PM domain.
1058 * @dev: Device to resume.
1059 *
1060 * Restore power to the device's PM domain, if necessary, and start the device.
 
 
 
1061 */
1062static int pm_genpd_resume_noirq(struct device *dev)
1063{
1064	struct generic_pm_domain *genpd;
1065
1066	dev_dbg(dev, "%s()\n", __func__);
1067
1068	genpd = dev_to_genpd(dev);
1069	if (IS_ERR(genpd))
1070		return -EINVAL;
1071
1072	if (genpd->suspend_power_off
1073	    || (dev->power.wakeup_path && genpd_dev_active_wakeup(genpd, dev)))
1074		return 0;
1075
1076	/*
1077	 * Since all of the "noirq" callbacks are executed sequentially, it is
1078	 * guaranteed that this function will never run twice in parallel for
1079	 * the same PM domain, so it is not necessary to use locking here.
1080	 */
1081	pm_genpd_sync_poweron(genpd);
1082	genpd->suspended_count--;
 
 
1083
1084	return genpd_start_dev(genpd, dev);
1085}
1086
1087/**
1088 * pm_genpd_resume_early - Early resume of a device in an I/O PM domain.
1089 * @dev: Device to resume.
1090 *
1091 * Carry out an early resume of a device under the assumption that its
1092 * pm_domain field points to the domain member of an object of type
1093 * struct generic_pm_domain representing a power domain consisting of I/O
1094 * devices.
1095 */
1096static int pm_genpd_resume_early(struct device *dev)
1097{
1098	struct generic_pm_domain *genpd;
1099
1100	dev_dbg(dev, "%s()\n", __func__);
1101
1102	genpd = dev_to_genpd(dev);
1103	if (IS_ERR(genpd))
1104		return -EINVAL;
1105
1106	return genpd->suspend_power_off ? 0 : genpd_resume_early(genpd, dev);
1107}
1108
1109/**
1110 * pm_genpd_resume - Resume of device in an I/O PM domain.
1111 * @dev: Device to resume.
1112 *
1113 * Resume a device under the assumption that its pm_domain field points to the
1114 * domain member of an object of type struct generic_pm_domain representing
1115 * a power domain consisting of I/O devices.
1116 */
1117static int pm_genpd_resume(struct device *dev)
1118{
1119	struct generic_pm_domain *genpd;
1120
1121	dev_dbg(dev, "%s()\n", __func__);
1122
1123	genpd = dev_to_genpd(dev);
1124	if (IS_ERR(genpd))
1125		return -EINVAL;
1126
1127	return genpd->suspend_power_off ? 0 : genpd_resume_dev(genpd, dev);
1128}
1129
1130/**
1131 * pm_genpd_freeze - Freezing a device in an I/O PM domain.
1132 * @dev: Device to freeze.
1133 *
1134 * Freeze a device under the assumption that its pm_domain field points to the
1135 * domain member of an object of type struct generic_pm_domain representing
1136 * a power domain consisting of I/O devices.
1137 */
1138static int pm_genpd_freeze(struct device *dev)
1139{
1140	struct generic_pm_domain *genpd;
1141
1142	dev_dbg(dev, "%s()\n", __func__);
1143
1144	genpd = dev_to_genpd(dev);
1145	if (IS_ERR(genpd))
1146		return -EINVAL;
1147
1148	return genpd->suspend_power_off ? 0 : genpd_freeze_dev(genpd, dev);
1149}
1150
1151/**
1152 * pm_genpd_freeze_late - Late freeze of a device in an I/O PM domain.
1153 * @dev: Device to freeze.
1154 *
1155 * Carry out a late freeze of a device under the assumption that its
1156 * pm_domain field points to the domain member of an object of type
1157 * struct generic_pm_domain representing a power domain consisting of I/O
1158 * devices.
1159 */
1160static int pm_genpd_freeze_late(struct device *dev)
1161{
1162	struct generic_pm_domain *genpd;
 
1163
1164	dev_dbg(dev, "%s()\n", __func__);
1165
1166	genpd = dev_to_genpd(dev);
1167	if (IS_ERR(genpd))
1168		return -EINVAL;
1169
1170	return genpd->suspend_power_off ? 0 : genpd_freeze_late(genpd, dev);
 
 
 
 
 
 
 
 
 
 
1171}
1172
1173/**
1174 * pm_genpd_freeze_noirq - Completion of freezing a device in an I/O PM domain.
1175 * @dev: Device to freeze.
1176 *
1177 * Carry out a late freeze of a device under the assumption that its
1178 * pm_domain field points to the domain member of an object of type
1179 * struct generic_pm_domain representing a power domain consisting of I/O
1180 * devices.
1181 */
1182static int pm_genpd_freeze_noirq(struct device *dev)
1183{
1184	struct generic_pm_domain *genpd;
1185
1186	dev_dbg(dev, "%s()\n", __func__);
1187
1188	genpd = dev_to_genpd(dev);
1189	if (IS_ERR(genpd))
1190		return -EINVAL;
1191
1192	return genpd->suspend_power_off ? 0 : genpd_stop_dev(genpd, dev);
 
 
 
 
 
 
1193}
1194
1195/**
1196 * pm_genpd_thaw_noirq - Early thaw of device in an I/O PM domain.
1197 * @dev: Device to thaw.
1198 *
1199 * Start the device, unless power has been removed from the domain already
1200 * before the system transition.
 
1201 */
1202static int pm_genpd_thaw_noirq(struct device *dev)
1203{
1204	struct generic_pm_domain *genpd;
1205
1206	dev_dbg(dev, "%s()\n", __func__);
1207
1208	genpd = dev_to_genpd(dev);
1209	if (IS_ERR(genpd))
1210		return -EINVAL;
1211
1212	return genpd->suspend_power_off ? 0 : genpd_start_dev(genpd, dev);
1213}
1214
1215/**
1216 * pm_genpd_thaw_early - Early thaw of device in an I/O PM domain.
1217 * @dev: Device to thaw.
1218 *
1219 * Carry out an early thaw of a device under the assumption that its
1220 * pm_domain field points to the domain member of an object of type
1221 * struct generic_pm_domain representing a power domain consisting of I/O
1222 * devices.
1223 */
1224static int pm_genpd_thaw_early(struct device *dev)
1225{
1226	struct generic_pm_domain *genpd;
1227
1228	dev_dbg(dev, "%s()\n", __func__);
1229
1230	genpd = dev_to_genpd(dev);
1231	if (IS_ERR(genpd))
1232		return -EINVAL;
1233
1234	return genpd->suspend_power_off ? 0 : genpd_thaw_early(genpd, dev);
1235}
1236
1237/**
1238 * pm_genpd_thaw - Thaw a device belonging to an I/O power domain.
1239 * @dev: Device to thaw.
1240 *
1241 * Thaw a device under the assumption that its pm_domain field points to the
1242 * domain member of an object of type struct generic_pm_domain representing
1243 * a power domain consisting of I/O devices.
1244 */
1245static int pm_genpd_thaw(struct device *dev)
1246{
1247	struct generic_pm_domain *genpd;
 
1248
1249	dev_dbg(dev, "%s()\n", __func__);
1250
1251	genpd = dev_to_genpd(dev);
1252	if (IS_ERR(genpd))
1253		return -EINVAL;
1254
1255	return genpd->suspend_power_off ? 0 : genpd_thaw_dev(genpd, dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1256}
1257
1258/**
1259 * pm_genpd_restore_noirq - Start of restore of device in an I/O PM domain.
1260 * @dev: Device to resume.
1261 *
1262 * Make sure the domain will be in the same power state as before the
1263 * hibernation the system is resuming from and start the device if necessary.
 
 
1264 */
1265static int pm_genpd_restore_noirq(struct device *dev)
1266{
1267	struct generic_pm_domain *genpd;
1268
1269	dev_dbg(dev, "%s()\n", __func__);
1270
1271	genpd = dev_to_genpd(dev);
1272	if (IS_ERR(genpd))
1273		return -EINVAL;
1274
1275	/*
1276	 * Since all of the "noirq" callbacks are executed sequentially, it is
1277	 * guaranteed that this function will never run twice in parallel for
1278	 * the same PM domain, so it is not necessary to use locking here.
1279	 *
1280	 * At this point suspended_count == 0 means we are being run for the
1281	 * first time for the given domain in the present cycle.
1282	 */
1283	if (genpd->suspended_count++ == 0) {
 
1284		/*
1285		 * The boot kernel might put the domain into arbitrary state,
1286		 * so make it appear as powered off to pm_genpd_sync_poweron(),
1287		 * so that it tries to power it on in case it was really off.
1288		 */
1289		genpd->status = GPD_STATE_POWER_OFF;
1290		if (genpd->suspend_power_off) {
1291			/*
1292			 * If the domain was off before the hibernation, make
1293			 * sure it will be off going forward.
1294			 */
1295			if (genpd->power_off)
1296				genpd->power_off(genpd);
1297
1298			return 0;
1299		}
1300	}
1301
1302	if (genpd->suspend_power_off)
1303		return 0;
 
 
1304
1305	pm_genpd_sync_poweron(genpd);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1306
1307	return genpd_start_dev(genpd, dev);
1308}
1309
1310/**
1311 * pm_genpd_complete - Complete power transition of a device in a power domain.
1312 * @dev: Device to complete the transition of.
1313 *
1314 * Complete a power transition of a device (during a system-wide power
1315 * transition) under the assumption that its pm_domain field points to the
1316 * domain member of an object of type struct generic_pm_domain representing
1317 * a power domain consisting of I/O devices.
1318 */
1319static void pm_genpd_complete(struct device *dev)
1320{
1321	struct generic_pm_domain *genpd;
1322	bool run_complete;
1323
1324	dev_dbg(dev, "%s()\n", __func__);
1325
1326	genpd = dev_to_genpd(dev);
1327	if (IS_ERR(genpd))
1328		return;
1329
1330	mutex_lock(&genpd->lock);
1331
1332	run_complete = !genpd->suspend_power_off;
1333	if (--genpd->prepared_count == 0)
1334		genpd->suspend_power_off = false;
1335
1336	mutex_unlock(&genpd->lock);
1337
1338	if (run_complete) {
1339		pm_generic_complete(dev);
1340		pm_runtime_set_active(dev);
1341		pm_runtime_enable(dev);
1342		pm_request_idle(dev);
1343	}
1344}
1345
1346/**
1347 * pm_genpd_syscore_switch - Switch power during system core suspend or resume.
1348 * @dev: Device that normally is marked as "always on" to switch power for.
1349 *
1350 * This routine may only be called during the system core (syscore) suspend or
1351 * resume phase for devices whose "always on" flags are set.
1352 */
1353void pm_genpd_syscore_switch(struct device *dev, bool suspend)
1354{
1355	struct generic_pm_domain *genpd;
1356
1357	genpd = dev_to_genpd(dev);
1358	if (!pm_genpd_present(genpd))
1359		return;
1360
1361	if (suspend) {
1362		genpd->suspended_count++;
1363		pm_genpd_sync_poweroff(genpd);
1364	} else {
1365		pm_genpd_sync_poweron(genpd);
1366		genpd->suspended_count--;
1367	}
1368}
1369EXPORT_SYMBOL_GPL(pm_genpd_syscore_switch);
1370
1371#else
1372
1373#define pm_genpd_prepare		NULL
1374#define pm_genpd_suspend		NULL
1375#define pm_genpd_suspend_late		NULL
1376#define pm_genpd_suspend_noirq		NULL
1377#define pm_genpd_resume_early		NULL
1378#define pm_genpd_resume_noirq		NULL
1379#define pm_genpd_resume			NULL
1380#define pm_genpd_freeze			NULL
1381#define pm_genpd_freeze_late		NULL
1382#define pm_genpd_freeze_noirq		NULL
1383#define pm_genpd_thaw_early		NULL
1384#define pm_genpd_thaw_noirq		NULL
1385#define pm_genpd_thaw			NULL
 
 
1386#define pm_genpd_restore_noirq		NULL
 
1387#define pm_genpd_complete		NULL
1388
1389#endif /* CONFIG_PM_SLEEP */
1390
1391static struct generic_pm_domain_data *__pm_genpd_alloc_dev_data(struct device *dev)
1392{
1393	struct generic_pm_domain_data *gpd_data;
1394
1395	gpd_data = kzalloc(sizeof(*gpd_data), GFP_KERNEL);
1396	if (!gpd_data)
1397		return NULL;
1398
1399	mutex_init(&gpd_data->lock);
1400	gpd_data->nb.notifier_call = genpd_dev_pm_qos_notifier;
1401	dev_pm_qos_add_notifier(dev, &gpd_data->nb);
1402	return gpd_data;
1403}
1404
1405static void __pm_genpd_free_dev_data(struct device *dev,
1406				     struct generic_pm_domain_data *gpd_data)
1407{
1408	dev_pm_qos_remove_notifier(dev, &gpd_data->nb);
1409	kfree(gpd_data);
1410}
1411
1412/**
1413 * __pm_genpd_add_device - Add a device to an I/O PM domain.
1414 * @genpd: PM domain to add the device to.
1415 * @dev: Device to be added.
1416 * @td: Set of PM QoS timing parameters to attach to the device.
1417 */
1418int __pm_genpd_add_device(struct generic_pm_domain *genpd, struct device *dev,
1419			  struct gpd_timing_data *td)
1420{
1421	struct generic_pm_domain_data *gpd_data_new, *gpd_data = NULL;
1422	struct pm_domain_data *pdd;
1423	int ret = 0;
1424
1425	dev_dbg(dev, "%s()\n", __func__);
1426
1427	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
1428		return -EINVAL;
1429
1430	gpd_data_new = __pm_genpd_alloc_dev_data(dev);
1431	if (!gpd_data_new)
1432		return -ENOMEM;
1433
1434	genpd_acquire_lock(genpd);
1435
 
 
 
 
 
1436	if (genpd->prepared_count > 0) {
1437		ret = -EAGAIN;
1438		goto out;
1439	}
1440
1441	list_for_each_entry(pdd, &genpd->dev_list, list_node)
1442		if (pdd->dev == dev) {
1443			ret = -EINVAL;
1444			goto out;
1445		}
1446
1447	ret = dev_pm_get_subsys_data(dev);
1448	if (ret)
 
1449		goto out;
 
1450
 
 
 
1451	genpd->device_count++;
1452	genpd->max_off_time_changed = true;
1453
1454	spin_lock_irq(&dev->power.lock);
1455
1456	dev->pm_domain = &genpd->domain;
1457	if (dev->power.subsys_data->domain_data) {
1458		gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
1459	} else {
1460		gpd_data = gpd_data_new;
1461		dev->power.subsys_data->domain_data = &gpd_data->base;
1462	}
1463	gpd_data->refcount++;
1464	if (td)
1465		gpd_data->td = *td;
1466
1467	spin_unlock_irq(&dev->power.lock);
1468
1469	mutex_lock(&gpd_data->lock);
1470	gpd_data->base.dev = dev;
1471	list_add_tail(&gpd_data->base.list_node, &genpd->dev_list);
1472	gpd_data->need_restore = genpd->status == GPD_STATE_POWER_OFF;
1473	gpd_data->td.constraint_changed = true;
1474	gpd_data->td.effective_constraint_ns = -1;
1475	mutex_unlock(&gpd_data->lock);
1476
1477 out:
1478	genpd_release_lock(genpd);
1479
1480	if (gpd_data != gpd_data_new)
1481		__pm_genpd_free_dev_data(dev, gpd_data_new);
1482
1483	return ret;
1484}
1485
1486/**
1487 * __pm_genpd_of_add_device - Add a device to an I/O PM domain.
1488 * @genpd_node: Device tree node pointer representing a PM domain to which the
1489 *   the device is added to.
1490 * @dev: Device to be added.
1491 * @td: Set of PM QoS timing parameters to attach to the device.
1492 */
1493int __pm_genpd_of_add_device(struct device_node *genpd_node, struct device *dev,
1494			     struct gpd_timing_data *td)
1495{
1496	struct generic_pm_domain *genpd = NULL, *gpd;
1497
1498	dev_dbg(dev, "%s()\n", __func__);
1499
1500	if (IS_ERR_OR_NULL(genpd_node) || IS_ERR_OR_NULL(dev))
1501		return -EINVAL;
1502
1503	mutex_lock(&gpd_list_lock);
1504	list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
1505		if (gpd->of_node == genpd_node) {
1506			genpd = gpd;
1507			break;
1508		}
1509	}
1510	mutex_unlock(&gpd_list_lock);
1511
1512	if (!genpd)
1513		return -EINVAL;
1514
1515	return __pm_genpd_add_device(genpd, dev, td);
1516}
1517
1518
1519/**
1520 * __pm_genpd_name_add_device - Find I/O PM domain and add a device to it.
1521 * @domain_name: Name of the PM domain to add the device to.
1522 * @dev: Device to be added.
1523 * @td: Set of PM QoS timing parameters to attach to the device.
1524 */
1525int __pm_genpd_name_add_device(const char *domain_name, struct device *dev,
1526			       struct gpd_timing_data *td)
1527{
1528	return __pm_genpd_add_device(pm_genpd_lookup_name(domain_name), dev, td);
1529}
1530
1531/**
1532 * pm_genpd_remove_device - Remove a device from an I/O PM domain.
1533 * @genpd: PM domain to remove the device from.
1534 * @dev: Device to be removed.
1535 */
1536int pm_genpd_remove_device(struct generic_pm_domain *genpd,
1537			   struct device *dev)
1538{
1539	struct generic_pm_domain_data *gpd_data;
1540	struct pm_domain_data *pdd;
1541	bool remove = false;
1542	int ret = 0;
1543
1544	dev_dbg(dev, "%s()\n", __func__);
1545
1546	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev)
1547	    ||  IS_ERR_OR_NULL(dev->pm_domain)
1548	    ||  pd_to_genpd(dev->pm_domain) != genpd)
1549		return -EINVAL;
1550
1551	genpd_acquire_lock(genpd);
1552
1553	if (genpd->prepared_count > 0) {
1554		ret = -EAGAIN;
1555		goto out;
1556	}
1557
1558	genpd->device_count--;
1559	genpd->max_off_time_changed = true;
1560
1561	spin_lock_irq(&dev->power.lock);
1562
1563	dev->pm_domain = NULL;
1564	pdd = dev->power.subsys_data->domain_data;
1565	list_del_init(&pdd->list_node);
1566	gpd_data = to_gpd_data(pdd);
1567	if (--gpd_data->refcount == 0) {
1568		dev->power.subsys_data->domain_data = NULL;
1569		remove = true;
1570	}
1571
1572	spin_unlock_irq(&dev->power.lock);
1573
1574	mutex_lock(&gpd_data->lock);
1575	pdd->dev = NULL;
1576	mutex_unlock(&gpd_data->lock);
1577
1578	genpd_release_lock(genpd);
 
 
1579
1580	dev_pm_put_subsys_data(dev);
1581	if (remove)
1582		__pm_genpd_free_dev_data(dev, gpd_data);
1583
1584	return 0;
 
 
1585
1586 out:
1587	genpd_release_lock(genpd);
1588
1589	return ret;
1590}
1591
1592/**
1593 * pm_genpd_dev_need_restore - Set/unset the device's "need restore" flag.
1594 * @dev: Device to set/unset the flag for.
1595 * @val: The new value of the device's "need restore" flag.
1596 */
1597void pm_genpd_dev_need_restore(struct device *dev, bool val)
1598{
1599	struct pm_subsys_data *psd;
1600	unsigned long flags;
1601
1602	spin_lock_irqsave(&dev->power.lock, flags);
1603
1604	psd = dev_to_psd(dev);
1605	if (psd && psd->domain_data)
1606		to_gpd_data(psd->domain_data)->need_restore = val;
1607
1608	spin_unlock_irqrestore(&dev->power.lock, flags);
1609}
1610EXPORT_SYMBOL_GPL(pm_genpd_dev_need_restore);
1611
1612/**
1613 * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
1614 * @genpd: Master PM domain to add the subdomain to.
1615 * @subdomain: Subdomain to be added.
1616 */
1617int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
1618			   struct generic_pm_domain *subdomain)
1619{
1620	struct gpd_link *link;
1621	int ret = 0;
1622
1623	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain)
1624	    || genpd == subdomain)
1625		return -EINVAL;
1626
1627 start:
1628	genpd_acquire_lock(genpd);
1629	mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
1630
1631	if (subdomain->status != GPD_STATE_POWER_OFF
1632	    && subdomain->status != GPD_STATE_ACTIVE) {
1633		mutex_unlock(&subdomain->lock);
1634		genpd_release_lock(genpd);
1635		goto start;
1636	}
1637
1638	if (genpd->status == GPD_STATE_POWER_OFF
1639	    &&  subdomain->status != GPD_STATE_POWER_OFF) {
1640		ret = -EINVAL;
1641		goto out;
1642	}
1643
1644	list_for_each_entry(link, &genpd->master_links, master_node) {
1645		if (link->slave == subdomain && link->master == genpd) {
1646			ret = -EINVAL;
1647			goto out;
1648		}
1649	}
1650
1651	link = kzalloc(sizeof(*link), GFP_KERNEL);
1652	if (!link) {
1653		ret = -ENOMEM;
1654		goto out;
1655	}
1656	link->master = genpd;
1657	list_add_tail(&link->master_node, &genpd->master_links);
1658	link->slave = subdomain;
1659	list_add_tail(&link->slave_node, &subdomain->slave_links);
1660	if (subdomain->status != GPD_STATE_POWER_OFF)
1661		genpd_sd_counter_inc(genpd);
1662
1663 out:
1664	mutex_unlock(&subdomain->lock);
1665	genpd_release_lock(genpd);
1666
1667	return ret;
1668}
1669
1670/**
1671 * pm_genpd_add_subdomain_names - Add a subdomain to an I/O PM domain.
1672 * @master_name: Name of the master PM domain to add the subdomain to.
1673 * @subdomain_name: Name of the subdomain to be added.
1674 */
1675int pm_genpd_add_subdomain_names(const char *master_name,
1676				 const char *subdomain_name)
1677{
1678	struct generic_pm_domain *master = NULL, *subdomain = NULL, *gpd;
1679
1680	if (IS_ERR_OR_NULL(master_name) || IS_ERR_OR_NULL(subdomain_name))
1681		return -EINVAL;
1682
1683	mutex_lock(&gpd_list_lock);
1684	list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
1685		if (!master && !strcmp(gpd->name, master_name))
1686			master = gpd;
1687
1688		if (!subdomain && !strcmp(gpd->name, subdomain_name))
1689			subdomain = gpd;
1690
1691		if (master && subdomain)
1692			break;
1693	}
1694	mutex_unlock(&gpd_list_lock);
1695
1696	return pm_genpd_add_subdomain(master, subdomain);
1697}
1698
1699/**
1700 * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
1701 * @genpd: Master PM domain to remove the subdomain from.
1702 * @subdomain: Subdomain to be removed.
1703 */
1704int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
1705			      struct generic_pm_domain *subdomain)
1706{
1707	struct gpd_link *link;
1708	int ret = -EINVAL;
1709
1710	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
1711		return -EINVAL;
1712
1713 start:
1714	genpd_acquire_lock(genpd);
1715
1716	list_for_each_entry(link, &genpd->master_links, master_node) {
1717		if (link->slave != subdomain)
1718			continue;
1719
1720		mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
1721
1722		if (subdomain->status != GPD_STATE_POWER_OFF
1723		    && subdomain->status != GPD_STATE_ACTIVE) {
1724			mutex_unlock(&subdomain->lock);
1725			genpd_release_lock(genpd);
1726			goto start;
1727		}
1728
1729		list_del(&link->master_node);
1730		list_del(&link->slave_node);
1731		kfree(link);
1732		if (subdomain->status != GPD_STATE_POWER_OFF)
1733			genpd_sd_counter_dec(genpd);
1734
1735		mutex_unlock(&subdomain->lock);
1736
1737		ret = 0;
1738		break;
1739	}
1740
1741	genpd_release_lock(genpd);
1742
1743	return ret;
1744}
1745
1746/**
1747 * pm_genpd_add_callbacks - Add PM domain callbacks to a given device.
1748 * @dev: Device to add the callbacks to.
1749 * @ops: Set of callbacks to add.
1750 * @td: Timing data to add to the device along with the callbacks (optional).
1751 *
1752 * Every call to this routine should be balanced with a call to
1753 * __pm_genpd_remove_callbacks() and they must not be nested.
1754 */
1755int pm_genpd_add_callbacks(struct device *dev, struct gpd_dev_ops *ops,
1756			   struct gpd_timing_data *td)
1757{
1758	struct generic_pm_domain_data *gpd_data_new, *gpd_data = NULL;
1759	int ret = 0;
1760
1761	if (!(dev && ops))
1762		return -EINVAL;
1763
1764	gpd_data_new = __pm_genpd_alloc_dev_data(dev);
1765	if (!gpd_data_new)
1766		return -ENOMEM;
1767
1768	pm_runtime_disable(dev);
1769	device_pm_lock();
1770
1771	ret = dev_pm_get_subsys_data(dev);
1772	if (ret)
1773		goto out;
1774
1775	spin_lock_irq(&dev->power.lock);
1776
1777	if (dev->power.subsys_data->domain_data) {
1778		gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
1779	} else {
1780		gpd_data = gpd_data_new;
1781		dev->power.subsys_data->domain_data = &gpd_data->base;
1782	}
1783	gpd_data->refcount++;
1784	gpd_data->ops = *ops;
1785	if (td)
1786		gpd_data->td = *td;
1787
1788	spin_unlock_irq(&dev->power.lock);
1789
1790 out:
1791	device_pm_unlock();
1792	pm_runtime_enable(dev);
1793
1794	if (gpd_data != gpd_data_new)
1795		__pm_genpd_free_dev_data(dev, gpd_data_new);
1796
1797	return ret;
1798}
1799EXPORT_SYMBOL_GPL(pm_genpd_add_callbacks);
1800
1801/**
1802 * __pm_genpd_remove_callbacks - Remove PM domain callbacks from a given device.
1803 * @dev: Device to remove the callbacks from.
1804 * @clear_td: If set, clear the device's timing data too.
1805 *
1806 * This routine can only be called after pm_genpd_add_callbacks().
1807 */
1808int __pm_genpd_remove_callbacks(struct device *dev, bool clear_td)
1809{
1810	struct generic_pm_domain_data *gpd_data = NULL;
1811	bool remove = false;
1812	int ret = 0;
1813
1814	if (!(dev && dev->power.subsys_data))
1815		return -EINVAL;
1816
1817	pm_runtime_disable(dev);
1818	device_pm_lock();
1819
1820	spin_lock_irq(&dev->power.lock);
1821
1822	if (dev->power.subsys_data->domain_data) {
1823		gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
1824		gpd_data->ops = (struct gpd_dev_ops){ NULL };
1825		if (clear_td)
1826			gpd_data->td = (struct gpd_timing_data){ 0 };
1827
1828		if (--gpd_data->refcount == 0) {
1829			dev->power.subsys_data->domain_data = NULL;
1830			remove = true;
1831		}
1832	} else {
1833		ret = -EINVAL;
1834	}
1835
1836	spin_unlock_irq(&dev->power.lock);
1837
1838	device_pm_unlock();
1839	pm_runtime_enable(dev);
1840
1841	if (ret)
1842		return ret;
1843
1844	dev_pm_put_subsys_data(dev);
1845	if (remove)
1846		__pm_genpd_free_dev_data(dev, gpd_data);
1847
1848	return 0;
1849}
1850EXPORT_SYMBOL_GPL(__pm_genpd_remove_callbacks);
1851
1852/**
1853 * pm_genpd_attach_cpuidle - Connect the given PM domain with cpuidle.
1854 * @genpd: PM domain to be connected with cpuidle.
1855 * @state: cpuidle state this domain can disable/enable.
1856 *
1857 * Make a PM domain behave as though it contained a CPU core, that is, instead
1858 * of calling its power down routine it will enable the given cpuidle state so
1859 * that the cpuidle subsystem can power it down (if possible and desirable).
1860 */
1861int pm_genpd_attach_cpuidle(struct generic_pm_domain *genpd, int state)
1862{
1863	struct cpuidle_driver *cpuidle_drv;
1864	struct gpd_cpu_data *cpu_data;
1865	struct cpuidle_state *idle_state;
1866	int ret = 0;
1867
1868	if (IS_ERR_OR_NULL(genpd) || state < 0)
1869		return -EINVAL;
1870
1871	genpd_acquire_lock(genpd);
1872
1873	if (genpd->cpu_data) {
1874		ret = -EEXIST;
1875		goto out;
1876	}
1877	cpu_data = kzalloc(sizeof(*cpu_data), GFP_KERNEL);
1878	if (!cpu_data) {
1879		ret = -ENOMEM;
1880		goto out;
1881	}
1882	cpuidle_drv = cpuidle_driver_ref();
1883	if (!cpuidle_drv) {
1884		ret = -ENODEV;
1885		goto err_drv;
1886	}
1887	if (cpuidle_drv->state_count <= state) {
1888		ret = -EINVAL;
1889		goto err;
1890	}
1891	idle_state = &cpuidle_drv->states[state];
1892	if (!idle_state->disabled) {
1893		ret = -EAGAIN;
1894		goto err;
1895	}
1896	cpu_data->idle_state = idle_state;
1897	cpu_data->saved_exit_latency = idle_state->exit_latency;
1898	genpd->cpu_data = cpu_data;
1899	genpd_recalc_cpu_exit_latency(genpd);
1900
1901 out:
1902	genpd_release_lock(genpd);
1903	return ret;
1904
1905 err:
1906	cpuidle_driver_unref();
1907
1908 err_drv:
1909	kfree(cpu_data);
1910	goto out;
1911}
1912
1913/**
1914 * pm_genpd_name_attach_cpuidle - Find PM domain and connect cpuidle to it.
1915 * @name: Name of the domain to connect to cpuidle.
1916 * @state: cpuidle state this domain can manipulate.
1917 */
1918int pm_genpd_name_attach_cpuidle(const char *name, int state)
1919{
1920	return pm_genpd_attach_cpuidle(pm_genpd_lookup_name(name), state);
1921}
1922
1923/**
1924 * pm_genpd_detach_cpuidle - Remove the cpuidle connection from a PM domain.
1925 * @genpd: PM domain to remove the cpuidle connection from.
1926 *
1927 * Remove the cpuidle connection set up by pm_genpd_attach_cpuidle() from the
1928 * given PM domain.
1929 */
1930int pm_genpd_detach_cpuidle(struct generic_pm_domain *genpd)
1931{
1932	struct gpd_cpu_data *cpu_data;
1933	struct cpuidle_state *idle_state;
1934	int ret = 0;
1935
1936	if (IS_ERR_OR_NULL(genpd))
1937		return -EINVAL;
1938
1939	genpd_acquire_lock(genpd);
1940
1941	cpu_data = genpd->cpu_data;
1942	if (!cpu_data) {
1943		ret = -ENODEV;
1944		goto out;
1945	}
1946	idle_state = cpu_data->idle_state;
1947	if (!idle_state->disabled) {
1948		ret = -EAGAIN;
1949		goto out;
1950	}
1951	idle_state->exit_latency = cpu_data->saved_exit_latency;
1952	cpuidle_driver_unref();
1953	genpd->cpu_data = NULL;
1954	kfree(cpu_data);
1955
1956 out:
1957	genpd_release_lock(genpd);
1958	return ret;
1959}
1960
1961/**
1962 * pm_genpd_name_detach_cpuidle - Find PM domain and disconnect cpuidle from it.
1963 * @name: Name of the domain to disconnect cpuidle from.
1964 */
1965int pm_genpd_name_detach_cpuidle(const char *name)
1966{
1967	return pm_genpd_detach_cpuidle(pm_genpd_lookup_name(name));
1968}
1969
1970/* Default device callbacks for generic PM domains. */
1971
1972/**
1973 * pm_genpd_default_save_state - Default "save device state" for PM domians.
1974 * @dev: Device to handle.
1975 */
1976static int pm_genpd_default_save_state(struct device *dev)
1977{
1978	int (*cb)(struct device *__dev);
1979
1980	cb = dev_gpd_data(dev)->ops.save_state;
1981	if (cb)
1982		return cb(dev);
1983
1984	if (dev->type && dev->type->pm)
1985		cb = dev->type->pm->runtime_suspend;
1986	else if (dev->class && dev->class->pm)
1987		cb = dev->class->pm->runtime_suspend;
1988	else if (dev->bus && dev->bus->pm)
1989		cb = dev->bus->pm->runtime_suspend;
1990	else
1991		cb = NULL;
1992
1993	if (!cb && dev->driver && dev->driver->pm)
1994		cb = dev->driver->pm->runtime_suspend;
1995
1996	return cb ? cb(dev) : 0;
1997}
1998
1999/**
2000 * pm_genpd_default_restore_state - Default PM domians "restore device state".
2001 * @dev: Device to handle.
2002 */
2003static int pm_genpd_default_restore_state(struct device *dev)
2004{
2005	int (*cb)(struct device *__dev);
2006
2007	cb = dev_gpd_data(dev)->ops.restore_state;
2008	if (cb)
2009		return cb(dev);
2010
2011	if (dev->type && dev->type->pm)
2012		cb = dev->type->pm->runtime_resume;
2013	else if (dev->class && dev->class->pm)
2014		cb = dev->class->pm->runtime_resume;
2015	else if (dev->bus && dev->bus->pm)
2016		cb = dev->bus->pm->runtime_resume;
2017	else
2018		cb = NULL;
2019
2020	if (!cb && dev->driver && dev->driver->pm)
2021		cb = dev->driver->pm->runtime_resume;
2022
2023	return cb ? cb(dev) : 0;
2024}
2025
2026#ifdef CONFIG_PM_SLEEP
2027
2028/**
2029 * pm_genpd_default_suspend - Default "device suspend" for PM domians.
2030 * @dev: Device to handle.
2031 */
2032static int pm_genpd_default_suspend(struct device *dev)
2033{
2034	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend;
2035
2036	return cb ? cb(dev) : pm_generic_suspend(dev);
2037}
2038
2039/**
2040 * pm_genpd_default_suspend_late - Default "late device suspend" for PM domians.
2041 * @dev: Device to handle.
2042 */
2043static int pm_genpd_default_suspend_late(struct device *dev)
2044{
2045	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.suspend_late;
2046
2047	return cb ? cb(dev) : pm_generic_suspend_late(dev);
2048}
2049
2050/**
2051 * pm_genpd_default_resume_early - Default "early device resume" for PM domians.
2052 * @dev: Device to handle.
2053 */
2054static int pm_genpd_default_resume_early(struct device *dev)
2055{
2056	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume_early;
2057
2058	return cb ? cb(dev) : pm_generic_resume_early(dev);
2059}
2060
2061/**
2062 * pm_genpd_default_resume - Default "device resume" for PM domians.
2063 * @dev: Device to handle.
2064 */
2065static int pm_genpd_default_resume(struct device *dev)
2066{
2067	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.resume;
2068
2069	return cb ? cb(dev) : pm_generic_resume(dev);
2070}
2071
2072/**
2073 * pm_genpd_default_freeze - Default "device freeze" for PM domians.
2074 * @dev: Device to handle.
2075 */
2076static int pm_genpd_default_freeze(struct device *dev)
2077{
2078	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze;
2079
2080	return cb ? cb(dev) : pm_generic_freeze(dev);
2081}
2082
2083/**
2084 * pm_genpd_default_freeze_late - Default "late device freeze" for PM domians.
2085 * @dev: Device to handle.
2086 */
2087static int pm_genpd_default_freeze_late(struct device *dev)
2088{
2089	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.freeze_late;
2090
2091	return cb ? cb(dev) : pm_generic_freeze_late(dev);
2092}
2093
2094/**
2095 * pm_genpd_default_thaw_early - Default "early device thaw" for PM domians.
2096 * @dev: Device to handle.
2097 */
2098static int pm_genpd_default_thaw_early(struct device *dev)
2099{
2100	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw_early;
2101
2102	return cb ? cb(dev) : pm_generic_thaw_early(dev);
2103}
2104
2105/**
2106 * pm_genpd_default_thaw - Default "device thaw" for PM domians.
2107 * @dev: Device to handle.
2108 */
2109static int pm_genpd_default_thaw(struct device *dev)
2110{
2111	int (*cb)(struct device *__dev) = dev_gpd_data(dev)->ops.thaw;
2112
2113	return cb ? cb(dev) : pm_generic_thaw(dev);
2114}
2115
2116#else /* !CONFIG_PM_SLEEP */
2117
2118#define pm_genpd_default_suspend	NULL
2119#define pm_genpd_default_suspend_late	NULL
2120#define pm_genpd_default_resume_early	NULL
2121#define pm_genpd_default_resume		NULL
2122#define pm_genpd_default_freeze		NULL
2123#define pm_genpd_default_freeze_late	NULL
2124#define pm_genpd_default_thaw_early	NULL
2125#define pm_genpd_default_thaw		NULL
2126
2127#endif /* !CONFIG_PM_SLEEP */
2128
2129/**
2130 * pm_genpd_init - Initialize a generic I/O PM domain object.
2131 * @genpd: PM domain object to initialize.
2132 * @gov: PM domain governor to associate with the domain (may be NULL).
2133 * @is_off: Initial value of the domain's power_is_off field.
2134 */
2135void pm_genpd_init(struct generic_pm_domain *genpd,
2136		   struct dev_power_governor *gov, bool is_off)
2137{
2138	if (IS_ERR_OR_NULL(genpd))
2139		return;
2140
2141	INIT_LIST_HEAD(&genpd->master_links);
2142	INIT_LIST_HEAD(&genpd->slave_links);
2143	INIT_LIST_HEAD(&genpd->dev_list);
 
2144	mutex_init(&genpd->lock);
2145	genpd->gov = gov;
2146	INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn);
2147	genpd->in_progress = 0;
2148	atomic_set(&genpd->sd_count, 0);
2149	genpd->status = is_off ? GPD_STATE_POWER_OFF : GPD_STATE_ACTIVE;
2150	init_waitqueue_head(&genpd->status_wait_queue);
2151	genpd->poweroff_task = NULL;
2152	genpd->resume_count = 0;
2153	genpd->device_count = 0;
2154	genpd->max_off_time_ns = -1;
2155	genpd->max_off_time_changed = true;
2156	genpd->domain.ops.runtime_suspend = pm_genpd_runtime_suspend;
2157	genpd->domain.ops.runtime_resume = pm_genpd_runtime_resume;
 
2158	genpd->domain.ops.prepare = pm_genpd_prepare;
2159	genpd->domain.ops.suspend = pm_genpd_suspend;
2160	genpd->domain.ops.suspend_late = pm_genpd_suspend_late;
2161	genpd->domain.ops.suspend_noirq = pm_genpd_suspend_noirq;
2162	genpd->domain.ops.resume_noirq = pm_genpd_resume_noirq;
2163	genpd->domain.ops.resume_early = pm_genpd_resume_early;
2164	genpd->domain.ops.resume = pm_genpd_resume;
2165	genpd->domain.ops.freeze = pm_genpd_freeze;
2166	genpd->domain.ops.freeze_late = pm_genpd_freeze_late;
2167	genpd->domain.ops.freeze_noirq = pm_genpd_freeze_noirq;
2168	genpd->domain.ops.thaw_noirq = pm_genpd_thaw_noirq;
2169	genpd->domain.ops.thaw_early = pm_genpd_thaw_early;
2170	genpd->domain.ops.thaw = pm_genpd_thaw;
2171	genpd->domain.ops.poweroff = pm_genpd_suspend;
2172	genpd->domain.ops.poweroff_late = pm_genpd_suspend_late;
2173	genpd->domain.ops.poweroff_noirq = pm_genpd_suspend_noirq;
2174	genpd->domain.ops.restore_noirq = pm_genpd_restore_noirq;
2175	genpd->domain.ops.restore_early = pm_genpd_resume_early;
2176	genpd->domain.ops.restore = pm_genpd_resume;
2177	genpd->domain.ops.complete = pm_genpd_complete;
2178	genpd->dev_ops.save_state = pm_genpd_default_save_state;
2179	genpd->dev_ops.restore_state = pm_genpd_default_restore_state;
2180	genpd->dev_ops.suspend = pm_genpd_default_suspend;
2181	genpd->dev_ops.suspend_late = pm_genpd_default_suspend_late;
2182	genpd->dev_ops.resume_early = pm_genpd_default_resume_early;
2183	genpd->dev_ops.resume = pm_genpd_default_resume;
2184	genpd->dev_ops.freeze = pm_genpd_default_freeze;
2185	genpd->dev_ops.freeze_late = pm_genpd_default_freeze_late;
2186	genpd->dev_ops.thaw_early = pm_genpd_default_thaw_early;
2187	genpd->dev_ops.thaw = pm_genpd_default_thaw;
2188	mutex_lock(&gpd_list_lock);
2189	list_add(&genpd->gpd_list_node, &gpd_list);
2190	mutex_unlock(&gpd_list_lock);
2191}
v3.1
   1/*
   2 * drivers/base/power/domain.c - Common code related to device power domains.
   3 *
   4 * Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, Renesas Electronics Corp.
   5 *
   6 * This file is released under the GPLv2.
   7 */
   8
   9#include <linux/init.h>
  10#include <linux/kernel.h>
  11#include <linux/io.h>
  12#include <linux/pm_runtime.h>
  13#include <linux/pm_domain.h>
 
  14#include <linux/slab.h>
  15#include <linux/err.h>
  16#include <linux/sched.h>
  17#include <linux/suspend.h>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  18
  19static LIST_HEAD(gpd_list);
  20static DEFINE_MUTEX(gpd_list_lock);
  21
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  22#ifdef CONFIG_PM
  23
  24static struct generic_pm_domain *dev_to_genpd(struct device *dev)
  25{
  26	if (IS_ERR_OR_NULL(dev->pm_domain))
  27		return ERR_PTR(-EINVAL);
  28
  29	return pd_to_genpd(dev->pm_domain);
  30}
  31
  32static void genpd_sd_counter_dec(struct generic_pm_domain *genpd)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  33{
  34	if (!WARN_ON(genpd->sd_count == 0))
  35			genpd->sd_count--;
  36}
  37
  38static void genpd_acquire_lock(struct generic_pm_domain *genpd)
  39{
  40	DEFINE_WAIT(wait);
  41
  42	mutex_lock(&genpd->lock);
  43	/*
  44	 * Wait for the domain to transition into either the active,
  45	 * or the power off state.
  46	 */
  47	for (;;) {
  48		prepare_to_wait(&genpd->status_wait_queue, &wait,
  49				TASK_UNINTERRUPTIBLE);
  50		if (genpd->status == GPD_STATE_ACTIVE
  51		    || genpd->status == GPD_STATE_POWER_OFF)
  52			break;
  53		mutex_unlock(&genpd->lock);
  54
  55		schedule();
  56
  57		mutex_lock(&genpd->lock);
  58	}
  59	finish_wait(&genpd->status_wait_queue, &wait);
  60}
  61
  62static void genpd_release_lock(struct generic_pm_domain *genpd)
  63{
  64	mutex_unlock(&genpd->lock);
  65}
  66
  67static void genpd_set_active(struct generic_pm_domain *genpd)
  68{
  69	if (genpd->resume_count == 0)
  70		genpd->status = GPD_STATE_ACTIVE;
  71}
  72
 
 
 
 
 
 
 
 
 
 
 
 
 
  73/**
  74 * pm_genpd_poweron - Restore power to a given PM domain and its parents.
  75 * @genpd: PM domain to power up.
  76 *
  77 * Restore power to @genpd and all of its parents so that it is possible to
  78 * resume a device belonging to it.
  79 */
  80int pm_genpd_poweron(struct generic_pm_domain *genpd)
 
  81{
  82	struct generic_pm_domain *parent = genpd->parent;
 
  83	int ret = 0;
  84
  85 start:
  86	if (parent) {
  87		genpd_acquire_lock(parent);
  88		mutex_lock_nested(&genpd->lock, SINGLE_DEPTH_NESTING);
  89	} else {
 
 
 
 
 
  90		mutex_lock(&genpd->lock);
  91	}
 
  92
  93	if (genpd->status == GPD_STATE_ACTIVE
  94	    || (genpd->prepared_count > 0 && genpd->suspend_power_off))
  95		goto out;
  96
  97	if (genpd->status != GPD_STATE_POWER_OFF) {
  98		genpd_set_active(genpd);
 
 
 
 
 
 
 
  99		goto out;
 100	}
 101
 102	if (parent && parent->status != GPD_STATE_ACTIVE) {
 
 
 
 
 
 
 
 
 103		mutex_unlock(&genpd->lock);
 104		genpd_release_lock(parent);
 105
 106		ret = pm_genpd_poweron(parent);
 107		if (ret)
 108			return ret;
 109
 110		goto start;
 
 
 
 
 
 
 
 
 
 111	}
 112
 113	if (genpd->power_on) {
 
 
 
 114		ret = genpd->power_on(genpd);
 115		if (ret)
 116			goto out;
 
 
 
 
 
 
 
 
 
 
 
 117	}
 118
 
 119	genpd_set_active(genpd);
 120	if (parent)
 121		parent->sd_count++;
 122
 123 out:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 124	mutex_unlock(&genpd->lock);
 125	if (parent)
 126		genpd_release_lock(parent);
 127
 128	return ret;
 
 
 
 
 
 
 
 
 
 129}
 130
 131#endif /* CONFIG_PM */
 132
 133#ifdef CONFIG_PM_RUNTIME
 134
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 135/**
 136 * __pm_genpd_save_device - Save the pre-suspend state of a device.
 137 * @dle: Device list entry of the device to save the state of.
 138 * @genpd: PM domain the device belongs to.
 139 */
 140static int __pm_genpd_save_device(struct dev_list_entry *dle,
 141				  struct generic_pm_domain *genpd)
 142	__releases(&genpd->lock) __acquires(&genpd->lock)
 143{
 144	struct device *dev = dle->dev;
 145	struct device_driver *drv = dev->driver;
 146	int ret = 0;
 147
 148	if (dle->need_restore)
 149		return 0;
 150
 151	mutex_unlock(&genpd->lock);
 152
 153	if (drv && drv->pm && drv->pm->runtime_suspend) {
 154		if (genpd->start_device)
 155			genpd->start_device(dev);
 156
 157		ret = drv->pm->runtime_suspend(dev);
 158
 159		if (genpd->stop_device)
 160			genpd->stop_device(dev);
 161	}
 162
 163	mutex_lock(&genpd->lock);
 164
 165	if (!ret)
 166		dle->need_restore = true;
 167
 168	return ret;
 169}
 170
 171/**
 172 * __pm_genpd_restore_device - Restore the pre-suspend state of a device.
 173 * @dle: Device list entry of the device to restore the state of.
 174 * @genpd: PM domain the device belongs to.
 175 */
 176static void __pm_genpd_restore_device(struct dev_list_entry *dle,
 177				      struct generic_pm_domain *genpd)
 178	__releases(&genpd->lock) __acquires(&genpd->lock)
 179{
 180	struct device *dev = dle->dev;
 181	struct device_driver *drv = dev->driver;
 182
 183	if (!dle->need_restore)
 184		return;
 185
 
 186	mutex_unlock(&genpd->lock);
 187
 188	if (drv && drv->pm && drv->pm->runtime_resume) {
 189		if (genpd->start_device)
 190			genpd->start_device(dev);
 191
 192		drv->pm->runtime_resume(dev);
 193
 194		if (genpd->stop_device)
 195			genpd->stop_device(dev);
 196	}
 197
 198	mutex_lock(&genpd->lock);
 199
 200	dle->need_restore = false;
 201}
 202
 203/**
 204 * genpd_abort_poweroff - Check if a PM domain power off should be aborted.
 205 * @genpd: PM domain to check.
 206 *
 207 * Return true if a PM domain's status changed to GPD_STATE_ACTIVE during
 208 * a "power off" operation, which means that a "power on" has occured in the
 209 * meantime, or if its resume_count field is different from zero, which means
 210 * that one of its devices has been resumed in the meantime.
 211 */
 212static bool genpd_abort_poweroff(struct generic_pm_domain *genpd)
 213{
 214	return genpd->status == GPD_STATE_ACTIVE || genpd->resume_count > 0;
 
 215}
 216
 217/**
 218 * genpd_queue_power_off_work - Queue up the execution of pm_genpd_poweroff().
 219 * @genpd: PM domait to power off.
 220 *
 221 * Queue up the execution of pm_genpd_poweroff() unless it's already been done
 222 * before.
 223 */
 224void genpd_queue_power_off_work(struct generic_pm_domain *genpd)
 225{
 226	if (!work_pending(&genpd->power_off_work))
 227		queue_work(pm_wq, &genpd->power_off_work);
 228}
 229
 230/**
 231 * pm_genpd_poweroff - Remove power from a given PM domain.
 232 * @genpd: PM domain to power down.
 233 *
 234 * If all of the @genpd's devices have been suspended and all of its subdomains
 235 * have been powered down, run the runtime suspend callbacks provided by all of
 236 * the @genpd's devices' drivers and remove power from @genpd.
 237 */
 238static int pm_genpd_poweroff(struct generic_pm_domain *genpd)
 239	__releases(&genpd->lock) __acquires(&genpd->lock)
 240{
 241	struct generic_pm_domain *parent;
 242	struct dev_list_entry *dle;
 243	unsigned int not_suspended;
 244	int ret = 0;
 245
 246 start:
 247	/*
 248	 * Do not try to power off the domain in the following situations:
 249	 * (1) The domain is already in the "power off" state.
 250	 * (2) System suspend is in progress.
 251	 * (3) One of the domain's devices is being resumed right now.
 
 252	 */
 253	if (genpd->status == GPD_STATE_POWER_OFF || genpd->prepared_count > 0
 254	    || genpd->resume_count > 0)
 
 255		return 0;
 256
 257	if (genpd->sd_count > 0)
 258		return -EBUSY;
 259
 260	not_suspended = 0;
 261	list_for_each_entry(dle, &genpd->dev_list, node)
 262		if (dle->dev->driver && !pm_runtime_suspended(dle->dev))
 
 
 
 
 
 
 
 
 
 263			not_suspended++;
 
 264
 265	if (not_suspended > genpd->in_progress)
 266		return -EBUSY;
 267
 268	if (genpd->poweroff_task) {
 269		/*
 270		 * Another instance of pm_genpd_poweroff() is executing
 271		 * callbacks, so tell it to start over and return.
 272		 */
 273		genpd->status = GPD_STATE_REPEAT;
 274		return 0;
 275	}
 276
 277	if (genpd->gov && genpd->gov->power_down_ok) {
 278		if (!genpd->gov->power_down_ok(&genpd->domain))
 279			return -EAGAIN;
 280	}
 281
 282	genpd->status = GPD_STATE_BUSY;
 283	genpd->poweroff_task = current;
 284
 285	list_for_each_entry_reverse(dle, &genpd->dev_list, node) {
 286		ret = __pm_genpd_save_device(dle, genpd);
 
 
 
 
 
 287		if (ret) {
 288			genpd_set_active(genpd);
 289			goto out;
 290		}
 291
 292		if (genpd_abort_poweroff(genpd))
 293			goto out;
 294
 295		if (genpd->status == GPD_STATE_REPEAT) {
 296			genpd->poweroff_task = NULL;
 297			goto start;
 298		}
 299	}
 300
 301	parent = genpd->parent;
 302	if (parent) {
 303		mutex_unlock(&genpd->lock);
 
 
 
 
 
 
 
 
 
 
 
 304
 305		genpd_acquire_lock(parent);
 306		mutex_lock_nested(&genpd->lock, SINGLE_DEPTH_NESTING);
 
 307
 308		if (genpd_abort_poweroff(genpd)) {
 309			genpd_release_lock(parent);
 310			goto out;
 311		}
 312	}
 313
 314	if (genpd->power_off) {
 
 
 
 
 
 
 
 
 
 315		ret = genpd->power_off(genpd);
 316		if (ret == -EBUSY) {
 317			genpd_set_active(genpd);
 318			if (parent)
 319				genpd_release_lock(parent);
 320
 321			goto out;
 
 
 
 
 
 
 
 322		}
 323	}
 324
 325	genpd->status = GPD_STATE_POWER_OFF;
 326
 327	if (parent) {
 328		genpd_sd_counter_dec(parent);
 329		if (parent->sd_count == 0)
 330			genpd_queue_power_off_work(parent);
 331
 332		genpd_release_lock(parent);
 333	}
 334
 335 out:
 336	genpd->poweroff_task = NULL;
 337	wake_up_all(&genpd->status_wait_queue);
 338	return ret;
 339}
 340
 341/**
 342 * genpd_power_off_work_fn - Power off PM domain whose subdomain count is 0.
 343 * @work: Work structure used for scheduling the execution of this function.
 344 */
 345static void genpd_power_off_work_fn(struct work_struct *work)
 346{
 347	struct generic_pm_domain *genpd;
 348
 349	genpd = container_of(work, struct generic_pm_domain, power_off_work);
 350
 351	genpd_acquire_lock(genpd);
 352	pm_genpd_poweroff(genpd);
 353	genpd_release_lock(genpd);
 354}
 355
 356/**
 357 * pm_genpd_runtime_suspend - Suspend a device belonging to I/O PM domain.
 358 * @dev: Device to suspend.
 359 *
 360 * Carry out a runtime suspend of a device under the assumption that its
 361 * pm_domain field points to the domain member of an object of type
 362 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 363 */
 364static int pm_genpd_runtime_suspend(struct device *dev)
 365{
 366	struct generic_pm_domain *genpd;
 
 
 367
 368	dev_dbg(dev, "%s()\n", __func__);
 369
 370	genpd = dev_to_genpd(dev);
 371	if (IS_ERR(genpd))
 372		return -EINVAL;
 373
 374	if (genpd->stop_device) {
 375		int ret = genpd->stop_device(dev);
 376		if (ret)
 377			return ret;
 378	}
 
 
 
 
 
 
 
 
 
 
 
 379
 380	mutex_lock(&genpd->lock);
 381	genpd->in_progress++;
 382	pm_genpd_poweroff(genpd);
 383	genpd->in_progress--;
 384	mutex_unlock(&genpd->lock);
 385
 386	return 0;
 387}
 388
 389/**
 390 * __pm_genpd_runtime_resume - Resume a device belonging to I/O PM domain.
 391 * @dev: Device to resume.
 392 * @genpd: PM domain the device belongs to.
 393 */
 394static void __pm_genpd_runtime_resume(struct device *dev,
 395				      struct generic_pm_domain *genpd)
 396{
 397	struct dev_list_entry *dle;
 398
 399	list_for_each_entry(dle, &genpd->dev_list, node) {
 400		if (dle->dev == dev) {
 401			__pm_genpd_restore_device(dle, genpd);
 402			break;
 403		}
 404	}
 405}
 406
 407/**
 408 * pm_genpd_runtime_resume - Resume a device belonging to I/O PM domain.
 409 * @dev: Device to resume.
 410 *
 411 * Carry out a runtime resume of a device under the assumption that its
 412 * pm_domain field points to the domain member of an object of type
 413 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 414 */
 415static int pm_genpd_runtime_resume(struct device *dev)
 416{
 417	struct generic_pm_domain *genpd;
 418	DEFINE_WAIT(wait);
 419	int ret;
 420
 421	dev_dbg(dev, "%s()\n", __func__);
 422
 423	genpd = dev_to_genpd(dev);
 424	if (IS_ERR(genpd))
 425		return -EINVAL;
 426
 427	ret = pm_genpd_poweron(genpd);
 428	if (ret)
 429		return ret;
 
 
 430
 431	mutex_lock(&genpd->lock);
 
 
 
 
 
 432	genpd->status = GPD_STATE_BUSY;
 433	genpd->resume_count++;
 434	for (;;) {
 435		prepare_to_wait(&genpd->status_wait_queue, &wait,
 436				TASK_UNINTERRUPTIBLE);
 437		/*
 438		 * If current is the powering off task, we have been called
 439		 * reentrantly from one of the device callbacks, so we should
 440		 * not wait.
 441		 */
 442		if (!genpd->poweroff_task || genpd->poweroff_task == current)
 443			break;
 444		mutex_unlock(&genpd->lock);
 445
 446		schedule();
 447
 448		mutex_lock(&genpd->lock);
 449	}
 450	finish_wait(&genpd->status_wait_queue, &wait);
 451	__pm_genpd_runtime_resume(dev, genpd);
 452	genpd->resume_count--;
 453	genpd_set_active(genpd);
 454	wake_up_all(&genpd->status_wait_queue);
 455	mutex_unlock(&genpd->lock);
 456
 457	if (genpd->start_device)
 458		genpd->start_device(dev);
 459
 460	return 0;
 
 
 
 
 461}
 
 462
 463/**
 464 * pm_genpd_poweroff_unused - Power off all PM domains with no devices in use.
 465 */
 466void pm_genpd_poweroff_unused(void)
 467{
 468	struct generic_pm_domain *genpd;
 469
 
 
 
 
 
 470	mutex_lock(&gpd_list_lock);
 471
 472	list_for_each_entry(genpd, &gpd_list, gpd_list_node)
 473		genpd_queue_power_off_work(genpd);
 474
 475	mutex_unlock(&gpd_list_lock);
 476}
 477
 478#else
 479
 
 
 
 
 
 
 480static inline void genpd_power_off_work_fn(struct work_struct *work) {}
 481static inline void __pm_genpd_runtime_resume(struct device *dev,
 482					     struct generic_pm_domain *genpd) {}
 483
 484#define pm_genpd_runtime_suspend	NULL
 485#define pm_genpd_runtime_resume		NULL
 486
 487#endif /* CONFIG_PM_RUNTIME */
 488
 489#ifdef CONFIG_PM_SLEEP
 490
 491/**
 492 * pm_genpd_sync_poweroff - Synchronously power off a PM domain and its parents.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 493 * @genpd: PM domain to power off, if possible.
 494 *
 495 * Check if the given PM domain can be powered off (during system suspend or
 496 * hibernation) and do that if so.  Also, in that case propagate to its parent.
 497 *
 498 * This function is only called in "noirq" stages of system power transitions,
 499 * so it need not acquire locks (all of the "noirq" callbacks are executed
 500 * sequentially, so it is guaranteed that it will never run twice in parallel).
 
 501 */
 502static void pm_genpd_sync_poweroff(struct generic_pm_domain *genpd)
 503{
 504	struct generic_pm_domain *parent = genpd->parent;
 505
 506	if (genpd->status == GPD_STATE_POWER_OFF)
 507		return;
 508
 509	if (genpd->suspended_count != genpd->device_count || genpd->sd_count > 0)
 
 510		return;
 511
 512	if (genpd->power_off)
 513		genpd->power_off(genpd);
 514
 515	genpd->status = GPD_STATE_POWER_OFF;
 516	if (parent) {
 517		genpd_sd_counter_dec(parent);
 518		pm_genpd_sync_poweroff(parent);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 519	}
 
 
 
 
 
 520}
 521
 522/**
 523 * resume_needed - Check whether to resume a device before system suspend.
 524 * @dev: Device to check.
 525 * @genpd: PM domain the device belongs to.
 526 *
 527 * There are two cases in which a device that can wake up the system from sleep
 528 * states should be resumed by pm_genpd_prepare(): (1) if the device is enabled
 529 * to wake up the system and it has to remain active for this purpose while the
 530 * system is in the sleep state and (2) if the device is not enabled to wake up
 531 * the system from sleep states and it generally doesn't generate wakeup signals
 532 * by itself (those signals are generated on its behalf by other parts of the
 533 * system).  In the latter case it may be necessary to reconfigure the device's
 534 * wakeup settings during system suspend, because it may have been set up to
 535 * signal remote wakeup from the system's working state as needed by runtime PM.
 536 * Return 'true' in either of the above cases.
 537 */
 538static bool resume_needed(struct device *dev, struct generic_pm_domain *genpd)
 539{
 540	bool active_wakeup;
 541
 542	if (!device_can_wakeup(dev))
 543		return false;
 544
 545	active_wakeup = genpd->active_wakeup && genpd->active_wakeup(dev);
 546	return device_may_wakeup(dev) ? active_wakeup : !active_wakeup;
 547}
 548
 549/**
 550 * pm_genpd_prepare - Start power transition of a device in a PM domain.
 551 * @dev: Device to start the transition of.
 552 *
 553 * Start a power transition of a device (during a system-wide power transition)
 554 * under the assumption that its pm_domain field points to the domain member of
 555 * an object of type struct generic_pm_domain representing a PM domain
 556 * consisting of I/O devices.
 557 */
 558static int pm_genpd_prepare(struct device *dev)
 559{
 560	struct generic_pm_domain *genpd;
 561	int ret;
 562
 563	dev_dbg(dev, "%s()\n", __func__);
 564
 565	genpd = dev_to_genpd(dev);
 566	if (IS_ERR(genpd))
 567		return -EINVAL;
 568
 569	/*
 570	 * If a wakeup request is pending for the device, it should be woken up
 571	 * at this point and a system wakeup event should be reported if it's
 572	 * set up to wake up the system from sleep states.
 573	 */
 574	pm_runtime_get_noresume(dev);
 575	if (pm_runtime_barrier(dev) && device_may_wakeup(dev))
 576		pm_wakeup_event(dev, 0);
 577
 578	if (pm_wakeup_pending()) {
 579		pm_runtime_put_sync(dev);
 580		return -EBUSY;
 581	}
 582
 583	if (resume_needed(dev, genpd))
 584		pm_runtime_resume(dev);
 585
 586	genpd_acquire_lock(genpd);
 587
 588	if (genpd->prepared_count++ == 0)
 
 589		genpd->suspend_power_off = genpd->status == GPD_STATE_POWER_OFF;
 
 590
 591	genpd_release_lock(genpd);
 592
 593	if (genpd->suspend_power_off) {
 594		pm_runtime_put_noidle(dev);
 595		return 0;
 596	}
 597
 598	/*
 599	 * The PM domain must be in the GPD_STATE_ACTIVE state at this point,
 600	 * so pm_genpd_poweron() will return immediately, but if the device
 601	 * is suspended (e.g. it's been stopped by .stop_device()), we need
 602	 * to make it operational.
 603	 */
 604	pm_runtime_resume(dev);
 605	__pm_runtime_disable(dev, false);
 606
 607	ret = pm_generic_prepare(dev);
 608	if (ret) {
 609		mutex_lock(&genpd->lock);
 610
 611		if (--genpd->prepared_count == 0)
 612			genpd->suspend_power_off = false;
 613
 614		mutex_unlock(&genpd->lock);
 615		pm_runtime_enable(dev);
 616	}
 617
 618	pm_runtime_put_sync(dev);
 619	return ret;
 620}
 621
 622/**
 623 * pm_genpd_suspend - Suspend a device belonging to an I/O PM domain.
 624 * @dev: Device to suspend.
 625 *
 626 * Suspend a device under the assumption that its pm_domain field points to the
 627 * domain member of an object of type struct generic_pm_domain representing
 628 * a PM domain consisting of I/O devices.
 629 */
 630static int pm_genpd_suspend(struct device *dev)
 631{
 632	struct generic_pm_domain *genpd;
 633
 634	dev_dbg(dev, "%s()\n", __func__);
 635
 636	genpd = dev_to_genpd(dev);
 637	if (IS_ERR(genpd))
 638		return -EINVAL;
 639
 640	return genpd->suspend_power_off ? 0 : pm_generic_suspend(dev);
 641}
 642
 643/**
 644 * pm_genpd_suspend_noirq - Late suspend of a device from an I/O PM domain.
 645 * @dev: Device to suspend.
 646 *
 647 * Carry out a late suspend of a device under the assumption that its
 648 * pm_domain field points to the domain member of an object of type
 649 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 650 */
 651static int pm_genpd_suspend_noirq(struct device *dev)
 652{
 653	struct generic_pm_domain *genpd;
 654	int ret;
 655
 656	dev_dbg(dev, "%s()\n", __func__);
 657
 658	genpd = dev_to_genpd(dev);
 659	if (IS_ERR(genpd))
 660		return -EINVAL;
 661
 662	if (genpd->suspend_power_off)
 663		return 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 664
 665	ret = pm_generic_suspend_noirq(dev);
 666	if (ret)
 667		return ret;
 668
 669	if (device_may_wakeup(dev)
 670	    && genpd->active_wakeup && genpd->active_wakeup(dev))
 671		return 0;
 672
 673	if (genpd->stop_device)
 674		genpd->stop_device(dev);
 675
 676	/*
 677	 * Since all of the "noirq" callbacks are executed sequentially, it is
 678	 * guaranteed that this function will never run twice in parallel for
 679	 * the same PM domain, so it is not necessary to use locking here.
 680	 */
 681	genpd->suspended_count++;
 682	pm_genpd_sync_poweroff(genpd);
 683
 684	return 0;
 685}
 686
 687/**
 688 * pm_genpd_resume_noirq - Early resume of a device from an I/O power domain.
 689 * @dev: Device to resume.
 690 *
 691 * Carry out an early resume of a device under the assumption that its
 692 * pm_domain field points to the domain member of an object of type
 693 * struct generic_pm_domain representing a power domain consisting of I/O
 694 * devices.
 695 */
 696static int pm_genpd_resume_noirq(struct device *dev)
 697{
 698	struct generic_pm_domain *genpd;
 699
 700	dev_dbg(dev, "%s()\n", __func__);
 701
 702	genpd = dev_to_genpd(dev);
 703	if (IS_ERR(genpd))
 704		return -EINVAL;
 705
 706	if (genpd->suspend_power_off)
 
 707		return 0;
 708
 709	/*
 710	 * Since all of the "noirq" callbacks are executed sequentially, it is
 711	 * guaranteed that this function will never run twice in parallel for
 712	 * the same PM domain, so it is not necessary to use locking here.
 713	 */
 714	pm_genpd_poweron(genpd);
 715	genpd->suspended_count--;
 716	if (genpd->start_device)
 717		genpd->start_device(dev);
 718
 719	return pm_generic_resume_noirq(dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 720}
 721
 722/**
 723 * pm_genpd_resume - Resume a device belonging to an I/O power domain.
 724 * @dev: Device to resume.
 725 *
 726 * Resume a device under the assumption that its pm_domain field points to the
 727 * domain member of an object of type struct generic_pm_domain representing
 728 * a power domain consisting of I/O devices.
 729 */
 730static int pm_genpd_resume(struct device *dev)
 731{
 732	struct generic_pm_domain *genpd;
 733
 734	dev_dbg(dev, "%s()\n", __func__);
 735
 736	genpd = dev_to_genpd(dev);
 737	if (IS_ERR(genpd))
 738		return -EINVAL;
 739
 740	return genpd->suspend_power_off ? 0 : pm_generic_resume(dev);
 741}
 742
 743/**
 744 * pm_genpd_freeze - Freeze a device belonging to an I/O power domain.
 745 * @dev: Device to freeze.
 746 *
 747 * Freeze a device under the assumption that its pm_domain field points to the
 748 * domain member of an object of type struct generic_pm_domain representing
 749 * a power domain consisting of I/O devices.
 750 */
 751static int pm_genpd_freeze(struct device *dev)
 752{
 753	struct generic_pm_domain *genpd;
 754
 755	dev_dbg(dev, "%s()\n", __func__);
 756
 757	genpd = dev_to_genpd(dev);
 758	if (IS_ERR(genpd))
 759		return -EINVAL;
 760
 761	return genpd->suspend_power_off ? 0 : pm_generic_freeze(dev);
 762}
 763
 764/**
 765 * pm_genpd_freeze_noirq - Late freeze of a device from an I/O power domain.
 766 * @dev: Device to freeze.
 767 *
 768 * Carry out a late freeze of a device under the assumption that its
 769 * pm_domain field points to the domain member of an object of type
 770 * struct generic_pm_domain representing a power domain consisting of I/O
 771 * devices.
 772 */
 773static int pm_genpd_freeze_noirq(struct device *dev)
 774{
 775	struct generic_pm_domain *genpd;
 776	int ret;
 777
 778	dev_dbg(dev, "%s()\n", __func__);
 779
 780	genpd = dev_to_genpd(dev);
 781	if (IS_ERR(genpd))
 782		return -EINVAL;
 783
 784	if (genpd->suspend_power_off)
 785		return 0;
 786
 787	ret = pm_generic_freeze_noirq(dev);
 788	if (ret)
 789		return ret;
 790
 791	if (genpd->stop_device)
 792		genpd->stop_device(dev);
 793
 794	return 0;
 795}
 796
 797/**
 798 * pm_genpd_thaw_noirq - Early thaw of a device from an I/O power domain.
 799 * @dev: Device to thaw.
 800 *
 801 * Carry out an early thaw of a device under the assumption that its
 802 * pm_domain field points to the domain member of an object of type
 803 * struct generic_pm_domain representing a power domain consisting of I/O
 804 * devices.
 805 */
 806static int pm_genpd_thaw_noirq(struct device *dev)
 807{
 808	struct generic_pm_domain *genpd;
 809
 810	dev_dbg(dev, "%s()\n", __func__);
 811
 812	genpd = dev_to_genpd(dev);
 813	if (IS_ERR(genpd))
 814		return -EINVAL;
 815
 816	if (genpd->suspend_power_off)
 817		return 0;
 818
 819	if (genpd->start_device)
 820		genpd->start_device(dev);
 821
 822	return pm_generic_thaw_noirq(dev);
 823}
 824
 825/**
 826 * pm_genpd_thaw - Thaw a device belonging to an I/O power domain.
 827 * @dev: Device to thaw.
 828 *
 829 * Thaw a device under the assumption that its pm_domain field points to the
 830 * domain member of an object of type struct generic_pm_domain representing
 831 * a power domain consisting of I/O devices.
 832 */
 833static int pm_genpd_thaw(struct device *dev)
 834{
 835	struct generic_pm_domain *genpd;
 836
 837	dev_dbg(dev, "%s()\n", __func__);
 838
 839	genpd = dev_to_genpd(dev);
 840	if (IS_ERR(genpd))
 841		return -EINVAL;
 842
 843	return genpd->suspend_power_off ? 0 : pm_generic_thaw(dev);
 844}
 845
 846/**
 847 * pm_genpd_dev_poweroff - Power off a device belonging to an I/O PM domain.
 848 * @dev: Device to suspend.
 849 *
 850 * Power off a device under the assumption that its pm_domain field points to
 851 * the domain member of an object of type struct generic_pm_domain representing
 852 * a PM domain consisting of I/O devices.
 
 853 */
 854static int pm_genpd_dev_poweroff(struct device *dev)
 855{
 856	struct generic_pm_domain *genpd;
 857
 858	dev_dbg(dev, "%s()\n", __func__);
 859
 860	genpd = dev_to_genpd(dev);
 861	if (IS_ERR(genpd))
 862		return -EINVAL;
 863
 864	return genpd->suspend_power_off ? 0 : pm_generic_poweroff(dev);
 865}
 866
 867/**
 868 * pm_genpd_dev_poweroff_noirq - Late power off of a device from a PM domain.
 869 * @dev: Device to suspend.
 870 *
 871 * Carry out a late powering off of a device under the assumption that its
 872 * pm_domain field points to the domain member of an object of type
 873 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
 874 */
 875static int pm_genpd_dev_poweroff_noirq(struct device *dev)
 876{
 877	struct generic_pm_domain *genpd;
 878	int ret;
 879
 880	dev_dbg(dev, "%s()\n", __func__);
 881
 882	genpd = dev_to_genpd(dev);
 883	if (IS_ERR(genpd))
 884		return -EINVAL;
 885
 886	if (genpd->suspend_power_off)
 887		return 0;
 888
 889	ret = pm_generic_poweroff_noirq(dev);
 890	if (ret)
 891		return ret;
 892
 893	if (device_may_wakeup(dev)
 894	    && genpd->active_wakeup && genpd->active_wakeup(dev))
 895		return 0;
 896
 897	if (genpd->stop_device)
 898		genpd->stop_device(dev);
 899
 900	/*
 901	 * Since all of the "noirq" callbacks are executed sequentially, it is
 902	 * guaranteed that this function will never run twice in parallel for
 903	 * the same PM domain, so it is not necessary to use locking here.
 904	 */
 905	genpd->suspended_count++;
 906	pm_genpd_sync_poweroff(genpd);
 907
 908	return 0;
 909}
 910
 911/**
 912 * pm_genpd_restore_noirq - Early restore of a device from an I/O power domain.
 913 * @dev: Device to resume.
 914 *
 915 * Carry out an early restore of a device under the assumption that its
 916 * pm_domain field points to the domain member of an object of type
 917 * struct generic_pm_domain representing a power domain consisting of I/O
 918 * devices.
 919 */
 920static int pm_genpd_restore_noirq(struct device *dev)
 921{
 922	struct generic_pm_domain *genpd;
 923
 924	dev_dbg(dev, "%s()\n", __func__);
 925
 926	genpd = dev_to_genpd(dev);
 927	if (IS_ERR(genpd))
 928		return -EINVAL;
 929
 930	/*
 931	 * Since all of the "noirq" callbacks are executed sequentially, it is
 932	 * guaranteed that this function will never run twice in parallel for
 933	 * the same PM domain, so it is not necessary to use locking here.
 
 
 
 934	 */
 935	genpd->status = GPD_STATE_POWER_OFF;
 936	if (genpd->suspend_power_off) {
 937		/*
 938		 * The boot kernel might put the domain into the power on state,
 939		 * so make sure it really is powered off.
 
 940		 */
 941		if (genpd->power_off)
 942			genpd->power_off(genpd);
 943		return 0;
 
 
 
 
 
 
 
 
 944	}
 945
 946	pm_genpd_poweron(genpd);
 947	genpd->suspended_count--;
 948	if (genpd->start_device)
 949		genpd->start_device(dev);
 950
 951	return pm_generic_restore_noirq(dev);
 952}
 953
 954/**
 955 * pm_genpd_restore - Restore a device belonging to an I/O power domain.
 956 * @dev: Device to resume.
 957 *
 958 * Restore a device under the assumption that its pm_domain field points to the
 959 * domain member of an object of type struct generic_pm_domain representing
 960 * a power domain consisting of I/O devices.
 961 */
 962static int pm_genpd_restore(struct device *dev)
 963{
 964	struct generic_pm_domain *genpd;
 965
 966	dev_dbg(dev, "%s()\n", __func__);
 967
 968	genpd = dev_to_genpd(dev);
 969	if (IS_ERR(genpd))
 970		return -EINVAL;
 971
 972	return genpd->suspend_power_off ? 0 : pm_generic_restore(dev);
 973}
 974
 975/**
 976 * pm_genpd_complete - Complete power transition of a device in a power domain.
 977 * @dev: Device to complete the transition of.
 978 *
 979 * Complete a power transition of a device (during a system-wide power
 980 * transition) under the assumption that its pm_domain field points to the
 981 * domain member of an object of type struct generic_pm_domain representing
 982 * a power domain consisting of I/O devices.
 983 */
 984static void pm_genpd_complete(struct device *dev)
 985{
 986	struct generic_pm_domain *genpd;
 987	bool run_complete;
 988
 989	dev_dbg(dev, "%s()\n", __func__);
 990
 991	genpd = dev_to_genpd(dev);
 992	if (IS_ERR(genpd))
 993		return;
 994
 995	mutex_lock(&genpd->lock);
 996
 997	run_complete = !genpd->suspend_power_off;
 998	if (--genpd->prepared_count == 0)
 999		genpd->suspend_power_off = false;
1000
1001	mutex_unlock(&genpd->lock);
1002
1003	if (run_complete) {
1004		pm_generic_complete(dev);
1005		pm_runtime_set_active(dev);
1006		pm_runtime_enable(dev);
1007		pm_runtime_idle(dev);
1008	}
1009}
1010
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1011#else
1012
1013#define pm_genpd_prepare		NULL
1014#define pm_genpd_suspend		NULL
 
1015#define pm_genpd_suspend_noirq		NULL
 
1016#define pm_genpd_resume_noirq		NULL
1017#define pm_genpd_resume			NULL
1018#define pm_genpd_freeze			NULL
 
1019#define pm_genpd_freeze_noirq		NULL
 
1020#define pm_genpd_thaw_noirq		NULL
1021#define pm_genpd_thaw			NULL
1022#define pm_genpd_dev_poweroff_noirq	NULL
1023#define pm_genpd_dev_poweroff		NULL
1024#define pm_genpd_restore_noirq		NULL
1025#define pm_genpd_restore		NULL
1026#define pm_genpd_complete		NULL
1027
1028#endif /* CONFIG_PM_SLEEP */
1029
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1030/**
1031 * pm_genpd_add_device - Add a device to an I/O PM domain.
1032 * @genpd: PM domain to add the device to.
1033 * @dev: Device to be added.
 
1034 */
1035int pm_genpd_add_device(struct generic_pm_domain *genpd, struct device *dev)
 
1036{
1037	struct dev_list_entry *dle;
 
1038	int ret = 0;
1039
1040	dev_dbg(dev, "%s()\n", __func__);
1041
1042	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
1043		return -EINVAL;
1044
 
 
 
 
1045	genpd_acquire_lock(genpd);
1046
1047	if (genpd->status == GPD_STATE_POWER_OFF) {
1048		ret = -EINVAL;
1049		goto out;
1050	}
1051
1052	if (genpd->prepared_count > 0) {
1053		ret = -EAGAIN;
1054		goto out;
1055	}
1056
1057	list_for_each_entry(dle, &genpd->dev_list, node)
1058		if (dle->dev == dev) {
1059			ret = -EINVAL;
1060			goto out;
1061		}
1062
1063	dle = kzalloc(sizeof(*dle), GFP_KERNEL);
1064	if (!dle) {
1065		ret = -ENOMEM;
1066		goto out;
1067	}
1068
1069	dle->dev = dev;
1070	dle->need_restore = false;
1071	list_add_tail(&dle->node, &genpd->dev_list);
1072	genpd->device_count++;
 
1073
1074	spin_lock_irq(&dev->power.lock);
 
1075	dev->pm_domain = &genpd->domain;
 
 
 
 
 
 
 
 
 
 
1076	spin_unlock_irq(&dev->power.lock);
1077
 
 
 
 
 
 
 
 
1078 out:
1079	genpd_release_lock(genpd);
1080
 
 
 
1081	return ret;
1082}
1083
1084/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1085 * pm_genpd_remove_device - Remove a device from an I/O PM domain.
1086 * @genpd: PM domain to remove the device from.
1087 * @dev: Device to be removed.
1088 */
1089int pm_genpd_remove_device(struct generic_pm_domain *genpd,
1090			   struct device *dev)
1091{
1092	struct dev_list_entry *dle;
1093	int ret = -EINVAL;
 
 
1094
1095	dev_dbg(dev, "%s()\n", __func__);
1096
1097	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(dev))
 
 
1098		return -EINVAL;
1099
1100	genpd_acquire_lock(genpd);
1101
1102	if (genpd->prepared_count > 0) {
1103		ret = -EAGAIN;
1104		goto out;
1105	}
1106
1107	list_for_each_entry(dle, &genpd->dev_list, node) {
1108		if (dle->dev != dev)
1109			continue;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1110
1111		spin_lock_irq(&dev->power.lock);
1112		dev->pm_domain = NULL;
1113		spin_unlock_irq(&dev->power.lock);
1114
1115		genpd->device_count--;
1116		list_del(&dle->node);
1117		kfree(dle);
1118
1119		ret = 0;
1120		break;
1121	}
1122
1123 out:
1124	genpd_release_lock(genpd);
1125
1126	return ret;
1127}
1128
1129/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1130 * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
1131 * @genpd: Master PM domain to add the subdomain to.
1132 * @new_subdomain: Subdomain to be added.
1133 */
1134int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
1135			   struct generic_pm_domain *new_subdomain)
1136{
1137	struct generic_pm_domain *subdomain;
1138	int ret = 0;
1139
1140	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(new_subdomain))
 
1141		return -EINVAL;
1142
1143 start:
1144	genpd_acquire_lock(genpd);
1145	mutex_lock_nested(&new_subdomain->lock, SINGLE_DEPTH_NESTING);
1146
1147	if (new_subdomain->status != GPD_STATE_POWER_OFF
1148	    && new_subdomain->status != GPD_STATE_ACTIVE) {
1149		mutex_unlock(&new_subdomain->lock);
1150		genpd_release_lock(genpd);
1151		goto start;
1152	}
1153
1154	if (genpd->status == GPD_STATE_POWER_OFF
1155	    &&  new_subdomain->status != GPD_STATE_POWER_OFF) {
1156		ret = -EINVAL;
1157		goto out;
1158	}
1159
1160	list_for_each_entry(subdomain, &genpd->sd_list, sd_node) {
1161		if (subdomain == new_subdomain) {
1162			ret = -EINVAL;
1163			goto out;
1164		}
1165	}
1166
1167	list_add_tail(&new_subdomain->sd_node, &genpd->sd_list);
1168	new_subdomain->parent = genpd;
 
 
 
 
 
 
 
1169	if (subdomain->status != GPD_STATE_POWER_OFF)
1170		genpd->sd_count++;
1171
1172 out:
1173	mutex_unlock(&new_subdomain->lock);
1174	genpd_release_lock(genpd);
1175
1176	return ret;
1177}
1178
1179/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1180 * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
1181 * @genpd: Master PM domain to remove the subdomain from.
1182 * @target: Subdomain to be removed.
1183 */
1184int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
1185			      struct generic_pm_domain *target)
1186{
1187	struct generic_pm_domain *subdomain;
1188	int ret = -EINVAL;
1189
1190	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(target))
1191		return -EINVAL;
1192
1193 start:
1194	genpd_acquire_lock(genpd);
1195
1196	list_for_each_entry(subdomain, &genpd->sd_list, sd_node) {
1197		if (subdomain != target)
1198			continue;
1199
1200		mutex_lock_nested(&subdomain->lock, SINGLE_DEPTH_NESTING);
1201
1202		if (subdomain->status != GPD_STATE_POWER_OFF
1203		    && subdomain->status != GPD_STATE_ACTIVE) {
1204			mutex_unlock(&subdomain->lock);
1205			genpd_release_lock(genpd);
1206			goto start;
1207		}
1208
1209		list_del(&subdomain->sd_node);
1210		subdomain->parent = NULL;
 
1211		if (subdomain->status != GPD_STATE_POWER_OFF)
1212			genpd_sd_counter_dec(genpd);
1213
1214		mutex_unlock(&subdomain->lock);
1215
1216		ret = 0;
1217		break;
1218	}
1219
1220	genpd_release_lock(genpd);
1221
1222	return ret;
1223}
1224
1225/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1226 * pm_genpd_init - Initialize a generic I/O PM domain object.
1227 * @genpd: PM domain object to initialize.
1228 * @gov: PM domain governor to associate with the domain (may be NULL).
1229 * @is_off: Initial value of the domain's power_is_off field.
1230 */
1231void pm_genpd_init(struct generic_pm_domain *genpd,
1232		   struct dev_power_governor *gov, bool is_off)
1233{
1234	if (IS_ERR_OR_NULL(genpd))
1235		return;
1236
1237	INIT_LIST_HEAD(&genpd->sd_node);
1238	genpd->parent = NULL;
1239	INIT_LIST_HEAD(&genpd->dev_list);
1240	INIT_LIST_HEAD(&genpd->sd_list);
1241	mutex_init(&genpd->lock);
1242	genpd->gov = gov;
1243	INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn);
1244	genpd->in_progress = 0;
1245	genpd->sd_count = 0;
1246	genpd->status = is_off ? GPD_STATE_POWER_OFF : GPD_STATE_ACTIVE;
1247	init_waitqueue_head(&genpd->status_wait_queue);
1248	genpd->poweroff_task = NULL;
1249	genpd->resume_count = 0;
1250	genpd->device_count = 0;
1251	genpd->suspended_count = 0;
 
1252	genpd->domain.ops.runtime_suspend = pm_genpd_runtime_suspend;
1253	genpd->domain.ops.runtime_resume = pm_genpd_runtime_resume;
1254	genpd->domain.ops.runtime_idle = pm_generic_runtime_idle;
1255	genpd->domain.ops.prepare = pm_genpd_prepare;
1256	genpd->domain.ops.suspend = pm_genpd_suspend;
 
1257	genpd->domain.ops.suspend_noirq = pm_genpd_suspend_noirq;
1258	genpd->domain.ops.resume_noirq = pm_genpd_resume_noirq;
 
1259	genpd->domain.ops.resume = pm_genpd_resume;
1260	genpd->domain.ops.freeze = pm_genpd_freeze;
 
1261	genpd->domain.ops.freeze_noirq = pm_genpd_freeze_noirq;
1262	genpd->domain.ops.thaw_noirq = pm_genpd_thaw_noirq;
 
1263	genpd->domain.ops.thaw = pm_genpd_thaw;
1264	genpd->domain.ops.poweroff = pm_genpd_dev_poweroff;
1265	genpd->domain.ops.poweroff_noirq = pm_genpd_dev_poweroff_noirq;
 
1266	genpd->domain.ops.restore_noirq = pm_genpd_restore_noirq;
1267	genpd->domain.ops.restore = pm_genpd_restore;
 
1268	genpd->domain.ops.complete = pm_genpd_complete;
 
 
 
 
 
 
 
 
 
 
1269	mutex_lock(&gpd_list_lock);
1270	list_add(&genpd->gpd_list_node, &gpd_list);
1271	mutex_unlock(&gpd_list_lock);
1272}