Lines Matching +full:power +full:- +full:domain
1 // SPDX-License-Identifier: GPL-2.0
3 * drivers/base/power/domain.c - Common code related to device power domains.
26 #include "power.h"
35 __routine = genpd->dev_ops.callback; \
54 mutex_lock(&genpd->mlock); in genpd_lock_mtx()
60 mutex_lock_nested(&genpd->mlock, depth); in genpd_lock_nested_mtx()
65 return mutex_lock_interruptible(&genpd->mlock); in genpd_lock_interruptible_mtx()
70 return mutex_unlock(&genpd->mlock); in genpd_unlock_mtx()
81 __acquires(&genpd->slock) in genpd_lock_spin()
85 spin_lock_irqsave(&genpd->slock, flags); in genpd_lock_spin()
86 genpd->lock_flags = flags; in genpd_lock_spin()
91 __acquires(&genpd->slock) in genpd_lock_nested_spin()
95 spin_lock_irqsave_nested(&genpd->slock, flags, depth); in genpd_lock_nested_spin()
96 genpd->lock_flags = flags; in genpd_lock_nested_spin()
100 __acquires(&genpd->slock) in genpd_lock_interruptible_spin()
104 spin_lock_irqsave(&genpd->slock, flags); in genpd_lock_interruptible_spin()
105 genpd->lock_flags = flags; in genpd_lock_interruptible_spin()
110 __releases(&genpd->slock) in genpd_unlock_spin()
112 spin_unlock_irqrestore(&genpd->slock, genpd->lock_flags); in genpd_unlock_spin()
122 #define genpd_lock(p) p->lock_ops->lock(p)
123 #define genpd_lock_nested(p, d) p->lock_ops->lock_nested(p, d)
124 #define genpd_lock_interruptible(p) p->lock_ops->lock_interruptible(p)
125 #define genpd_unlock(p) p->lock_ops->unlock(p)
127 #define genpd_status_on(genpd) (genpd->status == GENPD_STATE_ON)
128 #define genpd_is_irq_safe(genpd) (genpd->flags & GENPD_FLAG_IRQ_SAFE)
129 #define genpd_is_always_on(genpd) (genpd->flags & GENPD_FLAG_ALWAYS_ON)
130 #define genpd_is_active_wakeup(genpd) (genpd->flags & GENPD_FLAG_ACTIVE_WAKEUP)
131 #define genpd_is_cpu_domain(genpd) (genpd->flags & GENPD_FLAG_CPU_DOMAIN)
132 #define genpd_is_rpm_always_on(genpd) (genpd->flags & GENPD_FLAG_RPM_ALWAYS_ON)
142 * Warn once if an IRQ safe device is attached to a domain, which in irq_safe_dev_in_sleep_domain()
144 * configuration for PM, but it doesn't matter for an always on domain. in irq_safe_dev_in_sleep_domain()
150 dev_warn_once(dev, "PM domain %s will not be powered off\n", in irq_safe_dev_in_sleep_domain()
151 genpd->name); in irq_safe_dev_in_sleep_domain()
159 * Get the generic PM domain for a particular struct device.
160 * This validates the struct device pointer, the PM domain pointer,
161 * and checks that the PM domain pointer is a real generic PM domain.
166 if (IS_ERR_OR_NULL(dev) || IS_ERR_OR_NULL(dev->pm_domain)) in dev_to_genpd_safe()
169 /* A genpd's always have its ->runtime_suspend() callback assigned. */ in dev_to_genpd_safe()
170 if (dev->pm_domain->ops.runtime_suspend == genpd_runtime_suspend) in dev_to_genpd_safe()
171 return pd_to_genpd(dev->pm_domain); in dev_to_genpd_safe()
178 * attached to the device is a genpd domain.
182 if (IS_ERR_OR_NULL(dev->pm_domain)) in dev_to_genpd()
183 return ERR_PTR(-EINVAL); in dev_to_genpd()
185 return pd_to_genpd(dev->pm_domain); in dev_to_genpd()
204 if (!WARN_ON(atomic_read(&genpd->sd_count) == 0)) in genpd_sd_counter_dec()
205 ret = !!atomic_dec_and_test(&genpd->sd_count); in genpd_sd_counter_dec()
212 atomic_inc(&genpd->sd_count); in genpd_sd_counter_inc()
226 debugfs_lookup_and_remove(genpd->name, genpd_debugfs_dir); in genpd_debug_remove()
234 if (now <= genpd->accounting_time) in genpd_update_accounting()
237 delta = now - genpd->accounting_time; in genpd_update_accounting()
240 * If genpd->status is active, it means we are just in genpd_update_accounting()
244 if (genpd->status == GENPD_STATE_ON) in genpd_update_accounting()
245 genpd->states[genpd->state_idx].idle_time += delta; in genpd_update_accounting()
247 genpd->on_time += delta; in genpd_update_accounting()
249 genpd->accounting_time = now; in genpd_update_accounting()
265 if (state == genpd->performance_state) in _genpd_reeval_performance_state()
269 if (state > genpd->performance_state) in _genpd_reeval_performance_state()
272 /* Traverse all devices within the domain */ in _genpd_reeval_performance_state()
273 list_for_each_entry(pdd, &genpd->dev_list, list_node) { in _genpd_reeval_performance_state()
276 if (pd_data->performance_state > state) in _genpd_reeval_performance_state()
277 state = pd_data->performance_state; in _genpd_reeval_performance_state()
281 * Traverse all sub-domains within the domain. This can be in _genpd_reeval_performance_state()
282 * done without any additional locking as the link->performance_state in _genpd_reeval_performance_state()
283 * field is protected by the parent genpd->lock, which is already taken. in _genpd_reeval_performance_state()
285 * Also note that link->performance_state (subdomain's performance state in _genpd_reeval_performance_state()
286 * requirement to parent domain) is different from in _genpd_reeval_performance_state()
287 * link->child->performance_state (current performance state requirement in _genpd_reeval_performance_state()
288 * of the devices/sub-domains of the subdomain) and so can have a in _genpd_reeval_performance_state()
291 * Note that we also take vote from powered-off sub-domains into account in _genpd_reeval_performance_state()
294 list_for_each_entry(link, &genpd->parent_links, parent_node) { in _genpd_reeval_performance_state()
295 if (link->performance_state > state) in _genpd_reeval_performance_state()
296 state = link->performance_state; in _genpd_reeval_performance_state()
306 if (!parent->set_performance_state) in genpd_xlate_performance_state()
309 return dev_pm_opp_xlate_performance_state(genpd->opp_table, in genpd_xlate_performance_state()
310 parent->opp_table, in genpd_xlate_performance_state()
321 if (state == genpd->performance_state) in _genpd_set_performance_state()
325 list_for_each_entry(link, &genpd->child_links, child_node) { in _genpd_set_performance_state()
326 parent = link->parent; in _genpd_set_performance_state()
337 link->prev_performance_state = link->performance_state; in _genpd_set_performance_state()
338 link->performance_state = parent_state; in _genpd_set_performance_state()
343 link->performance_state = link->prev_performance_state; in _genpd_set_performance_state()
351 if (genpd->set_performance_state) { in _genpd_set_performance_state()
352 ret = genpd->set_performance_state(genpd, state); in _genpd_set_performance_state()
357 genpd->performance_state = state; in _genpd_set_performance_state()
362 list_for_each_entry_continue_reverse(link, &genpd->child_links, in _genpd_set_performance_state()
364 parent = link->parent; in _genpd_set_performance_state()
368 parent_state = link->prev_performance_state; in _genpd_set_performance_state()
369 link->performance_state = parent_state; in _genpd_set_performance_state()
375 parent->name, parent_state); in _genpd_set_performance_state()
391 prev_state = gpd_data->performance_state; in genpd_set_performance_state()
395 gpd_data->performance_state = state; in genpd_set_performance_state()
400 gpd_data->performance_state = prev_state; in genpd_set_performance_state()
407 unsigned int prev_state = dev_gpd_data(dev)->performance_state; in genpd_drop_performance_state()
423 * dev_pm_genpd_set_performance_state- Set performance state of device's power
424 * domain.
426 * @dev: Device for which the performance-state needs to be set.
444 return -ENODEV; in dev_pm_genpd_set_performance_state()
446 if (WARN_ON(!dev->power.subsys_data || in dev_pm_genpd_set_performance_state()
447 !dev->power.subsys_data->domain_data)) in dev_pm_genpd_set_performance_state()
448 return -EINVAL; in dev_pm_genpd_set_performance_state()
452 dev_gpd_data(dev)->rpm_pstate = state; in dev_pm_genpd_set_performance_state()
456 dev_gpd_data(dev)->rpm_pstate = 0; in dev_pm_genpd_set_performance_state()
465 * dev_pm_genpd_set_next_wakeup - Notify PM framework of an impending wakeup.
477 * about that, so stale @next will be ignored when powering off the domain.
488 td = to_gpd_data(dev->power.subsys_data->domain_data)->td; in dev_pm_genpd_set_next_wakeup()
490 td->next_wakeup = next; in dev_pm_genpd_set_next_wakeup()
495 * dev_pm_genpd_get_next_hrtimer - Return the next_hrtimer for the genpd
512 if (genpd->gd) in dev_pm_genpd_get_next_hrtimer()
513 return genpd->gd->next_hrtimer; in dev_pm_genpd_get_next_hrtimer()
520 * dev_pm_genpd_synced_poweroff - Next power off should be synchronous
524 * Allows a consumer of the genpd to notify the provider that the next power off
539 genpd->synced_poweroff = true; in dev_pm_genpd_synced_poweroff()
546 unsigned int state_idx = genpd->state_idx; in _genpd_power_on()
551 /* Notify consumers that we are about to power on. */ in _genpd_power_on()
552 ret = raw_notifier_call_chain_robust(&genpd->power_notifiers, in _genpd_power_on()
559 if (!genpd->power_on) in _genpd_power_on()
562 timed = timed && genpd->gd && !genpd->states[state_idx].fwnode; in _genpd_power_on()
564 ret = genpd->power_on(genpd); in _genpd_power_on()
572 ret = genpd->power_on(genpd); in _genpd_power_on()
577 if (elapsed_ns <= genpd->states[state_idx].power_on_latency_ns) in _genpd_power_on()
580 genpd->states[state_idx].power_on_latency_ns = elapsed_ns; in _genpd_power_on()
581 genpd->gd->max_off_time_changed = true; in _genpd_power_on()
582 pr_debug("%s: Power-%s latency exceeded, new value %lld ns\n", in _genpd_power_on()
583 genpd->name, "on", elapsed_ns); in _genpd_power_on()
586 raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_ON, NULL); in _genpd_power_on()
587 genpd->synced_poweroff = false; in _genpd_power_on()
590 raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_OFF, in _genpd_power_on()
597 unsigned int state_idx = genpd->state_idx; in _genpd_power_off()
602 /* Notify consumers that we are about to power off. */ in _genpd_power_off()
603 ret = raw_notifier_call_chain_robust(&genpd->power_notifiers, in _genpd_power_off()
610 if (!genpd->power_off) in _genpd_power_off()
613 timed = timed && genpd->gd && !genpd->states[state_idx].fwnode; in _genpd_power_off()
615 ret = genpd->power_off(genpd); in _genpd_power_off()
623 ret = genpd->power_off(genpd); in _genpd_power_off()
628 if (elapsed_ns <= genpd->states[state_idx].power_off_latency_ns) in _genpd_power_off()
631 genpd->states[state_idx].power_off_latency_ns = elapsed_ns; in _genpd_power_off()
632 genpd->gd->max_off_time_changed = true; in _genpd_power_off()
633 pr_debug("%s: Power-%s latency exceeded, new value %lld ns\n", in _genpd_power_off()
634 genpd->name, "off", elapsed_ns); in _genpd_power_off()
637 raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_OFF, in _genpd_power_off()
641 raw_notifier_call_chain(&genpd->power_notifiers, GENPD_NOTIFY_ON, NULL); in _genpd_power_off()
646 * genpd_queue_power_off_work - Queue up the execution of genpd_power_off().
647 * @genpd: PM domain to power off.
654 queue_work(pm_wq, &genpd->power_off_work); in genpd_queue_power_off_work()
658 * genpd_power_off - Remove power from a given PM domain.
659 * @genpd: PM domain to power down.
660 * @one_dev_on: If invoked from genpd's ->runtime_suspend|resume() callback, the
663 * be RPM_SUSPENDED, while it tries to power off the PM domain.
667 * have been powered down, remove power from @genpd.
678 * Do not try to power off the domain in the following situations: in genpd_power_off()
679 * (1) The domain is already in the "power off" state. in genpd_power_off()
682 if (!genpd_status_on(genpd) || genpd->prepared_count > 0) in genpd_power_off()
686 * Abort power off for the PM domain in the following situations: in genpd_power_off()
687 * (1) The domain is configured as always on. in genpd_power_off()
688 * (2) When the domain has a subdomain being powered on. in genpd_power_off()
692 atomic_read(&genpd->sd_count) > 0) in genpd_power_off()
693 return -EBUSY; in genpd_power_off()
696 * The children must be in their deepest (powered-off) states to allow in genpd_power_off()
701 list_for_each_entry(link, &genpd->parent_links, parent_node) { in genpd_power_off()
702 struct generic_pm_domain *child = link->child; in genpd_power_off()
703 if (child->state_idx < child->state_count - 1) in genpd_power_off()
704 return -EBUSY; in genpd_power_off()
707 list_for_each_entry(pdd, &genpd->dev_list, list_node) { in genpd_power_off()
709 * Do not allow PM domain to be powered off, when an IRQ safe in genpd_power_off()
710 * device is part of a non-IRQ safe domain. in genpd_power_off()
712 if (!pm_runtime_suspended(pdd->dev) || in genpd_power_off()
713 irq_safe_dev_in_sleep_domain(pdd->dev, genpd)) in genpd_power_off()
718 return -EBUSY; in genpd_power_off()
720 if (genpd->gov && genpd->gov->power_down_ok) { in genpd_power_off()
721 if (!genpd->gov->power_down_ok(&genpd->domain)) in genpd_power_off()
722 return -EAGAIN; in genpd_power_off()
726 if (!genpd->gov) in genpd_power_off()
727 genpd->state_idx = 0; in genpd_power_off()
729 /* Don't power off, if a child domain is waiting to power on. */ in genpd_power_off()
730 if (atomic_read(&genpd->sd_count) > 0) in genpd_power_off()
731 return -EBUSY; in genpd_power_off()
735 genpd->states[genpd->state_idx].rejected++; in genpd_power_off()
739 genpd->status = GENPD_STATE_OFF; in genpd_power_off()
741 genpd->states[genpd->state_idx].usage++; in genpd_power_off()
743 list_for_each_entry(link, &genpd->child_links, child_node) { in genpd_power_off()
744 genpd_sd_counter_dec(link->parent); in genpd_power_off()
745 genpd_lock_nested(link->parent, depth + 1); in genpd_power_off()
746 genpd_power_off(link->parent, false, depth + 1); in genpd_power_off()
747 genpd_unlock(link->parent); in genpd_power_off()
754 * genpd_power_on - Restore power to a given PM domain and its parents.
755 * @genpd: PM domain to power up.
758 * Restore power to @genpd and all of its parents so that it is possible to
774 list_for_each_entry(link, &genpd->child_links, child_node) { in genpd_power_on()
775 struct generic_pm_domain *parent = link->parent; in genpd_power_on()
793 genpd->status = GENPD_STATE_ON; in genpd_power_on()
800 &genpd->child_links, in genpd_power_on()
802 genpd_sd_counter_dec(link->parent); in genpd_power_on()
803 genpd_lock_nested(link->parent, depth + 1); in genpd_power_on()
804 genpd_power_off(link->parent, false, depth + 1); in genpd_power_on()
805 genpd_unlock(link->parent); in genpd_power_on()
825 dev = gpd_data->base.dev; in genpd_dev_pm_qos_notifier()
828 struct generic_pm_domain *genpd = ERR_PTR(-ENODATA); in genpd_dev_pm_qos_notifier()
832 spin_lock_irq(&dev->power.lock); in genpd_dev_pm_qos_notifier()
834 pdd = dev->power.subsys_data ? in genpd_dev_pm_qos_notifier()
835 dev->power.subsys_data->domain_data : NULL; in genpd_dev_pm_qos_notifier()
837 td = to_gpd_data(pdd)->td; in genpd_dev_pm_qos_notifier()
839 td->constraint_changed = true; in genpd_dev_pm_qos_notifier()
844 spin_unlock_irq(&dev->power.lock); in genpd_dev_pm_qos_notifier()
848 genpd->gd->max_off_time_changed = true; in genpd_dev_pm_qos_notifier()
852 dev = dev->parent; in genpd_dev_pm_qos_notifier()
853 if (!dev || dev->power.ignore_children) in genpd_dev_pm_qos_notifier()
861 * genpd_power_off_work_fn - Power off PM domain whose subdomain count is 0.
876 * __genpd_runtime_suspend - walk the hierarchy of ->runtime_suspend() callbacks
883 if (dev->type && dev->type->pm) in __genpd_runtime_suspend()
884 cb = dev->type->pm->runtime_suspend; in __genpd_runtime_suspend()
885 else if (dev->class && dev->class->pm) in __genpd_runtime_suspend()
886 cb = dev->class->pm->runtime_suspend; in __genpd_runtime_suspend()
887 else if (dev->bus && dev->bus->pm) in __genpd_runtime_suspend()
888 cb = dev->bus->pm->runtime_suspend; in __genpd_runtime_suspend()
892 if (!cb && dev->driver && dev->driver->pm) in __genpd_runtime_suspend()
893 cb = dev->driver->pm->runtime_suspend; in __genpd_runtime_suspend()
899 * __genpd_runtime_resume - walk the hierarchy of ->runtime_resume() callbacks
906 if (dev->type && dev->type->pm) in __genpd_runtime_resume()
907 cb = dev->type->pm->runtime_resume; in __genpd_runtime_resume()
908 else if (dev->class && dev->class->pm) in __genpd_runtime_resume()
909 cb = dev->class->pm->runtime_resume; in __genpd_runtime_resume()
910 else if (dev->bus && dev->bus->pm) in __genpd_runtime_resume()
911 cb = dev->bus->pm->runtime_resume; in __genpd_runtime_resume()
915 if (!cb && dev->driver && dev->driver->pm) in __genpd_runtime_resume()
916 cb = dev->driver->pm->runtime_resume; in __genpd_runtime_resume()
922 * genpd_runtime_suspend - Suspend a device belonging to I/O PM domain.
926 * pm_domain field points to the domain member of an object of type
927 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
934 struct gpd_timing_data *td = gpd_data->td; in genpd_runtime_suspend()
944 return -EINVAL; in genpd_runtime_suspend()
947 * A runtime PM centric subsystem/driver may re-use the runtime PM in genpd_runtime_suspend()
952 suspend_ok = genpd->gov ? genpd->gov->suspend_ok : NULL; in genpd_runtime_suspend()
954 return -EBUSY; in genpd_runtime_suspend()
973 if (elapsed_ns > td->suspend_latency_ns) { in genpd_runtime_suspend()
974 td->suspend_latency_ns = elapsed_ns; in genpd_runtime_suspend()
977 genpd->gd->max_off_time_changed = true; in genpd_runtime_suspend()
978 td->constraint_changed = true; in genpd_runtime_suspend()
983 * If power.irq_safe is set, this routine may be run with in genpd_runtime_suspend()
984 * IRQs disabled, so suspend only if the PM domain also is irq_safe. in genpd_runtime_suspend()
991 gpd_data->rpm_pstate = genpd_drop_performance_state(dev); in genpd_runtime_suspend()
998 * genpd_runtime_resume - Resume a device belonging to I/O PM domain.
1002 * pm_domain field points to the domain member of an object of type
1003 * struct generic_pm_domain representing a PM domain consisting of I/O devices.
1009 struct gpd_timing_data *td = gpd_data->td; in genpd_runtime_resume()
1019 return -EINVAL; in genpd_runtime_resume()
1022 * As we don't power off a non IRQ safe domain, which holds in genpd_runtime_resume()
1023 * an IRQ safe device, we don't need to restore power to it. in genpd_runtime_resume()
1029 genpd_restore_performance_state(dev, gpd_data->rpm_pstate); in genpd_runtime_resume()
1052 if (elapsed_ns > td->resume_latency_ns) { in genpd_runtime_resume()
1053 td->resume_latency_ns = elapsed_ns; in genpd_runtime_resume()
1056 genpd->gd->max_off_time_changed = true; in genpd_runtime_resume()
1057 td->constraint_changed = true; in genpd_runtime_resume()
1069 gpd_data->rpm_pstate = genpd_drop_performance_state(dev); in genpd_runtime_resume()
1085 * genpd_power_off_unused - Power off all PM domains with no devices in use.
1092 pr_warn("genpd: Not disabling unused power domains\n"); in genpd_power_off_unused()
1110 * genpd_sync_power_off - Synchronously power off a PM domain and its parents.
1111 * @genpd: PM domain to power off, if possible.
1115 * Check if the given PM domain can be powered off (during system suspend or
1118 * This function is only called in "noirq" and "syscore" stages of system power
1130 if (genpd->suspended_count != genpd->device_count in genpd_sync_power_off()
1131 || atomic_read(&genpd->sd_count) > 0) in genpd_sync_power_off()
1134 /* Check that the children are in their deepest (powered-off) state. */ in genpd_sync_power_off()
1135 list_for_each_entry(link, &genpd->parent_links, parent_node) { in genpd_sync_power_off()
1136 struct generic_pm_domain *child = link->child; in genpd_sync_power_off()
1137 if (child->state_idx < child->state_count - 1) in genpd_sync_power_off()
1142 genpd->state_idx = genpd->state_count - 1; in genpd_sync_power_off()
1146 genpd->status = GENPD_STATE_OFF; in genpd_sync_power_off()
1148 list_for_each_entry(link, &genpd->child_links, child_node) { in genpd_sync_power_off()
1149 genpd_sd_counter_dec(link->parent); in genpd_sync_power_off()
1152 genpd_lock_nested(link->parent, depth + 1); in genpd_sync_power_off()
1154 genpd_sync_power_off(link->parent, use_lock, depth + 1); in genpd_sync_power_off()
1157 genpd_unlock(link->parent); in genpd_sync_power_off()
1162 * genpd_sync_power_on - Synchronously power on a PM domain and its parents.
1163 * @genpd: PM domain to power on.
1167 * This function is only called in "noirq" and "syscore" stages of system power
1179 list_for_each_entry(link, &genpd->child_links, child_node) { in genpd_sync_power_on()
1180 genpd_sd_counter_inc(link->parent); in genpd_sync_power_on()
1183 genpd_lock_nested(link->parent, depth + 1); in genpd_sync_power_on()
1185 genpd_sync_power_on(link->parent, use_lock, depth + 1); in genpd_sync_power_on()
1188 genpd_unlock(link->parent); in genpd_sync_power_on()
1192 genpd->status = GENPD_STATE_ON; in genpd_sync_power_on()
1196 * genpd_prepare - Start power transition of a device in a PM domain.
1199 * Start a power transition of a device (during a system-wide power transition)
1200 * under the assumption that its pm_domain field points to the domain member of
1201 * an object of type struct generic_pm_domain representing a PM domain
1213 return -EINVAL; in genpd_prepare()
1217 if (genpd->prepared_count++ == 0) in genpd_prepare()
1218 genpd->suspended_count = 0; in genpd_prepare()
1226 genpd->prepared_count--; in genpd_prepare()
1236 * genpd_finish_suspend - Completion of suspend or hibernation of device in an
1237 * I/O pm domain.
1242 * Stop the device and remove power from the domain if all devices in it have
1254 return -EINVAL; in genpd_finish_suspend()
1263 if (genpd->dev_ops.stop && genpd->dev_ops.start && in genpd_finish_suspend()
1273 genpd->suspended_count++; in genpd_finish_suspend()
1281 * genpd_suspend_noirq - Completion of suspend of device in an I/O PM domain.
1284 * Stop the device and remove power from the domain if all devices in it have
1297 * genpd_finish_resume - Completion of resume of device in an I/O PM domain.
1301 * Restore power to the device's PM domain, if necessary, and start the device.
1313 return -EINVAL; in genpd_finish_resume()
1320 genpd->suspended_count--; in genpd_finish_resume()
1323 if (genpd->dev_ops.stop && genpd->dev_ops.start && in genpd_finish_resume()
1334 * genpd_resume_noirq - Start of resume of device in an I/O PM domain.
1337 * Restore power to the device's PM domain, if necessary, and start the device.
1347 * genpd_freeze_noirq - Completion of freezing a device in an I/O PM domain.
1351 * pm_domain field points to the domain member of an object of type
1352 * struct generic_pm_domain representing a power domain consisting of I/O
1365 * genpd_thaw_noirq - Early thaw of device in an I/O PM domain.
1368 * Start the device, unless power has been removed from the domain already
1379 * genpd_poweroff_noirq - Completion of hibernation of device in an
1380 * I/O PM domain.
1383 * Stop the device and remove power from the domain if all devices in it have
1396 * genpd_restore_noirq - Start of restore of device in an I/O PM domain.
1399 * Make sure the domain will be in the same power state as before the
1410 * genpd_complete - Complete power transition of a device in a power domain.
1413 * Complete a power transition of a device (during a system-wide power
1415 * domain member of an object of type struct generic_pm_domain representing
1416 * a power domain consisting of I/O devices.
1432 genpd->prepared_count--; in genpd_complete()
1433 if (!genpd->prepared_count) in genpd_complete()
1454 genpd->suspended_count++; in genpd_switch_state()
1458 genpd->suspended_count--; in genpd_switch_state()
1466 * dev_pm_genpd_suspend - Synchronously try to suspend the genpd for @dev
1471 * suspend-to-idle to suspend a corresponding CPU device that is attached to a
1481 * dev_pm_genpd_resume - Synchronously try to resume the genpd for @dev
1485 * during the syscore resume phase. It may also be called during suspend-to-idle
1520 ret = -ENOMEM; in genpd_alloc_dev_data()
1524 gpd_data->base.dev = dev; in genpd_alloc_dev_data()
1525 gpd_data->nb.notifier_call = genpd_dev_pm_qos_notifier; in genpd_alloc_dev_data()
1531 ret = -ENOMEM; in genpd_alloc_dev_data()
1535 td->constraint_changed = true; in genpd_alloc_dev_data()
1536 td->effective_constraint_ns = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT_NS; in genpd_alloc_dev_data()
1537 td->next_wakeup = KTIME_MAX; in genpd_alloc_dev_data()
1538 gpd_data->td = td; in genpd_alloc_dev_data()
1541 spin_lock_irq(&dev->power.lock); in genpd_alloc_dev_data()
1543 if (dev->power.subsys_data->domain_data) in genpd_alloc_dev_data()
1544 ret = -EINVAL; in genpd_alloc_dev_data()
1546 dev->power.subsys_data->domain_data = &gpd_data->base; in genpd_alloc_dev_data()
1548 spin_unlock_irq(&dev->power.lock); in genpd_alloc_dev_data()
1556 kfree(gpd_data->td); in genpd_alloc_dev_data()
1566 spin_lock_irq(&dev->power.lock); in genpd_free_dev_data()
1568 dev->power.subsys_data->domain_data = NULL; in genpd_free_dev_data()
1570 spin_unlock_irq(&dev->power.lock); in genpd_free_dev_data()
1572 kfree(gpd_data->td); in genpd_free_dev_data()
1585 list_for_each_entry(link, &genpd->child_links, child_node) { in genpd_update_cpumask()
1586 struct generic_pm_domain *parent = link->parent; in genpd_update_cpumask()
1594 cpumask_set_cpu(cpu, genpd->cpus); in genpd_update_cpumask()
1596 cpumask_clear_cpu(cpu, genpd->cpus); in genpd_update_cpumask()
1616 return -1; in genpd_get_cpu()
1623 return -1; in genpd_get_cpu()
1629 struct genpd_governor_data *gd = genpd->gd; in genpd_add_device()
1639 gpd_data->cpu = genpd_get_cpu(genpd, base_dev); in genpd_add_device()
1641 ret = genpd->attach_dev ? genpd->attach_dev(genpd, dev) : 0; in genpd_add_device()
1647 genpd_set_cpumask(genpd, gpd_data->cpu); in genpd_add_device()
1648 dev_pm_domain_set(dev, &genpd->domain); in genpd_add_device()
1650 genpd->device_count++; in genpd_add_device()
1652 gd->max_off_time_changed = true; in genpd_add_device()
1654 list_add_tail(&gpd_data->base.list_node, &genpd->dev_list); in genpd_add_device()
1661 dev_pm_qos_add_notifier(dev, &gpd_data->nb, in genpd_add_device()
1668 * pm_genpd_add_device - Add a device to an I/O PM domain.
1669 * @genpd: PM domain to add the device to.
1677 return -EINVAL; in pm_genpd_add_device()
1696 pdd = dev->power.subsys_data->domain_data; in genpd_remove_device()
1698 dev_pm_qos_remove_notifier(dev, &gpd_data->nb, in genpd_remove_device()
1703 if (genpd->prepared_count > 0) { in genpd_remove_device()
1704 ret = -EAGAIN; in genpd_remove_device()
1708 genpd->device_count--; in genpd_remove_device()
1709 if (genpd->gd) in genpd_remove_device()
1710 genpd->gd->max_off_time_changed = true; in genpd_remove_device()
1712 genpd_clear_cpumask(genpd, gpd_data->cpu); in genpd_remove_device()
1715 list_del_init(&pdd->list_node); in genpd_remove_device()
1719 if (genpd->detach_dev) in genpd_remove_device()
1720 genpd->detach_dev(genpd, dev); in genpd_remove_device()
1728 dev_pm_qos_add_notifier(dev, &gpd_data->nb, DEV_PM_QOS_RESUME_LATENCY); in genpd_remove_device()
1734 * pm_genpd_remove_device - Remove a device from an I/O PM domain.
1742 return -EINVAL; in pm_genpd_remove_device()
1749 * dev_pm_genpd_add_notifier - Add a genpd power on/off notifier for @dev
1754 * Users may call this function to add a genpd power on/off notifier for an
1756 * sent when genpd is powering on/off the PM domain.
1771 return -ENODEV; in dev_pm_genpd_add_notifier()
1773 if (WARN_ON(!dev->power.subsys_data || in dev_pm_genpd_add_notifier()
1774 !dev->power.subsys_data->domain_data)) in dev_pm_genpd_add_notifier()
1775 return -EINVAL; in dev_pm_genpd_add_notifier()
1777 gpd_data = to_gpd_data(dev->power.subsys_data->domain_data); in dev_pm_genpd_add_notifier()
1778 if (gpd_data->power_nb) in dev_pm_genpd_add_notifier()
1779 return -EEXIST; in dev_pm_genpd_add_notifier()
1782 ret = raw_notifier_chain_register(&genpd->power_notifiers, nb); in dev_pm_genpd_add_notifier()
1786 dev_warn(dev, "failed to add notifier for PM domain %s\n", in dev_pm_genpd_add_notifier()
1787 genpd->name); in dev_pm_genpd_add_notifier()
1791 gpd_data->power_nb = nb; in dev_pm_genpd_add_notifier()
1797 * dev_pm_genpd_remove_notifier - Remove a genpd power on/off notifier for @dev
1801 * Users may call this function to remove a genpd power on/off notifier for an
1817 return -ENODEV; in dev_pm_genpd_remove_notifier()
1819 if (WARN_ON(!dev->power.subsys_data || in dev_pm_genpd_remove_notifier()
1820 !dev->power.subsys_data->domain_data)) in dev_pm_genpd_remove_notifier()
1821 return -EINVAL; in dev_pm_genpd_remove_notifier()
1823 gpd_data = to_gpd_data(dev->power.subsys_data->domain_data); in dev_pm_genpd_remove_notifier()
1824 if (!gpd_data->power_nb) in dev_pm_genpd_remove_notifier()
1825 return -ENODEV; in dev_pm_genpd_remove_notifier()
1828 ret = raw_notifier_chain_unregister(&genpd->power_notifiers, in dev_pm_genpd_remove_notifier()
1829 gpd_data->power_nb); in dev_pm_genpd_remove_notifier()
1833 dev_warn(dev, "failed to remove notifier for PM domain %s\n", in dev_pm_genpd_remove_notifier()
1834 genpd->name); in dev_pm_genpd_remove_notifier()
1838 gpd_data->power_nb = NULL; in dev_pm_genpd_remove_notifier()
1851 return -EINVAL; in genpd_add_subdomain()
1854 * If the domain can be powered on/off in an IRQ safe in genpd_add_subdomain()
1860 genpd->name, subdomain->name); in genpd_add_subdomain()
1861 return -EINVAL; in genpd_add_subdomain()
1866 return -ENOMEM; in genpd_add_subdomain()
1872 ret = -EINVAL; in genpd_add_subdomain()
1876 list_for_each_entry(itr, &genpd->parent_links, parent_node) { in genpd_add_subdomain()
1877 if (itr->child == subdomain && itr->parent == genpd) { in genpd_add_subdomain()
1878 ret = -EINVAL; in genpd_add_subdomain()
1883 link->parent = genpd; in genpd_add_subdomain()
1884 list_add_tail(&link->parent_node, &genpd->parent_links); in genpd_add_subdomain()
1885 link->child = subdomain; in genpd_add_subdomain()
1886 list_add_tail(&link->child_node, &subdomain->child_links); in genpd_add_subdomain()
1899 * pm_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
1900 * @genpd: Leader PM domain to add the subdomain to.
1917 * pm_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
1918 * @genpd: Leader PM domain to remove the subdomain from.
1925 int ret = -EINVAL; in pm_genpd_remove_subdomain()
1928 return -EINVAL; in pm_genpd_remove_subdomain()
1933 if (!list_empty(&subdomain->parent_links) || subdomain->device_count) { in pm_genpd_remove_subdomain()
1935 genpd->name, subdomain->name); in pm_genpd_remove_subdomain()
1936 ret = -EBUSY; in pm_genpd_remove_subdomain()
1940 list_for_each_entry_safe(link, l, &genpd->parent_links, parent_node) { in pm_genpd_remove_subdomain()
1941 if (link->child != subdomain) in pm_genpd_remove_subdomain()
1944 list_del(&link->parent_node); in pm_genpd_remove_subdomain()
1945 list_del(&link->child_node); in pm_genpd_remove_subdomain()
1974 return -ENOMEM; in genpd_set_default_power_state()
1976 genpd->states = state; in genpd_set_default_power_state()
1977 genpd->state_count = 1; in genpd_set_default_power_state()
1978 genpd->free_states = genpd_free_default_power_state; in genpd_set_default_power_state()
1989 !zalloc_cpumask_var(&genpd->cpus, GFP_KERNEL)) in genpd_alloc_data()
1990 return -ENOMEM; in genpd_alloc_data()
1992 if (genpd->gov) { in genpd_alloc_data()
1995 ret = -ENOMEM; in genpd_alloc_data()
1999 gd->max_off_time_ns = -1; in genpd_alloc_data()
2000 gd->max_off_time_changed = true; in genpd_alloc_data()
2001 gd->next_wakeup = KTIME_MAX; in genpd_alloc_data()
2002 gd->next_hrtimer = KTIME_MAX; in genpd_alloc_data()
2006 if (genpd->state_count == 0) { in genpd_alloc_data()
2012 genpd->gd = gd; in genpd_alloc_data()
2017 free_cpumask_var(genpd->cpus); in genpd_alloc_data()
2025 free_cpumask_var(genpd->cpus); in genpd_free_data()
2026 if (genpd->free_states) in genpd_free_data()
2027 genpd->free_states(genpd->states, genpd->state_count); in genpd_free_data()
2028 kfree(genpd->gd); in genpd_free_data()
2033 if (genpd->flags & GENPD_FLAG_IRQ_SAFE) { in genpd_lock_init()
2034 spin_lock_init(&genpd->slock); in genpd_lock_init()
2035 genpd->lock_ops = &genpd_spin_ops; in genpd_lock_init()
2037 mutex_init(&genpd->mlock); in genpd_lock_init()
2038 genpd->lock_ops = &genpd_mtx_ops; in genpd_lock_init()
2043 * pm_genpd_init - Initialize a generic I/O PM domain object.
2044 * @genpd: PM domain object to initialize.
2045 * @gov: PM domain governor to associate with the domain (may be NULL).
2046 * @is_off: Initial value of the domain's power_is_off field.
2056 return -EINVAL; in pm_genpd_init()
2058 INIT_LIST_HEAD(&genpd->parent_links); in pm_genpd_init()
2059 INIT_LIST_HEAD(&genpd->child_links); in pm_genpd_init()
2060 INIT_LIST_HEAD(&genpd->dev_list); in pm_genpd_init()
2061 RAW_INIT_NOTIFIER_HEAD(&genpd->power_notifiers); in pm_genpd_init()
2063 genpd->gov = gov; in pm_genpd_init()
2064 INIT_WORK(&genpd->power_off_work, genpd_power_off_work_fn); in pm_genpd_init()
2065 atomic_set(&genpd->sd_count, 0); in pm_genpd_init()
2066 genpd->status = is_off ? GENPD_STATE_OFF : GENPD_STATE_ON; in pm_genpd_init()
2067 genpd->device_count = 0; in pm_genpd_init()
2068 genpd->provider = NULL; in pm_genpd_init()
2069 genpd->has_provider = false; in pm_genpd_init()
2070 genpd->accounting_time = ktime_get_mono_fast_ns(); in pm_genpd_init()
2071 genpd->domain.ops.runtime_suspend = genpd_runtime_suspend; in pm_genpd_init()
2072 genpd->domain.ops.runtime_resume = genpd_runtime_resume; in pm_genpd_init()
2073 genpd->domain.ops.prepare = genpd_prepare; in pm_genpd_init()
2074 genpd->domain.ops.suspend_noirq = genpd_suspend_noirq; in pm_genpd_init()
2075 genpd->domain.ops.resume_noirq = genpd_resume_noirq; in pm_genpd_init()
2076 genpd->domain.ops.freeze_noirq = genpd_freeze_noirq; in pm_genpd_init()
2077 genpd->domain.ops.thaw_noirq = genpd_thaw_noirq; in pm_genpd_init()
2078 genpd->domain.ops.poweroff_noirq = genpd_poweroff_noirq; in pm_genpd_init()
2079 genpd->domain.ops.restore_noirq = genpd_restore_noirq; in pm_genpd_init()
2080 genpd->domain.ops.complete = genpd_complete; in pm_genpd_init()
2081 genpd->domain.start = genpd_dev_pm_start; in pm_genpd_init()
2083 if (genpd->flags & GENPD_FLAG_PM_CLK) { in pm_genpd_init()
2084 genpd->dev_ops.stop = pm_clk_suspend; in pm_genpd_init()
2085 genpd->dev_ops.start = pm_clk_resume; in pm_genpd_init()
2088 /* The always-on governor works better with the corresponding flag. */ in pm_genpd_init()
2090 genpd->flags |= GENPD_FLAG_RPM_ALWAYS_ON; in pm_genpd_init()
2092 /* Always-on domains must be powered on at initialization. */ in pm_genpd_init()
2095 pr_err("always-on PM domain %s is not on\n", genpd->name); in pm_genpd_init()
2096 return -EINVAL; in pm_genpd_init()
2100 if (!gov && genpd->state_count > 1) in pm_genpd_init()
2101 pr_warn("%s: no governor for states\n", genpd->name); in pm_genpd_init()
2107 device_initialize(&genpd->dev); in pm_genpd_init()
2108 dev_set_name(&genpd->dev, "%s", genpd->name); in pm_genpd_init()
2111 list_add(&genpd->gpd_list_node, &gpd_list); in pm_genpd_init()
2124 return -EINVAL; in genpd_remove()
2128 if (genpd->has_provider) { in genpd_remove()
2130 pr_err("Provider present, unable to remove %s\n", genpd->name); in genpd_remove()
2131 return -EBUSY; in genpd_remove()
2134 if (!list_empty(&genpd->parent_links) || genpd->device_count) { in genpd_remove()
2136 pr_err("%s: unable to remove %s\n", __func__, genpd->name); in genpd_remove()
2137 return -EBUSY; in genpd_remove()
2140 list_for_each_entry_safe(link, l, &genpd->child_links, child_node) { in genpd_remove()
2141 list_del(&link->parent_node); in genpd_remove()
2142 list_del(&link->child_node); in genpd_remove()
2146 list_del(&genpd->gpd_list_node); in genpd_remove()
2149 cancel_work_sync(&genpd->power_off_work); in genpd_remove()
2152 pr_debug("%s: removed %s\n", __func__, genpd->name); in genpd_remove()
2158 * pm_genpd_remove - Remove a generic I/O PM domain
2159 * @genpd: Pointer to PM domain that is to be removed.
2161 * To remove the PM domain, this function:
2162 * - Removes the PM domain as a subdomain to any parent domains,
2164 * - Removes the PM domain from the list of registered PM domains.
2166 * The PM domain will only be removed, if the associated provider has
2167 * been removed, it is not a parent to any other PM domain and has no
2185 * Device Tree based PM domain providers.
2187 * The code below implements generic device tree based PM domain providers that
2191 * devices to these domains is supposed to register a PM domain provider, which
2192 * maps a PM domain specifier retrieved from the device tree to a PM domain.
2195 * - genpd_xlate_simple() for 1:1 device tree node to PM domain mapping.
2196 * - genpd_xlate_onecell() for mapping of multiple PM domains per node by
2201 * struct of_genpd_provider - PM domain provider registration structure
2202 * @link: Entry in global list of PM domain providers
2203 * @node: Pointer to device tree node of PM domain provider
2204 * @xlate: Provider-specific xlate callback mapping a set of specifier cells
2205 * into a PM domain.
2215 /* List of registered PM domain providers. */
2221 * genpd_xlate_simple() - Xlate function for direct node-domain mapping
2222 * @genpdspec: OF phandle args to map into a PM domain
2223 * @data: xlate function private data - pointer to struct generic_pm_domain
2237 * genpd_xlate_onecell() - Xlate function using a single index.
2238 * @genpdspec: OF phandle args to map into a PM domain
2239 * @data: xlate function private data - pointer to struct genpd_onecell_data
2241 * This is a generic xlate function that can be used to model simple PM domain
2251 unsigned int idx = genpdspec->args[0]; in genpd_xlate_onecell()
2253 if (genpdspec->args_count != 1) in genpd_xlate_onecell()
2254 return ERR_PTR(-EINVAL); in genpd_xlate_onecell()
2256 if (idx >= genpd_data->num_domains) { in genpd_xlate_onecell()
2257 pr_err("%s: invalid domain index %u\n", __func__, idx); in genpd_xlate_onecell()
2258 return ERR_PTR(-EINVAL); in genpd_xlate_onecell()
2261 if (!genpd_data->domains[idx]) in genpd_xlate_onecell()
2262 return ERR_PTR(-ENOENT); in genpd_xlate_onecell()
2264 return genpd_data->domains[idx]; in genpd_xlate_onecell()
2268 * genpd_add_provider() - Register a PM domain provider for a node
2269 * @np: Device node pointer associated with the PM domain provider.
2270 * @xlate: Callback for decoding PM domain from phandle arguments.
2280 return -ENOMEM; in genpd_add_provider()
2282 cp->node = of_node_get(np); in genpd_add_provider()
2283 cp->data = data; in genpd_add_provider()
2284 cp->xlate = xlate; in genpd_add_provider()
2285 fwnode_dev_initialized(&np->fwnode, true); in genpd_add_provider()
2288 list_add(&cp->link, &of_genpd_providers); in genpd_add_provider()
2290 pr_debug("Added domain provider from %pOF\n", np); in genpd_add_provider()
2313 * of_genpd_add_provider_simple() - Register a simple PM domain provider
2314 * @np: Device node pointer associated with the PM domain provider.
2315 * @genpd: Pointer to PM domain associated with the PM domain provider.
2323 return -EINVAL; in of_genpd_add_provider_simple()
2326 return -EINVAL; in of_genpd_add_provider_simple()
2328 genpd->dev.of_node = np; in of_genpd_add_provider_simple()
2331 if (genpd->set_performance_state) { in of_genpd_add_provider_simple()
2332 ret = dev_pm_opp_of_add_table(&genpd->dev); in of_genpd_add_provider_simple()
2334 return dev_err_probe(&genpd->dev, ret, "Failed to add OPP table\n"); in of_genpd_add_provider_simple()
2340 genpd->opp_table = dev_pm_opp_get_opp_table(&genpd->dev); in of_genpd_add_provider_simple()
2341 WARN_ON(IS_ERR(genpd->opp_table)); in of_genpd_add_provider_simple()
2346 if (genpd->set_performance_state) { in of_genpd_add_provider_simple()
2347 dev_pm_opp_put_opp_table(genpd->opp_table); in of_genpd_add_provider_simple()
2348 dev_pm_opp_of_remove_table(&genpd->dev); in of_genpd_add_provider_simple()
2354 genpd->provider = &np->fwnode; in of_genpd_add_provider_simple()
2355 genpd->has_provider = true; in of_genpd_add_provider_simple()
2362 * of_genpd_add_provider_onecell() - Register a onecell PM domain provider
2363 * @np: Device node pointer associated with the PM domain provider.
2364 * @data: Pointer to the data associated with the PM domain provider.
2371 int ret = -EINVAL; in of_genpd_add_provider_onecell()
2374 return -EINVAL; in of_genpd_add_provider_onecell()
2376 if (!data->xlate) in of_genpd_add_provider_onecell()
2377 data->xlate = genpd_xlate_onecell; in of_genpd_add_provider_onecell()
2379 for (i = 0; i < data->num_domains; i++) { in of_genpd_add_provider_onecell()
2380 genpd = data->domains[i]; in of_genpd_add_provider_onecell()
2387 genpd->dev.of_node = np; in of_genpd_add_provider_onecell()
2390 if (genpd->set_performance_state) { in of_genpd_add_provider_onecell()
2391 ret = dev_pm_opp_of_add_table_indexed(&genpd->dev, i); in of_genpd_add_provider_onecell()
2393 dev_err_probe(&genpd->dev, ret, in of_genpd_add_provider_onecell()
2402 genpd->opp_table = dev_pm_opp_get_opp_table(&genpd->dev); in of_genpd_add_provider_onecell()
2403 WARN_ON(IS_ERR(genpd->opp_table)); in of_genpd_add_provider_onecell()
2406 genpd->provider = &np->fwnode; in of_genpd_add_provider_onecell()
2407 genpd->has_provider = true; in of_genpd_add_provider_onecell()
2410 ret = genpd_add_provider(np, data->xlate, data); in of_genpd_add_provider_onecell()
2417 while (i--) { in of_genpd_add_provider_onecell()
2418 genpd = data->domains[i]; in of_genpd_add_provider_onecell()
2423 genpd->provider = NULL; in of_genpd_add_provider_onecell()
2424 genpd->has_provider = false; in of_genpd_add_provider_onecell()
2426 if (genpd->set_performance_state) { in of_genpd_add_provider_onecell()
2427 dev_pm_opp_put_opp_table(genpd->opp_table); in of_genpd_add_provider_onecell()
2428 dev_pm_opp_of_remove_table(&genpd->dev); in of_genpd_add_provider_onecell()
2437 * of_genpd_del_provider() - Remove a previously registered PM domain provider
2438 * @np: Device node pointer associated with the PM domain provider
2448 if (cp->node == np) { in of_genpd_del_provider()
2450 * For each PM domain associated with the in of_genpd_del_provider()
2452 * so that the PM domain can be safely removed. in of_genpd_del_provider()
2455 if (gpd->provider == &np->fwnode) { in of_genpd_del_provider()
2456 gpd->has_provider = false; in of_genpd_del_provider()
2458 if (!gpd->set_performance_state) in of_genpd_del_provider()
2461 dev_pm_opp_put_opp_table(gpd->opp_table); in of_genpd_del_provider()
2462 dev_pm_opp_of_remove_table(&gpd->dev); in of_genpd_del_provider()
2466 fwnode_dev_initialized(&cp->node->fwnode, false); in of_genpd_del_provider()
2467 list_del(&cp->link); in of_genpd_del_provider()
2468 of_node_put(cp->node); in of_genpd_del_provider()
2479 * genpd_get_from_provider() - Look-up PM domain
2480 * @genpdspec: OF phandle args to use for look-up
2482 * Looks for a PM domain provider under the node specified by @genpdspec and if
2484 * domain.
2492 struct generic_pm_domain *genpd = ERR_PTR(-ENOENT); in genpd_get_from_provider()
2496 return ERR_PTR(-EINVAL); in genpd_get_from_provider()
2502 if (provider->node == genpdspec->np) in genpd_get_from_provider()
2503 genpd = provider->xlate(genpdspec, provider->data); in genpd_get_from_provider()
2514 * of_genpd_add_device() - Add a device to an I/O PM domain
2515 * @genpdspec: OF phandle args to use for look-up PM domain
2518 * Looks-up an I/O PM domain based upon phandle args provided and adds
2519 * the device to the PM domain. Returns a negative error code on failure.
2527 return -EINVAL; in of_genpd_add_device()
2547 * of_genpd_add_subdomain - Add a subdomain to an I/O PM domain.
2548 * @parent_spec: OF phandle args to use for parent PM domain look-up
2549 * @subdomain_spec: OF phandle args to use for subdomain look-up
2551 * Looks-up a parent PM domain and subdomain based upon phandle args
2552 * provided and adds the subdomain to the parent PM domain. Returns a
2580 return ret == -ENOENT ? -EPROBE_DEFER : ret; in of_genpd_add_subdomain()
2585 * of_genpd_remove_subdomain - Remove a subdomain from an I/O PM domain.
2586 * @parent_spec: OF phandle args to use for parent PM domain look-up
2587 * @subdomain_spec: OF phandle args to use for subdomain look-up
2589 * Looks-up a parent PM domain and subdomain based upon phandle args
2590 * provided and removes the subdomain from the parent PM domain. Returns a
2623 * of_genpd_remove_last - Remove the last PM domain registered for a provider
2626 * Find the last PM domain that was added by a particular provider and
2627 * remove this PM domain from the list of PM domains. The provider is
2629 * domain will only be removed, if the provider associated with domain
2637 struct generic_pm_domain *gpd, *tmp, *genpd = ERR_PTR(-ENOENT); in of_genpd_remove_last()
2641 return ERR_PTR(-EINVAL); in of_genpd_remove_last()
2645 if (gpd->provider == &np->fwnode) { in of_genpd_remove_last()
2659 of_node_put(dev->of_node); in genpd_release_dev()
2668 * genpd_dev_pm_detach - Detach a device from its PM domain.
2672 * Try to locate a corresponding generic PM domain, which the device was
2685 dev_dbg(dev, "removing from PM domain %s\n", pd->name); in genpd_dev_pm_detach()
2688 if (dev_gpd_data(dev)->default_pstate) { in genpd_dev_pm_detach()
2690 dev_gpd_data(dev)->default_pstate = 0; in genpd_dev_pm_detach()
2695 if (ret != -EAGAIN) in genpd_dev_pm_detach()
2703 dev_err(dev, "failed to remove from PM domain %s: %d", in genpd_dev_pm_detach()
2704 pd->name, ret); in genpd_dev_pm_detach()
2708 /* Check if PM domain can be powered off after removing this device. */ in genpd_dev_pm_detach()
2712 if (dev->bus == &genpd_bus_type) in genpd_dev_pm_detach()
2735 ret = of_parse_phandle_with_args(dev->of_node, "power-domains", in __genpd_dev_pm_attach()
2736 "#power-domain-cells", index, &pd_args); in __genpd_dev_pm_attach()
2745 dev_dbg(dev, "%s() failed to find PM domain: %ld\n", in __genpd_dev_pm_attach()
2750 dev_dbg(dev, "adding to PM domain %s\n", pd->name); in __genpd_dev_pm_attach()
2756 return dev_err_probe(dev, ret, "failed to add to PM domain %s\n", pd->name); in __genpd_dev_pm_attach()
2758 dev->pm_domain->detach = genpd_dev_pm_detach; in __genpd_dev_pm_attach()
2759 dev->pm_domain->sync = genpd_dev_pm_sync; in __genpd_dev_pm_attach()
2762 pstate = of_get_required_opp_performance_state(dev->of_node, index); in __genpd_dev_pm_attach()
2763 if (pstate < 0 && pstate != -ENODEV && pstate != -EOPNOTSUPP) { in __genpd_dev_pm_attach()
2770 dev_gpd_data(dev)->default_pstate = pstate; in __genpd_dev_pm_attach()
2781 if (dev_gpd_data(dev)->default_pstate) { in __genpd_dev_pm_attach()
2783 dev_gpd_data(dev)->default_pstate = 0; in __genpd_dev_pm_attach()
2787 return -EPROBE_DEFER; in __genpd_dev_pm_attach()
2793 dev_err(dev, "failed to set required performance state for power-domain %s: %d\n", in __genpd_dev_pm_attach()
2794 pd->name, ret); in __genpd_dev_pm_attach()
2800 * genpd_dev_pm_attach - Attach a device to its PM domain using DT.
2803 * Parse device's OF node to find a PM domain specifier. If such is found,
2806 * Returns 1 on successfully attached PM domain, 0 when the device don't need a
2807 * PM domain or when multiple power-domains exists for it, else a negative error
2808 * code. Note that if a power-domain exists for the device, but it cannot be
2809 * found or turned on, then return -EPROBE_DEFER to ensure that the device is
2810 * not probed and to re-try again later.
2814 if (!dev->of_node) in genpd_dev_pm_attach()
2819 * can only attach one PM domain per device. in genpd_dev_pm_attach()
2821 if (of_count_phandle_with_args(dev->of_node, "power-domains", in genpd_dev_pm_attach()
2822 "#power-domain-cells") != 1) in genpd_dev_pm_attach()
2830 * genpd_dev_pm_attach_by_id - Associate a device with one of its PM domains.
2831 * @dev: The device used to lookup the PM domain.
2832 * @index: The index of the PM domain.
2834 * Parse device's OF node to find a PM domain specifier at the provided @index.
2836 * pm_domain ops. To deal with detaching of the virtual device, the ->detach()
2839 * Returns the created virtual device if successfully attached PM domain, NULL
2840 * when the device don't need a PM domain, else an ERR_PTR() in case of
2841 * failures. If a power-domain exists for the device, but cannot be found or
2842 * turned on, then ERR_PTR(-EPROBE_DEFER) is returned to ensure that the device
2843 * is not probed and to re-try again later.
2852 if (!dev->of_node) in genpd_dev_pm_attach_by_id()
2856 num_domains = of_count_phandle_with_args(dev->of_node, "power-domains", in genpd_dev_pm_attach_by_id()
2857 "#power-domain-cells"); in genpd_dev_pm_attach_by_id()
2864 return ERR_PTR(-ENOMEM); in genpd_dev_pm_attach_by_id()
2867 virt_dev->bus = &genpd_bus_type; in genpd_dev_pm_attach_by_id()
2868 virt_dev->release = genpd_release_dev; in genpd_dev_pm_attach_by_id()
2869 virt_dev->of_node = of_node_get(dev->of_node); in genpd_dev_pm_attach_by_id()
2877 /* Try to attach the device to the PM domain at the specified index. */ in genpd_dev_pm_attach_by_id()
2892 * genpd_dev_pm_attach_by_name - Associate a device with one of its PM domains.
2893 * @dev: The device used to lookup the PM domain.
2894 * @name: The name of the PM domain.
2896 * Parse device's OF node to find a PM domain specifier using the
2897 * power-domain-names DT property. For further description see
2904 if (!dev->of_node) in genpd_dev_pm_attach_by_name()
2907 index = of_property_match_string(dev->of_node, "power-domain-names", in genpd_dev_pm_attach_by_name()
2916 { .compatible = "domain-idle-state", },
2927 err = of_property_read_u32(state_node, "entry-latency-us", in genpd_parse_state()
2930 pr_debug(" * %pOF missing entry-latency-us property\n", in genpd_parse_state()
2932 return -EINVAL; in genpd_parse_state()
2935 err = of_property_read_u32(state_node, "exit-latency-us", in genpd_parse_state()
2938 pr_debug(" * %pOF missing exit-latency-us property\n", in genpd_parse_state()
2940 return -EINVAL; in genpd_parse_state()
2943 err = of_property_read_u32(state_node, "min-residency-us", &residency); in genpd_parse_state()
2945 genpd_state->residency_ns = 1000LL * residency; in genpd_parse_state()
2947 genpd_state->power_on_latency_ns = 1000LL * exit_latency; in genpd_parse_state()
2948 genpd_state->power_off_latency_ns = 1000LL * entry_latency; in genpd_parse_state()
2949 genpd_state->fwnode = &state_node->fwnode; in genpd_parse_state()
2962 ret = of_count_phandle_with_args(dn, "domain-idle-states", NULL); in genpd_iterate_idle_states()
2964 return ret == -ENOENT ? 0 : ret; in genpd_iterate_idle_states()
2967 of_for_each_phandle(&it, ret, dn, "domain-idle-states", NULL, 0) { in genpd_iterate_idle_states()
2999 * free the memory after use. If any or zero compatible domain idle states is
3020 return -ENOMEM; in of_genpd_parse_idle_states()
3025 return ret < 0 ? ret : -EINVAL; in of_genpd_parse_idle_states()
3036 * pm_genpd_opp_to_performance_state - Gets performance state of the genpd from its OPP node.
3038 * @genpd_dev: Genpd's device for which the performance-state needs to be found.
3043 * platform specific genpd->opp_to_performance_state() callback to translate
3044 * power domain OPP to performance state.
3056 if (unlikely(!genpd->opp_to_performance_state)) in pm_genpd_opp_to_performance_state()
3060 state = genpd->opp_to_performance_state(genpd, opp); in pm_genpd_opp_to_performance_state()
3093 if (dev->power.runtime_error) in rtpm_status_str()
3095 else if (dev->power.disable_depth) in rtpm_status_str()
3097 else if (dev->power.runtime_status < ARRAY_SIZE(status_lookup)) in rtpm_status_str()
3098 p = status_lookup[dev->power.runtime_status]; in rtpm_status_str()
3102 seq_printf(s, "%-25s ", p); in rtpm_status_str()
3109 gpd_data = to_gpd_data(dev->power.subsys_data->domain_data); in perf_status_str()
3110 seq_put_decimal_ull(s, "", gpd_data->performance_state); in perf_status_str()
3128 return -ERESTARTSYS; in genpd_summary_one()
3130 if (WARN_ON(genpd->status >= ARRAY_SIZE(status_lookup))) in genpd_summary_one()
3133 snprintf(state, sizeof(state), "%s-%u", in genpd_summary_one()
3134 status_lookup[genpd->status], genpd->state_idx); in genpd_summary_one()
3137 status_lookup[genpd->status]); in genpd_summary_one()
3138 seq_printf(s, "%-30s %-50s %u", genpd->name, state, genpd->performance_state); in genpd_summary_one()
3143 * Also genpd->name is immutable. in genpd_summary_one()
3145 list_for_each_entry(link, &genpd->parent_links, parent_node) { in genpd_summary_one()
3146 if (list_is_first(&link->parent_node, &genpd->parent_links)) in genpd_summary_one()
3148 seq_printf(s, "%s", link->child->name); in genpd_summary_one()
3149 if (!list_is_last(&link->parent_node, &genpd->parent_links)) in genpd_summary_one()
3153 list_for_each_entry(pm_data, &genpd->dev_list, list_node) { in genpd_summary_one()
3154 kobj_path = kobject_get_path(&pm_data->dev->kobj, in genpd_summary_one()
3160 seq_printf(s, "\n %-50s ", kobj_path); in genpd_summary_one()
3161 rtpm_status_str(s, pm_data->dev); in genpd_summary_one()
3162 perf_status_str(s, pm_data->dev); in genpd_summary_one()
3178 …seq_puts(s, "domain status children pe… in summary_show()
3180 …seq_puts(s, "-------------------------------------------------------------------------------------… in summary_show()
3184 return -ERESTARTSYS; in summary_show()
3203 struct generic_pm_domain *genpd = s->private; in status_show()
3208 return -ERESTARTSYS; in status_show()
3210 if (WARN_ON_ONCE(genpd->status >= ARRAY_SIZE(status_lookup))) in status_show()
3213 if (genpd->status == GENPD_STATE_OFF) in status_show()
3214 seq_printf(s, "%s-%u\n", status_lookup[genpd->status], in status_show()
3215 genpd->state_idx); in status_show()
3217 seq_printf(s, "%s\n", status_lookup[genpd->status]); in status_show()
3225 struct generic_pm_domain *genpd = s->private; in sub_domains_show()
3231 return -ERESTARTSYS; in sub_domains_show()
3233 list_for_each_entry(link, &genpd->parent_links, parent_node) in sub_domains_show()
3234 seq_printf(s, "%s\n", link->child->name); in sub_domains_show()
3242 struct generic_pm_domain *genpd = s->private; in idle_states_show()
3249 return -ERESTARTSYS; in idle_states_show()
3253 for (i = 0; i < genpd->state_count; i++) { in idle_states_show()
3254 idle_time += genpd->states[i].idle_time; in idle_states_show()
3256 if (genpd->status == GENPD_STATE_OFF && genpd->state_idx == i) { in idle_states_show()
3258 if (now > genpd->accounting_time) { in idle_states_show()
3259 delta = now - genpd->accounting_time; in idle_states_show()
3265 seq_printf(s, "S%-13i %-14llu %-14llu %llu\n", i, idle_time, in idle_states_show()
3266 genpd->states[i].usage, genpd->states[i].rejected); in idle_states_show()
3275 struct generic_pm_domain *genpd = s->private; in active_time_show()
3281 return -ERESTARTSYS; in active_time_show()
3283 if (genpd->status == GENPD_STATE_ON) { in active_time_show()
3285 if (now > genpd->accounting_time) in active_time_show()
3286 delta = now - genpd->accounting_time; in active_time_show()
3289 on_time = genpd->on_time + delta; in active_time_show()
3299 struct generic_pm_domain *genpd = s->private; in total_idle_time_show()
3306 return -ERESTARTSYS; in total_idle_time_show()
3308 for (i = 0; i < genpd->state_count; i++) { in total_idle_time_show()
3309 total += genpd->states[i].idle_time; in total_idle_time_show()
3311 if (genpd->status == GENPD_STATE_OFF && genpd->state_idx == i) { in total_idle_time_show()
3313 if (now > genpd->accounting_time) { in total_idle_time_show()
3314 delta = now - genpd->accounting_time; in total_idle_time_show()
3330 struct generic_pm_domain *genpd = s->private; in devices_show()
3337 return -ERESTARTSYS; in devices_show()
3339 list_for_each_entry(pm_data, &genpd->dev_list, list_node) { in devices_show()
3340 kobj_path = kobject_get_path(&pm_data->dev->kobj, in devices_show()
3356 struct generic_pm_domain *genpd = s->private; in perf_state_show()
3359 return -ERESTARTSYS; in perf_state_show()
3361 seq_printf(s, "%u\n", genpd->performance_state); in perf_state_show()
3383 d = debugfs_create_dir(genpd->name, genpd_debugfs_dir); in genpd_debug_add()
3397 if (genpd->set_performance_state) in genpd_debug_add()