xref: /linux-6.15/include/linux/pm_opp.h (revision 258ea41c)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Generic OPP Interface
4  *
5  * Copyright (C) 2009-2010 Texas Instruments Incorporated.
6  *	Nishanth Menon
7  *	Romit Dasgupta
8  *	Kevin Hilman
9  */
10 
11 #ifndef __LINUX_OPP_H__
12 #define __LINUX_OPP_H__
13 
14 #include <linux/energy_model.h>
15 #include <linux/err.h>
16 #include <linux/notifier.h>
17 
18 struct clk;
19 struct regulator;
20 struct dev_pm_opp;
21 struct device;
22 struct opp_table;
23 
24 enum dev_pm_opp_event {
25 	OPP_EVENT_ADD, OPP_EVENT_REMOVE, OPP_EVENT_ENABLE, OPP_EVENT_DISABLE,
26 	OPP_EVENT_ADJUST_VOLTAGE,
27 };
28 
29 /**
30  * struct dev_pm_opp_supply - Power supply voltage/current values
31  * @u_volt:	Target voltage in microvolts corresponding to this OPP
32  * @u_volt_min:	Minimum voltage in microvolts corresponding to this OPP
33  * @u_volt_max:	Maximum voltage in microvolts corresponding to this OPP
34  * @u_amp:	Maximum current drawn by the device in microamperes
35  * @u_watt:	Power used by the device in microwatts
36  *
37  * This structure stores the voltage/current/power values for a single power
38  * supply.
39  */
40 struct dev_pm_opp_supply {
41 	unsigned long u_volt;
42 	unsigned long u_volt_min;
43 	unsigned long u_volt_max;
44 	unsigned long u_amp;
45 	unsigned long u_watt;
46 };
47 
48 /**
49  * struct dev_pm_opp_icc_bw - Interconnect bandwidth values
50  * @avg:	Average bandwidth corresponding to this OPP (in icc units)
51  * @peak:	Peak bandwidth corresponding to this OPP (in icc units)
52  *
53  * This structure stores the bandwidth values for a single interconnect path.
54  */
55 struct dev_pm_opp_icc_bw {
56 	u32 avg;
57 	u32 peak;
58 };
59 
60 typedef int (*config_regulators_t)(struct device *dev,
61 			struct dev_pm_opp *old_opp, struct dev_pm_opp *new_opp,
62 			struct regulator **regulators, unsigned int count);
63 
64 typedef int (*config_clks_t)(struct device *dev, struct opp_table *opp_table,
65 			struct dev_pm_opp *opp, void *data, bool scaling_down);
66 
67 /**
68  * struct dev_pm_opp_config - Device OPP configuration values
69  * @clk_names: Clk names, NULL terminated array.
70  * @config_clks: Custom set clk helper.
71  * @prop_name: Name to postfix to properties.
72  * @config_regulators: Custom set regulator helper.
73  * @supported_hw: Array of hierarchy of versions to match.
74  * @supported_hw_count: Number of elements in the array.
75  * @regulator_names: Array of pointers to the names of the regulator, NULL terminated.
76  * @genpd_names: Null terminated array of pointers containing names of genpd to
77  *		 attach.
78  * @virt_devs: Pointer to return the array of virtual devices.
79  *
80  * This structure contains platform specific OPP configurations for the device.
81  */
82 struct dev_pm_opp_config {
83 	/* NULL terminated */
84 	const char * const *clk_names;
85 	config_clks_t config_clks;
86 	const char *prop_name;
87 	config_regulators_t config_regulators;
88 	const unsigned int *supported_hw;
89 	unsigned int supported_hw_count;
90 	const char * const *regulator_names;
91 	const char * const *genpd_names;
92 	struct device ***virt_devs;
93 };
94 
95 /**
96  * struct dev_pm_opp_data - The data to use to initialize an OPP.
97  * @level: The performance level for the OPP.
98  * @freq: The clock rate in Hz for the OPP.
99  * @u_volt: The voltage in uV for the OPP.
100  */
101 struct dev_pm_opp_data {
102 	unsigned int level;
103 	unsigned long freq;
104 	unsigned long u_volt;
105 };
106 
107 #if defined(CONFIG_PM_OPP)
108 
109 struct opp_table *dev_pm_opp_get_opp_table(struct device *dev);
110 void dev_pm_opp_put_opp_table(struct opp_table *opp_table);
111 
112 unsigned long dev_pm_opp_get_voltage(struct dev_pm_opp *opp);
113 
114 int dev_pm_opp_get_supplies(struct dev_pm_opp *opp, struct dev_pm_opp_supply *supplies);
115 
116 unsigned long dev_pm_opp_get_power(struct dev_pm_opp *opp);
117 
118 unsigned long dev_pm_opp_get_freq_indexed(struct dev_pm_opp *opp, u32 index);
119 
120 unsigned int dev_pm_opp_get_level(struct dev_pm_opp *opp);
121 
122 unsigned int dev_pm_opp_get_required_pstate(struct dev_pm_opp *opp,
123 					    unsigned int index);
124 
125 bool dev_pm_opp_is_turbo(struct dev_pm_opp *opp);
126 
127 int dev_pm_opp_get_opp_count(struct device *dev);
128 unsigned long dev_pm_opp_get_max_clock_latency(struct device *dev);
129 unsigned long dev_pm_opp_get_max_volt_latency(struct device *dev);
130 unsigned long dev_pm_opp_get_max_transition_latency(struct device *dev);
131 unsigned long dev_pm_opp_get_suspend_opp_freq(struct device *dev);
132 
133 struct dev_pm_opp *dev_pm_opp_find_freq_exact(struct device *dev,
134 					      unsigned long freq,
135 					      bool available);
136 
137 struct dev_pm_opp *
138 dev_pm_opp_find_freq_exact_indexed(struct device *dev, unsigned long freq,
139 				   u32 index, bool available);
140 
141 struct dev_pm_opp *dev_pm_opp_find_freq_floor(struct device *dev,
142 					      unsigned long *freq);
143 
144 struct dev_pm_opp *dev_pm_opp_find_freq_floor_indexed(struct device *dev,
145 						      unsigned long *freq, u32 index);
146 
147 struct dev_pm_opp *dev_pm_opp_find_freq_ceil(struct device *dev,
148 					     unsigned long *freq);
149 
150 struct dev_pm_opp *dev_pm_opp_find_freq_ceil_indexed(struct device *dev,
151 						     unsigned long *freq, u32 index);
152 
153 struct dev_pm_opp *dev_pm_opp_find_level_exact(struct device *dev,
154 					       unsigned int level);
155 
156 struct dev_pm_opp *dev_pm_opp_find_level_ceil(struct device *dev,
157 					      unsigned int *level);
158 
159 struct dev_pm_opp *dev_pm_opp_find_level_floor(struct device *dev,
160 					       unsigned long *level);
161 
162 struct dev_pm_opp *dev_pm_opp_find_bw_ceil(struct device *dev,
163 					   unsigned int *bw, int index);
164 
165 struct dev_pm_opp *dev_pm_opp_find_bw_floor(struct device *dev,
166 					   unsigned int *bw, int index);
167 
168 void dev_pm_opp_put(struct dev_pm_opp *opp);
169 
170 int dev_pm_opp_add_dynamic(struct device *dev, struct dev_pm_opp_data *opp);
171 
172 void dev_pm_opp_remove(struct device *dev, unsigned long freq);
173 void dev_pm_opp_remove_all_dynamic(struct device *dev);
174 
175 int dev_pm_opp_adjust_voltage(struct device *dev, unsigned long freq,
176 			      unsigned long u_volt, unsigned long u_volt_min,
177 			      unsigned long u_volt_max);
178 
179 int dev_pm_opp_enable(struct device *dev, unsigned long freq);
180 
181 int dev_pm_opp_disable(struct device *dev, unsigned long freq);
182 
183 int dev_pm_opp_register_notifier(struct device *dev, struct notifier_block *nb);
184 int dev_pm_opp_unregister_notifier(struct device *dev, struct notifier_block *nb);
185 
186 int dev_pm_opp_set_config(struct device *dev, struct dev_pm_opp_config *config);
187 int devm_pm_opp_set_config(struct device *dev, struct dev_pm_opp_config *config);
188 void dev_pm_opp_clear_config(int token);
189 int dev_pm_opp_config_clks_simple(struct device *dev,
190 		struct opp_table *opp_table, struct dev_pm_opp *opp, void *data,
191 		bool scaling_down);
192 
193 struct dev_pm_opp *dev_pm_opp_xlate_required_opp(struct opp_table *src_table, struct opp_table *dst_table, struct dev_pm_opp *src_opp);
194 int dev_pm_opp_xlate_performance_state(struct opp_table *src_table, struct opp_table *dst_table, unsigned int pstate);
195 int dev_pm_opp_set_rate(struct device *dev, unsigned long target_freq);
196 int dev_pm_opp_set_opp(struct device *dev, struct dev_pm_opp *opp);
197 int dev_pm_opp_set_sharing_cpus(struct device *cpu_dev, const struct cpumask *cpumask);
198 int dev_pm_opp_get_sharing_cpus(struct device *cpu_dev, struct cpumask *cpumask);
199 void dev_pm_opp_remove_table(struct device *dev);
200 void dev_pm_opp_cpumask_remove_table(const struct cpumask *cpumask);
201 int dev_pm_opp_sync_regulators(struct device *dev);
202 #else
203 static inline struct opp_table *dev_pm_opp_get_opp_table(struct device *dev)
204 {
205 	return ERR_PTR(-EOPNOTSUPP);
206 }
207 
208 static inline struct opp_table *dev_pm_opp_get_opp_table_indexed(struct device *dev, int index)
209 {
210 	return ERR_PTR(-EOPNOTSUPP);
211 }
212 
213 static inline void dev_pm_opp_put_opp_table(struct opp_table *opp_table) {}
214 
215 static inline unsigned long dev_pm_opp_get_voltage(struct dev_pm_opp *opp)
216 {
217 	return 0;
218 }
219 
220 static inline int dev_pm_opp_get_supplies(struct dev_pm_opp *opp, struct dev_pm_opp_supply *supplies)
221 {
222 	return -EOPNOTSUPP;
223 }
224 
225 static inline unsigned long dev_pm_opp_get_power(struct dev_pm_opp *opp)
226 {
227 	return 0;
228 }
229 
230 static inline unsigned long dev_pm_opp_get_freq_indexed(struct dev_pm_opp *opp, u32 index)
231 {
232 	return 0;
233 }
234 
235 static inline unsigned int dev_pm_opp_get_level(struct dev_pm_opp *opp)
236 {
237 	return 0;
238 }
239 
240 static inline
241 unsigned int dev_pm_opp_get_required_pstate(struct dev_pm_opp *opp,
242 					    unsigned int index)
243 {
244 	return 0;
245 }
246 
247 static inline bool dev_pm_opp_is_turbo(struct dev_pm_opp *opp)
248 {
249 	return false;
250 }
251 
252 static inline int dev_pm_opp_get_opp_count(struct device *dev)
253 {
254 	return 0;
255 }
256 
257 static inline unsigned long dev_pm_opp_get_max_clock_latency(struct device *dev)
258 {
259 	return 0;
260 }
261 
262 static inline unsigned long dev_pm_opp_get_max_volt_latency(struct device *dev)
263 {
264 	return 0;
265 }
266 
267 static inline unsigned long dev_pm_opp_get_max_transition_latency(struct device *dev)
268 {
269 	return 0;
270 }
271 
272 static inline unsigned long dev_pm_opp_get_suspend_opp_freq(struct device *dev)
273 {
274 	return 0;
275 }
276 
277 static inline struct dev_pm_opp *dev_pm_opp_find_freq_exact(struct device *dev,
278 					unsigned long freq, bool available)
279 {
280 	return ERR_PTR(-EOPNOTSUPP);
281 }
282 
283 static inline struct dev_pm_opp *
284 dev_pm_opp_find_freq_exact_indexed(struct device *dev, unsigned long freq,
285 				   u32 index, bool available)
286 {
287 	return ERR_PTR(-EOPNOTSUPP);
288 }
289 
290 static inline struct dev_pm_opp *dev_pm_opp_find_freq_floor(struct device *dev,
291 					unsigned long *freq)
292 {
293 	return ERR_PTR(-EOPNOTSUPP);
294 }
295 
296 static inline struct dev_pm_opp *
297 dev_pm_opp_find_freq_floor_indexed(struct device *dev, unsigned long *freq, u32 index)
298 {
299 	return ERR_PTR(-EOPNOTSUPP);
300 }
301 
302 static inline struct dev_pm_opp *dev_pm_opp_find_freq_ceil(struct device *dev,
303 					unsigned long *freq)
304 {
305 	return ERR_PTR(-EOPNOTSUPP);
306 }
307 
308 static inline struct dev_pm_opp *
309 dev_pm_opp_find_freq_ceil_indexed(struct device *dev, unsigned long *freq, u32 index)
310 {
311 	return ERR_PTR(-EOPNOTSUPP);
312 }
313 
314 static inline struct dev_pm_opp *dev_pm_opp_find_level_exact(struct device *dev,
315 					unsigned int level)
316 {
317 	return ERR_PTR(-EOPNOTSUPP);
318 }
319 
320 static inline struct dev_pm_opp *dev_pm_opp_find_level_ceil(struct device *dev,
321 					unsigned int *level)
322 {
323 	return ERR_PTR(-EOPNOTSUPP);
324 }
325 
326 static inline struct dev_pm_opp *dev_pm_opp_find_level_floor(struct device *dev,
327 							     unsigned long *level)
328 {
329 	return ERR_PTR(-EOPNOTSUPP);
330 }
331 
332 static inline struct dev_pm_opp *dev_pm_opp_find_bw_ceil(struct device *dev,
333 					unsigned int *bw, int index)
334 {
335 	return ERR_PTR(-EOPNOTSUPP);
336 }
337 
338 static inline struct dev_pm_opp *dev_pm_opp_find_bw_floor(struct device *dev,
339 					unsigned int *bw, int index)
340 {
341 	return ERR_PTR(-EOPNOTSUPP);
342 }
343 
344 static inline void dev_pm_opp_put(struct dev_pm_opp *opp) {}
345 
346 static inline int
347 dev_pm_opp_add_dynamic(struct device *dev, struct dev_pm_opp_data *opp)
348 {
349 	return -EOPNOTSUPP;
350 }
351 
352 static inline void dev_pm_opp_remove(struct device *dev, unsigned long freq)
353 {
354 }
355 
356 static inline void dev_pm_opp_remove_all_dynamic(struct device *dev)
357 {
358 }
359 
360 static inline int
361 dev_pm_opp_adjust_voltage(struct device *dev, unsigned long freq,
362 			  unsigned long u_volt, unsigned long u_volt_min,
363 			  unsigned long u_volt_max)
364 {
365 	return 0;
366 }
367 
368 static inline int dev_pm_opp_enable(struct device *dev, unsigned long freq)
369 {
370 	return 0;
371 }
372 
373 static inline int dev_pm_opp_disable(struct device *dev, unsigned long freq)
374 {
375 	return 0;
376 }
377 
378 static inline int dev_pm_opp_register_notifier(struct device *dev, struct notifier_block *nb)
379 {
380 	return -EOPNOTSUPP;
381 }
382 
383 static inline int dev_pm_opp_unregister_notifier(struct device *dev, struct notifier_block *nb)
384 {
385 	return -EOPNOTSUPP;
386 }
387 
388 static inline int dev_pm_opp_set_config(struct device *dev, struct dev_pm_opp_config *config)
389 {
390 	return -EOPNOTSUPP;
391 }
392 
393 static inline int devm_pm_opp_set_config(struct device *dev, struct dev_pm_opp_config *config)
394 {
395 	return -EOPNOTSUPP;
396 }
397 
398 static inline void dev_pm_opp_clear_config(int token) {}
399 
400 static inline int dev_pm_opp_config_clks_simple(struct device *dev,
401 		struct opp_table *opp_table, struct dev_pm_opp *opp, void *data,
402 		bool scaling_down)
403 {
404 	return -EOPNOTSUPP;
405 }
406 
407 static inline struct dev_pm_opp *dev_pm_opp_xlate_required_opp(struct opp_table *src_table,
408 				struct opp_table *dst_table, struct dev_pm_opp *src_opp)
409 {
410 	return ERR_PTR(-EOPNOTSUPP);
411 }
412 
413 static inline int dev_pm_opp_xlate_performance_state(struct opp_table *src_table, struct opp_table *dst_table, unsigned int pstate)
414 {
415 	return -EOPNOTSUPP;
416 }
417 
418 static inline int dev_pm_opp_set_rate(struct device *dev, unsigned long target_freq)
419 {
420 	return -EOPNOTSUPP;
421 }
422 
423 static inline int dev_pm_opp_set_opp(struct device *dev, struct dev_pm_opp *opp)
424 {
425 	return -EOPNOTSUPP;
426 }
427 
428 static inline int dev_pm_opp_set_sharing_cpus(struct device *cpu_dev, const struct cpumask *cpumask)
429 {
430 	return -EOPNOTSUPP;
431 }
432 
433 static inline int dev_pm_opp_get_sharing_cpus(struct device *cpu_dev, struct cpumask *cpumask)
434 {
435 	return -EINVAL;
436 }
437 
438 static inline void dev_pm_opp_remove_table(struct device *dev)
439 {
440 }
441 
442 static inline void dev_pm_opp_cpumask_remove_table(const struct cpumask *cpumask)
443 {
444 }
445 
446 static inline int dev_pm_opp_sync_regulators(struct device *dev)
447 {
448 	return -EOPNOTSUPP;
449 }
450 
451 #endif		/* CONFIG_PM_OPP */
452 
453 #if defined(CONFIG_PM_OPP) && defined(CONFIG_OF)
454 int dev_pm_opp_of_add_table(struct device *dev);
455 int dev_pm_opp_of_add_table_indexed(struct device *dev, int index);
456 int devm_pm_opp_of_add_table_indexed(struct device *dev, int index);
457 void dev_pm_opp_of_remove_table(struct device *dev);
458 int devm_pm_opp_of_add_table(struct device *dev);
459 int dev_pm_opp_of_cpumask_add_table(const struct cpumask *cpumask);
460 void dev_pm_opp_of_cpumask_remove_table(const struct cpumask *cpumask);
461 int dev_pm_opp_of_get_sharing_cpus(struct device *cpu_dev, struct cpumask *cpumask);
462 struct device_node *dev_pm_opp_of_get_opp_desc_node(struct device *dev);
463 struct device_node *dev_pm_opp_get_of_node(struct dev_pm_opp *opp);
464 int of_get_required_opp_performance_state(struct device_node *np, int index);
465 int dev_pm_opp_of_find_icc_paths(struct device *dev, struct opp_table *opp_table);
466 int dev_pm_opp_of_register_em(struct device *dev, struct cpumask *cpus);
467 static inline void dev_pm_opp_of_unregister_em(struct device *dev)
468 {
469 	em_dev_unregister_perf_domain(dev);
470 }
471 #else
472 static inline int dev_pm_opp_of_add_table(struct device *dev)
473 {
474 	return -EOPNOTSUPP;
475 }
476 
477 static inline int dev_pm_opp_of_add_table_indexed(struct device *dev, int index)
478 {
479 	return -EOPNOTSUPP;
480 }
481 
482 static inline int devm_pm_opp_of_add_table_indexed(struct device *dev, int index)
483 {
484 	return -EOPNOTSUPP;
485 }
486 
487 static inline void dev_pm_opp_of_remove_table(struct device *dev)
488 {
489 }
490 
491 static inline int devm_pm_opp_of_add_table(struct device *dev)
492 {
493 	return -EOPNOTSUPP;
494 }
495 
496 static inline int dev_pm_opp_of_cpumask_add_table(const struct cpumask *cpumask)
497 {
498 	return -EOPNOTSUPP;
499 }
500 
501 static inline void dev_pm_opp_of_cpumask_remove_table(const struct cpumask *cpumask)
502 {
503 }
504 
505 static inline int dev_pm_opp_of_get_sharing_cpus(struct device *cpu_dev, struct cpumask *cpumask)
506 {
507 	return -EOPNOTSUPP;
508 }
509 
510 static inline struct device_node *dev_pm_opp_of_get_opp_desc_node(struct device *dev)
511 {
512 	return NULL;
513 }
514 
515 static inline struct device_node *dev_pm_opp_get_of_node(struct dev_pm_opp *opp)
516 {
517 	return NULL;
518 }
519 
520 static inline int dev_pm_opp_of_register_em(struct device *dev,
521 					    struct cpumask *cpus)
522 {
523 	return -EOPNOTSUPP;
524 }
525 
526 static inline void dev_pm_opp_of_unregister_em(struct device *dev)
527 {
528 }
529 
530 static inline int of_get_required_opp_performance_state(struct device_node *np, int index)
531 {
532 	return -EOPNOTSUPP;
533 }
534 
535 static inline int dev_pm_opp_of_find_icc_paths(struct device *dev, struct opp_table *opp_table)
536 {
537 	return -EOPNOTSUPP;
538 }
539 #endif
540 
541 /* OPP Configuration helpers */
542 
543 static inline int dev_pm_opp_add(struct device *dev, unsigned long freq,
544 				 unsigned long u_volt)
545 {
546 	struct dev_pm_opp_data data = {
547 		.freq = freq,
548 		.u_volt = u_volt,
549 	};
550 
551 	return dev_pm_opp_add_dynamic(dev, &data);
552 }
553 
554 /* Regulators helpers */
555 static inline int dev_pm_opp_set_regulators(struct device *dev,
556 					    const char * const names[])
557 {
558 	struct dev_pm_opp_config config = {
559 		.regulator_names = names,
560 	};
561 
562 	return dev_pm_opp_set_config(dev, &config);
563 }
564 
565 static inline void dev_pm_opp_put_regulators(int token)
566 {
567 	dev_pm_opp_clear_config(token);
568 }
569 
570 static inline int devm_pm_opp_set_regulators(struct device *dev,
571 					     const char * const names[])
572 {
573 	struct dev_pm_opp_config config = {
574 		.regulator_names = names,
575 	};
576 
577 	return devm_pm_opp_set_config(dev, &config);
578 }
579 
580 /* Supported-hw helpers */
581 static inline int dev_pm_opp_set_supported_hw(struct device *dev,
582 					      const u32 *versions,
583 					      unsigned int count)
584 {
585 	struct dev_pm_opp_config config = {
586 		.supported_hw = versions,
587 		.supported_hw_count = count,
588 	};
589 
590 	return dev_pm_opp_set_config(dev, &config);
591 }
592 
593 static inline void dev_pm_opp_put_supported_hw(int token)
594 {
595 	dev_pm_opp_clear_config(token);
596 }
597 
598 static inline int devm_pm_opp_set_supported_hw(struct device *dev,
599 					       const u32 *versions,
600 					       unsigned int count)
601 {
602 	struct dev_pm_opp_config config = {
603 		.supported_hw = versions,
604 		.supported_hw_count = count,
605 	};
606 
607 	return devm_pm_opp_set_config(dev, &config);
608 }
609 
610 /* clkname helpers */
611 static inline int dev_pm_opp_set_clkname(struct device *dev, const char *name)
612 {
613 	const char *names[] = { name, NULL };
614 	struct dev_pm_opp_config config = {
615 		.clk_names = names,
616 	};
617 
618 	return dev_pm_opp_set_config(dev, &config);
619 }
620 
621 static inline void dev_pm_opp_put_clkname(int token)
622 {
623 	dev_pm_opp_clear_config(token);
624 }
625 
626 static inline int devm_pm_opp_set_clkname(struct device *dev, const char *name)
627 {
628 	const char *names[] = { name, NULL };
629 	struct dev_pm_opp_config config = {
630 		.clk_names = names,
631 	};
632 
633 	return devm_pm_opp_set_config(dev, &config);
634 }
635 
636 /* config-regulators helpers */
637 static inline int dev_pm_opp_set_config_regulators(struct device *dev,
638 						   config_regulators_t helper)
639 {
640 	struct dev_pm_opp_config config = {
641 		.config_regulators = helper,
642 	};
643 
644 	return dev_pm_opp_set_config(dev, &config);
645 }
646 
647 static inline void dev_pm_opp_put_config_regulators(int token)
648 {
649 	dev_pm_opp_clear_config(token);
650 }
651 
652 /* genpd helpers */
653 static inline int dev_pm_opp_attach_genpd(struct device *dev,
654 					  const char * const *names,
655 					  struct device ***virt_devs)
656 {
657 	struct dev_pm_opp_config config = {
658 		.genpd_names = names,
659 		.virt_devs = virt_devs,
660 	};
661 
662 	return dev_pm_opp_set_config(dev, &config);
663 }
664 
665 static inline void dev_pm_opp_detach_genpd(int token)
666 {
667 	dev_pm_opp_clear_config(token);
668 }
669 
670 static inline int devm_pm_opp_attach_genpd(struct device *dev,
671 					   const char * const *names,
672 					   struct device ***virt_devs)
673 {
674 	struct dev_pm_opp_config config = {
675 		.genpd_names = names,
676 		.virt_devs = virt_devs,
677 	};
678 
679 	return devm_pm_opp_set_config(dev, &config);
680 }
681 
682 /* prop-name helpers */
683 static inline int dev_pm_opp_set_prop_name(struct device *dev, const char *name)
684 {
685 	struct dev_pm_opp_config config = {
686 		.prop_name = name,
687 	};
688 
689 	return dev_pm_opp_set_config(dev, &config);
690 }
691 
692 static inline void dev_pm_opp_put_prop_name(int token)
693 {
694 	dev_pm_opp_clear_config(token);
695 }
696 
697 static inline unsigned long dev_pm_opp_get_freq(struct dev_pm_opp *opp)
698 {
699 	return dev_pm_opp_get_freq_indexed(opp, 0);
700 }
701 
702 #endif		/* __LINUX_OPP_H__ */
703