1 // SPDX-License-Identifier: GPL-2.0
5  * Copyright (c) 2018-2021, Arm ltd.
21  * Mutex serializing the registrations of performance domains and letting
28 	return (dev->bus == &cpu_subsys);  in _is_cpu_device()
39 	snprintf(name, sizeof(name), "ps:%lu", ps->frequency);  in em_debug_create_ps()
41 	/* Create per-ps directory */  in em_debug_create_ps()
43 	debugfs_create_ulong("frequency", 0444, d, &ps->frequency);  in em_debug_create_ps()
44 	debugfs_create_ulong("power", 0444, d, &ps->power);  in em_debug_create_ps()
45 	debugfs_create_ulong("cost", 0444, d, &ps->cost);  in em_debug_create_ps()
46 	debugfs_create_ulong("inefficient", 0444, d, &ps->flags);  in em_debug_create_ps()
51 	seq_printf(s, "%*pbl\n", cpumask_pr_args(to_cpumask(s->private)));  in em_debug_cpus_show()
59 	struct em_perf_domain *pd = s->private;  in em_debug_flags_show()
61 	seq_printf(s, "%#lx\n", pd->flags);  in em_debug_flags_show()
72 	/* Create the directory of the performance domain */  in em_debug_create_pd()
76 		debugfs_create_file("cpus", 0444, d, dev->em_pd->cpus,  in em_debug_create_pd()
79 	debugfs_create_file("flags", 0444, d, dev->em_pd,  in em_debug_create_pd()
82 	/* Create a sub-directory for each performance state */  in em_debug_create_pd()
83 	for (i = 0; i < dev->em_pd->nr_perf_states; i++)  in em_debug_create_pd()
84 		em_debug_create_ps(&dev->em_pd->table[i], d);  in em_debug_create_pd()
120 		return -ENOMEM;  in em_create_perf_table()
122 	/* Build the list of performance states for this performance domain */  in em_create_perf_table()
126 		 * lowest performance state of 'dev' above 'freq' and updates  in em_create_perf_table()
129 		ret = cb->active_power(dev, &power, &freq);  in em_create_perf_table()
138 		 * higher performance states.  in em_create_perf_table()
141 			dev_err(dev, "EM: non-increasing freq: %lu\n",  in em_create_perf_table()
160 	/* Compute the cost of each performance state. */  in em_create_perf_table()
161 	fmax = (u64) table[nr_states - 1].frequency;  in em_create_perf_table()
162 	for (i = nr_states - 1; i >= 0; i--) {  in em_create_perf_table()
166 			ret = cb->get_cost(dev, table[i].frequency, &cost);  in em_create_perf_table()
188 	pd->table = table;  in em_create_perf_table()
189 	pd->nr_perf_states = nr_states;  in em_create_perf_table()
195 	return -EINVAL;  in em_create_perf_table()
212 			return -EINVAL;  in em_create_pd()
217 			return -ENOMEM;  in em_create_pd()
223 			return -ENOMEM;  in em_create_pd()
235 			cpu_dev->em_pd = pd;  in em_create_pd()
238 	dev->em_pd = pd;  in em_create_pd()
245 	struct em_perf_domain *pd = dev->em_pd;  in em_cpufreq_update_efficiencies()
260 	table = pd->table;  in em_cpufreq_update_efficiencies()
262 	for (i = 0; i < pd->nr_perf_states; i++) {  in em_cpufreq_update_efficiencies()
279 	pd->flags |= EM_PERF_DOMAIN_SKIP_INEFFICIENCIES;  in em_cpufreq_update_efficiencies()
283  * em_pd_get() - Return the performance domain for a device
284  * @dev : Device to find the performance domain for
286  * Returns the performance domain to which @dev belongs, or NULL if it doesn't
294 	return dev->em_pd;  in em_pd_get()
299  * em_cpu_get() - Return the performance domain for a CPU
300  * @cpu : CPU to find the performance domain for
302  * Returns the performance domain to which @cpu belongs, or NULL if it doesn't
318  * em_dev_register_perf_domain() - Register the Energy Model (EM) for a device
320  * @nr_states	: Number of performance states to register
323  *		obligatory. It can be taken from i.e. 'policy->cpus'. For other
325  * @microwatts	: Flag indicating that the power values are in micro-Watts or
328  * Create Energy Model tables for a performance domain using the callbacks
332  * sub-systems might rely on this flag and check if all devices in the EM are
335  * If multiple clients register the same performance domain, all but the first
349 		return -EINVAL;  in em_dev_register_perf_domain()
352 	 * Use a mutex to serialize the registration of performance domains and  in em_dev_register_perf_domain()
353 	 * let the driver-defined callback functions sleep.  in em_dev_register_perf_domain()
357 	if (dev->em_pd) {  in em_dev_register_perf_domain()
358 		ret = -EEXIST;  in em_dev_register_perf_domain()
365 			ret = -EINVAL;  in em_dev_register_perf_domain()
372 				ret = -EEXIST;  in em_dev_register_perf_domain()
377 			 * micro-architecture since they all share the same  in em_dev_register_perf_domain()
385 				ret = -EINVAL;  in em_dev_register_perf_domain()
394 	else if (cb->get_cost)  in em_dev_register_perf_domain()
401 	dev->em_pd->flags |= flags;  in em_dev_register_perf_domain()
415  * em_dev_unregister_perf_domain() - Unregister Energy Model (EM) for a device
422 	if (IS_ERR_OR_NULL(dev) || !dev->em_pd)  in em_dev_unregister_perf_domain()
430 	 * from potential clean-up/setup issues in the debugfs directories.  in em_dev_unregister_perf_domain()
436 	kfree(dev->em_pd->table);  in em_dev_unregister_perf_domain()
437 	kfree(dev->em_pd);  in em_dev_unregister_perf_domain()
438 	dev->em_pd = NULL;  in em_dev_unregister_perf_domain()