xref: /linux/drivers/pmdomain/core.c (revision 7a5f93ea5862da91488975acaa0c7abd508f192b)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * drivers/base/power/domain.c - Common code related to device power domains.
4  *
5  * Copyright (C) 2011 Rafael J. Wysocki <rjw@sisk.pl>, Renesas Electronics Corp.
6  */
7 #define pr_fmt(fmt) "PM: " fmt
8 
9 #include <linux/delay.h>
10 #include <linux/idr.h>
11 #include <linux/kernel.h>
12 #include <linux/io.h>
13 #include <linux/platform_device.h>
14 #include <linux/pm_opp.h>
15 #include <linux/pm_runtime.h>
16 #include <linux/pm_domain.h>
17 #include <linux/pm_qos.h>
18 #include <linux/pm_clock.h>
19 #include <linux/slab.h>
20 #include <linux/err.h>
21 #include <linux/sched.h>
22 #include <linux/suspend.h>
23 #include <linux/export.h>
24 #include <linux/cpu.h>
25 #include <linux/debugfs.h>
26 
27 /* Provides a unique ID for each genpd device */
28 static DEFINE_IDA(genpd_ida);
29 
30 #define GENPD_RETRY_MAX_MS	250		/* Approximate */
31 
32 #define GENPD_DEV_CALLBACK(genpd, type, callback, dev)		\
33 ({								\
34 	type (*__routine)(struct device *__d); 			\
35 	type __ret = (type)0;					\
36 								\
37 	__routine = genpd->dev_ops.callback; 			\
38 	if (__routine) {					\
39 		__ret = __routine(dev); 			\
40 	}							\
41 	__ret;							\
42 })
43 
44 static LIST_HEAD(gpd_list);
45 static DEFINE_MUTEX(gpd_list_lock);
46 
47 struct genpd_lock_ops {
48 	void (*lock)(struct generic_pm_domain *genpd);
49 	void (*lock_nested)(struct generic_pm_domain *genpd, int depth);
50 	int (*lock_interruptible)(struct generic_pm_domain *genpd);
51 	void (*unlock)(struct generic_pm_domain *genpd);
52 };
53 
54 static void genpd_lock_mtx(struct generic_pm_domain *genpd)
55 {
56 	mutex_lock(&genpd->mlock);
57 }
58 
59 static void genpd_lock_nested_mtx(struct generic_pm_domain *genpd,
60 					int depth)
61 {
62 	mutex_lock_nested(&genpd->mlock, depth);
63 }
64 
65 static int genpd_lock_interruptible_mtx(struct generic_pm_domain *genpd)
66 {
67 	return mutex_lock_interruptible(&genpd->mlock);
68 }
69 
70 static void genpd_unlock_mtx(struct generic_pm_domain *genpd)
71 {
72 	return mutex_unlock(&genpd->mlock);
73 }
74 
75 static const struct genpd_lock_ops genpd_mtx_ops = {
76 	.lock = genpd_lock_mtx,
77 	.lock_nested = genpd_lock_nested_mtx,
78 	.lock_interruptible = genpd_lock_interruptible_mtx,
79 	.unlock = genpd_unlock_mtx,
80 };
81 
82 static void genpd_lock_spin(struct generic_pm_domain *genpd)
83 	__acquires(&genpd->slock)
84 {
85 	unsigned long flags;
86 
87 	spin_lock_irqsave(&genpd->slock, flags);
88 	genpd->lock_flags = flags;
89 }
90 
91 static void genpd_lock_nested_spin(struct generic_pm_domain *genpd,
92 					int depth)
93 	__acquires(&genpd->slock)
94 {
95 	unsigned long flags;
96 
97 	spin_lock_irqsave_nested(&genpd->slock, flags, depth);
98 	genpd->lock_flags = flags;
99 }
100 
101 static int genpd_lock_interruptible_spin(struct generic_pm_domain *genpd)
102 	__acquires(&genpd->slock)
103 {
104 	unsigned long flags;
105 
106 	spin_lock_irqsave(&genpd->slock, flags);
107 	genpd->lock_flags = flags;
108 	return 0;
109 }
110 
111 static void genpd_unlock_spin(struct generic_pm_domain *genpd)
112 	__releases(&genpd->slock)
113 {
114 	spin_unlock_irqrestore(&genpd->slock, genpd->lock_flags);
115 }
116 
117 static const struct genpd_lock_ops genpd_spin_ops = {
118 	.lock = genpd_lock_spin,
119 	.lock_nested = genpd_lock_nested_spin,
120 	.lock_interruptible = genpd_lock_interruptible_spin,
121 	.unlock = genpd_unlock_spin,
122 };
123 
124 static void genpd_lock_raw_spin(struct generic_pm_domain *genpd)
125 	__acquires(&genpd->raw_slock)
126 {
127 	unsigned long flags;
128 
129 	raw_spin_lock_irqsave(&genpd->raw_slock, flags);
130 	genpd->raw_lock_flags = flags;
131 }
132 
133 static void genpd_lock_nested_raw_spin(struct generic_pm_domain *genpd,
134 					int depth)
135 	__acquires(&genpd->raw_slock)
136 {
137 	unsigned long flags;
138 
139 	raw_spin_lock_irqsave_nested(&genpd->raw_slock, flags, depth);
140 	genpd->raw_lock_flags = flags;
141 }
142 
143 static int genpd_lock_interruptible_raw_spin(struct generic_pm_domain *genpd)
144 	__acquires(&genpd->raw_slock)
145 {
146 	unsigned long flags;
147 
148 	raw_spin_lock_irqsave(&genpd->raw_slock, flags);
149 	genpd->raw_lock_flags = flags;
150 	return 0;
151 }
152 
153 static void genpd_unlock_raw_spin(struct generic_pm_domain *genpd)
154 	__releases(&genpd->raw_slock)
155 {
156 	raw_spin_unlock_irqrestore(&genpd->raw_slock, genpd->raw_lock_flags);
157 }
158 
159 static const struct genpd_lock_ops genpd_raw_spin_ops = {
160 	.lock = genpd_lock_raw_spin,
161 	.lock_nested = genpd_lock_nested_raw_spin,
162 	.lock_interruptible = genpd_lock_interruptible_raw_spin,
163 	.unlock = genpd_unlock_raw_spin,
164 };
165 
166 #define genpd_lock(p)			p->lock_ops->lock(p)
167 #define genpd_lock_nested(p, d)		p->lock_ops->lock_nested(p, d)
168 #define genpd_lock_interruptible(p)	p->lock_ops->lock_interruptible(p)
169 #define genpd_unlock(p)			p->lock_ops->unlock(p)
170 
171 #define genpd_status_on(genpd)		(genpd->status == GENPD_STATE_ON)
172 #define genpd_is_irq_safe(genpd)	(genpd->flags & GENPD_FLAG_IRQ_SAFE)
173 #define genpd_is_always_on(genpd)	(genpd->flags & GENPD_FLAG_ALWAYS_ON)
174 #define genpd_is_active_wakeup(genpd)	(genpd->flags & GENPD_FLAG_ACTIVE_WAKEUP)
175 #define genpd_is_cpu_domain(genpd)	(genpd->flags & GENPD_FLAG_CPU_DOMAIN)
176 #define genpd_is_rpm_always_on(genpd)	(genpd->flags & GENPD_FLAG_RPM_ALWAYS_ON)
177 #define genpd_is_opp_table_fw(genpd)	(genpd->flags & GENPD_FLAG_OPP_TABLE_FW)
178 #define genpd_is_dev_name_fw(genpd)	(genpd->flags & GENPD_FLAG_DEV_NAME_FW)
179 
180 static inline bool irq_safe_dev_in_sleep_domain(struct device *dev,
181 		const struct generic_pm_domain *genpd)
182 {
183 	bool ret;
184 
185 	ret = pm_runtime_is_irq_safe(dev) && !genpd_is_irq_safe(genpd);
186 
187 	/*
188 	 * Warn once if an IRQ safe device is attached to a domain, which
189 	 * callbacks are allowed to sleep. This indicates a suboptimal
190 	 * configuration for PM, but it doesn't matter for an always on domain.
191 	 */
192 	if (genpd_is_always_on(genpd) || genpd_is_rpm_always_on(genpd))
193 		return ret;
194 
195 	if (ret)
196 		dev_warn_once(dev, "PM domain %s will not be powered off\n",
197 			      dev_name(&genpd->dev));
198 
199 	return ret;
200 }
201 
202 static int genpd_runtime_suspend(struct device *dev);
203 
204 /*
205  * Get the generic PM domain for a particular struct device.
206  * This validates the struct device pointer, the PM domain pointer,
207  * and checks that the PM domain pointer is a real generic PM domain.
208  * Any failure results in NULL being returned.
209  */
210 static struct generic_pm_domain *dev_to_genpd_safe(struct device *dev)
211 {
212 	if (IS_ERR_OR_NULL(dev) || IS_ERR_OR_NULL(dev->pm_domain))
213 		return NULL;
214 
215 	/* A genpd's always have its ->runtime_suspend() callback assigned. */
216 	if (dev->pm_domain->ops.runtime_suspend == genpd_runtime_suspend)
217 		return pd_to_genpd(dev->pm_domain);
218 
219 	return NULL;
220 }
221 
222 /*
223  * This should only be used where we are certain that the pm_domain
224  * attached to the device is a genpd domain.
225  */
226 static struct generic_pm_domain *dev_to_genpd(struct device *dev)
227 {
228 	if (IS_ERR_OR_NULL(dev->pm_domain))
229 		return ERR_PTR(-EINVAL);
230 
231 	return pd_to_genpd(dev->pm_domain);
232 }
233 
234 struct device *dev_to_genpd_dev(struct device *dev)
235 {
236 	struct generic_pm_domain *genpd = dev_to_genpd(dev);
237 
238 	if (IS_ERR(genpd))
239 		return ERR_CAST(genpd);
240 
241 	return &genpd->dev;
242 }
243 
244 static int genpd_stop_dev(const struct generic_pm_domain *genpd,
245 			  struct device *dev)
246 {
247 	return GENPD_DEV_CALLBACK(genpd, int, stop, dev);
248 }
249 
250 static int genpd_start_dev(const struct generic_pm_domain *genpd,
251 			   struct device *dev)
252 {
253 	return GENPD_DEV_CALLBACK(genpd, int, start, dev);
254 }
255 
256 static bool genpd_sd_counter_dec(struct generic_pm_domain *genpd)
257 {
258 	bool ret = false;
259 
260 	if (!WARN_ON(atomic_read(&genpd->sd_count) == 0))
261 		ret = !!atomic_dec_and_test(&genpd->sd_count);
262 
263 	return ret;
264 }
265 
266 static void genpd_sd_counter_inc(struct generic_pm_domain *genpd)
267 {
268 	atomic_inc(&genpd->sd_count);
269 	smp_mb__after_atomic();
270 }
271 
272 #ifdef CONFIG_DEBUG_FS
273 static struct dentry *genpd_debugfs_dir;
274 
275 static void genpd_debug_add(struct generic_pm_domain *genpd);
276 
277 static void genpd_debug_remove(struct generic_pm_domain *genpd)
278 {
279 	if (!genpd_debugfs_dir)
280 		return;
281 
282 	debugfs_lookup_and_remove(dev_name(&genpd->dev), genpd_debugfs_dir);
283 }
284 
285 static void genpd_update_accounting(struct generic_pm_domain *genpd)
286 {
287 	u64 delta, now;
288 
289 	now = ktime_get_mono_fast_ns();
290 	if (now <= genpd->accounting_time)
291 		return;
292 
293 	delta = now - genpd->accounting_time;
294 
295 	/*
296 	 * If genpd->status is active, it means we are just
297 	 * out of off and so update the idle time and vice
298 	 * versa.
299 	 */
300 	if (genpd->status == GENPD_STATE_ON)
301 		genpd->states[genpd->state_idx].idle_time += delta;
302 	else
303 		genpd->on_time += delta;
304 
305 	genpd->accounting_time = now;
306 }
307 #else
308 static inline void genpd_debug_add(struct generic_pm_domain *genpd) {}
309 static inline void genpd_debug_remove(struct generic_pm_domain *genpd) {}
310 static inline void genpd_update_accounting(struct generic_pm_domain *genpd) {}
311 #endif
312 
313 static int _genpd_reeval_performance_state(struct generic_pm_domain *genpd,
314 					   unsigned int state)
315 {
316 	struct generic_pm_domain_data *pd_data;
317 	struct pm_domain_data *pdd;
318 	struct gpd_link *link;
319 
320 	/* New requested state is same as Max requested state */
321 	if (state == genpd->performance_state)
322 		return state;
323 
324 	/* New requested state is higher than Max requested state */
325 	if (state > genpd->performance_state)
326 		return state;
327 
328 	/* Traverse all devices within the domain */
329 	list_for_each_entry(pdd, &genpd->dev_list, list_node) {
330 		pd_data = to_gpd_data(pdd);
331 
332 		if (pd_data->performance_state > state)
333 			state = pd_data->performance_state;
334 	}
335 
336 	/*
337 	 * Traverse all sub-domains within the domain. This can be
338 	 * done without any additional locking as the link->performance_state
339 	 * field is protected by the parent genpd->lock, which is already taken.
340 	 *
341 	 * Also note that link->performance_state (subdomain's performance state
342 	 * requirement to parent domain) is different from
343 	 * link->child->performance_state (current performance state requirement
344 	 * of the devices/sub-domains of the subdomain) and so can have a
345 	 * different value.
346 	 *
347 	 * Note that we also take vote from powered-off sub-domains into account
348 	 * as the same is done for devices right now.
349 	 */
350 	list_for_each_entry(link, &genpd->parent_links, parent_node) {
351 		if (link->performance_state > state)
352 			state = link->performance_state;
353 	}
354 
355 	return state;
356 }
357 
358 static int genpd_xlate_performance_state(struct generic_pm_domain *genpd,
359 					 struct generic_pm_domain *parent,
360 					 unsigned int pstate)
361 {
362 	if (!parent->set_performance_state)
363 		return pstate;
364 
365 	return dev_pm_opp_xlate_performance_state(genpd->opp_table,
366 						  parent->opp_table,
367 						  pstate);
368 }
369 
370 static int _genpd_set_performance_state(struct generic_pm_domain *genpd,
371 					unsigned int state, int depth);
372 
373 static void _genpd_rollback_parent_state(struct gpd_link *link, int depth)
374 {
375 	struct generic_pm_domain *parent = link->parent;
376 	int parent_state;
377 
378 	genpd_lock_nested(parent, depth + 1);
379 
380 	parent_state = link->prev_performance_state;
381 	link->performance_state = parent_state;
382 
383 	parent_state = _genpd_reeval_performance_state(parent, parent_state);
384 	if (_genpd_set_performance_state(parent, parent_state, depth + 1)) {
385 		pr_err("%s: Failed to roll back to %d performance state\n",
386 		       parent->name, parent_state);
387 	}
388 
389 	genpd_unlock(parent);
390 }
391 
392 static int _genpd_set_parent_state(struct generic_pm_domain *genpd,
393 				   struct gpd_link *link,
394 				   unsigned int state, int depth)
395 {
396 	struct generic_pm_domain *parent = link->parent;
397 	int parent_state, ret;
398 
399 	/* Find parent's performance state */
400 	ret = genpd_xlate_performance_state(genpd, parent, state);
401 	if (unlikely(ret < 0))
402 		return ret;
403 
404 	parent_state = ret;
405 
406 	genpd_lock_nested(parent, depth + 1);
407 
408 	link->prev_performance_state = link->performance_state;
409 	link->performance_state = parent_state;
410 
411 	parent_state = _genpd_reeval_performance_state(parent, parent_state);
412 	ret = _genpd_set_performance_state(parent, parent_state, depth + 1);
413 	if (ret)
414 		link->performance_state = link->prev_performance_state;
415 
416 	genpd_unlock(parent);
417 
418 	return ret;
419 }
420 
421 static int _genpd_set_performance_state(struct generic_pm_domain *genpd,
422 					unsigned int state, int depth)
423 {
424 	struct gpd_link *link = NULL;
425 	int ret;
426 
427 	if (state == genpd->performance_state)
428 		return 0;
429 
430 	/* When scaling up, propagate to parents first in normal order */
431 	if (state > genpd->performance_state) {
432 		list_for_each_entry(link, &genpd->child_links, child_node) {
433 			ret = _genpd_set_parent_state(genpd, link, state, depth);
434 			if (ret)
435 				goto rollback_parents_up;
436 		}
437 	}
438 
439 	if (genpd->set_performance_state) {
440 		ret = genpd->set_performance_state(genpd, state);
441 		if (ret) {
442 			if (link)
443 				goto rollback_parents_up;
444 			return ret;
445 		}
446 	}
447 
448 	/* When scaling down, propagate to parents last in reverse order */
449 	if (state < genpd->performance_state) {
450 		list_for_each_entry_reverse(link, &genpd->child_links, child_node) {
451 			ret = _genpd_set_parent_state(genpd, link, state, depth);
452 			if (ret)
453 				goto rollback_parents_down;
454 		}
455 	}
456 
457 	genpd->performance_state = state;
458 	return 0;
459 
460 rollback_parents_up:
461 	list_for_each_entry_continue_reverse(link, &genpd->child_links, child_node)
462 		_genpd_rollback_parent_state(link, depth);
463 	return ret;
464 rollback_parents_down:
465 	list_for_each_entry_continue(link, &genpd->child_links, child_node)
466 		_genpd_rollback_parent_state(link, depth);
467 	return ret;
468 }
469 
470 static int genpd_set_performance_state(struct device *dev, unsigned int state)
471 {
472 	struct generic_pm_domain *genpd = dev_to_genpd(dev);
473 	struct generic_pm_domain_data *gpd_data = dev_gpd_data(dev);
474 	unsigned int prev_state;
475 	int ret;
476 
477 	prev_state = gpd_data->performance_state;
478 	if (prev_state == state)
479 		return 0;
480 
481 	gpd_data->performance_state = state;
482 	state = _genpd_reeval_performance_state(genpd, state);
483 
484 	ret = _genpd_set_performance_state(genpd, state, 0);
485 	if (ret)
486 		gpd_data->performance_state = prev_state;
487 
488 	return ret;
489 }
490 
491 static int genpd_drop_performance_state(struct device *dev)
492 {
493 	unsigned int prev_state = dev_gpd_data(dev)->performance_state;
494 
495 	if (!genpd_set_performance_state(dev, 0))
496 		return prev_state;
497 
498 	return 0;
499 }
500 
501 static void genpd_restore_performance_state(struct device *dev,
502 					    unsigned int state)
503 {
504 	if (state)
505 		genpd_set_performance_state(dev, state);
506 }
507 
508 static int genpd_dev_pm_set_performance_state(struct device *dev,
509 					      unsigned int state)
510 {
511 	struct generic_pm_domain *genpd = dev_to_genpd(dev);
512 	int ret = 0;
513 
514 	genpd_lock(genpd);
515 	if (pm_runtime_suspended(dev)) {
516 		dev_gpd_data(dev)->rpm_pstate = state;
517 	} else {
518 		ret = genpd_set_performance_state(dev, state);
519 		if (!ret)
520 			dev_gpd_data(dev)->rpm_pstate = 0;
521 	}
522 	genpd_unlock(genpd);
523 
524 	return ret;
525 }
526 
527 /**
528  * dev_pm_genpd_set_performance_state- Set performance state of device's power
529  * domain.
530  *
531  * @dev: Device for which the performance-state needs to be set.
532  * @state: Target performance state of the device. This can be set as 0 when the
533  *	   device doesn't have any performance state constraints left (And so
534  *	   the device wouldn't participate anymore to find the target
535  *	   performance state of the genpd).
536  *
537  * It is assumed that the users guarantee that the genpd wouldn't be detached
538  * while this routine is getting called.
539  *
540  * Returns 0 on success and negative error values on failures.
541  */
542 int dev_pm_genpd_set_performance_state(struct device *dev, unsigned int state)
543 {
544 	struct generic_pm_domain *genpd;
545 
546 	genpd = dev_to_genpd_safe(dev);
547 	if (!genpd)
548 		return -ENODEV;
549 
550 	if (WARN_ON(!dev->power.subsys_data ||
551 		     !dev->power.subsys_data->domain_data))
552 		return -EINVAL;
553 
554 	return genpd_dev_pm_set_performance_state(dev, state);
555 }
556 EXPORT_SYMBOL_GPL(dev_pm_genpd_set_performance_state);
557 
558 /**
559  * dev_pm_genpd_set_next_wakeup - Notify PM framework of an impending wakeup.
560  *
561  * @dev: Device to handle
562  * @next: impending interrupt/wakeup for the device
563  *
564  *
565  * Allow devices to inform of the next wakeup. It's assumed that the users
566  * guarantee that the genpd wouldn't be detached while this routine is getting
567  * called. Additionally, it's also assumed that @dev isn't runtime suspended
568  * (RPM_SUSPENDED)."
569  * Although devices are expected to update the next_wakeup after the end of
570  * their usecase as well, it is possible the devices themselves may not know
571  * about that, so stale @next will be ignored when powering off the domain.
572  */
573 void dev_pm_genpd_set_next_wakeup(struct device *dev, ktime_t next)
574 {
575 	struct generic_pm_domain *genpd;
576 	struct gpd_timing_data *td;
577 
578 	genpd = dev_to_genpd_safe(dev);
579 	if (!genpd)
580 		return;
581 
582 	td = to_gpd_data(dev->power.subsys_data->domain_data)->td;
583 	if (td)
584 		td->next_wakeup = next;
585 }
586 EXPORT_SYMBOL_GPL(dev_pm_genpd_set_next_wakeup);
587 
588 /**
589  * dev_pm_genpd_get_next_hrtimer - Return the next_hrtimer for the genpd
590  * @dev: A device that is attached to the genpd.
591  *
592  * This routine should typically be called for a device, at the point of when a
593  * GENPD_NOTIFY_PRE_OFF notification has been sent for it.
594  *
595  * Returns the aggregated value of the genpd's next hrtimer or KTIME_MAX if no
596  * valid value have been set.
597  */
598 ktime_t dev_pm_genpd_get_next_hrtimer(struct device *dev)
599 {
600 	struct generic_pm_domain *genpd;
601 
602 	genpd = dev_to_genpd_safe(dev);
603 	if (!genpd)
604 		return KTIME_MAX;
605 
606 	if (genpd->gd)
607 		return genpd->gd->next_hrtimer;
608 
609 	return KTIME_MAX;
610 }
611 EXPORT_SYMBOL_GPL(dev_pm_genpd_get_next_hrtimer);
612 
613 /*
614  * dev_pm_genpd_synced_poweroff - Next power off should be synchronous
615  *
616  * @dev: A device that is attached to the genpd.
617  *
618  * Allows a consumer of the genpd to notify the provider that the next power off
619  * should be synchronous.
620  *
621  * It is assumed that the users guarantee that the genpd wouldn't be detached
622  * while this routine is getting called.
623  */
624 void dev_pm_genpd_synced_poweroff(struct device *dev)
625 {
626 	struct generic_pm_domain *genpd;
627 
628 	genpd = dev_to_genpd_safe(dev);
629 	if (!genpd)
630 		return;
631 
632 	genpd_lock(genpd);
633 	genpd->synced_poweroff = true;
634 	genpd_unlock(genpd);
635 }
636 EXPORT_SYMBOL_GPL(dev_pm_genpd_synced_poweroff);
637 
638 /**
639  * dev_pm_genpd_set_hwmode() - Set the HW mode for the device and its PM domain.
640  *
641  * @dev: Device for which the HW-mode should be changed.
642  * @enable: Value to set or unset the HW-mode.
643  *
644  * Some PM domains can rely on HW signals to control the power for a device. To
645  * allow a consumer driver to switch the behaviour for its device in runtime,
646  * which may be beneficial from a latency or energy point of view, this function
647  * may be called.
648  *
649  * It is assumed that the users guarantee that the genpd wouldn't be detached
650  * while this routine is getting called.
651  *
652  * Return: Returns 0 on success and negative error values on failures.
653  */
654 int dev_pm_genpd_set_hwmode(struct device *dev, bool enable)
655 {
656 	struct generic_pm_domain *genpd;
657 	int ret = 0;
658 
659 	genpd = dev_to_genpd_safe(dev);
660 	if (!genpd)
661 		return -ENODEV;
662 
663 	if (!genpd->set_hwmode_dev)
664 		return -EOPNOTSUPP;
665 
666 	genpd_lock(genpd);
667 
668 	if (dev_gpd_data(dev)->hw_mode == enable)
669 		goto out;
670 
671 	ret = genpd->set_hwmode_dev(genpd, dev, enable);
672 	if (!ret)
673 		dev_gpd_data(dev)->hw_mode = enable;
674 
675 out:
676 	genpd_unlock(genpd);
677 	return ret;
678 }
679 EXPORT_SYMBOL_GPL(dev_pm_genpd_set_hwmode);
680 
681 /**
682  * dev_pm_genpd_get_hwmode() - Get the HW mode setting for the device.
683  *
684  * @dev: Device for which the current HW-mode setting should be fetched.
685  *
686  * This helper function allows consumer drivers to fetch the current HW mode
687  * setting of its the device.
688  *
689  * It is assumed that the users guarantee that the genpd wouldn't be detached
690  * while this routine is getting called.
691  *
692  * Return: Returns the HW mode setting of device from SW cached hw_mode.
693  */
694 bool dev_pm_genpd_get_hwmode(struct device *dev)
695 {
696 	return dev_gpd_data(dev)->hw_mode;
697 }
698 EXPORT_SYMBOL_GPL(dev_pm_genpd_get_hwmode);
699 
700 static int _genpd_power_on(struct generic_pm_domain *genpd, bool timed)
701 {
702 	unsigned int state_idx = genpd->state_idx;
703 	ktime_t time_start;
704 	s64 elapsed_ns;
705 	int ret;
706 
707 	/* Notify consumers that we are about to power on. */
708 	ret = raw_notifier_call_chain_robust(&genpd->power_notifiers,
709 					     GENPD_NOTIFY_PRE_ON,
710 					     GENPD_NOTIFY_OFF, NULL);
711 	ret = notifier_to_errno(ret);
712 	if (ret)
713 		return ret;
714 
715 	if (!genpd->power_on)
716 		goto out;
717 
718 	timed = timed && genpd->gd && !genpd->states[state_idx].fwnode;
719 	if (!timed) {
720 		ret = genpd->power_on(genpd);
721 		if (ret)
722 			goto err;
723 
724 		goto out;
725 	}
726 
727 	time_start = ktime_get();
728 	ret = genpd->power_on(genpd);
729 	if (ret)
730 		goto err;
731 
732 	elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
733 	if (elapsed_ns <= genpd->states[state_idx].power_on_latency_ns)
734 		goto out;
735 
736 	genpd->states[state_idx].power_on_latency_ns = elapsed_ns;
737 	genpd->gd->max_off_time_changed = true;
738 	pr_debug("%s: Power-%s latency exceeded, new value %lld ns\n",
739 		 dev_name(&genpd->dev), "on", elapsed_ns);
740 
741 out:
742 	raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_ON, NULL);
743 	genpd->synced_poweroff = false;
744 	return 0;
745 err:
746 	raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_OFF,
747 				NULL);
748 	return ret;
749 }
750 
751 static int _genpd_power_off(struct generic_pm_domain *genpd, bool timed)
752 {
753 	unsigned int state_idx = genpd->state_idx;
754 	ktime_t time_start;
755 	s64 elapsed_ns;
756 	int ret;
757 
758 	/* Notify consumers that we are about to power off. */
759 	ret = raw_notifier_call_chain_robust(&genpd->power_notifiers,
760 					     GENPD_NOTIFY_PRE_OFF,
761 					     GENPD_NOTIFY_ON, NULL);
762 	ret = notifier_to_errno(ret);
763 	if (ret)
764 		return ret;
765 
766 	if (!genpd->power_off)
767 		goto out;
768 
769 	timed = timed && genpd->gd && !genpd->states[state_idx].fwnode;
770 	if (!timed) {
771 		ret = genpd->power_off(genpd);
772 		if (ret)
773 			goto busy;
774 
775 		goto out;
776 	}
777 
778 	time_start = ktime_get();
779 	ret = genpd->power_off(genpd);
780 	if (ret)
781 		goto busy;
782 
783 	elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
784 	if (elapsed_ns <= genpd->states[state_idx].power_off_latency_ns)
785 		goto out;
786 
787 	genpd->states[state_idx].power_off_latency_ns = elapsed_ns;
788 	genpd->gd->max_off_time_changed = true;
789 	pr_debug("%s: Power-%s latency exceeded, new value %lld ns\n",
790 		 dev_name(&genpd->dev), "off", elapsed_ns);
791 
792 out:
793 	raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_OFF,
794 				NULL);
795 	return 0;
796 busy:
797 	raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_ON, NULL);
798 	return ret;
799 }
800 
801 /**
802  * genpd_queue_power_off_work - Queue up the execution of genpd_power_off().
803  * @genpd: PM domain to power off.
804  *
805  * Queue up the execution of genpd_power_off() unless it's already been done
806  * before.
807  */
808 static void genpd_queue_power_off_work(struct generic_pm_domain *genpd)
809 {
810 	queue_work(pm_wq, &genpd->power_off_work);
811 }
812 
813 /**
814  * genpd_power_off - Remove power from a given PM domain.
815  * @genpd: PM domain to power down.
816  * @one_dev_on: If invoked from genpd's ->runtime_suspend|resume() callback, the
817  * RPM status of the releated device is in an intermediate state, not yet turned
818  * into RPM_SUSPENDED. This means genpd_power_off() must allow one device to not
819  * be RPM_SUSPENDED, while it tries to power off the PM domain.
820  * @depth: nesting count for lockdep.
821  *
822  * If all of the @genpd's devices have been suspended and all of its subdomains
823  * have been powered down, remove power from @genpd.
824  */
825 static int genpd_power_off(struct generic_pm_domain *genpd, bool one_dev_on,
826 			   unsigned int depth)
827 {
828 	struct pm_domain_data *pdd;
829 	struct gpd_link *link;
830 	unsigned int not_suspended = 0;
831 	int ret;
832 
833 	/*
834 	 * Do not try to power off the domain in the following situations:
835 	 * (1) The domain is already in the "power off" state.
836 	 * (2) System suspend is in progress.
837 	 */
838 	if (!genpd_status_on(genpd) || genpd->prepared_count > 0)
839 		return 0;
840 
841 	/*
842 	 * Abort power off for the PM domain in the following situations:
843 	 * (1) The domain is configured as always on.
844 	 * (2) When the domain has a subdomain being powered on.
845 	 */
846 	if (genpd_is_always_on(genpd) ||
847 			genpd_is_rpm_always_on(genpd) ||
848 			atomic_read(&genpd->sd_count) > 0)
849 		return -EBUSY;
850 
851 	/*
852 	 * The children must be in their deepest (powered-off) states to allow
853 	 * the parent to be powered off. Note that, there's no need for
854 	 * additional locking, as powering on a child, requires the parent's
855 	 * lock to be acquired first.
856 	 */
857 	list_for_each_entry(link, &genpd->parent_links, parent_node) {
858 		struct generic_pm_domain *child = link->child;
859 		if (child->state_idx < child->state_count - 1)
860 			return -EBUSY;
861 	}
862 
863 	list_for_each_entry(pdd, &genpd->dev_list, list_node) {
864 		/*
865 		 * Do not allow PM domain to be powered off, when an IRQ safe
866 		 * device is part of a non-IRQ safe domain.
867 		 */
868 		if (!pm_runtime_suspended(pdd->dev) ||
869 			irq_safe_dev_in_sleep_domain(pdd->dev, genpd))
870 			not_suspended++;
871 	}
872 
873 	if (not_suspended > 1 || (not_suspended == 1 && !one_dev_on))
874 		return -EBUSY;
875 
876 	if (genpd->gov && genpd->gov->power_down_ok) {
877 		if (!genpd->gov->power_down_ok(&genpd->domain))
878 			return -EAGAIN;
879 	}
880 
881 	/* Default to shallowest state. */
882 	if (!genpd->gov)
883 		genpd->state_idx = 0;
884 
885 	/* Don't power off, if a child domain is waiting to power on. */
886 	if (atomic_read(&genpd->sd_count) > 0)
887 		return -EBUSY;
888 
889 	ret = _genpd_power_off(genpd, true);
890 	if (ret) {
891 		genpd->states[genpd->state_idx].rejected++;
892 		return ret;
893 	}
894 
895 	genpd->status = GENPD_STATE_OFF;
896 	genpd_update_accounting(genpd);
897 	genpd->states[genpd->state_idx].usage++;
898 
899 	list_for_each_entry(link, &genpd->child_links, child_node) {
900 		genpd_sd_counter_dec(link->parent);
901 		genpd_lock_nested(link->parent, depth + 1);
902 		genpd_power_off(link->parent, false, depth + 1);
903 		genpd_unlock(link->parent);
904 	}
905 
906 	return 0;
907 }
908 
909 /**
910  * genpd_power_on - Restore power to a given PM domain and its parents.
911  * @genpd: PM domain to power up.
912  * @depth: nesting count for lockdep.
913  *
914  * Restore power to @genpd and all of its parents so that it is possible to
915  * resume a device belonging to it.
916  */
917 static int genpd_power_on(struct generic_pm_domain *genpd, unsigned int depth)
918 {
919 	struct gpd_link *link;
920 	int ret = 0;
921 
922 	if (genpd_status_on(genpd))
923 		return 0;
924 
925 	/*
926 	 * The list is guaranteed not to change while the loop below is being
927 	 * executed, unless one of the parents' .power_on() callbacks fiddles
928 	 * with it.
929 	 */
930 	list_for_each_entry(link, &genpd->child_links, child_node) {
931 		struct generic_pm_domain *parent = link->parent;
932 
933 		genpd_sd_counter_inc(parent);
934 
935 		genpd_lock_nested(parent, depth + 1);
936 		ret = genpd_power_on(parent, depth + 1);
937 		genpd_unlock(parent);
938 
939 		if (ret) {
940 			genpd_sd_counter_dec(parent);
941 			goto err;
942 		}
943 	}
944 
945 	ret = _genpd_power_on(genpd, true);
946 	if (ret)
947 		goto err;
948 
949 	genpd->status = GENPD_STATE_ON;
950 	genpd_update_accounting(genpd);
951 
952 	return 0;
953 
954  err:
955 	list_for_each_entry_continue_reverse(link,
956 					&genpd->child_links,
957 					child_node) {
958 		genpd_sd_counter_dec(link->parent);
959 		genpd_lock_nested(link->parent, depth + 1);
960 		genpd_power_off(link->parent, false, depth + 1);
961 		genpd_unlock(link->parent);
962 	}
963 
964 	return ret;
965 }
966 
967 static int genpd_dev_pm_start(struct device *dev)
968 {
969 	struct generic_pm_domain *genpd = dev_to_genpd(dev);
970 
971 	return genpd_start_dev(genpd, dev);
972 }
973 
974 static int genpd_dev_pm_qos_notifier(struct notifier_block *nb,
975 				     unsigned long val, void *ptr)
976 {
977 	struct generic_pm_domain_data *gpd_data;
978 	struct device *dev;
979 
980 	gpd_data = container_of(nb, struct generic_pm_domain_data, nb);
981 	dev = gpd_data->base.dev;
982 
983 	for (;;) {
984 		struct generic_pm_domain *genpd = ERR_PTR(-ENODATA);
985 		struct pm_domain_data *pdd;
986 		struct gpd_timing_data *td;
987 
988 		spin_lock_irq(&dev->power.lock);
989 
990 		pdd = dev->power.subsys_data ?
991 				dev->power.subsys_data->domain_data : NULL;
992 		if (pdd) {
993 			td = to_gpd_data(pdd)->td;
994 			if (td) {
995 				td->constraint_changed = true;
996 				genpd = dev_to_genpd(dev);
997 			}
998 		}
999 
1000 		spin_unlock_irq(&dev->power.lock);
1001 
1002 		if (!IS_ERR(genpd)) {
1003 			genpd_lock(genpd);
1004 			genpd->gd->max_off_time_changed = true;
1005 			genpd_unlock(genpd);
1006 		}
1007 
1008 		dev = dev->parent;
1009 		if (!dev || dev->power.ignore_children)
1010 			break;
1011 	}
1012 
1013 	return NOTIFY_DONE;
1014 }
1015 
1016 /**
1017  * genpd_power_off_work_fn - Power off PM domain whose subdomain count is 0.
1018  * @work: Work structure used for scheduling the execution of this function.
1019  */
1020 static void genpd_power_off_work_fn(struct work_struct *work)
1021 {
1022 	struct generic_pm_domain *genpd;
1023 
1024 	genpd = container_of(work, struct generic_pm_domain, power_off_work);
1025 
1026 	genpd_lock(genpd);
1027 	genpd_power_off(genpd, false, 0);
1028 	genpd_unlock(genpd);
1029 }
1030 
1031 /**
1032  * __genpd_runtime_suspend - walk the hierarchy of ->runtime_suspend() callbacks
1033  * @dev: Device to handle.
1034  */
1035 static int __genpd_runtime_suspend(struct device *dev)
1036 {
1037 	int (*cb)(struct device *__dev);
1038 
1039 	if (dev->type && dev->type->pm)
1040 		cb = dev->type->pm->runtime_suspend;
1041 	else if (dev->class && dev->class->pm)
1042 		cb = dev->class->pm->runtime_suspend;
1043 	else if (dev->bus && dev->bus->pm)
1044 		cb = dev->bus->pm->runtime_suspend;
1045 	else
1046 		cb = NULL;
1047 
1048 	if (!cb && dev->driver && dev->driver->pm)
1049 		cb = dev->driver->pm->runtime_suspend;
1050 
1051 	return cb ? cb(dev) : 0;
1052 }
1053 
1054 /**
1055  * __genpd_runtime_resume - walk the hierarchy of ->runtime_resume() callbacks
1056  * @dev: Device to handle.
1057  */
1058 static int __genpd_runtime_resume(struct device *dev)
1059 {
1060 	int (*cb)(struct device *__dev);
1061 
1062 	if (dev->type && dev->type->pm)
1063 		cb = dev->type->pm->runtime_resume;
1064 	else if (dev->class && dev->class->pm)
1065 		cb = dev->class->pm->runtime_resume;
1066 	else if (dev->bus && dev->bus->pm)
1067 		cb = dev->bus->pm->runtime_resume;
1068 	else
1069 		cb = NULL;
1070 
1071 	if (!cb && dev->driver && dev->driver->pm)
1072 		cb = dev->driver->pm->runtime_resume;
1073 
1074 	return cb ? cb(dev) : 0;
1075 }
1076 
1077 /**
1078  * genpd_runtime_suspend - Suspend a device belonging to I/O PM domain.
1079  * @dev: Device to suspend.
1080  *
1081  * Carry out a runtime suspend of a device under the assumption that its
1082  * pm_domain field points to the domain member of an object of type
1083  * struct generic_pm_domain representing a PM domain consisting of I/O devices.
1084  */
1085 static int genpd_runtime_suspend(struct device *dev)
1086 {
1087 	struct generic_pm_domain *genpd;
1088 	bool (*suspend_ok)(struct device *__dev);
1089 	struct generic_pm_domain_data *gpd_data = dev_gpd_data(dev);
1090 	struct gpd_timing_data *td = gpd_data->td;
1091 	bool runtime_pm = pm_runtime_enabled(dev);
1092 	ktime_t time_start = 0;
1093 	s64 elapsed_ns;
1094 	int ret;
1095 
1096 	dev_dbg(dev, "%s()\n", __func__);
1097 
1098 	genpd = dev_to_genpd(dev);
1099 	if (IS_ERR(genpd))
1100 		return -EINVAL;
1101 
1102 	/*
1103 	 * A runtime PM centric subsystem/driver may re-use the runtime PM
1104 	 * callbacks for other purposes than runtime PM. In those scenarios
1105 	 * runtime PM is disabled. Under these circumstances, we shall skip
1106 	 * validating/measuring the PM QoS latency.
1107 	 */
1108 	suspend_ok = genpd->gov ? genpd->gov->suspend_ok : NULL;
1109 	if (runtime_pm && suspend_ok && !suspend_ok(dev))
1110 		return -EBUSY;
1111 
1112 	/* Measure suspend latency. */
1113 	if (td && runtime_pm)
1114 		time_start = ktime_get();
1115 
1116 	ret = __genpd_runtime_suspend(dev);
1117 	if (ret)
1118 		return ret;
1119 
1120 	ret = genpd_stop_dev(genpd, dev);
1121 	if (ret) {
1122 		__genpd_runtime_resume(dev);
1123 		return ret;
1124 	}
1125 
1126 	/* Update suspend latency value if the measured time exceeds it. */
1127 	if (td && runtime_pm) {
1128 		elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
1129 		if (elapsed_ns > td->suspend_latency_ns) {
1130 			td->suspend_latency_ns = elapsed_ns;
1131 			dev_dbg(dev, "suspend latency exceeded, %lld ns\n",
1132 				elapsed_ns);
1133 			genpd->gd->max_off_time_changed = true;
1134 			td->constraint_changed = true;
1135 		}
1136 	}
1137 
1138 	/*
1139 	 * If power.irq_safe is set, this routine may be run with
1140 	 * IRQs disabled, so suspend only if the PM domain also is irq_safe.
1141 	 */
1142 	if (irq_safe_dev_in_sleep_domain(dev, genpd))
1143 		return 0;
1144 
1145 	genpd_lock(genpd);
1146 	genpd_power_off(genpd, true, 0);
1147 	gpd_data->rpm_pstate = genpd_drop_performance_state(dev);
1148 	genpd_unlock(genpd);
1149 
1150 	return 0;
1151 }
1152 
1153 /**
1154  * genpd_runtime_resume - Resume a device belonging to I/O PM domain.
1155  * @dev: Device to resume.
1156  *
1157  * Carry out a runtime resume of a device under the assumption that its
1158  * pm_domain field points to the domain member of an object of type
1159  * struct generic_pm_domain representing a PM domain consisting of I/O devices.
1160  */
1161 static int genpd_runtime_resume(struct device *dev)
1162 {
1163 	struct generic_pm_domain *genpd;
1164 	struct generic_pm_domain_data *gpd_data = dev_gpd_data(dev);
1165 	struct gpd_timing_data *td = gpd_data->td;
1166 	bool timed = td && pm_runtime_enabled(dev);
1167 	ktime_t time_start = 0;
1168 	s64 elapsed_ns;
1169 	int ret;
1170 
1171 	dev_dbg(dev, "%s()\n", __func__);
1172 
1173 	genpd = dev_to_genpd(dev);
1174 	if (IS_ERR(genpd))
1175 		return -EINVAL;
1176 
1177 	/*
1178 	 * As we don't power off a non IRQ safe domain, which holds
1179 	 * an IRQ safe device, we don't need to restore power to it.
1180 	 */
1181 	if (irq_safe_dev_in_sleep_domain(dev, genpd))
1182 		goto out;
1183 
1184 	genpd_lock(genpd);
1185 	genpd_restore_performance_state(dev, gpd_data->rpm_pstate);
1186 	ret = genpd_power_on(genpd, 0);
1187 	genpd_unlock(genpd);
1188 
1189 	if (ret)
1190 		return ret;
1191 
1192  out:
1193 	/* Measure resume latency. */
1194 	if (timed)
1195 		time_start = ktime_get();
1196 
1197 	ret = genpd_start_dev(genpd, dev);
1198 	if (ret)
1199 		goto err_poweroff;
1200 
1201 	ret = __genpd_runtime_resume(dev);
1202 	if (ret)
1203 		goto err_stop;
1204 
1205 	/* Update resume latency value if the measured time exceeds it. */
1206 	if (timed) {
1207 		elapsed_ns = ktime_to_ns(ktime_sub(ktime_get(), time_start));
1208 		if (elapsed_ns > td->resume_latency_ns) {
1209 			td->resume_latency_ns = elapsed_ns;
1210 			dev_dbg(dev, "resume latency exceeded, %lld ns\n",
1211 				elapsed_ns);
1212 			genpd->gd->max_off_time_changed = true;
1213 			td->constraint_changed = true;
1214 		}
1215 	}
1216 
1217 	return 0;
1218 
1219 err_stop:
1220 	genpd_stop_dev(genpd, dev);
1221 err_poweroff:
1222 	if (!pm_runtime_is_irq_safe(dev) || genpd_is_irq_safe(genpd)) {
1223 		genpd_lock(genpd);
1224 		genpd_power_off(genpd, true, 0);
1225 		gpd_data->rpm_pstate = genpd_drop_performance_state(dev);
1226 		genpd_unlock(genpd);
1227 	}
1228 
1229 	return ret;
1230 }
1231 
1232 static bool pd_ignore_unused;
1233 static int __init pd_ignore_unused_setup(char *__unused)
1234 {
1235 	pd_ignore_unused = true;
1236 	return 1;
1237 }
1238 __setup("pd_ignore_unused", pd_ignore_unused_setup);
1239 
1240 /**
1241  * genpd_power_off_unused - Power off all PM domains with no devices in use.
1242  */
1243 static int __init genpd_power_off_unused(void)
1244 {
1245 	struct generic_pm_domain *genpd;
1246 
1247 	if (pd_ignore_unused) {
1248 		pr_warn("genpd: Not disabling unused power domains\n");
1249 		return 0;
1250 	}
1251 
1252 	pr_info("genpd: Disabling unused power domains\n");
1253 	mutex_lock(&gpd_list_lock);
1254 
1255 	list_for_each_entry(genpd, &gpd_list, gpd_list_node)
1256 		genpd_queue_power_off_work(genpd);
1257 
1258 	mutex_unlock(&gpd_list_lock);
1259 
1260 	return 0;
1261 }
1262 late_initcall_sync(genpd_power_off_unused);
1263 
1264 #ifdef CONFIG_PM_SLEEP
1265 
1266 /**
1267  * genpd_sync_power_off - Synchronously power off a PM domain and its parents.
1268  * @genpd: PM domain to power off, if possible.
1269  * @use_lock: use the lock.
1270  * @depth: nesting count for lockdep.
1271  *
1272  * Check if the given PM domain can be powered off (during system suspend or
1273  * hibernation) and do that if so.  Also, in that case propagate to its parents.
1274  *
1275  * This function is only called in "noirq" and "syscore" stages of system power
1276  * transitions. The "noirq" callbacks may be executed asynchronously, thus in
1277  * these cases the lock must be held.
1278  */
1279 static void genpd_sync_power_off(struct generic_pm_domain *genpd, bool use_lock,
1280 				 unsigned int depth)
1281 {
1282 	struct gpd_link *link;
1283 
1284 	if (!genpd_status_on(genpd) || genpd_is_always_on(genpd))
1285 		return;
1286 
1287 	if (genpd->suspended_count != genpd->device_count
1288 	    || atomic_read(&genpd->sd_count) > 0)
1289 		return;
1290 
1291 	/* Check that the children are in their deepest (powered-off) state. */
1292 	list_for_each_entry(link, &genpd->parent_links, parent_node) {
1293 		struct generic_pm_domain *child = link->child;
1294 		if (child->state_idx < child->state_count - 1)
1295 			return;
1296 	}
1297 
1298 	/* Choose the deepest state when suspending */
1299 	genpd->state_idx = genpd->state_count - 1;
1300 	if (_genpd_power_off(genpd, false)) {
1301 		genpd->states[genpd->state_idx].rejected++;
1302 		return;
1303 	} else {
1304 		genpd->states[genpd->state_idx].usage++;
1305 	}
1306 
1307 	genpd->status = GENPD_STATE_OFF;
1308 
1309 	list_for_each_entry(link, &genpd->child_links, child_node) {
1310 		genpd_sd_counter_dec(link->parent);
1311 
1312 		if (use_lock)
1313 			genpd_lock_nested(link->parent, depth + 1);
1314 
1315 		genpd_sync_power_off(link->parent, use_lock, depth + 1);
1316 
1317 		if (use_lock)
1318 			genpd_unlock(link->parent);
1319 	}
1320 }
1321 
1322 /**
1323  * genpd_sync_power_on - Synchronously power on a PM domain and its parents.
1324  * @genpd: PM domain to power on.
1325  * @use_lock: use the lock.
1326  * @depth: nesting count for lockdep.
1327  *
1328  * This function is only called in "noirq" and "syscore" stages of system power
1329  * transitions. The "noirq" callbacks may be executed asynchronously, thus in
1330  * these cases the lock must be held.
1331  */
1332 static void genpd_sync_power_on(struct generic_pm_domain *genpd, bool use_lock,
1333 				unsigned int depth)
1334 {
1335 	struct gpd_link *link;
1336 
1337 	if (genpd_status_on(genpd))
1338 		return;
1339 
1340 	list_for_each_entry(link, &genpd->child_links, child_node) {
1341 		genpd_sd_counter_inc(link->parent);
1342 
1343 		if (use_lock)
1344 			genpd_lock_nested(link->parent, depth + 1);
1345 
1346 		genpd_sync_power_on(link->parent, use_lock, depth + 1);
1347 
1348 		if (use_lock)
1349 			genpd_unlock(link->parent);
1350 	}
1351 
1352 	_genpd_power_on(genpd, false);
1353 	genpd->status = GENPD_STATE_ON;
1354 }
1355 
1356 /**
1357  * genpd_prepare - Start power transition of a device in a PM domain.
1358  * @dev: Device to start the transition of.
1359  *
1360  * Start a power transition of a device (during a system-wide power transition)
1361  * under the assumption that its pm_domain field points to the domain member of
1362  * an object of type struct generic_pm_domain representing a PM domain
1363  * consisting of I/O devices.
1364  */
1365 static int genpd_prepare(struct device *dev)
1366 {
1367 	struct generic_pm_domain *genpd;
1368 	int ret;
1369 
1370 	dev_dbg(dev, "%s()\n", __func__);
1371 
1372 	genpd = dev_to_genpd(dev);
1373 	if (IS_ERR(genpd))
1374 		return -EINVAL;
1375 
1376 	genpd_lock(genpd);
1377 	genpd->prepared_count++;
1378 	genpd_unlock(genpd);
1379 
1380 	ret = pm_generic_prepare(dev);
1381 	if (ret < 0) {
1382 		genpd_lock(genpd);
1383 
1384 		genpd->prepared_count--;
1385 
1386 		genpd_unlock(genpd);
1387 	}
1388 
1389 	/* Never return 1, as genpd don't cope with the direct_complete path. */
1390 	return ret >= 0 ? 0 : ret;
1391 }
1392 
1393 /**
1394  * genpd_finish_suspend - Completion of suspend or hibernation of device in an
1395  *   I/O pm domain.
1396  * @dev: Device to suspend.
1397  * @suspend_noirq: Generic suspend_noirq callback.
1398  * @resume_noirq: Generic resume_noirq callback.
1399  *
1400  * Stop the device and remove power from the domain if all devices in it have
1401  * been stopped.
1402  */
1403 static int genpd_finish_suspend(struct device *dev,
1404 				int (*suspend_noirq)(struct device *dev),
1405 				int (*resume_noirq)(struct device *dev))
1406 {
1407 	struct generic_pm_domain *genpd;
1408 	int ret = 0;
1409 
1410 	genpd = dev_to_genpd(dev);
1411 	if (IS_ERR(genpd))
1412 		return -EINVAL;
1413 
1414 	ret = suspend_noirq(dev);
1415 	if (ret)
1416 		return ret;
1417 
1418 	if (device_wakeup_path(dev) && genpd_is_active_wakeup(genpd))
1419 		return 0;
1420 
1421 	if (genpd->dev_ops.stop && genpd->dev_ops.start &&
1422 	    !pm_runtime_status_suspended(dev)) {
1423 		ret = genpd_stop_dev(genpd, dev);
1424 		if (ret) {
1425 			resume_noirq(dev);
1426 			return ret;
1427 		}
1428 	}
1429 
1430 	genpd_lock(genpd);
1431 	genpd->suspended_count++;
1432 	genpd_sync_power_off(genpd, true, 0);
1433 	genpd_unlock(genpd);
1434 
1435 	return 0;
1436 }
1437 
1438 /**
1439  * genpd_suspend_noirq - Completion of suspend of device in an I/O PM domain.
1440  * @dev: Device to suspend.
1441  *
1442  * Stop the device and remove power from the domain if all devices in it have
1443  * been stopped.
1444  */
1445 static int genpd_suspend_noirq(struct device *dev)
1446 {
1447 	dev_dbg(dev, "%s()\n", __func__);
1448 
1449 	return genpd_finish_suspend(dev,
1450 				    pm_generic_suspend_noirq,
1451 				    pm_generic_resume_noirq);
1452 }
1453 
1454 /**
1455  * genpd_finish_resume - Completion of resume of device in an I/O PM domain.
1456  * @dev: Device to resume.
1457  * @resume_noirq: Generic resume_noirq callback.
1458  *
1459  * Restore power to the device's PM domain, if necessary, and start the device.
1460  */
1461 static int genpd_finish_resume(struct device *dev,
1462 			       int (*resume_noirq)(struct device *dev))
1463 {
1464 	struct generic_pm_domain *genpd;
1465 	int ret;
1466 
1467 	dev_dbg(dev, "%s()\n", __func__);
1468 
1469 	genpd = dev_to_genpd(dev);
1470 	if (IS_ERR(genpd))
1471 		return -EINVAL;
1472 
1473 	if (device_wakeup_path(dev) && genpd_is_active_wakeup(genpd))
1474 		return resume_noirq(dev);
1475 
1476 	genpd_lock(genpd);
1477 	genpd_sync_power_on(genpd, true, 0);
1478 	genpd->suspended_count--;
1479 	genpd_unlock(genpd);
1480 
1481 	if (genpd->dev_ops.stop && genpd->dev_ops.start &&
1482 	    !pm_runtime_status_suspended(dev)) {
1483 		ret = genpd_start_dev(genpd, dev);
1484 		if (ret)
1485 			return ret;
1486 	}
1487 
1488 	return pm_generic_resume_noirq(dev);
1489 }
1490 
1491 /**
1492  * genpd_resume_noirq - Start of resume of device in an I/O PM domain.
1493  * @dev: Device to resume.
1494  *
1495  * Restore power to the device's PM domain, if necessary, and start the device.
1496  */
1497 static int genpd_resume_noirq(struct device *dev)
1498 {
1499 	dev_dbg(dev, "%s()\n", __func__);
1500 
1501 	return genpd_finish_resume(dev, pm_generic_resume_noirq);
1502 }
1503 
1504 /**
1505  * genpd_freeze_noirq - Completion of freezing a device in an I/O PM domain.
1506  * @dev: Device to freeze.
1507  *
1508  * Carry out a late freeze of a device under the assumption that its
1509  * pm_domain field points to the domain member of an object of type
1510  * struct generic_pm_domain representing a power domain consisting of I/O
1511  * devices.
1512  */
1513 static int genpd_freeze_noirq(struct device *dev)
1514 {
1515 	dev_dbg(dev, "%s()\n", __func__);
1516 
1517 	return genpd_finish_suspend(dev,
1518 				    pm_generic_freeze_noirq,
1519 				    pm_generic_thaw_noirq);
1520 }
1521 
1522 /**
1523  * genpd_thaw_noirq - Early thaw of device in an I/O PM domain.
1524  * @dev: Device to thaw.
1525  *
1526  * Start the device, unless power has been removed from the domain already
1527  * before the system transition.
1528  */
1529 static int genpd_thaw_noirq(struct device *dev)
1530 {
1531 	dev_dbg(dev, "%s()\n", __func__);
1532 
1533 	return genpd_finish_resume(dev, pm_generic_thaw_noirq);
1534 }
1535 
1536 /**
1537  * genpd_poweroff_noirq - Completion of hibernation of device in an
1538  *   I/O PM domain.
1539  * @dev: Device to poweroff.
1540  *
1541  * Stop the device and remove power from the domain if all devices in it have
1542  * been stopped.
1543  */
1544 static int genpd_poweroff_noirq(struct device *dev)
1545 {
1546 	dev_dbg(dev, "%s()\n", __func__);
1547 
1548 	return genpd_finish_suspend(dev,
1549 				    pm_generic_poweroff_noirq,
1550 				    pm_generic_restore_noirq);
1551 }
1552 
1553 /**
1554  * genpd_restore_noirq - Start of restore of device in an I/O PM domain.
1555  * @dev: Device to resume.
1556  *
1557  * Make sure the domain will be in the same power state as before the
1558  * hibernation the system is resuming from and start the device if necessary.
1559  */
1560 static int genpd_restore_noirq(struct device *dev)
1561 {
1562 	dev_dbg(dev, "%s()\n", __func__);
1563 
1564 	return genpd_finish_resume(dev, pm_generic_restore_noirq);
1565 }
1566 
1567 /**
1568  * genpd_complete - Complete power transition of a device in a power domain.
1569  * @dev: Device to complete the transition of.
1570  *
1571  * Complete a power transition of a device (during a system-wide power
1572  * transition) under the assumption that its pm_domain field points to the
1573  * domain member of an object of type struct generic_pm_domain representing
1574  * a power domain consisting of I/O devices.
1575  */
1576 static void genpd_complete(struct device *dev)
1577 {
1578 	struct generic_pm_domain *genpd;
1579 
1580 	dev_dbg(dev, "%s()\n", __func__);
1581 
1582 	genpd = dev_to_genpd(dev);
1583 	if (IS_ERR(genpd))
1584 		return;
1585 
1586 	pm_generic_complete(dev);
1587 
1588 	genpd_lock(genpd);
1589 
1590 	genpd->prepared_count--;
1591 	if (!genpd->prepared_count)
1592 		genpd_queue_power_off_work(genpd);
1593 
1594 	genpd_unlock(genpd);
1595 }
1596 
1597 static void genpd_switch_state(struct device *dev, bool suspend)
1598 {
1599 	struct generic_pm_domain *genpd;
1600 	bool use_lock;
1601 
1602 	genpd = dev_to_genpd_safe(dev);
1603 	if (!genpd)
1604 		return;
1605 
1606 	use_lock = genpd_is_irq_safe(genpd);
1607 
1608 	if (use_lock)
1609 		genpd_lock(genpd);
1610 
1611 	if (suspend) {
1612 		genpd->suspended_count++;
1613 		genpd_sync_power_off(genpd, use_lock, 0);
1614 	} else {
1615 		genpd_sync_power_on(genpd, use_lock, 0);
1616 		genpd->suspended_count--;
1617 	}
1618 
1619 	if (use_lock)
1620 		genpd_unlock(genpd);
1621 }
1622 
1623 /**
1624  * dev_pm_genpd_suspend - Synchronously try to suspend the genpd for @dev
1625  * @dev: The device that is attached to the genpd, that can be suspended.
1626  *
1627  * This routine should typically be called for a device that needs to be
1628  * suspended during the syscore suspend phase. It may also be called during
1629  * suspend-to-idle to suspend a corresponding CPU device that is attached to a
1630  * genpd.
1631  */
1632 void dev_pm_genpd_suspend(struct device *dev)
1633 {
1634 	genpd_switch_state(dev, true);
1635 }
1636 EXPORT_SYMBOL_GPL(dev_pm_genpd_suspend);
1637 
1638 /**
1639  * dev_pm_genpd_resume - Synchronously try to resume the genpd for @dev
1640  * @dev: The device that is attached to the genpd, which needs to be resumed.
1641  *
1642  * This routine should typically be called for a device that needs to be resumed
1643  * during the syscore resume phase. It may also be called during suspend-to-idle
1644  * to resume a corresponding CPU device that is attached to a genpd.
1645  */
1646 void dev_pm_genpd_resume(struct device *dev)
1647 {
1648 	genpd_switch_state(dev, false);
1649 }
1650 EXPORT_SYMBOL_GPL(dev_pm_genpd_resume);
1651 
1652 #else /* !CONFIG_PM_SLEEP */
1653 
1654 #define genpd_prepare		NULL
1655 #define genpd_suspend_noirq	NULL
1656 #define genpd_resume_noirq	NULL
1657 #define genpd_freeze_noirq	NULL
1658 #define genpd_thaw_noirq	NULL
1659 #define genpd_poweroff_noirq	NULL
1660 #define genpd_restore_noirq	NULL
1661 #define genpd_complete		NULL
1662 
1663 #endif /* CONFIG_PM_SLEEP */
1664 
1665 static struct generic_pm_domain_data *genpd_alloc_dev_data(struct device *dev,
1666 							   bool has_governor)
1667 {
1668 	struct generic_pm_domain_data *gpd_data;
1669 	struct gpd_timing_data *td;
1670 	int ret;
1671 
1672 	ret = dev_pm_get_subsys_data(dev);
1673 	if (ret)
1674 		return ERR_PTR(ret);
1675 
1676 	gpd_data = kzalloc(sizeof(*gpd_data), GFP_KERNEL);
1677 	if (!gpd_data) {
1678 		ret = -ENOMEM;
1679 		goto err_put;
1680 	}
1681 
1682 	gpd_data->base.dev = dev;
1683 	gpd_data->nb.notifier_call = genpd_dev_pm_qos_notifier;
1684 
1685 	/* Allocate data used by a governor. */
1686 	if (has_governor) {
1687 		td = kzalloc(sizeof(*td), GFP_KERNEL);
1688 		if (!td) {
1689 			ret = -ENOMEM;
1690 			goto err_free;
1691 		}
1692 
1693 		td->constraint_changed = true;
1694 		td->effective_constraint_ns = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT_NS;
1695 		td->next_wakeup = KTIME_MAX;
1696 		gpd_data->td = td;
1697 	}
1698 
1699 	spin_lock_irq(&dev->power.lock);
1700 
1701 	if (dev->power.subsys_data->domain_data)
1702 		ret = -EINVAL;
1703 	else
1704 		dev->power.subsys_data->domain_data = &gpd_data->base;
1705 
1706 	spin_unlock_irq(&dev->power.lock);
1707 
1708 	if (ret)
1709 		goto err_free;
1710 
1711 	return gpd_data;
1712 
1713  err_free:
1714 	kfree(gpd_data->td);
1715 	kfree(gpd_data);
1716  err_put:
1717 	dev_pm_put_subsys_data(dev);
1718 	return ERR_PTR(ret);
1719 }
1720 
1721 static void genpd_free_dev_data(struct device *dev,
1722 				struct generic_pm_domain_data *gpd_data)
1723 {
1724 	spin_lock_irq(&dev->power.lock);
1725 
1726 	dev->power.subsys_data->domain_data = NULL;
1727 
1728 	spin_unlock_irq(&dev->power.lock);
1729 
1730 	dev_pm_opp_clear_config(gpd_data->opp_token);
1731 	kfree(gpd_data->td);
1732 	kfree(gpd_data);
1733 	dev_pm_put_subsys_data(dev);
1734 }
1735 
1736 static void genpd_update_cpumask(struct generic_pm_domain *genpd,
1737 				 int cpu, bool set, unsigned int depth)
1738 {
1739 	struct gpd_link *link;
1740 
1741 	if (!genpd_is_cpu_domain(genpd))
1742 		return;
1743 
1744 	list_for_each_entry(link, &genpd->child_links, child_node) {
1745 		struct generic_pm_domain *parent = link->parent;
1746 
1747 		genpd_lock_nested(parent, depth + 1);
1748 		genpd_update_cpumask(parent, cpu, set, depth + 1);
1749 		genpd_unlock(parent);
1750 	}
1751 
1752 	if (set)
1753 		cpumask_set_cpu(cpu, genpd->cpus);
1754 	else
1755 		cpumask_clear_cpu(cpu, genpd->cpus);
1756 }
1757 
1758 static void genpd_set_cpumask(struct generic_pm_domain *genpd, int cpu)
1759 {
1760 	if (cpu >= 0)
1761 		genpd_update_cpumask(genpd, cpu, true, 0);
1762 }
1763 
1764 static void genpd_clear_cpumask(struct generic_pm_domain *genpd, int cpu)
1765 {
1766 	if (cpu >= 0)
1767 		genpd_update_cpumask(genpd, cpu, false, 0);
1768 }
1769 
1770 static int genpd_get_cpu(struct generic_pm_domain *genpd, struct device *dev)
1771 {
1772 	int cpu;
1773 
1774 	if (!genpd_is_cpu_domain(genpd))
1775 		return -1;
1776 
1777 	for_each_possible_cpu(cpu) {
1778 		if (get_cpu_device(cpu) == dev)
1779 			return cpu;
1780 	}
1781 
1782 	return -1;
1783 }
1784 
1785 static int genpd_add_device(struct generic_pm_domain *genpd, struct device *dev,
1786 			    struct device *base_dev)
1787 {
1788 	struct genpd_governor_data *gd = genpd->gd;
1789 	struct generic_pm_domain_data *gpd_data;
1790 	int ret;
1791 
1792 	dev_dbg(dev, "%s()\n", __func__);
1793 
1794 	gpd_data = genpd_alloc_dev_data(dev, gd);
1795 	if (IS_ERR(gpd_data))
1796 		return PTR_ERR(gpd_data);
1797 
1798 	gpd_data->cpu = genpd_get_cpu(genpd, base_dev);
1799 
1800 	gpd_data->hw_mode = genpd->get_hwmode_dev ? genpd->get_hwmode_dev(genpd, dev) : false;
1801 
1802 	ret = genpd->attach_dev ? genpd->attach_dev(genpd, dev) : 0;
1803 	if (ret)
1804 		goto out;
1805 
1806 	genpd_lock(genpd);
1807 
1808 	genpd_set_cpumask(genpd, gpd_data->cpu);
1809 
1810 	genpd->device_count++;
1811 	if (gd)
1812 		gd->max_off_time_changed = true;
1813 
1814 	list_add_tail(&gpd_data->base.list_node, &genpd->dev_list);
1815 
1816 	genpd_unlock(genpd);
1817 	dev_pm_domain_set(dev, &genpd->domain);
1818  out:
1819 	if (ret)
1820 		genpd_free_dev_data(dev, gpd_data);
1821 	else
1822 		dev_pm_qos_add_notifier(dev, &gpd_data->nb,
1823 					DEV_PM_QOS_RESUME_LATENCY);
1824 
1825 	return ret;
1826 }
1827 
1828 /**
1829  * pm_genpd_add_device - Add a device to an I/O PM domain.
1830  * @genpd: PM domain to add the device to.
1831  * @dev: Device to be added.
1832  */
1833 int pm_genpd_add_device(struct generic_pm_domain *genpd, struct device *dev)
1834 {
1835 	int ret;
1836 
1837 	if (!genpd || !dev)
1838 		return -EINVAL;
1839 
1840 	mutex_lock(&gpd_list_lock);
1841 	ret = genpd_add_device(genpd, dev, dev);
1842 	mutex_unlock(&gpd_list_lock);
1843 
1844 	return ret;
1845 }
1846 EXPORT_SYMBOL_GPL(pm_genpd_add_device);
1847 
1848 static int genpd_remove_device(struct generic_pm_domain *genpd,
1849 			       struct device *dev)
1850 {
1851 	struct generic_pm_domain_data *gpd_data;
1852 	struct pm_domain_data *pdd;
1853 	int ret = 0;
1854 
1855 	dev_dbg(dev, "%s()\n", __func__);
1856 
1857 	pdd = dev->power.subsys_data->domain_data;
1858 	gpd_data = to_gpd_data(pdd);
1859 	dev_pm_qos_remove_notifier(dev, &gpd_data->nb,
1860 				   DEV_PM_QOS_RESUME_LATENCY);
1861 
1862 	genpd_lock(genpd);
1863 
1864 	if (genpd->prepared_count > 0) {
1865 		ret = -EAGAIN;
1866 		goto out;
1867 	}
1868 
1869 	genpd->device_count--;
1870 	if (genpd->gd)
1871 		genpd->gd->max_off_time_changed = true;
1872 
1873 	genpd_clear_cpumask(genpd, gpd_data->cpu);
1874 
1875 	list_del_init(&pdd->list_node);
1876 
1877 	genpd_unlock(genpd);
1878 
1879 	dev_pm_domain_set(dev, NULL);
1880 
1881 	if (genpd->detach_dev)
1882 		genpd->detach_dev(genpd, dev);
1883 
1884 	genpd_free_dev_data(dev, gpd_data);
1885 
1886 	return 0;
1887 
1888  out:
1889 	genpd_unlock(genpd);
1890 	dev_pm_qos_add_notifier(dev, &gpd_data->nb, DEV_PM_QOS_RESUME_LATENCY);
1891 
1892 	return ret;
1893 }
1894 
1895 /**
1896  * pm_genpd_remove_device - Remove a device from an I/O PM domain.
1897  * @dev: Device to be removed.
1898  */
1899 int pm_genpd_remove_device(struct device *dev)
1900 {
1901 	struct generic_pm_domain *genpd = dev_to_genpd_safe(dev);
1902 
1903 	if (!genpd)
1904 		return -EINVAL;
1905 
1906 	return genpd_remove_device(genpd, dev);
1907 }
1908 EXPORT_SYMBOL_GPL(pm_genpd_remove_device);
1909 
1910 /**
1911  * dev_pm_genpd_add_notifier - Add a genpd power on/off notifier for @dev
1912  *
1913  * @dev: Device that should be associated with the notifier
1914  * @nb: The notifier block to register
1915  *
1916  * Users may call this function to add a genpd power on/off notifier for an
1917  * attached @dev. Only one notifier per device is allowed. The notifier is
1918  * sent when genpd is powering on/off the PM domain.
1919  *
1920  * It is assumed that the user guarantee that the genpd wouldn't be detached
1921  * while this routine is getting called.
1922  *
1923  * Returns 0 on success and negative error values on failures.
1924  */
1925 int dev_pm_genpd_add_notifier(struct device *dev, struct notifier_block *nb)
1926 {
1927 	struct generic_pm_domain *genpd;
1928 	struct generic_pm_domain_data *gpd_data;
1929 	int ret;
1930 
1931 	genpd = dev_to_genpd_safe(dev);
1932 	if (!genpd)
1933 		return -ENODEV;
1934 
1935 	if (WARN_ON(!dev->power.subsys_data ||
1936 		     !dev->power.subsys_data->domain_data))
1937 		return -EINVAL;
1938 
1939 	gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
1940 	if (gpd_data->power_nb)
1941 		return -EEXIST;
1942 
1943 	genpd_lock(genpd);
1944 	ret = raw_notifier_chain_register(&genpd->power_notifiers, nb);
1945 	genpd_unlock(genpd);
1946 
1947 	if (ret) {
1948 		dev_warn(dev, "failed to add notifier for PM domain %s\n",
1949 			 dev_name(&genpd->dev));
1950 		return ret;
1951 	}
1952 
1953 	gpd_data->power_nb = nb;
1954 	return 0;
1955 }
1956 EXPORT_SYMBOL_GPL(dev_pm_genpd_add_notifier);
1957 
1958 /**
1959  * dev_pm_genpd_remove_notifier - Remove a genpd power on/off notifier for @dev
1960  *
1961  * @dev: Device that is associated with the notifier
1962  *
1963  * Users may call this function to remove a genpd power on/off notifier for an
1964  * attached @dev.
1965  *
1966  * It is assumed that the user guarantee that the genpd wouldn't be detached
1967  * while this routine is getting called.
1968  *
1969  * Returns 0 on success and negative error values on failures.
1970  */
1971 int dev_pm_genpd_remove_notifier(struct device *dev)
1972 {
1973 	struct generic_pm_domain *genpd;
1974 	struct generic_pm_domain_data *gpd_data;
1975 	int ret;
1976 
1977 	genpd = dev_to_genpd_safe(dev);
1978 	if (!genpd)
1979 		return -ENODEV;
1980 
1981 	if (WARN_ON(!dev->power.subsys_data ||
1982 		     !dev->power.subsys_data->domain_data))
1983 		return -EINVAL;
1984 
1985 	gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
1986 	if (!gpd_data->power_nb)
1987 		return -ENODEV;
1988 
1989 	genpd_lock(genpd);
1990 	ret = raw_notifier_chain_unregister(&genpd->power_notifiers,
1991 					    gpd_data->power_nb);
1992 	genpd_unlock(genpd);
1993 
1994 	if (ret) {
1995 		dev_warn(dev, "failed to remove notifier for PM domain %s\n",
1996 			 dev_name(&genpd->dev));
1997 		return ret;
1998 	}
1999 
2000 	gpd_data->power_nb = NULL;
2001 	return 0;
2002 }
2003 EXPORT_SYMBOL_GPL(dev_pm_genpd_remove_notifier);
2004 
2005 static int genpd_add_subdomain(struct generic_pm_domain *genpd,
2006 			       struct generic_pm_domain *subdomain)
2007 {
2008 	struct gpd_link *link, *itr;
2009 	int ret = 0;
2010 
2011 	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain)
2012 	    || genpd == subdomain)
2013 		return -EINVAL;
2014 
2015 	/*
2016 	 * If the domain can be powered on/off in an IRQ safe
2017 	 * context, ensure that the subdomain can also be
2018 	 * powered on/off in that context.
2019 	 */
2020 	if (!genpd_is_irq_safe(genpd) && genpd_is_irq_safe(subdomain)) {
2021 		WARN(1, "Parent %s of subdomain %s must be IRQ safe\n",
2022 		     dev_name(&genpd->dev), subdomain->name);
2023 		return -EINVAL;
2024 	}
2025 
2026 	link = kzalloc(sizeof(*link), GFP_KERNEL);
2027 	if (!link)
2028 		return -ENOMEM;
2029 
2030 	genpd_lock(subdomain);
2031 	genpd_lock_nested(genpd, SINGLE_DEPTH_NESTING);
2032 
2033 	if (!genpd_status_on(genpd) && genpd_status_on(subdomain)) {
2034 		ret = -EINVAL;
2035 		goto out;
2036 	}
2037 
2038 	list_for_each_entry(itr, &genpd->parent_links, parent_node) {
2039 		if (itr->child == subdomain && itr->parent == genpd) {
2040 			ret = -EINVAL;
2041 			goto out;
2042 		}
2043 	}
2044 
2045 	link->parent = genpd;
2046 	list_add_tail(&link->parent_node, &genpd->parent_links);
2047 	link->child = subdomain;
2048 	list_add_tail(&link->child_node, &subdomain->child_links);
2049 	if (genpd_status_on(subdomain))
2050 		genpd_sd_counter_inc(genpd);
2051 
2052  out:
2053 	genpd_unlock(genpd);
2054 	genpd_unlock(subdomain);
2055 	if (ret)
2056 		kfree(link);
2057 	return ret;
2058 }
2059 
2060 /**
2061  * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
2062  * @genpd: Leader PM domain to add the subdomain to.
2063  * @subdomain: Subdomain to be added.
2064  */
2065 int pm_genpd_add_subdomain(struct generic_pm_domain *genpd,
2066 			   struct generic_pm_domain *subdomain)
2067 {
2068 	int ret;
2069 
2070 	mutex_lock(&gpd_list_lock);
2071 	ret = genpd_add_subdomain(genpd, subdomain);
2072 	mutex_unlock(&gpd_list_lock);
2073 
2074 	return ret;
2075 }
2076 EXPORT_SYMBOL_GPL(pm_genpd_add_subdomain);
2077 
2078 /**
2079  * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
2080  * @genpd: Leader PM domain to remove the subdomain from.
2081  * @subdomain: Subdomain to be removed.
2082  */
2083 int pm_genpd_remove_subdomain(struct generic_pm_domain *genpd,
2084 			      struct generic_pm_domain *subdomain)
2085 {
2086 	struct gpd_link *l, *link;
2087 	int ret = -EINVAL;
2088 
2089 	if (IS_ERR_OR_NULL(genpd) || IS_ERR_OR_NULL(subdomain))
2090 		return -EINVAL;
2091 
2092 	genpd_lock(subdomain);
2093 	genpd_lock_nested(genpd, SINGLE_DEPTH_NESTING);
2094 
2095 	if (!list_empty(&subdomain->parent_links) || subdomain->device_count) {
2096 		pr_warn("%s: unable to remove subdomain %s\n",
2097 			dev_name(&genpd->dev), subdomain->name);
2098 		ret = -EBUSY;
2099 		goto out;
2100 	}
2101 
2102 	list_for_each_entry_safe(link, l, &genpd->parent_links, parent_node) {
2103 		if (link->child != subdomain)
2104 			continue;
2105 
2106 		list_del(&link->parent_node);
2107 		list_del(&link->child_node);
2108 		kfree(link);
2109 		if (genpd_status_on(subdomain))
2110 			genpd_sd_counter_dec(genpd);
2111 
2112 		ret = 0;
2113 		break;
2114 	}
2115 
2116 out:
2117 	genpd_unlock(genpd);
2118 	genpd_unlock(subdomain);
2119 
2120 	return ret;
2121 }
2122 EXPORT_SYMBOL_GPL(pm_genpd_remove_subdomain);
2123 
2124 static void genpd_free_default_power_state(struct genpd_power_state *states,
2125 					   unsigned int state_count)
2126 {
2127 	kfree(states);
2128 }
2129 
2130 static int genpd_set_default_power_state(struct generic_pm_domain *genpd)
2131 {
2132 	struct genpd_power_state *state;
2133 
2134 	state = kzalloc(sizeof(*state), GFP_KERNEL);
2135 	if (!state)
2136 		return -ENOMEM;
2137 
2138 	genpd->states = state;
2139 	genpd->state_count = 1;
2140 	genpd->free_states = genpd_free_default_power_state;
2141 
2142 	return 0;
2143 }
2144 
2145 static int genpd_alloc_data(struct generic_pm_domain *genpd)
2146 {
2147 	struct genpd_governor_data *gd = NULL;
2148 	int ret;
2149 
2150 	if (genpd_is_cpu_domain(genpd) &&
2151 	    !zalloc_cpumask_var(&genpd->cpus, GFP_KERNEL))
2152 		return -ENOMEM;
2153 
2154 	if (genpd->gov) {
2155 		gd = kzalloc(sizeof(*gd), GFP_KERNEL);
2156 		if (!gd) {
2157 			ret = -ENOMEM;
2158 			goto free;
2159 		}
2160 
2161 		gd->max_off_time_ns = -1;
2162 		gd->max_off_time_changed = true;
2163 		gd->next_wakeup = KTIME_MAX;
2164 		gd->next_hrtimer = KTIME_MAX;
2165 	}
2166 
2167 	/* Use only one "off" state if there were no states declared */
2168 	if (genpd->state_count == 0) {
2169 		ret = genpd_set_default_power_state(genpd);
2170 		if (ret)
2171 			goto free;
2172 	}
2173 
2174 	genpd->gd = gd;
2175 	device_initialize(&genpd->dev);
2176 
2177 	if (!genpd_is_dev_name_fw(genpd)) {
2178 		dev_set_name(&genpd->dev, "%s", genpd->name);
2179 	} else {
2180 		ret = ida_alloc(&genpd_ida, GFP_KERNEL);
2181 		if (ret < 0)
2182 			goto put;
2183 
2184 		genpd->device_id = ret;
2185 		dev_set_name(&genpd->dev, "%s_%u", genpd->name, genpd->device_id);
2186 	}
2187 
2188 	return 0;
2189 put:
2190 	put_device(&genpd->dev);
2191 	if (genpd->free_states == genpd_free_default_power_state)
2192 		kfree(genpd->states);
2193 free:
2194 	if (genpd_is_cpu_domain(genpd))
2195 		free_cpumask_var(genpd->cpus);
2196 	kfree(gd);
2197 	return ret;
2198 }
2199 
2200 static void genpd_free_data(struct generic_pm_domain *genpd)
2201 {
2202 	put_device(&genpd->dev);
2203 	if (genpd->device_id != -ENXIO)
2204 		ida_free(&genpd_ida, genpd->device_id);
2205 	if (genpd_is_cpu_domain(genpd))
2206 		free_cpumask_var(genpd->cpus);
2207 	if (genpd->free_states)
2208 		genpd->free_states(genpd->states, genpd->state_count);
2209 	kfree(genpd->gd);
2210 }
2211 
2212 static void genpd_lock_init(struct generic_pm_domain *genpd)
2213 {
2214 	if (genpd_is_cpu_domain(genpd)) {
2215 		raw_spin_lock_init(&genpd->raw_slock);
2216 		genpd->lock_ops = &genpd_raw_spin_ops;
2217 	} else if (genpd_is_irq_safe(genpd)) {
2218 		spin_lock_init(&genpd->slock);
2219 		genpd->lock_ops = &genpd_spin_ops;
2220 	} else {
2221 		mutex_init(&genpd->mlock);
2222 		genpd->lock_ops = &genpd_mtx_ops;
2223 	}
2224 }
2225 
2226 /**
2227  * pm_genpd_init - Initialize a generic I/O PM domain object.
2228  * @genpd: PM domain object to initialize.
2229  * @gov: PM domain governor to associate with the domain (may be NULL).
2230  * @is_off: Initial value of the domain's power_is_off field.
2231  *
2232  * Returns 0 on successful initialization, else a negative error code.
2233  */
2234 int pm_genpd_init(struct generic_pm_domain *genpd,
2235 		  struct dev_power_governor *gov, bool is_off)
2236 {
2237 	int ret;
2238 
2239 	if (IS_ERR_OR_NULL(genpd))
2240 		return -EINVAL;
2241 
2242 	INIT_LIST_HEAD(&genpd->parent_links);
2243 	INIT_LIST_HEAD(&genpd->child_links);
2244 	INIT_LIST_HEAD(&genpd->dev_list);
2245 	RAW_INIT_NOTIFIER_HEAD(&genpd->power_notifiers);
2246 	genpd_lock_init(genpd);
2247 	genpd->gov = gov;
2248 	INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn);
2249 	atomic_set(&genpd->sd_count, 0);
2250 	genpd->status = is_off ? GENPD_STATE_OFF : GENPD_STATE_ON;
2251 	genpd->device_count = 0;
2252 	genpd->provider = NULL;
2253 	genpd->device_id = -ENXIO;
2254 	genpd->has_provider = false;
2255 	genpd->accounting_time = ktime_get_mono_fast_ns();
2256 	genpd->domain.ops.runtime_suspend = genpd_runtime_suspend;
2257 	genpd->domain.ops.runtime_resume = genpd_runtime_resume;
2258 	genpd->domain.ops.prepare = genpd_prepare;
2259 	genpd->domain.ops.suspend_noirq = genpd_suspend_noirq;
2260 	genpd->domain.ops.resume_noirq = genpd_resume_noirq;
2261 	genpd->domain.ops.freeze_noirq = genpd_freeze_noirq;
2262 	genpd->domain.ops.thaw_noirq = genpd_thaw_noirq;
2263 	genpd->domain.ops.poweroff_noirq = genpd_poweroff_noirq;
2264 	genpd->domain.ops.restore_noirq = genpd_restore_noirq;
2265 	genpd->domain.ops.complete = genpd_complete;
2266 	genpd->domain.start = genpd_dev_pm_start;
2267 	genpd->domain.set_performance_state = genpd_dev_pm_set_performance_state;
2268 
2269 	if (genpd->flags & GENPD_FLAG_PM_CLK) {
2270 		genpd->dev_ops.stop = pm_clk_suspend;
2271 		genpd->dev_ops.start = pm_clk_resume;
2272 	}
2273 
2274 	/* The always-on governor works better with the corresponding flag. */
2275 	if (gov == &pm_domain_always_on_gov)
2276 		genpd->flags |= GENPD_FLAG_RPM_ALWAYS_ON;
2277 
2278 	/* Always-on domains must be powered on at initialization. */
2279 	if ((genpd_is_always_on(genpd) || genpd_is_rpm_always_on(genpd)) &&
2280 			!genpd_status_on(genpd)) {
2281 		pr_err("always-on PM domain %s is not on\n", genpd->name);
2282 		return -EINVAL;
2283 	}
2284 
2285 	/* Multiple states but no governor doesn't make sense. */
2286 	if (!gov && genpd->state_count > 1)
2287 		pr_warn("%s: no governor for states\n", genpd->name);
2288 
2289 	ret = genpd_alloc_data(genpd);
2290 	if (ret)
2291 		return ret;
2292 
2293 	mutex_lock(&gpd_list_lock);
2294 	list_add(&genpd->gpd_list_node, &gpd_list);
2295 	mutex_unlock(&gpd_list_lock);
2296 	genpd_debug_add(genpd);
2297 
2298 	return 0;
2299 }
2300 EXPORT_SYMBOL_GPL(pm_genpd_init);
2301 
2302 static int genpd_remove(struct generic_pm_domain *genpd)
2303 {
2304 	struct gpd_link *l, *link;
2305 
2306 	if (IS_ERR_OR_NULL(genpd))
2307 		return -EINVAL;
2308 
2309 	genpd_lock(genpd);
2310 
2311 	if (genpd->has_provider) {
2312 		genpd_unlock(genpd);
2313 		pr_err("Provider present, unable to remove %s\n", dev_name(&genpd->dev));
2314 		return -EBUSY;
2315 	}
2316 
2317 	if (!list_empty(&genpd->parent_links) || genpd->device_count) {
2318 		genpd_unlock(genpd);
2319 		pr_err("%s: unable to remove %s\n", __func__, dev_name(&genpd->dev));
2320 		return -EBUSY;
2321 	}
2322 
2323 	list_for_each_entry_safe(link, l, &genpd->child_links, child_node) {
2324 		list_del(&link->parent_node);
2325 		list_del(&link->child_node);
2326 		kfree(link);
2327 	}
2328 
2329 	list_del(&genpd->gpd_list_node);
2330 	genpd_unlock(genpd);
2331 	genpd_debug_remove(genpd);
2332 	cancel_work_sync(&genpd->power_off_work);
2333 	genpd_free_data(genpd);
2334 
2335 	pr_debug("%s: removed %s\n", __func__, dev_name(&genpd->dev));
2336 
2337 	return 0;
2338 }
2339 
2340 /**
2341  * pm_genpd_remove - Remove a generic I/O PM domain
2342  * @genpd: Pointer to PM domain that is to be removed.
2343  *
2344  * To remove the PM domain, this function:
2345  *  - Removes the PM domain as a subdomain to any parent domains,
2346  *    if it was added.
2347  *  - Removes the PM domain from the list of registered PM domains.
2348  *
2349  * The PM domain will only be removed, if the associated provider has
2350  * been removed, it is not a parent to any other PM domain and has no
2351  * devices associated with it.
2352  */
2353 int pm_genpd_remove(struct generic_pm_domain *genpd)
2354 {
2355 	int ret;
2356 
2357 	mutex_lock(&gpd_list_lock);
2358 	ret = genpd_remove(genpd);
2359 	mutex_unlock(&gpd_list_lock);
2360 
2361 	return ret;
2362 }
2363 EXPORT_SYMBOL_GPL(pm_genpd_remove);
2364 
2365 #ifdef CONFIG_PM_GENERIC_DOMAINS_OF
2366 
2367 /*
2368  * Device Tree based PM domain providers.
2369  *
2370  * The code below implements generic device tree based PM domain providers that
2371  * bind device tree nodes with generic PM domains registered in the system.
2372  *
2373  * Any driver that registers generic PM domains and needs to support binding of
2374  * devices to these domains is supposed to register a PM domain provider, which
2375  * maps a PM domain specifier retrieved from the device tree to a PM domain.
2376  *
2377  * Two simple mapping functions have been provided for convenience:
2378  *  - genpd_xlate_simple() for 1:1 device tree node to PM domain mapping.
2379  *  - genpd_xlate_onecell() for mapping of multiple PM domains per node by
2380  *    index.
2381  */
2382 
2383 /**
2384  * struct of_genpd_provider - PM domain provider registration structure
2385  * @link: Entry in global list of PM domain providers
2386  * @node: Pointer to device tree node of PM domain provider
2387  * @xlate: Provider-specific xlate callback mapping a set of specifier cells
2388  *         into a PM domain.
2389  * @data: context pointer to be passed into @xlate callback
2390  */
2391 struct of_genpd_provider {
2392 	struct list_head link;
2393 	struct device_node *node;
2394 	genpd_xlate_t xlate;
2395 	void *data;
2396 };
2397 
2398 /* List of registered PM domain providers. */
2399 static LIST_HEAD(of_genpd_providers);
2400 /* Mutex to protect the list above. */
2401 static DEFINE_MUTEX(of_genpd_mutex);
2402 
2403 /**
2404  * genpd_xlate_simple() - Xlate function for direct node-domain mapping
2405  * @genpdspec: OF phandle args to map into a PM domain
2406  * @data: xlate function private data - pointer to struct generic_pm_domain
2407  *
2408  * This is a generic xlate function that can be used to model PM domains that
2409  * have their own device tree nodes. The private data of xlate function needs
2410  * to be a valid pointer to struct generic_pm_domain.
2411  */
2412 static struct generic_pm_domain *genpd_xlate_simple(
2413 					const struct of_phandle_args *genpdspec,
2414 					void *data)
2415 {
2416 	return data;
2417 }
2418 
2419 /**
2420  * genpd_xlate_onecell() - Xlate function using a single index.
2421  * @genpdspec: OF phandle args to map into a PM domain
2422  * @data: xlate function private data - pointer to struct genpd_onecell_data
2423  *
2424  * This is a generic xlate function that can be used to model simple PM domain
2425  * controllers that have one device tree node and provide multiple PM domains.
2426  * A single cell is used as an index into an array of PM domains specified in
2427  * the genpd_onecell_data struct when registering the provider.
2428  */
2429 static struct generic_pm_domain *genpd_xlate_onecell(
2430 					const struct of_phandle_args *genpdspec,
2431 					void *data)
2432 {
2433 	struct genpd_onecell_data *genpd_data = data;
2434 	unsigned int idx = genpdspec->args[0];
2435 
2436 	if (genpdspec->args_count != 1)
2437 		return ERR_PTR(-EINVAL);
2438 
2439 	if (idx >= genpd_data->num_domains) {
2440 		pr_err("%s: invalid domain index %u\n", __func__, idx);
2441 		return ERR_PTR(-EINVAL);
2442 	}
2443 
2444 	if (!genpd_data->domains[idx])
2445 		return ERR_PTR(-ENOENT);
2446 
2447 	return genpd_data->domains[idx];
2448 }
2449 
2450 /**
2451  * genpd_add_provider() - Register a PM domain provider for a node
2452  * @np: Device node pointer associated with the PM domain provider.
2453  * @xlate: Callback for decoding PM domain from phandle arguments.
2454  * @data: Context pointer for @xlate callback.
2455  */
2456 static int genpd_add_provider(struct device_node *np, genpd_xlate_t xlate,
2457 			      void *data)
2458 {
2459 	struct of_genpd_provider *cp;
2460 
2461 	cp = kzalloc(sizeof(*cp), GFP_KERNEL);
2462 	if (!cp)
2463 		return -ENOMEM;
2464 
2465 	cp->node = of_node_get(np);
2466 	cp->data = data;
2467 	cp->xlate = xlate;
2468 	fwnode_dev_initialized(&np->fwnode, true);
2469 
2470 	mutex_lock(&of_genpd_mutex);
2471 	list_add(&cp->link, &of_genpd_providers);
2472 	mutex_unlock(&of_genpd_mutex);
2473 	pr_debug("Added domain provider from %pOF\n", np);
2474 
2475 	return 0;
2476 }
2477 
2478 static bool genpd_present(const struct generic_pm_domain *genpd)
2479 {
2480 	bool ret = false;
2481 	const struct generic_pm_domain *gpd;
2482 
2483 	mutex_lock(&gpd_list_lock);
2484 	list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
2485 		if (gpd == genpd) {
2486 			ret = true;
2487 			break;
2488 		}
2489 	}
2490 	mutex_unlock(&gpd_list_lock);
2491 
2492 	return ret;
2493 }
2494 
2495 /**
2496  * of_genpd_add_provider_simple() - Register a simple PM domain provider
2497  * @np: Device node pointer associated with the PM domain provider.
2498  * @genpd: Pointer to PM domain associated with the PM domain provider.
2499  */
2500 int of_genpd_add_provider_simple(struct device_node *np,
2501 				 struct generic_pm_domain *genpd)
2502 {
2503 	int ret;
2504 
2505 	if (!np || !genpd)
2506 		return -EINVAL;
2507 
2508 	if (!genpd_present(genpd))
2509 		return -EINVAL;
2510 
2511 	genpd->dev.of_node = np;
2512 
2513 	/* Parse genpd OPP table */
2514 	if (!genpd_is_opp_table_fw(genpd) && genpd->set_performance_state) {
2515 		ret = dev_pm_opp_of_add_table(&genpd->dev);
2516 		if (ret)
2517 			return dev_err_probe(&genpd->dev, ret, "Failed to add OPP table\n");
2518 
2519 		/*
2520 		 * Save table for faster processing while setting performance
2521 		 * state.
2522 		 */
2523 		genpd->opp_table = dev_pm_opp_get_opp_table(&genpd->dev);
2524 		WARN_ON(IS_ERR(genpd->opp_table));
2525 	}
2526 
2527 	ret = genpd_add_provider(np, genpd_xlate_simple, genpd);
2528 	if (ret) {
2529 		if (!genpd_is_opp_table_fw(genpd) && genpd->set_performance_state) {
2530 			dev_pm_opp_put_opp_table(genpd->opp_table);
2531 			dev_pm_opp_of_remove_table(&genpd->dev);
2532 		}
2533 
2534 		return ret;
2535 	}
2536 
2537 	genpd->provider = &np->fwnode;
2538 	genpd->has_provider = true;
2539 
2540 	return 0;
2541 }
2542 EXPORT_SYMBOL_GPL(of_genpd_add_provider_simple);
2543 
2544 /**
2545  * of_genpd_add_provider_onecell() - Register a onecell PM domain provider
2546  * @np: Device node pointer associated with the PM domain provider.
2547  * @data: Pointer to the data associated with the PM domain provider.
2548  */
2549 int of_genpd_add_provider_onecell(struct device_node *np,
2550 				  struct genpd_onecell_data *data)
2551 {
2552 	struct generic_pm_domain *genpd;
2553 	unsigned int i;
2554 	int ret = -EINVAL;
2555 
2556 	if (!np || !data)
2557 		return -EINVAL;
2558 
2559 	if (!data->xlate)
2560 		data->xlate = genpd_xlate_onecell;
2561 
2562 	for (i = 0; i < data->num_domains; i++) {
2563 		genpd = data->domains[i];
2564 
2565 		if (!genpd)
2566 			continue;
2567 		if (!genpd_present(genpd))
2568 			goto error;
2569 
2570 		genpd->dev.of_node = np;
2571 
2572 		/* Parse genpd OPP table */
2573 		if (!genpd_is_opp_table_fw(genpd) && genpd->set_performance_state) {
2574 			ret = dev_pm_opp_of_add_table_indexed(&genpd->dev, i);
2575 			if (ret) {
2576 				dev_err_probe(&genpd->dev, ret,
2577 					      "Failed to add OPP table for index %d\n", i);
2578 				goto error;
2579 			}
2580 
2581 			/*
2582 			 * Save table for faster processing while setting
2583 			 * performance state.
2584 			 */
2585 			genpd->opp_table = dev_pm_opp_get_opp_table(&genpd->dev);
2586 			WARN_ON(IS_ERR(genpd->opp_table));
2587 		}
2588 
2589 		genpd->provider = &np->fwnode;
2590 		genpd->has_provider = true;
2591 	}
2592 
2593 	ret = genpd_add_provider(np, data->xlate, data);
2594 	if (ret < 0)
2595 		goto error;
2596 
2597 	return 0;
2598 
2599 error:
2600 	while (i--) {
2601 		genpd = data->domains[i];
2602 
2603 		if (!genpd)
2604 			continue;
2605 
2606 		genpd->provider = NULL;
2607 		genpd->has_provider = false;
2608 
2609 		if (!genpd_is_opp_table_fw(genpd) && genpd->set_performance_state) {
2610 			dev_pm_opp_put_opp_table(genpd->opp_table);
2611 			dev_pm_opp_of_remove_table(&genpd->dev);
2612 		}
2613 	}
2614 
2615 	return ret;
2616 }
2617 EXPORT_SYMBOL_GPL(of_genpd_add_provider_onecell);
2618 
2619 /**
2620  * of_genpd_del_provider() - Remove a previously registered PM domain provider
2621  * @np: Device node pointer associated with the PM domain provider
2622  */
2623 void of_genpd_del_provider(struct device_node *np)
2624 {
2625 	struct of_genpd_provider *cp, *tmp;
2626 	struct generic_pm_domain *gpd;
2627 
2628 	mutex_lock(&gpd_list_lock);
2629 	mutex_lock(&of_genpd_mutex);
2630 	list_for_each_entry_safe(cp, tmp, &of_genpd_providers, link) {
2631 		if (cp->node == np) {
2632 			/*
2633 			 * For each PM domain associated with the
2634 			 * provider, set the 'has_provider' to false
2635 			 * so that the PM domain can be safely removed.
2636 			 */
2637 			list_for_each_entry(gpd, &gpd_list, gpd_list_node) {
2638 				if (gpd->provider == &np->fwnode) {
2639 					gpd->has_provider = false;
2640 
2641 					if (genpd_is_opp_table_fw(gpd) || !gpd->set_performance_state)
2642 						continue;
2643 
2644 					dev_pm_opp_put_opp_table(gpd->opp_table);
2645 					dev_pm_opp_of_remove_table(&gpd->dev);
2646 				}
2647 			}
2648 
2649 			fwnode_dev_initialized(&cp->node->fwnode, false);
2650 			list_del(&cp->link);
2651 			of_node_put(cp->node);
2652 			kfree(cp);
2653 			break;
2654 		}
2655 	}
2656 	mutex_unlock(&of_genpd_mutex);
2657 	mutex_unlock(&gpd_list_lock);
2658 }
2659 EXPORT_SYMBOL_GPL(of_genpd_del_provider);
2660 
2661 /**
2662  * genpd_get_from_provider() - Look-up PM domain
2663  * @genpdspec: OF phandle args to use for look-up
2664  *
2665  * Looks for a PM domain provider under the node specified by @genpdspec and if
2666  * found, uses xlate function of the provider to map phandle args to a PM
2667  * domain.
2668  *
2669  * Returns a valid pointer to struct generic_pm_domain on success or ERR_PTR()
2670  * on failure.
2671  */
2672 static struct generic_pm_domain *genpd_get_from_provider(
2673 					const struct of_phandle_args *genpdspec)
2674 {
2675 	struct generic_pm_domain *genpd = ERR_PTR(-ENOENT);
2676 	struct of_genpd_provider *provider;
2677 
2678 	if (!genpdspec)
2679 		return ERR_PTR(-EINVAL);
2680 
2681 	mutex_lock(&of_genpd_mutex);
2682 
2683 	/* Check if we have such a provider in our array */
2684 	list_for_each_entry(provider, &of_genpd_providers, link) {
2685 		if (provider->node == genpdspec->np)
2686 			genpd = provider->xlate(genpdspec, provider->data);
2687 		if (!IS_ERR(genpd))
2688 			break;
2689 	}
2690 
2691 	mutex_unlock(&of_genpd_mutex);
2692 
2693 	return genpd;
2694 }
2695 
2696 /**
2697  * of_genpd_add_device() - Add a device to an I/O PM domain
2698  * @genpdspec: OF phandle args to use for look-up PM domain
2699  * @dev: Device to be added.
2700  *
2701  * Looks-up an I/O PM domain based upon phandle args provided and adds
2702  * the device to the PM domain. Returns a negative error code on failure.
2703  */
2704 int of_genpd_add_device(const struct of_phandle_args *genpdspec, struct device *dev)
2705 {
2706 	struct generic_pm_domain *genpd;
2707 	int ret;
2708 
2709 	if (!dev)
2710 		return -EINVAL;
2711 
2712 	mutex_lock(&gpd_list_lock);
2713 
2714 	genpd = genpd_get_from_provider(genpdspec);
2715 	if (IS_ERR(genpd)) {
2716 		ret = PTR_ERR(genpd);
2717 		goto out;
2718 	}
2719 
2720 	ret = genpd_add_device(genpd, dev, dev);
2721 
2722 out:
2723 	mutex_unlock(&gpd_list_lock);
2724 
2725 	return ret;
2726 }
2727 EXPORT_SYMBOL_GPL(of_genpd_add_device);
2728 
2729 /**
2730  * of_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
2731  * @parent_spec: OF phandle args to use for parent PM domain look-up
2732  * @subdomain_spec: OF phandle args to use for subdomain look-up
2733  *
2734  * Looks-up a parent PM domain and subdomain based upon phandle args
2735  * provided and adds the subdomain to the parent PM domain. Returns a
2736  * negative error code on failure.
2737  */
2738 int of_genpd_add_subdomain(const struct of_phandle_args *parent_spec,
2739 			   const struct of_phandle_args *subdomain_spec)
2740 {
2741 	struct generic_pm_domain *parent, *subdomain;
2742 	int ret;
2743 
2744 	mutex_lock(&gpd_list_lock);
2745 
2746 	parent = genpd_get_from_provider(parent_spec);
2747 	if (IS_ERR(parent)) {
2748 		ret = PTR_ERR(parent);
2749 		goto out;
2750 	}
2751 
2752 	subdomain = genpd_get_from_provider(subdomain_spec);
2753 	if (IS_ERR(subdomain)) {
2754 		ret = PTR_ERR(subdomain);
2755 		goto out;
2756 	}
2757 
2758 	ret = genpd_add_subdomain(parent, subdomain);
2759 
2760 out:
2761 	mutex_unlock(&gpd_list_lock);
2762 
2763 	return ret == -ENOENT ? -EPROBE_DEFER : ret;
2764 }
2765 EXPORT_SYMBOL_GPL(of_genpd_add_subdomain);
2766 
2767 /**
2768  * of_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
2769  * @parent_spec: OF phandle args to use for parent PM domain look-up
2770  * @subdomain_spec: OF phandle args to use for subdomain look-up
2771  *
2772  * Looks-up a parent PM domain and subdomain based upon phandle args
2773  * provided and removes the subdomain from the parent PM domain. Returns a
2774  * negative error code on failure.
2775  */
2776 int of_genpd_remove_subdomain(const struct of_phandle_args *parent_spec,
2777 			      const struct of_phandle_args *subdomain_spec)
2778 {
2779 	struct generic_pm_domain *parent, *subdomain;
2780 	int ret;
2781 
2782 	mutex_lock(&gpd_list_lock);
2783 
2784 	parent = genpd_get_from_provider(parent_spec);
2785 	if (IS_ERR(parent)) {
2786 		ret = PTR_ERR(parent);
2787 		goto out;
2788 	}
2789 
2790 	subdomain = genpd_get_from_provider(subdomain_spec);
2791 	if (IS_ERR(subdomain)) {
2792 		ret = PTR_ERR(subdomain);
2793 		goto out;
2794 	}
2795 
2796 	ret = pm_genpd_remove_subdomain(parent, subdomain);
2797 
2798 out:
2799 	mutex_unlock(&gpd_list_lock);
2800 
2801 	return ret;
2802 }
2803 EXPORT_SYMBOL_GPL(of_genpd_remove_subdomain);
2804 
2805 /**
2806  * of_genpd_remove_last - Remove the last PM domain registered for a provider
2807  * @np: Pointer to device node associated with provider
2808  *
2809  * Find the last PM domain that was added by a particular provider and
2810  * remove this PM domain from the list of PM domains. The provider is
2811  * identified by the 'provider' device structure that is passed. The PM
2812  * domain will only be removed, if the provider associated with domain
2813  * has been removed.
2814  *
2815  * Returns a valid pointer to struct generic_pm_domain on success or
2816  * ERR_PTR() on failure.
2817  */
2818 struct generic_pm_domain *of_genpd_remove_last(struct device_node *np)
2819 {
2820 	struct generic_pm_domain *gpd, *tmp, *genpd = ERR_PTR(-ENOENT);
2821 	int ret;
2822 
2823 	if (IS_ERR_OR_NULL(np))
2824 		return ERR_PTR(-EINVAL);
2825 
2826 	mutex_lock(&gpd_list_lock);
2827 	list_for_each_entry_safe(gpd, tmp, &gpd_list, gpd_list_node) {
2828 		if (gpd->provider == &np->fwnode) {
2829 			ret = genpd_remove(gpd);
2830 			genpd = ret ? ERR_PTR(ret) : gpd;
2831 			break;
2832 		}
2833 	}
2834 	mutex_unlock(&gpd_list_lock);
2835 
2836 	return genpd;
2837 }
2838 EXPORT_SYMBOL_GPL(of_genpd_remove_last);
2839 
2840 static void genpd_release_dev(struct device *dev)
2841 {
2842 	of_node_put(dev->of_node);
2843 	kfree(dev);
2844 }
2845 
2846 static const struct bus_type genpd_bus_type = {
2847 	.name		= "genpd",
2848 };
2849 
2850 /**
2851  * genpd_dev_pm_detach - Detach a device from its PM domain.
2852  * @dev: Device to detach.
2853  * @power_off: Currently not used
2854  *
2855  * Try to locate a corresponding generic PM domain, which the device was
2856  * attached to previously. If such is found, the device is detached from it.
2857  */
2858 static void genpd_dev_pm_detach(struct device *dev, bool power_off)
2859 {
2860 	struct generic_pm_domain *pd;
2861 	unsigned int i;
2862 	int ret = 0;
2863 
2864 	pd = dev_to_genpd(dev);
2865 	if (IS_ERR(pd))
2866 		return;
2867 
2868 	dev_dbg(dev, "removing from PM domain %s\n", pd->name);
2869 
2870 	/* Drop the default performance state */
2871 	if (dev_gpd_data(dev)->default_pstate) {
2872 		dev_pm_genpd_set_performance_state(dev, 0);
2873 		dev_gpd_data(dev)->default_pstate = 0;
2874 	}
2875 
2876 	for (i = 1; i < GENPD_RETRY_MAX_MS; i <<= 1) {
2877 		ret = genpd_remove_device(pd, dev);
2878 		if (ret != -EAGAIN)
2879 			break;
2880 
2881 		mdelay(i);
2882 		cond_resched();
2883 	}
2884 
2885 	if (ret < 0) {
2886 		dev_err(dev, "failed to remove from PM domain %s: %d",
2887 			pd->name, ret);
2888 		return;
2889 	}
2890 
2891 	/* Check if PM domain can be powered off after removing this device. */
2892 	genpd_queue_power_off_work(pd);
2893 
2894 	/* Unregister the device if it was created by genpd. */
2895 	if (dev->bus == &genpd_bus_type)
2896 		device_unregister(dev);
2897 }
2898 
2899 static void genpd_dev_pm_sync(struct device *dev)
2900 {
2901 	struct generic_pm_domain *pd;
2902 
2903 	pd = dev_to_genpd(dev);
2904 	if (IS_ERR(pd))
2905 		return;
2906 
2907 	genpd_queue_power_off_work(pd);
2908 }
2909 
2910 static int genpd_set_required_opp_dev(struct device *dev,
2911 				      struct device *base_dev)
2912 {
2913 	struct dev_pm_opp_config config = {
2914 		.required_dev = dev,
2915 	};
2916 	int ret;
2917 
2918 	/* Limit support to non-providers for now. */
2919 	if (of_property_present(base_dev->of_node, "#power-domain-cells"))
2920 		return 0;
2921 
2922 	if (!dev_pm_opp_of_has_required_opp(base_dev))
2923 		return 0;
2924 
2925 	ret = dev_pm_opp_set_config(base_dev, &config);
2926 	if (ret < 0)
2927 		return ret;
2928 
2929 	dev_gpd_data(dev)->opp_token = ret;
2930 	return 0;
2931 }
2932 
2933 static int genpd_set_required_opp(struct device *dev, unsigned int index)
2934 {
2935 	int ret, pstate;
2936 
2937 	/* Set the default performance state */
2938 	pstate = of_get_required_opp_performance_state(dev->of_node, index);
2939 	if (pstate < 0 && pstate != -ENODEV && pstate != -EOPNOTSUPP) {
2940 		ret = pstate;
2941 		goto err;
2942 	} else if (pstate > 0) {
2943 		ret = dev_pm_genpd_set_performance_state(dev, pstate);
2944 		if (ret)
2945 			goto err;
2946 		dev_gpd_data(dev)->default_pstate = pstate;
2947 	}
2948 
2949 	return 0;
2950 err:
2951 	dev_err(dev, "failed to set required performance state for power-domain %s: %d\n",
2952 		dev_to_genpd(dev)->name, ret);
2953 	return ret;
2954 }
2955 
2956 static int __genpd_dev_pm_attach(struct device *dev, struct device *base_dev,
2957 				 unsigned int index, unsigned int num_domains,
2958 				 bool power_on)
2959 {
2960 	struct of_phandle_args pd_args;
2961 	struct generic_pm_domain *pd;
2962 	int ret;
2963 
2964 	ret = of_parse_phandle_with_args(dev->of_node, "power-domains",
2965 				"#power-domain-cells", index, &pd_args);
2966 	if (ret < 0)
2967 		return ret;
2968 
2969 	mutex_lock(&gpd_list_lock);
2970 	pd = genpd_get_from_provider(&pd_args);
2971 	of_node_put(pd_args.np);
2972 	if (IS_ERR(pd)) {
2973 		mutex_unlock(&gpd_list_lock);
2974 		dev_dbg(dev, "%s() failed to find PM domain: %ld\n",
2975 			__func__, PTR_ERR(pd));
2976 		return driver_deferred_probe_check_state(base_dev);
2977 	}
2978 
2979 	dev_dbg(dev, "adding to PM domain %s\n", pd->name);
2980 
2981 	ret = genpd_add_device(pd, dev, base_dev);
2982 	mutex_unlock(&gpd_list_lock);
2983 
2984 	if (ret < 0)
2985 		return dev_err_probe(dev, ret, "failed to add to PM domain %s\n", pd->name);
2986 
2987 	dev->pm_domain->detach = genpd_dev_pm_detach;
2988 	dev->pm_domain->sync = genpd_dev_pm_sync;
2989 
2990 	/*
2991 	 * For a single PM domain the index of the required OPP must be zero, so
2992 	 * let's try to assign a required dev in that case. In the multiple PM
2993 	 * domains case, we need platform code to specify the index.
2994 	 */
2995 	if (num_domains == 1) {
2996 		ret = genpd_set_required_opp_dev(dev, base_dev);
2997 		if (ret)
2998 			goto err;
2999 	}
3000 
3001 	ret = genpd_set_required_opp(dev, index);
3002 	if (ret)
3003 		goto err;
3004 
3005 	if (power_on) {
3006 		genpd_lock(pd);
3007 		ret = genpd_power_on(pd, 0);
3008 		genpd_unlock(pd);
3009 	}
3010 
3011 	if (ret) {
3012 		/* Drop the default performance state */
3013 		if (dev_gpd_data(dev)->default_pstate) {
3014 			dev_pm_genpd_set_performance_state(dev, 0);
3015 			dev_gpd_data(dev)->default_pstate = 0;
3016 		}
3017 
3018 		genpd_remove_device(pd, dev);
3019 		return -EPROBE_DEFER;
3020 	}
3021 
3022 	return 1;
3023 
3024 err:
3025 	genpd_remove_device(pd, dev);
3026 	return ret;
3027 }
3028 
3029 /**
3030  * genpd_dev_pm_attach - Attach a device to its PM domain using DT.
3031  * @dev: Device to attach.
3032  *
3033  * Parse device's OF node to find a PM domain specifier. If such is found,
3034  * attaches the device to retrieved pm_domain ops.
3035  *
3036  * Returns 1 on successfully attached PM domain, 0 when the device don't need a
3037  * PM domain or when multiple power-domains exists for it, else a negative error
3038  * code. Note that if a power-domain exists for the device, but it cannot be
3039  * found or turned on, then return -EPROBE_DEFER to ensure that the device is
3040  * not probed and to re-try again later.
3041  */
3042 int genpd_dev_pm_attach(struct device *dev)
3043 {
3044 	if (!dev->of_node)
3045 		return 0;
3046 
3047 	/*
3048 	 * Devices with multiple PM domains must be attached separately, as we
3049 	 * can only attach one PM domain per device.
3050 	 */
3051 	if (of_count_phandle_with_args(dev->of_node, "power-domains",
3052 				       "#power-domain-cells") != 1)
3053 		return 0;
3054 
3055 	return __genpd_dev_pm_attach(dev, dev, 0, 1, true);
3056 }
3057 EXPORT_SYMBOL_GPL(genpd_dev_pm_attach);
3058 
3059 /**
3060  * genpd_dev_pm_attach_by_id - Associate a device with one of its PM domains.
3061  * @dev: The device used to lookup the PM domain.
3062  * @index: The index of the PM domain.
3063  *
3064  * Parse device's OF node to find a PM domain specifier at the provided @index.
3065  * If such is found, creates a virtual device and attaches it to the retrieved
3066  * pm_domain ops. To deal with detaching of the virtual device, the ->detach()
3067  * callback in the struct dev_pm_domain are assigned to genpd_dev_pm_detach().
3068  *
3069  * Returns the created virtual device if successfully attached PM domain, NULL
3070  * when the device don't need a PM domain, else an ERR_PTR() in case of
3071  * failures. If a power-domain exists for the device, but cannot be found or
3072  * turned on, then ERR_PTR(-EPROBE_DEFER) is returned to ensure that the device
3073  * is not probed and to re-try again later.
3074  */
3075 struct device *genpd_dev_pm_attach_by_id(struct device *dev,
3076 					 unsigned int index)
3077 {
3078 	struct device *virt_dev;
3079 	int num_domains;
3080 	int ret;
3081 
3082 	if (!dev->of_node)
3083 		return NULL;
3084 
3085 	/* Verify that the index is within a valid range. */
3086 	num_domains = of_count_phandle_with_args(dev->of_node, "power-domains",
3087 						 "#power-domain-cells");
3088 	if (index >= num_domains)
3089 		return NULL;
3090 
3091 	/* Allocate and register device on the genpd bus. */
3092 	virt_dev = kzalloc(sizeof(*virt_dev), GFP_KERNEL);
3093 	if (!virt_dev)
3094 		return ERR_PTR(-ENOMEM);
3095 
3096 	dev_set_name(virt_dev, "genpd:%u:%s", index, dev_name(dev));
3097 	virt_dev->bus = &genpd_bus_type;
3098 	virt_dev->release = genpd_release_dev;
3099 	virt_dev->of_node = of_node_get(dev->of_node);
3100 
3101 	ret = device_register(virt_dev);
3102 	if (ret) {
3103 		put_device(virt_dev);
3104 		return ERR_PTR(ret);
3105 	}
3106 
3107 	/* Try to attach the device to the PM domain at the specified index. */
3108 	ret = __genpd_dev_pm_attach(virt_dev, dev, index, num_domains, false);
3109 	if (ret < 1) {
3110 		device_unregister(virt_dev);
3111 		return ret ? ERR_PTR(ret) : NULL;
3112 	}
3113 
3114 	pm_runtime_enable(virt_dev);
3115 	genpd_queue_power_off_work(dev_to_genpd(virt_dev));
3116 
3117 	return virt_dev;
3118 }
3119 EXPORT_SYMBOL_GPL(genpd_dev_pm_attach_by_id);
3120 
3121 /**
3122  * genpd_dev_pm_attach_by_name - Associate a device with one of its PM domains.
3123  * @dev: The device used to lookup the PM domain.
3124  * @name: The name of the PM domain.
3125  *
3126  * Parse device's OF node to find a PM domain specifier using the
3127  * power-domain-names DT property. For further description see
3128  * genpd_dev_pm_attach_by_id().
3129  */
3130 struct device *genpd_dev_pm_attach_by_name(struct device *dev, const char *name)
3131 {
3132 	int index;
3133 
3134 	if (!dev->of_node)
3135 		return NULL;
3136 
3137 	index = of_property_match_string(dev->of_node, "power-domain-names",
3138 					 name);
3139 	if (index < 0)
3140 		return NULL;
3141 
3142 	return genpd_dev_pm_attach_by_id(dev, index);
3143 }
3144 
3145 static const struct of_device_id idle_state_match[] = {
3146 	{ .compatible = "domain-idle-state", },
3147 	{ }
3148 };
3149 
3150 static int genpd_parse_state(struct genpd_power_state *genpd_state,
3151 				    struct device_node *state_node)
3152 {
3153 	int err;
3154 	u32 residency;
3155 	u32 entry_latency, exit_latency;
3156 
3157 	err = of_property_read_u32(state_node, "entry-latency-us",
3158 						&entry_latency);
3159 	if (err) {
3160 		pr_debug(" * %pOF missing entry-latency-us property\n",
3161 			 state_node);
3162 		return -EINVAL;
3163 	}
3164 
3165 	err = of_property_read_u32(state_node, "exit-latency-us",
3166 						&exit_latency);
3167 	if (err) {
3168 		pr_debug(" * %pOF missing exit-latency-us property\n",
3169 			 state_node);
3170 		return -EINVAL;
3171 	}
3172 
3173 	err = of_property_read_u32(state_node, "min-residency-us", &residency);
3174 	if (!err)
3175 		genpd_state->residency_ns = 1000LL * residency;
3176 
3177 	genpd_state->power_on_latency_ns = 1000LL * exit_latency;
3178 	genpd_state->power_off_latency_ns = 1000LL * entry_latency;
3179 	genpd_state->fwnode = &state_node->fwnode;
3180 
3181 	return 0;
3182 }
3183 
3184 static int genpd_iterate_idle_states(struct device_node *dn,
3185 				     struct genpd_power_state *states)
3186 {
3187 	int ret;
3188 	struct of_phandle_iterator it;
3189 	struct device_node *np;
3190 	int i = 0;
3191 
3192 	ret = of_count_phandle_with_args(dn, "domain-idle-states", NULL);
3193 	if (ret <= 0)
3194 		return ret == -ENOENT ? 0 : ret;
3195 
3196 	/* Loop over the phandles until all the requested entry is found */
3197 	of_for_each_phandle(&it, ret, dn, "domain-idle-states", NULL, 0) {
3198 		np = it.node;
3199 		if (!of_match_node(idle_state_match, np))
3200 			continue;
3201 
3202 		if (!of_device_is_available(np))
3203 			continue;
3204 
3205 		if (states) {
3206 			ret = genpd_parse_state(&states[i], np);
3207 			if (ret) {
3208 				pr_err("Parsing idle state node %pOF failed with err %d\n",
3209 				       np, ret);
3210 				of_node_put(np);
3211 				return ret;
3212 			}
3213 		}
3214 		i++;
3215 	}
3216 
3217 	return i;
3218 }
3219 
3220 /**
3221  * of_genpd_parse_idle_states: Return array of idle states for the genpd.
3222  *
3223  * @dn: The genpd device node
3224  * @states: The pointer to which the state array will be saved.
3225  * @n: The count of elements in the array returned from this function.
3226  *
3227  * Returns the device states parsed from the OF node. The memory for the states
3228  * is allocated by this function and is the responsibility of the caller to
3229  * free the memory after use. If any or zero compatible domain idle states is
3230  * found it returns 0 and in case of errors, a negative error code is returned.
3231  */
3232 int of_genpd_parse_idle_states(struct device_node *dn,
3233 			struct genpd_power_state **states, int *n)
3234 {
3235 	struct genpd_power_state *st;
3236 	int ret;
3237 
3238 	ret = genpd_iterate_idle_states(dn, NULL);
3239 	if (ret < 0)
3240 		return ret;
3241 
3242 	if (!ret) {
3243 		*states = NULL;
3244 		*n = 0;
3245 		return 0;
3246 	}
3247 
3248 	st = kcalloc(ret, sizeof(*st), GFP_KERNEL);
3249 	if (!st)
3250 		return -ENOMEM;
3251 
3252 	ret = genpd_iterate_idle_states(dn, st);
3253 	if (ret <= 0) {
3254 		kfree(st);
3255 		return ret < 0 ? ret : -EINVAL;
3256 	}
3257 
3258 	*states = st;
3259 	*n = ret;
3260 
3261 	return 0;
3262 }
3263 EXPORT_SYMBOL_GPL(of_genpd_parse_idle_states);
3264 
3265 static int __init genpd_bus_init(void)
3266 {
3267 	return bus_register(&genpd_bus_type);
3268 }
3269 core_initcall(genpd_bus_init);
3270 
3271 #endif /* CONFIG_PM_GENERIC_DOMAINS_OF */
3272 
3273 
3274 /***        debugfs support        ***/
3275 
3276 #ifdef CONFIG_DEBUG_FS
3277 /*
3278  * TODO: This function is a slightly modified version of rtpm_status_show
3279  * from sysfs.c, so generalize it.
3280  */
3281 static void rtpm_status_str(struct seq_file *s, struct device *dev)
3282 {
3283 	static const char * const status_lookup[] = {
3284 		[RPM_ACTIVE] = "active",
3285 		[RPM_RESUMING] = "resuming",
3286 		[RPM_SUSPENDED] = "suspended",
3287 		[RPM_SUSPENDING] = "suspending"
3288 	};
3289 	const char *p = "";
3290 
3291 	if (dev->power.runtime_error)
3292 		p = "error";
3293 	else if (dev->power.disable_depth)
3294 		p = "unsupported";
3295 	else if (dev->power.runtime_status < ARRAY_SIZE(status_lookup))
3296 		p = status_lookup[dev->power.runtime_status];
3297 	else
3298 		WARN_ON(1);
3299 
3300 	seq_printf(s, "%-26s  ", p);
3301 }
3302 
3303 static void perf_status_str(struct seq_file *s, struct device *dev)
3304 {
3305 	struct generic_pm_domain_data *gpd_data;
3306 
3307 	gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
3308 
3309 	seq_printf(s, "%-10u  ", gpd_data->performance_state);
3310 }
3311 
3312 static void mode_status_str(struct seq_file *s, struct device *dev)
3313 {
3314 	struct generic_pm_domain_data *gpd_data;
3315 
3316 	gpd_data = to_gpd_data(dev->power.subsys_data->domain_data);
3317 
3318 	seq_printf(s, "%2s", gpd_data->hw_mode ? "HW" : "SW");
3319 }
3320 
3321 static int genpd_summary_one(struct seq_file *s,
3322 			struct generic_pm_domain *genpd)
3323 {
3324 	static const char * const status_lookup[] = {
3325 		[GENPD_STATE_ON] = "on",
3326 		[GENPD_STATE_OFF] = "off"
3327 	};
3328 	struct pm_domain_data *pm_data;
3329 	struct gpd_link *link;
3330 	char state[16];
3331 	int ret;
3332 
3333 	ret = genpd_lock_interruptible(genpd);
3334 	if (ret)
3335 		return -ERESTARTSYS;
3336 
3337 	if (WARN_ON(genpd->status >= ARRAY_SIZE(status_lookup)))
3338 		goto exit;
3339 	if (!genpd_status_on(genpd))
3340 		snprintf(state, sizeof(state), "%s-%u",
3341 			 status_lookup[genpd->status], genpd->state_idx);
3342 	else
3343 		snprintf(state, sizeof(state), "%s",
3344 			 status_lookup[genpd->status]);
3345 	seq_printf(s, "%-30s  %-30s  %u", dev_name(&genpd->dev), state, genpd->performance_state);
3346 
3347 	/*
3348 	 * Modifications on the list require holding locks on both
3349 	 * parent and child, so we are safe.
3350 	 * Also the device name is immutable.
3351 	 */
3352 	list_for_each_entry(link, &genpd->parent_links, parent_node) {
3353 		if (list_is_first(&link->parent_node, &genpd->parent_links))
3354 			seq_printf(s, "\n%48s", " ");
3355 		seq_printf(s, "%s", link->child->name);
3356 		if (!list_is_last(&link->parent_node, &genpd->parent_links))
3357 			seq_puts(s, ", ");
3358 	}
3359 
3360 	list_for_each_entry(pm_data, &genpd->dev_list, list_node) {
3361 		seq_printf(s, "\n    %-30s  ", dev_name(pm_data->dev));
3362 		rtpm_status_str(s, pm_data->dev);
3363 		perf_status_str(s, pm_data->dev);
3364 		mode_status_str(s, pm_data->dev);
3365 	}
3366 
3367 	seq_puts(s, "\n");
3368 exit:
3369 	genpd_unlock(genpd);
3370 
3371 	return 0;
3372 }
3373 
3374 static int summary_show(struct seq_file *s, void *data)
3375 {
3376 	struct generic_pm_domain *genpd;
3377 	int ret = 0;
3378 
3379 	seq_puts(s, "domain                          status          children        performance\n");
3380 	seq_puts(s, "    /device                         runtime status                  managed by\n");
3381 	seq_puts(s, "------------------------------------------------------------------------------\n");
3382 
3383 	ret = mutex_lock_interruptible(&gpd_list_lock);
3384 	if (ret)
3385 		return -ERESTARTSYS;
3386 
3387 	list_for_each_entry(genpd, &gpd_list, gpd_list_node) {
3388 		ret = genpd_summary_one(s, genpd);
3389 		if (ret)
3390 			break;
3391 	}
3392 	mutex_unlock(&gpd_list_lock);
3393 
3394 	return ret;
3395 }
3396 
3397 static int status_show(struct seq_file *s, void *data)
3398 {
3399 	static const char * const status_lookup[] = {
3400 		[GENPD_STATE_ON] = "on",
3401 		[GENPD_STATE_OFF] = "off"
3402 	};
3403 
3404 	struct generic_pm_domain *genpd = s->private;
3405 	int ret = 0;
3406 
3407 	ret = genpd_lock_interruptible(genpd);
3408 	if (ret)
3409 		return -ERESTARTSYS;
3410 
3411 	if (WARN_ON_ONCE(genpd->status >= ARRAY_SIZE(status_lookup)))
3412 		goto exit;
3413 
3414 	if (genpd->status == GENPD_STATE_OFF)
3415 		seq_printf(s, "%s-%u\n", status_lookup[genpd->status],
3416 			genpd->state_idx);
3417 	else
3418 		seq_printf(s, "%s\n", status_lookup[genpd->status]);
3419 exit:
3420 	genpd_unlock(genpd);
3421 	return ret;
3422 }
3423 
3424 static int sub_domains_show(struct seq_file *s, void *data)
3425 {
3426 	struct generic_pm_domain *genpd = s->private;
3427 	struct gpd_link *link;
3428 	int ret = 0;
3429 
3430 	ret = genpd_lock_interruptible(genpd);
3431 	if (ret)
3432 		return -ERESTARTSYS;
3433 
3434 	list_for_each_entry(link, &genpd->parent_links, parent_node)
3435 		seq_printf(s, "%s\n", link->child->name);
3436 
3437 	genpd_unlock(genpd);
3438 	return ret;
3439 }
3440 
3441 static int idle_states_show(struct seq_file *s, void *data)
3442 {
3443 	struct generic_pm_domain *genpd = s->private;
3444 	u64 now, delta, idle_time = 0;
3445 	unsigned int i;
3446 	int ret = 0;
3447 
3448 	ret = genpd_lock_interruptible(genpd);
3449 	if (ret)
3450 		return -ERESTARTSYS;
3451 
3452 	seq_puts(s, "State          Time Spent(ms) Usage          Rejected\n");
3453 
3454 	for (i = 0; i < genpd->state_count; i++) {
3455 		idle_time += genpd->states[i].idle_time;
3456 
3457 		if (genpd->status == GENPD_STATE_OFF && genpd->state_idx == i) {
3458 			now = ktime_get_mono_fast_ns();
3459 			if (now > genpd->accounting_time) {
3460 				delta = now - genpd->accounting_time;
3461 				idle_time += delta;
3462 			}
3463 		}
3464 
3465 		do_div(idle_time, NSEC_PER_MSEC);
3466 		seq_printf(s, "S%-13i %-14llu %-14llu %llu\n", i, idle_time,
3467 			   genpd->states[i].usage, genpd->states[i].rejected);
3468 	}
3469 
3470 	genpd_unlock(genpd);
3471 	return ret;
3472 }
3473 
3474 static int active_time_show(struct seq_file *s, void *data)
3475 {
3476 	struct generic_pm_domain *genpd = s->private;
3477 	u64 now, on_time, delta = 0;
3478 	int ret = 0;
3479 
3480 	ret = genpd_lock_interruptible(genpd);
3481 	if (ret)
3482 		return -ERESTARTSYS;
3483 
3484 	if (genpd->status == GENPD_STATE_ON) {
3485 		now = ktime_get_mono_fast_ns();
3486 		if (now > genpd->accounting_time)
3487 			delta = now - genpd->accounting_time;
3488 	}
3489 
3490 	on_time = genpd->on_time + delta;
3491 	do_div(on_time, NSEC_PER_MSEC);
3492 	seq_printf(s, "%llu ms\n", on_time);
3493 
3494 	genpd_unlock(genpd);
3495 	return ret;
3496 }
3497 
3498 static int total_idle_time_show(struct seq_file *s, void *data)
3499 {
3500 	struct generic_pm_domain *genpd = s->private;
3501 	u64 now, delta, total = 0;
3502 	unsigned int i;
3503 	int ret = 0;
3504 
3505 	ret = genpd_lock_interruptible(genpd);
3506 	if (ret)
3507 		return -ERESTARTSYS;
3508 
3509 	for (i = 0; i < genpd->state_count; i++) {
3510 		total += genpd->states[i].idle_time;
3511 
3512 		if (genpd->status == GENPD_STATE_OFF && genpd->state_idx == i) {
3513 			now = ktime_get_mono_fast_ns();
3514 			if (now > genpd->accounting_time) {
3515 				delta = now - genpd->accounting_time;
3516 				total += delta;
3517 			}
3518 		}
3519 	}
3520 
3521 	do_div(total, NSEC_PER_MSEC);
3522 	seq_printf(s, "%llu ms\n", total);
3523 
3524 	genpd_unlock(genpd);
3525 	return ret;
3526 }
3527 
3528 
3529 static int devices_show(struct seq_file *s, void *data)
3530 {
3531 	struct generic_pm_domain *genpd = s->private;
3532 	struct pm_domain_data *pm_data;
3533 	int ret = 0;
3534 
3535 	ret = genpd_lock_interruptible(genpd);
3536 	if (ret)
3537 		return -ERESTARTSYS;
3538 
3539 	list_for_each_entry(pm_data, &genpd->dev_list, list_node)
3540 		seq_printf(s, "%s\n", dev_name(pm_data->dev));
3541 
3542 	genpd_unlock(genpd);
3543 	return ret;
3544 }
3545 
3546 static int perf_state_show(struct seq_file *s, void *data)
3547 {
3548 	struct generic_pm_domain *genpd = s->private;
3549 
3550 	if (genpd_lock_interruptible(genpd))
3551 		return -ERESTARTSYS;
3552 
3553 	seq_printf(s, "%u\n", genpd->performance_state);
3554 
3555 	genpd_unlock(genpd);
3556 	return 0;
3557 }
3558 
3559 DEFINE_SHOW_ATTRIBUTE(summary);
3560 DEFINE_SHOW_ATTRIBUTE(status);
3561 DEFINE_SHOW_ATTRIBUTE(sub_domains);
3562 DEFINE_SHOW_ATTRIBUTE(idle_states);
3563 DEFINE_SHOW_ATTRIBUTE(active_time);
3564 DEFINE_SHOW_ATTRIBUTE(total_idle_time);
3565 DEFINE_SHOW_ATTRIBUTE(devices);
3566 DEFINE_SHOW_ATTRIBUTE(perf_state);
3567 
3568 static void genpd_debug_add(struct generic_pm_domain *genpd)
3569 {
3570 	struct dentry *d;
3571 
3572 	if (!genpd_debugfs_dir)
3573 		return;
3574 
3575 	d = debugfs_create_dir(dev_name(&genpd->dev), genpd_debugfs_dir);
3576 
3577 	debugfs_create_file("current_state", 0444,
3578 			    d, genpd, &status_fops);
3579 	debugfs_create_file("sub_domains", 0444,
3580 			    d, genpd, &sub_domains_fops);
3581 	debugfs_create_file("idle_states", 0444,
3582 			    d, genpd, &idle_states_fops);
3583 	debugfs_create_file("active_time", 0444,
3584 			    d, genpd, &active_time_fops);
3585 	debugfs_create_file("total_idle_time", 0444,
3586 			    d, genpd, &total_idle_time_fops);
3587 	debugfs_create_file("devices", 0444,
3588 			    d, genpd, &devices_fops);
3589 	if (genpd->set_performance_state)
3590 		debugfs_create_file("perf_state", 0444,
3591 				    d, genpd, &perf_state_fops);
3592 }
3593 
3594 static int __init genpd_debug_init(void)
3595 {
3596 	struct generic_pm_domain *genpd;
3597 
3598 	genpd_debugfs_dir = debugfs_create_dir("pm_genpd", NULL);
3599 
3600 	debugfs_create_file("pm_genpd_summary", S_IRUGO, genpd_debugfs_dir,
3601 			    NULL, &summary_fops);
3602 
3603 	list_for_each_entry(genpd, &gpd_list, gpd_list_node)
3604 		genpd_debug_add(genpd);
3605 
3606 	return 0;
3607 }
3608 late_initcall(genpd_debug_init);
3609 
3610 static void __exit genpd_debug_exit(void)
3611 {
3612 	debugfs_remove_recursive(genpd_debugfs_dir);
3613 }
3614 __exitcall(genpd_debug_exit);
3615 #endif /* CONFIG_DEBUG_FS */
3616